Установка и использование платформы

REST API: информация о блоках сети

https://img.shields.io/badge/auth-required-orange.svg

Для получения информации о различных блоках сети предусмотрена группа методов blocks.

Примечание

Те же данные, что и с помощью REST методов группы blocks можно получить с помощью gRPC метода SubscribeOn.

GET /blocks/height

Метод возвращает номер текущего блока в блокчейне (высоту блокчейна).

Пример ответа:

GET /blocks/height:
{
  "height": 7788
}

GET /blocks/height/{signature}

Метод возвращает высоту блока по его подписи {signature}.

Ответ метода содержит поле height, как и метод GET /blocks/height.

GET /blocks/first

Метод возвращает информацию о генезис-блоке сети.

В ответе содержатся следующие параметры:

  • reference – хэш-сумма генезис-блока;

  • blocksize – размер генезис-блока;

  • signature – подпись генезис-блока;

  • fee – комиссия за транзакции, включенные в генезис-блок;

  • generator – адрес создателя генезис-блока;

  • transactionCount – количество транзакций 1 и 101, включенных в генезис-блок;

  • transactions – массив с телами транзакций 1 и 101, включенных в генезис-блок;

  • version – версия генезис-блока;

  • timestamp – временная метка создания генезис-блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания генезис-блока (1).

Пример ответа:

