Block and Transaction API

Blocks and transactions

get_block_header(block_num)

Retrieve a block header.

Parameters

Option

Description

uint32_t block_num

height of the block whose header should be returned

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_block_header",
[
"75"
]
]
}

Returns

Header of the referenced block, or null if no matching block was found.

{
"id": 4,
"jsonrpc": "2.0",
"result": {
"previous": "0000004abf11056270d24459abe3a58516d99cee",
"round": 75,
"attempt": 2,
"timestamp": "2019-11-26T13:54:37",
"account": "1.2.11",
"delegate": "1.2.0",
"transaction_merkle_root": "4346203bfbd5139e1ee6167b1ad79cb6be752934",
"vm_root": [
"002b44168e591a0a984350ca8f56776a98c3b6b64351cd0bbef52cf8615d990cece9f0bcd9205c170ed67dbabad0b643482e0ea87650abeb172a47656b53bc53",
"0.9a71ff66a2f503e4e96c4e9a2521d6a710f2d373b422332029da170d78fa1a68"
],
"prev_signatures": [
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 9,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "c2c1d7e758306154ab5038c97f20e0c034c51be35e084fef0361299a641a258021dbf6ddba764ce33532c51e1d1a9df19bba90ed5b5e5d0731fffdc5892f9c01"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 8,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "81105a4baa83e5f2d90703b5fa644fa9284134352401e947aa97c30f8d1ae9fc22add66d0c911ee927f032a3bfb56ff6c93ae8962eeb116f58323984e12a3409"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 7,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "4166ca7d166eacbede077e3ddb8ad5babf4394437df9a990072b5fecd1910d5caaebcf5b19134e6e28124f42e227ea6f4474798e0a724cb3c3837949cecf9808"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 14,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "4b59f6ee279947650777cee665c90d07de412eb8b0ad700a2971994751b061c4e03c3b94f5cd402c7a96df0861de6561573c3f11788820a854436ccea94bce02"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 15,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "1387f12d74152386aa4040f66688de9b45c94a6631d26108ce0b07aa1ca6261934931bd16cde22ad953915957caa9de6ba1bd7ddcf98d73eedfc27d560842108"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 13,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "81cf173e6aa13e5734be6f49c80db6bac62eb4e8197783ed33ad8db14c1c2c9728ac82687563c087932958ca13c82c6273440cd73e92332947985622c9ca3501"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 6,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "bef6e45a768e9a9580d8d844c0b26ca34bac69dd1bb5d5023d6ba511ba42bf47f6d2152f0577cbc3961c7b7d09e935fb79e95d06ee60a0e8054d3e44d8b4770a"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 12,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "b3403176506658346a0445bc97f31a12bbbac8e4e7a523e87dbd63254e29def3dee69d7ad55e4c4972d5d1dfa4b09432e2ac01573a75f50931c70aff38c6670d"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 11,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "b26cf526fca6f9da9bbb6b70f35281266876705db200590562720fe1d85fffa54231d00139f937665dfaef40afdbe33abb4447296d0ac62de7ea3ae509bd6c0e"
}
],
"extensions": []
}
}

get_block_header_batch(block_nums)

Retrieve multiple block header by block numbers.

Parameters

Option

Description

vector<uint32_t> block_nums

vector containing heights of the block whose header should be returned

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_block_header_batch",
[
[
"10",
"20",
"30", ...
]
]
]
}

Returns

Array of headers of the referenced blocks, or null if no matching block was found.

