Files
smom-dbis-138/docs/deployment/TOKENS_AND_CHAINS_SUMMARY.md
2026-03-02 12:14:09 -08:00

220 lines
6.7 KiB
Markdown

# Complete Tokens and Chains Summary for Deployment
**Last Updated**: 2026-02-26 20:12:26 UTC
**Purpose**: Quick reference for all native tokens and chains required for deploying remaining contracts
---
## 📋 Chains Requiring Deployment
### 1. Ethereum Mainnet (Chain ID: 1)
- **Status**: 1 contract remaining
- **Native Token**: ETH
- **Required Balance**: 0.20 ETH (recommended)
### 2. Cronos (Chain ID: 25)
- **Status**: 5 contracts to deploy
- **Native Token**: CRO
- **Required Balance**: 15 CRO (recommended)
### 3. BSC / BNB Smart Chain (Chain ID: 56)
- **Status**: 5 contracts to deploy
- **Native Token**: BNB
- **Required Balance**: 0.06 BNB (recommended)
### 4. Polygon PoS (Chain ID: 137)
- **Status**: 5 contracts to deploy
- **Native Token**: MATIC
- **Required Balance**: 1.0 MATIC (recommended)
### 5. Gnosis Chain (Chain ID: 100)
- **Status**: 5 contracts to deploy
- **Native Token**: xDAI
- **Required Balance**: 0.05 xDAI (recommended)
---
## 💰 Complete Token Requirements
### Native Tokens (for Gas)
**Real-time costs** (from gas API, 2026-01-31): Run `./scripts/deployment/get-multichain-gas-prices.sh` to refresh.
| Chain | Token Symbol | Required Amount | Real-Time Deploy Cost | USD (@ script rates) |
|-------|--------------|-----------------|------------------------|----------------------|
| **Ethereum Mainnet** | ETH | **0.20 ETH** (rec) | 0.0082 ETH | ~$20.59 |
| **Cronos** | CRO | **15 CRO** (rec) | 0.00876 CRO | ~$0.001 |
| **BSC** | BNB | **0.06 BNB** (rec) | 0.0438 BNB | ~$13.14 |
| **Polygon** | MATIC | **1.0 MATIC** (rec) | 0.438 MATIC | ~$0.35 |
| **Gnosis** | xDAI | **0.05 xDAI** (rec) | 0.0175 xDAI | ~$0.02 |
**Total Real-Time Deploy Cost**: ~$67 USD (all chains, from gas API)
**Recommended Balances**: ~$520 USD (includes buffers for gas spikes)
### LINK Tokens (for CCIP Fees - Post-Deployment)
| Chain | LINK Address | Required Amount | Purpose |
|-------|--------------|-----------------|---------|
| **Ethereum Mainnet** | `0x514910771AF9Ca656af840dff83E8264EcF986CA` | 10 LINK | CCIP message fees |
| **Cronos** | TBD | 10 LINK | CCIP message fees |
| **BSC** | TBD | 10 LINK | CCIP message fees |
| **Polygon** | `0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39` | 10 LINK | CCIP message fees |
| **Gnosis** | TBD | 10 LINK | CCIP message fees |
**Total LINK Required**: ~50 LINK (for initial operations)
---
## 📊 Contracts to Deploy by Chain
### Ethereum Mainnet
1.**CCIPLogger** (~2,500,000 gas)
### Cronos / BSC / Polygon / Gnosis
1.**WETH9** (~450,000 gas)
2.**WETH10** (~750,000 gas)
3.**CCIPWETH9Bridge** (~1,800,000 gas)
4.**CCIPWETH10Bridge** (~1,800,000 gas)
5.**CCIPLogger** (~2,500,000 gas)
**Total per chain**: ~8,760,000 gas (with 20% buffer)
---
## 🔗 Token Acquisition Guide
### How to Get Native Tokens
#### Ethereum Mainnet (ETH)
- **Exchanges**: Coinbase, Binance, Kraken, etc.
- **Bridge**: Use bridges from other chains
- **DEX**: Uniswap, SushiSwap
- **Minimum**: 0.20 ETH recommended
#### Cronos (CRO)
- **Exchanges**: Crypto.com Exchange, Binance
- **Bridge**: Crypto.com DeFi Wallet bridge
- **DEX**: VVS Finance, CronaSwap
- **Minimum**: 15 CRO recommended
#### BSC (BNB)
- **Exchanges**: Binance (native), Coinbase, Kraken
- **Bridge**: Binance Bridge
- **DEX**: PancakeSwap
- **Minimum**: 0.06 BNB recommended
#### Polygon (MATIC)
- **Exchanges**: Coinbase, Binance, Kraken
- **Bridge**: Polygon Bridge (from Ethereum)
- **DEX**: QuickSwap, SushiSwap
- **Minimum**: 1.0 MATIC recommended
#### Gnosis (xDAI)
- **Exchanges**: Honeyswap, Swapr
- **Bridge**: xDAI Bridge (from Ethereum)
- **DEX**: Honeyswap
- **Minimum**: 0.05 xDAI recommended
### How to Get LINK Tokens
#### Ethereum Mainnet
- **Address**: `0x514910771AF9Ca656af840dff83E8264EcF986CA`
- **Exchanges**: Coinbase, Binance, Kraken
- **DEX**: Uniswap, SushiSwap
- **Amount**: 10 LINK recommended per chain
#### Polygon
- **Address**: `0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39`
- **Bridge**: Polygon Bridge (from Ethereum)
- **DEX**: QuickSwap
- **Amount**: 10 LINK recommended
#### Other Chains
- **Cronos/BSC/Gnosis**: LINK addresses TBD
- **Check**: Chainlink documentation for official addresses
- **Amount**: 10 LINK recommended per chain
---
## 📝 Pre-Deployment Checklist
Before starting deployment, ensure you have:
### Native Tokens
- [ ] **0.20 ETH** in Ethereum Mainnet wallet
- [ ] **15 CRO** in Cronos wallet
- [ ] **0.06 BNB** in BSC wallet
- [ ] **1.0 MATIC** in Polygon wallet
- [ ] **0.05 xDAI** in Gnosis wallet
### LINK Tokens (Post-Deployment)
- [ ] **10 LINK** on Ethereum Mainnet (for bridge operations)
- [ ] **10 LINK** on Polygon (for bridge operations)
- [ ] **10 LINK** on Cronos (when CCIP available)
- [ ] **10 LINK** on BSC (when CCIP available)
- [ ] **10 LINK** on Gnosis (when CCIP available)
### Configuration
- [ ] All RPC endpoints configured in `.env`
- [ ] All explorer API keys configured
- [ ] CCIP router addresses verified for each chain
- [ ] LINK token addresses verified for each chain
---
## 💡 Cost Optimization Tips
1. **Deploy During Low Gas**: Monitor gas prices and deploy during off-peak hours
2. **Batch Operations**: Deploy multiple contracts in sequence to save on transaction overhead
3. **Test on Testnets First**: Verify everything works before mainnet deployment
4. **Use Gas Trackers**: Check real-time gas prices before deploying
5. **Consider Layer 2**: Some chains have lower gas costs
---
## 🔍 Verification Commands
Check your balances before deployment:
```bash
# Ethereum Mainnet
cast balance $DEPLOYER_ADDRESS --rpc-url $ETH_MAINNET_RPC_URL
# Cronos
cast balance $DEPLOYER_ADDRESS --rpc-url $CRONOS_RPC_URL
# BSC
cast balance $DEPLOYER_ADDRESS --rpc-url $BSC_RPC_URL
# Polygon
cast balance $DEPLOYER_ADDRESS --rpc-url $POLYGON_RPC_URL
# Gnosis
cast balance $DEPLOYER_ADDRESS --rpc-url $GNOSIS_RPC_URL
```
---
## 📚 Related Documentation
- [Gas and Token Requirements](./GAS_AND_TOKEN_REQUIREMENTS.md) - Detailed gas cost breakdown
- [Multichain Deployment Runbook](./MULTICHAIN_DEPLOYMENT_RUNBOOK.md) - Complete deployment guide
- [Environment Variables Template](./ENV_EXAMPLE_CONTENT.md) - .env configuration
- [Deployment Quick Reference](./DEPLOYMENT_QUICK_REFERENCE.md) - Quick start guide
---
## ⚠️ Important Notes
1. **Gas Prices Fluctuate**: Always check current gas prices before deployment
2. **Buffer Recommended**: Recommended balances include 20% buffer for gas price spikes
3. **LINK Required Post-Deployment**: LINK tokens are needed after deployment for CCIP operations
4. **CCIP Availability**: Some chains may not have CCIP routers yet - verify before deployment
5. **Test First**: Always test on testnets before mainnet deployment
---
**Last Updated**: 2026-02-26 20:12:26 UTC
**Next Review**: Before deployment phase