Lire l'historique privé

Lire récupère les transactions chiffrées de l’indexeur avec des méthodes RPC dédiées.
Seul l’utilisateur, ou toute personne autorisée par l’utilisateur, peut déchiffrer l’historique avec sa clé de visualisation.
Utilisez-le partout où le portefeuille effectue des remplissages : lors du déverrouillage du portefeuille, de l’ouverture d’un portefeuille privé, de la reprise de l’application, de la reconnexion au réseau, d’un écart de flux ou de la restauration d’un portefeuille.

Comparer à getSignaturesForAddress

getSignaturesForAddress renvoie des signatures publiques.
Le RPC renvoie l’historique 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 vue

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 transactions 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 à ce créneau.
L’indexeur renvoie des données de sortie chiffrées. Il ne déchiffre pas l’historique privé.

Déchiffrer pour un historique privé

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 fournit la clé de visualisation de l’expéditeur pour le déchiffrement local.
decryptTransactions déchiffre les sorties correspondantes et écrit l’historique sur Wallet.
wallet.privateTransactions() lit l’historique déchiffré.
decryptToBalances renvoie uniquement les soldes.

Réponse Exemple :

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

Voir Concepts pour comprendre le marquage des propriétaires et le fonctionnement des 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 vue

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 transactions 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 à ce créneau.
L’indexeur renvoie des données de sortie chiffrées. Il ne déchiffre pas l’historique privé.

Déchiffrer pour un historique privé

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 fournit la clé de visualisation de l’expéditeur pour le déchiffrement local.
Wallet::sync déchiffre les sorties correspondantes et écrit l’historique sur Wallet.
wallet.private_transactions() lit l’historique déchiffré.
decrypt_transactions renvoie uniquement les soldes.

Réponse Exemple :

[
    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,
    },
]

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

Lire l'historique privé

Commencer

Prérequis

Dériver le tag de vue

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

Déchiffrer pour un historique privé

Exemple de Code Complet

Prérequis

Dériver le tag de vue

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

Déchiffrer pour un historique privé

Exemple de Code Complet

Guides Associés

Lire un solde privé

Déposer

Transférer

Retirer

Didn’t find what you were looking for?

​Commencer

​Prérequis

​Dériver le tag de vue

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

​Déchiffrer pour un historique privé

​Exemple de Code Complet

​Prérequis

​Dériver le tag de vue

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

​Déchiffrer pour un historique privé

​Exemple de Code Complet

​Guides Associés

Lire un solde privé

Déposer

Transférer

Retirer

​Didn’t find what you were looking for?

Commencer

Prérequis

Dériver le tag de vue

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

Déchiffrer pour un historique privé

Exemple de Code Complet

Prérequis

Dériver le tag de vue

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

Déchiffrer pour un historique privé

Exemple de Code Complet

Guides Associés

Didn’t find what you were looking for?