{
"id": 4,
"jsonrpc": "2.0",
"result": [
[
10,
{
"previous": "00000009d9f26ac464ce30713bfdf9213d62bf72",
"round": 10,
"attempt": 0,
"timestamp": "2019-11-26T13:49:47",
"account": "1.2.12",
"delegate": "1.2.0",
"transaction_merkle_root": "0000000000000000000000000000000000000000",
"vm_root": [
"56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b42156e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"0.9a71ff66a2f503e4e96c4e9a2521d6a710f2d373b422332029da170d78fa1a68"
],
"prev_signatures": [
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 9,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "e7da3962836ed729e1d9328e202b7b9d1f1c02fd58070f8100ab157c628b8adfe4114a9e59674704ef1f08a22adb4ce6130106829782c688a25d53154d36f906"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 8,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "dd49d2ea30a2a74974ded7acd48189e96eb48c7df1adc8cdb2235f8c1b455a189ce663919efc51b88a916a5c66cc38b2c28ab6033e272928ddfde78c5d97e80e"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 7,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "9be2a70db76e3ecde06efd49df86ade1f52fa7424a6893984efaff468c63be7adb49753386a2d7cdd1716be2dd9e209dc68e38a0d803200d9cb94e87a622070a"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 13,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "658ed2e7afc2e2628657c813534b86984a5cb177c5524eca2a6b1d025476d42fb3172cbc1f4f9226df71edcffb2928e5efafa877b3bf467700327f290f40900b"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 6,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "1578503a6137344d4a340419d5f475e4ca46610e333e8d1ce87eb53719f2489f32d9efc37fe56e218135a5c69c64e00677e3eb819b4c9d0fadc2ba29c646a70d"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 14,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "640a7abccdfbd3f0f9846a0f876f6d6902487f87faca92eebe54a496e6397f04840735f308daab62ef264e09d67026926aefca4de56aa982a1c98f34de772807"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 12,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "5b848ee65c860c7a088c62674b96227eddf7ad0b9927c7c3833419a1dc282addc29bc898ca55aed09bb8d2c7fc183fd411f41f947e17493ec62c0418b5ab870e"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 15,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "220d9ae9d5a10a773883e2d638fac8d01480c1a0368919e18120c32930cad067e3e5b02d25636bb9d43b762d9f2e1ed7a7fdc3336fba31a2fc4454ce5ff7ea0a"
},
{
"_step": 4,
"_value": 0,
"_leader": 13,
"_producer": 11,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "1280197b49fafc2877b3813fdb51656df76440d42d993eae72a3d9da19e20f1ac79354ba6d769476888a47de44a5d1d445557084eecf5a677363009957276f06"
}
],
"extensions": []
}
],
[
20,
{
"previous": "000000134026b7af365a7785c1363c611ef44f1c",
"round": 20,
"attempt": 0,
"timestamp": "2019-11-26T13:50:27",
"account": "1.2.10",
"delegate": "1.2.0",
"transaction_merkle_root": "0000000000000000000000000000000000000000",
"vm_root": [
"56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b42156e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"0.9a71ff66a2f503e4e96c4e9a2521d6a710f2d373b422332029da170d78fa1a68"
],
"prev_signatures": [
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 7,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "53640c1ed6683a1b488063dc4d053b8c523035c5ee73769d0901ed22cd75dbde96f1e94acae8df0e899925bec9779643790108a38c551db2ba54a2bc0520130d"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 9,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "e989298932fc04961b99d7a934c9cbb49f3aed85d01ef5ad32741ffbbb6ee0cd3d0149a818865f2938d743f3b8206a7bf8edec077fde4ef731e2a5b88e81f004"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 8,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "2e98aa7487be46db65520c1bfaf77b4d1886e2d34f162cd71e57533687d6bcf6059ef322cc58ca3aa17ad7bd664f36b50ebf843f1ec4699220cf9268306c7d04"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 11,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "987d3d7fab249bfa1ef567128d4ea817ad82adbbb999c21e90d236593c474cc9db36ff776741d73df43a430a9f3f192baf9b41c3e8fe9d6d1f53d1ebb19c6903"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 13,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "3245cc0bf37dc2952fb35aba1bc7f410d9e8e04db917c8b8b8391487c1071911f874a471e5fcc97c405944ca13c135a39850bdae71d417a615f6fab627435202"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 12,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "4e96442065c1a4ffc13416de21004d626d99d0a8edab8721b773cbfba901b3e819920b94d9a61c6f18df495bf6edb43cd071c15115140c6969eb979e730da60e"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 14,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "7965ba7193694a9fd20f69c820d6402d66f5c2c9f8873ccfed8939b2128d11f446666f5a8aa400262b144346e8d21e6df61e81a85bf442069861b527c60e6d04"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 15,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "c7c6030fd3b172cbb9c13c7d799db95f6e930dd098fd5d6303a2a3819745e7d60f220fb64badce54d8b8bb8b56f4d0370db30898d9a9d9f74b62bcec25e16a09"
},
{
"_step": 4,
"_value": 0,
"_leader": 10,
"_producer": 10,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "b92196d8ec8f988a1fb5780f2f23cd55cfa77a5d245240f06ba467c5aa419e67c01c92b2d3bedc904e87f897445487ae94bd4ece2816919d8a0a4f0aa1017008"
}
],
"extensions": []
}
],
[
30,
{
"previous": "0000001daaabe07d7e1b0ed10dda968653eafdf1",
"round": 30,
"attempt": 0,
"timestamp": "2019-11-26T13:51:08",
"account": "1.2.12",
"delegate": "1.2.0",
"transaction_merkle_root": "0000000000000000000000000000000000000000",
"vm_root": [
"56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b42156e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"0.9a71ff66a2f503e4e96c4e9a2521d6a710f2d373b422332029da170d78fa1a68"
],
"prev_signatures": [
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 9,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "c6b758b24747078900bd38660fdf5c435bbc3656de6f5fcf4e612232479c06080d79f1287c27b7d617c8a3f411cdd6decbeff1b0b40cc9ba31f510502815c10b"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 8,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "66a7bc3cac01f4a8cb0139c3b11c846f5b487021d189225638bd3d16e5f1ce95195ab6554a5c0b6b7878e401b97b53f644420eeaed9a9ca92c2b4fc1ac7baf0d"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 7,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "62c88137c9888c779b134eec9102a90d6c43c9e01e6b149effac8cb51ecd77b87f9d5a376b47c485ab4171f2e456410698c8d9af4dd50a97e9c446882cb4e604"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 13,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "4fe2c0568ae379efdd40790c35263bb71eca1e3bef8c998885c0527b257e33e804083f93c2ddd97d7ffea9e70dfcad453f0f5c3d84ec6699a9f5d9281bfb1700"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 6,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "e7d7e90619c0e61f4c4073b20404d494dd6db09809c6e64a4a05f2b82226b013c22021f52c6493f7dfa527fcc1fd4e41505c4e8b4983bb7aaa84cd73e2813b08"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 15,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "64bf9fcbdc84905b93dbb8f2a99d47af9b0d8fd9080f155ed452d718378026ab7a613882a78eff8f2c033f04c2f7d7232f2e5735daa429d03a5045338bc8cc06"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 12,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "8410d2eae74d8e925631596267a19c64725fffe7e186aba035ac8b18a96e3d04f7c868ce148d9bfde9b0df23e0909f87ad41e7723b2615838f3e57f78186cd08"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 14,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "2b4184d0b615000ff44e3c4b7e2518f7ceb8a67376abb53aac4496b61e9e895f9c77b0effc7bd8f17795c847e8be49b835a1914ea06df3a2a09a85e457c87d09"
},
{
"_step": 4,
"_value": 0,
"_leader": 15,
"_producer": 11,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "ecf1272e2d300c35628cefb84c24e4e3ed67a04825e69a132a80f9863f06341ebdab72118ea6e2fa3079016f8171974ba56d040dbcc417946253fb689913120b"
}
],
"extensions": []
}
]
]
}

