Anéis de privacidade da Solana
getEncryptedUtxosByTags
Recupere saídas UTXO criptografadas que correspondam a tags de visualização ou a um anel 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": {}
}
}Saídas criptografadas
Use este método para obter UTXOs criptografadas para descriptografia no lado do cliente. Sua carteira descriptografa as saídas e soma os valores não gastos de cada ativo para determinar seu saldo privado. Este método é comparável aogetTokenAccountsByOwner da Solana, que retorna contas de tokens SPL pertencentes a um endereço. Um saldo privado é armazenado em UTXOs, não em contas da Solana, por isso requer um método RPC dedicado. Saiba mais sobre estado privado e UTXOs.
O método retorna as saídas correspondentes em result.data, agrupadas por transação da Solana. Cada entrada inclui slot e signature da transação. Uma saída inclui seu texto cifrado, sua tag de visualização, seu compromisso, seu ID de árvore e seu índice de folha.
A resposta inclui saídas históricas que talvez já tenham sido gastas. Sua carteira deve rastrear nulificadores para determinar o saldo disponível para gasto. Consulte o guia de saldo privado.
Um array tags vazio requer ringProgramId e seleciona as saídas desse anel. Quando ambos são fornecidos, as saídas devem corresponder às tags e ao anel.
Consulte paginação e atualidade dos dados para saber mais sobre limites de página, tokens de continuação e leituras incrementais.
Parâmetros da solicitação
object
Limites de slot. Retome uma leitura atualizada e sem limite com
slot.gt definido como o context.slot da última página.object
Limites de slot para a leitura. Os limites fornecidos são combinados com AND.
number
Inclua apenas transações posteriores a este slot.
number
Inclua apenas transações neste slot ou posteriores a ele.
number
Inclua apenas transações anteriores a este slot.
number
Inclua apenas transações neste slot ou anteriores a ele.
number
padrão:"1000"
Número máximo de transações da Solana por página, de 1 a 1.000.
number
Slot mínimo persistido do indexador necessário para esta leitura. Retorna o erro JSON-RPC -32016 se o indexador estiver atrasado.
string
Token de continuação da resposta anterior. Envie-o novamente sem alterações, com as mesmas tags, o mesmo anel e os mesmos filtros de slot.
string
Restrinja os resultados ao anel autorizado por este ID de programa. Obrigatório quando tags estiver vazio.
array
obrigatório
Tags de visualização de 32 bytes codificadas em Base58. No máximo 1.000. Um array vazio requer ringProgramId e seleciona esse anel.
Autorizações
Sua chave de API da Helius.
Corpo
application/json
Um ID para identificar a solicitação.
A versão do protocolo JSON-RPC.
Opções disponíveis:
2.0 O método a ser invocado. Deve corresponder ao segmento final do caminho da URL.
Opções disponíveis:
getEncryptedUtxosByTags Show child attributes
Show child attributes
Exemplo:
{
"tags": ["11111111111111111111111111111112"],
"limit": 100
}
Resposta
Resposta JSON-RPC. Verifique error antes de ler result.
Esta página foi útil?
⌘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": {}
}
}