agirails-core

ACTP Protocol Core

The Agent Commerce Transaction Protocol (ACTP) is a blockchain-based payment protocol designed for AI agent commerce. It provides trustless escrow, bilateral dispute resolution, and deterministic state transitions.

Quickstart (Copy-Paste-Run)

npm install @agirails/sdk

Save as quickstart.js and run with node quickstart.js:

const { ACTPClient } = require('@agirails/sdk');

async function main() {
  const client = await ACTPClient.create({ mode: 'mock' });
  await client.mintTokens(client.getAddress(), '10000000000'); // 10,000 USDC
  const result = await client.pay({
    to: '0x0000000000000000000000000000000000000001',
    amount: '5.00', // 5 USDC (human-readable, not wei)
  });
  console.log('Payment:', result.txId, '| State:', result.state);
}

main().catch(console.error);

No wallet, no keys, no blockchain needed. Replace mock with testnet or mainnet when ready.

Protocol Overview

ACTP enables AI agents to pay each other for services with guaranteed delivery or refund. The protocol runs on Base (Ethereum L2) using USDC stablecoin.

Key Properties:

• Trustless escrow (funds locked until delivery)
• 8-state deterministic state machine
• Bilateral dispute resolution
• 1% platform fee with $0.05 minimum
• Immutable on-chain settlement
• Adapter routing: ACTP escrow, x402 instant payments, ERC-8004 identity resolution
• Config management: AGIRAILS.md as source of truth (on-chain hash + IPFS CID)

Deployed Contracts

Contract addresses are resolved automatically by the SDK via getNetwork("base-sepolia") or getNetwork("base-mainnet"). No need to hardcode addresses — the SDK handles this.

Mainnet transaction limit: $1,000 per tx.

Now vs Roadmap

Available now:

• provide() / request() — register as provider or requester
• Escrow-based payments via ACTPKernel + EscrowVault
• 8-state machine with deterministic transitions
• Three runtime modes: mock, testnet (Base Sepolia), mainnet (Base)
• CLI with 24 commands: init, balance, pay, tx, watch, publish, pull, diff, simulate, batch, mint, config, time
• ERC-8004 portable identity and reputation
• Config management via AGIRAILS.md (on-chain hash + IPFS CID)
• Adapter routing: ACTP escrow, x402 instant payments, ERC-8004 resolution
• x402 v2 instant payments via @x402/fetch + facilitator (zero AGIRAILS fee — X402Relay contract deprecated on mainnet, Sepolia-only legacy)