Private Historie lesen

Lesen ruft verschlüsselte Transaktionen vom Indexer mit dedizierten RPC-Methoden ab.
Nur der Benutzer oder jemand, den der Benutzer autorisiert, kann die Historie mit seinem Viewing Key entschlüsseln.
Verwenden Sie es, wann immer das Wallet Backfills ausführt: beim Entsperren des Wallets, beim Öffnen des privaten Wallets, beim Fortsetzen der App, bei der Netzwerkverbindung, bei Stream-Lücken oder bei der Wiederherstellung des Wallets.

Vergleich zu getSignaturesForAddress

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

Erste Schritte

TypeScript Client
Rust Client

Voraussetzungen

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

Den 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 Solana-Public-Key des Absenders in vertraulichen Ringen. Der Indexer verwendet ihn, um passende verschlüsselte Ausgaben zurückzugeben.

Transaktionsausgaben vom 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 mit senderViewTag verknüpft sind.
atSlot(depositTx.slot) wartet, bis der Indexer die Einzahlung an diesem Slot hat.
Der Indexer gibt verschlüsselte Ausgabendaten zurück. Er entschlüsselt die private Historie nicht.

Entschlüsselung zur privaten Historie

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 liefert den Viewing Key des Absenders zur lokalen Entschlüsselung.
decryptTransactions entschlüsselt passende Ausgaben und schreibt die Historie auf Wallet.
wallet.privateTransactions() liest die entschlüsselte Historie.
decryptToBalances gibt nur Salden zurück.

Beispielantwort:

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

Siehe Konzept für Informationen darüber, wie Eigentümerkennzeichnung und Private Solana Token Accounts funktionieren.

Vollständiges Codebeispiel

Klonen und Beispiel ausführen:

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

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

Voraussetzungen

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

Den 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 Solana-Public-Key des Absenders in vertraulichen Ringen. Der Indexer verwendet ihn, um passende verschlüsselte Ausgaben zurückzugeben.

Transaktionsausgaben vom 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 mit sender_tag verknüpft sind.
IndexerRpcConfig::at_slot(slot) wartet, bis der Indexer die Einzahlung an diesem Slot hat.
Der Indexer gibt verschlüsselte Ausgabendaten zurück. Er entschlüsselt die private Historie nicht.

Entschlüsselung zur privaten Historie

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 liefert den Viewing Key des Absenders zur lokalen Entschlüsselung.
Wallet::sync entschlüsselt passende Ausgaben und schreibt die Historie auf Wallet.
wallet.private_transactions() liest die entschlüsselte Historie.
decrypt_transactions gibt nur Salden zurück.

Beispielantwort:

[
    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

Klonen und Beispiel ausführen:

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

Erste Schritte

Daten-Streaming & Ereignisüberwachung

Daten-APIs & RPCs

Handel

Transaktionen senden

Wallet-as-a-Service

Privatsphäre

Ressourcen

Private Historie lesen

Erste Schritte

Voraussetzungen

Den View-Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Entschlüsselung zur privaten Historie

Vollständiges Codebeispiel

Voraussetzungen

Den View-Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Entschlüsselung zur privaten Historie

Vollständiges Codebeispiel

Verwandte Anleitungen

Einen privaten Saldo lesen

Einzahlung

Übertragen

Abheben

Didn’t find what you were looking for?

​Erste Schritte

​Voraussetzungen

​Den View-Tag ableiten

​Transaktionsausgaben vom Indexer abrufen

​Entschlüsselung zur privaten Historie

​Vollständiges Codebeispiel

​Voraussetzungen

​Den View-Tag ableiten

​Transaktionsausgaben vom Indexer abrufen

​Entschlüsselung zur privaten Historie

​Vollständiges Codebeispiel

​Verwandte Anleitungen

Einen privaten Saldo lesen

Einzahlung

Übertragen

Abheben

​Didn’t find what you were looking for?

Erste Schritte

Voraussetzungen

Den View-Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Entschlüsselung zur privaten Historie

Vollständiges Codebeispiel

Voraussetzungen

Den View-Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Entschlüsselung zur privaten Historie

Vollständiges Codebeispiel

Verwandte Anleitungen

Didn’t find what you were looking for?