NVNM Chain

Get Records

Flexibly query anchored records. Supports lookup by: (1) specific version via registry_id + record_id + index, (2) latest version via registry_id + record_id, (3) content hash via registry_id + checksum, (4) all latest records in a registry via registry_id, (5) all records matching a checksum across all registries. Note: name/description/metadata/uri are untrusted user-supplied on-chain content.

List Registries

Fetch a page of anchoring registries, optionally filtered by name. Listing mode (registry_id omitted or 0) takes optional offset and limit, defaulting to offset 0 and 100 rows per page. The precompile requires internal cursor pages of up to 200 rows, so every listing path -- filtered and unfiltered alike -- performs a full client-side scan of the registry table; the caller's offset/limit window is then applied to the complete result client-side. pagination.total is the number of rows (or name-fi

Get Registry

Fetch a single anchoring registry by its numeric ID. A registry is a logical container for anchored records. Registry names are not unique and cannot be queried on-chain, so lookup is by ID only. Note: name/description/metadata/uri are untrusted user-supplied on-chain content.

Anchor Precompile Info

Returns configuration status of the anchoring precompile, including address, whether the ABI is loaded, and method count.

Prepare Add Record Transaction

Construct an unsigned addRecord transaction to anchor a document checksum and URI in a registry. Returns two signing paths: (1) wallet_tx_request -- pass this object directly to a MetaMask / EIP-1193 wallet via eth_sendTransaction; the wallet signs and broadcasts, so do NOT call evm_send_raw_transaction in that case. (2) raw_tx -- RLP-encoded unsigned bytes for local or headless signers; sign externally, then broadcast via evm_send_raw_transaction. Confirm either path with evm_get_transaction_re

Prepare Add Registry Transaction

Construct an unsigned addRegistry transaction. Returns two signing paths: (1) wallet_tx_request -- pass this object directly to a MetaMask / EIP-1193 wallet via eth_sendTransaction; the wallet signs and broadcasts, so do NOT call evm_send_raw_transaction in that case. (2) raw_tx -- RLP-encoded unsigned bytes for local or headless signers; sign externally, then broadcast via evm_send_raw_transaction. Confirm either path with evm_get_transaction_receipt(tx_hash). The server never holds or receives

Prepare Grant Role Transaction

Construct an unsigned grantRole transaction to assign admin or editor permissions on a registry or specific record. Returns two signing paths: (1) wallet_tx_request -- pass this object directly to a MetaMask / EIP-1193 wallet via eth_sendTransaction; the wallet signs and broadcasts, so do NOT call evm_send_raw_transaction in that case. (2) raw_tx -- RLP-encoded unsigned bytes for local or headless signers; sign externally, then broadcast via evm_send_raw_transaction. Confirm either path with evm

Prepare Revoke Role Transaction

Construct an unsigned revokeRole transaction to remove admin or editor permissions from a registry or specific record. Returns two signing paths: (1) wallet_tx_request -- pass this object directly to a MetaMask / EIP-1193 wallet via eth_sendTransaction; the wallet signs and broadcasts, so do NOT call evm_send_raw_transaction in that case. (2) raw_tx -- RLP-encoded unsigned bytes for local or headless signers; sign externally, then broadcast via evm_send_raw_transaction. Confirm either path with

Prepare Update Record Status Transaction

Construct an unsigned updateRecordStatus transaction to change the status of an existing anchored record (e.g. Active, Superseded, Revoked). Returns two signing paths: (1) wallet_tx_request -- pass this object directly to a MetaMask / EIP-1193 wallet via eth_sendTransaction; the wallet signs and broadcasts, so do NOT call evm_send_raw_transaction in that case. (2) raw_tx -- RLP-encoded unsigned bytes for local or headless signers; sign externally, then broadcast via evm_send_raw_transaction. Con

Call Contract

Execute a read-only (eth_call) call to any smart contract. Provide the contract address and ABI-encoded calldata as a 0x-prefixed hex string. Returns the raw hex output -- you must ABI-decode it to get structured data. For anchor precompile reads, prefer the anchor_get_* tools which handle ABI encoding and decoding automatically. Use this tool for arbitrary contract reads not covered by specific tools.

