AgentDomain

Public developer tools for autonomous identity on Base.

AgentDomain gives AI agents and builders a programmable identity stack: domain, email, SSL, optional Basename or ENS, AgentID, and x402-powered lifecycle management.

• Website: agentdomain.app
• Documentation: docs.agentdomain.app
• API: api.agentdomain.app/api/v1

Public packages

All eight packages are published at 0.11.0: the six npm packages (shared, SDK, MCP, AgentKit, Eliza and LangChain) and the two Python distributions, agentdomain-crewai and agentdomain-autogen, on PyPI.

Package	Purpose	Release status
@agentdomain/sdk	TypeScript SDK for AgentDomain API and x402 workflows	Published 0.11.0
@agentdomain/shared	Public schemas, types, constants, and utilities	Published 0.11.0
@agentdomain/mcp-server	MCP tools for agent runtimes	Published 0.11.0
@agentdomain/agentkit-plugin	Coinbase AgentKit integration	Published 0.11.0
@agentdomain/eliza-plugin	ElizaOS integration	Published 0.11.0
@agentdomain/langchain-plugin	Native LangChain JavaScript tools	Published 0.11.0
agentdomain-crewai	Standalone native CrewAI Python integration	Published 0.11.0
agentdomain-autogen	Standalone native AutoGen Python integration	Published 0.11.0

CrewAI and Microsoft AutoGen have their own Python distributions. Both retain the native stdio MCP interface and require a separately installed Node MCP server.

Install the published SDK:

npm install @agentdomain/sdk@0.11.0

See the changelog for public package release notes and compatibility details. The five earlier npm 0.11.0 releases have verified GitHub Actions OIDC provenance; LangChain's local publication has no OIDC provenance.

Lifecycle workflow

The 0.11.0 SDK and MCP releases include independent identity inspection, renewal observations and unsigned planning. Their published tarballs were verified against the reviewed GitHub Actions artifacts on September 14. Publication after the event is recorded separately in the changelog; it is not additional work claimed during the hackathon. See the pre-existing work record for the event baseline and the Identity Check demo.

• inspectAgentIdentity observes the AgentDomain registry on Base without platform credentials or a wallet. Missing identities, RPC errors, owner mismatches and inconsistent records remain distinct.
• inspectAgentRenewal reads identity and RenewalVault state at the same canonical safe-block hash, including available/reserved USDC, timing and flags.
• prepareAutoRenewChange creates an unsigned, attributed setting transaction. executeAutoRenewChange requires a separate host-provided human approval callback; confirmAutoRenewChange checks the actual transaction and safe readback. Uncertain submissions are not automatically resent.
• The verification view adds read-only renewal observations. The framework flows stop at inspection or unsigned preparation, without wallet execution.

These are RPC observations, not consensus proofs or verification of linked Basename/ENS ownership. The minimum vault fee is not a registrar quote, and changing auto-renew does not itself renew a domain. Enabling permits authorized renewal operators to use funded vault balances without a new signature for each renewal; disabling does not cancel an existing reservation.

New integration	Implementation
LangChain	TypeScript tools using @langchain/core; unsigned planning is a host opt-in.
CrewAI	Standalone Python tools using official core-native MCP APIs.
Microsoft AutoGen	Standalone guarded Python McpWorkbench for identity, renewal and unsigned planning.

The deterministic framework tests need no paid model and submit no live wallet transactions. The optional CrewAI recipe retains known Chroma dependency advisories; passing its isolated tests is not a clean security audit. Read the scoped security note before using the Python integration. See the renewal guide for the approval and billing boundaries.

Documentation for tools

The docs build now generates llms-full.txt, openapi.json, api-index.json and .well-known/agentdomain.json from reviewed public sources. They describe documented interfaces, with source hashes and workspace versions; they do not invent REST endpoints for onchain functions, authorize actions, or prove npm publication. Published outputs: full text, OpenAPI, API index, and discovery.

For the ETHOnline contribution and reused-work distinction, see PREEXISTING.md. For AI assistance in development, see AI_DISCLOSURE.md.

Tech stack

Surface	Technologies
Frontend	Next.js 16, React 19, TypeScript, Tailwind CSS, TanStack Query
Wallet and onchain	wagmi, viem, ethers, SIWE, x402, Base
Documentation	Astro 7, Starlight
SDK and integrations	TypeScript, Model Context Protocol SDK, Zod
Smart contracts	Solidity, Foundry, OpenZeppelin
Hosting and build system	Cloudflare Workers, OpenNext, Wrangler, pnpm, Turborepo

Smart contracts

Public smart-contract source and available Base deployment records are in contracts. Review the published artifacts and verify relevant addresses onchain before integrating.

Contributing and security

See CONTRIBUTING.md before opening a pull request. Report suspected vulnerabilities through the confidential process in SECURITY.md, not through a public issue.

License

Unless a file or third-party notice states otherwise, the source code and documentation in this repository are licensed under the Apache License 2.0. AgentDomain names, logos, marks, and brand artwork are excluded from that license; see NOTICE.