feat: bridges, PMM, flash workflow, token-aggregation, and deployment docs

- CCIP/trustless bridge contracts, GRU tokens, DEX/PMM tests, reserve vault.
- Token-aggregation service routes, planner, chain config, relay env templates.
- Config snapshots and multi-chain deployment markdown updates.
- gitignore services/btc-intake/dist/ (tsc output); do not track dist.

Run forge build && forge test before deploy (large solc graph).

Made-with: Cursor
This commit is contained in:
defiQUG
2026-04-07 23:40:52 -07:00
parent 0fb7bba07b
commit 76aa419320
289 changed files with 28367 additions and 824 deletions

View File

@@ -5,24 +5,55 @@
# Or copy the needed lines into .env manually. Do NOT commit .env.
# DODO PMM Provider (deployed); required for liquidity/quoting scripts
DODO_PMM_PROVIDER_ADDRESS=0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381
DODO_PMM_PROVIDER_ADDRESS=0x3f729632E9553EBacCdE2e9b4c8F2B285b014F2e
# DODO PMM Integration (Chain 138)
DODO_PMM_INTEGRATION_ADDRESS=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d
# Official DODO V2 DVM stack (Chain 138)
DODO_DVM_FACTORY=0xc93870594C7f83A0aE076c2e30b494Efc526b68E
DODO_VENDING_MACHINE_ADDRESS=0xb6D9EF3575bc48De3f011C310DC24d87bEC6087C
DODO_PMM_INTEGRATION_ADDRESS=0x86ADA6Ef91A3B450F89f2b751e93B1b7A3218895
# Local quote-side mirror stables (Chain 138); optional — see deploy runbooks
OFFICIAL_USDT_ADDRESS=0x004b63A7B5b0E06f6bB6adb4a5F9f590BF3182D1
OFFICIAL_USDC_ADDRESS=0x71D6687F38b93CCad569Fa6352c876eea967201b
# PMM pool addresses (optional; RegisterDODOPools reads from integration if unset)
# Canonical current cUSDT/USDT pool is the funded pool returned by the live
# Chain 138 integration/provider mapping.
POOL_CUSDTCUSDC=0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8
POOL_CUSDTUSDT=0x6fc60DEDc92a2047062294488539992710b99D71
POOL_CUSDCUSDC=0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5
# Canonical current stable pools were recalibrated on 2026-04-02 with i=1e18 and k=0
# so equal-reserve stable pairs quote at true 1:1 on the official DODO V2 DVM stack.
POOL_CUSDTCUSDC=0x9e89bAe009adf128782E19e8341996c596ac40dC
POOL_CUSDTUSDT=0x866Cb44b59303d8dc5f4F9E3E7A8e8b0bf238d66
POOL_CUSDCUSDC=0xc39B7D0F40838cbFb54649d327f49a6DAC964062
# Canonical stable-pool creation parameters for Chain 138 official DVM
DODO_LP_FEE_BPS=10
DODO_INITIAL_PRICE_1E18=1000000000000000000
DODO_K_FACTOR_1E18=0
DODO_ENABLE_TWAP=false
# Token-aggregation (quote API): same integration address so indexer can index DODO pools
CHAIN_138_DODO_PMM_INTEGRATION=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d
CHAIN_138_DODO_PMM_INTEGRATION=0x86ADA6Ef91A3B450F89f2b751e93B1b7A3218895
# Optional USDW public-wrap surfaces (BSC / Polygon) for cWUSDW rollout
CWUSDW_ADDRESS_56=0xC2FA05F12a75Ac84ea778AF9D6935cA807275E55
# CWUSDW_ADDRESS_137=0x...
USDW_NATIVE_ADDRESS_56=0xed75ad08f416d4e53e4d45dd5140a4c8b84f39fb
USDW_NATIVE_ADDRESS_137=0x3deb0c60f0be9d9b99da83a2b6b2ee790f5af37a
# USDW_WRAP_VAULT_56=0x...
# USDW_WRAP_VAULT_137=0x...
# Planned ALL Mainnet AUSDT -> cWAUSDT -> cAUSDT corridor
AUSDT_ADDRESS_651940=0x015B1897Ed5279930bC2Be46F661894d219292A6
CAUSDT_ADDRESS_138=0x5fdDF65733e3d590463F68f93Cf16E8c04081271
CWAUSDT_ADDRESS_56=0xe1a51Bc037a79AB36767561B147eb41780124934
CWAUSDT_ADDRESS_137=0xf12e262F85107df26741726b074606CaFa24AAe7
CWAUSDT_ADDRESS_43114=0xff3084410A732231472Ee9f93F5855dA89CC5254
CWAUSDT_ADDRESS_42220=0xC158b6cD3A3088C52F797D41f5Aa02825361629e
# Planned ALL Mainnet gold corridor
# 138 cXAUC/cXAUT -> source-leg cWXAUC/cWXAUT -> 651940 cWAXAUC/cWAXAUT -> 651940 cAXAUC/cAXAUT
# CAXAUC_ADDRESS_651940=0x...
# CAXAUT_ADDRESS_651940=0x...
# CWAXAUC_ADDRESS_651940=0x...
# CWAXAUT_ADDRESS_651940=0x...
# Add liquidity (run-pmm-full-parity or AddLiquidityPMMPoolsChain138.s.sol); amounts in token units (6 decimals, e.g. 1000000e6 = 1M)
# ADD_LIQUIDITY_BASE_AMOUNT=1000000e6