get_block(block_num)

Retrieve a full, signed block.

Parameters

Option

Description

uint32_t block_num

height of the block to be returned

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_block",
[
"75"
]
]
}

Returns

The referenced block, or null if no matching block was found.

{
"id": 4,
"jsonrpc": "2.0",
"result": {
"previous": "0000004abf11056270d24459abe3a58516d99cee",
"round": 75,
"attempt": 2,
"timestamp": "2019-11-26T13:54:37",
"account": "1.2.11",
"delegate": "1.2.0",
"transaction_merkle_root": "4346203bfbd5139e1ee6167b1ad79cb6be752934",
"vm_root": [
"002b44168e591a0a984350ca8f56776a98c3b6b64351cd0bbef52cf8615d990cece9f0bcd9205c170ed67dbabad0b643482e0ea87650abeb172a47656b53bc53",
"0.9a71ff66a2f503e4e96c4e9a2521d6a710f2d373b422332029da170d78fa1a68"
],
"prev_signatures": [
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 9,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "c2c1d7e758306154ab5038c97f20e0c034c51be35e084fef0361299a641a258021dbf6ddba764ce33532c51e1d1a9df19bba90ed5b5e5d0731fffdc5892f9c01"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 8,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "81105a4baa83e5f2d90703b5fa644fa9284134352401e947aa97c30f8d1ae9fc22add66d0c911ee927f032a3bfb56ff6c93ae8962eeb116f58323984e12a3409"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 7,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "4166ca7d166eacbede077e3ddb8ad5babf4394437df9a990072b5fecd1910d5caaebcf5b19134e6e28124f42e227ea6f4474798e0a724cb3c3837949cecf9808"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 14,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "4b59f6ee279947650777cee665c90d07de412eb8b0ad700a2971994751b061c4e03c3b94f5cd402c7a96df0861de6561573c3f11788820a854436ccea94bce02"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 15,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "1387f12d74152386aa4040f66688de9b45c94a6631d26108ce0b07aa1ca6261934931bd16cde22ad953915957caa9de6ba1bd7ddcf98d73eedfc27d560842108"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 13,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "81cf173e6aa13e5734be6f49c80db6bac62eb4e8197783ed33ad8db14c1c2c9728ac82687563c087932958ca13c82c6273440cd73e92332947985622c9ca3501"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 6,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "bef6e45a768e9a9580d8d844c0b26ca34bac69dd1bb5d5023d6ba511ba42bf47f6d2152f0577cbc3961c7b7d09e935fb79e95d06ee60a0e8054d3e44d8b4770a"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 12,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "b3403176506658346a0445bc97f31a12bbbac8e4e7a523e87dbd63254e29def3dee69d7ad55e4c4972d5d1dfa4b09432e2ac01573a75f50931c70aff38c6670d"
},
{
"_step": 4,
"_value": 0,
"_leader": 8,
"_producer": 11,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "b26cf526fca6f9da9bbb6b70f35281266876705db200590562720fe1d85fffa54231d00139f937665dfaef40afdbe33abb4447296d0ac62de7ea3ae509bd6c0e"
}
],
"extensions": [],
"ed_signature": "584a7c6ed652446b9db2bd8224463850f2d634d1dff873e8296e6820ca40dd15b5f4cdb144ae226231ebf7a93b6c508b953f4b7609250ad8cc72f00e9e829f07",
"rand": "6a9ce5d9989fbca417db32dad701b3c805a3a64cb8e6b50753cdc53759071737",
"cert": [
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 7,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "02a3cca6c7562b9c23a55695c489ab7e770ceb1af89153be5c770ca0cc69d6beba87be580a954125bb0e3f530ec1aded2d66c3faef11eea4c5f73b4228862b0d"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 8,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "6fb9049a851b45b2c5c2e63771993d083ae172539d61d9fe5277cfb9db61fdb790d0f5a9ef4bdc139262f60ecb370558dbaa805768976b8522a2aca35abecc0c"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 9,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "58f28a9a60cbbe574fb637c9c9da649b7091188d5a6e89c12d9a081d2ccfb7635f05b2f53a27cc2e1d2132205afa759c05805ef5d02e92224fd7fbd5fd7f8d08"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 12,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "abdc1cd5f5727c5dada7562ef90853ecac60f51ba3c5aaffb6d461b88d06d3d96b92f57c69fe89e752b6b6be43b155854c703b7790c3834342cd1706738b490d"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 11,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "728923637a3b62ed08ca30f692137b97d0d58f4b15f2662c344a5ae9faf163a0ffab6803c993577bb52c64b3bd776b799a9c49f0e56db05d4c8b4bc60fe8ec02"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 13,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "8ad6904facbbd56b898b77ccab4d5307a098d41f0421bdca6cfa55924cbecfd72fbc15dfb5c6642d4c61817b228414f6e525e6b938a932d00940b6b6e915240e"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 14,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "4dd7dd264c8183b56c22892ebdfa004d26ec8ff7d635ebcae370c6acfdca1b8468884ca46c087179dc3c1182536d55802958e10d9941e90f70afd70acdd23105"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 15,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "dfe9a82f1b9db6b29de3393ec7c51053b0361ab3ba309285107f4acbfcd75bf5307ff22635316c671963f766ea2e1058f50fa2d440bb48a3ab68d55dc200b40e"
},
{
"_step": 4,
"_value": 0,
"_leader": 11,
"_producer": 10,
"_delegate": 0,
"_fallback": 0,
"_bba_sign": "8d1c9c26a9b8c3aab77711f7ae544d158605966a3a4816422d2ce6a0c294cdba7595f4da768396db5bedc7300e546fbef33791a458d4f6186b243f0d8f970305"
}
],
"transactions": [
{
"ref_block_num": 36,
"ref_block_prefix": 764926637,
"expiration": "2019-11-26T14:01:36",
"operations": [
[
31,
{
"fee": {
"amount": 381,
"asset_id": "1.3.0"
},
"registrar": "1.2.15",
"value": {
"amount": 1,
"asset_id": "1.3.0"
},
"code": "60806040526101e2806100136000396000f30060806040526004361061004c576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680632e1a7d4d14610051578063d0e30db01461007e575b600080fd5b34801561005d57600080fd5b5061007c60048036038101908080359060200190929190505050610088565b005b610086610143565b005b3373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501580156100ce573d6000803e3d6000fd5b503073ffffffffffffffffffffffffffffffffffffffff16317fe8d947d7ebdd7b8b8fa2ad2022c7591418ac32d8c29c5f8a8fc9de52ffa5409260405160405180910390a2807f4e70a604b23a8edee2b1d0a656e9b9c00b73ad8bb1afc2c59381ee9f69197de760405160405180910390a250565b347f4d6ce1e535dbade1c23defba91e23b8f791ce5edc0cc320257a2b364e4e3842660405160405180910390a23073ffffffffffffffffffffffffffffffffffffffff16317fe8d947d7ebdd7b8b8fa2ad2022c7591418ac32d8c29c5f8a8fc9de52ffa5409260405160405180910390a25600a165627a7a72305820a27dfc236191402eef3cee43c9a20e3a01fe184eba3625103e93c636009a93fb0029",
"eth_accuracy": false,
"extensions": []
}
]
],
"extensions": [],
"signatures": [
"7f9bbe70a45197e9d01ecf35b8f42965ec9689b298223b8bed6895325dbdda6adedba3db491620d78d1022b2feb7d53c2d5e622b8f2f47d9af1c5a3be75dd603"
],
"signed_with_echorand_key": false,
"operation_results": [
[
1,
"1.12.1000"
]
],
"fees_collected": 381
},
{
"ref_block_num": 36,
"ref_block_prefix": 764926637,
"expiration": "2019-11-26T14:01:37",
"operations": [
[
31,
{
"fee": {
"amount": 381,
"asset_id": "1.3.0"
},
"registrar": "1.2.15",
"value": {
"amount": 1,
"asset_id": "1.3.0"
},
"code": "60806040526101e2806100136000396000f30060806040526004361061004c576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680632e1a7d4d14610051578063d0e30db01461007e575b600080fd5b34801561005d57600080fd5b5061007c60048036038101908080359060200190929190505050610088565b005b610086610143565b005b3373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501580156100ce573d6000803e3d6000fd5b503073ffffffffffffffffffffffffffffffffffffffff16317fe8d947d7ebdd7b8b8fa2ad2022c7591418ac32d8c29c5f8a8fc9de52ffa5409260405160405180910390a2807f4e70a604b23a8edee2b1d0a656e9b9c00b73ad8bb1afc2c59381ee9f69197de760405160405180910390a250565b347f4d6ce1e535dbade1c23defba91e23b8f791ce5edc0cc320257a2b364e4e3842660405160405180910390a23073ffffffffffffffffffffffffffffffffffffffff16317fe8d947d7ebdd7b8b8fa2ad2022c7591418ac32d8c29c5f8a8fc9de52ffa5409260405160405180910390a25600a165627a7a72305820a27dfc236191402eef3cee43c9a20e3a01fe184eba3625103e93c636009a93fb0029",
"eth_accuracy": false,
"extensions": []
}
]
],
"extensions": [],
"signatures": [
"77563fdbee2579c603c14fda65baa3b98d4f65c73a33c2a7167b41abc919d60cd55f961db3f5d6555fa19d3c3e0029dbacc2489017b1593ab1122da30bbe5904"
],
"signed_with_echorand_key": false,
"operation_results": [
[
1,
"1.12.1001"
]
],
"fees_collected": 381
}
]
}
}

