Skip to main content الرئيسية المنشئون demerzels-lab elsamultiskillagent agirails-payments
agirails-payments Official ACTP (Agent Commerce Transaction Protocol) SDK — the first trustless payment layer for AI agents. Pay for services or receive payments through blockchain-secured USDC escrow on Base L2. Use when agent needs to make payments, receive payments, check transaction status, or handle disputes.
الانتقال إلى التثبيت سوق المهارات اكتشف واستكشف مهارات الذكاء الاصطناعي التي بناها المجتمع.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
عرض تفاصيل Prompt يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/Demerzels-lab/elsamultiskillagent --skill agirails-paymentsيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
تحميل Zip جاري التحميل... المهن ذات الصلة SOC
استنادا إلى تصنيف SOC المهني
name AGIRAILS Payments version 2.1.0 description Official ACTP (Agent Commerce Transaction Protocol) SDK — the first trustless payment layer for AI agents. Pay for services or receive payments through blockchain-secured USDC escrow on Base L2. Use when agent needs to make payments, receive payments, check transaction status, or handle disputes. author AGIRAILS Inc. homepage https://agirails.io repository https://github.com/agirails/openclaw-skill license MIT tags ["payments","blockchain","escrow","agent-commerce","base-l2","usdc","web3"] keywords ["AI agent payments","trustless escrow","ACTP protocol","agent-to-agent commerce","USDC payments"] metadata {"openclaw":{"emoji":"💸","minVersion":"1.0.0","requires":{"env":["AGENT_PRIVATE_KEY","AGENT_ADDRESS"]}}}
AGIRAILS — Trustless Payments for AI Agents
Enable your AI agent to pay for services or receive payments through blockchain-secured USDC escrow on Base L2.
🚀 Quick Start
Just say: "Pay 10 USDC to 0xProvider for translation service"
The agent will:
Initialize ACTP client
Create transaction with escrow
Track state through completion
Handle disputes if needed
Prerequisites
Requirement Check Install Node.js 18+ node --versionnodejs.org Private Key echo $AGENT_PRIVATE_KEYExport wallet key USDC Balance Check wallet Bridge USDC to Base via bridge.base.org
Environment Variables
export AGENT_PRIVATE_KEY="0x..."
export AGENT_ADDRESS="0x..."
Note: SDK includes default RPC endpoints. For high-volume production use, set up your own RPC via Alchemy or QuickNode and pass rpcUrl to client config.
Installation
npm install @agirails/sdk
pip install agirails
How It Works
ACTP uses an 8-state machine with blockchain-secured escrow:
Human/Agent requests service
↓
INITIATED ──► Provider quotes price
↓
QUOTED ──► Requester accepts, locks USDC
↓
COMMITTED ──► Provider starts work
↓
IN_PROGRESS ──► Provider delivers (REQUIRED step!)
↓
DELIVERED ──► Dispute window (48h default)
↓
SETTLED ◄── Manual release (requester calls releaseEscrow)
DISPUTED ──► Mediator resolves (splits funds)
CANCELLED ──► Refund to requester
Key Guarantees Guarantee Description Escrow Solvency Vault always holds ≥ active transaction amounts State Monotonicity States only move forward, never backwards Deadline Enforcement No delivery after deadline passes Dispute Protection 48h window to raise issues before settlement
Actions Action Who Description payRequester Simple payment (create + escrow lock) checkStatusAnyone Get transaction state createTransactionRequester Create with custom params linkEscrowRequester Lock funds in escrow transitionStateProvider Quote, start, deliver releaseEscrowRequester Release funds to provider transitionState('DISPUTED')Either Raise dispute for mediation
Requester Flow (Paying for Services)
Simple Payment import { ACTPClient } from '@agirails/sdk' ;
const client = await ACTPClient .create ({
mode : 'mainnet' ,
privateKey : process.env .AGENT_PRIVATE_KEY !,
requesterAddress : process.env .AGENT_ADDRESS !,
});
const result = await client.basic .pay ({
to : '0xProviderAddress' ,
amount : '25.00' ,
deadline : '+24h' ,
});
console .log (`Transaction: ${result.txId} ` );
console .log (`State: ${result.state} ` );
Advanced Payment (Full Control)
const txId = await client.standard .createTransaction ({
provider : '0xProviderAddress' ,
amount : '100' ,
deadline : Math .floor (Date .now () / 1000 ) + 86400 ,
disputeWindow : 172800 ,
serviceDescription : 'Translate 500 words to Spanish' ,
});
const escrowId = await client.standard .linkEscrow (txId);
await client.standard .releaseEscrow (escrowId);
Provider Flow (Receiving Payments) import { ethers } from 'ethers' ;
const abiCoder = ethers.AbiCoder .defaultAbiCoder ();
const quoteAmount = ethers.parseUnits ('50' , 6 );
const quoteProof = abiCoder.encode (['uint256' ], [quoteAmount]);
await client.standard .transitionState (txId, 'QUOTED' , quoteProof);
await client.standard .transitionState (txId, 'IN_PROGRESS' );
const disputeWindow = 172800 ;
const deliveryProof = abiCoder.encode (['uint256' ], [disputeWindow]);
await client.standard .transitionState (txId, 'DELIVERED' , deliveryProof);
⚠️ CRITICAL: IN_PROGRESS is required before DELIVERED. Contract rejects direct COMMITTED → DELIVERED.
Proof Encoding All proofs must be ABI-encoded hex strings:
Transition Proof Format Example QUOTED ['uint256'] amountencode(['uint256'], [parseUnits('50', 6)])DELIVERED ['uint256'] dispute windowencode(['uint256'], [172800])SETTLED (dispute) ['uint256', 'uint256', 'address', 'uint256'][reqAmt, provAmt, mediator, fee]
import { ethers } from 'ethers' ;
const abiCoder = ethers.AbiCoder .defaultAbiCoder ();
const quoteProof = abiCoder.encode (['uint256' ], [ethers.parseUnits ('100' , 6 )]);
const deliveryProof = abiCoder.encode (['uint256' ], [172800 ]);
const resolutionProof = abiCoder.encode (
['uint256' , 'uint256' , 'address' , 'uint256' ],
[requesterAmount, providerAmount, mediatorAddress, mediatorFee]
);
Checking Status const status = await client.basic .checkStatus (txId);
console .log (`State: ${status.state} ` );
console .log (`Can dispute: ${status.canDispute} ` );
Disputes Either party can raise a dispute before settlement:
await client.standard .transitionState (txId, 'DISPUTED' );
const resolution = abiCoder.encode (
['uint256' , 'uint256' , 'address' , 'uint256' ],
[
ethers.parseUnits ('30' , 6 ),
ethers.parseUnits ('65' , 6 ),
mediatorAddress,
ethers.parseUnits ('5' , 6 ),
]
);
await client.standard .transitionState (txId, 'SETTLED' , resolution);
Protocol Fees Fee Type Amount Platform fee 1% of transaction Minimum fee $0.05 USDC Maximum cap 5% (governance limit)
Provider receives: amount - max(amount * 0.01, $0.05)
Client Modes Mode Network Use Case mockLocal simulation Development, testing testnetBase Sepolia Integration testing mainnetBase Production
const client = await ACTPClient .create ({
mode : 'mock' ,
requesterAddress : '0x...' ,
});
await client.mintTokens ('0x...' , '1000000000' );
const client = await ACTPClient .create ({
mode : 'mainnet' ,
privateKey : process.env .AGENT_PRIVATE_KEY !,
requesterAddress : process.env .AGENT_ADDRESS !,
});
Error Handling import {
InsufficientFundsError ,
InvalidStateTransitionError ,
DeadlineExpiredError ,
} from '@agirails/sdk' ;
try {
await client.basic .pay ({...});
} catch (error) {
if (error instanceof InsufficientFundsError ) {
console .log (error.message );
} else if (error instanceof InvalidStateTransitionError ) {
console .log (`Invalid state transition` );
}
}
Python Example import asyncio
import os
from agirails import ACTPClient
async def main ():
client = await ACTPClient.create(
mode="mainnet" ,
private_key=os.environ["AGENT_PRIVATE_KEY" ],
requester_address=os.environ["AGENT_ADDRESS" ],
)
result = await client.basic.pay({
"to" : "0xProviderAddress" ,
"amount" : "25.00" ,
"deadline" : "24h" ,
})
print (f"Transaction: {result.tx_id} " )
print (f"State: {result.state} " )
asyncio.run(main())
Troubleshooting Problem Cause Solution COMMITTED → DELIVERED revertsMissing IN_PROGRESS Add transitionState(txId, 'IN_PROGRESS') first Invalid proof error Wrong encoding Use ethers.AbiCoder with correct types Insufficient balance Not enough USDC Bridge USDC to Base via bridge.base.org Deadline expired Too slow Create new transaction with longer deadline
Files File Purpose {baseDir}/references/requester-template.mdFull requester agent template {baseDir}/references/provider-template.mdFull provider agent template {baseDir}/references/state-machine.mdDetailed state transitions {baseDir}/examples/simple-payment.mdMinimal payment example {baseDir}/examples/full-lifecycle.mdComplete transaction lifecycle
OpenClaw Integration Ready-to-use templates for OpenClaw agents.
Quick Setup (5 minutes)
bash {baseDir}/scripts/setup.sh
See {baseDir}/openclaw/QUICKSTART.md for detailed guide.
OpenClaw Files File Purpose {baseDir}/openclaw/QUICKSTART.md5-minute setup guide {baseDir}/openclaw/agent-config.jsonReady-to-use agent configs {baseDir}/openclaw/SOUL-treasury.mdTreasury agent template (buyer) {baseDir}/openclaw/SOUL-provider.mdMerchant agent template (seller) {baseDir}/openclaw/cron-examples.jsonAutomation cron jobs {baseDir}/openclaw/validation-patterns.mdDelivery validation helpers {baseDir}/openclaw/security-checklist.mdPre-launch security audit
Scripts Script Purpose {baseDir}/scripts/setup.shAutomated workspace setup {baseDir}/scripts/test-balance.tsCheck wallet balance {baseDir}/scripts/test-purchase.tsTest purchase on testnet
Resources 