# 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