Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
New: Try Gatekeeper (Beta) for significantly lower latency. Learn More
从索引器读取钱包私密余额的指南，包含完整的代码示例。
与 getBalance / getAccount 比较
getBalance 返回公开的 SOL。getAccount 返回一个公开的代币账户。pnpm add @heliuslabs/zolana@^0.3.1-alpha @solana/kit@^8.3.0
连接到端点
pnpm install
cp .env.example .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",
});
:8899)、Photon 索引器(:8784)和证明器(:3001)，客户端自动连接到它们而无需配置端点。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({});
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 是 senderAddress.confidentialViewTag()，发送者在机密环中的 Solana 公钥。索引器使用它返回匹配的加密输出。import { atSlot } from "@heliuslabs/zolana/client";
const depositResponse =
await client.getShieldedTransactionsByTags(
{ tags: [senderViewTag] },
atSlot(depositTx.slot),
);
getShieldedTransactionsByTags 获取与 senderViewTag 相关的加密输出。atSlot(depositTx.slot) 等待索引器在该插槽中有存款。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 提供发送方的查看密钥，用于本地解密。decryptToBalances 解密匹配的输出，并返回发送方的私密余额。balancesAfterDeposit.balance(SOL_MINT) 读取私密 SOL 余额。git clone https://github.com/helius-labs/zolana-examples.git
cd zolana-examples/typescript-client
pnpm install
pnpm example examples/sync_balance.ts
[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" }
连接到端点
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",
)?;
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",
)?;
use zolana_client::Rpc;
let sender_tag = sender_shielded_address.confidential_view_tag()?;
sender_tag 是 sender_shielded_address.confidential_view_tag()，发送者在机密环中的 Solana 公钥。索引器使用它返回匹配的加密输出。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 获取与 sender_tag 相关的加密输出。IndexerRpcConfig::at_slot(slot) 等待索引器在该插槽中有存款。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 提供发送者的查看密钥，用于本地解密。decrypt_spendable 解密并验证匹配的输出。其 .balances 字段包含发送者在这些输出中的余额。get_balance(SOL_MINT) 读取私有 SOL 余额。git clone https://github.com/helius-labs/zolana-examples.git
cd zolana-examples/rust-client
cargo run -p rust-client-example --example sync_balance
此页面对您有帮助吗？