Zum Hauptinhalt springen
POST
getEncryptedUtxosByTags

Verschlüsselte Ausgänge

Rufe mit dieser Methode verschlüsselte UTXOs zur clientseitigen Entschlüsselung ab. Deine Wallet entschlüsselt die Ausgänge und summiert die nicht ausgegebenen Beträge für jeden Vermögenswert, um das private Guthaben zu ermitteln. Dies entspricht Solanas getTokenAccountsByOwner, das die SPL-Token-Konten einer Adresse zurückgibt. Ein privates Guthaben wird in UTXOs und nicht in Solana-Konten gespeichert. Daher ist eine eigene RPC-Methode erforderlich. Weitere Informationen findest du unter Privater Zustand und UTXOs. Die Methode gibt übereinstimmende Ausgänge in result.data zurück, gruppiert nach Solana-Transaktion. Jeder Eintrag enthält slot und signature der Transaktion. Ein Ausgang enthält seinen Chiffretext, View-Tag, commitment, seine Baum-ID und seinen Blattindex. Die response enthält historische Ausgänge, die möglicherweise bereits ausgegeben wurden. Deine Wallet muss Nullifier nachverfolgen, um das ausgebbare Guthaben zu ermitteln. Weitere Informationen findest du im Leitfaden zum privaten Guthaben. Ein leeres tags-Array erfordert ringProgramId und wählt Ausgänge aus diesem Ring aus. Wenn du beides angibst, müssen die Ausgänge sowohl mit den Tags als auch mit dem Ring übereinstimmen. Unter Paginierung und Aktualität findest du Informationen zu Seitenlimits, Fortsetzungs-token und inkrementellen Lesevorgängen.

Parameter des request

object
Grenzen für den slot. Setze slot.gt auf context.slot der letzten Seite, um einen aufgeholten, unbegrenzten Lesevorgang fortzusetzen.
object
Grenzen für den slot des Lesevorgangs. Angegebene Grenzen werden mit AND verknüpft.
number
Berücksichtigt nur Transaktionen nach diesem slot.
number
Berücksichtigt nur Transaktionen in oder nach diesem slot.
number
Berücksichtigt nur Transaktionen vor diesem slot.
number
Berücksichtigt nur Transaktionen in oder vor diesem slot.
number
Standard:"1000"
Maximale Anzahl von Solana-Transaktionen pro Seite, von 1 bis 1.000.
number
Mindestens erforderlicher persistierter slot des Indexers für diesen Lesevorgang. Gibt den JSON-RPC-Fehler -32016 zurück, wenn der Indexer zurückliegt.
string
token für die Fortsetzung aus der vorherigen response. Übergib ihn unverändert mit denselben Tags sowie denselben Ring- und slot-Filtern.
string
Beschränkt die Ergebnisse auf den von dieser Programm-ID autorisierten Ring. Erforderlich, wenn tags leer ist.
array
erforderlich
Base58-codierte View-Tags mit 32 Byte. Maximal 1.000. Ein leeres Array erfordert ringProgramId und wählt diesen Ring aus.

Autorisierungen

api-key
string
query
erforderlich

Dein Helius API key.

Body

application/json
id
string
Standard:1
erforderlich

Eine ID zur Identifizierung des request.

jsonrpc
enum<string>
Standard:2.0
erforderlich

Die Version des JSON-RPC-Protokolls.

Verfügbare Optionen:
2.0
method
enum<string>
Standard:getEncryptedUtxosByTags
erforderlich

Die aufzurufende Methode. Sie muss mit dem letzten Segment des URL-Pfads übereinstimmen.

Verfügbare Optionen:
getEncryptedUtxosByTags
params
object
erforderlich
Beispiel:

Antwort

JSON-RPC response. Prüfe error, bevor du result liest.

id
string
erforderlich

Die ID des request.

jsonrpc
enum<string>
erforderlich

Die Version des JSON-RPC-Protokolls.

Verfügbare Optionen:
2.0
error
object
result
object

Eine begrenzte Seite eines Verlaufslesevorgangs mit Paginierung im gTFA-Stil.