비공개 기록 읽기

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

getSignaturesForAddress와 비교

getSignaturesForAddress는 공개 서명을 반환합니다.
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을 보유해야 합니다. 테스트넷 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 공개 키인 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, LocalShieldedKeys } from "@heliuslabs/zolana/transaction";

const wallet = new Wallet({
  identity: senderAddress,
  registry: assets,
});
await decryptTransactions({
  wallet,
  keys: LocalShieldedKeys.fromKeypair(sender),
  transactions: depositResponse.transactions,
});
const history = wallet.privateTransactions();

LocalShieldedKeys.fromKeypair(sender)는 로컬 복호화에 필요한 송신자의 키를 제공합니다.
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/read_history.ts

예제에서는 여기의 로컬/devnet에 있는 기밀 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 공개 키인 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_wallet::{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_spendable는 트랜잭션 내역이 아니라 데이터가 포함된 검증된 잔액과 UTXO를 반환합니다.

예시 응답:

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

예제에서는 여기의 로컬/devnet에 있는 기밀 Ring을 사용합니다.

시작하기

데이터 스트리밍 및 이벤트 수신

데이터 API 및 RPC

트레이딩

트랜잭션 전송

서비스형 지갑

개인정보 보호

리소스

비공개 기록 읽기

시작하기

전제 조건

보기 태그 파생

인덱서에서 거래 출력 가져오기

비공개 기록으로 해독

전체 코드 예제

전제 조건

보기 태그 파생

인덱서에서 거래 출력 가져오기

비공개 기록으로 해독

전체 코드 예제

관련 가이드

비공개 잔액 읽기

입금

전송

출금

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

​시작하기

​전제 조건

​보기 태그 파생

​인덱서에서 거래 출력 가져오기

​비공개 기록으로 해독

​전체 코드 예제

​전제 조건

​보기 태그 파생

​인덱서에서 거래 출력 가져오기

​비공개 기록으로 해독

​전체 코드 예제

​관련 가이드

비공개 잔액 읽기

입금

전송

출금

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

시작하기

전제 조건

보기 태그 파생

인덱서에서 거래 출력 가져오기

비공개 기록으로 해독

전체 코드 예제

전제 조건

보기 태그 파생

인덱서에서 거래 출력 가져오기

비공개 기록으로 해독

전체 코드 예제

관련 가이드

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