Read busca Contas de Token Privadas Solana criptografadas do indexador com métodos RPC dedicados.
Apenas o usuário, ou qualquer pessoa que o usuário autorize, pode descriptografar saldos com sua chave de visualização.
Use isso depois que um saldo privado mudar e antes de uma transferência.

Comparar com getBalance / getAccount

getBalance retorna SOL público. getAccount retorna uma conta de token pública.
O RPC retorna o saldo público.

Introdução

Cliente TypeScript
Cliente Rust

Pré-requisitos

The TypeScript examples require Node.js 24 or later, pnpm 11.18.0, and the Solana CLI.

pnpm add @heliuslabs/zolana @solana/kit

Source: sdk-libs/ts

Connect to Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Add a Helius API key:

.env

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

import { createZolanaClient } from "@heliuslabs/zolana";

const client = await createZolanaClient({
  solanaRpcUrl: "https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY",
  indexerUrl: "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com",
  proverUrl: "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com:3001",
  allowInsecureHttp: true,
});

The examples use the Solana CLI wallet as the payer by default. The payer must hold devnet SOL. See How to Get Devnet SOL.

On localnet the SDK starts the local test validator (:8899), Photon indexer (:8784), and prover (:3001), and the client connects to them automatically without needing endpoint configuration.

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

import { createZolanaClient } from "@heliuslabs/zolana";

const client = await createZolanaClient({});

Derivar a Tag de Visualização

import { createZolanaClient } from "@heliuslabs/zolana";

// 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 é senderAddress.confidentialViewTag(), a chave pública Solana do remetente em anéis confidenciais. O indexador a usa para retornar saídas criptografadas correspondentes.

Buscar Saídas de Transações do Indexador

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

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

getShieldedTransactionsByTags busca as saídas criptografadas associadas a senderViewTag.
atSlot(depositTx.slot) espera até que o indexador tenha o depósito naquele slot.
O indexador retorna dados de saída criptografados. Ele não descriptografa o saldo privado.

Descriptografar para um Saldo Privado

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

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

senderKeypair fornece a chave de visualização do remetente para descriptografia local.
decryptToBalances descriptografa saídas correspondentes e retorna os saldos privados do remetente.
balancesAfterDeposit.balance(SOL_MINT) lê o saldo privado de SOL.

Veja Conceitos para entender como funciona a marcação de proprietário e Contas de Token Privadas Solana.

Exemplo Completo de Código

Clone e execute o exemplo:

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

Os exemplos usam um Anel confidencial no local/devnet aqui.

Pré-requisitos

The Rust examples require the latest stable Rust toolchain and the Solana CLI v4.0.2. See the Solana installation guide.

Cargo.toml

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

Source: sdk-libs/client

Connect to Endpoints

Devnet
Localnet

Add a Helius API key:

.env

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

use solana_address::Address;
use zolana_client::{SolanaRpc, ZolanaClient};
use zolana_interface::DEFAULT_TREE_ADDRESS;

let tree: Address = DEFAULT_TREE_ADDRESS.parse()?;
let client = ZolanaClient::from_urls_allowing_insecure_http(
    SolanaRpc::new("https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
    "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com",
    "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com:3001",
    tree,
);

The examples use the Solana CLI wallet as the payer by default. The payer must hold devnet SOL. See How to Get Devnet SOL.

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

use solana_address::Address;
use zolana_client::{SolanaRpc, ZolanaClient};
use zolana_interface::DEFAULT_TREE_ADDRESS;

let tree: Address = DEFAULT_TREE_ADDRESS.parse()?;
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",
    tree,
)?;

Derivar a Tag de Visualização

use zolana_client::Rpc;

let sender_tag = sender_shielded_address.confidential_view_tag()?;

sender_tag é sender_shielded_address.confidential_view_tag(), a chave pública Solana do remetente em anéis confidenciais. O indexador a usa para retornar saídas criptografadas correspondentes.

Buscar Saídas de Transações do 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 busca as saídas criptografadas associadas a sender_tag.
IndexerRpcConfig::at_slot(slot) espera até que o indexador tenha o depósito naquele slot.
O indexador retorna dados de saída criptografados. Ele não descriptografa o saldo privado.

Descriptografar para um Saldo Privado

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

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

sender fornece a chave de visualização do remetente para descriptografia local.
decrypt_transactions descriptografa saídas correspondentes e retorna os saldos privados do remetente.
get_balance(SOL_MINT) lê o saldo privado de SOL.

Exemplo Completo de Código

Clone e execute o exemplo:

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

Introdução

Streaming de Dados & Escuta de Eventos

APIs de Dados & RPCs

Trading

Enviando Transações

Wallet-como-Serviço

Privacidade

Guias

Recursos

Ler um Saldo Privado

Introdução

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transações do Indexador

Descriptografar para um Saldo Privado

Exemplo Completo de Código

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transações do Indexador

Descriptografar para um Saldo Privado

Exemplo Completo de Código

Guias Relacionados

Depósito

Transferir

Sacar

Ler Histórico Privado

Didn’t find what you were looking for?

​Introdução

​Pré-requisitos

​Derivar a Tag de Visualização

​Buscar Saídas de Transações do Indexador

​Descriptografar para um Saldo Privado

​Exemplo Completo de Código

​Pré-requisitos

​Derivar a Tag de Visualização

​Buscar Saídas de Transações do Indexador

​Descriptografar para um Saldo Privado

​Exemplo Completo de Código

​Guias Relacionados

Depósito

Transferir

Sacar

Ler Histórico Privado

​Didn’t find what you were looking for?

Introdução

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transações do Indexador

Descriptografar para um Saldo Privado

Exemplo Completo de Código

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transações do Indexador

Descriptografar para um Saldo Privado

Exemplo Completo de Código

Guias Relacionados

Didn’t find what you were looking for?