96 lines
2.0 KiB
Markdown
96 lines
2.0 KiB
Markdown
# Testnet Deployment Guide
|
||
|
||
**Last Updated:** 2026-03-27
|
||
**Document Version:** 1.1
|
||
**Status:** Active Documentation
|
||
|
||
**Purpose:** Guide for deploying and testing on testnets.
|
||
|
||
---
|
||
|
||
## 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`
|
||
|
||
---
|
||
|
||
## 🧪 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
|
||
|
||
---
|
||
|
||
**Last Updated:** 2026-03-27
|
||
|