proxmox/docs/11-references/DEPLOYMENT_DATA_SOURCES_INDEX.md

Deployment Data Sources Index — Dotenv and Config Files

Last Updated: 2026-04-22
Purpose: Index of files that contain or reference smart contract deployment addresses, RPC endpoints, or deployment configuration.

Primary deployer (smom / core scripts): 0x4A666F96fC8764181194447A7dFdb7d471b301C8
Thirdweb / CREATE2 deploys: 0xB2dEA0e264ddfFf91057A3415112e57A1a5Eac14 — contract txs submitted to RPC VMID 2103 (http://192.168.11.217:8545); on-chain path is CREATE2 via the singleton at 0x4e59b44847b379578588920ca78fbf26c0b4956c (see RPC_ENDPOINTS_MASTER.md § Active RPC nodes).
Canonical contract list: DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md | CONTRACT_ADDRESSES_REFERENCE.md

---

1. Primary dotenv

File	Contains addresses?	Notes
smom-dbis-138/.env	Yes	Canonical for Chain 138: PRIVATE_KEY, RPC_URL_138, cUSDT/cUSDC/…, CCIP, DODO PMM, pools, TRANSACTION_MIRROR, vaults. Do not commit.
.env (repo root)	Partial	RPC_URL_138, optional PRIVATE_KEY / DEPLOYER_ADDRESS, ETHEREUM_MAINNET_RPC, ALL_MAINNET_RPC, CHAIN_651940_RPC_URL, API keys.

---

2. Env examples (address reference)

File	Notes
smom-dbis-138/docs/deployment/ENV_EXAMPLE_CONTENT.md	Full env var reference: RPC, Chain 138 c*, CCIP per chain, WETH9/WETH10, mainnet bridges, gas.
smom-dbis-138/env.additions.example	DODO_PMM_*, POOL_CUSDTCUSDC, POOL_CUSDTUSDT, POOL_CUSDCUSDC.
smom-dbis-138/docs/deployment/ENV_CONFIG_READY_CHAINS.example	CCIP routers/LINK/bridges for Gnosis, Celo, Wemix, Cronos.
smom-dbis-138/terraform/phases/phase1/.env.chain138	Chain 138 RPC, CCIP, LINK, WETH, bridges. Prefer smom-dbis-138/.env.
smom-dbis-138/terraform/phases/phase1/config/env.chain138.example	Example 138 env.
smom-dbis-138/terraform/phases/phase1/config/env.mainnet.example	Example mainnet env.

---

3. Config JSON

File	Notes
config/token-mapping-multichain.json	138↔651940 and multichain token mapping; addressFrom/addressTo per pair.
cross-chain-pmm-lps/config/deployment-status.json	Per-chain cwTokens, anchorAddresses, pmmPools, bridgeAvailable.
ai-mcp-pmm-controller/config/allowlist-138.json	Chain 138 DODO pool list for MCP.
config/smart-contracts-master.json	Referenced by load-contract-addresses.sh; may be optional or removed.
config/contract-addresses.conf	Legacy; sourced by load-contract-addresses.sh.

---

4. Script load order

• scripts/lib/load-project-env.sh — loads root .env, ip-addresses.conf, smom-dbis-138/.env, derives DEPLOYER_ADDRESS from PRIVATE_KEY, and aliases CHAIN_651940_RPC_URL <- ALL_MAINNET_RPC when needed.
• smom-dbis-138/scripts/lib/deployment/dotenv.sh — now mirrors the same deployer/all-mainnet fallbacks when ENV_FILE is not overriding the default load path.
• scripts/lib/load-contract-addresses.sh — reads config/smart-contracts-master.json and contract-addresses.conf; .env overrides.

---

5. Service env (may reference RPC/contracts)

smom-dbis-138/services/relay/.env, smom-dbis-138/services/transaction-mirroring-service/.env, smom-dbis-138/services/state-anchoring-service/.env, explorer-monorepo/.env, alltra-lifi-settlement/.env, rpc-translator-138/.env.

---

6. Docs with contract lists (no env)

CONTRACT_ADDRESSES_REFERENCE.md, DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md, ADDRESS_MATRIX_AND_STATUS.md, CHAIN138_TOKEN_ADDRESSES.md, DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md.