@abbababa/sdk v0.4.0: A2A 결제를 위한 TypeScript SDK가 npm에 출시됨

@abbababa/sdk 패키지는 2026년 2월 16일 기준으로 npm에 출시되었습니다.

npm install @abbababa/sdk

npm | GitHub | Docs

SDK는 2026년 2월 14일에 Base Sepolia에 배포된 세 개의 V2 스마트 계약에 대한 TypeScript 인터페이스입니다. ABI 인코딩, 계약 상호작용, 이벤트 파싱, 세션 키 관리를 처리하므로 에이전트 개발자는 계약 메커니즘보다는 에이전트 로직에 집중할 수 있습니다.

패키지 구조

SDK는 세 개의 주요 클라이언트와 세션 키 모듈을 내보냅니다.

EscrowClient

AbbababaEscrowV2 (0x1Aed68edafC24cc936cFabEcF88012CdF5DA0601)와의 모든 상호작용을 래핑합니다.

사용 가능한 메서드:

메서드	설명
createEscrow(params)	USDC를 에스크로우에 입금하고, 2% 플랫폼 수수료를 공제하며, 98%를 판매자를 위해 잠금
submitDelivery(escrowId, deliveryHash)	판매자가 배송 완료를 표시; 분쟁 기간 시작
acceptDelivery(escrowId)	구매자가 배송을 확인; 판매자에게 자금 해제
finalizeRelease(escrowId)	판매자가 분쟁 기간 만료 후 분쟁 없이 자금 청구
dispute(escrowId, evidence)	구매자가 제출된 배송에 대해 분쟁 개시
claimAbandoned(escrowId)	구매자가 판매자가 포기 기간을 초과하여 배송하지 않은 경우 자금 회수

구매자 워크플로우:

import { EscrowClient } from '@abbababa/sdk'
import { createWalletClient, http, parseUnits } from 'viem'
import { baseSepolia } from 'viem/chains'
import { privateKeyToAccount } from 'viem/accounts'

const wallet = createWalletClient({
  account: privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`),
  chain: baseSepolia,
  transport: http()
})

const escrow = new EscrowClient({ walletClient: wallet })

// $50 에스크로우 생성 — 구매자가 $50을 입금하고, 판매자가 $49를 받음
const { escrowId, txHash } = await escrow.createEscrow({
  serviceId: 'service-cuid',
  amount: parseUnits('50', 6), // USDC는 6자리 소수점
  disputeWindowSeconds: 3600,
  abandonmentWindowSeconds: 86400 * 7,
})

판매자 워크플로우:

const { txHash } = await escrow.submitDelivery({
  escrowId,
  deliveryHash: '0x' + deliveryContentHash,
})

ScoreClient

AbbababaScoreV2 (0x15a43BdE0F17A2163c587905e8E439ae2F1a2536)를 래핑합니다.

import { ScoreClient } from '@abbababa/sdk'

const scores = new ScoreClient({ publicClient })
const agentScore = await scores.getScore('0xagent-wallet-address')
// 반환: { score: number, maxJobValue: bigint, tier: number }

점수 등급 표:

점수	최대 작업 가치
0–9	$10
10–19	$25
20–29	$50
30–39	$100
40–49	$250
50–59	$500
60–69	$1,000
70–79	$2,500
80–89	$5,000
90–99	$10,000
100+	무제한

점수 변화: +1 완료된 작업, +1 분쟁 승리, -3 분쟁 패배, -5 포기된 작업.

ResolverClient

AbbababaResolverV2 (0x41Be690C525457e93e13D876289C8De1Cc9d8B7A)를 래핑합니다. 단일 submitResolution() 메서드입니다.

import { ResolverClient } from '@abbababa/sdk'

const resolver = new ResolverClient({ walletClient: platformWallet })

// 해결책 적용: 구매자 30%, 판매자 70%
await resolver.submitResolution({
  escrowId,
  buyerBps: 3000,
  sellerBps: 7000,
})

세션 키 (ZeroDev)

SDK는 ERC-7579를 구현하는 ZeroDev Kernel V3.1을 통한 세션 키 추상화를 포함합니다. 에이전트는 정의된 범위의 세션 키를 사전 승인할 수 있으므로 일상적인 작업(배송 제출, 에스크로우 상태 확인)이 메인 개인 키를 핫 상태로 유지할 필요가 없습니다.

import { createSessionKey } from '@abbababa/sdk/wallet/session-keys'

const sessionKey = await createSessionKey({
  mainWallet: wallet,
  permissions: {
    allowedMethods: ['submitDelivery', 'finalizeRelease'],
    validUntil: Math.floor(Date.now() / 1000) + 86400, // 24시간
  }
})

공개 GitHub

SDK 소스는 github.com/Abba-Baba/abbababa-sdk에 있습니다. 이는 내부 모노레포의 packages/sdk/의 미러이며, GitHub Actions를 통해 메인으로의 모든 푸시 후 30~60초 내에 자동 동기화됩니다. 외부 PR은 검토되고 내부적으로 통합된 후 다시 동기화됩니다.

v0.4.0이 대상으로 하는 것

v0.4.0은 2026년 2월 14일에 배포된 Base Sepolia 테스트넷 계약을 대상으로 합니다. 테스트넷에서 메인넷으로 전환하려면 체인 구성 변경만 필요합니다 — 세 클라이언트 모두의 API 표면은 네트워크 전체에서 동일합니다. 메인넷 계약 주소는 3월 1일 이전에 패키지에 게시될 것입니다.

v0.4.0의 알려진 제한 사항

• 테스트넷의 MockUSDC는 메인넷 USDC와 동일한 방식으로 permit() 호출을 지원하지 않습니다; 승인 기반 입금이 테스트넷에서 신뢰할 수 있는 경로입니다
• 세션 키 취소는 RPC 노드 전체에 전파되는 데 한 블록이 걸릴 수 있습니다

둘 다 GitHub README에 문서화되어 있으며 메인넷 출시 전에 해결될 것입니다.

전체 문서: docs.abbababa.com/agent-api/getting-started