proxmox/docs/07-ccip/README.md

CCIP & Chainlink

Last Updated: 2026-02-12
Document Version: 1.2
Status: Active Documentation

---

This directory contains CCIP deployment and Chainlink documentation.

Documents

Core CCIP

• CCIP_DEPLOYMENT_SPEC.md ⭐⭐⭐ - CCIP fleet deployment specification (41-43 nodes)
• CCIP_RELAY_DEPLOYMENT.md ⭐⭐⭐ - CCIP Relay Service (Chain 138 → Mainnet); deployed on r630-01; uses VMID 2201 RPC
• CCIP_BRIDGE_MAINNET_CONNECTION.md - Relay flow, mainnet contracts, funding
• TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md - Token mapping (138↔Mainnet), relay-supported tokens, recommendations; source of truth: config/token-mapping.json
• MAPPER_COVERAGE_BRIDGES_AND_LIQUIDITY_POOLS.md - Mapper (AddressMapper + config) coverage for all networks with bridges or liquidity pools
• MAPPER_GAPS_DEPLOYMENTS_AND_IMPROVEMENTS.md - Gaps, deployments, and improvements (based on mapper coverage)
• RECOMMENDED_COMPLETION_CHECKLIST.md - Operator checklist to complete all recommended items (Wemix, CCIP, LINK, AddressMapper, DODO, Trustless)
• WEMIX_TOKEN_VERIFICATION.md - Wemix (1111) WETH/USDT/USDC addresses from scan.wemix.com and verification steps
• EXPLORER_TOKENS_CANONICAL_MAPPING.md - Explorer tokens/contracts list URLs for all chains (canonical mapping verification)
• OPTIONAL_DEPLOYMENTS_START_HERE.md - Deployments start here (AddressMapper other chains, DODO PMM 138, Trustless, Paymaster). Note: Nothing is optional nor future — planned deployments.
• RELAY_BRIDGE_ADD_LINK_SUPPORT_RUNBOOK.md - Runbook: add LINK support to Mainnet relay bridge
• CCIP_SENDER_CONTRACT_REFERENCE.md - CCIP sender contract
• CCIP_SECURITY_DOCUMENTATION.md - Security documentation
• BRIDGE_TESTING_GUIDE.md - Bridge testing procedures

Tezos / Etherlink / Jumper

• TEZOS_NETWORK_CONFIG_ENV_MATRIX.md - Network config and env vars (138, 651940, 42793, Tezos)
• Tezos explorer (contracts list): tzkt.io/contracts — verify Tezos token/contract addresses (FA1.2/FA2, KT1)
• TEZOS_JUMPER_SUPPORT_MATRIX.md - Jumper API support for Tezos/Etherlink
• TEZOS_CCIP_DON_PREREQUISITES.md - Tezos CCIP DON onboarding prerequisites
• TEZOS_CCIP_RUNBOOKS_INDEX.md - Runbooks index (Tezos L1, Etherlink, Jumper)
• TEZOS_ETHERLINK_PRODUCTION_CONFIG.md - Feature flags, rate limits, caps
• TEZOS_ETHERLINK_DON_CONFIG.md - DON config for Etherlink (when CCIP supported)
• TEZOS_ETHERLINK_RMN_POLICY.md - RMN policy for Tezos/Etherlink flows
• TEZOS_CROSS_CHAIN_FINALITY.md - Cross-chain finality rules

Quick Reference

CCIP Relay Service (deployed 2026-02-12):

• Host: r630-01 (192.168.11.11)
• Path: /opt/smom-dbis-138/services/relay
• Chain 138 RPC: VMID 2201 (192.168.11.221:8545)
• Purpose: Monitors MessageSent events, relays to Ethereum Mainnet

CCIP Deployment:

• 41-43 nodes total (minimum production fleet)
• 16 Commit nodes, 16 Execute nodes, 7 RMN nodes
• VLAN assignments and NAT pool configuration

Tezos / Etherlink: Chain IDs 1 (Tezos registry), 42793 (Etherlink). See TEZOS_NETWORK_CONFIG_ENV_MATRIX for RPC and relay env vars. Jumper route selection: TEZOS_JUMPER_SUPPORT_MATRIX.

Related Documentation

• ../02-architecture/ORCHESTRATION_DEPLOYMENT_GUIDE.md - Deployment orchestration
• ../02-architecture/NETWORK_ARCHITECTURE.md - Network architecture
• ../03-deployment/ - Deployment guides