Adds @settlekit/attribution — reuse-detection, weighted provenance lineage,
and HMAC-signed proofs-of-citation — wired live into the rsshub-citation-toll
sidecar (POST /attribution/{detect,proof,verify}) and persisted via
PgLineageStore/PgProofStore over new lepton_lineage_edges + lepton_citation_proofs
tables.
Adds apps/creator-dashboard — a Next.js earnings view in the Statement
greenbar-ledger design system, driven by real domain logic (createSource +
computeRoyaltyDistribution + detectReuse, not mocks). Statement / Sources /
Payouts / Reuse & proofs (interactive) / Wallet. next build green.
Also bundles in-progress settlement hardening: settlement-core idempotency
concurrency, api env validation, bundles + contracts/worker tweaks.
Verified: 943 vitest tests, 27 Foundry tests, next build all green.
Co-Authored-By: Claude Opus 4.8 <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 # 13 tests (escrow + CCTP hook)
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).
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.