GET /blocks/first:
{
    "reference": "67rpwLCuS5DGA8KGZXKsVQ7dnPb9goRLoKfgGbLfQg9WoLUgNY77E2jT11fem3coV9nAkguBACzrU1iyZM4B8roQ",
    "blocksize": 1435,
    "signature": "4HENriUyMthzMSqWa5sYPFMATbzpQugTBMk6mXUh5HmnvHfUhmQk6EqmdhGvNFcUvTDrsyiVqkxtm8iiV2xNTSNK",
    "fee": 0,
    "generator": "3MvQKx98a713B28rdUAtbWJ8DFJEXhnTjKs",
    "transactionCount": 26,
    "transactions": [
      {
        "type": 1,
        "id": "2AdCY254MFSrgxpr6otBisV5Zz7neH8YoM6VGW5egoVJnwD8cJpYZVR42aVKTZnwGT9ee7LCpAGMNSUV86FEAGXu",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "2AdCY254MFSrgxpr6otBisV5Zz7neH8YoM6VGW5egoVJnwD8cJpYZVR42aVKTZnwGT9ee7LCpAGMNSUV86FEAGXu",
        "recipient": "3MufokZsFzaf7heTV1yreUtm1uoJXPoFzdP",
        "amount": 1250000000000000
      },
      {
        "type": 1,
        "id": "5VC2LoFTbrfLkd48bjQkp8CmTyqXJSkJh723qxo9v5pz38tBUjRW9tHLuvwajSvkzQNFxrCc6Yjkgx5R2YR3x5VC",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "5VC2LoFTbrfLkd48bjQkp8CmTyqXJSkJh723qxo9v5pz38tBUjRW9tHLuvwajSvkzQNFxrCc6Yjkgx5R2YR3x5VC",
        "recipient": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
        "amount": 300000000000000
      },
      {
        "type": 1,
        "id": "4cmwEkSnBLc3TBTPUiT7HwmdER25X7GzCj2mgiEJ8K149vnNa1orBZUNstwNXtXFyKcQbkRPym39d9wJXTE4wgbU",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "4cmwEkSnBLc3TBTPUiT7HwmdER25X7GzCj2mgiEJ8K149vnNa1orBZUNstwNXtXFyKcQbkRPym39d9wJXTE4wgbU",
        "recipient": "3N9nNFySk1zVSVf9DUWR9DiBA1jEmmDDpaJ",
        "amount": 100000000000000
      },
      {
        "type": 1,
        "id": "5Etq3o1eWoN3bqR9cYV6149qxAE3ru4CoSCf1Mm5sSJEedcbmLhsbfg8rh4S6ESrAPq7ZEbghEgHjyb3xzUbDDRh",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "5Etq3o1eWoN3bqR9cYV6149qxAE3ru4CoSCf1Mm5sSJEedcbmLhsbfg8rh4S6ESrAPq7ZEbghEgHjyb3xzUbDDRh",
        "recipient": "3N3jgxvmSsBBV4oz9BcKhT8War1em2sKoJn",
        "amount": 1000000000000000
      },
      {
        "type": 110,
        "id": "3HewQJtzuaumzX4TvmN7fxVCgnsWTTaLeQjYBVDDuYoEW2ijWd7JME8h1gtsqepv5SDhHPvoMesVNm96br8WRgF8",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "3HewQJtzuaumzX4TvmN7fxVCgnsWTTaLeQjYBVDDuYoEW2ijWd7JME8h1gtsqepv5SDhHPvoMesVNm96br8WRgF8",
        "targetPublicKey": "56rV5kcR9SBsxQ9LtNrmp6V72S4BDkZUJaA6ujZswDneDmCTmeSG6UE2FQP1rPXdfpWQNunRw4aijGXxoK3o4puj",
        "target": "3MufokZsFzaf7heTV1yreUtm1uoJXPoFzdP"
      },
      {
        "type": 101,
        "id": "5r4uLWn3rwmqbBygNj29iR4YsiV82dYWFeCbepAHhKGXqnn27vE6i811U9H2UZgX8zNQYZciyw3PR6nAdwjSPSp5",
        "fee": 0,
        "timestamp": 1606211535609,
        "signature": "5r4uLWn3rwmqbBygNj29iR4YsiV82dYWFeCbepAHhKGXqnn27vE6i811U9H2UZgX8zNQYZciyw3PR6nAdwjSPSp5",
        "target": "3MufokZsFzaf7heTV1yreUtm1uoJXPoFzdP",
        "role": "permissioner"
      },
      {
        "type": 101,
        "id": "4pBwjviNLtSPEBY5YB7ZdUXVSFnEk4rgscW8r9QQKxdxQZzjwjdq1ZnruMxQo7tomQVJf1Ni6SyVxSHrQZhBJaFN",
        "fee": 0,
        "timestamp": 1606211535608,
        "signature": "4pBwjviNLtSPEBY5YB7ZdUXVSFnEk4rgscW8r9QQKxdxQZzjwjdq1ZnruMxQo7tomQVJf1Ni6SyVxSHrQZhBJaFN",
        "target": "3MufokZsFzaf7heTV1yreUtm1uoJXPoFzdP",
        "role": "miner"
      },
      {
        "type": 101,
        "id": "5kwQwLH8oTy1ztF6xxsBxE3MDGio1NJm8F7Mtpynf3QTw9CWCsp5Fio5SxLmPxnB1bUVQHMCHbQCD4wXJLJgjSrp",
        "fee": 0,
        "timestamp": 1606211535607,
        "signature": "5kwQwLH8oTy1ztF6xxsBxE3MDGio1NJm8F7Mtpynf3QTw9CWCsp5Fio5SxLmPxnB1bUVQHMCHbQCD4wXJLJgjSrp",
        "target": "3MufokZsFzaf7heTV1yreUtm1uoJXPoFzdP",
        "role": "connection_manager"
      },
      {
        "type": 101,
        "id": "62xS2qkR7chFMSdryTjwB15BKd4CH5Hwn9PbzasZo1Qx6Bwg82nixMPKRQobDy3JW7cLmzMHi97hJk1JSDqhwUgM",
        "fee": 0,
        "timestamp": 1606211535606,
        "signature": "62xS2qkR7chFMSdryTjwB15BKd4CH5Hwn9PbzasZo1Qx6Bwg82nixMPKRQobDy3JW7cLmzMHi97hJk1JSDqhwUgM",
        "target": "3MufokZsFzaf7heTV1yreUtm1uoJXPoFzdP",
        "role": "contract_developer"
      },
      {
        "type": 101,
        "id": "2sNwzGbwDL2Es53P8XY5wA9T9wwu3eXJbJUrtXJ9wg49urPjuBejWbidat2z3yZ8JrTpkWWFEsrerCtnC38XuRTJ",
        "fee": 0,
        "timestamp": 1606211535605,
        "signature": "2sNwzGbwDL2Es53P8XY5wA9T9wwu3eXJbJUrtXJ9wg49urPjuBejWbidat2z3yZ8JrTpkWWFEsrerCtnC38XuRTJ",
        "target": "3MufokZsFzaf7heTV1yreUtm1uoJXPoFzdP",
        "role": "issuer"
      },
      {
        "type": 110,
        "id": "4hLep3GngPEBH2xEmuUZ323muT8BstFdT552e42z6ZXCKGnF1PABGGjEiCkHfr6hMuyvRJ7axD9qoGeWQCU5yaCk",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "4hLep3GngPEBH2xEmuUZ323muT8BstFdT552e42z6ZXCKGnF1PABGGjEiCkHfr6hMuyvRJ7axD9qoGeWQCU5yaCk",
        "targetPublicKey": "5nGi8XoiGjjyjbPmjLNy1k2bus4yXLaeuA3Hb7BikwD9tboFwFXJYUmto5Joox76c3pp2Mr1LjgodUJuxryCJofQ",
        "target": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c"
      },
      {
        "type": 101,
        "id": "nj9Xfqm3pPLmuLsWfDZx4htKaNKAyvhen7tF95T9YwdmK1pqkiCjtaV9AxCwzEceViyo5rHPapigxPyCZdBWvRn",
        "fee": 0,
        "timestamp": 1606211535604,
        "signature": "nj9Xfqm3pPLmuLsWfDZx4htKaNKAyvhen7tF95T9YwdmK1pqkiCjtaV9AxCwzEceViyo5rHPapigxPyCZdBWvRn",
        "target": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
        "role": "permissioner"
      },
      {
        "type": 101,
        "id": "24AmxdGyH3afYRxPXn5zqvU1Fro1MwVQPDqwkdjCKLddSEiKVhyeMHTAVrRpHu83ZDPMyQkf3ty161PrujmGYtef",
        "fee": 0,
        "timestamp": 1606211535603,
        "signature": "24AmxdGyH3afYRxPXn5zqvU1Fro1MwVQPDqwkdjCKLddSEiKVhyeMHTAVrRpHu83ZDPMyQkf3ty161PrujmGYtef",
        "target": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
        "role": "miner"
      },
      {
        "type": 101,
        "id": "4xsEQoh6Z4wDW6jT9UP3SqA1Yv5trbaGfF4uHajWxayBU8hrw2ZAYmtAWwDFytTdc6yqDepj6GwzxZuFYTq6638v",
        "fee": 0,
        "timestamp": 1606211535602,
        "signature": "4xsEQoh6Z4wDW6jT9UP3SqA1Yv5trbaGfF4uHajWxayBU8hrw2ZAYmtAWwDFytTdc6yqDepj6GwzxZuFYTq6638v",
        "target": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
        "role": "connection_manager"
      },
      {
        "type": 101,
        "id": "FSNaHMC11W3VskpGYfgxt3fqAMvt6gUmgy61CX8mm93QykuRp2E9Z8BtQc8w22Awc6W8CpXGJn6VcpkcBdAx4Tj",
        "fee": 0,
        "timestamp": 1606211535601,
        "signature": "FSNaHMC11W3VskpGYfgxt3fqAMvt6gUmgy61CX8mm93QykuRp2E9Z8BtQc8w22Awc6W8CpXGJn6VcpkcBdAx4Tj",
        "target": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
        "role": "contract_developer"
      },
      {
        "type": 101,
        "id": "4rfDMTGjbHENy3uiACLmfAHFJWyouhridZHGpynfV8S6aX3XmZHjUSfCvadn3KSzb8eHRq1kmzEaLMxvbqWkUKBY",
        "fee": 0,
        "timestamp": 1606211535600,
        "signature": "4rfDMTGjbHENy3uiACLmfAHFJWyouhridZHGpynfV8S6aX3XmZHjUSfCvadn3KSzb8eHRq1kmzEaLMxvbqWkUKBY",
        "target": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
        "role": "issuer"
      },
      {
        "type": 110,
        "id": "4q5iXHv8jZ1qw5FptfBCz1cic14u1M4zCzE1i5qqEA4z6TQmeVFaqhZRpepFpdyGiSyKH4s6XqKPTgxuEJ8Sp4QQ",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "4q5iXHv8jZ1qw5FptfBCz1cic14u1M4zCzE1i5qqEA4z6TQmeVFaqhZRpepFpdyGiSyKH4s6XqKPTgxuEJ8Sp4QQ",
        "targetPublicKey": "25GXtqKBAHTCrHuDoXvwQGXnHKBdeVcjdLvSmQ7SVFq4FDoMWzV78oRkgoS32AFDQ23DvfGFX6QpRkQRShQ4zMJy",
        "target": "3N9nNFySk1zVSVf9DUWR9DiBA1jEmmDDpaJ"
      },
      {
        "type": 101,
        "id": "2gjzK3qSp89ywXCjEpvCHKSeyqoBYR2XCKegZ1ngGrQF8cDGXjA19HN8eYTgw8DRoXy62MM138EXXiZyV7oCaZrt",
        "fee": 0,
        "timestamp": 1606211535599,
        "signature": "2gjzK3qSp89ywXCjEpvCHKSeyqoBYR2XCKegZ1ngGrQF8cDGXjA19HN8eYTgw8DRoXy62MM138EXXiZyV7oCaZrt",
        "target": "3N9nNFySk1zVSVf9DUWR9DiBA1jEmmDDpaJ",
        "role": "permissioner"
      },
      {
        "type": 101,
        "id": "3zq1bCbeiNt4Z35rVtKwPo2MnW8peEcx2fQtgMseiJSb3TN7TKfU9auLEWKAgRXoNjpbpi9XA4aJw8Ly4gcpEaTv",
        "fee": 0,
        "timestamp": 1606211535598,
        "signature": "3zq1bCbeiNt4Z35rVtKwPo2MnW8peEcx2fQtgMseiJSb3TN7TKfU9auLEWKAgRXoNjpbpi9XA4aJw8Ly4gcpEaTv",
        "target": "3N9nNFySk1zVSVf9DUWR9DiBA1jEmmDDpaJ",
        "role": "miner"
      },
      {
        "type": 101,
        "id": "Aikgzt9ChSDfK4foF9oQJ8qRjV5cRyqF9okU9gr9JdpXh2LpyVB7GW4XSjmyc4MK9btPh3xd2whFDoCr8J5F4Hs",
        "fee": 0,
        "timestamp": 1606211535597,
        "signature": "Aikgzt9ChSDfK4foF9oQJ8qRjV5cRyqF9okU9gr9JdpXh2LpyVB7GW4XSjmyc4MK9btPh3xd2whFDoCr8J5F4Hs",
        "target": "3N9nNFySk1zVSVf9DUWR9DiBA1jEmmDDpaJ",
        "role": "connection_manager"
      },
      {
        "type": 101,
        "id": "48EGdWC133vQeydqMSXjmXJKB6L2brnu8Sh5W8r4anKCaUQZp5iKGrpVUAwsiUHfHrMXGA52roeoqo7abUHQbbVw",
        "fee": 0,
        "timestamp": 1606211535596,
        "signature": "48EGdWC133vQeydqMSXjmXJKB6L2brnu8Sh5W8r4anKCaUQZp5iKGrpVUAwsiUHfHrMXGA52roeoqo7abUHQbbVw",
        "target": "3N9nNFySk1zVSVf9DUWR9DiBA1jEmmDDpaJ",
        "role": "contract_developer"
      },
      {
        "type": 101,
        "id": "FwNbJyr2Est9DFi5uch1ZfkQjDg13asqSsAdm37381aMWMrdaxcjqXMpKus1rxDcxZd5YnD4MNkz1ZpPgZ8nupn",
        "fee": 0,
        "timestamp": 1606211535595,
        "signature": "FwNbJyr2Est9DFi5uch1ZfkQjDg13asqSsAdm37381aMWMrdaxcjqXMpKus1rxDcxZd5YnD4MNkz1ZpPgZ8nupn",
        "target": "3N9nNFySk1zVSVf9DUWR9DiBA1jEmmDDpaJ",
        "role": "issuer"
      },
      {
        "type": 110,
        "id": "ps5vGHxv4DfTFnTXsqeS22hXQQm8uBf1mwnc7gtDvGxGGfEhDq8DvnCjtKukYmuEW6adz5NQGLbaqbMJK7ChYdA",
        "fee": 0,
        "timestamp": 1606211535610,
        "signature": "ps5vGHxv4DfTFnTXsqeS22hXQQm8uBf1mwnc7gtDvGxGGfEhDq8DvnCjtKukYmuEW6adz5NQGLbaqbMJK7ChYdA",
        "targetPublicKey": "5fbBNmkW9LJBUFNJW6vsjnmBzGf2AMwdqgHNvne2iYPMNW2wtDJGmF4PGnqyzTYJyYN3kWNWd4cFf9xBZ8Qi9Hki",
        "target": "3N3jgxvmSsBBV4oz9BcKhT8War1em2sKoJn"
      },
      {
        "type": 101,
        "id": "5BG3AhFnGbDcSDJ88KmXViU2tCxs4VNhXGjgocn2ZCcvCjTbxGjso4DKPkcajUNJBhPZHqgMmEKugVxqBMjNf2YY",
        "fee": 0,
        "timestamp": 1606211535594,
        "signature": "5BG3AhFnGbDcSDJ88KmXViU2tCxs4VNhXGjgocn2ZCcvCjTbxGjso4DKPkcajUNJBhPZHqgMmEKugVxqBMjNf2YY",
        "target": "3N3jgxvmSsBBV4oz9BcKhT8War1em2sKoJn",
        "role": "permissioner"
      },
      {
        "type": 101,
        "id": "HYoFXRgsyHGTa9JTnCDpJtBu6hr61LTYTA2zGPkUAVaTn6mhHfSKoVJbn91DN2gtqZxNreQnrV4GGnMR4cFikAE",
        "fee": 0,
        "timestamp": 1606211535593,
        "signature": "HYoFXRgsyHGTa9JTnCDpJtBu6hr61LTYTA2zGPkUAVaTn6mhHfSKoVJbn91DN2gtqZxNreQnrV4GGnMR4cFikAE",
        "target": "3N3jgxvmSsBBV4oz9BcKhT8War1em2sKoJn",
        "role": "contract_developer"
      },
      {
        "type": 101,
        "id": "4snBMYD3dDw9pivJM2YFSJBPPtK4K43YGL8Qjw4APadgZCtqsR4yoo3CZC4bgf5ZffwVWQQzVmfSjxpzsiwCjNju",
        "fee": 0,
        "timestamp": 1606211535592,
        "signature": "4snBMYD3dDw9pivJM2YFSJBPPtK4K43YGL8Qjw4APadgZCtqsR4yoo3CZC4bgf5ZffwVWQQzVmfSjxpzsiwCjNju",
        "target": "3N3jgxvmSsBBV4oz9BcKhT8War1em2sKoJn",
        "role": "issuer"
      }
    ],
    "version": 1,
    "poa-consensus": {
      "overall-skipped-rounds": 0
    },
    "timestamp": 1606211535610,
    "height": 1
  }

