Skip to main content
register_identity creates a Stellar8004 (ERC-8004 compatible) on-chain identity record for your agent’s wallet. The identity is signed via the Nebula Hub. Once registered, your agent has a verifiable, explorer-visible presence on the Stellar network that other agents and gated services can look up to assess trustworthiness. This call is idempotent — if your agent is already registered, calling again simply returns the existing identity without creating a duplicate or incurring any fee. It is safe to call on every cold-start.

​
Parameters

This tool takes no parameters.

​
Response

​
agent_id
string
The unique on-chain identifier assigned to your agent. Use this when referencing your agent in protocols that support Stellar8004 identity lookups.
​
stellar_address
string
The Stellar public key (G-address) associated with this identity — the same address Nebula uses for all payments.
​
explorer_url
string
A direct link to your agent’s public identity and reputation page on the Nebula explorer.

​
When to call

Call register_identity once, early in your agent’s lifecycle — typically during initialisation or the first time the agent starts up. After that, the identity is permanent. Re-calling on subsequent starts is harmless (the call is idempotent) and is a safe way to retrieve the agent’s ID if it was not stored locally.

​
Why it matters

A registered Stellar8004 identity:
  • Enables your agent to build a verifiable reputation through on-chain feedback from counterparties (visible via get_my_reputation).
  • Allows gated services and other agents to verify your agent’s identity and trust score before accepting a request.
  • Provides a public explorer link you can share with humans or services that need to audit your agent’s track record.
You must call register_identity before get_my_reputation returns meaningful data. An unregistered wallet will return an error or empty reputation record.

​
Example

Tool call
register_identity request
{
  "tool": "register_identity"
}
Response
register_identity response
{
  "status": "ok",
  "agent_id": "agent_01HZ4XM7KPQR2NSTV8WY3ZA6B",
  "stellar_address": "GBXYZ1234567890ABCDEF1234567890ABCDEF1234567890ABCDE",
  "explorer_url": "https://nebulaonchain.xyz/agents/agent_01HZ4XM7KPQR2NSTV8WY3ZA6B"
}
Response when already registered (idempotent)
register_identity response — already registered
{
  "status": "ok",
  "agent_id": "agent_01HZ4XM7KPQR2NSTV8WY3ZA6B",
  "stellar_address": "GBXYZ1234567890ABCDEF1234567890ABCDEF1234567890ABCDE",
  "explorer_url": "https://nebulaonchain.xyz/agents/agent_01HZ4XM7KPQR2NSTV8WY3ZA6B",
  "note": "Identity already registered. Returning existing record."
}