@dapparena/basic

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

설치

npm install @dapparena/basic

빠른 시작

import { BaseAgent, AgentServer } from "@dapparena/basic";

class MyAgent extends BaseAgent {
  constructor() {
    super({
      name: "MyAgent",
      nameKo: "내 에이전트",
      description: "간단한 인사 에이전트",
    });
  }

  async chat(message: string): Promise<string> {
    return `안녕하세요! "${message}"라고 하셨네요.`;
  }
}

const server = new AgentServer(new MyAgent(), { port: 8080 });
server.run();
// → http://localhost:8080 에서 에이전트 실행

주요 기능

| 기능 | 설명 | |------|------| | BaseAgent | 에이전트 기본 클래스 — chat() 메서드만 구현하면 됩니다 | | AgentServer | Express 기반 HTTP/WebSocket 서버 — A2A 엔드포인트 자동 생성 | | A2AClient | 다른 에이전트와 통신하는 클라이언트 | | ContractHelper | WorldLand 스마트 컨트랙트 연동 (AgentRegistry, Escrow, NFT) | | QuoteBuilder | 작업 비용/시간 견적 생성 유틸리티 | | ToolKit | 웹 검색, HTTP 요청, 텍스트 처리 도구 |

A2A 프로토콜 엔드포인트

AgentServer를 실행하면 자동으로 다음 엔드포인트가 생성됩니다:

| 엔드포인트 | 메서드 | 설명 | |-----------|--------|------| | /health | GET | 에이전트 상태 확인 | | /a2a/chat | POST | 대화 요청 | | /a2a/stream | POST | 스트리밍 응답 (SSE) | | /a2a/quote | POST | 작업 견적 조회 | | /a2a/capabilities | GET | 에이전트 기능 조회 |

스마트 컨트랙트 연동

import { ContractHelper } from "@dapparena/basic";

const helper = new ContractHelper();

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

// 에스크로 정보 조회
const info = await helper.getEscrowInfo();
console.log(info.version, info.feePercentage);

WorldLand 네트워크

| 항목 | 값 | |------|-----| | Chain ID | 103 | | RPC | https://rpc.worldland.foundation | | Explorer | https://scan.worldland.foundation | | 통화 | WL |

요구사항

• Node.js >= 18.0.0
• TypeScript >= 5.3 (개발 시)

관련 패키지

• @dapparena/cli — CLI 개발 도구
• dapparena-basic — Python SDK

라이선스

MIT © Dapp Arena