Anillos de privacidad de Solana
getEncryptedUtxosByTags
Recupera salidas UTXO cifradas que coincidan con etiquetas de visualización o con un anillo específico.
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": {}
}
}Salidas cifradas
Usa este método para obtener UTXO cifradas y descifrarlas en el cliente. Tu billetera descifra las salidas y suma los importes no gastados de cada activo para determinar su saldo privado. Esto es comparable congetTokenAccountsByOwner de Solana, que devuelve las cuentas de tokens SPL pertenecientes a una dirección. Un saldo privado se almacena en UTXO, no en cuentas de Solana, por lo que requiere un método RPC específico. Obtén más información sobre el estado privado y las UTXO.
El método devuelve las salidas coincidentes en result.data, agrupadas por transacción de Solana. Cada entrada incluye los valores slot e signature de la transacción. Una salida incluye su texto cifrado, etiqueta de visualización, compromiso, ID del árbol e índice de hoja.
La respuesta incluye salidas históricas que podrían haberse gastado. Tu billetera debe rastrear los anuladores para determinar su saldo disponible para gastar. Consulta la guía de saldos privados.
Un arreglo tags vacío requiere ringProgramId y selecciona las salidas de ese anillo. Cuando se proporcionan ambos, las salidas deben coincidir con las etiquetas y el anillo.
Consulta paginación y actualización para obtener información sobre los límites de página, los tokens de continuación y las lecturas incrementales.
Parámetros de la solicitud
object
Límites de slots. Reanuda una lectura sin límite que esté al día con
slot.gt establecido en el valor context.slot de la última página.object
Límites de slots para la lectura. Los límites proporcionados se combinan con AND.
number
Incluye únicamente transacciones posteriores a este slot.
number
Incluye únicamente transacciones de este slot o posteriores.
number
Incluye únicamente transacciones anteriores a este slot.
number
Incluye únicamente transacciones de este slot o anteriores.
number
predeterminado:"1000"
Número máximo de transacciones de Solana por página, de 1 a 1,000.
number
Slot mínimo persistido del indexador requerido para esta lectura. Devuelve el error JSON-RPC -32016 si el indexador está retrasado.
string
Token de continuación de la respuesta anterior. Vuelve a enviarlo sin cambios con las mismas etiquetas y los mismos filtros de anillo y slot.
string
Restringe los resultados al anillo autorizado por este ID de programa. Es obligatorio cuando el arreglo de etiquetas está vacío.
array
requerido
Etiquetas de visualización de 32 bytes codificadas en Base58. Se permiten hasta 1,000. Un arreglo vacío requiere ringProgramId y selecciona ese anillo.
Autorizaciones
Tu clave de API de Helius.
Cuerpo
application/json
Un ID para identificar la solicitud.
La versión del protocolo JSON-RPC.
Opciones disponibles:
2.0 El método que se invocará. Debe coincidir con el segmento final de la ruta de la URL.
Opciones disponibles:
getEncryptedUtxosByTags Show child attributes
Show child attributes
Ejemplo:
{
"tags": ["11111111111111111111111111111112"],
"limit": 100
}
Respuesta
Respuesta JSON-RPC. Revisa error antes de leer result.
¿Esta página le ayudó?
⌘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": {}
}
}