Tạo Ví Tác nhân
Mỗi tác nhân có ví MPC được bảo mật riêng. Chỉ định chuỗi và chính sách ban đầu tại thời điểm tạo.
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}`);
Nạp tiền vào Ví
Gửi token đến địa chỉ ví tác nhân. Địa chỉ ví là địa chỉ on-chain tiêu chuẩn có thể nhận token từ bất kỳ nguồn nào.
Ở chế độ sandbox (eip155:84532), sử dụng faucet testnet để nhận token thử nghiệm. Không cần quỹ thực.
Đối với hoạt động x402, bạn cũng có thể nạp tiền qua endpoint số dư:
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"}'
Gửi Thanh toán
Thực hiện thanh toán on-chain thông qua tác nhân. Giao dịch đi qua công cụ chính sách và ký MPC trước khi phát sóng.
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
Kiểm tra Số dư
Truy vấn số dư x402 cho tác nhân:
curl -X GET https://api.agentwallex.com/api/v1/x402/balances \
-H "X-API-Key: awx_your_api_key"
Liệt kê Giao dịch
Xem lịch sử giao dịch cho tác nhân:
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})`);
});
Đóng băng và Mở đóng băng
Dừng ngay lập tức mọi giao dịch cho tác nhân. Hữu ích cho trường hợp khẩn cấp hoặc bảo trì theo lịch.
Đóng băng
await aw.agents.freeze("agent_abc123");
// All transactions are now blocked
Mở đóng băng
// Subject to 10-minute cool-down after freeze
await aw.agents.unfreeze("agent_abc123");
Có thời gian chờ bắt buộc 10 phút sau khi đóng băng trước khi bạn có thể mở đóng băng. Cố gắng mở đóng băng sớm hơn sẽ trả về lỗi.
Xóa Tác nhân
Xóa vĩnh viễn tác nhân và ví của nó. Hành động này không thể hoàn tác.
curl -X DELETE https://api.agentwallex.com/api/v1/agents/agent_abc123 \
-H "X-API-Key: awx_your_api_key"
Đảm bảo số dư ví bằng không trước khi xóa. Bất kỳ quỹ còn lại nào sẽ không thể truy cập được sau khi xóa.