Namensauflösung

Einen Namen auflösen

Löst einen PIVX-Namen auf und liefert die zugehörige PIVX-Adresse, die Beweisdetails, Synchronisations-Checkpoints und Registrierungsdaten.

Endpunkt

GET https://indexer.pivx.name/v1.0/resolve/{name} (nur Namensauflösung)
POST https://indexer.pivx.name/v1.0/resolve/{name} (falls zusätzliche Parameter nötig sind)

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
{name}	string	Ja	Der aufzulösende PIVX-Name (z. B. richard.pivx).

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 der aktuelle Checkpoint zurückgegeben, auf den der Indexer synchronisiert ist.

---

Codebeispiele

cURL

curl -X POST https://indexer.pivx.name/v1.0/resolve/richard.pivx \
  -H "Content-Type: application/json" \
  -d '{
    "extended": true,
    "with_checkpoint": true
  }'

JavaScript

const url = 'https://indexer.pivx.name/v1.0/resolve/richard.pivx';
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));

Python

import requests

url = "https://indexer.pivx.name/v1.0/resolve/richard.pivx"
payload = {
    "extended": True,
    "with_checkpoint": True
}
headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

PHP

php

<?php

$url = 'https://indexer.pivx.name/v1.0/resolve/richard.pivx';
$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.pivx",
    "target_address": "ps12qtzaw6x3dh35xuukrqgk06e9ffx8szg2n2huqncwjsnj3ajczmklqgcx97kn63vwlge6gj2cmn",
    "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	PIVX-Zieladresse
owner_pubkey	string	Öffentlicher Schlüssel des Namensinhabers
price	int	Preisangabe (für den Marktplatz)
nonce	int	Aufsteigende Nonce
smt_root	string	Aktueller Merkle-Tree-Root (hex)
		(bei with_checkpoint:false, sonst siehe SMT-Root unter "checkpoint")
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	PIVX-block_id der Domainerstellung
updated_block_id	int	PIVX-block_id der letzten Domainänderung
domain_tx	string	Der PIVX-Transaktionshash der Namensregistrierung
with_checkpoint:		Felder innerhalb von "checkpoint":
idx	int	Position im rootChain-Array des Anchor-Vertrags; der Wiederaufnahmepunkt der Checkpoint-Ermittlung
block_id	int	Die PIVX-block_id des zuletzt erzeugten SMT-Beweises
smt_root	string	Aktueller Merkle-Tree-Root (hex)

proof_terminal

Beschreibt, was am Ende des Beweispfads steht. Erst das macht Abwesenheit beweisbar statt bloß behauptet:

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.

Prüfcode für all dies in Python, PHP und JavaScript steht unter Beweise prüfen.

Umgekehrte Namensauflösung

Geben Sie eine PIVX-Adresse an, um umgekehrt aufzulösen:

GET/POST https://indexer.pivx.name/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.pivx.name/v1.0/resolve/owner/{Ed25519_public_key}

Die POST-Parameter sind oben beschrieben.