Private Historie lesen

Der Lesevorgang ruft verschlüsselte Transaktionen mit speziellen RPC-Methoden aus dem Indexer ab.
Nur der Benutzer oder eine von ihm autorisierte Person kann die Historie mit seinem Anzeigeschlüssel entschlüsseln.
Nutze dies überall dort, wo die Wallet backfills ausführt: beim Entsperren der Wallet, Öffnen der privaten Wallet, Fortsetzen der App, erneuten Herstellen der Netzwerkverbindung, bei einer Lücke im stream oder beim Wiederherstellen der Wallet.

Compare to getSignaturesForAddress

getSignaturesForAddress gibt öffentliche Signaturen zurück.
Der RPC gibt die öffentliche Historie zurück.

Erste Schritte

TypeScript Client
Rust Client

Voraussetzungen

Für die TypeScript-Beispiele benötigst du Node.js 24 oder höher, pnpm 11.18.0 und die Solana CLI.

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

Quelle: sdk-libs/ts

Connect to Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Füge einen Helius API key hinzu:

.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",
});

Die Beispiele verwenden standardmäßig die Solana CLI wallet als Gebührenzahler. Der Gebührenzahler muss devnet SOL enthalten. Siehe So erhältst du Devnet SOL.

Auf Localnet startet das SDK den lokalen Test-Validator (:8899), den Photon-Indexer (:8784) und den Prover (:3001). Der Client verbindet sich automatisch mit ihnen, ohne dass du endpoints konfigurieren musst.

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

View-Tag ableiten

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 ist senderAddress.confidentialViewTag(), der öffentliche Solana-Schlüssel des Absenders in vertraulichen Rings. Der Indexer verwendet ihn, um passende verschlüsselte Ausgaben zurückzugeben.

Transaktionsausgaben aus dem Indexer abrufen

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

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

getShieldedTransactionsByTags ruft die verschlüsselten Ausgaben ab, die senderViewTag zugeordnet sind.
atSlot(depositTx.slot) wartet, bis der Indexer die Einzahlung in diesem slot erfasst hat.
Der Indexer gibt verschlüsselte Ausgabedaten zurück. Er entschlüsselt die private Historie nicht.

Private Historie entschlüsseln

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) stellt die Schlüssel des Absenders für die lokale Entschlüsselung bereit.
decryptTransactions entschlüsselt übereinstimmende Ausgaben und schreibt den Verlauf in Wallet.
wallet.privateTransactions() liest den entschlüsselten Verlauf.
decryptToBalances gibt nur Guthaben zurück.

Beispiel-response:

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

Unter Privater Zustand und UTXOs erfährst du, wie Eigentümer-Tags und private Solana-Token-Konten funktionieren.

Vollständiges Codebeispiel

Klone das Beispiel und führe es aus:

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

Die Beispiele verwenden hier einen vertraulichen Ring auf local/devnet.

Voraussetzungen

Die Rust-Beispiele erfordern Rust 1.98.1 und die Solana CLI v4.0.2. Weitere Informationen findest du in der Installationsanleitung für 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" }

Quelle: sdk-libs/client

Connect to Endpoints

Devnet
Localnet

Füge einen Helius API key hinzu:

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

Die Beispiele verwenden standardmäßig das Solana-CLI-Wallet als Gebührenzahler. Der Gebührenzahler muss über devnet SOL verfügen. Weitere Informationen findest du unter So erhältst du Devnet SOL.

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

View-Tag ableiten

use zolana_client::Rpc;

let sender_tag = sender_shielded_address.confidential_view_tag()?;

sender_tag ist sender_shielded_address.confidential_view_tag(), der öffentliche Solana-Schlüssel des Absenders in vertraulichen Rings. Der Indexer verwendet ihn, um passende verschlüsselte Ausgaben zurückzugeben.

Transaktionsausgaben aus dem Indexer abrufen

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 ruft die verschlüsselten Ausgaben ab, die sender_tag zugeordnet sind.
IndexerRpcConfig::at_slot(slot) wartet, bis der Indexer die Einzahlung in diesem slot erfasst hat.
Der Indexer gibt verschlüsselte Ausgabedaten zurück. Er entschlüsselt die private Historie nicht.

Private Historie entschlüsseln

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 stellt den Viewing Key des Absenders für die lokale Entschlüsselung bereit.
Wallet::sync entschlüsselt übereinstimmende Outputs und schreibt den Verlauf auf Wallet.
wallet.private_transactions() liest den entschlüsselten Verlauf.
decrypt_spendable gibt verifizierte Salden und UTXOs mit Daten zurück, nicht den Transaktionsverlauf.

Beispiel-response:

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

Vollständiges Codebeispiel

Klone das Beispiel und führe es aus:

git clone https://github.com/helius-labs/zolana-examples.git
cd zolana-examples/rust-client
cargo run -p rust-client-example --example read_history

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

Private Historie lesen

Erste Schritte

Voraussetzungen

View-Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

Private Historie entschlüsseln

Vollständiges Codebeispiel

Voraussetzungen

View-Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

Private Historie entschlüsseln

Vollständiges Codebeispiel

Verwandte Anleitungen

Read a Private Balance

Deposit

Transfer

Withdraw

Nicht gefunden, wonach du gesucht hast?

​Erste Schritte

​Voraussetzungen

​View-Tag ableiten

​Transaktionsausgaben aus dem Indexer abrufen

​Private Historie entschlüsseln

​Vollständiges Codebeispiel

​Voraussetzungen

​View-Tag ableiten

​Transaktionsausgaben aus dem Indexer abrufen

​Private Historie entschlüsseln

​Vollständiges Codebeispiel

​Verwandte Anleitungen

Read a Private Balance

Deposit

Transfer

Withdraw

​Nicht gefunden, wonach du gesucht hast?

Erste Schritte

Voraussetzungen

View-Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

Private Historie entschlüsseln

Vollständiges Codebeispiel

Voraussetzungen

View-Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

Private Historie entschlüsseln

Vollständiges Codebeispiel

Verwandte Anleitungen

Nicht gefunden, wonach du gesucht hast?