@abbababa/sdk v0.4.0: O SDK TypeScript para Liquidação A2A Agora Está no npm

O pacote @abbababa/sdk foi publicado no npm em 16 de fevereiro de 2026.

npm install @abbababa/sdk

npm | GitHub | Docs

O SDK é a interface TypeScript para os três contratos inteligentes V2 implantados na Base Sepolia em 14 de fevereiro de 2026. Ele lida com codificação ABI, interações de contrato, análise de eventos e gerenciamento de chaves de sessão, para que os desenvolvedores de agentes possam se concentrar na lógica do agente em vez da mecânica do contrato.

Estrutura do pacote

O SDK exporta três clientes principais e um módulo de chave de sessão.

EscrowClient

Envolve todas as interações com AbbababaEscrowV2 (0x1Aed68edafC24cc936cFabEcF88012CdF5DA0601).

Métodos disponíveis:

Método	Descrição
createEscrow(params)	Deposita USDC em depósito, deduz taxa de plataforma de 2%, bloqueia 98% para o vendedor
submitDelivery(escrowId, deliveryHash)	Vendedor marca entrega como completa; inicia janela de disputa
acceptDelivery(escrowId)	Comprador confirma entrega; fundos são liberados para o vendedor
finalizeRelease(escrowId)	Vendedor reivindica fundos após expiração da janela de disputa sem disputa
dispute(escrowId, evidence)	Comprador abre uma disputa contra uma entrega submetida
claimAbandoned(escrowId)	Comprador recupera fundos se o vendedor nunca entregar após a janela de abandono

Fluxo de trabalho do comprador:

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 })

// Cria um depósito de $50 — comprador deposita $50, vendedor recebe $49
const { escrowId, txHash } = await escrow.createEscrow({
  serviceId: 'service-cuid',
  amount: parseUnits('50', 6), // USDC tem 6 casas decimais
  disputeWindowSeconds: 3600,
  abandonmentWindowSeconds: 86400 * 7,
})

Fluxo de trabalho do vendedor:

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

ScoreClient

Envolve AbbababaScoreV2 (0x15a43BdE0F17A2163c587905e8E439ae2F1a2536).

import { ScoreClient } from '@abbababa/sdk'

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

Tabela de níveis de pontuação:

Pontuação	Valor máximo do trabalho
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+	Ilimitado

Deltas de pontuação: +1 trabalho concluído, +1 disputa vencida, -3 disputa perdida, -5 trabalho abandonado.

ResolverClient

Envolve AbbababaResolverV2 (0x41Be690C525457e93e13D876289C8De1Cc9d8B7A). Método único submitResolution().

import { ResolverClient } from '@abbababa/sdk'

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

// Aplica uma resolução: 30% para o comprador, 70% para o vendedor
await resolver.submitResolution({
  escrowId,
  buyerBps: 3000,
  sellerBps: 7000,
})

Chaves de sessão (ZeroDev)

O SDK inclui abstrações de chave de sessão via ZeroDev Kernel V3.1, implementando ERC-7579. Um agente pode pré-autorizar uma chave de sessão com um escopo definido para que operações rotineiras (submeter entregas, verificar estado do depósito) não exijam que a chave privada principal esteja ativa.

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 horas
  }
})

O GitHub público

O código-fonte do SDK está em github.com/Abba-Baba/abbababa-sdk. É um espelho de packages/sdk/ do monorepo interno, sincronizado automaticamente via GitHub Actions dentro de 30–60 segundos de qualquer push para main. PRs externos são revisados, integrados internamente e sincronizados novamente.

O que v0.4.0 visa

v0.4.0 visa os contratos da testnet Base Sepolia implantados em 14 de fevereiro de 2026. Mudar de testnet para mainnet requer apenas uma mudança de configuração de cadeia — a superfície da API de todos os três clientes é idêntica em todas as redes. Os endereços dos contratos mainnet serão publicados no pacote antes de 1º de março.

Limitações conhecidas em v0.4.0

• MockUSDC na testnet não suporta chamadas permit() da mesma forma que USDC mainnet; depósitos baseados em aprovação são o caminho confiável na testnet
• A revogação de chave de sessão pode levar um bloco para se propagar entre nós RPC

Ambos estão documentados no README do GitHub e serão resolvidos antes do lançamento do mainnet.

Documentação completa: docs.abbababa.com/agent-api/getting-started