# Deployments — Master Runbook

**Note: Nothing here is optional nor future — these are planned deployments.**

**Last Updated:** 2026-02-16  
**Status:** Reference — run when PRIVATE_KEY, funded wallet, and RPC access are available

---

## Overview

This runbook covers all deployments (Chain 138 and multichain). Run from `smom-dbis-138/` with `.env` loaded. **Chain 138** default gas: 2 gwei (`GAS_PRICE_138`).

| Deployment | Script | Chain(s) | Depends |
|------------|--------|----------|---------|
| Trustless Bridge | `script/bridge/trustless/DeployTrustlessBridge.s.sol` | 138 + Mainnet | None |
| DeployAll (multichain) | `script/DeployAll.s.sol` | Mainnet, Cronos, BSC, Polygon, Gnosis, Avalanche, Base, Arbitrum, Optimism | Per-chain RPC |
| CREATE2 / Deterministic Core | `script/deploy/DeployDeterministicCore.s.sol` | 138 | None |
| Vault System | `script/deploy/vault/DeployVaultSystem.s.sol` | 138 | None |
| Reserve System | `script/reserve/DeployReserveSystem.s.sol` | 138 | TOKEN_FACTORY |
| Reserve Keeper | `script/reserve/DeployKeeper.s.sol` | 138 | Reserve system |
| DODO / Swap | `script/dex/DeployDODOPMMIntegration.s.sol` | 138 | cUSDT, cUSDC |
| eMoney | `script/emoney/DeployChain138.s.sol` | 138 | None |
| Smart Accounts + Paymaster | `script/smart-accounts/DeploySmartAccountsKit.s.sol` | 138 | EntryPoint/Factory from ERC-4337 |
| PaymentChannelManager | `script/DeployPaymentChannelManager.s.sol` | 138 | None |
| GenericStateChannelManager | `script/DeployGenericStateChannelManager.s.sol` | 138 | None |

---

## 1. Trustless Bridge (Chain 138 + Mainnet)

**Purpose:** Lockbox138 on Chain 138; BondManager, ChallengeManager, LiquidityPoolETH, InboxETH, SwapRouter, BridgeSwapCoordinator on Mainnet.

```bash
cd smom-dbis-138
source .env

# Chain 138: Lockbox138 only
forge script script/bridge/trustless/DeployTrustlessBridge.s.sol:DeployTrustlessBridge \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000

# Mainnet: Full bridge (requires MAINNET_RPC in .env)
forge script script/bridge/trustless/DeployTrustlessBridge.s.sol:DeployTrustlessBridge \
  --rpc-url $ETHEREUM_MAINNET_RPC --broadcast --via-ir --verify
```

**Full system (Mainnet):** DeployEnhancedSwapRouter, DeployIntegrationContracts, InitializeBridgeSystem — see `script/bridge/trustless/DeployCompleteSystem.s.sol` for steps.

**Ref:** [bridge/trustless/DEPLOYMENT_GUIDE.md](../../smom-dbis-138/docs/bridge/trustless/DEPLOYMENT_GUIDE.md)

---

## 2. DeployAll (Mainnet / Multichain)

**Purpose:** WETH9, WETH10, CCIP Bridges, CCIPLogger to Cronos, BSC, Polygon, Gnosis, Avalanche, Base, Arbitrum, Optimism. Mainnet: CCIPLogger only.

```bash
cd smom-dbis-138
source .env

# Per chain — set RPC for target chain
# Cronos
forge script script/DeployAll.s.sol --rpc-url $CRONOS_RPC --broadcast --private-key $PRIVATE_KEY

# Polygon
forge script script/DeployAll.s.sol --rpc-url $POLYGON_RPC --broadcast --private-key $PRIVATE_KEY

# Arbitrum
forge script script/DeployAll.s.sol --rpc-url $ARBITRUM_RPC --broadcast --private-key $PRIVATE_KEY

# ... repeat for BSC, Gnosis, Avalanche, Base, Optimism
```

**Chain 138 is NOT in DeployAll** — use `deploy-and-configure-weth9-bridge-chain138.sh` for Chain 138.

---

## 3. CREATE2 / Deterministic Core (Chain 138)

**Purpose:** CREATE2Factory, UniversalAssetRegistry, UniversalCCIPBridge (proxy), MirrorRegistry, AlltraAdapter — deterministic addresses.

```bash
cd smom-dbis-138
source .env

forge script script/deploy/DeployDeterministicCore.s.sol \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000

# After deploy: call UniversalCCIPBridge.setCCIPRouter(router) on each chain
```

---

## 4. Vault / Reserve / Keeper

### Vault System

```bash
forge script script/deploy/vault/DeployVaultSystem.s.sol:DeployVaultSystem \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000
```

