Namensauflösung
Einen Namen auflösen
Löst einen ZCashNamesn auf und liefert die zugehörige ZCash-Adresse, die Beweisdetails, Synchronisations-Checkpoints und Registrierungsdaten.
Endpunkt
GET https://indexer.zcashnames.co/v1.0/resolve/{name} (nur Namensauflösung)
POST https://indexer.zcashnames.co/v1.0/resolve/{name} (falls zusätzliche Parameter nötig sind)
Pfadparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
{name} | string | Ja | Der aufzulösende ZCashNames (z. B. richard.zcash). |
Anfragekörper
Der Anfragekörper muss ein JSON-Objekt mit folgenden Parametern sein:
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
extended | boolean | false | Bei true wird zusätzlich domain_tx zurückgegeben (der TX-Hash der Domainregistrierung). |
with_checkpoint | boolean | false | Bei true wird zusätzlich checkpoint zurückgegeben: der verankerte Checkpoint, gegen dessen Root (denselben wie smt_root) dieser Beweis erstellt wurde. Er ist null, während eine Synchronisierung festgeschrieben wird; wiederholen Sie dann die Anfrage. |
Codebeispiele
- cURL
- JavaScript
- Python
- PHP
curl -X POST https://indexer.zcashnames.co/v1.0/resolve/richard.zcash \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'
const url = 'https://indexer.zcashnames.co/v1.0/resolve/richard.zcash';
const data = {
extended: true,
with_checkpoint: true
};
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
url = "https://indexer.zcashnames.co/v1.0/resolve/richard.zcash"
payload = {
"extended": True,
"with_checkpoint": True
}
headers = {
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
<?php
$url = 'https://indexer.zcashnames.co/v1.0/resolve/richard.zcash';
$data = [
'extended' => true,
'with_checkpoint' => true
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
?>
Beispielantwort
{
"response": {
"domain_name": "bob.zec",
"target_address": "u146xylzx0uygtu0f2ae0p67w0229vm8h756aurrhsjpsfpyxy20ustc62xhtc9a4xrr734u5nndw0kzzav7vt57qh95yvwqktpqcfvkwx",
"owner_pubkey": "1111111111111111111111111111111111111111111111111111111111111111",
"price": 250000000,
"nonce": 1780000002,
"smt_root": "5892c31e50ad3a4cf0407b91b3012a196d60c4e4f53e37261ac6747dea180eea",
"merkle_proof": [
"29bc98ae3a939618e50ba72e11a25ba30b37bb53a168a17463b9ef3fe90495d8",
"0000000000000000000000000000000000000000000000000000000000000000"
],
"proof_depth": 2,
"proof_terminal": "Occupied"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
domain_name | string | Der registrierte Name |
target_address | string | ZCash-Zieladresse |
owner_pubkey | string | Öffentlicher Schlüssel des Namensinhabers |
price | int | Preisangabe (für den Marktplatz) |
nonce | int | Aufsteigende Nonce |
smt_root | string | Der Merkle-Tree-Root (hex), gegen den der Beweis erstellt wurde, in jeder Antwort |
merkle_proof | string[] | Geschwisterhashes in hex; [0] ist am tiefsten. Länge entspricht proof_depth |
proof_depth | int | Anzahl der Geschwister — prüfen Sie, dass sie merkle_proof.length entspricht |
proof_terminal | string | object | "Occupied", "Vacant" oder {"Blocked":{…}} — siehe unten |
| extended: | ||
created_block_id | int | ZCash-block_id der Domainerstellung |
updated_block_id | int | ZCash-block_id der letzten Domainänderung |
domain_tx | string | Der ZCash-Transaktionshash der Namensregistrierung |
| with_checkpoint: | Felder innerhalb von "checkpoint" (null, während eine Synchronisierung festgeschrieben wird): | |
idx | int | Index des Roots im rootAt-Mapping des Anchor-Vertrags (0 ist der Genesis-Root); der Wiederaufnahmepunkt der Checkpoint-Ermittlung |
block_id | int | Die ZCash-block_id, die der Checkpoint abdeckt |
smt_root | string | Der Root des Checkpoints (hex) — derselbe wie smt_root oben |
proof_terminal
Beschreibt, was am Ende des Beweispfads steht — das lässt einen Beweis Abwesenheit ebenso zeigen wie Anwesenheit:
| Wert | Bedeutung |
|---|---|
"Occupied" | dort steht das eigene Blatt des Namens — eine erfolgreiche Auflösung. Weisen Sie jede Auflösung zurück, deren Terminal nicht dies ist. |
"Vacant" | dort steht ein leerer Teilbaum — der Name ist nicht registriert |
{"Blocked": {"record": {…}}} | an dieser Position steht das Blatt eines anderen Namens, der abgefragte Name ist also nicht registriert. Der blockierende Datensatz ist vollständig enthalten, sodass Sie die Behauptung prüfen statt ihr vertrauen können. |
Ein Name, den der Indexer nicht kennt, wird ohne Beweis mit dem Fehler Domain not found
beantwortet: Die API liefert noch keine Vacant- oder Blocked-Beweise, ein „not found“ ist
also das Wort des Indexers. Prüfen Sie es mit einem zweiten Indexer, bevor Sie sich darauf
verlassen.
Prüfcode für all dies in Python, PHP und JavaScript steht unter Beweise prüfen.
Umgekehrte Namensauflösung
Geben Sie eine ZCash-Adresse an, um umgekehrt aufzulösen:
GET/POST https://indexer.zcashnames.co/v1.0/resolve/reverse/{address}
Die POST-Parameter sind oben beschrieben.
Namen nach Inhaber
Alle Namen, die einem bestimmten öffentlichen Ed25519-Schlüssel gehören.
GET/POST https://indexer.zcashnames.co/v1.0/resolve/owner/{Ed25519_public_key}
Die POST-Parameter sind oben beschrieben.