プライベート残高を読む

専用のRPCメソッドを使用して、インデクサから暗号化されたプライベートソラナトークンアカウントを取得します。
ユーザーまたはユーザーが許可した人のみが、視聴キーで残高を復号できます。
プライベート残高が変化した後と転送の前に使用します。

getBalance / getAccountと比較

getBalance は公開SOLを返します。 getAccount は公開トークンアカウントを返します。
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 { 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

例では、こちらのローカル/devnet 上の confidential 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_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

例では、こちらのローカル/devnet 上の confidential Ring を使用しています。

はじめに

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

データ API と RPC

取引

トランザクションの送信

Wallet-as-a-Service

プライバシー

リソース

プライベート残高を読む

始めに

前提条件

ビュータグを導出

インデクサからトランザクション出力をフェッチ

プライベート残高に復号

完全なコード例

前提条件

ビュータグを導出

インデクサからトランザクション出力をフェッチ

プライベート残高に復号

完全なコード例

関連ガイド

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

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

​始めに

​前提条件

​ビュータグを導出

​インデクサからトランザクション出力をフェッチ

​プライベート残高に復号

​完全なコード例

​前提条件

​ビュータグを導出

​インデクサからトランザクション出力をフェッチ

​プライベート残高に復号

​完全なコード例

​関連ガイド

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

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

始めに

前提条件

ビュータグを導出

インデクサからトランザクション出力をフェッチ

プライベート残高に復号

完全なコード例

前提条件

ビュータグを導出

インデクサからトランザクション出力をフェッチ

プライベート残高に復号

完全なコード例

関連ガイド

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