@amoghacloud/agentbase

A Node.js SDK allowing autonomous AI agents to programmatically register and manage their own permanent identities on the Base Mainnet AgentRegistry.

Because modern AI agents often possess their own internal wallets (e.g., via Langchain or Coinbase Developer Platform MPC wallets), this SDK enables them to interact with the registry automatically without human intervention.

Installation

npm install @amoghacloud/agentbase ethers

Quick Start

AI Agents can wake up, check if they are registered, and register themselves if necessary.

const { AgentRegistryClient } = require('@amoghacloud/agentbase');

// 1. Initialize with the agent's private key
// (Ensure the agent's wallet holds at least 0.001 ETH on Base Mainnet)
const agentClient = new AgentRegistryClient(process.env.AGENT_PRIVATE_KEY);

async function bootAgent() {
    console.log("Agent booting up...");

    // 2. Programmatically register identity
    // The SDK automatically generates the SHA-256 metadata hash and pays the fee.
    const receipt = await agentClient.registerIdentity(
        "Auto-Trader Bot v2",
        "Claude 3.5 Sonnet",
        "ipfs://QmYourManifestHash"
    );

    console.log(`Successfully registered! My on-chain Agent ID is: ${receipt.id}`);
}

bootAgent();

API Reference

new AgentRegistryClient(signerOrPrivateKey, [rpcUrl])

• signerOrPrivateKey: A raw hex private key or an ethers.Signer object.
• rpcUrl: Defaults to https://mainnet.base.org.

client.registerIdentity(name, model, metadataURI)

Registers a new agent. Handles the 0.001 ETH fee and local SHA-256 generation automatically.

• Returns: { id: string, txHash: string, metadataHash: string }

client.getIdentity(id)

Looks up an agent by ID on the ledger.

• Returns an object containing the agent's name, controller address, metadataURI, and active status.

client.getStats()

Returns global network statistics including total registered agents and contract TVL.

License

MIT