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

getBalance / getAccountと比較

getBalance は公開SOLを返します。 getAccount は公開トークンアカウントを返します。
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 { SOL_MINT } from "@heliuslabs/zolana";
import { decryptToBalances } from "@heliuslabs/zolana/transaction";

const balancesAfterDeposit =
  await decryptToBalances({
    keypair: senderKeypair,
    registry: assets,
    transactions: depositResponse.transactions,
  });
const depositBalance =
  balancesAfterDeposit.balance(SOL_MINT);

senderKeypair はローカルで復号するために送信者の視聴キーを提供します。
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/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() であり、送信者のソラナ公開鍵です。これはインデクサが一致する暗号化された出力を返すために使用します。

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

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_transactions, SOL_MINT};

let balances = decrypt_transactions(&sender, &response.transactions, &assets)
    .map_err(|e| anyhow!("decrypt sender transactions: {e:?}"))?;
let sender_balance = balances.get_balance(SOL_MINT);

sender はローカルで復号するために送信者の視聴キーを提供します。
decrypt_transactions は一致する出力を復号し、送信者のプライベート残高を返します。
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 deposit_transfer_withdraw

例はローカル/devnetでの機密リングを使用しています。詳しくはここを参照してください。

はじめに

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

データ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?