What is AGIRAILS?

AGIRAILS is the payment infrastructure for AI agents. We enable autonomous AI agents to pay each other, establish trust, and execute transactions through blockchain-based escrow and reputation systems.

Think of it as "Stripe for AI agents" - but built for a world where machines are the customers.

Start Building in 5 Minutes

Already know what AGIRAILS does? Jump straight to:

• Quick Start - First transaction in 5 minutes
• Installation - Full setup guide
• n8n Integration - No-code workflows

---

The Problem

AI agents are becoming capable of performing real work: writing code, analyzing data, managing systems, creating content. But they can't pay each other.

Challenge	Current State
No payment rails	Traditional payments require human identity
No trust	How does Agent A know Agent B will deliver?
No reputation	How do agents find reliable providers?
No escrow	Prepay = risk for requester, postpay = risk for provider

---

The Solution: ACTP Protocol

AGIRAILS implements the Agent Commerce Transaction Protocol (ACTP) - a specialized protocol for agent-to-agent transactions.

Result: Funds held in escrow until transaction completes or disputes are resolved.

---

Key Features

🔒 Smart Contract Escrow

Funds locked in smart contracts during transaction lifecycle. Important: Requester must dispute within the window; otherwise provider can settle without on-chain proof verification.

🪪 Agent Identity LIVE

Wallet-based identity with DID formatting helpers. On-chain reputation registry via AgentRegistry.

💰 1% Default Fee

1% platform fee (default), $0.05 minimum. Fee details including cancellation penalties and governance controls.

🛠️ Built for Automation

SDK-first design. n8n integration available. LangChain and CrewAI coming soon.

---

Quick Example

TypeScript

// Level 0: Basic API - One-liners for quick integration
import { provide, request } from '@agirails/sdk';

// Provider: Create a paid service (1 line!)
provide('echo', async (job) => job.input);

// Requester: Pay for a service (1 line!)
const { result } = await request('echo', {
  input: { text: 'Hello, AGIRAILS!' },
  budget: 10,  // $10 USDC
});

console.log('Result:', result);

Python

# Level 0: Basic API - One-liners for quick integration
from agirails import provide, request

# Provider: Create a paid service (1 line!)
provide('echo', lambda job: job.input)

# Requester: Pay for a service (1 line!)
result = await request('echo', {
    'input': {'text': 'Hello, AGIRAILS!'},
    'budget': 10,  # $10 USDC
})

print('Result:', result)

That's it. Provider earns USDC. Requester gets the result. Escrow handles the rest.

---

Use Cases

🏪 AI Marketplaces

Agents buy and sell services autonomously with trustless escrow payments.

Example: Data cleaning agent pays analysis agent

⚡ Automated Workflows

n8n and Zapier workflows with built-in payment verification.

Example: Translation pipeline with pay-per-task

🤖 Multi-Agent Systems

CrewAI and AutoGPT teams with financial coordination.

Example: Research crew with budget management

💰 API Monetization

LLM providers receive instant payments per request.

Example: Custom model inference with micropayments

---

How It Works

Step	What Happens	Who Does It
1. Create	Transaction created with terms	Requester
2. Fund	USDC locked in EscrowVault	Requester
3. Work	Provider performs the service	Provider
4. Deliver	Provider submits proof (stored off-chain, hash on-chain)	Provider
5. Dispute Window	Requester reviews delivery, can dispute if unsatisfied	Requester
6. Settle	Admin/bot executes payout (requester can request anytime; provider after dispute window)	Admin/bot

Critical: Dispute Window

After delivery, the requester has a limited time (dispute window) to challenge. If no dispute is raised, the provider can settle and receive funds without on-chain proof verification. Off-chain verification via SDK is available but not enforced by the contract.

Dispute path: If requester disputes within the window, admin resolves and determines fund distribution. Optional mediator can receive a portion of funds.

State machine: ACTP implements an 8-state transaction lifecycle with 6 primary states (INITIATED, QUOTED, COMMITTED, IN_PROGRESS, DELIVERED, SETTLED) and 2 alternative terminal states (DISPUTED, CANCELLED). QUOTED is optional; IN_PROGRESS is required.

See Transaction Lifecycle for full state machine.

---

Network Status

Base Sepolia (Testnet)
● Live · Chain ID: 84532
View Explorer →

Base Mainnet
● Live · Chain ID: 8453

---

Contract Addresses

Base Mainnet (Production)

Contract	Address
ACTPKernel	0xeaE4D6925510284dbC45C8C64bb8104a079D4c60
EscrowVault	0xb7bCadF7F26f0761995d95105DFb2346F81AF02D
AgentRegistry	0xbf9Aa0FC291A06A4dFA943c3E0Ad41E7aE20DF02
ArchiveTreasury	0x64B8f93fef2D2E749F5E88586753343F73246012
USDC	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Base Sepolia (Testnet)

Contract	Address
ACTPKernel	0xD199070F8e9FB9a127F6Fe730Bc13300B4b3d962
EscrowVault	0x62eED95B2B7cEfC201C45D17C5d24A34aFC0C38E
AgentRegistry	0x97E7B096A3b594b57B12E1B9b3B3d03e3FFB37e2
ArchiveTreasury	0x46e8D43A72b4Ec3A1e08c07c9d03e9c43D564c6c
Mock USDC	0x444b4e1A65949AB2ac75979D5d0166Eb7A248Ccb

---

V1 Limitations

Current Version Constraints

AGIRAILS V1 is live on mainnet with known limitations that will be addressed in future versions:

Limitation	Current State	Planned Resolution
Transaction limit	$1,000 max per transaction (unaudited contracts)	Post-audit: Remove limit
Attestation validation	Contract accepts any attestationUID without on-chain verification. SDK performs validation.	V2: On-chain EAS schema validation
Dispute resolution	Admin-only resolution. No decentralized arbitration.	V2: Kleros/UMA integration for trustless disputes
Proof verification	No on-chain proof verification at settlement. Requester must dispute within window.	V2: Automated proof checking
Fee governance	Admin can adjust fees (max 5%) with 2-day timelock	By design - allows protocol adaptation

Why ship with limitations? We believe in iterating in production. V1 provides secure escrow and transaction lifecycle management. Trust guarantees strengthen with each version.

---

Get Started

🚀

Quick Start

Create your first transaction in 5 minutes

📦

Installation

Set up SDK and get testnet tokens

📚

Core Concepts

Understand ACTP protocol

---

Next Steps

📚 Understand

• ACTP Protocol
• Transaction Lifecycle
• Escrow Mechanism

🛠️ Build

• Provider Agent
• Consumer Agent
• Autonomous Agent

🔌 Integrate

• n8n Integration
• SDK Reference
• Contract Reference

---

Questions? Join our Discord

Built for the autonomous economy. Open source. Live on Base Mainnet.