Leer un saldo privado

La lectura obtiene cuentas privadas de tokens de Solana cifradas desde el indexador mediante métodos RPC específicos.
Solo el usuario, o cualquier persona que este autorice, puede descifrar los saldos con su clave de visualización.
Úsala después de que cambie un saldo privado y antes de una transferencia.

Compare to getBalance / getAccount

getBalance devuelve SOL público. getAccount devuelve una cuenta pública de tokens.
El RPC devuelve el saldo público.

Comenzar

TypeScript Client
Rust Client

Requisitos previos

Los ejemplos de TypeScript requieren Node.js 24 o una versión posterior, pnpm 11.18.0 y la CLI de Solana.

pnpm add @heliuslabs/spr@^0.9.0-alpha @solana/kit@^8.3.0

Connect to Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Agrega una clave de API de Helius:

.env

API_KEY=YOUR_API_KEY
ZOLANA_PAYER_KEYPAIR=~/.config/solana/id.json

import { createSprClient } from "@heliuslabs/spr";

const client = await createSprClient({
  solanaRpcUrl: "https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY",
});

Los ejemplos usan de forma predeterminada la billetera de la CLI de Solana como pagador. El pagador debe tener SOL de devnet. Consulta Cómo obtener SOL de devnet.

En localnet, el SDK inicia el validador de pruebas local (:8899), el indexador Photon (:8784) y el demostrador (:3001), y el cliente se conecta a ellos automáticamente sin necesidad de configurar puntos de conexión.

cargo install --git https://github.com/helius-labs/zolana --tag v0.5.0-alpha zolana-cli
zolana dev start

import { createSprClient } from "@heliuslabs/spr";

const client = await createSprClient({});

Derivar la etiqueta de visualización

import { createSprClient } from "@heliuslabs/spr";

// The view tag is the sender's Solana public key in confidential rings.
// Used by the indexer to fetch the sender's UTXOs.
const senderViewTag =
  senderAddress.confidentialViewTag();

senderViewTag es senderAddress.confidentialViewTag(), la clave pública de Solana del remitente en anillos confidenciales. El indexador la usa para devolver las salidas cifradas coincidentes.

Obtener las salidas de transacciones del indexador

import { atSlot } from "@heliuslabs/spr/client";

const depositResponse =
  await client.getShieldedTransactionsByTags(
    { tags: [senderViewTag] },
    atSlot(depositTx.slot),
  );

getShieldedTransactionsByTags obtiene las salidas cifradas asociadas con senderViewTag.
atSlot(depositTx.slot) espera hasta que el indexador tenga el depósito en ese slot.
El indexador devuelve datos de salida cifrados. No descifra el saldo privado.

Descifrar para obtener un saldo privado

import { SOL_MINT } from "@heliuslabs/spr";
import { decryptToBalances } from "@heliuslabs/spr/transaction";

const balancesAfterDeposit =
  await decryptToBalances({
    keypair: sender,
    registry: assets,
    transactions: depositResponse.transactions,
  });
const depositBalance =
  balancesAfterDeposit.balance(SOL_MINT);

sender proporciona la clave de visualización del remitente para el descifrado local.
decryptToBalances descifra las salidas coincidentes y devuelve los saldos privados del remitente.
balancesAfterDeposit.balance(SOL_MINT) lee el saldo privado de SOL.

Consulta Estado privado y UTXO para saber cómo funcionan el etiquetado de propietarios y las cuentas privadas de tokens de Solana.

Ejemplo de código completo

Clona y ejecuta el ejemplo:

git clone https://github.com/helius-labs/zolana-examples.git
cd zolana-examples/typescript-client
pnpm install
pnpm example examples/sync_balance.ts

Los ejemplos usan un Ring confidencial en local/devnet aquí.

Requisitos previos

Los ejemplos de Rust requieren Rust 1.98.1 y la CLI de Solana v4.0.2. Consulta la guía de instalación de Solana.

Cargo.toml

[dependencies]
zolana-client = { git = "https://github.com/helius-labs/zolana", tag = "v0.5.0-alpha", features = ["solana-rpc"] }
zolana-interface = { git = "https://github.com/helius-labs/zolana", tag = "v0.5.0-alpha" }
zolana-program = { git = "https://github.com/helius-labs/zolana", tag = "v0.5.0-alpha" }
zolana-keypair = { git = "https://github.com/helius-labs/zolana", tag = "v0.5.0-alpha" }
zolana-transaction = { git = "https://github.com/helius-labs/zolana", tag = "v0.5.0-alpha" }
zolana-test-utils = { git = "https://github.com/helius-labs/zolana", tag = "v0.5.0-alpha" }

