Membaca Saldo Privat

Operasi baca mengambil Akun Token Solana Privat yang terenkripsi dari pengindeks menggunakan metode RPC khusus.
Hanya pengguna, atau siapa pun yang diberi otorisasi oleh pengguna, yang dapat mendekripsi saldo dengan kunci penayangannya.
Gunakan operasi ini setelah saldo privat berubah dan sebelum transfer.

Compare to getBalance / getAccount

getBalance mengembalikan SOL publik. getAccount mengembalikan akun token publik.
RPC mengembalikan saldo publik.

Memulai

TypeScript Client
Rust Client

Prasyarat

Contoh TypeScript memerlukan Node.js 24 atau versi yang lebih baru, pnpm 11.18.0, dan Solana CLI.

pnpm add 'git+ssh://git@github.com/helius-labs/zolana.git#v0.3.0-alpha&path:/sdk-libs/ts' @solana/kit@^8.3.0

Sumber: sdk-libs/ts

Connect to Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Tambahkan kunci 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",
  indexerUrl: "https://d2xah7tnhdhcom.cloudfront.net",
  proverUrl: "https://d21ni15goiip6l.cloudfront.net",
});

Contoh-contoh ini menggunakan dompet CLI Solana sebagai pembayar secara default. Pembayar harus memiliki SOL devnet. Lihat Cara Mendapatkan SOL Devnet.

Di localnet, SDK memulai validator pengujian lokal (:8899), pengindeks Photon (:8784), dan prover (:3001), lalu klien terhubung secara otomatis tanpa memerlukan konfigurasi endpoint.

cargo install --git https://github.com/helius-labs/zolana --tag v0.3.0-alpha zolana-cli
zolana dev start

import { createZolanaClient } from "@heliuslabs/zolana";

const client = await createZolanaClient({});

Mendapatkan Tag Penayangan

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 adalah senderAddress.confidentialViewTag(), kunci publik Solana milik pengirim dalam ring rahasia. Pengindeks menggunakannya untuk mengembalikan output terenkripsi yang cocok.

Mengambil Output Transaksi dari Pengindeks

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

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

getShieldedTransactionsByTags mengambil output terenkripsi yang terkait dengan senderViewTag.
atSlot(depositTx.slot) menunggu hingga pengindeks memiliki deposit pada slot tersebut.
Pengindeks mengembalikan data output terenkripsi. Pengindeks tidak mendekripsi saldo privat.

Mendekripsi Menjadi Saldo Privat

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 menyediakan kunci penayangan milik pengirim untuk dekripsi lokal.
decryptToBalances mendekripsi output yang cocok dan mengembalikan saldo privat milik pengirim.
balancesAfterDeposit.balance(SOL_MINT) membaca saldo SOL privat.

Lihat Konsep untuk mempelajari cara kerja penandaan pemilik dan Akun Token Solana Privat.

Contoh Kode Lengkap

Kloning dan jalankan contoh:

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

Contoh-contoh tersebut menggunakan Ring rahasia di local/devnet di sini.

Prasyarat

Contoh Rust memerlukan Rust 1.98.1 dan Solana CLI v4.0.2. Lihat panduan instalasi Solana.

Cargo.toml

[dependencies]
zolana-client = { git = "https://github.com/helius-labs/zolana", tag = "v0.3.0-alpha", features = ["indexer-api", "solana-rpc"] }
zolana-interface = { git = "https://github.com/helius-labs/zolana", tag = "v0.3.0-alpha" }
zolana-program = { git = "https://github.com/helius-labs/zolana", tag = "v0.3.0-alpha" }
zolana-keypair = { git = "https://github.com/helius-labs/zolana", tag = "v0.3.0-alpha" }
zolana-transaction = { git = "https://github.com/helius-labs/zolana", tag = "v0.3.0-alpha" }
zolana-wallet = { git = "https://github.com/helius-labs/zolana", tag = "v0.3.0-alpha" }

Sumber: sdk-libs/client

Connect to Endpoints

Devnet
Localnet

Tambahkan kunci 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 client = ZolanaClient::from_urls(
    SolanaRpc::new("https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
    "https://d2xah7tnhdhcom.cloudfront.net",
    "https://d21ni15goiip6l.cloudfront.net",
)?;

Contoh-contoh ini menggunakan dompet Solana CLI sebagai pembayar secara default. Pembayar harus memiliki SOL devnet. Lihat Cara Mendapatkan SOL Devnet.

cargo install --git https://github.com/helius-labs/zolana --tag v0.3.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",
)?;

Mendapatkan Tag Penayangan

use zolana_client::Rpc;

let sender_tag = sender_shielded_address.confidential_view_tag()?;

sender_tag adalah sender_shielded_address.confidential_view_tag(), kunci publik Solana milik pengirim dalam ring rahasia. Pengindeks menggunakannya untuk mengembalikan output terenkripsi yang cocok.

Mengambil Output Transaksi dari Pengindeks

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 mengambil output terenkripsi yang terkait dengan sender_tag.
IndexerRpcConfig::at_slot(slot) menunggu hingga pengindeks memiliki deposit pada slot tersebut.
Pengindeks mengembalikan data output terenkripsi. Pengindeks tidak mendekripsi saldo privat.

Mendekripsi Menjadi Saldo Privat

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 menyediakan kunci penayangan milik pengirim untuk dekripsi lokal.
decrypt_spendable mendekripsi dan memverifikasi output yang cocok. Kolom .balances berisi saldo milik pengirim untuk output tersebut.
get_balance(SOL_MINT) membaca saldo SOL privat.

Contoh Kode Lengkap

Kloning dan jalankan contoh:

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

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

Memulai

Prasyarat

Mendapatkan Tag Penayangan

Mengambil Output Transaksi dari Pengindeks

Mendekripsi Menjadi Saldo Privat

Contoh Kode Lengkap

Prasyarat

Mendapatkan Tag Penayangan

Mengambil Output Transaksi dari Pengindeks

Mendekripsi Menjadi Saldo Privat

Contoh Kode Lengkap

Panduan Terkait

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

Tidak menemukan yang Anda cari?

​Memulai

​Prasyarat

​Mendapatkan Tag Penayangan

​Mengambil Output Transaksi dari Pengindeks

​Mendekripsi Menjadi Saldo Privat

​Contoh Kode Lengkap

​Prasyarat

​Mendapatkan Tag Penayangan

​Mengambil Output Transaksi dari Pengindeks

​Mendekripsi Menjadi Saldo Privat

​Contoh Kode Lengkap

​Panduan Terkait

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​Tidak menemukan yang Anda cari?

Memulai

Prasyarat

Mendapatkan Tag Penayangan

Mengambil Output Transaksi dari Pengindeks

Mendekripsi Menjadi Saldo Privat

Contoh Kode Lengkap

Prasyarat

Mendapatkan Tag Penayangan

Mengambil Output Transaksi dari Pengindeks

Mendekripsi Menjadi Saldo Privat

Contoh Kode Lengkap

Panduan Terkait

Tidak menemukan yang Anda cari?