Adds DeployArcMainnet.s.sol and deploy-arc-mainnet.sh. The script checks the chain id (5042) and USDC, simulates, prints the cost in USDC, asks for confirmation, then verifies on Sourcify and Blockscout. Also adds the bounty runbook. SettleKitCctpHook is excluded: it is not called by CCTP V2. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
SettleKit contracts (Arc / EVM)
Solidity contracts for the on-chain pieces of SettleKit on Arc. Built + tested
with Foundry (solc 0.8.30).
cd contracts
forge build # compile
forge test # all suites (escrow, CCTP hook, OperatorVault, ...)
Contracts
SettleKitEscrow.sol
Trustless USDC escrow — the on-chain counterpart to the off-chain escrow product. A buyer funds an escrow for a seller with a neutral arbiter:
createAndFund(id, seller, arbiter, amount)— buyer pulls USDC into escrow (requires priorapprove).release(id)— buyer or arbiter → pays the seller.refund(id)— seller or arbiter → returns to the buyer.dispute(id)— buyer or seller flags it; only the arbiter can then resolve.
Checks-effects-interactions ordering (state finalized before transfer) prevents re-entrancy; custom errors for every guard.
SettleKitCctpHook.sol
Implements Circle's published CCTP V2 IMessageHandlerV2
(circlefin/evm-cctp-contracts). Deploy as the CCTP mintRecipient: a pay-in
burned on a source chain with depositForBurnWithHook(..., hookData) mints USDC
to this contract on Arc, then MessageTransmitterV2 calls a handler here with
the burn message body. The contract decodes the trailing hookData as
abi.encode(address merchant, bytes32 orderId) and forwards the freshly-minted
USDC to the merchant, emitting OrderSettled — making cross-chain pay-in →
merchant credit atomic.
Only the configured MessageTransmitterV2 may call the handlers. hookData
begins at byte 228 of a BurnMessageV2 body (offset documented in-contract).
OperatorVault.sol (Tameion operator)
Guard rails for SettleKit's autonomous business operator. A human owner sets
policy; the agent operator (a Circle DCW address) runs inside it. USDC is
split into OPERATING / TAX / YIELD / REFUND buckets via allocate (only from
unallocated inflow). pay enforces allowlist, per-tx cap, UTC-day cap and
bucket balance; TAX is never operator-spendable; amounts above escalateAbove
reserve funds and emit Escalated for owner approve/reject (72h expiry).
Optional USYC yield adapter (sweepToYield/redeemFromYield, YieldDisabled
when unset), pause kill switch, and DecisionAnchored(decisionHash, action)
on every mutation. Deploy: script/DeployOperator.s.sol.
Integration
- Hook payload — the API's
POST /v1/cctp/burn-txaccepts ahookDatahex field (Phase 3). Set it toabi.encode(merchant, orderId)and pointmintRecipientat a deployedSettleKitCctpHookto settle a checkout the moment the cross-chain USDC mints on Arc. - Deploy — use the deterministic
create2Factoryin@settlekit/arcARC_TESTNET.contracts.create2Factoryfor stable addresses; pass the Arc USDC (0x3600…0000) and the ArcMessageTransmitterV2(ARC_TESTNET.contracts.cctpMessageTransmitterV2) to the hook constructor, and the USDC address to the escrow constructor.
Deploying to Arc testnet needs a faucet-funded deployer key (USDC is the gas token) — gated on the same Circle/Arc provisioning as the rest of the stack.