개인 잔액 읽기

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

getBalance / getAccount과 비교

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

시작하기

TypeScript Client
Rust Client

요구 사항

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을 보유해야 합니다. 테스트넷 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는 비공개 링 내에서 발신자의 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: sender,
    registry: assets,
    transactions: depositResponse.transactions,
  });
const depositBalance =
  balancesAfterDeposit.balance(SOL_MINT);

sender는 로컬 복호화를 위해 발신자의 보기 키를 제공합니다.
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/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는 비공개 링 내에서 발신자의 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_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

트레이딩

트랜잭션 전송

서비스형 지갑

개인정보 보호

리소스

시작하기

요구 사항

조회 태그 유도

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

개인 잔액 복호화

전체 코드 예제

요구 사항

조회 태그 유도

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

개인 잔액 복호화

전체 코드 예제

관련 가이드

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

원하는 정보를 찾지 못하셨나요?

​시작하기

​요구 사항

​조회 태그 유도

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

​개인 잔액 복호화

​전체 코드 예제

​요구 사항

​조회 태그 유도

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

​개인 잔액 복호화

​전체 코드 예제

​관련 가이드

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​원하는 정보를 찾지 못하셨나요?

시작하기

요구 사항

조회 태그 유도

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

개인 잔액 복호화

전체 코드 예제

요구 사항

조회 태그 유도

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

개인 잔액 복호화

전체 코드 예제

관련 가이드

원하는 정보를 찾지 못하셨나요?