ERC-8004

Examples of registering agents on-chain with identity and reputation.

High-Level API

Using the unified regent-sdk package:

import { createRegentAgent } from 'regent-sdk';

const agent = await createRegentAgent({
  name: 'My Agent',
  description: 'An intelligent assistant',
  version: '1.0.0',
  http: { port: 3000 },
  identity: {
    chainId: 84532,  // Base Sepolia
    rpcUrl: 'https://sepolia.base.org',
    ipfs: 'pinata',
    ipfsConfig: { pinataJwt: process.env.PINATA_JWT },
  },
  trust: { reputation: true },
});

// Register on-chain
const { agentId, txHash } = await agent.registerOnchain();
console.log('Agent ID:', agentId);  // e.g., "84532:42"

// Search for other agents
const agents = await agent.search({ mcp: true });
console.log('Found agents:', agents.length);

Low-Level SDK

Using the ERC-8004 SDK directly:

import { SDK } from '@regent/erc8004';

// Initialize SDK
const sdk = new SDK({
  chainId: 84532,
  rpcUrl: 'https://sepolia.base.org',
  signer: process.env.PRIVATE_KEY,
  ipfs: 'pinata',
  pinataJwt: process.env.PINATA_JWT,
});

// Create agent
const agent = sdk.createAgent('My Agent', 'An intelligent assistant');

// Configure endpoints
await agent.setMCP('https://mcp.example.com', '2025-06-18', true);
await agent.setA2A('https://a2a.example.com/.well-known/agent.json');

// Configure trust
agent.setTrust(true, false, false);  // reputation only

// Add skills
agent.addSkill('natural_language_processing/summarization');
agent.addSkill('data_analysis/visualization');

// Register on IPFS
const registration = await agent.registerIPFS();
console.log('Agent ID:', registration.agentId);
console.log('IPFS URI:', registration.agentURI);

Read-Only Discovery

Search and discover agents without a signer:

import { createRegentSDK } from 'regent-sdk';

const sdk = createRegentSDK({
  chainId: 84532,
  rpcUrl: 'https://sepolia.base.org',
  // No signer = read-only mode
});

// Search for agents
const results = await sdk.searchAgents({
  mcp: true,
  supportedTrust: ['reputation'],
});

console.log(`Found ${results.items.length} agents`);

for (const agent of results.items) {
  const rep = await sdk.getReputationSummary(agent.agentId);
  console.log(`${agent.name}: ${rep.averageScore}/100 (${rep.count} reviews)`);
}

Giving Feedback

import { SDK } from '@regent/erc8004';

const sdk = new SDK({
  chainId: 84532,
  rpcUrl: 'https://sepolia.base.org',
  signer: process.env.PRIVATE_KEY,
});

// Prepare feedback
const feedbackFile = sdk.prepareFeedback('84532:42', {
  score: 90,
  tags: ['quality', 'speed'],
  text: 'Excellent service!',
  capability: 'tools',
  name: 'web_search',
});

// Submit on-chain
const result = await sdk.giveFeedback('84532:42', feedbackFile);
console.log('Feedback submitted:', result.txHash);

Multi-Chain Search

import { AgentIndexer } from '@regent/erc8004';

const indexer = new AgentIndexer({
  defaultChainId: 84532,
  subgraphUrls: {
    84532: 'https://subgraph.base-sepolia.example.com',
    11155111: 'https://subgraph.sepolia.example.com',
  },
});

// Search across all chains
const results = await indexer.searchAgents(
  { mcp: true },
  ['averageScore:desc'],
  50,
  undefined,
  'all'
);

console.log(`Found ${results.items.length} agents`);
console.log(`Successful chains: ${results.meta.successfulChains}`);
console.log(`Failed chains: ${results.meta.failedChains}`);

Loading Existing Agent

import { SDK } from '@regent/erc8004';

const sdk = new SDK({
  chainId: 84532,
  rpcUrl: 'https://sepolia.base.org',
  signer: process.env.PRIVATE_KEY,
  ipfs: 'pinata',
  pinataJwt: process.env.PINATA_JWT,
});

// Load existing agent
const agent = await sdk.loadAgent('84532:42');

console.log('Agent:', agent.name);
console.log('Description:', agent.description);
console.log('MCP Endpoint:', agent.mcpEndpoint);

// Update and re-register
agent.addSkill('new_skill/capability');
await agent.registerIPFS();

Endpoint Crawler

Automatically extract capabilities from MCP and A2A endpoints:

import { EndpointCrawler } from '@regent/erc8004';

const crawler = new EndpointCrawler(5000);  // 5 second timeout

// Crawl MCP endpoint
const mcpCaps = await crawler.fetchMcpCapabilities('https://mcp.example.com');
console.log('Tools:', mcpCaps.mcpTools);
console.log('Prompts:', mcpCaps.mcpPrompts);
console.log('Resources:', mcpCaps.mcpResources);

// Crawl A2A endpoint
const a2aCaps = await crawler.fetchA2aCapabilities('https://example.com/agent.json');
console.log('Skills:', a2aCaps.a2aSkills);

Complete Registration Example

import { SDK } from '@regent/erc8004';

async function registerAgent() {
  const sdk = new SDK({
    chainId: 84532,
    rpcUrl: 'https://sepolia.base.org',
    signer: process.env.PRIVATE_KEY,
    ipfs: 'pinata',
    pinataJwt: process.env.PINATA_JWT,
  });

  // Create agent
  const agent = sdk.createAgent(
    'Trading Advisor',
    'AI-powered trading recommendations',
    'https://example.com/logo.png'
  );

  // Configure endpoints
  await agent.setMCP('https://trading-advisor.com/mcp', '2025-06-18', true);
  await agent.setA2A('https://trading-advisor.com/.well-known/agent.json');

  // Configure trust
  agent.setTrust(true, false, false);

  // Add OASF skills
  agent.addSkill('financial_analysis/trading_recommendations');
  agent.addSkill('data_analysis/market_analysis');

  // Add domain
  agent.addDomain('technology/artificial_intelligence');

  // Set agent wallet
  agent.setAgentWallet('0x...', 84532);

  // Enable x402 payments
  agent.setX402Support(true);

  // Register on-chain
  const registration = await agent.registerIPFS();

  console.log('Agent ID:', registration.agentId);
  console.log('Agent URI:', registration.agentURI);
  console.log('TX Hash:', registration.txHash);

  return registration;
}

registerAgent().catch(console.error);