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

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 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, LocalShieldedKeys } from "@heliuslabs/zolana/transaction";

const wallet = new Wallet({
  identity: senderAddress,
  registry: assets,
});
await decryptTransactions({
  wallet,
  keys: LocalShieldedKeys.fromKeypair(sender),
  transactions: depositResponse.transactions,
});
const history = wallet.privateTransactions();

LocalShieldedKeys.fromKeypair(sender) fournit les clés de l’expéditeur pour le déchiffrement local.
decryptTransactions déchiffre les sorties correspondantes et écrit l’historique dans 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,
  },
]

Consultez État privé et UTXO pour comprendre le fonctionnement du balisage des propriétaires et des comptes de jetons 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/read_history.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 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_test_utils::wallet::{sync_wallet_with_config, SyncWalletConfig, Wallet};

let mut wallet = Wallet::new(sender.shielded_address()?, assets)
    .map_err(|e| anyhow!("create wallet: {e:?}"))?;
let report = sync_wallet_with_config(
    &mut wallet,
    &sender,
    &client,
    SyncWalletConfig {
        page_limit: 50,
        ..SyncWalletConfig::default()
    },
)?;
anyhow::ensure!(
    report.unknown_asset_ids.is_empty() && report.unknown_mints.is_empty(),
    "could not resolve SPL asset registrations"
);
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 dans Wallet.
wallet.private_transactions() lit l’historique déchiffré.
decrypt_spendable renvoie les soldes vérifiés et les UTXO avec leurs données, mais pas l’historique des transactions.

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 read_history

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

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

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

​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

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

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

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