Co-authored-by: Cursor <cursoragent@cursor.com>
7.3 KiB
Recommended Completion Checklist
Last Updated: 2026-02-16
Purpose: Operator checklist to complete all recommended improvements from MAPPER_GAPS_DEPLOYMENTS_AND_IMPROVEMENTS.md.
Full consolidated list (all next steps + remaining TODOs): NEXT_STEPS_AND_REMAINING_TODOS.md.
Run completable mapper tasks + see operator checklist: ./scripts/run-remaining-mapper-tasks.sh
High priority
1. Wemix (1111) token addresses
- Scan checked (2026-02-16): scan.wemix.com/tokens fetched; WWEMIX at
0x7d72b22a74a216af4a002a1095c8c707d6ec1c5f. WEMIX_TOKEN_VERIFICATION.md updated with scan check; our mapping uses WETH0x5adc...(wrapped Ether). - Operator: Confirm WETH, USDT, USDC on scan and with Tether/Circle/Wemix; if different official addresses exist, update
config/token-mapping-multichain.jsonand WEMIX_TOKEN_VERIFICATION.md. - Validation: Run
bash scripts/run-remaining-mapper-tasks.sh(runsvalidate-config-files.sh+ on-chain check + prints operator checklist). Once operator has confirmed Wemix addresses, no further change needed; note in multichain JSON is "Operator: verify on scan.wemix.com before production".
Ref: WEMIX_TOKEN_VERIFICATION.md, MAPPER_GAPS_DEPLOYMENTS_AND_IMPROVEMENTS.md § Gaps (Wemix token addresses).
2. Gnosis, Celo, Wemix — CCIP bridges (config-ready → ✅)
- Confirm Chainlink CCIP supported networks include Gnosis (100), Celo (42220), Wemix (1111). If any chain is not supported, skip that chain.
- Per chain (Gnosis, Celo, Wemix):
- Set RPC_URL, CCIP Router address (from CCIP directory), LINK token address, WETH9/WETH10 addresses (or deploy), and deployer private key with native gas (xDAI / CELO / WEMIX).
- From
smom-dbis-138/: runforge script script/deploy/bridge/DeployWETHBridges.s.sol:DeployWETHBridges --rpc-url "$RPC_URL" --broadcast -vvvv(or equivalent per chain). - Record deployed CCIPWETH9Bridge and CCIPWETH10Bridge addresses.
- On Chain 138: Add each new chain as destination on CCIPWETH9_Bridge and CCIPWETH10_Bridge (
addDestination(selector, receiverBridge)). Use selectors: Gnosis465200170687744372, Celo1346049177634351622, Wemix5142893604156789321. - On each new chain: Add Chain 138 as destination on the new bridges (
addDestination(CHAIN138_SELECTOR, chain138Bridge)). - Fund each new bridge with LINK (e.g. ~10 LINK per bridge).
- Update env / docs with new bridge addresses.
Ref: CONFIG_READY_CHAINS_COMPLETION_RUNBOOK.md.
Medium priority
3. Token-aggregation / UIs using multichain mapping
- Done: Token-aggregation exposes
GET /api/v1/token-mapping?fromChain=&toChain=,GET /api/v1/token-mapping/pairs,GET /api/v1/token-mapping/resolve?fromChain=&toChain=&address=(usesconfig/token-mapping-loader.cjswhen run from monorepo). - Done: Bridge UIs / Snap:
GET /api/v1/bridge/routesnow returnstokenMappingApi(basePath, pairs, resolve); Snap hasget_token_mappingRPC (fromChain, toChain, address for resolve). REST_API_REFERENCE documents token-mapping for bridge UIs. - Done: Token-mapping API documented in token-aggregation README and REST_API_REFERENCE.
Ref: MAPPER_GAPS_DEPLOYMENTS_AND_IMPROVEMENTS.md § Recommended (wire token-aggregation).
4. LINK support on Mainnet relay bridge
- Choose Option A (extend CCIPRelayBridge to accept LINK) or Option B (deploy separate LINK receiver). See runbook.
- Implement contract changes and deploy (or deploy LINK receiver).
- Fund the bridge (or LINK receiver) with Mainnet LINK.
- In
config/token-mapping.json, setrelaySupported: truefor the LINK token entry. - Update TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md and CCIP_BRIDGE_MAINNET_CONNECTION.md to state LINK is accepted.
Ref: RELAY_BRIDGE_ADD_LINK_SUPPORT_RUNBOOK.md.
Low priority
5. AddressMapper on other chains (e.g. Cronos)
- Cronos done: Deployed at
0x6F521cd9FCF7884cD4E9486c7790e818638e09Dd;config/smart-contracts-master.json→chains["25"].mapperandcontracts.Address_Mapperupdated. - For other chains: from
smom-dbis-138/, run DeployAddressMapperOtherChain (set RPC to target chain, e.g. CRONOS_RPC), then add deployed address toconfig/smart-contracts-master.jsonfor that chain (mapperandcontracts.Address_Mapper).
Ref: OPTIONAL_DEPLOYMENTS_START_HERE.md §A, MAPPER_COVERAGE_BRIDGES_AND_LIQUIDITY_POOLS.md.
6. DODO PMM on Chain 138
- Deploy DODOPMMIntegration on Chain 138 (env: DODO_VENDING_MACHINE_ADDRESS, COMPLIANT_USDT_ADDRESS, COMPLIANT_USDC_ADDRESS). Set
CHAIN_138_DODO_POOL_MANAGER,CHAIN_138_DODO_VENDING_MACHINEin env after deploy. - Create cUSDT/cUSDC and related pools (e.g.
createCUSDTUSDTPool,createCUSDCUSDCPool) when design is ready. - Document deployed addresses and pool IDs in LIQUIDITY_POOLS_MASTER_MAP.md.
Ref: OPTIONAL_DEPLOYMENTS_START_HERE.md §B, LIQUIDITY_POOL_CONTROLS_RUNBOOK.md.
7. Mainnet trustless stack (LiquidityPoolETH, InboxETH, BondManager, etc.)
- Deploy Lockbox138 on Chain 138; deploy Mainnet stack (InboxETH, BondManager, ChallengeManager, LiquidityPoolETH) per OPTIONAL_DEPLOYMENTS_START_HERE.md §C.
- Configure Lockbox138↔InboxETH, fund liquidity; update env and docs with Mainnet trustless addresses.
Ref: OPTIONAL_DEPLOYMENTS_START_HERE.md §C, OPTIONAL_FUTURE_DEPLOYMENTS_RUNBOOK.md.
Summary
| Item | Priority | Status |
|---|---|---|
| Wemix token addresses in multichain JSON | High | ☐ Operator |
| Gnosis, Celo, Wemix CCIP bridges deploy + config + fund | High | ☐ Ops / runbook |
| Token-aggregation / UIs use multichain mapping | Medium | ☑ Done (API + bridge response + Snap get_token_mapping) |
| LINK support on Mainnet relay | Medium | ☐ Runbook |
| AddressMapper on other chains | Low | ☑ Cronos done; others as needed |
| DODO PMM on 138 | Low | ☐ |
| Mainnet trustless stack | Low | ☐ |