GET /blocks/last

Метод возвращает содержимое текущего блока блокчейна.

Текущий блок находится в процессе создания, пока он не будет принят нодами-майнерами, количество транзакций в нем может меняться.

В ответе метода возвращаются следующие параметры:

  • reference – хэш-сумма блока;

  • blocksize – размер блока;

  • featuresфункциональные возможности, запущенные на момент создания блока;

  • signature – подпись блока;

  • fee – комиссия за транзакции, включенные в блок;

  • generator – адрес создателя блока;

  • transactionCount – количество транзакций 1 и 101, включенных в блок;

  • transactions – массив с телами транзакций, включенных в блок;

  • version – версия блока;

  • poa-consensus.overall-skipped-rounds – количество пропущенных раундов майнинга, при использовании алгоритма консенсуса PoA;

  • timestamp – временная метка создания блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания блока.

Пример ответа для пустого текущего блока:

GET /blocks/last:
{
  "reference": "hT5RcPT4jDVoNspfZkNhKqfGuMbrizjpG4vmPecVfWgWaGMoAn5hgPBJpC9696TL8wGDKJzkwewiqe8m26C4aPd",
  "blocksize": 226,
  "features": [],
  "signature": "5GAM7jfQScw4g3g7PCNNtz5xG3JzjJnW4Ap2soThirSx1AmUQHQMjz8VMtkFEzK7L447ouKHfj2gMvZyP5u94Rps",
  "fee": 0,
  "generator": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
  "transactionCount": 0,
  "transactions": [],
  "version": 3,
  "poa-consensus": {
    "overall-skipped-rounds": 1065423
  },
  "timestamp": 1615816767694,
  "height": 1826
}