Connect to Endpoints

Devnet
Localnet

Agrega una clave de API de Helius:

.env

API_KEY=YOUR_API_KEY
ZOLANA_PAYER_KEYPAIR=~/.config/solana/id.json

use zolana_client::{SolanaRpc, ZolanaClient};
use zolana_interface::pda;

let tree = pda::tree(0);
let url = "https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY";
let client = ZolanaClient::from_urls(SolanaRpc::new(url), url, url)?;

Los ejemplos usan la billetera de Solana CLI como pagador de forma predeterminada. El pagador debe tener SOL de devnet. Consulta Cómo obtener SOL de devnet.

cargo install --git https://github.com/helius-labs/zolana --tag v0.5.0-alpha zolana-cli
zolana dev start

use zolana_client::{SolanaRpc, ZolanaClient};
use zolana_interface::pda;

let tree = pda::tree(0);
let client = ZolanaClient::from_urls(
    SolanaRpc::new("http://127.0.0.1:8899"),
    "http://127.0.0.1:8784",
    "http://127.0.0.1:3001",
)?;

Derivar la etiqueta de visualización

use zolana_client::Rpc;

let sender_tag = sender_shielded_address.confidential_view_tag()?;

sender_tag es sender_shielded_address.confidential_view_tag(), la clave pública de Solana del remitente en anillos confidenciales. El indexador la usa para devolver las salidas cifradas coincidentes.

Obtener las salidas de transacciones del indexador

use zolana_client::{IndexerRpcConfig, Rpc};

let response = client.get_shielded_transactions_by_tags(
    vec![sender_tag],
    None,
    Some(50),
    Some(IndexerRpcConfig::at_slot(slot)),
)?;

get_shielded_transactions_by_tags obtiene las salidas cifradas asociadas con sender_tag.
IndexerRpcConfig::at_slot(slot) espera hasta que el indexador tenga el depósito en ese slot.
El indexador devuelve datos de salida cifrados. No descifra el saldo privado.

Descifrar para obtener un saldo privado

use anyhow::anyhow;
use zolana_transaction::{decrypt_spendable, SOL_MINT};

let balances = decrypt_spendable(&sender, &response.transactions, &assets)
    .map_err(|e| anyhow!("decrypt sender transactions: {e:?}"))?
    .balances;
let sender_balance = balances.get_balance(SOL_MINT);

sender proporciona la clave de visualización del remitente para el descifrado local.
decrypt_spendable descifra y verifica las salidas coincidentes. Su campo .balances contiene los saldos del remitente para esas salidas.
get_balance(SOL_MINT) lee el saldo privado de SOL.

Ejemplo de código completo

Clona y ejecuta el ejemplo:

git clone https://github.com/helius-labs/zolana-examples.git
cd zolana-examples/rust-client
cargo run -p rust-client-example --example sync_balance

Primeros pasos

Transmisión de datos y escucha de eventos

API de datos y RPC

Trading

Envío de transacciones

Billetera como servicio

Privacidad

Recursos

Leer un saldo privado

Comenzar

Requisitos previos

Derivar la etiqueta de visualización

Obtener las salidas de transacciones del indexador

Descifrar para obtener un saldo privado

Ejemplo de código completo

Requisitos previos

Derivar la etiqueta de visualización

Obtener las salidas de transacciones del indexador

Descifrar para obtener un saldo privado

Ejemplo de código completo

Guías relacionadas

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

¿No encontraste lo que buscabas?

​Comenzar

​Requisitos previos

​Derivar la etiqueta de visualización

​Obtener las salidas de transacciones del indexador

​Descifrar para obtener un saldo privado

​Ejemplo de código completo

​Requisitos previos

​Derivar la etiqueta de visualización

​Obtener las salidas de transacciones del indexador

​Descifrar para obtener un saldo privado

​Ejemplo de código completo

​Guías relacionadas

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​¿No encontraste lo que buscabas?

Comenzar

Requisitos previos

Derivar la etiqueta de visualización

Obtener las salidas de transacciones del indexador

Descifrar para obtener un saldo privado

Ejemplo de código completo

Requisitos previos

Derivar la etiqueta de visualización

Obtener las salidas de transacciones del indexador

Descifrar para obtener un saldo privado

Ejemplo de código completo

Guías relacionadas

¿No encontraste lo que buscabas?