get_block_tx_number(id)

Get the total number of transactions in block.

Parameters

Option

Description

block_id_type(ripemd160) id

ID of the block to retrieve

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_block_tx_number",
[
"000003e835f96c81ce14fea203ad5658f8b2f5b1"
]
]
}

Returns

If block was found total number of transaction in block, or null if no matching block was found.

{
"id": 4,
"jsonrpc": "2.0",
"result": 1
}

get_block_virtual_ops(block_num)

Get virtual ops from the block.

Parameters

Option

Description

uint32_t block_num

height of the block to be returned

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_block_virtual_ops",
[
"7429"
]
]
}

Returns

Array of operation history objects, or null if no matching operation was found.

{
"id": 4,
"jsonrpc": "2.0",
"result": [
{
"id": "1.6.2018",
"op": [
37,
{
"fee": {
"amount": 0,
"asset_id": "1.3.0"
},
"value": {
"amount": 10000,
"asset_id": "1.3.1"
},
"account": "1.2.1013",
"deposit_id": "1.15.0",
"extensions": []
}
],
"result": [
0,
{}
],
"block_num": 1413,
"trx_in_block": 3,
"op_in_trx": 0,
"virtual_op": 15129,
"extensions": []
}
]
}

get_transaction(block_num, trx_in_block)

