Privates Guthaben auslesen

Read ruft verschlüsselte private Solana-Token-Konten mit dedizierten RPC-Methoden aus dem Indexer ab.
Nur der Benutzer oder eine von ihm autorisierte Person kann Guthaben mit dem Viewing Key entschlüsseln.
Verwende Read, nachdem sich ein privates Guthaben geändert hat und bevor du eine Übertragung ausführst.

Compare to 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

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 mit senderViewTag verknüpften verschlüsselten Ausgaben ab.
atSlot(depositTx.slot) wartet, bis der Indexer die Einzahlung an diesem slot erfasst hat.
Der Indexer gibt verschlüsselte Ausgabedaten zurück. Er entschlüsselt das private Guthaben nicht.

In ein privates Guthaben entschlüsseln

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

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

sender stellt den Anzeigeschlüssel des Absenders für die lokale Entschlüsselung bereit.
decryptToBalances entschlüsselt übereinstimmende Ausgaben und gibt die privaten Guthaben des Absenders zurück.
balancesAfterDeposit.balance(SOL_MINT) liest das private SOL-Guthaben aus.

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/sync_balance.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 mit sender_tag verknüpften verschlüsselten Ausgaben ab.
IndexerRpcConfig::at_slot(slot) wartet, bis der Indexer die Einzahlung an diesem slot erfasst hat.
Der Indexer gibt verschlüsselte Ausgabedaten zurück. Er entschlüsselt das private Guthaben nicht.

In ein privates Guthaben entschlüsseln

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

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

sender liefert den Viewing Key des Absenders für die lokale Entschlüsselung.
decrypt_spendable entschlüsselt und verifiziert übereinstimmende Outputs. Das Feld .balances enthält die Guthaben des Absenders für diese Outputs.
get_balance(SOL_MINT) liest das private SOL-Guthaben aus.

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 sync_balance

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

Privates Guthaben auslesen

Erste Schritte

Voraussetzungen

View Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

In ein privates Guthaben entschlüsseln

Vollständiges Codebeispiel

Voraussetzungen

View Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

In ein privates Guthaben entschlüsseln

Vollständiges Codebeispiel

Verwandte Anleitungen

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

Nicht gefunden, wonach du gesucht hast?

​Erste Schritte

​Voraussetzungen

​View Tag ableiten

​Transaktionsausgaben aus dem Indexer abrufen

​In ein privates Guthaben entschlüsseln

​Vollständiges Codebeispiel

​Voraussetzungen

​View Tag ableiten

​Transaktionsausgaben aus dem Indexer abrufen

​In ein privates Guthaben entschlüsseln

​Vollständiges Codebeispiel

​Verwandte Anleitungen

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​Nicht gefunden, wonach du gesucht hast?

Erste Schritte

Voraussetzungen

View Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

In ein privates Guthaben entschlüsseln

Vollständiges Codebeispiel

Voraussetzungen

View Tag ableiten

Transaktionsausgaben aus dem Indexer abrufen

In ein privates Guthaben entschlüsseln

Vollständiges Codebeispiel

Verwandte Anleitungen

Nicht gefunden, wonach du gesucht hast?