Skip to main content
Use agent-identity to register an AI or automation agent with a reusable receipt. Default path: neus_agent_create (MCP) or the hosted verify flow. This page is for SDK-level detail when you already know you need it. Verifier ID: agent-identity

Basic Registration

const proof = await client.verify({
  verifier: 'agent-identity',
  data: {
    agentId: 'my-assistant',
    agentWallet: '0x...',
    agentChainRef: 'eip155:8453',
    agentType: 'ai',
    description: 'My AI assistant',
  },
  walletAddress: agentWallet,
});
You can supply chain context either in data as agentChainRef (CAIP-2) or on the verification request as chain (CAIP-2) or chainId (EVM). Those options satisfy the same requirement. Canonical field list: agent-identity verifier doc.

Full Example

await client.verify({
  verifier: 'agent-identity',
  data: {
    agentId: 'my-agent',
    agentWallet: '0x...',           // universal-address: EVM or Solana
    agentChainRef: 'eip155:8453',
    agentType: 'ai',
    description: 'My AI assistant',
    capabilities: ['web-search'],
    instructions: 'System prompt (max 4000 chars)',
    skills: ['web-search', 'code-execution'],   // max 48, each max 64 chars
    services: [                                  // max 16
      { name: 'metrics', endpoint: 'https://metrics.example.com/v1', version: '1.0' }
    ]
  },
  walletAddress: agentWallet,
});

Fields

FieldRequiredMax LengthDescription
agentIdYes1–128 charsUnique identifier for the agent
agentWalletYesAgent wallet address (EVM or Solana)
agentChainRefYes in data, or set chain or chainId on the verification requestCAIP-2 chain reference for agentWallet
agentLabelNo128 charsHuman-readable display name
agentTypeNoenumai, bot, service, automation, or agent
descriptionNo500 charsAgent description
capabilitiesNo32 itemsList of declared capabilities
instructionsNo4000 charsSystem prompt or behavioral instructions
skillsNo48 itemsList of skill identifiers
servicesNo16 itemsService endpoint definitions

What You Get Back

You receive a proof receipt ID that can be reused for public agent identity, profile trust, and agent-aware product flows. agent-identity is a self-attestation. The agent wallet signs this proof itself. It does not grant permissions. Use agent-delegation when an account needs to grant scoped authority to that agent.

Verification

GET /api/v1/proofs/check?verifierIds=agent-identity&address=0x...

Use Cases

Use CaseDescription
AI assistantsRegister ChatGPT-like agents
Trading botsRegister automated trading agents
DAO delegatesRegister governance delegates