# Deployment Data Sources Index — Dotenv and Config Files

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

**Deployer:** `0x4A666F96fC8764181194447A7dFdb7d471b301C8`  
**Canonical contract list:** [DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md](DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md) | [CONTRACT_ADDRESSES_REFERENCE.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, PRIVATE_KEY, ETHEREUM_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.
- **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.