Wallet Metadata

Wallet Metadata

Label, tag, and query agent wallets for operational visibility.

Runtime

Every agent and its wallet accepts a metadata map of arbitrary key-value strings. Metadata is indexed and queryable, making it straightforward to build dashboards, cost-centre reports, or per-environment breakdowns without touching the ledger.

Setting metadata at creation

typescriptnomiqon.com
const agent = await nomiqon.agents.create({
  name: "email-drafter-agent",
  policy: { dailyCap: "3.00" },
  metadata: {
    environment: "production",
    team:        "growth",
    costCentre:  "CC-4421",
    version:     "1.4.2",
  },
});

Updating metadata

typescriptnomiqon.com
await nomiqon.agents.update(agent.id, {
  metadata: { version: "1.5.0", deployedAt: new Date().toISOString() },
});

Querying by metadata

typescriptnomiqon.com
const agents = await nomiqon.agents.list({
  metadata: { team: "growth", environment: "production" },
  limit: 50,
});
Tip
Metadata keys are limited to 64 characters; values to 512 characters. Maximum 32 pairs per agent. Keys must be lowercase alphanumeric with hyphens or underscores only.
Wallet Metadata — Nomiqon Docs