Indexing ERC-8004 + x402 protocols

Credit bureau for AI agent wallets.

Compute trust scores from on-chain transaction history. One API call to verify any autonomous agent before transacting.

Documentation →
index.tscurl
import { AgentKarma } from 'agentkarma'

const karma = new AgentKarma()

// Get trust score + tier + role
const { trust_score, tier, role } =
  await karma.getScore('0xABC...DEF')

// Quick gate: is this agent trusted?
if (await karma.isHighTrust(seller)) {
  await agent.pay(seller, amount)
}
Data sourcesERC-8004 Identity RegistryERC-8004 Reputation Registryx402 Payments (Base L2)

Capabilities

Everything you need to assess agent trust.

SDK, API, MCP server, and dashboard. Open source under MIT.

Trust Scoring

6-signal weighted model: loyalty (32%), activity (20%), diversity (18%), feedback (15%), age (9%), recency (6%). Score 0–100 with ERC-8004 registration bonus.

REST API

8 endpoints: /score, /wallet, /wallets, /leaderboard, /transactions, /feedback, /stats. Paginated, filterable, 60s cache, CORS enabled.

TypeScript SDK

Zero-dependency npm package. 7 methods: getScore(), isHighTrust(), meetsThreshold(), lookupWallet(), getTransactions(), getLeaderboard(), getStats().

MCP Server

5 tools: lookup_wallet, get_trust_score, get_wallet_trust_signals, list_wallets, agentkarma_stats. Stdio transport for Claude, GPT, or any MCP-compatible agent.

Public Dashboard

Search any wallet address. View trust score breakdowns. Leaderboard of top-scored agents. Live stats from the API.

Sybil Resistance

Loyalty signal caps wallets with suspiciously concentrated patterns (>20 txns to <3 counterparties). Based on Arbitrum sybil detection research.

Live data

Built for scale.

6,460+
Wallets indexed

Across Ethereum mainnet and Base L2.

4,400
Transactions

x402 payments and ERC-8004 mints.

1,966
Feedback records

On-chain reputation from ERC-8004.

6 Signals
Scoring model

Loyalty, activity, diversity, feedback, age, recency.

$0/mo
Infrastructure cost

Free tier: Alchemy RPC + Neon Postgres.

API First
8 endpoints · 7 SDK methods · 5 MCP tools

REST API on Cloudflare Workers. TypeScript SDK on npm. MCP server for AI agents.

Developer experience

Three lines of code.

From install to trust check in under a minute.

01

Install the SDK

Zero dependencies. Works in Node, Deno, Bun, and browsers.

02

Check trust before paying

Returns true if trust_score >= 80. One line to gate payments.

03

Or get the full score

Returns trust_score, tier, breakdown, role, tx_count, and scored_at.

Use cases

For every type of agent.

Whether you're building buyer agents, seller agents, or managing a fleet.

Buyer-Agent Developers

Gate payments on trust.

Before your AI agent sends USDC to an unknown wallet, check the trust score. isHighTrust() returns a boolean — one line to block scam agents.

const karma = new AgentKarma()

if (await karma.isHighTrust(seller)) {
  await agent.pay(seller, amount)
}

Seller-Agent Developers

Build verifiable reputation.

Every honest transaction improves your score. Loyalty, activity, and diversity signals reward consistent behavior. ERC-8004 registration adds a +5 bonus.

const { trust_score, tier, role } =
  await karma.getScore(myWallet)

// trust_score: 84, tier: "HIGH", role: "seller"

Fleet Managers

Monitor your entire fleet.

Pull the leaderboard or query individual agents. Filter by source (ERC-8004, x402, or both). Paginate through all indexed wallets.

const board = await karma.getLeaderboard({
  limit: 50, source: 'x402'
})
// [{ rank: 1, trust_score: 84, ... }]

FAQ

Frequently asked questions.

Start verifying agents.

One API call. Zero dependencies. MIT licensed.