d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
d7ca90b84b0dc759c8f9c53c98442cfe0cfe4d61
proxmox/docs/03-deployment/FUNDING_AND_DEPLOYMENT_CHECKLIST.md
defiQUG bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
Sync all local changes: docs, config, scripts, submodule refs, verification evidence 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-21 15:46:06 -08:00

8.4 KiB
Raw Blame History

Funding and Deployment Checklist

Last Updated: 2026-02-13
Purpose: Single source for network token funding sources and deployment flow. Use this after balance checks show insufficient funds.

Related: check-balances-gas-and-deploy.sh | WALLET_REQUIREMENTS | STEPS_FROM_PROXMOX_OR_LAN_WITH_SECRETS

1. Balance Check (Run First)

Before any deployment, verify network token balances:

cd smom-dbis-138
./scripts/deployment/check-balances-gas-and-deploy.sh

This checks native gas token only (ETH, MATIC, BNB, etc.). ERC-20 tokens (USDT, LINK) cannot pay gas unless a meta-tx relayer is used.

Deployer address: cast wallet address $PRIVATE_KEY (from smom-dbis-138/.env)

2. Funding Sources by Network

Chain 138 (DeFi Oracle Meta Mainnet)

Chain 138 is a private Besu QBFT network. There is no public faucet.

Source How Notes
Genesis alloc Deployer may already be pre-funded in genesis.json Check smom-dbis-138/config/genesis.json alloc section. If address is listed, funds exist at chain start. If balance is 0, chain may have been redeployed or funds spent.
Transfer from genesis faucet Use a genesis-funded account's private key Genesis alloc addresses (examples): 0xa55A4B57A91561e9df5a883D4883Bd4b1a7C4882 (GENESIS_FAUCET_1), others in genesis.json. If you have the private key for any funded account, send ETH to deployer: cast send DEPLOYER_ADDRESS --value 10ether --rpc-url $RPC_URL_138 --private-key $FUNDING_PRIVATE_KEY
Validator transfer Use validator node account If you control a validator, transfer ETH from its account to the deployer.
Pre-fund in genesis Add deployer to genesis alloc, redeploy chain For new chains or re-genesis; requires operator access to Besu nodes.

Chain 138 RPC URLs:

  • Admin/deploy (LAN): http://192.168.11.211:8545 or https://rpc-core.d-bis.org
  • Public: https://rpc-http-pub.d-bis.org

Required for deploy: ~0.006 ETH minimum (5M gas × 1 gwei + 20% buffer). Recommended: 1–2 ETH for future operations.

Ethereum Mainnet

Source How Notes
Exchange Buy ETH on Coinbase, Binance, etc.; withdraw to deployer address Typical 1–2 hour confirmation.
Bridge from L2 Arbitrum, Optimism, Base → Mainnet Use official bridges.
Another wallet Send ETH from any funded wallet

Required: ~0.025 ETH minimum; recommended 0.05–0.20 ETH for deployment + buffer.

Polygon, Base, Optimism, etc.

Source How Notes
Exchange Buy MATIC/ETH; withdraw to deployer
Bridge Bridge from Ethereum or other chains
Testnet faucets Sepolia, Base Sepolia, Polygon Amoy Use chain-specific faucets (e.g. sepoliafaucet.com, faucet.quicknode.com).

Testnets (Sepolia, Base Sepolia, Polygon Amoy)

Network Faucet
Ethereum Sepolia https://sepoliafaucet.com, https://www.alchemy.com/faucets/ethereum-sepolia
Base Sepolia https://www.alchemy.com/faucets/base-sepolia
Polygon Amoy https://faucet.polygon.technology/

3. Deployment Checklist

Pre-deployment

  • PRIVATE_KEY set in smom-dbis-138/.env
  • RPC_URL_138 or CHAIN138_RPC_URL set (e.g. http://192.168.11.211:8545 or https://rpc-http-pub.d-bis.org)
  • cast (Foundry) and forge installed
  • Balance check passes for target network(s)

Step 1: Run balance check

cd smom-dbis-138
./scripts/deployment/check-balances-gas-and-deploy.sh

Confirm Chain 138 shows OK for deploy. If not, fund the deployer per §2.

Step 2: Deploy on Chain 138

cd smom-dbis-138
./scripts/deployment/check-balances-gas-and-deploy.sh --deploy

This runs:

  1. 01_DeployCore (phased core)
  2. 02_DeployBridges (if CCIP_ROUTER set and 01 succeeded)

Alternative: Full phased deployment

cd smom-dbis-138
./scripts/deployment/deploy-all-phases.sh

Phases: 1) Core, 2) Bridges, 3) Channel managers, 4) Deterministic core, 5) Vault, 6) Reserve.

Step 3: Operator tasks (from LAN)

./scripts/run-all-operator-tasks-from-lan.sh --deploy

