Read は専用の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() で、送信者のソラナ公開鍵です。インデクサーはこれを使用して一致する暗号化出力を返します。

インデクサーからトランザクションの出力を取得する

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

所有者のタグ付けやプライベートソラナトークンアカウントの作業方法については、コンセプトをご覧ください。

完全なコード例

例をクローンして実行します：

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

例はローカル/デブネット上の機密Ringを使用していますここ。

前提条件

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() で、送信者のソラナ公開鍵です。インデクサーはこれを使用して一致する暗号化出力を返します。

インデクサーからトランザクションの出力を取得する

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

例はローカル/デブネット上の機密Ringを使用していますここ。

はじめに

データストリーミングとイベントリスニング

データAPIとRPC

トレーディング

トランザクション送信

Wallet-as-a-Service

プライバシー

ガイド

リソース

プライベート履歴を読む

始めましょう

前提条件

ビュータグを導出する

インデクサーからトランザクションの出力を取得する

プライベート履歴に復号化する

完全なコード例

前提条件

ビュータグを導出する

インデクサーからトランザクションの出力を取得する

プライベート履歴に復号化する

完全なコード例

関連ガイド

プライベート残高を読む

入金

送金

出金

Didn’t find what you were looking for?

​始めましょう

​前提条件

​ビュータグを導出する

​インデクサーからトランザクションの出力を取得する

​プライベート履歴に復号化する

​完全なコード例

​前提条件

​ビュータグを導出する

​インデクサーからトランザクションの出力を取得する

​プライベート履歴に復号化する

​完全なコード例

​関連ガイド

プライベート残高を読む

入金

送金

出金

​Didn’t find what you were looking for?

始めましょう

前提条件

ビュータグを導出する

インデクサーからトランザクションの出力を取得する

プライベート履歴に復号化する

完全なコード例

前提条件

ビュータグを導出する

インデクサーからトランザクションの出力を取得する

プライベート履歴に復号化する

完全なコード例

関連ガイド

Didn’t find what you were looking for?