f3d2961b97
Some checks failed
CI/CD Pipeline / Lint and Format (push) Failing after 46s
CI/CD Pipeline / Terraform Validation (push) Failing after 35s
CI/CD Pipeline / Kubernetes Validation (push) Successful in 37s
Deploy ChainID 138 / Deploy ChainID 138 (push) Failing after 1m50s
HYBX OMNL TypeScript & anchor / token-aggregation build + reconcile artifact (push) Failing after 2m19s
Validation / validate-genesis (push) Successful in 51s
Validation / validate-terraform (push) Failing after 39s
Validation / validate-kubernetes (push) Failing after 10s
CI/CD Pipeline / Solidity Contracts (push) Failing after 12m56s
Validation / validate-smart-contracts (push) Failing after 12s
CI/CD Pipeline / Security Scanning (push) Failing after 15m52s
Validation / validate-security (push) Failing after 10m59s
Validation / validate-documentation (push) Failing after 17s
Validate Token List / validate (push) Failing after 30s
OMNL reconcile anchor / Run omnl:reconcile and upload artifacts (push) Failing after 26s
Verify Deployment / Verify Deployment (push) Failing after 56s
2.3 KiB
2.3 KiB
CCIP mirror flow — Chain 138 ↔ ALL Mainnet (651940)
Roles
- Primary reserve writer: Chain 138 (
ReserveCommitmentStore.commitReserveorcommitReserveAttested) after operational attestation signing. - One-shot mirror send:
OMNLMirrorCoordinator.commitReserveAndMirroron 138 commits then sends CCIP (native fee). GrantRESERVE_COMMITTER_ROLEonReserveCommitmentStoreto the coordinator address. - Mirror chain: 651940 receives identical commitments via
OMNLMirrorReceiver.ccipReceive, which callsReserveCommitmentStore.applyMirrorCommit(caller must equalmirrorReceiverset on the store).
Finality
- 138 (QBFT): treat blocks as final immediately for attestation pipeline (
confirmations: 1in indexer config). - 651940: wait 12 confirmations before treating mirrored state as binding for breaker automation that affects user funds (matches chains.ts defaults).
Payload encoding
Off-chain helper (repo): services/token-aggregation/scripts/encode-omnl-mirror-payload.mjs.
OMNLMirrorReceiver decodes message.data as:
abi.encode(version, lineId, R, validUntil, evidenceHash, merkleRoot)
versionmust be strictly greater than the stored version forlineIdon the mirror store.lineIdisbytes32.R,validUntil,evidenceHash,merkleRootmust match the primary commit being mirrored.
Router integration
- Deploy
OMNLMirrorReceiver(router651940, reserveStore651940, admin)on ALL Mainnet. - On
ReserveCommitmentStore(651940):setMirrorReceiver(receiverAddr)(admin). - On receiver:
setSourceAllowed(chainSelector138, true)with the Chainlink CCIP selector for Chain 138 as source. - From Chain 138, send CCIP messages to
receiveron 651940 with no token amounts (data-only message) using the encoded payload above. Fee in native or LINK per router config.
Replay protection
OMNLMirrorReceiver marks messageId processed (same pattern as CCIPRelayBridge).
Desync breaker
If mirrored version / R on 651940 lags primary beyond N blocks (operator config), automation documented in RUNBOOK_CIRCUIT_BREAKERS.md should alert and optionally invoke OMNLCircuitBreaker.setLinePaused / setGlobalPaused.