kya — Know Your Agent

Trust scoring for AI agents. Check any wallet's trust score, verify ERC-8004 identity, get tier. Zero dependencies.

npm install agent-kya

Also available as: pip install agent-kya

Quick start

import kya from 'agent-kya';

// Trust score (0–100) — FREE, no API key
const { score, tier } = await kya.check('0xABC...');
console.log(score); // 73
console.log(tier);  // 'trusted'

// Quick boolean
if (await kya.isTrusted('0xABC...', 50)) {
  // safe to transact
}

Why

Every AI agent that transacts with another agent needs to answer one question: should I trust this address?

kya answers it in one line. No signup, no API key, no payment for basic checks.

API

Free (no API key)

Function	What it does
kya.check(address)	Trust score 0–100, tier, components, blocked status
kya.verify(address)	ERC-8004 identity verification (registered agent?)
kya.tier(address)	Trust tier + transaction limits
kya.batchCheck(addresses)	Batch trust check (max 10)
kya.framework()	Scoring methodology, tiers, endpoints
kya.isTrusted(address, minScore?)	Quick boolean: score ≥ minScore and not blocked

Premium ($0.01/query via x402)

Function	What it does
kya.deepAnalysis(address)	Behavioral signals, velocity scoring, anomaly flags, recommendation

Examples

Check before paying another agent

import kya from 'kya';

async function payAgent(agentAddress: string, amount: number) {
  const trust = await kya.check(agentAddress);

  if (trust.blocked) throw new Error('Agent is sanctioned');
  if (trust.score < 20) throw new Error('Trust too low');

  // Proceed with payment...
}

Verify ERC-8004 identity

const { verified, agentId } = await kya.verify('0x...');
if (!verified) {
  console.log('Not a registered agent');
}

Batch check multiple agents

const results = await kya.batchCheck([
  '0xAgent1...',
  '0xAgent2...',
  '0xAgent3...',
]);
results.forEach(r => console.log(r.address, r.score, r.tier));

Deep analysis (paid)

const deep = await kya.deepAnalysis('0x...');
console.log(deep.recommendation); // 'allow' | 'review' | 'block'
console.log(deep.behavioral.anomalyFlags);

Custom API endpoint

import kya from 'agent-kya';

kya.configure({ baseUrl: 'https://my-kya-server.com' });

Trust tiers

Tier	Score	Max per TX	Requirements
Open	0–19	$1	Wallet + sanctions pass
Verified	20–49	$1,000	ERC-8004 identity + wallet history
Trusted	50–79	$10,000	Operator KYB + Travel Rule
Enterprise	80–100	Unlimited	Full KYB + trust bond + SLA

How it works

kya queries the AsterPay KYA API which aggregates:

1. On-chain identity — ERC-8004 registration on Base
2. Wallet history — age, transaction count, balance patterns
3. Behavioral signals — velocity, pattern analysis, anomaly detection
4. Sanctions screening — OFAC, EU, UN sanctions lists

All free endpoints require no authentication. The API is rate-limited but generous for normal use.

Framework integrations

• LangChain: pip install asterpay[langchain]
• CrewAI: pip install asterpay[crewai]
• MCP Server: npx @asterpay/mcp-server
• AgentKit: npm install @asterpay/agentkit-kya

License

MIT — AsterPay