GET /blocks/at/{height}

Метод возвращает содержимое блока на высоте height.

В ответе метода возвращаются следующие параметры:

  • reference – хэш-сумма блока;

  • blocksize – размер блока;

  • featuresфункциональные возможности, запущенные на момент создания блока;

  • signature – подпись блока;

  • fee – комиссия за транзакции, включенные в блок;

  • generator – адрес создателя блока;

  • transactionCount – количество транзакций, включенных в блок;

  • transactions – массив с телами транзакций, включенных в блок;

  • version – версия блока;

  • poa-consensus.overall-skipped-rounds – количество пропущенных раундов майнинга, при использовании алгоритма консенсуса PoA;

  • timestamp – временная метка создания блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания блока.

Пример ответа:

GET /blocks/at/{height}:
{
  "reference": "hT5RcPT4jDVoNspfZkNhKqfGuMbrizjpG4vmPecVfWgWaGMoAn5hgPBJpC9696TL8wGDKJzkwewiqe8m26C4aPd",
  "blocksize": 226,
  "features": [],
  "signature": "5GAM7jfQScw4g3g7PCNNtz5xG3JzjJnW4Ap2soThirSx1AmUQHQMjz8VMtkFEzK7L447ouKHfj2gMvZyP5u94Rps",
  "fee": 0,
  "generator": "3Mv79dyPX2cvLtRXn1MDDWiCZMBrkw9d97c",
  "transactionCount": 0,
  "transactions": [],
  "version": 3,
  "poa-consensus": {
    "overall-skipped-rounds": 1065423
  },
  "timestamp": 1615816767694,
  "height": 1826
}

