Output and Errors

Human OutputCopy Anchor Link

namera wallet list

Found 1 delegated wallet:

👛 Example account | Active
-> Address: 0x1111111111111111111111111111111111111111
-> Network type: EVM
-> Custody: Namera-managed
-> Description: SDK test account
-> Created: 11 Oct 2026, 09:00:00 UTC

Status and permissions use terminal colors when supported. NO_COLOR disables colors; pipes and unsupported terminals use plain-text symbols.

JSON OutputCopy Anchor Link

namera --output json wallet list

[
  {
    "id": "0199dfe1-0000-7000-8000-000000000001",
    "organizationId": "0199dfe1-0000-7000-8000-000000000004",
    "metadata": {
      "version": 1,
      "name": "Example account",
      "logo": { "type": "emoji", "value": "👛" },
      "description": "SDK test account"
    },
    "status": "active",
    "namespace": "eip155",
    "address": "0x1111111111111111111111111111111111111111",
    "owner": {
      "signingKeyId": "0199dfe1-0000-7000-8000-000000000005",
      "custody": "namera-managed",
      "provider": "1claw",
      "algorithm": "secp256k1"
    },
    "createdAt": "2026-10-11T09:00:00.000Z",
    "updatedAt": "2026-10-11T09:00:00.000Z",
    "implementation": "alchemy-modular-v2",
    "data": {
      "version": 1,
      "modularAccountVersion": "2.0.0",
      "validatorType": "ecdsa_secp256k1",
      "entryPointVersion": "0.7",
      "accountMode": "7702",
      "delegationVersion": "v1.1.0"
    }
  }
]

The CLI prints one compact JSON value to stdout, not the SDK's { success, data, error } envelope. Successful list commands can return an array or a paginated object. Bigint quantities are decimal strings.

Quiet ModeCopy Anchor Link

namera --quiet auth status

Successful output is suppressed, but the command still runs and failures remain visible on stderr. Quiet mode also disables operation-input prompts.

FailuresCopy Anchor Link

A failed command exits nonzero. With --output json, stderr contains one structured error object:

{
  "error": {
    "code": "INVALID_EXPORT",
    "message": "The encrypted session-key export is invalid or incomplete.",
    "nextStep": "Copy the entire import command from the dashboard. Do not paste a private key.",
    "retryable": false
  }
}

Use error.code for branching and nextStep for recovery. Do not parse human error text. Keep stdout and stderr separate when consuming JSON.

A command can succeed while reporting allowed: false, valid: false, or a submission with status: "failed". Check the returned fields as well as the exit status. A successful status lookup does not mean a successful transaction.

Retry SafelyCopy Anchor Link

Do not repeat an execution just because the response was lost. Check its saved submission ID, or reconcile the outcome first. Follow Handle Retries and Recovery.

MCP reserves stdout for protocol messages and writes diagnostics to stderr. Do not parse its stdout as ordinary CLI JSON.

Example output uses fixture accounts and hashes, captured with the CLI's output formatters. Plain-text output is shown without terminal colors; your values and relative expiry dates will differ.