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 werden zusätzlich created_block_id, updated_block_id und domain_tx zurückgegeben (der Hash der Transaktion der letzten Operation des Namens). |
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. updated_block_id kommt ebenfalls mit. |
Codebeispiele
- cURL
- JavaScript
- Python
- PHP
curl -X POST https://indexer.pivx.name/v1.0/resolve/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'
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));
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
$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": "richard.pivx",
"target_address": "ps1zu2xyry4rc5j0trs3w9zqr5ayhw8h3ulhsfw4reufcg8c62gpg3rzcj7tkasn7tlwgc9y4emwtq",
"owner_pubkey": "ba17d58e11e9828a4ffc140560730ce1b410c924043c1d60cf52a127bde47544",
"price": 750000000000,
"nonce": 1793384994,
"created_block_id": 5648982,
"domain_tx": "a1003dace6ed2ea966aba28926c6ecb7cb5436229db329ce72d118d2cf502d66",
"updated_block_id": 5649418,
"smt_root": "5613850a42087074b88a35dfd6c878d53267f6fa571438026a437c059cbc8245",
"merkle_proof": [
"5a9acd90db63c21d8eff4b656d4526c1bb4b5f9f5e7cf6c5a22719c4d8854bec",
"0000000000000000000000000000000000000000000000000000000000000000",
"d8f11c6213a091087e5bcf8aeac624c7f768d9436af9b6883880155e28e3f4a7",
"ed05b1037b96221bda47b2dd76aa37a93f3d39cb336f8e6f8a203f8fb1ea2a98",
"3af379894717ec7000caf91fcd2bf0e570fda54befa24f5a5770275728dcb11e",
"50e173401bd419424082e3cb2caf9ee62e0808e79e8c8ade99d3396f35e995ce",
"4c1b349c97b95c712f4777b357de9ff1535aad68bb7c56134273a88fefe8bef5",
"3695b047cfbd47f93c899c03736d085924a23ba48d51a6db8382bb2a7452c4b6",
"badcf46ab543cb4a9a1ad7335a07b87d8ede6dc241cf4b4168894f4822f08325",
"e33ad310acd0cc3f5a4261ed6a24615e60e91de423a8ace2f6716c0b60aa351c"
],
"proof_depth": 10,
"proof_terminal": "Occupied",
"checkpoint": {
"idx": 31,
"block_id": 5671618,
"smt_root": "5613850a42087074b88a35dfd6c878d53267f6fa571438026a437c059cbc8245"
}
}
}
Dies ist eine Antwort von indexer.pivx.name auf die Anfrage oben, bei Checkpoint 31 (PIVX-Block 5671618). Die Root ändert sich mit jedem neuen Batch von Operationen, eine spätere Anfrage kann also eine andere smt_root und andere Geschwisterhashes liefern; diese Antwort ergibt mit dem Code unter Beweise prüfen weiterhin ihre eigene Root.
| 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 | 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 | PIVX-block_id der Domainerstellung |
updated_block_id | int | PIVX-block_id der letzten Domainänderung |
domain_tx | string | Der PIVX-Transaktionshash der letzten Operation des Namens: seiner Registrierung, bis der Name aktualisiert, übertragen, zum Verkauf angeboten, vom Verkauf zurückgezogen oder gekauft wird |
| 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 PIVX-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 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.
Listen seitenweise abrufen
Die umgekehrte Auflösung und die Suche nach Inhaber liefern die Namen seitenweise, nach Namen sortiert (A bis Z). Zwei weitere POST-Parameter blättern durch sie:
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
count | integer | 500 | Namen pro Seite, 1 bis 500. Ein größerer Wert wird auf 500 gekürzt. |
after | string | — | Der letzte Name der vorigen Seite: diese Seite beginnt nach ihm. Für die erste Seite weglassen. |
Enthält eine Seite count Namen, können weitere folgen: erneut anfragen, mit after auf ihren letzten Namen gesetzt. Eine kürzere Seite ist die letzte, und eine Seite hinter dem letzten Namen ist eine leere Liste, [].
curl -X POST https://indexer.pivx.name/v1.0/resolve/owner/{Ed25519_public_key} \
-H "Content-Type: application/json" \
-d '{"count": 100, "after": "alice.pivx"}'