GET /blocks/seq/{from}/{to}

Метод возвращает содержимое блоков от высоты {from} до высоты {to}.

Для каждого блока возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/seqext/{from}/{to}

Метод возвращает содержимое блоков с расширенной информацией о транзакциях от высоты {from} до высоты {to}.

В остальном, для каждого блока возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/signature/{signature}

Метод возвращает содержимое блока по его подписи {signature}.

В ответе метода возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/address/{address}/{from}/{to}

Метод возвращает содержимое всех блоков, сформированных адресатом {address} от высоты {from} до высоты {to}.

В ответе метода для каждого блока возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/child/{signature}

Метод возвращает унаследованный блок от блока с подписью {signature}.

В ответе метода возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/headers/at/{height}

Метод возвращает заголовок блока на высоте {height}.

В ответе метода возвращаются следующие параметры:

  • reference – хэш-сумма блока;

  • blocksize – размер блока;

  • featuresфункциональные возможности, запущенные на момент создания блока;

  • signature – подпись блока;

  • fee – комиссия за транзакции, включенные в блок;

  • generator – адрес создателя блока;

  • pos-consensus.base-target – коэффициент, регулирующий время выпуска блока, при использовании алгоритма консенсуса PoS;

  • pos-consensus.generation-signature – подпись, необходимая для валидации майнера блока;

  • poa-consensus.overall-skipped-rounds – количество пропущенных раундов майнинга, при использовании алгоритма консенсуса PoA;

  • version – версия блока;

  • timestamp – временная метка создания блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания блока.

