Перейти к содержанию

Address Info Service

Обзор

Данный сервис предназначен для:

  • Получения доступной в блокчейне информации по конкретному адресу об имеющихся на этом адресе активах и балансе этих активов.
  • Получения списка транзакций по конкретному адресу.

Опционально данный сервис может использоваться для отправки доступных в блокчейне данных об активах на Asset info сервис. Этот функционал настраивается в конфигурационном файле приложения.

Основные понятия и термины

Ассеты

В рамках сервиса информация об активах представлена ассетами. Сервис поддерживает следующие виды ассетов:

  • Коины (Coin) - основные криптовалюты блокчейнов, поддерживаемых сервисом;
  • Токены ERC-20 (Erc20Token) - криптовалюты на основе Ethereum и Ethereum-подобных блокчейнов, определяемые адресом контракта.
  • Ассеты Stellar (StellarAsset) - криптовалюты на основе блокчейна Stellar, определяемые адресом эмитента данного актива и кодом актива.

Подробное описание полей и примеры см. Раздел Модели данных: Asset.

Сумма актива

Информация о сумме актива в данных баланса и транзакций всегда содержит количественное значение во внутреннем целочисленном формате (amount), а также разряд дробной части десятичной дроби (decimals), необходимый для приведения целочисленных данных к внешнему формату с заданной точностью, наблюдаемому конечным пользователем.

Пример структуры суммы актива:

{ amount: '184000', decimals: 8 }

Подробное описание полей см. Раздел Документация api.

Балансы

Список балансов представляет собой набор данных по каждому доступному на адресе активу с указанием ассета (asset) и суммы актива (balance). Этот список всегда содержит как минимум одну запись баланса коина.

Пример структуры балансов с минимальным набором данных: 

balances: [
  {
    asset: {
      kind: 'coin',
      chain: 'btc',
    },
    balance: { amount: '114492', decimals: 8 }
  }
]

Подробное описание полей см. Раздел Документация api .

Транзакции и действия

Список транзакций представляет собой набор данных по всем доступным на адресе транзакциям с указанием:

  • Идентификатор транзакции (txid)
  • Идентификатор блока (block)
  • Дата создания транзакции (date)
  • Комиссия в валюте коина (fee)
  • Сумма в валюте коина (value)
  • Адрес отправителя (from)
  • Адрес получателя (to)
  • Статус (status)
  • Список действий (actions) - набор данных по всем совершенным в рамках этой транзакции действиям с указанием обязательных полей:
    • Тип действия (type), например, движение средств, создание аккаунта и др.,
    • Ассет (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.