A leitura busca transações criptografadas do indexador com métodos RPC dedicados.
Apenas o usuário, ou qualquer pessoa que ele autorize, pode descriptografar o histórico com sua chave de visualização.
Use em qualquer lugar onde a carteira executa preenchimentos: ao desbloquear a carteira, abrir carteira privada, retomar aplicativo, reconectar rede, intervalo de streaming ou restaurar carteira.

Comparar com getSignaturesForAddress

getSignaturesForAddress retorna assinaturas públicas.
O RPC retorna o histórico público.

Comece Agora

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 utiliza para retornar saídas criptografadas correspondentes.

Buscar Saídas de Transação 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 com 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 histórico privado.

Descriptografar para Histórico Privado

import { Wallet } from "@heliuslabs/zolana";
import { decryptTransactions } from "@heliuslabs/zolana/transaction";

const wallet = new Wallet({
  identity: senderAddress,
  registry: assets,
});
await decryptTransactions({
  wallet,
  authority: {
    syncMaterial: () =>
      Promise.resolve({
        identity: senderAddress,
        viewingKeys: [senderKeypair.viewingKey()],
        nullifierKey: senderKeypair.nullifierKey(),
      }),
  },
  transactions: depositResponse.transactions,
});
const history = wallet.privateTransactions();

senderKeypair fornece a chave de visualização do remetente para a descriptografia local.
decryptTransactions descriptografa saídas correspondentes e grava o histórico em Wallet.
wallet.privateTransactions() lê o histórico descriptografado.
decryptToBalances retorna apenas saldos.

Resposta de Exemplo:

[
  {
    id: { signature: "5x…", slot: 291044100n, index: 0n },
    kind: "deposit",
    direction: "inbound",
    status: "confirmed",
    asset: SOL_MINT,
    amount: 100_000_000n,
    counterpartyViewingPublicKey: undefined,
  },
]

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

Exemplo de Código Completo

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 utiliza para retornar saídas criptografadas correspondentes.

Buscar Saídas de Transação 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 com 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 histórico privado.

Descriptografar para Histórico Privado

use anyhow::anyhow;
use zolana_transaction::{Wallet, DEFAULT_TAG_WINDOW};

let mut wallet = Wallet::new(sender.shielded_address()?, assets.clone())
    .map_err(|e| anyhow!("create wallet: {e:?}"))?;
wallet
    .sync(&sender, &response.transactions, 0, DEFAULT_TAG_WINDOW)
    .map_err(|e| anyhow!("decrypt sender transactions: {e:?}"))?;
let history = wallet.private_transactions();

sender fornece a chave de visualização do remetente para a descriptografia local.
Wallet::sync descriptografa saídas correspondentes e grava o histórico em Wallet.
wallet.private_transactions() lê o histórico descriptografado.
decrypt_transactions retorna apenas saldos.

Resposta de Exemplo:

[
    PrivateTransaction {
        id: PrivateTransactionId {
            signature: "5x…".into(),
            slot: 291044100,
            index: 0,
        },
        kind: PrivateTransactionKind::Deposit,
        direction: PrivateTransactionDirection::Inbound,
        status: PrivateTransactionStatus::Confirmed,
        asset: SOL_MINT,
        amount: 100_000_000,
        counterparty_viewing_pubkey: None,
    },
]

Exemplo de Código Completo

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 Histórico Privado

Comece Agora

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transação do Indexador

Descriptografar para Histórico Privado

Exemplo de Código Completo

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transação do Indexador

Descriptografar para Histórico Privado

Exemplo de Código Completo

Guias Relacionados

Ler um Saldo Privado

Depositar

Transferir

Retirar

Didn’t find what you were looking for?

​Comece Agora

​Pré-requisitos

​Derivar a Tag de Visualização

​Buscar Saídas de Transação do Indexador

​Descriptografar para Histórico Privado

​Exemplo de Código Completo

​Pré-requisitos

​Derivar a Tag de Visualização

​Buscar Saídas de Transação do Indexador

​Descriptografar para Histórico Privado

​Exemplo de Código Completo

​Guias Relacionados

Ler um Saldo Privado

Depositar

Transferir

Retirar

​Didn’t find what you were looking for?

Comece Agora

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transação do Indexador

Descriptografar para Histórico Privado

Exemplo de Código Completo

Pré-requisitos

Derivar a Tag de Visualização

Buscar Saídas de Transação do Indexador

Descriptografar para Histórico Privado

Exemplo de Código Completo

Guias Relacionados

Didn’t find what you were looking for?