AGIRAILS Improvement Proposals (AIPs)

Formal specifications defining the Agent Commerce Transaction Protocol (ACTP) — the standard for AI agent-to-agent payments with blockchain-based escrow.

Proposals

Core Protocol (AIP 0-6)

AIP	Title	Status
AIP-0	Protocol Overview & State Machine	Final
AIP-1	Transaction Creation	Final
AIP-2	Escrow Management	Final
AIP-3	State Transitions	Final
AIP-4	Delivery Proofs & EAS	Final
AIP-5	Dispute Resolution	Final
AIP-6	Fee Structure	Final

Identity & Marketplace (AIP 7-8)

AIP	Title	Status
AIP-7	Agent Identity Registry	Final
AIP-8	Builders & Partners Marketplace	Draft

NFT & Trust Layer (AIP 9-11)

AIP	Title	Status	Depends On
AIP-9	Agent Passport NFT	Draft	AIP-7, AIP-8
AIP-10	Reputation Badges	Draft	AIP-8, AIP-9, AIP-11
AIP-11	Token Bound Accounts	Draft	AIP-9

Operations & Security (AIP 12-14)

AIP	Title	Status
AIP-12	Agent Discovery Protocol	Draft
AIP-13	Deployment Security	Implemented
AIP-14	Fair Dispute Resolution	Draft

Protocol Overview

ACTP enables AI agents to:

• Transact: Pay each other for services using USDC
• Trust: Escrow ensures payment security for both parties
• Verify: On-chain attestations prove service delivery
• Dispute: Built-in resolution mechanism for conflicts

NFT & Trust Layer

The NFT layer (AIP 9-11) provides portable identity and verifiable reputation:

• Agent Passport (AIP-9): ERC-721 NFT representing agent ownership. tokenId = uint256(uint160(agentAddress)) ensures deterministic, collision-free derivation. Tradeable on OpenSea/Blur.

• Reputation Badges (AIP-10): Soulbound ERC-1155 badges earned through protocol usage. Uses AIP-8 thresholds ($1K GMV, 5 counterparties, 95% success). EAS attestations are source of truth.

• Token Bound Accounts (AIP-11): Passive ERC-6551 wallets that hold badges. CANNOT execute or sign - receive-only design minimizes attack surface. Badges travel with Passport on transfer.

Agent Passport (ERC-721)
    └── Token Bound Account (ERC-6551)
            ├── AGENT_PRODUCTION badge
            ├── SPEED_CERTIFIED badge
            └── QUALITY_VERIFIED badge

State Machine

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

Implementation

• Smart Contracts: actp-kernel
• TypeScript SDK: sdk-js
• Python SDK: sdk-python

Contributing

1. Fork this repository
2. Create a new AIP following the template in existing AIPs
3. Submit a Pull Request with your proposal
4. Discuss in Discord

Links

• AGIRAILS Documentation
• ACTP Kernel
• Discord
• Website

License

Apache-2.0