Indexer info
Indexer info and state
Retrieves the current status, sync progress, and current SMT root of ZCashNames Resolution Indexer node.
Endpoint
GET https://indexer.zcashnames.co/v1.0/info (get basic info)
POST https://indexer.zcashnames.co/v1.0/info (If additional parameters are required)
Request Body
The request body must be a JSON object containing the following parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
extended | boolean | false | If true, additionally returns additional info values |
Code Examples
- cURL
- JavaScript
- Python
- PHP
curl -X GET https://indexer.zcashnames.co/v1.0/info
const url = 'https://indexer.zcashnames.co/v1.0/info';
fetch(url, {
method: 'GET'
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
url = "https://indexer.zcashnames.co/v1.0/info"
response = requests.get(url)
print(response.json())
<?php
$url = 'https://indexer.zcashnames.co/v1.0/info';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
Response Example (with extended: true)
{
"response": {
"last_processed_coin_block": 3423251,
"last_checkpoint": {
"idx": 42,
"block_id": 3423251,
"smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
},
"indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"indexer_synced": true,
"checkpoints_behind": false,
"domains_count": 4,
"registrar_address": "u1nlded5cat3n9r4m0tpxr5a7sy3emccvaun7n4x9w848qa7ncl4eg5v2zyat4kevaa4fwfq0unwj3vnczfax3s9rutma43dckgqss8qrg",
"registrar_viewing_key": "uview1uxy3j27qhwkh8peq8k6g0vldalgqm4lyfxwuc2r95jelk458gmx6elc4e92t9g75x655vd7nxrtv3gllvajt3n8v0x36224ma3hrtvvtps7ejxysx8puelggt86vfuslxvdvjq7a778chqtcg626lcsr0ht26v3wgyfu5u04sn2qsle9k7faakg479tqf"
}
}
| Field | Type | Description |
|---|---|---|
last_processed_coin_block | int | Latest processed block on chain (usually last checkpoint's block_id) |
indexer_smt_root | string | The latest point of Indexer's sync (SMT Root of the Indexer) |
anchored_smt_root | string | The root the anchor contract currently attests to, read directly from its state |
indexer_synced | boolean | Whether this node’s independently computed root equals the root the anchor contract attests to. This is the full sync check — it is measured against the contract, not against a local table |
checkpoints_behind | boolean | True when this node’s newest checkpoint is older than the root the contract attests to — i.e. discovery is lagging |
domains_count | int | Total names registered |
registrar_address | string | Address of the Registrar to process incoming TXes and escrow |
registrar_viewing_key | string | Full viewing key of the Registrar ZCash Address, giving access to the whole Protocol history — incoming commands and outgoing payouts alike |
last_checkpoint | Latest checkpoint information (latest SMT Root update) | |
idx | int | Position in the anchor contract’s rootChain array; the resume cursor for checkpoint discovery |
smt_root | string | Latest Merkle tree root (hex) |
block_id | int | ZCash block_id of the last checkpoint and SMT Root generation |
warning
If last_processed_coin_block is significantly behind last_checkpoint.block_id, recent registrations may not be reflected yet.