Lire un solde privé

Lire récupère les comptes de jetons Solana privés chiffrés de l’indexeur avec des méthodes RPC dédiées.
Seul l’utilisateur, ou toute personne que l’utilisateur autorise, peut déchiffrer les soldes avec sa clé de visualisation.
Utilisez-le après qu’un solde privé ait changé et avant un transfert.

Comparer à getBalance / getAccount

getBalance renvoie le SOL public. getAccount renvoie un compte de jetons public.
Le RPC renvoie le solde public.

Commencer

Client TypeScript
Client Rust

Prérequis

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({});

Dériver le tag de visualisation

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 est senderAddress.confidentialViewTag(), la clé publique Solana de l’expéditeur dans les anneaux confidentiels. L’indexeur l’utilise pour renvoyer des sorties chiffrées correspondantes.

Récupérer les sorties de transaction de l’indexeur

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

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

getShieldedTransactionsByTags récupère les sorties chiffrées associées à senderViewTag.
atSlot(depositTx.slot) attend que l’indexeur ait le dépôt à cet emplacement.
L’indexeur renvoie les données de sortie chiffrées. Il ne déchiffre pas le solde privé.

Déchiffrer vers un solde privé

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 fournit la clé de visualisation de l’expéditeur pour le déchiffrement local.
decryptToBalances déchiffre les sorties correspondantes et renvoie les soldes privés de l’expéditeur.
balancesAfterDeposit.balance(SOL_MINT) lit le solde SOL privé.

Voir Concepts pour savoir comment fonctionnent le marquage des propriétaires et les comptes de jetons privés Solana.

Exemple de code complet

Clonez et exécutez l’exemple :

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

Les exemples utilisent un anneau confidentiel sur local/devnet ici.

Prérequis

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,
)?;

Dériver le tag de visualisation

use zolana_client::Rpc;

let sender_tag = sender_shielded_address.confidential_view_tag()?;

sender_tag est sender_shielded_address.confidential_view_tag(), la clé publique Solana de l’expéditeur dans les anneaux confidentiels. L’indexeur l’utilise pour renvoyer des sorties chiffrées correspondantes.

Récupérer les sorties de transaction de l’indexeur

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 récupère les sorties chiffrées associées à sender_tag.
IndexerRpcConfig::at_slot(slot) attend que l’indexeur ait le dépôt à cet emplacement.
L’indexeur renvoie les données de sortie chiffrées. Il ne déchiffre pas le solde privé.

Déchiffrer vers un solde privé

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 fournit la clé de visualisation de l’expéditeur pour le déchiffrement local.
decrypt_transactions déchiffre les sorties correspondantes et renvoie les soldes privés de l’expéditeur.
get_balance(SOL_MINT) lit le solde SOL privé.

Exemple de code complet

Clonez et exécutez l’exemple :

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

Commencer

Diffusion de données et écoute d'événements

API de données et RPC

Trading

Envoyer des transactions

Wallet en tant que service

Confidentialité

Ressources

Commencer

Prérequis

Dériver le tag de visualisation

Récupérer les sorties de transaction de l’indexeur

Déchiffrer vers un solde privé

Exemple de code complet

Prérequis

Dériver le tag de visualisation

Récupérer les sorties de transaction de l’indexeur

Déchiffrer vers un solde privé

Exemple de code complet

Guides connexes

Dépôt

Transfert

Retrait

Lire l'historique privé

Didn’t find what you were looking for?

​Commencer

​Prérequis

​Dériver le tag de visualisation

​Récupérer les sorties de transaction de l’indexeur

​Déchiffrer vers un solde privé

​Exemple de code complet

​Prérequis

​Dériver le tag de visualisation

​Récupérer les sorties de transaction de l’indexeur

​Déchiffrer vers un solde privé

​Exemple de code complet

​Guides connexes

Dépôt

Transfert

Retrait

Lire l'historique privé

​Didn’t find what you were looking for?

Commencer

Prérequis

Dériver le tag de visualisation

Récupérer les sorties de transaction de l’indexeur

Déchiffrer vers un solde privé

Exemple de code complet

Prérequis

Dériver le tag de visualisation

Récupérer les sorties de transaction de l’indexeur

Déchiffrer vers un solde privé

Exemple de code complet

Guides connexes

Didn’t find what you were looking for?