ACTP Kernel

On-chain implementation of the Agent Commerce Transaction Protocol (ACTP) — smart contracts managing escrow, settlement, and attestations for AI agent transactions.

Contracts

Contract	Description
ACTPKernel.sol	Core transaction coordinator with 8-state lifecycle
EscrowVault.sol	Non-custodial USDC escrow with 2-of-2 release
AgentRegistry.sol	On-chain agent identity, config publishing, and reputation (AIP-7)
X402Relay.sol	Atomic x402 payment fee splitting (1% with $0.05 min)
ArchiveTreasury.sol	Arweave permanent storage funding from protocol fees
AGIRAILSIdentityRegistry.sol	ERC-1056 compatible DID registry
MockUSDC.sol	Test token for development

Transaction Lifecycle

INITIATED → QUOTED → COMMITTED → IN_PROGRESS → DELIVERED → SETTLED
                ↘                      ↘              ↘
              CANCELLED              CANCELLED      DISPUTED → SETTLED

Quick Start

# Install dependencies
forge install

# Build contracts
forge build

# Run tests
forge test

# Run with verbosity
forge test -vvv

# Coverage report
forge coverage

Deployed Contracts

Base Mainnet

Contract	Address
ACTPKernel	0x132B9eB321dBB57c828B083844287171BDC92d29
EscrowVault	0x6aAF45882c4b0dD34130ecC790bb5Ec6be7fFb99
AgentRegistry	0x6fB222CF3DDdf37Bcb248EE7BBBA42Fb41901de8
X402Relay	0x81DFb954A3D58FEc24Fc9c946aC2C71a911609F8
ArchiveTreasury	0x0516C411C0E8d75D17A768022819a0a4FB3cA2f2
USDC (Circle)	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Base Sepolia (Testnet)

Contract	Address
ACTPKernel	0x0ba0b17554601b30F5406e74d2208f567C12CcFE
EscrowVault	0xedC62264301A119207f1f89C6bDE4Fd7a7A4CeB4
AgentRegistry	0xDd6D66924B43419F484aE981F174b803487AF25A
X402Relay	0x4DCD02b276Dbeab57c265B72435e90507b6Ac81A
ArchiveTreasury	0xACB672de092beaAE2cd286dD61Cb2352AF7159F1
AGIRAILSIdentityRegistry	0xF64F748C7802a68Cb936a9213881fE74e83FDA97
MockUSDC	0x444b4e1A65949AB2ac75979D5d0166Eb7A248Ccb

Security

• Audit Status: Internal security audit (Feb 2026), CTO + CODEx audit (Apr 2026) — all findings fixed. See SECURITY.md
• Invariants: See COVENANT.md for protocol guarantees
• Admin: Gnosis Safe 2-of-3 multisig (0x61fE...c2f2)
• Contact: security@agirails.io

Links

• AGIRAILS Documentation
• AIPs (Protocol Specs)
• TypeScript SDK (npm @agirails/sdk@3.0.0)
• Python SDK (PyPI agirails==2.3.1)
• n8n Node (npm n8n-nodes-actp@2.4.0)
• Discord

License

Apache-2.0