@agnt-id/sdk

The complete .agnt SDK — resolve names, generate A2A Agent Cards, bridge ERC-8004 identities, and plug into LangChain, CrewAI, or ElizaOS. One install, everything included.

.agnt is an on-chain ENS-style naming system for AI agents on Ethereum, Base, and Arbitrum. Register a name like alice.agnt and point it at wallets, A2A endpoints, MCP servers, and more.

Install

npm i @agnt-id/sdk

Quick Start

import { AgntClient } from "@agnt-id/sdk";

const agnt = new AgntClient();

// Resolve a name
const result = await agnt.resolve("alice.agnt");
console.log(result.records.wallets);
console.log(result.records.a2a);

// Reverse lookup
const reverse = await agnt.reverse("0x1234...abcd");

// Discover agents
const agents = await agnt.discover({ q: "trading" });

// Check availability
const free = await agnt.available("myagent");

What's Included

This meta-package bundles everything in the @agnt-id ecosystem:

| Sub-path | Package | Description | |----------|---------|-------------| | @agnt-id/sdk | @agnt-id/resolve | Core SDK — resolve, reverse, discover, trust, availability | | @agnt-id/sdk/a2a | @agnt-id/a2a | Google A2A Agent Card generator | | @agnt-id/sdk/agent0 | @agnt-id/agent0 | ERC-8004 / Agent0 identity bridge | | @agnt-id/sdk/langchain | @agnt-id/frameworks | LangChain tools | | @agnt-id/sdk/crewai | @agnt-id/frameworks | CrewAI tools | | @agnt-id/sdk/eliza | @agnt-id/frameworks | ElizaOS plugin |

Usage by Sub-path

Core (resolve, reverse, discover)

import { AgntClient, AgntError } from "@agnt-id/sdk";

const agnt = new AgntClient({ chainId: "eip155:8453" }); // Base
const result = await agnt.resolve("alice.agnt");

A2A Agent Cards

import { toAgentCard, agentCardToJSON } from "@agnt-id/sdk/a2a";

const card = toAgentCard(resolved, { version: "1.0.0" });
console.log(agentCardToJSON(card));

ERC-8004 / Agent0

import { toRegistrationFile, fromRegistrationFile } from "@agnt-id/sdk/agent0";

const file = toRegistrationFile(resolved, {
  agentURI: "https://alice.example.com/.well-known/agent.json",
});

LangChain

import { AgntResolveTool, AgntReverseTool, AgntDiscoverTool } from "@agnt-id/sdk/langchain";

const tools = [new AgntResolveTool(), new AgntReverseTool(), new AgntDiscoverTool()];

CrewAI

import { AgntResolveTool, AgntReverseTool, AgntDiscoverTool } from "@agnt-id/sdk/crewai";

const tools = [new AgntResolveTool(), new AgntReverseTool(), new AgntDiscoverTool()];

ElizaOS

import { agntPlugin } from "@agnt-id/sdk/eliza";

runtime.registerPlugin(agntPlugin());

MCP Server

For AI assistants that support MCP (Claude, Cursor, Windsurf), use the MCP server instead:

npx @agnt-id/mcp

See @agnt-id/mcp for setup instructions.

Individual Packages

Prefer installing only what you need? Each sub-path is available as a standalone package:

npm i @agnt-id/resolve     # Core SDK only
npm i @agnt-id/a2a          # A2A Agent Cards only
npm i @agnt-id/agent0       # ERC-8004 bridge only
npm i @agnt-id/frameworks   # Framework plugins only

Links

• Website
• API Docs
• Register a name
• GitHub

License

MIT