Ein privates Guthaben lesen

‘Read’ ruft verschlüsselte Private Solana Token Accounts aus dem Indexer mit speziellen RPC-Methoden ab.
Nur der Benutzer oder jede Person, der der Benutzer Zugriff gewährt, kann Guthaben mit ihrem Viewing Key entschlüsseln.
Verwenden Sie es, nachdem sich ein privates Guthaben geändert hat und vor einer Übertragung.

Vergleich zu getBalance / getAccount

getBalance gibt öffentliches SOL zurück. getAccount gibt ein öffentliches Token-Konto zurück.
Der RPC gibt das öffentliche Guthaben 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 öffentliche Solana-Schlüssel 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 in diesem Slot hat.
Der Indexer gibt verschlüsselte Ausgabedaten zurück. Er entschlüsselt das private Guthaben nicht.

Zu einem privaten Guthaben entschlüsseln

import { SOL_MINT } from "@heliuslabs/zolana";
import { decryptToBalances } from "@heliuslabs/zolana/transaction";

const balancesAfterDeposit =
  await decryptToBalances({
    keypair: senderKeypair,
    registry: assets,
    transactions: depositResponse.transactions,
  });
const depositBalance =
  balancesAfterDeposit.balance(SOL_MINT);

senderKeypair liefert den Viewing Key des Absenders für die lokale Entschlüsselung.
decryptToBalances entschlüsselt passende Ausgaben und gibt die privaten Guthaben des Absenders zurück.
balancesAfterDeposit.balance(SOL_MINT) liest das private SOL-Guthaben.

Siehe Konzeptionen für Informationen, wie Eigentümer-Tagging und Private Solana Token Accounts funktionieren.

Vollständiges Codebeispiel

Beispiel klonen und 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 öffentliche Solana-Schlüssel 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 in diesem Slot hat.
Der Indexer gibt verschlüsselte Ausgabedaten zurück. Er entschlüsselt das private Guthaben nicht.

Zu einem privaten Guthaben entschlüsseln

use anyhow::anyhow;
use zolana_transaction::{decrypt_transactions, SOL_MINT};

let balances = decrypt_transactions(&sender, &response.transactions, &assets)
    .map_err(|e| anyhow!("decrypt sender transactions: {e:?}"))?;
let sender_balance = balances.get_balance(SOL_MINT);

sender liefert den Viewing Key des Absenders für die lokale Entschlüsselung.
decrypt_transactions entschlüsselt passende Ausgaben und gibt die privaten Guthaben des Absenders zurück.
get_balance(SOL_MINT) liest das private SOL-Guthaben.

Vollständiges Codebeispiel

Beispiel klonen und 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

Ein privates Guthaben lesen

Erste Schritte

Voraussetzungen

Den View Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Zu einem privaten Guthaben entschlüsseln

Vollständiges Codebeispiel

Voraussetzungen

Den View Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Zu einem privaten Guthaben entschlüsseln

Vollständiges Codebeispiel

Verwandte Anleitungen

Einzahlung

Übertragung

Abhebung

Privaten Verlauf lesen

Didn’t find what you were looking for?

​Erste Schritte

​Voraussetzungen

​Den View Tag ableiten

​Transaktionsausgaben vom Indexer abrufen

​Zu einem privaten Guthaben entschlüsseln

​Vollständiges Codebeispiel

​Voraussetzungen

​Den View Tag ableiten

​Transaktionsausgaben vom Indexer abrufen

​Zu einem privaten Guthaben entschlüsseln

​Vollständiges Codebeispiel

​Verwandte Anleitungen

Einzahlung

Übertragung

Abhebung

Privaten Verlauf lesen

​Didn’t find what you were looking for?

Erste Schritte

Voraussetzungen

Den View Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Zu einem privaten Guthaben entschlüsseln

Vollständiges Codebeispiel

Voraussetzungen

Den View Tag ableiten

Transaktionsausgaben vom Indexer abrufen

Zu einem privaten Guthaben entschlüsseln

Vollständiges Codebeispiel

Verwandte Anleitungen

Didn’t find what you were looking for?