Просмотр приватного баланса

Операция чтения получает зашифрованные приватные токен-аккаунты Solana из индексатора с помощью специальных методов RPC.
Только пользователь или тот, кого он уполномочил, может расшифровать балансы с помощью ключа просмотра.
Используйте эту операцию после изменения приватного баланса и перед переводом.

Compare to 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.4.0-alpha @solana/kit@^8.3.0

Источник: sdk-libs/ts

Connect to Endpoints

Devnet
Localnet

pnpm install
cp .env.example .env

Добавьте ключ API Helius:

.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",
});

По умолчанию в примерах в качестве плательщика используется кошелёк Solana CLI. На балансе плательщика должны быть SOL в devnet. См. Как получить SOL в devnet.

В localnet SDK запускает локальный тестовый валидатор (:8899), индексатор Photon (:8784) и средство доказательства (:3001), после чего клиент автоматически подключается к ним без необходимости настраивать конечные точки.

cargo install --git https://github.com/helius-labs/zolana --tag v0.4.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(), публичный ключ 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 см. в разделе Приватное состояние и UTXO.

Полный пример кода

Клонируйте и запустите пример:

git clone https://github.com/helius-labs/zolana-examples.git
cd zolana-examples/typescript-client
pnpm install
pnpm example examples/sync_balance.ts

В примерах используется конфиденциальное кольцо в локальной сети/devnet, доступное здесь.

Предварительные требования

Для примеров на 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.4.0-alpha", features = ["indexer-api", "solana-rpc"] }
zolana-interface = { git = "https://github.com/helius-labs/zolana", tag = "v0.4.0-alpha" }
zolana-program = { git = "https://github.com/helius-labs/zolana", tag = "v0.4.0-alpha" }
zolana-keypair = { git = "https://github.com/helius-labs/zolana", tag = "v0.4.0-alpha" }
zolana-transaction = { git = "https://github.com/helius-labs/zolana", tag = "v0.4.0-alpha" }
zolana-wallet = { git = "https://github.com/helius-labs/zolana", tag = "v0.4.0-alpha" }

Источник: sdk-libs/client

Connect to Endpoints

Devnet
Localnet

Добавьте API-ключ Helius:

.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 url = "https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY";
let client = ZolanaClient::from_urls(SolanaRpc::new(url), url, url)?;

По умолчанию в примерах в качестве плательщика используется кошелёк Solana CLI. На балансе плательщика должны быть SOL в сети devnet. См. Как получить SOL в сети devnet.

cargo install --git https://github.com/helius-labs/zolana --tag v0.4.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 — это sender_shielded_address.confidential_view_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, доступное здесь.

Связанные руководства

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

Не нашли то, что искали?

Свяжитесь с нами! Telegram | Электронная почта | Контакты

Начало работы

Потоковая передача данных и отслеживание событий

API данных и RPC

Торговля

Отправка транзакций

Кошелек как услуга

Конфиденциальность

Ресурсы

Просмотр приватного баланса

Начало работы

Предварительные требования

Получите тег просмотра

Получите выходы транзакций из индексатора

Расшифруйте приватный баланс

Полный пример кода

Предварительные требования

Получите тег просмотра

Получите выходы транзакций из индексатора

Расшифруйте приватный баланс

Полный пример кода

Связанные руководства

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

Не нашли то, что искали?

​Начало работы

​Предварительные требования

​Получите тег просмотра

​Получите выходы транзакций из индексатора

​Расшифруйте приватный баланс

​Полный пример кода

​Предварительные требования

​Получите тег просмотра

​Получите выходы транзакций из индексатора

​Расшифруйте приватный баланс

​Полный пример кода

​Связанные руководства

Create a Private Wallet

Deposit

Transfer

Withdraw

Read Private History

​Не нашли то, что искали?

Начало работы

Предварительные требования

Получите тег просмотра

Получите выходы транзакций из индексатора

Расшифруйте приватный баланс

Полный пример кода

Предварительные требования

Получите тег просмотра

Получите выходы транзакций из индексатора

Расшифруйте приватный баланс

Полный пример кода

Связанные руководства

Не нашли то, что искали?