プライベート履歴を読む

Read は専用のRPCメソッドを使用してインデクサーから暗号化されたトランザクションを取得します。
ユーザーまたはユーザーが許可した人のみが、自分の閲覧キーを使用して履歴を復号化できます。
ウォレットのバックフィルが実行される場所で使用してください：ウォレットの解除、プライベートウォレットのオープン、アプリの再開、ネットワークの再接続、ストリームのギャップ、またはウォレットの復元時など。

getSignaturesForAddressとの比較

getSignaturesForAddress は公開署名を返します。
RPCは公開履歴を返します。

はじめに

TypeScript クライアント
Rust クライアント

前提条件

TypeScript の例には Node.js 24 以降、pnpm 11.18.0、および Solana CLI が必要です。

pnpm add @heliuslabs/zolana@^0.3.1-alpha @solana/kit@^8.3.0

出典: sdk-libs/ts

エンドポイントに接続

Devnet
Localnet

pnpm install
cp .env.example .env

Helius APIキーを追加します:

.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",
});

例ではデフォルトで支払者としてSolana CLIウォレットを使用します。支払者はdevnet SOLを保有している必要があります。Devnet SOLの取得方法を参照してください。

localnetでは、SDKがローカルテストバリデーター（: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() で、送信者のソラナ公開鍵です。インデクサーはこれを使用して一致する暗号化出力を返します。

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

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, 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) は、ローカルでの復号に使用する送信者のキーを提供します。
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/read_history.ts

例では、こちらの local/devnet 上にある機密 Ring を使用します。

前提条件

Rust の例を実行するには、Rust 1.98.1 と Solana CLI v4.0.2 が必要です。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" }

ソース: sdk-libs/client

エンドポイントに接続

Devnet
Localnet

Helius API キーを追加してください。

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

例では、Solana CLI ウォレットをデフォルトの支払者として使用しています。支払者は devnet SOL を保持している必要があります。Devnet SOL の取得方法を参照してください。

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

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

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_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 は、ローカルでの復号に使用する送信者の閲覧キーを提供します。
Wallet::sync は、一致する出力を復号し、履歴を Wallet に書き込みます。
wallet.private_transactions() は、復号された履歴を読み取ります。
decrypt_spendable は、データを含む検証済みの残高と UTXO を返しますが、トランザクション履歴は返しません。

例の応答：

[
    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 read_history

例では、こちらの local/devnet 上にある機密 Ring を使用します。

はじめに

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

データ API と RPC

取引

トランザクションの送信

Wallet-as-a-Service

プライバシー

リソース

プライベート履歴を読む

はじめに

前提条件

ビュータグを導出する

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

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

完全なコード例

前提条件

ビュータグを導出する

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

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

完全なコード例

関連ガイド

プライベート残高を読む

入金

送金

出金

お探しの情報が見つかりませんでしたか？

​はじめに

​前提条件

​ビュータグを導出する

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

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

​完全なコード例

​前提条件

​ビュータグを導出する

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

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

​完全なコード例

​関連ガイド

プライベート残高を読む

入金

送金

出金

​お探しの情報が見つかりませんでしたか？

はじめに

前提条件

ビュータグを導出する

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

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

完全なコード例

前提条件

ビュータグを導出する

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

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

完全なコード例

関連ガイド

お探しの情報が見つかりませんでしたか？