convez.ai
SkillFinanceiroAvançado
agirails

AGIRAILS Claude Skill — Pagamentos para Agentes IA

agirails/claude-skill

Carteira de USDC para agentes IA com escrow e pagamentos gasless

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que adiciona capacidade de pagamento on-chain a agentes Claude via USDC na Base L2. Oferece onboarding interativo em 7 passos, suporte a dois modos de pagamento (ACTP escrow para trabalhos complexos, x402 para chamadas API instant), carteira criptografada auto-gerada e liquidação gasless em menos de 2 segundos.

Instalação

$npx convez-ai agirails/claude-skill

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
5
Forks
1
Acompanhando
0
Saúde
37%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Agentes que precisam receber pagamentos de outros agentes ou usuários
  • Integração de pagamento cripto nativo em workflows de IA
  • Prototipagem rápida de marketplaces de agentes com liquidação on-chain

Veredito

Solução madura e opinada para um problema real: agentes IA que precisam liquidar valor entre si. A abordagem de escrow + instant, keystore criptografado e onboarding guiado reduzem barreiras técnicas. Requer familiaridade com Web3 e TypeScript/Python, mas entrega production-ready em 5 minutos.

README

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

agirails-agent-payments

Give your AI agent a wallet. Let it earn and pay USDC — settled on-chain, gasless, in under 2 seconds.

AGIRAILS is the open settlement layer for AI agents on Base L2. This Claude Code skill gives you interactive onboarding: it asks your preferences, generates production-ready agent code, and verifies your setup. Zero to first transaction in 5 minutes.

Why This Exists

AI agents need to pay each other. Not with API keys and invoices — with real money, real escrow, real dispute resolution. AGIRAILS handles the hard parts:

What you getHow it works
Gasless transactionsGas sponsored — your agent never needs ETH
USDC settlementReal stablecoin, not tokens. $1 = $1. On Base L2.
Encrypted walletAuto-generated keystore (AES-128-CTR, chmod 600, gitignored). No keys in code, ever.
Two payment modesACTP escrow for complex jobs. x402 instant for API calls. Same SDK.
On-chain identityERC-8004 portable identity + reputation. Follows your agent across marketplaces.
10,000 test USDCactp init in mock mode — start building immediately. Testnet: 1,000 USDC minted gaslessly during registration.
1% transparent feemax(amount * 1%, $0.05). Same on both payment paths. No subscriptions.

ACTP or x402? Pick the Right Payment Mode

Need time to do the work?  →  ACTP (escrow)
  Lock USDC → work → deliver → dispute window → settle
  Think: hiring a contractor

Instant API call?  →  x402 (instant)
  Pay → get response. One step. No escrow. No disputes.
  Think: buying from a vending machine

Both modes are in the same SDK. Your agent can use both simultaneously.

What the Skill Does

When triggered, Claude walks through a 7-step interactive onboarding:

  1. Asks what you want (earn, pay, or both)
  2. Asks agent name, network, wallet setup, capabilities, pricing
  3. Shows a summary and waits for your explicit "yes"
  4. Installs @agirails/sdk (TypeScript) or agirails (Python)
  5. Generates customized agent code from your answers
  6. Runs verification (actp balance, actp config show)
  7. Launches your agent

This isn't a reference doc you have to read — it's an onboarding agent that does the work.

Quickest Path

# Earn USDC
npx actp init --mode mock
npx actp init --scaffold --intent earn --service code-review --price 5
npx ts-node agent.ts

# Pay another agent
npx actp init --mode mock
npx actp init --scaffold --intent pay --service code-review --price 5
npx ts-node agent.ts

Three commands. Mock mode. No keys, no gas, no config. Then graduate to testnet → mainnet when ready.

Install

Via aitmpl CLI

npx claude-code-templates@latest --skill agirails-agent-payments

Manual

mkdir -p .claude/skills/agirails-agent-payments
curl -sL https://raw.githubusercontent.com/agirails/claude-skill/main/SKILL.md \
  -o .claude/skills/agirails-agent-payments/SKILL.md

What's Inside the Skill

  • Interactive onboarding protocol — 10 questions with conditional logic, not a wall of text
  • Code templates — Level 0 (one-liner), Level 1 (Agent class), SOUL pattern (earn + pay)
  • Full ACTP state machine — 8 states, valid transitions, escrow lifecycle
  • Contract addresses — Base Sepolia (testnet) + Base Mainnet (production), all 8 contracts
  • Adapter routing — ACTP (default), x402 (register), ERC-8004 (configure)
  • Anti-patterns — 4 critical mistakes with wrong/right code examples
  • Sharp edges — 8 severity-rated issues that will bite you in production
  • 24 CLI commands — full actp reference
  • Troubleshooting — 14 common problems with fixes
  • Pricing model — cost + margin with auto-negotiation via QUOTED state

Networks

MockTestnet (Base Sepolia)Mainnet (Base)
Cost to startFreeFree (1,000 USDC minted during registration)Real USDC
GasSimulatedSponsored (paymaster) or ETHSponsored (paymaster) or ETH
USDC10,000 auto-minted1,000 minted gaslessly on registrationbridge.base.org
Escrowrequest() auto-releases; client.pay() manualManual release()Manual release()
Tx limitNoneNone$1,000

Trigger Keywords

agirails, ACTP, agent payment, x402, agent escrow, @agirails/sdk, actp init, ERC-8004, agent identity, agent economy, USDC agent, provide service, request service

Links

License

Apache-2.0

Ver o original no GitHub

Bom para

Relacionados