메인 콘텐츠로 건너뛰기

​
사전 요구 사항

  • Node.js 18+ 또는 Python 3.9+
  • AgentWallex API 키 (awx_...) — 조기 액세스 신청
  • 블록체인 거래에 대한 기본 이해

​
설치

npm install @agentwallex/sdk

​
단계별 통합

1

클라이언트 초기화

API 키로 AgentWallex 클라이언트를 생성합니다. 테스트에는 sandbox를, 메인넷에는 production을 사용하세요.
import { AgentWallex } from "@agentwallex/sdk";

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

에이전트 지갑 생성

각 에이전트는 구성 가능한 정책이 적용된 자체 MPC 보안 지갑을 받습니다.
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

지갑에 자금 입금

에이전트의 지갑 주소로 테스트넷 토큰을 전송합니다. Base Sepolia에서는 파우셋을 사용하여 테스트 USDC를 받을 수 있습니다.
샌드박스 모드에서는 에이전트 지갑이 테스트넷에 있습니다. 실제 자금은 위험에 처하지 않습니다.
4

결제 전송

에이전트를 통해 온체인 결제를 실행합니다.
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"

​
내부 동작 원리

  1. 정책 검사 — 정책 엔진이 에이전트의 규칙(지출 한도, 주소 화이트리스트, 속도 제어)에 따라 거래를 검증합니다.
  2. MPC 서명 — 2-of-3 임계값 MPC를 사용하여 거래에 서명합니다. 단일 당사자가 전체 키를 보유하지 않습니다.
  3. 브로드캐스트 — 서명된 거래가 네트워크에 제출됩니다.
  4. 확인 — AgentWallex가 거래를 모니터링하고 확인한 후 웹훅 이벤트를 전달합니다.

​
다음 단계

TypeScript SDK

모든 메서드와 타입을 포함한 전체 SDK 레퍼런스입니다.

REST API

커스텀 통합을 위한 HTTP 엔드포인트입니다.

x402 소액 결제

에이전트의 API 호출당 결제를 활성화하세요.

정책 엔진

지출 제어 및 보안 규칙을 구성하세요.