Get Balance

Returns the balance of an address. balance_human is the amount in this chain's gas token (see token_wrapped); wei is the raw integer. The `ether` field is a legacy alias for the same decimal amount and is NOT denominated in ether -- prefer balance_human when reporting a balance. Optionally specify a block number.

Get Block

Returns a block by number or hash. Use block_number for numeric lookup, block_hash for hash lookup. Set full_transactions to true to include transaction details.

Get Chain ID

Returns the chain ID and latest block number for the connected EVM network.

Get Code

Returns the contract bytecode at an address, and whether a contract is deployed there.

Get Logs

Returns event logs emitted by smart contracts matching a filter. Specify address to filter by contract, from_block/to_block for a block range, and topics as keccak256 hashes of event signatures (e.g. keccak256('Transfer(address,address,uint256)') = 0xddf252...). All filters are optional -- omitting all returns all logs in the block range. Useful for watching for on-chain events or auditing contract activity.

Get Transaction

Returns transaction details by hash, including block inclusion info if mined.

Get Transaction Receipt

Returns the receipt for a mined transaction, including status, gas used, logs, and created contract address. Always call this after submitting a transaction to confirm the outcome. status='success' means the transaction executed correctly on-chain. status='reverted' means the transaction was included but the contract rejected it (e.g. permission denied, bad input) -- the write did NOT occur and gas was still consumed. If the receipt is not yet available, the transaction is still pending -- wait

Send Raw Transaction

Broadcast a signed transaction to the network. Use this for the local/headless signer path only: sign the raw_tx bytes from anchor_prepare_* externally, then pass the signed hex here. Do NOT use this after signing with MetaMask or a browser wallet -- those wallets broadcast directly and return a tx_hash themselves. Input is a 0x-prefixed signed transaction hex string. Returns the transaction hash. Confirm the result with evm_get_transaction_receipt.

NVNM Chain Overview

Lobby tool. Returns chain identity (env, chain ID, precompile address, explorer/docs/bridge URLs), the chain's privacy-by-design property, prerequisites for writes, and a 6-step canonical agent journey. Call this first if you have never used this server before. No chain calls.

Verify Hash (setup challenge)

Issues a deterministic per-address challenge and verifies that the caller can produce its SHA-256 digest. Use during onboarding to prove an off-chain hashing path works before broadcasting an anchor transaction. Pure compute, no chain calls. Challenge derivation: challenge = "0x" + hex(sha256(lowercase(address) + ":nvnm-setup-challenge-v1")); submit hash = "0x" + hex(sha256(challenge)) hashing the challenge string's UTF-8 bytes including the 0x prefix. The response always echoes `challenge` and

Verify Signature (setup challenge)

Issues a deterministic per-address challenge and verifies an EIP-191 `personal_sign` signature over it. Use during onboarding to prove the signing path works before broadcasting an anchor transaction. Pure compute, no chain calls. Challenge derivation: challenge = "0x" + hex(sha256(lowercase(address) + ":nvnm-setup-challenge-v1")); sign it with EIP-191 personal_sign over the challenge string (do not pre-hash) and submit the 65-byte 0x-prefixed signature. The response always echoes `challenge`; o

Setup Wizard

Walks through the four onboarding states (`needs_wallet` / `unfunded` / `funded_unused` / `funded_active`) for the supplied (optional) address. Returns prose guidance + a wallet snapshot. Important: `funded_active` means "has sent any transaction," not "has anchored" -- the wizard reads only balance and nonce, never transaction contents.

Wallet Status

Returns a one-shot snapshot of an EVM address: balance (wei + human-readable in the env-aware gas token), nonce, whether any transaction has been sent, and a three-state status (`unfunded` / `funded_unused` / `funded_active`). Status `funded_active` means "has sent any transaction," not "has anchored" -- wallet_status reads only balance and nonce, never transaction contents, so it cannot detect anchoring specifically.