전용 RPC 메서드를 통해 인덱서에서 암호화된 개인 Solana 토큰 계정을 가져옵니다.
사용자 또는 사용자가 허가한 사람만 조회 키를 통해 잔액을 복호화할 수 있습니다.
개인 잔액 변경 후 및 전송 전에 사용하세요.

getBalance / getAccount과 비교

getBalance는 공개 SOL을 반환합니다. getAccount는 공개 토큰 계정을 반환합니다.
RPC는 공개 잔액을 반환합니다.

시작하기

TypeScript Client
Rust Client

요구 사항

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는 비공개 링 내에서 발신자의 Solana 공개 키로, 인덱서는 이를 사용하여 일치하는 암호화된 출력을 반환합니다.

인덱서에서 트랜잭션 출력 가져오기

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 잔액을 읽습니다.

소유자 태그 지정 및 개인 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는 비공개 링 내에서 발신자의 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::{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

시작하기

데이터 스트리밍 및 이벤트 리스닝

데이터 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?