Đọc số dư riêng tư

Thao tác đọc truy xuất các Tài khoản Token Solana Riêng tư đã mã hóa từ bộ lập chỉ mục bằng các phương thức RPC chuyên dụng.
Chỉ người dùng hoặc bất kỳ ai được người dùng ủy quyền mới có thể giải mã số dư bằng khóa xem của họ.
Sử dụng thao tác này sau khi số dư riêng tư thay đổi và trước khi chuyển khoản.

Compare to getBalance / getAccount

getBalance trả về SOL công khai. getAccount trả về một tài khoản token công khai.
RPC trả về số dư công khai.

Bắt đầu

TypeScript Client
Rust Client

Điều kiện tiên quyết

Các ví dụ TypeScript yêu cầu Node.js 24 trở lên, pnpm 11.18.0 và 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

Nguồn: sdk-libs/ts

Connect to Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Thêm khóa 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",
});

Theo mặc định, các ví dụ sử dụng ví Solana CLI làm bên thanh toán. Bên thanh toán phải có SOL trên devnet. Xem Cách nhận SOL trên devnet.

Trên localnet, SDK khởi động trình xác thực kiểm thử cục bộ (:8899), trình lập chỉ mục Photon (:8784) và trình chứng minh (:3001), đồng thời máy khách tự động kết nối với chúng mà không cần cấu hình điểm cuối.

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

Tạo thẻ xem

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 là senderAddress.confidentialViewTag(), khóa công khai Solana của người gửi trong các Ring bảo mật. Bộ lập chỉ mục sử dụng khóa này để trả về các đầu ra được mã hóa tương ứng.

Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

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

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

getShieldedTransactionsByTags truy xuất các đầu ra được mã hóa liên kết với senderViewTag.
atSlot(depositTx.slot) chờ cho đến khi bộ lập chỉ mục có khoản nạp tại slot đó.
Bộ lập chỉ mục trả về dữ liệu đầu ra được mã hóa. Bộ lập chỉ mục không giải mã số dư riêng tư.

Giải mã thành số dư riêng tư

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 cung cấp khóa xem của người gửi để giải mã cục bộ.
decryptToBalances giải mã các đầu ra tương ứng và trả về số dư riêng tư của người gửi.
balancesAfterDeposit.balance(SOL_MINT) đọc số dư SOL riêng tư.

Xem Khái niệm để tìm hiểu cách hoạt động của tính năng gắn thẻ chủ sở hữu và Tài khoản Token Solana Riêng tư.

Ví dụ mã đầy đủ

Sao chép kho lưu trữ và chạy ví dụ:

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

Các ví dụ sử dụng một Ring bảo mật trên local/devnet tại đây.

Điều kiện tiên quyết

Các ví dụ Rust yêu cầu Rust 1.98.1 và Solana CLI v4.0.2. Xem hướng dẫn cài đặt 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" }

Nguồn: sdk-libs/client

Connect to Endpoints

Devnet
Localnet

Thêm khóa 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",
)?;

Theo mặc định, các ví dụ sử dụng ví Solana CLI làm tài khoản thanh toán. Tài khoản thanh toán phải có SOL trên devnet. Xem Cách nhận SOL trên 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",
)?;

Tạo thẻ xem

use zolana_client::Rpc;

let sender_tag = sender_shielded_address.confidential_view_tag()?;

sender_tag là sender_shielded_address.confidential_view_tag(), khóa công khai Solana của người gửi trong các Ring bảo mật. Bộ lập chỉ mục sử dụng khóa này để trả về các đầu ra được mã hóa tương ứng.

Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

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 truy xuất các đầu ra được mã hóa liên kết với sender_tag.
IndexerRpcConfig::at_slot(slot) chờ cho đến khi bộ lập chỉ mục có khoản nạp tại slot đó.
Bộ lập chỉ mục trả về dữ liệu đầu ra được mã hóa. Bộ lập chỉ mục không giải mã số dư riêng tư.

Giải mã thành số dư riêng tư

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 cung cấp khóa xem của người gửi để giải mã cục bộ.
decrypt_spendable giải mã và xác minh các đầu ra tương ứng. Trường .balances của đối tượng này chứa số dư của người gửi cho các đầu ra đó.
get_balance(SOL_MINT) đọc số dư SOL riêng tư.

Ví dụ mã đầy đủ

Sao chép kho lưu trữ và chạy ví dụ:

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

Các ví dụ sử dụng một Ring bảo mật trên local/devnet tại đây.

Bắt đầu

Truyền phát dữ liệu & lắng nghe sự kiện

API dữ liệu & RPC

Giao dịch

Gửi giao dịch

Ví dưới dạng dịch vụ

Quyền riêng tư

Tài nguyên

Đọc số dư riêng tư

Bắt đầu

Điều kiện tiên quyết

Tạo thẻ xem

Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

Giải mã thành số dư riêng tư

Ví dụ mã đầy đủ

Điều kiện tiên quyết

Tạo thẻ xem

Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

Giải mã thành số dư riêng tư

Ví dụ mã đầy đủ

Hướng dẫn liên quan

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

Không tìm thấy nội dung bạn đang tìm kiếm?

​Bắt đầu

​Điều kiện tiên quyết

​Tạo thẻ xem

​Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

​Giải mã thành số dư riêng tư

​Ví dụ mã đầy đủ

​Điều kiện tiên quyết

​Tạo thẻ xem

​Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

​Giải mã thành số dư riêng tư

​Ví dụ mã đầy đủ

​Hướng dẫn liên quan

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​Không tìm thấy nội dung bạn đang tìm kiếm?

Bắt đầu

Điều kiện tiên quyết

Tạo thẻ xem

Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

Giải mã thành số dư riêng tư

Ví dụ mã đầy đủ

Điều kiện tiên quyết

Tạo thẻ xem

Truy xuất đầu ra giao dịch từ bộ lập chỉ mục

Giải mã thành số dư riêng tư

Ví dụ mã đầy đủ

Hướng dẫn liên quan

Không tìm thấy nội dung bạn đang tìm kiếm?