### Reserve System (requires TOKEN_FACTORY in .env)

```bash
forge script script/reserve/DeployReserveSystem.s.sol \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000
```

### Reserve Keeper

```bash
forge script script/reserve/DeployKeeper.s.sol \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000
```

---

## 5. DODO / Swap

**Purpose:** DODOPMMIntegration for cUSDT/cUSDC pools. Requires DODO Vending Machine and Approve addresses on Chain 138.

**Required env:** `DODO_VENDING_MACHINE_ADDRESS`, `COMPLIANT_USDT_ADDRESS`, `COMPLIANT_USDC_ADDRESS`. Optional: `DODO_APPROVE_ADDRESS`, `OFFICIAL_USDT_ADDRESS`, `OFFICIAL_USDC_ADDRESS`.

```bash
cd smom-dbis-138
source .env

# Env: DODO_VENDING_MACHINE_ADDRESS (required), COMPLIANT_USDT_ADDRESS (required), COMPLIANT_USDC_ADDRESS (required)
forge script script/dex/DeployDODOPMMIntegration.s.sol \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000
```

**Pool creation:** Use `script/dex/DeployPrivatePoolRegistryAndPools.s.sol` or DODOPMMIntegration.createPool after deploy.

---

## 6. eMoney (Chain 138)

**Purpose:** ComplianceRegistry, DebtRegistry, PolicyManager, eMoneyToken, TokenFactory138, BridgeVault138.

```bash
cd smom-dbis-138
source .env

forge script script/emoney/DeployChain138.s.sol:DeployChain138 \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000
```

**Optional env:** GOVERNANCE_MULTISIG, TOKEN_DEPLOYER_MULTISIG, POLICY_OPERATOR_MULTISIG, etc.

---

## 7. Smart Accounts + Paymaster (ERC-4337)

**Purpose:** EntryPoint, AccountFactory, Paymaster. Script is informational — deploy from MetaMask Smart Accounts Kit or standard ERC-4337.

```bash
cd smom-dbis-138
source .env

# Script logs addresses; does not deploy contracts
forge script script/smart-accounts/DeploySmartAccountsKit.s.sol \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000
```

**Steps:**
1. Obtain EntryPoint, AccountFactory, Paymaster from MetaMask kit or ERC-4337 impl
2. Deploy to Chain 138
3. Set ENTRY_POINT, SMART_ACCOUNT_FACTORY, PAYMASTER in .env
4. Deploy AccountWalletRegistryExtended: `forge script script/smart-accounts/DeployAccountWalletRegistryExtended.s.sol ...`

---

## 8. PaymentChannelManager / GenericStateChannelManager

```bash
cd smom-dbis-138
source .env

forge script script/DeployPaymentChannelManager.s.sol \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000

forge script script/DeployGenericStateChannelManager.s.sol \
  --rpc-url $RPC_URL_138 --broadcast --private-key $PRIVATE_KEY --with-gas-price 1000000000
```

**Ref:** [PAYMENT_CHANNELS_DEPLOYMENT.md](../../smom-dbis-138/docs/deployment/PAYMENT_CHANNELS_DEPLOYMENT.md)

---

## 0. AddressMapper on other chains (Cronos, BSC, etc.)

**Purpose:** Deploy an empty AddressMapper (no Chain-138-specific mappings) so `config/smart-contracts-master.json` can set `mapper` to a contract address instead of `"canonical"`.

```bash
cd smom-dbis-138
source .env
# Set RPC for target chain (e.g. Cronos)
export RPC_URL="${CRONOS_RPC:-https://evm.cronos.org}"
forge script script/DeployAddressMapperOtherChain.s.sol:DeployAddressMapperOtherChain \
  --rpc-url "$RPC_URL" --broadcast --private-key "$PRIVATE_KEY" --legacy
```

**After deploy:** Update `config/smart-contracts-master.json`: set `chains["25"].mapper` (Cronos) to the deployed address. See [OPTIONAL_DEPLOYMENTS_START_HERE](../07-ccip/OPTIONAL_DEPLOYMENTS_START_HERE.md) §A.

---

## Orchestration Script

Run all optional/future deployments in order:

```bash
cd smom-dbis-138
./scripts/deployment/deploy-optional-future-all.sh [--dry-run] [--phases 1,2,3,...]
```

See `scripts/deployment/deploy-optional-future-all.sh` for phase list and skip logic.

---

## Post-Deployment

1. **Update .env** with all new addresses
2. **Update config/smart-contracts-master.json** when available
3. **Run on-chain check:** `./scripts/verify/check-contracts-on-chain-138.sh`
4. **Blockscout verification:** `./scripts/verify/run-contract-verification-with-proxy.sh` (from LAN)