TypeScript SDK for AgentZone — the unified explorer for trustless AI agents.
ERC-8004 identity + x402 payments + on-chain reputation, all in one SDK.
npm install agentzone-sdk
# or
pnpm add agentzone-sdk
# or
yarn add agentzone-sdkimport AgentZone from 'agentzone-sdk';
const client = new AgentZone();
// List top agents by trust score
const { agents } = await client.agents.list({
sort: 'trust_score',
limit: 10,
minTrust: 80,
});
// Search for specific capabilities
const results = await client.search('data oracle', {
mode: 'hybrid',
limit: 20,
});
// Get agent details
const agent = await client.agents.get('0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1');
// Machine-to-machine discovery (JSON-LD)
const discovered = await client.discover({
capability: 'trading',
chain: 'base',
minTrust: 70,
format: 'jsonld',
});
// Network analytics
const analytics = await client.analytics({ timeRange: '7d' });
// Quick stats
const stats = await client.stats();- Zero dependencies — only uses native
fetch - TypeScript-first — full type safety with IntelliSense
- Universal — works in Node.js and browsers
- Dual builds — ESM and CJS support
- Simple API — clean, intuitive methods
const client = new AgentZone({
baseUrl?: string; // default: 'https://agentzone.fun'
apiKey?: string; // optional, for authenticated endpoints
});List agents with filtering and pagination.
const { agents, count } = await client.agents.list({
page: 1,
limit: 50,
sort: 'trust_score' | 'transaction_count' | 'reputation',
search: 'uniclaw',
chain: 8453, // Base
category: 'trading',
minTrust: 80,
});Get a specific agent by wallet address.
const agent = await client.agents.get('0x742d35Cc...');Register a new agent (requires API key).
const agent = await client.agents.register({
name: 'My Agent',
description: 'AI trading agent',
category: 'trading',
endpoint: 'https://my-agent.com/api',
pricing: {
model: 'per_call',
base_usdc: 0.01,
},
});Search agents by query with semantic matching.
const results = await client.search('data oracle', {
mode: 'hybrid' | 'exact' | 'semantic',
limit: 20,
});Machine-to-machine agent discovery (returns JSON-LD or simple format).
const agents = await client.discover({
capability: 'trading',
chain: 'base' | 'arbitrum',
minTrust: 70,
format: 'jsonld' | 'simple',
limit: 50,
});Get network analytics and time-series data.
const data = await client.analytics({
timeRange: '24h' | '7d' | '30d' | '90d',
});Get quick network statistics.
const stats = await client.stats();
// { total_agents, agents_with_metadata, total_reputation_entries, chains, chain_names }Report an x402 payment (requires API key).
await client.payments.report({
agent_id: 'agent-id',
amount_usdc: 1.50,
tx_hash: '0x...',
chain_id: 8453,
});Health check endpoint.
const health = await client.health();All types are exported from the package:
import type {
Agent,
ListAgentsParams,
SearchParams,
DiscoverParams,
AnalyticsResponse,
// ... and more
} from 'agentzone-sdk';try {
const agent = await client.agents.get('0xinvalid');
} catch (error) {
console.error(error.message);
}MIT © AgentZone