Перейти к основному содержанию
POST
getEncryptedUtxosByTags

Зашифрованные выходы

Используйте этот метод, чтобы получить зашифрованные UTXO для расшифровки на стороне клиента. Ваш кошелек расшифровывает выходы и суммирует неизрасходованные суммы каждого актива, чтобы определить его приватный баланс. Этот метод аналогичен методу Solana getTokenAccountsByOwner, который возвращает аккаунты токенов SPL, принадлежащие определенному адресу. Приватный баланс хранится в UTXO, а не в аккаунтах Solana, поэтому для него требуется отдельный метод RPC. Подробнее см. в разделе «Приватное состояние и UTXO». Метод возвращает соответствующие выходы в result.data, сгруппированные по транзакциям Solana. Каждая запись содержит slot и signature транзакции. Выход содержит шифротекст, тег просмотра, коммитмент, идентификатор дерева и индекс листа. Ответ содержит исторические выходы, которые, возможно, уже были израсходованы. Ваш кошелек должен отслеживать нуллификаторы, чтобы определять доступный для расходования баланс. См. руководство по приватному балансу. Для пустого массива tags необходимо указать ringProgramId; в этом случае выбираются выходы из соответствующего кольца. Если указаны оба параметра, выходы должны соответствовать и тегам, и кольцу. Сведения об ограничениях страниц, токенах продолжения и инкрементальном чтении см. в разделе «Пагинация и актуальность».

Параметры запроса

object
Границы слотов. Чтобы возобновить синхронизированное чтение без верхнего ограничения, задайте для slot.gt значение context.slot с последней страницы.
object
Границы слотов для чтения. Указанные границы объединяются оператором AND.
number
Включать только транзакции после этого слота.
number
Включать только транзакции в этом слоте или после него.
number
Включать только транзакции до этого слота.
number
Включать только транзакции в этом слоте или до него.
number
по умолчанию:"1000"
Максимальное количество транзакций Solana на странице: от 1 до 1000.
number
Минимальный сохраненный слот индексатора, необходимый для этого чтения. Если индексатор отстает, возвращается ошибка JSON-RPC -32016.
string
Токен продолжения из предыдущего ответа. Передайте его без изменений с теми же тегами, кольцом и фильтрами слотов.
string
Ограничивает результаты кольцом, авторизованным этим идентификатором программы. Обязателен, если массив тегов пуст.
array
обязательно
32-байтовые теги просмотра в кодировке Base58. Не более 1000. Для пустого массива необходимо указать ringProgramId; в этом случае выбирается соответствующее кольцо.

Авторизации

api-key
string
query
обязательно

Ваш ключ API Helius.

Тело

application/json
id
string
по умолчанию:1
обязательно

Идентификатор запроса.

jsonrpc
enum<string>
по умолчанию:2.0
обязательно

Версия протокола JSON-RPC.

Доступные опции:
2.0
method
enum<string>
по умолчанию:getEncryptedUtxosByTags
обязательно

Вызываемый метод. Должен совпадать с последним сегментом пути URL.

Доступные опции:
getEncryptedUtxosByTags
params
object
обязательно
Пример:

Ответ

Ответ JSON-RPC. Проверьте error перед чтением result.

id
string
обязательно

Идентификатор запроса.

jsonrpc
enum<string>
обязательно

Версия протокола JSON-RPC.

Доступные опции:
2.0
error
object
result
object

Одна ограниченная страница чтения истории с пагинацией в стиле gTFA.