전용 RPC 메서드를 사용하여 인덱서에서 암호화된 거래를 읽어옵니다.
사용자 또는 사용자가 권한을 부여한 사람만이 자신의 보기 키로 기록을 해독할 수 있습니다.
지갑이 백필을 수행하는 곳 어디에서든 사용: 지갑 잠금 해제 시, 비공개 지갑 열기 시, 앱 재개 시, 네트워크 재연결 시, 스트림 간격, 또는 지갑 복원 시.

getSignaturesForAddress와 비교

getSignaturesForAddress는 공개 서명을 반환합니다.
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는 비공개 링에 있는 발신자의 Solana 공개 키인 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 } from "@heliuslabs/zolana/transaction";

const wallet = new Wallet({
  identity: senderAddress,
  registry: assets,
});
await decryptTransactions({
  wallet,
  authority: {
    syncMaterial: () =>
      Promise.resolve({
        identity: senderAddress,
        viewingKeys: [senderKeypair.viewingKey()],
        nullifierKey: senderKeypair.nullifierKey(),
      }),
  },
  transactions: depositResponse.transactions,
});
const history = wallet.privateTransactions();

senderKeypair는 로컬 해독을 위해 발신자의 보기 키를 제공합니다.
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,
  },
]

소유자 태그 지정 및 비공개 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

예제는 여기에 있는 로컬/개발 네트워크의 비공개 링을 사용합니다.

전제 조건

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 공개 키인 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::{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_transactions는 잔액만 반환합니다.

예시 응답:

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