Baca Riwayat Privat

Fitur baca mengambil transaksi terenkripsi dari pengindeks menggunakan metode RPC khusus.
Hanya pengguna, atau siapa pun yang diberi wewenang oleh pengguna, yang dapat mendekripsi riwayat menggunakan kunci penampil mereka.
Gunakan fitur ini setiap kali dompet menjalankan pengisian ulang data: saat dompet dibuka kuncinya, dompet privat dibuka, aplikasi dilanjutkan, jaringan terhubung kembali, terdapat celah stream, atau dompet dipulihkan.

Compare to getSignaturesForAddress

getSignaturesForAddress mengembalikan tanda tangan publik.
RPC mengembalikan riwayat publik.

Mulai

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

Dapatkan Tag Tampilan

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.

Ambil 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 setoran pada slot tersebut.
Pengindeks mengembalikan data output terenkripsi. Pengindeks tidak mendekripsi riwayat privat.

Dekripsi menjadi Riwayat Privat

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) menyediakan kunci pengirim untuk dekripsi lokal.
decryptTransactions mendekripsi output yang cocok dan menulis riwayat ke Wallet.
wallet.privateTransactions() membaca riwayat yang telah didekripsi.
decryptToBalances hanya mengembalikan saldo.

Contoh Respons:

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

Lihat Konsep untuk memahami 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/read_history.ts

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

Dapatkan Tag Tampilan

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.

Ambil 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 setoran pada slot tersebut.
Pengindeks mengembalikan data output terenkripsi. Pengindeks tidak mendekripsi riwayat privat.

Dekripsi menjadi Riwayat Privat

use anyhow::anyhow;
use zolana_wallet::{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 menyediakan kunci penampil milik pengirim untuk dekripsi lokal.
Wallet::sync mendekripsi output yang cocok dan menulis riwayat ke Wallet.
wallet.private_transactions() membaca riwayat yang telah didekripsi.
decrypt_spendable mengembalikan saldo terverifikasi dan UTXO beserta datanya, bukan riwayat transaksi.

Contoh Respons:

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

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 read_history

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

Mulai

Prasyarat

Dapatkan Tag Tampilan

Ambil Output Transaksi dari Pengindeks

Dekripsi menjadi Riwayat Privat

Contoh Kode Lengkap

Prasyarat

Dapatkan Tag Tampilan

Ambil Output Transaksi dari Pengindeks

Dekripsi menjadi Riwayat Privat

Contoh Kode Lengkap

Panduan Terkait

Read a Private Balance

Deposit

Transfer

Withdraw

Tidak menemukan yang Anda cari?

​Mulai

​Prasyarat

​Dapatkan Tag Tampilan

​Ambil Output Transaksi dari Pengindeks

​Dekripsi menjadi Riwayat Privat

​Contoh Kode Lengkap

​Prasyarat

​Dapatkan Tag Tampilan

​Ambil Output Transaksi dari Pengindeks

​Dekripsi menjadi Riwayat Privat

​Contoh Kode Lengkap

​Panduan Terkait

Read a Private Balance

Deposit

Transfer

Withdraw

​Tidak menemukan yang Anda cari?

Mulai

Prasyarat

Dapatkan Tag Tampilan

Ambil Output Transaksi dari Pengindeks

Dekripsi menjadi Riwayat Privat

Contoh Kode Lengkap

Prasyarat

Dapatkan Tag Tampilan

Ambil Output Transaksi dari Pengindeks

Dekripsi menjadi Riwayat Privat

Contoh Kode Lengkap

Panduan Terkait

Tidak menemukan yang Anda cari?