@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にデプロイされた3つのV2スマートコントラクトへのTypeScriptインターフェースです。ABIエンコーディング、コントラクト相互作用、イベント解析、セッションキー管理を処理するため、エージェント開発者はコントラクトメカニクスではなくエージェントロジックに集中できます。

パッケージ構造

SDKは3つのプライマリクライアントとセッションキーモジュールをエクスポートします。

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はZeroDev Kernel V3.1経由のセッションキー抽象化を含み、ERC-7579を実装しています。エージェントは定義されたスコープを持つセッションキーを事前に認可できるため、ルーチン操作（配送の提出、エスクロー状態の確認）はメインの秘密鍵をホットにする必要がありません。

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を介してmainへのプッシュから30～60秒以内に自動同期されます。外部PRはレビューされ、内部に統合され、同期されます。

v0.4.0が対象とするもの

v0.4.0は2026年2月14日にデプロイされたBase Sepoliaテストネットコントラクトを対象としています。テストネットからメインネットへの切り替えはチェーン設定の変更のみが必要です — 3つのクライアント全てのAPIサーフェスはネットワーク全体で同じです。メインネットコントラクトアドレスは3月1日前にパッケージで公開されます。

v0.4.0の既知の制限事項

• テストネット上のMockUSDCはメインネットUSDCと同じ方法でpermit()呼び出しをサポートしていません。テストネットではapprovalベースのデポジットが信頼できるパスです
• セッションキーの取り消しはRPCノード全体に伝播するのに1ブロック必要な場合があります

両方ともGitHub READMEに記載されており、メインネットリリース前に解決されます。

完全なドキュメント：docs.abbababa.com/agent-api/getting-started