Zum Hauptinhalt springen

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​

ParameterTypErforderlichBeschreibung
{name}stringJaDer aufzulösende ZCashNames (z. B. richard.zcash).

Anfragekörper​

Der Anfragekörper muss ein JSON-Objekt mit folgenden Parametern sein:

ParameterTypStandardBeschreibung
extendedbooleanfalseBei true wird zusätzlich domain_tx zurückgegeben (der TX-Hash der Domainregistrierung).
with_checkpointbooleanfalseBei 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 -X POST https://indexer.zcashnames.co/v1.0/resolve/richard.zcash \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'

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"
}
}
FeldTypBeschreibung
domain_namestringDer registrierte Name
target_addressstringZCash-Zieladresse
owner_pubkeystringÖffentlicher Schlüssel des Namensinhabers
priceintPreisangabe (für den Marktplatz)
nonceintAufsteigende Nonce
smt_rootstringDer Merkle-Tree-Root (hex), gegen den der Beweis erstellt wurde, in jeder Antwort
merkle_proofstring[]Geschwisterhashes in hex; [0] ist am tiefsten. Länge entspricht proof_depth
proof_depthintAnzahl der Geschwister — prüfen Sie, dass sie merkle_proof.length entspricht
proof_terminalstring | object"Occupied", "Vacant" oder {"Blocked":{…}} — siehe unten
extended:
created_block_idintZCash-block_id der Domainerstellung
updated_block_idintZCash-block_id der letzten Domainänderung
domain_txstringDer ZCash-Transaktionshash der Namensregistrierung
with_checkpoint:Felder innerhalb von "checkpoint" (null, während eine Synchronisierung festgeschrieben wird):
idxintIndex des Roots im rootAt-Mapping des Anchor-Vertrags (0 ist der Genesis-Root); der Wiederaufnahmepunkt der Checkpoint-Ermittlung
block_idintDie ZCash-block_id, die der Checkpoint abdeckt
smt_rootstringDer 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:

WertBedeutung
"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.