convez.ai
MCP ServerFinanceiroAvançado
1pacent

AgentsPay — Protocolo de Pagamento entre Agentes

1pacent/AgentsPay

Escrow USDC com registry on-chain e resolução automática de disputas

Ver no GitHub
InicialPluginScore · de 0 a 100

Protocolo on-chain para pagamentos peer-to-peer entre agentes de IA, com registry descentralizado de agentes, escrow USDC na rede Base e resolução de disputas por timeout. Fornece contratos inteligentes auditados, MCP server, integração n8n e card A2A para orquestração segura de transações em USDC.

Instalação

$npx convez-ai 1pacent/AgentsPay

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
4

Casos de uso

  • Pagamentos autônomos entre agentes de IA
  • Marketplace descentralizado de serviços de IA
  • Liquidação de transações B2B com garantia de entrega

Veredito

Infraestrutura sólida para economia de agentes com máquina de estados bem definida, testes robustos (22 casos) e proteções contra reentrância. Ainda em estágio pré-produção (testes, Sepolia), mas arquitetura é production-ready para casos de uso específicos de pagamento A2A.

README

A tradução para o português deste README ainda está na fila.

AgentPays — Smart Contracts

Agent-to-agent payment protocol on Base. On-chain agent registry and USDC escrow with timeout-based dispute resolution.

Architecture

Agent Registry (AgentRegistry.sol)
├── registerAgent() — Register with capabilities + pricing
├── updateRegistration() — Update agent details
├── deregisterAgent() — Remove from index
├── discover() — Search by capability category
└── updateReputation() — On-chain trust scoring

Payment Escrow (PaymentEscrow.sol)
├── createOrder() → CREATED
├── deposit() → FUNDED
├── confirmDelivery() → DELIVERED
├── releasePayment() → COMPLETED
├── refund() → REFUNDED (timeout)
└── cancelOrder() → CANCELLED

State Machine

CREATED ──deposit()──→ FUNDED ──confirmDelivery()──→ DELIVERED ──releasePayment()──→ COMPLETED
  │                       │                              │
  └──cancelOrder()──→     │                              │
  CANCELLED               └──refund()──→ REFUNDED        │
                                  (buyer)                 └──refund()──→ REFUNDED
                                                     (anyone after timeout)

Contracts

ContractLinesPurpose
AgentRegistry.sol~175Agent CRUD, capability discovery, on-chain reputation
PaymentEscrow.sol~290USDC escrow with 5-state machine, 0.5% protocol fee
MockUSDC.sol~206-decimal mock ERC20 for testing

Key Parameters

ParameterValue
SettlementUSDC (6 decimals)
Protocol fee0.5% (50 bps, paid by seller)
Buyer deposit timeout6 hours (configurable)
Delivery timeout6 hours (configurable)
Dispute V1Timeout-only (no arbitrator)
ReputationsuccessfulJobs / totalJobs * 10000

Test Coverage

22 tests (AgentRegistry: 11, PaymentEscrow: 11) + 2 fuzz suites

Covers:

  • Full happy path: create → deposit → confirm → release → withdraw fees
  • All revert conditions (duplicate, zero price, self-order, wrong caller)
  • All state transitions (cancel, refund at each stage)
  • Timeout mechanisms (delivery timeout, confirm timeout)
  • Access control (buyer-only, seller-only, owner-only)
  • Reputation scoring
  • Protocol fee calculation and withdrawal

Prerequisites

  • Foundry
  • Base Sepolia RPC URL (e.g. from Alchemy, Infura, or public endpoint)

Setup

# Install dependencies
forge install OpenZeppelin/openzeppelin-contracts
forge install foundry-rs/forge-std

# Build
forge build

# Run tests
forge test

# Run tests with gas report
forge test --gas-report

# Run with fuzz (CI profile)
forge test --profile ci

Deployment

Base Sepolia (Testnet)

export DEPLOYER_PRIVATE_KEY=0x...
export BASE_SEPOLIA_RPC_URL=https://sepolia.base.org
export BASESCAN_API_KEY=...

forge script script/Deploy.s.sol:DeployAgentPays \
  --rpc-url base_sepolia \
  --broadcast \
  --verify \
  -vvvv

Local / Mock

export DEPLOYER_PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80

forge script script/Deploy.s.sol:DeployMock \
  --rpc-url base_sepolia \
  --broadcast \
  -vvvv

Deployed Addresses

(To be updated after deployment)

ContractBase Sepolia
AgentRegistryTBD
PaymentEscrowTBD
USDC (Base Sepolia)0x036CbD53842c5426634e7929541eC2318f3dCF7e

Security

  • OpenZeppelin ReentrancyGuard on all state-mutating functions
  • OpenZeppelin Ownable for admin (owner-only fee withdrawal, reputation updates)
  • OpenZeppelin SafeERC20 for all USDC transfers
  • State-machine guards via modifier (onlyState)
  • Checks-effects-interactions pattern
  • No delegatecall, no selfdestruct, no low-level calls to arbitrary addresses

Related

License

MIT

Ver o original no GitHub

Bom para

Relacionados