Chuyển đến nội dung chính

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.