Anneaux de confidentialité Solana
getEncryptedUtxosByTags
Récupérez les sorties UTXO chiffrées correspondant à des balises de visualisation ou à un anneau spécifique.
POST
/
v1
/
spr
/
getEncryptedUtxosByTags
getEncryptedUtxosByTags
curl --request POST \
--url 'https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "1",
"method": "getEncryptedUtxosByTags",
"params": {
"tags": [
"11111111111111111111111111111112"
],
"limit": 100
}
}
'import requests
url = "https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key="
payload = {
"jsonrpc": "2.0",
"id": "1",
"method": "getEncryptedUtxosByTags",
"params": {
"tags": ["11111111111111111111111111111112"],
"limit": 100
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getEncryptedUtxosByTags',
params: {tags: ['11111111111111111111111111111112'], limit: 100}
})
};
fetch('https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'jsonrpc' => '2.0',
'id' => '1',
'method' => 'getEncryptedUtxosByTags',
'params' => [
'tags' => [
'11111111111111111111111111111112'
],
'limit' => 100
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key="
payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getEncryptedUtxosByTags\",\n \"params\": {\n \"tags\": [\n \"11111111111111111111111111111112\"\n ],\n \"limit\": 100\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=")
.header("Content-Type", "application/json")
.body("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getEncryptedUtxosByTags\",\n \"params\": {\n \"tags\": [\n \"11111111111111111111111111111112\"\n ],\n \"limit\": 100\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getEncryptedUtxosByTags\",\n \"params\": {\n \"tags\": [\n \"11111111111111111111111111111112\"\n ],\n \"limit\": 100\n }\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"id": "1",
"result": {
"context": {
"slot": 4242,
"blockTime": 1730000000
},
"data": [],
"paginationToken": null
}
}{
"jsonrpc": "2.0",
"id": "<string>",
"error": {
"code": 123,
"message": "<string>",
"data": {}
}
}{
"jsonrpc": "2.0",
"id": "<string>",
"error": {
"code": 123,
"message": "<string>",
"data": {}
}
}{
"jsonrpc": "2.0",
"id": "<string>",
"error": {
"code": 123,
"message": "<string>",
"data": {}
}
}Sorties chiffrées
Utilisez cette méthode pour obtenir des UTXO chiffrées à déchiffrer côté client. Votre portefeuille déchiffre les sorties et additionne les montants non dépensés de chaque actif afin de déterminer son solde privé. Cette méthode est comparable à la méthodegetTokenAccountsByOwner de Solana, qui renvoie les comptes de jetons SPL appartenant à une adresse. Un solde privé est stocké dans des UTXO, et non dans des comptes Solana. Il nécessite donc une méthode RPC dédiée. En savoir plus sur l’état privé et les UTXO.
La méthode renvoie les sorties correspondantes dans result.data, regroupées par transaction Solana. Chaque entrée inclut les valeurs slot et signature de la transaction. Une sortie inclut son texte chiffré, sa balise de visualisation, son engagement, l’ID de l’arbre et l’index de la feuille.
La réponse inclut des sorties historiques qui peuvent déjà avoir été dépensées. Votre portefeuille doit suivre les annulateurs pour déterminer le solde disponible. Consultez le guide sur le solde privé.
Un tableau tags vide nécessite ringProgramId et sélectionne les sorties de cet anneau. Lorsque les deux sont fournis, les sorties doivent correspondre aux balises et à l’anneau.
Consultez la section pagination et fraîcheur des données pour connaître les limites de page, les jetons de continuation et les lectures incrémentielles.
Paramètres de la requête
object
Bornes de slot. Reprenez une lecture à jour et sans limite en définissant
slot.gt sur la valeur context.slot de la dernière page.object
Bornes de slot pour la lecture. Les bornes fournies sont combinées avec l’opérateur AND.
number
Inclut uniquement les transactions postérieures à ce slot.
number
Inclut uniquement les transactions correspondant à ce slot ou postérieures à celui-ci.
number
Inclut uniquement les transactions antérieures à ce slot.
number
Inclut uniquement les transactions correspondant à ce slot ou antérieures à celui-ci.
number
défaut:"1000"
Nombre maximal de transactions Solana par page, de 1 à 1 000.
number
Slot minimal enregistré par l’indexeur requis pour cette lecture. Renvoie l’erreur JSON-RPC -32016 si l’indexeur est en retard.
string
Jeton de continuation provenant de la réponse précédente. Renvoyez-le sans le modifier, avec les mêmes balises, le même anneau et les mêmes filtres de slot.
string
Limite les résultats à l’anneau autorisé par cet ID de programme. Requis lorsque tags est vide.
array
requis
Balises de visualisation de 32 octets encodées en Base58. 1 000 au maximum. Un tableau vide nécessite ringProgramId et sélectionne cet anneau.
Autorisations
Votre clé API Helius.
Corps
application/json
Un ID permettant d'identifier la requête.
La version du protocole JSON-RPC.
Options disponibles:
2.0 La méthode à invoquer. Elle doit correspondre au dernier segment du chemin de l'URL.
Options disponibles:
getEncryptedUtxosByTags Show child attributes
Show child attributes
Exemple:
{
"tags": ["11111111111111111111111111111112"],
"limit": 100
}
Réponse
Réponse JSON-RPC. Vérifiez error avant de lire result.
Cette page vous a-t-elle été utile ?
⌘I
getEncryptedUtxosByTags
curl --request POST \
--url 'https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "1",
"method": "getEncryptedUtxosByTags",
"params": {
"tags": [
"11111111111111111111111111111112"
],
"limit": 100
}
}
'import requests
url = "https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key="
payload = {
"jsonrpc": "2.0",
"id": "1",
"method": "getEncryptedUtxosByTags",
"params": {
"tags": ["11111111111111111111111111111112"],
"limit": 100
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getEncryptedUtxosByTags',
params: {tags: ['11111111111111111111111111111112'], limit: 100}
})
};
fetch('https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'jsonrpc' => '2.0',
'id' => '1',
'method' => 'getEncryptedUtxosByTags',
'params' => [
'tags' => [
'11111111111111111111111111111112'
],
'limit' => 100
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key="
payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getEncryptedUtxosByTags\",\n \"params\": {\n \"tags\": [\n \"11111111111111111111111111111112\"\n ],\n \"limit\": 100\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=")
.header("Content-Type", "application/json")
.body("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getEncryptedUtxosByTags\",\n \"params\": {\n \"tags\": [\n \"11111111111111111111111111111112\"\n ],\n \"limit\": 100\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://devnet.helius-rpc.com/v1/spr/getEncryptedUtxosByTags?api-key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getEncryptedUtxosByTags\",\n \"params\": {\n \"tags\": [\n \"11111111111111111111111111111112\"\n ],\n \"limit\": 100\n }\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"id": "1",
"result": {
"context": {
"slot": 4242,
"blockTime": 1730000000
},
"data": [],
"paginationToken": null
}
}{
"jsonrpc": "2.0",
"id": "<string>",
"error": {
"code": 123,
"message": "<string>",
"data": {}
}
}{
"jsonrpc": "2.0",
"id": "<string>",
"error": {
"code": 123,
"message": "<string>",
"data": {}
}
}{
"jsonrpc": "2.0",
"id": "<string>",
"error": {
"code": 123,
"message": "<string>",
"data": {}
}
}