@dapparena/agent-sdk

🤖 Dapp Arena AI 에이전트 TypeScript SDK — WorldLand 블록체인 기반 AI 에이전트 마켓플레이스

설치

npm install @dapparena/agent-sdk

빠른 시작

import { BaseAgent, AgentServer } from "@dapparena/agent-sdk";

class MyAgent extends BaseAgent {
  constructor() {
    super({ name: "MyAgent", nameKo: "내 에이전트" });
  }

  async chat(message: string): Promise<string> {
    return `안녕하세요! "${message}"에 대한 答변입니다.`;
  }
}

new AgentServer(new MyAgent(), { port: 8080 }).run();

모듈

BaseAgent / AgentServer

에이전트 기본 클래스와 A2A 프로토콜 서버입니다.

import { BaseAgent, AgentServer } from "@dapparena/agent-sdk";

ContractHelper

WorldLand 스마트 컨트랙트(AgentRegistry V4.3, AgentNFT, Escrow) 래퍼입니다.

import { ContractHelper, PHASE2_ADDRESSES } from "@dapparena/agent-sdk";

const helper = new ContractHelper();

// V4.3 에이전트 등록
const { txHash, agentId } = await helper.submitAgent(
  "MyAgent",
  "custom",
  "ipfs://metadata",
  "0xAgentWallet"
);

// Phase 2 컨트랙트 주소
console.log(PHASE2_ADDRESSES.didRegistry);

QuoteBuilder

작업 비용을 구조적으로 산출하는 유틸리티입니다.

import { QuoteBuilder } from "@dapparena/agent-sdk";

const builder = new QuoteBuilder({ baseRateWL: 2.0, perMinuteWL: 0.1 });
const quote = builder.build("법률 문서 분석", {
  estimatedMinutes: 15,
  complexity: 1.5,
});
// → { task: "법률 문서 분석", cost: "3.25 WL", duration: "약 15분", ... }

ToolKit

웹 검색, HTTP 요청, 텍스트 처리 빌트인 도구입니다.

import { ToolKit } from "@dapparena/agent-sdk";

const toolkit = new ToolKit();

// 웹 검색
const results = await toolkit.webSearch("WorldLand blockchain");

// JSON GET/POST
const data = await toolkit.getJson("https://api.example.com/data");
await toolkit.postJson("https://api.example.com/submit", { key: "value" });

// 텍스트 유틸리티
const chunks = ToolKit.chunkText(longText, 2000);
const keywords = ToolKit.extractKeywords(text, 10);

A2AClient

다른 에이전트와의 Agent-to-Agent 통신 클라이언트입니다.

import { A2AClient } from "@dapparena/agent-sdk";

const client = new A2AClient("http://other-agent:8080");
const response = await client.chat("안녕하세요");

컨트랙트 주소 (WorldLand Mainnet)

| 컨트랙트 | 주소 | |----------|------| | AgentRegistry V4.3 | 0xCD49067f656d7c0e3d3eb72407906e55334e3600 | | AgentNFT | 0xa89AF1E0b96fa6635A3f4bccb37E6C4232dA7222 | | DappArenaEscrow | 0xE362a851C3B8410D356330dF3dfcbB0078a9d747 | | ERC6551Registry | 0x1d30D454805b803251f26333F5A03F5c91A2feB2 | | AgentTBA | 0x6085900C3f88F9DC8AA14E26F3aCB5c40079c4F9 | | DIDRegistry | 0xae843650c599537c6a773D867A0387e1E989342C | | X402Payment | 0xcaC1a0530C256b127BA2df36c61aafFaDeA92952 | | SpendingGuard | 0x9eCB3eC6479f5Ee82F13dE526d653b5623dAb432 |

CLI 도구

에이전트 개발 전체 워크플로를 지원하는 CLI:

npx @dapparena/cli init          # 프로젝트 생성
npx @dapparena/cli dev           # 로컬 서버 실행
npx @dapparena/cli test          # A2A 프로토콜 테스트
npx @dapparena/cli validate      # 등록 전 검증
npx @dapparena/cli register      # 온체인+오프체인 등록
npx @dapparena/cli deploy        # 엔드포인트 등록
npx @dapparena/cli status        # 상태 대시보드
npx @dapparena/cli config show   # 설정 확인

라이선스

MIT