Fetch an individual transaction.

Parameters

Option

Description

uint32_t block_num

height of the block in which the transaction resides

uint32_t trx_in_block

index of the transaction in the block

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_transaction",
[
"1000",
"10"
]
]
}

Returns

A processed transaction object.

{
"id": 4,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 221,
"ref_block_prefix": 4141892275,
"expiration": "2019-08-14T14:05:52",
"operations": [
[
0,
{
"fee": {
"amount": 20,
"asset_id": "1.3.0"
},
"from": "1.2.26",
"to": "1.2.10",
"amount": {
"amount": 1000000000,
"asset_id": "1.3.0"
},
"extensions": []
}
]
],
"extensions": [],
"signatures": [
"5c95aedb574a86252749031f4d5cbb790037604b8c2e01e6e6eae071cb231459a4902e2932383b14e0d61d49812a73992766c958c823cd2691c5d4d4fe803b07"
],
"signed_with_echorand_key": false,
"operation_results": [
[
0,
{}
]
]
}
}

get_recent_transaction_by_id(id)

If the transaction has not expired, this method will return the transaction for the given ID or it will return null if it is not known. Just because it is not known does not mean it wasn’t included in the blockchain.

Parameters

Option

Description

transaction_id_type(ripemd160) id

ID of the transaction

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_recent_transaction_by_id",
[
"15ec7bf0b50732b49f8228e07d24365338f9e3ab"
]
]
}

