Ler um Saldo Privado

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

Os exemplos em TypeScript exigem Node.js 24 ou superior, pnpm 11.18.0 e o Solana CLI.

pnpm add @heliuslabs/zolana@^0.3.1-alpha @solana/kit@^8.3.0

Fonte: sdk-libs/ts

Conectar aos Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Adicione uma chave de API Helius:

.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: "https://d2xah7tnhdhcom.cloudfront.net",
  proverUrl: "https://d21ni15goiip6l.cloudfront.net",
});

Os exemplos usam a carteira Solana CLI como pagador por padrão. O pagador deve possuir SOL na devnet. Veja Como Obter SOL na Devnet.

No localnet, o SDK inicia o validador de teste local (:8899), o indexador Photon (:8784) e o provedor (:3001), e o cliente se conecta a eles automaticamente, sem a necessidade de configuração de endpoint.

cargo install --git https://github.com/helius-labs/zolana --tag v0.3.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: sender,
    registry: assets,
    transactions: depositResponse.transactions,
  });
const depositBalance =
  balancesAfterDeposit.balance(SOL_MINT);

sender fornece a chave de visualização do remetente para descriptografia local.
decryptToBalances descriptografa as 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/sync_balance.ts

Os exemplos usam um Ring confidencial no ambiente local/devnet aqui.

Pré-requisitos

Os exemplos em Rust exigem o Rust 1.98.1 e a CLI da Solana v4.0.2. Consulte o guia de instalação da Solana.

Cargo.toml

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

Fonte: sdk-libs/client

Conectar aos Endpoints

Devnet
Localnet

Adicione uma chave da Helius API:

.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 client = ZolanaClient::from_urls(
    SolanaRpc::new("https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
    "https://d2xah7tnhdhcom.cloudfront.net",
    "https://d21ni15goiip6l.cloudfront.net",
)?;

Os exemplos usam a carteira Solana CLI como a pagadora por padrão. A pagadora deve possuir SOL de devnet. Veja Como Obter SOL de Devnet.

cargo install --git https://github.com/helius-labs/zolana --tag v0.3.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 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_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 fornece a chave de visualização do remetente para descriptografia local.
decrypt_spendable descriptografa e verifica as saídas correspondentes. Seu campo .balances contém os saldos do remetente para essas saídas.
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 sync_balance

Primeiros passos

Streaming de dados e escuta de eventos

APIs de dados e RPCs

Negociação

Envio de transações

Carteira como serviço

Privacidade

Recursos

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

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

Não encontrou o que estava procurando?

​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

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​Não encontrou o que estava procurando?

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

Não encontrou o que estava procurando?