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

Les exemples TypeScript nécessitent Node.js 24 ou une version ultérieure, pnpm 11.18.0, et le Solana CLI.

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

Source : sdk-libs/ts

Connecter aux Points de Terminaison

Devnet
Localnet

pnpm install
cp .env.example .env

Ajoutez une clé 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",
});

Les exemples utilisent le portefeuille Solana CLI comme payeur par défaut. Le payeur doit détenir du SOL sur le devnet. Voir Comment obtenir Devnet SOL.

Sur localnet, le SDK démarre le validateur de test local (:8899), l’indexeur Photon (:8784) et le prouveur (:3001), et le client s’y connecte automatiquement sans qu’il soit nécessaire de configurer les points de terminaison.

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

sender 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é.

Consultez État privé et UTXO pour comprendre le fonctionnement du marquage des propriétaires et des comptes de tokens Solana privés.

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/sync_balance.ts

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

Prérequis

Les exemples en Rust nécessitent Rust 1.98.1 et la CLI Solana v4.0.2. Consultez le guide d’installation 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" }

Source : sdk-libs/client

Se connecter aux points de terminaison

Devnet
Localnet

Ajoutez une clé API 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)?;

Les exemples utilisent le portefeuille CLI Solana comme payeur par défaut. Le payeur doit détenir des SOL de devnet. Voir Comment obtenir du SOL 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",
)?;

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_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 fournit la clé de visualisation de l’expéditeur pour le déchiffrement local.
decrypt_spendable déchiffre et vérifie les sorties correspondantes. Son champ .balances contient les soldes de l’expéditeur pour ces sorties.
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 sync_balance

Bien démarrer

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

API de données et RPC

Trading

Envoi de transactions

Portefeuille 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

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

Vous n’avez pas trouvé ce que vous cherchiez ?

​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

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​Vous n’avez pas trouvé ce que vous cherchiez ?

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

Vous n’avez pas trouvé ce que vous cherchiez ?