Includes backup, Blockscout verification, phased deploy, optional TransactionMirror and VM creation.

4. Mint ERC-20 Tokens (LINK, cUSDT, cUSDC) for Deployer

The deployer needs LINK for CCIP fees and cUSDT/cUSDC for cross-chain flows. Run:

./scripts/mint-tokens-for-deployer.sh

Defaults: 1,000,000 LINK, 100,000 cUSDT, 100,000 cUSDC, wrap 1 ETH to WETH9/WETH10.

Custom amounts:

./scripts/mint-tokens-for-deployer.sh --amount-link=500000 --amount-stable=50000 --wrap-eth=2

Dry-run: ./scripts/mint-tokens-for-deployer.sh --dry-run

Manual commands (if script fails, e.g. stuck tx):

cd smom-dbis-138 && source .env
RPC="${RPC_URL_138:-http://192.168.11.211:8545}"
GAS=100000 GAS_PRICE=1000000000
DEPLOYER=0x4A666F96fC8764181194447A7dFdb7d471b301C8

# Mint 1M LINK (MockLinkToken - unrestricted mint)
cast send 0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03 "mint(address,uint256)" $DEPLOYER 1000000000000000000000000 --rpc-url "$RPC" --private-key "$PRIVATE_KEY" --legacy --gas-limit $GAS --gas-price $GAS_PRICE

# Mint 100k cUSDT (deployer must be owner)
cast send 0x93E66202A11B1772E55407B32B44e5Cd8eda7f22 "mint(address,uint256)" $DEPLOYER 100000000000 --rpc-url "$RPC" --private-key "$PRIVATE_KEY" --legacy --gas-limit $GAS --gas-price $GAS_PRICE

# Mint 100k cUSDC (deployer must be owner)
cast send 0xf22258f57794CC8E06237084b353Ab30fFfa640b "mint(address,uint256)" $DEPLOYER 100000000000 --rpc-url "$RPC" --private-key "$PRIVATE_KEY" --legacy --gas-limit $GAS --gas-price $GAS_PRICE

# Wrap 1 ETH to WETH9
cast send 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 "deposit()" --value 1000000000000000000 --rpc-url "$RPC" --private-key "$PRIVATE_KEY" --legacy --gas-limit $GAS --gas-price $GAS_PRICE

If you see "Replacement transaction underpriced": A stuck transaction is blocking the deployer nonce. Options: (1) wait for it to be mined, (2) send a 0-ETH tx from MetaMask to advance nonce, (3) restart Besu RPC and flush mempool from Proxmox.

Verify: cd smom-dbis-138 && ./scripts/deployment/list-deployer-tokens-all-networks.sh

5. Post-deployment

  • Update smom-dbis-138/.env with new contract addresses (UNIVERSAL_ASSET_REGISTRY, CCIPWETH9_BRIDGE_CHAIN138, etc.)
  • Run Blockscout verification: ./scripts/verify/run-contract-verification-with-proxy.sh
  • Update CONTRACT_ADDRESSES_REFERENCE

6. Troubleshooting

"Chain 138 balance 0" but genesis has alloc

  • Chain may have been redeployed with different genesis.
  • Check current balance: cast balance DEPLOYER --rpc-url $RPC_URL_138
  • Transfer from another genesis-funded account if you have its private key.

"PRIVATE_KEY not set"

  • Ensure smom-dbis-138/.env exists and contains PRIVATE_KEY=0x...

"RPC not accessible"

  • For 192.168.11.211: requires LAN/VPN access.
  • Try public RPC: RPC_URL_138=https://rpc-http-pub.d-bis.org

"insufficient funds" on broadcast

  • Fund deployer with more native token (ETH on Chain 138).
  • Increase gas price if needed: GAS_PRICE_138=2000000000 (2 gwei).

7. Quick Reference

Action Command
Check balances cd smom-dbis-138 && ./scripts/deployment/check-balances-gas-and-deploy.sh
Deploy Chain 138 ./scripts/deployment/check-balances-gas-and-deploy.sh --deploy
Full phased deploy ./scripts/deployment/deploy-all-phases.sh
Operator tasks ./scripts/run-all-operator-tasks-from-lan.sh --deploy
Verify contracts ./scripts/verify/run-contract-verification-with-proxy.sh
Mint LINK/cUSDT/cUSDC ./scripts/mint-tokens-for-deployer.sh
Check deployer tokens cd smom-dbis-138 && ./scripts/deployment/list-deployer-tokens-all-networks.sh
Check deployer cast wallet address $PRIVATE_KEY
Chain 138 balance cast balance $DEPLOYER --rpc-url $RPC_URL_138

See also: WALLET_REQUIREMENTS, TOKENS_AND_CHAINS_SUMMARY.

Reference in New Issue View Git Blame Copy Permalink