使用专用的 RPC 方法从索引器读取加密交易。
只有用户或用户授权的人才能使用他们的查看密钥解密历史记录。
在钱包运行回填时使用：在钱包解锁、私密钱包打开、应用恢复、网络重新连接、流间隙或钱包恢复时。

与 getSignaturesForAddress 的比较

getSignaturesForAddress 返回公共签名。
RPC 返回公共历史。

开始使用

TypeScript 客户端
Rust 客户端

前提条件

The TypeScript examples require Node.js 24 or later, pnpm 11.18.0, and the Solana CLI.

pnpm add @heliuslabs/zolana @solana/kit

Source: sdk-libs/ts

Connect to Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Add a Helius API key:

.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: "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com",
  proverUrl: "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com:3001",
  allowInsecureHttp: true,
});

The examples use the Solana CLI wallet as the payer by default. The payer must hold devnet SOL. See How to Get Devnet SOL.

On localnet the SDK starts the local test validator (:8899), Photon indexer (:8784), and prover (:3001), and the client connects to them automatically without needing endpoint configuration.

cargo install --git https://github.com/helius-labs/zolana --tag v0.1.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 { Wallet } from "@heliuslabs/zolana";
import { decryptTransactions } from "@heliuslabs/zolana/transaction";

const wallet = new Wallet({
  identity: senderAddress,
  registry: assets,
});
await decryptTransactions({
  wallet,
  authority: {
    syncMaterial: () =>
      Promise.resolve({
        identity: senderAddress,
        viewingKeys: [senderKeypair.viewingKey()],
        nullifierKey: senderKeypair.nullifierKey(),
      }),
  },
  transactions: depositResponse.transactions,
});
const history = wallet.privateTransactions();

senderKeypair 提供发送者的查看密钥以进行本地解密。
decryptTransactions 解密匹配输出并将历史记录写入 Wallet。
wallet.privateTransactions() 阅读解密后的历史。
decryptToBalances 仅返回余额。

示例响应：

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

查看概念以了解所有者标记和私密 Solana 代币账户的工作方式。

完整代码示例

克隆并运行示例：

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

这些示例使用本地/devnet 上的机密环此处。

前提条件

The Rust examples require the latest stable Rust toolchain and the Solana CLI v4.0.2. See the Solana installation guide.

Cargo.toml

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

Source: sdk-libs/client

Connect to Endpoints

Devnet
Localnet

Add a Helius API key:

.env

API_KEY=YOUR_API_KEY
ZOLANA_PAYER_KEYPAIR=~/.config/solana/id.json

use solana_address::Address;
use zolana_client::{SolanaRpc, ZolanaClient};
use zolana_interface::DEFAULT_TREE_ADDRESS;

let tree: Address = DEFAULT_TREE_ADDRESS.parse()?;
let client = ZolanaClient::from_urls_allowing_insecure_http(
    SolanaRpc::new("https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
    "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com",
    "http://zolnet-devnet-1779374825.eu-north-1.elb.amazonaws.com:3001",
    tree,
);

The examples use the Solana CLI wallet as the payer by default. The payer must hold devnet SOL. See How to Get Devnet SOL.

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

use solana_address::Address;
use zolana_client::{SolanaRpc, ZolanaClient};
use zolana_interface::DEFAULT_TREE_ADDRESS;

let tree: Address = DEFAULT_TREE_ADDRESS.parse()?;
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",
    tree,
)?;

派生查看标签

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::{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 提供发送者的查看密钥以进行本地解密。
Wallet::sync 解密匹配输出并将历史记录写入 Wallet。
wallet.private_transactions() 阅读解密后的历史。
decrypt_transactions 仅返回余额。

示例响应：

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

完整代码示例

克隆并运行示例：

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

入门指南

数据流和事件监听

数据 API 和 RPC

交易

发送交易

钱包服务

隐私

指南

资源

读取私密历史记录

开始使用

前提条件

派生查看标签

从索引器获取交易输出

解密为私密历史

完整代码示例

前提条件

派生查看标签

从索引器获取交易输出

解密为私密历史

完整代码示例

相关指南

读取私密余额

存款

转账

取款

Didn’t find what you were looking for?

​开始使用

​前提条件

​派生查看标签

​从索引器获取交易输出

​解密为私密历史

​完整代码示例

​前提条件

​派生查看标签

​从索引器获取交易输出

​解密为私密历史

​完整代码示例

​相关指南

读取私密余额

存款

转账

取款

​Didn’t find what you were looking for?

开始使用

前提条件

派生查看标签

从索引器获取交易输出

解密为私密历史

完整代码示例

前提条件

派生查看标签

从索引器获取交易输出

解密为私密历史

完整代码示例

相关指南

Didn’t find what you were looking for?