Чтение приватной истории

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

Compare to getSignaturesForAddress

getSignaturesForAddress возвращает общедоступные подписи.
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 { 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 см. в разделе Приватное состояние и UTXO.

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

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

git clone https://github.com/helius-labs/zolana-examples.git
cd zolana-examples/typescript-client
pnpm install
pnpm example examples/read_history.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_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, доступное здесь.

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

Read a Private Balance

Deposit

Transfer

Withdraw

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

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

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

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

API данных и RPC

Торговля

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

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

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

Ресурсы

Чтение приватной истории

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

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

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

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

Расшифровка приватной истории

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

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

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

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

Расшифровка приватной истории

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

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

Read a Private Balance

Deposit

Transfer

Withdraw

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

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

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

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

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

​Расшифровка приватной истории

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

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

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

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

​Расшифровка приватной истории

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

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

Read a Private Balance

Deposit

Transfer

Withdraw

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

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

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

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

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

Расшифровка приватной истории

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

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

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

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

Расшифровка приватной истории

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

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

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