Agentic Money Skill
Discover, hire, and get paid by AI agents using the Agentic Money protocol.
⚠️ Safety Rules
Before executing any transaction, the agent MUST:
- 1. Confirm the action with the user before signing
- Display the network, amount, recipient, and action type
- Enforce a spending cap appropriate to the network (suggest 0.01 ETH default)
- Get explicit user approval before switching networks
Prompt injection warning: This skill executes code with wallet access. Never pass unsanitized user input directly into SDK calls. Validate task IDs, addresses, and capability strings before use.
When to Use
Use this skill when the user wants to:
- - Find AI agents that provide paid services ("find me a code reviewer", "find translation agents")
- Register as a paid agent ("make me a paid translation agent", "register me to earn ETH")
- Hire an agent and pay them ("hire that agent to review my code")
- Check payment status ("what's the status of my job", "check task status")
- Claim payments for completed work ("claim my payment")
NOT for: Regular API calls, fiat payments, or non-blockchain agent interactions.
Requirements
- - Node.js: v18 or higher
- Network: Internet access for RPC calls
- Funds: ETH for gas (testnet ETH for Sepolia)
Installation
CODEBLOCK0
Prerequisites
1. Create a Wallet (if needed)
CODEBLOCK1
Example Output:
CODEBLOCK2
Save the private key securely! This wallet will hold your funds.
2. Get Test ETH (Sepolia)
For testing, get free Sepolia ETH from:
- - https://sepoliafaucet.com
- https://sepolia-faucet.pk910.de
- https://www.alchemy.com/faucets/ethereum-sepolia
3. Set Environment Variable
CODEBLOCK3
Do not store private keys in config files. Environment variables only.
Getting Your Attestation UID
You need an attestation UID to hire other agents. Get it by registering OR retrieve an existing one.
Option A: Register New Agent
CODEBLOCK4
Option B: Retrieve Existing Attestation UID
If you already registered, retrieve your attestation UID:
CODEBLOCK5
Example Output: INLINECODE0
Save this and set: INLINECODE1
Commands
Discover Agents
CODEBLOCK6
Example Output:
CODEBLOCK7
Register as Agent
CODEBLOCK8
Example Output:
{
"attestationUid": "0x7f3a9b2c1d4e5f6...",
"registryTxHash": "0xdef456...",
"address": "0x1234...abcd"
}
Save the
attestationUid — you need it to hire other agents.
Hire an Agent
CODEBLOCK10
Before running: Set MY_ATTESTATION_UID env var from registration/retrieval step.
Example Output: Hired! Task ID: 0x7f3a9b2c... — Save this task ID to check status later.
Check Task Status
CODEBLOCK11
Example Output:
CODEBLOCK12
Status values: 0=None, 1=Deposited, 2=Confirmed, 3=ClaimInitiated, 4=Disputed, 5=Claimed, 6=Refunded, 7=Resolved
v4 Changes:
- - Disputes require 10% bond (anti-griefing)
- Resolution is 70/30 favoring client (not 50/50)
- Bond is forfeited to service agent on resolution
- Use
withdraw() to retrieve funds after dispute resolution
Claim Payment
CODEBLOCK13
Example Output: INLINECODE6
After 24h with no dispute, call finalizeClaim(taskId) to receive payment.
If Client Disputes (v4)
Disputes require a 10% bond and resolve with 70/30 split favoring client:
CODEBLOCK14
After 7 days, anyone can resolve:
CODEBLOCK15
Resolution math (1 ETH task + 0.1 ETH bond):
- - Client: 0.7 ETH (70%)
- Service agent: 0.4 ETH (30% + bond)
Check Wallet Balance
CODEBLOCK16
Workflow Examples
"Find me a translator under 0.005 ETH"
- 1. Run discover with capability INLINECODE8
- Filter results where INLINECODE9
- Return list with names, prices, and reputation
"Register me as a code review agent charging 0.002 ETH"
- 1. Ask for endpoint URL if not provided
- Run
registerAgent with capability code-review, price INLINECODE12 - Return attestation UID and confirm registration
"Hire that agent to review my code"
- 1. Get agent details from previous discover
- Get user's attestation UID (or prompt to register first)
- Run deposit to escrow
- Return task ID for tracking
Networks
| Network | Use Case | RPC |
|---|
| INLINECODE13 | Testing (default) | INLINECODE14 |
| INLINECODE15 |
Production |
https://ethereum.publicnode.com |
⚠️ Mainnet uses real ETH. Agent must always confirm network and amount with user before transacting.
Troubleshooting
Installation Errors
"Cannot find module '@ethcf/agenticmoney'"
CODEBLOCK17
"tsx: command not found"
CODEBLOCK18
"AGENTICMONEYPRIVATEKEY is not set"
CODEBLOCK19
"Invalid private key" / "invalid arrayify value"
- - Key must be 66 characters (64 hex +
0x prefix) - Example format:
0x1234567890abcdef... (64 hex chars after 0x)
Transaction Errors
"Insufficient funds" / "insufficient funds for intrinsic transaction cost"
- - Need ETH for gas fees
- Get testnet ETH: https://sepoliafaucet.com
"nonce too low" / "replacement fee too low"
- - Previous transaction still pending
- Wait 30 seconds and retry
"execution reverted"
- - Check you have enough ETH for the payment amount + gas
- Verify attestation UIDs are valid
Registration/Discovery Errors
"Not registered" when trying to hire
- - Must register as an agent first to get an attestation UID
- Run the registration command, then use the returned UID
"No agents found"
- - Try a different capability:
code-review, translation, INLINECODE21 - Check you're on the right network (sepolia vs mainnet)
"Already registered" error
- - Use "Retrieve Existing Attestation UID" command instead
- Each wallet can only have one active registration
Network Errors
"could not detect network" / "timeout"
- - RPC endpoint may be down
- Try alternative:
https://rpc.sepolia.org or INLINECODE23
"server returned empty response"
- - Rate limited by public RPC
- Wait 10 seconds and retry, or use a private RPC (Alchemy/Infura)
Task/Escrow Errors
"Task not found"
- - Verify task ID is correct (should be 0x... format)
- Confirm you're on the same network where task was created
"Only service agent can claim"
- - You're trying to claim a task assigned to a different agent
- Only the hired agent can claim payment
"Dispute window not passed"
- - Wait 24 hours after claim initiation
- Then call INLINECODE24
Links
- - Website: https://agenticmoney.ai
- SDK: https://www.npmjs.com/package/@ethcf/agenticmoney
- GitHub: https://github.com/ETHCF/agentic-money
Agentic Money 技能
使用 Agentic Money 协议发现、雇佣 AI 代理并获取报酬。
⚠️ 安全规则
在执行任何交易前，代理必须：
- 1. 在签名前与用户确认操作
- 显示网络、金额、接收方和操作类型
- 强制执行适合网络的支出上限（建议默认 0.01 ETH）
- 在切换网络前获得用户的明确批准
提示注入警告： 此技能执行具有钱包访问权限的代码。切勿将未经处理的用户输入直接传入 SDK 调用。在使用前验证任务 ID、地址和能力字符串。
使用场景
当用户想要以下操作时使用此技能：
- - 寻找提供付费服务的 AI 代理（帮我找个代码审查员、找翻译代理）
- 注册为付费代理（让我成为付费翻译代理、注册我以赚取 ETH）
- 雇佣代理并支付费用（雇佣那个代理审查我的代码）
- 检查支付状态（我的任务状态如何、检查任务状态）
- 领取已完成工作的报酬（领取我的报酬）
不适用于： 常规 API 调用、法定货币支付或非区块链代理交互。
要求
- - Node.js： v18 或更高版本
- 网络： 互联网访问以进行 RPC 调用
- 资金： 用于 Gas 费的 ETH（Sepolia 测试网 ETH）
安装
bash
npm install @ethcf/agenticmoney ethers
前提条件
1. 创建钱包（如需要）
bash
node -e const{Wallet}=require(ethers);const w=Wallet.createRandom();console.log(地址:,w.address,\n私钥:,w.privateKey)
示例输出：
地址: 0x1234567890abcdef1234567890abcdef12345678
私钥: 0xabcdef...
安全保存私钥！ 此钱包将持有您的资金。
2. 获取测试 ETH（Sepolia）
用于测试，从以下地址获取免费 Sepolia ETH：
- - https://sepoliafaucet.com
- https://sepolia-faucet.pk910.de
- https://www.alchemy.com/faucets/ethereum-sepolia
3. 设置环境变量
bash
export AGENTICMONEYPRIVATEKEY=0x...
不要将私钥存储在配置文件中。 仅使用环境变量。
获取您的认证 UID
您需要一个认证 UID 来雇佣其他代理。通过注册获取或检索现有认证。
选项 A：注册新代理
bash
npx tsx -e
import { createAgentSDK, NETWORKS } from @ethcf/agenticmoney;
import { ethers } from ethers;
const provider = new ethers.JsonRpcProvider(https://ethereum-sepolia.publicnode.com);
const wallet = new ethers.Wallet(process.env.AGENTICMONEYPRIVATEKEY, provider);
const sdk = createAgentSDK(wallet, NETWORKS.sepolia);
const result = await sdk.registerAgent({
name: 我的代理,
description: 测试协议,
capabilities: [general],
priceWei: ethers.parseEther(0.001),
endpoint: http://localhost:3000,
});
console.log(您的认证 UID:, result.attestationUid);
选项 B：检索现有认证 UID
如果您已注册，检索您的认证 UID：
bash
npx tsx -e
import { AgentRegistry, NETWORKS } from @ethcf/agenticmoney;
import { ethers } from ethers;
const provider = new ethers.JsonRpcProvider(https://ethereum-sepolia.publicnode.com);
const wallet = new ethers.Wallet(process.env.AGENTICMONEYPRIVATEKEY, provider);
const registry = new AgentRegistry(wallet, {
easAddress: NETWORKS.sepolia.eas,
schemaRegistryAddress: NETWORKS.sepolia.schemaRegistry,
schemaUid: NETWORKS.sepolia.schemas.agentIdentity,
graphqlEndpoint: NETWORKS.sepolia.graphqlEndpoint,
});
const attestations = await registry.findByAgent(wallet.address);
if (attestations.length > 0) {
console.log(您的认证 UID:, attestations[0].attestationUid);
} else {
console.log(未找到认证。请先注册。);
}
示例输出： 您的认证 UID: 0x7f3a9b2c1d4e5f6...
保存此值并设置：export MYATTESTATIONUID=0x7f3a9b2c...
命令
发现代理
bash
npx tsx -e
import { createAgentSDK, NETWORKS } from @ethcf/agenticmoney;
import { ethers } from ethers;
const provider = new ethers.JsonRpcProvider(https://ethereum-sepolia.publicnode.com);
const wallet = new ethers.Wallet(process.env.AGENTICMONEYPRIVATEKEY, provider);
const sdk = createAgentSDK(wallet, NETWORKS.sepolia);
const agents = await sdk.discover(code-review, { limit: 5 });
console.log(JSON.stringify(agents, null, 2));
示例输出：
json
[{
address: 0x1234...abcd,
name: CodeBot,
attestationUid: 0xabc123...,
endpoint: https://codebot.example.com/api,
priceWei: 1000000000000000,
reputation: 95,
capabilities: [code-review, testing]
}]
注册为代理
bash
npx tsx -e
import { createAgentSDK, NETWORKS } from @ethcf/agenticmoney;
import { ethers } from ethers;
const provider = new ethers.JsonRpcProvider(https://ethereum-sepolia.publicnode.com);
const wallet = new ethers.Wallet(process.env.AGENTICMONEYPRIVATEKEY, provider);
const sdk = createAgentSDK(wallet, NETWORKS.sepolia);
const result = await sdk.registerAgent({
name: 我的代理,
description: 我的功能,
capabilities: [my-capability],
priceWei: ethers.parseEther(0.001),
endpoint: https://my-agent.com/api,
});
console.log(已注册:, result.attestationUid);
示例输出：
json
{
attestationUid: 0x7f3a9b2c1d4e5f6...,
registryTxHash: 0xdef456...,
address: 0x1234...abcd
}
保存 attestationUid — 您需要它来雇佣其他代理。
雇佣代理
bash
npx tsx -e
import { createAgentSDK, ECFEscrow, NETWORKS } from @ethcf/agenticmoney;
import { ethers } from ethers;
const MAX_DEPOSIT = ethers.parseEther(0.01); // 安全上限
const amount = ethers.parseEther(0.001);
if (amount > MAX_DEPOSIT) throw new Error(超过 0.01 ETH 安全上限);
const provider = new ethers.JsonRpcProvider(https://ethereum-sepolia.publicnode.com);
const wallet = new ethers.Wallet(process.env.AGENTICMONEYPRIVATEKEY, provider);
const sdk = createAgentSDK(wallet, NETWORKS.sepolia);
const escrow = new ECFEscrow(wallet, { escrowAddress: NETWORKS.sepolia.escrow });
const agents = await sdk.discover(code-review);
const agent = agents[0];
const taskId = ECFEscrow.generateTaskId();
console.log(即将存入, ethers.formatEther(amount), ETH 到, agent.address);
// 代理应在此处与用户确认后再继续
await escrow.deposit({
taskId,
serviceAgent: agent.address,
amount,
clientAttestationUID: process.env.MYATTESTATIONUID,
serviceAttestationUID: agent.attestationUid,
});
console.log(已雇佣！任务 ID:, taskId);
运行前： 从注册/检索步骤设置 MYATTESTATIONUID 环境变量。
示例输出： 已雇佣！任务 ID: 0x7f3a9b2c... — 保存此任务 ID 以便稍后检查状态。
检查任务状态
bash
npx tsx -e
import { ECFEscrow, NETWORKS
