2026-01-06 01:46:25 -08:00
|
|
|
|
# Testnet Deployment Guide
|
|
|
|
|
|
|
2026-03-27 22:14:22 -07:00
|
|
|
|
**Last Updated:** 2026-03-27
|
|
|
|
|
|
**Document Version:** 1.1
|
2026-02-12 15:46:57 -08:00
|
|
|
|
**Status:** Active Documentation
|
|
|
|
|
|
|
|
|
|
|
|
**Purpose:** Guide for deploying and testing on testnets.
|
2026-01-06 01:46:25 -08:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-03-27 22:14:22 -07:00
|
|
|
|
## Defi Oracle Meta Testnet (chain ID 2138)
|
|
|
|
|
|
|
|
|
|
|
|
For **this project’s** L1 testnet (EIP-155 chain ID **2138**, CAIP-2 `eip155:2138`), use the mapped runbook:
|
|
|
|
|
|
|
|
|
|
|
|
- **[DEFI_ORACLE_META_TESTNET_2138_RUNBOOK.md](DEFI_ORACLE_META_TESTNET_2138_RUNBOOK.md)** — genesis, Besu/Proxmox scripts, RPC, explorer, contracts, chainlist
|
|
|
|
|
|
- **Env template:** `smom-dbis-138/terraform/phases/phase1/config/env.chain2138.example`
|
|
|
|
|
|
- **Chain metadata:** `pr-workspace/chains/_data/chains/eip155-2138.json`
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-01-06 01:46:25 -08:00
|
|
|
|
## 🧪 Testnet Options
|
|
|
|
|
|
|
|
|
|
|
|
### Recommended Testnets
|
|
|
|
|
|
|
|
|
|
|
|
1. **Sepolia** (Ethereum testnet)
|
|
|
|
|
|
2. **Mumbai** (Polygon testnet)
|
|
|
|
|
|
3. **BSC Testnet**
|
|
|
|
|
|
4. **Avalanche Fuji**
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 📋 Testnet Deployment Steps
|
|
|
|
|
|
|
|
|
|
|
|
### 1. Configure Testnet RPC
|
|
|
|
|
|
|
|
|
|
|
|
Add testnet RPC URLs to `.env`:
|
|
|
|
|
|
```bash
|
|
|
|
|
|
SEPOLIA_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
|
|
|
|
|
|
MUMBAI_RPC_URL=https://polygon-mumbai.infura.io/v3/YOUR_KEY
|
|
|
|
|
|
BSC_TESTNET_RPC_URL=https://data-seed-prebsc-1-s1.binance.org:8545
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 2. Deploy Contracts
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# Deploy to Sepolia
|
|
|
|
|
|
forge script script/DeployCCIPWETH9Bridge.s.sol:DeployCCIPWETH9Bridge \
|
|
|
|
|
|
--rpc-url $SEPOLIA_RPC_URL \
|
|
|
|
|
|
--broadcast \
|
|
|
|
|
|
--verify
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 3. Configure Destinations
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# Configure testnet destinations
|
|
|
|
|
|
bash scripts/configure-bridge-destinations.sh --testnet
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 4. Test Transfers
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# Test small transfer
|
|
|
|
|
|
bash scripts/test-bridge-transfers.sh sepolia 0.01 weth9
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## ✅ Testnet Checklist
|
|
|
|
|
|
|
|
|
|
|
|
- [ ] Deploy contracts to testnet
|
|
|
|
|
|
- [ ] Configure destination chains
|
|
|
|
|
|
- [ ] Test small transfers
|
|
|
|
|
|
- [ ] Verify cross-chain messages
|
|
|
|
|
|
- [ ] Test error scenarios
|
|
|
|
|
|
- [ ] Monitor testnet activity
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 🔄 Testnet Maintenance
|
|
|
|
|
|
|
|
|
|
|
|
### Regular Testing
|
|
|
|
|
|
- Run test suite weekly
|
|
|
|
|
|
- Test new features on testnet first
|
|
|
|
|
|
- Monitor testnet for issues
|
|
|
|
|
|
|
|
|
|
|
|
### Testnet Monitoring
|
|
|
|
|
|
- Monitor testnet bridge activity
|
|
|
|
|
|
- Track testnet gas prices
|
|
|
|
|
|
- Review testnet transactions
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-03-27 22:14:22 -07:00
|
|
|
|
**Last Updated:** 2026-03-27
|
2026-01-06 01:46:25 -08:00
|
|
|
|
|