Returns

A signed transaction object.

{
"id": 4,
"jsonrpc": "2.0",
"result": {
"ref_block_num": 27,
"ref_block_prefix": 109608699,
"expiration": "2019-08-14T14:22:17",
"operations": [
[
21,
{
"fee": {
"amount": 0,
"asset_id": "1.3.0"
},
"deposit_to_account": "1.2.26",
"balance_to_claim": "1.8.0",
"balance_owner_key": "ECHO6XS3BMVnEHAzo1PhHWt9vndrZn2P27tCbU9WdqCM8sJu",
"total_claimed": {
"amount": "1000000000000000",
"asset_id": "1.3.0"
},
"extensions": []
}
]
],
"extensions": [],
"signatures": [
"c621da6b014a5cf6d4533ea747f0d77908663e6b4daaa3f5041f6d176f26a947847889c467d82506da9c00316e073c2435f21a6bb6e2788996c8c0b94e93bd01"
],
"signed_with_echorand_key": false,
"operation_results": [
[
0,
{}
]
]
}
}

Proposed transactions

get_proposed_transactions(id)

Returns the set of proposed transactions relevant to the specified account id.

Parameters

Option

Description

account_id_type id

the ID of the account

Example

{
"id": 4,
"method": "call",
"params": [
DATABASE_API_ID,
"get_proposed_transactions",
[
"1.2.26"
]
]
}

Returns

{
"id": 4,
"jsonrpc": "2.0",
"result": [
{
"id": "1.5.0",
"expiration_time": "1970-01-01T00:00:00",
"proposed_transaction": {
"ref_block_num": 221,
"ref_block_prefix": 4141892275,
"expiration": "1970-01-01T00:00:00",
"operations": [],
"extensions": []
},
"required_active_approvals": [],
"available_active_approvals": [],
"available_key_approvals": [],
"extensions": []
}
]
}