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

Điều kiện tiên quyết

  • Node.js 18+ hoặc Python 3.9+
  • Khóa API AgentWallex (awx_...) — đăng ký truy cập sớm
  • Hiểu biết cơ bản về giao dịch blockchain

Cài đặt

npm install @agentwallex/sdk

Tích hợp từng bước

1

Khởi tạo client

Tạo client AgentWallex với khóa API của bạn. Sử dụng sandbox để thử nghiệm và production cho mainnet.
import { AgentWallex } from "@agentwallex/sdk";

const aw = new AgentWallex({
  apiKey: process.env.AGENTWALLEX_API_KEY!,
  environment: "sandbox", // use "production" for mainnet
});
2

Tạo ví tác nhân

Mỗi tác nhân có ví MPC được bảo mật riêng với các chính sách có thể cấu hình.
const agent = await aw.agents.create({
  name: "my-trading-agent",
  chain: "eip155:84532",
  policies: {
    maxTransactionAmount: "100",   // USDC
    dailyLimit: "1000",
    allowedAddresses: ["0x..."],
  },
});

console.log(`Agent ID: ${agent.id}`);
console.log(`Wallet: ${agent.wallet.address}`);
3

Nạp tiền vào ví

Gửi token testnet đến địa chỉ ví tác nhân của bạn. Trên Base Sepolia, bạn có thể sử dụng faucet để nhận USDC thử nghiệm.
Ở chế độ sandbox, ví tác nhân của bạn nằm trên testnet. Không có quỹ thực nào bị rủi ro.
4

Gửi thanh toán

Thực hiện thanh toán on-chain thông qua tác nhân.
const tx = await aw.payments.send({
  agentId: agent.id,
  to: "0xRecipientAddress",
  amount: "10.00",
  token: "USDC",
});

console.log(`Transaction hash: ${tx.hash}`);
console.log(`Status: ${tx.status}`); // "confirmed"

Những gì diễn ra bên trong

  1. Kiểm tra Chính sách — Công cụ chính sách xác thực giao dịch dựa trên quy tắc của tác nhân (giới hạn chi tiêu, danh sách địa chỉ cho phép, kiểm soát tốc độ).
  2. Ký MPC — Giao dịch được ký bằng MPC ngưỡng 2-trong-3. Không bên đơn lẻ nào nắm giữ toàn bộ khóa.
  3. Phát sóng — Giao dịch đã ký được gửi lên mạng lưới.
  4. Xác nhận — AgentWallex theo dõi và xác nhận giao dịch, sau đó gửi sự kiện webhook.

Bước tiếp theo

TypeScript SDK

Tài liệu SDK đầy đủ với tất cả phương thức và kiểu dữ liệu.

REST API

Các endpoint HTTP cho tích hợp tùy chỉnh.

Thanh toán nhỏ x402

Kích hoạt thanh toán theo cuộc gọi API cho tác nhân của bạn.

Công cụ Chính sách

Cấu hình kiểm soát chi tiêu và quy tắc bảo mật.