エージェントウォレットの作成
各エージェントは独自のMPCセキュアなウォレットを取得します。作成時にチェーンと初期ポリシーを指定します。const agent = await aw.agents.create({
name: "payment-agent",
chain: "eip155:8453", // Base mainnet
policies: {
maxTransactionAmount: "500",
dailyLimit: "5000",
allowedTokens: ["USDC"],
},
metadata: { team: "growth" },
});
console.log(`Agent ID: ${agent.id}`);
console.log(`Wallet address: ${agent.wallet.address}`);
console.log(`Chain: ${agent.wallet.chain}`);
agent = await aw.agents.create(
name="payment-agent",
chain="eip155:8453",
policies={
"max_transaction_amount": "500",
"daily_limit": "5000",
"allowed_tokens": ["USDC"],
},
metadata={"team": "growth"},
)
print(f"Agent ID: {agent.id}")
print(f"Wallet address: {agent.wallet.address}")
curl -X POST https://api.agentwallex.com/api/v1/agents \
-H "X-API-Key: awx_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"agent_name": "payment-agent",
"chain": "eip155:8453",
"metadata": "{\"team\":\"growth\"}"
}'
ウォレットへの入金
エージェントのウォレットアドレスにトークンを送信します。ウォレットアドレスは、任意のソースからトークンを受信できる標準のオンチェーンアドレスです。サンドボックスモード（
eip155:84532）では、テストネットフォーセットを使用してテストトークンを取得します。実際の資金は不要です。curl -X POST https://api.agentwallex.com/api/v1/x402/balances/deposit-address \
-H "X-API-Key: awx_your_api_key" \
-H "Content-Type: application/json" \
-d '{"agent_id": "agent_abc123", "chain": "eip155:8453"}'
支払いの送信
エージェントを通じてオンチェーン決済を実行します。トランザクションはブロードキャスト前にポリシーエンジンとMPC署名を通過します。const tx = await aw.payments.send({
agentId: "agent_abc123",
to: "0xRecipientAddress",
amount: "50.00",
token: "USDC",
memo: "Payment for API access",
});
console.log(`Transaction ID: ${tx.id}`);
console.log(`Hash: ${tx.hash}`);
console.log(`Status: ${tx.status}`); // "pending" -> "confirmed"
console.log(`Fee: ${tx.fee}`); // Network gas fee
tx = await aw.payments.send(
agent_id="agent_abc123",
to="0xRecipientAddress",
amount="50.00",
token="USDC",
memo="Payment for API access",
)
print(f"Hash: {tx.hash}")
print(f"Status: {tx.status}")
curl -X POST https://api.agentwallex.com/api/v1/transactions \
-H "X-API-Key: awx_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "agent_abc123",
"direction": "outbound",
"type": "transfer",
"to_address": "0xRecipientAddress",
"amount": "50.00",
"token": "USDC",
"chain": "eip155:8453",
"memo": "Payment for API access"
}'
残高の確認
エージェントのx402残高を照会します：curl -X GET https://api.agentwallex.com/api/v1/x402/balances \
-H "X-API-Key: awx_your_api_key"
トランザクションの一覧表示
エージェントのトランザクション履歴を表示します：const { transactions } = await aw.payments.list({
agentId: "agent_abc123",
limit: 50,
status: "confirmed",
});
transactions.forEach(tx => {
console.log(`${tx.amount} ${tx.token} -> ${tx.to} (${tx.status})`);
});
curl -X GET "https://api.agentwallex.com/api/v1/transactions?agent_id=agent_abc123&status=confirmed&page_size=50" \
-H "X-API-Key: awx_your_api_key"
凍結と凍結解除
エージェントのすべてのトランザクションを即座に停止します。緊急時や計画メンテナンスに便利です。凍結
await aw.agents.freeze("agent_abc123");
// All transactions are now blocked
curl -X PUT https://api.agentwallex.com/api/v1/agents/agent_abc123/status \
-H "X-API-Key: awx_your_api_key" \
-H "Content-Type: application/json" \
-d '{"status": "inactive"}'
凍結解除
// Subject to 10-minute cool-down after freeze
await aw.agents.unfreeze("agent_abc123");
curl -X PUT https://api.agentwallex.com/api/v1/agents/agent_abc123/status \
-H "X-API-Key: awx_your_api_key" \
-H "Content-Type: application/json" \
-d '{"status": "active"}'
凍結後、凍結解除するまでに10分間の必須クールダウン期間があります。それより早く凍結解除しようとするとエラーが返されます。
エージェントの削除
エージェントとそのウォレットを永久に削除します。この操作は取り消せません。curl -X DELETE https://api.agentwallex.com/api/v1/agents/agent_abc123 \
-H "X-API-Key: awx_your_api_key"
削除前にウォレット残高がゼロであることを確認してください。削除後に残った資金にはアクセスできなくなります。