Пример ответа:

GET /blocks/at/{height}:
{
  "reference": "5qWJh9aQ2hkwnBWygGYmrBhzMe5inRZ2r6WhEXz3VJsiMtASWkvbsVeZGychZKzcPDbWmpzdhQwNQJ19PfK2dst9",
  "blocksize": 589,
  "features": [
    0
  ],
  "signature": "4U4Hmg4mDYrvxaZ3JVzL1Z1piPDZ1PJ61vd1PeS7ESZFkHsUCUqeeAZoszTVr43Z4NV44dqbLv9WdrLytDL6gHuv",
  "fee": 5000000,
  "generator": "3NkZd8Xd4KsuPiNVsuphRNCZE3SqJycqv8d",
  "pos-consensus": {
    "base-target": 249912231,
    "generation-signature": "LM83w6eWQHnLJF2D9RQNdNcHAdnZLCLWrn5bfcoqcZy"
  },
  "poa-consensus": {
    "overall-skipped-rounds": 2
  },
  "transactionCount": 2,
  "version": 12,
  "timestamp": 1568287320962,
  "height": 48260
}

GET /blocks/headers/seq/{from}/{to}

Метод возвращает заголовки блоков с высоты {from} до высоты {to}.

В ответе метода для каждого блока возвращаются параметры, идентичные методу GET /blocks/headers/at/{height}.

GET /blocks/headers/last

Метод возвращает заголовок текущего блока.

В ответе метода для каждого блока возвращаются параметры, идентичные методу GET /blocks/headers/at/{height}.

Смотрите также