Address Info Service
Обзор
Данный сервис предназначен для:
- Получения доступной в блокчейне информации по конкретному адресу об имеющихся на этом адресе активах и балансе этих активов.
- Получения списка транзакций по конкретному адресу.
Опционально данный сервис может использоваться для отправки доступных в блокчейне данных об активах на Asset info сервис. Этот функционал настраивается в конфигурационном файле приложения.
Основные понятия и термины
Ассеты
В рамках сервиса информация об активах представлена ассетами. Сервис поддерживает следующие виды ассетов:
- Коины (Coin) - основные криптовалюты блокчейнов, поддерживаемых сервисом;
- Токены ERC-20 (Erc20Token) - криптовалюты на основе Ethereum и Ethereum-подобных блокчейнов, определяемые адресом контракта.
- Ассеты Stellar (StellarAsset) - криптовалюты на основе блокчейна Stellar, определяемые адресом эмитента данного актива и кодом актива.
Подробное описание полей и примеры см. Раздел Модели данных: Asset.
Сумма актива
Информация о сумме актива в данных баланса и транзакций всегда содержит количественное значение во внутреннем целочисленном формате (amount
), а также разряд дробной части десятичной дроби (decimals
), необходимый для приведения целочисленных данных к внешнему формату с заданной точностью, наблюдаемому конечным пользователем.
Пример структуры суммы актива:
Подробное описание полей см. Раздел Документация api.
Балансы
Список балансов представляет собой набор данных по каждому доступному на адресе активу с указанием ассета (asset
) и суммы актива (balance
). Этот список всегда содержит как минимум одну запись баланса коина.
Пример структуры балансов с минимальным набором данных:
balances: [
{
asset: {
kind: 'coin',
chain: 'btc',
},
balance: { amount: '114492', decimals: 8 }
}
]
Подробное описание полей см. Раздел Документация api .
Транзакции и действия
Список транзакций представляет собой набор данных по всем доступным на адресе транзакциям с указанием:
- Идентификатор транзакции (
txid
) - Идентификатор блока (
block
) - Дата создания транзакции (
date
) - Комиссия в валюте коина (
fee
) - Сумма в валюте коина (
value
) - Адрес отправителя (
from
) - Адрес получателя (
to
) - Статус (
status
) - Список действий (
actions
) - набор данных по всем совершенным в рамках этой транзакции действиям с указанием обязательного поля ассет (asset) и другой специфичной в рамках этого типа информации, например:- Сумма актива (
value
), - Адрес отправителя (
from
), - Адрес получателя (
to
).
- Сумма актива (
Поддерживаемые сервисом типы действий и соответствующие им структуры данных описаны в разделе документации API.
Пример структуры транзакций с одной записью:
transactions: [
{
txid: '88ae5ffad07794cbb89680a2ee6f9014535b921417343ca5dec5f2fcc9ea162c',
block: '650924',
date: '1601644422',
fee: { amount: '35346', decimals: 8 },
value: { amount: '500149885', decimals: 8 },
from: '3jjpf13rd8g6wayvg8yipnrsdjjt1np4fc',
to: '1axsmsktfqvyhw977gsakff5s3jw8pbhf8',
status: 'confirmed',
actions: [
{
type: 'transfer',
asset: {
kind: 'coin',
chain: 'btc',
},
value: {
amount: '184000',
decimals: 8,
},
from: '3jjpf13rd8g6wayvg8yipnrsdjjt1np4fc',
to: '1axsmsktfqvyhw977gsakff5s3jw8pbhf8',
}
],
}
]
Подробное описание полей см. Раздел Документация api.