LSK (Lisk)

chain_getBlockByID

Returns a block based on the id passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getBlockByID",
    "params": {
        "id": "78450927527c9a6019168530890ba2df1122c368b3ffd4dcdc119b79e75e14d9"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "header": {
            "version": 2,
            "timestamp": 1715577910,
            "height": 24753176,
            "previousBlockID": "c5e9cf17b025e13c782e6bef43b8e76968634ab68c934cbbe48099b63e9b777c",
            "stateRoot": "a77c2bcdb269b97211cb41c1a261c4020cd997321c12b618c667279be7eea1a0",
            "assetRoot": "ebe45cb0d0652741451adc01c31404345c666257f84fb327c99916fea3278b95",
            "eventRoot": "0ed6981a214144b82d9dc6ca2ff9330138a5140c1f53e8be92716d311b988480",
            "transactionRoot": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
            "validatorsHash": "00514e1869ada11a08667c52da0360a22a1ee26671ff4de313c79e60c768d924",
            "aggregateCommit": {
                "height": 24753011,
                "aggregationBits": "",
                "certificateSignature": ""
            },
            "generatorAddress": "lskr75mdo4kob3m6rmsvxwtharv8sngnkc8vn77x4",
            "maxHeightPrevoted": 24753097,
            "maxHeightGenerated": 24753096,
            "impliesMaxPrevotes": true,
            "signature": "ae88998a090e1d810ea754802f9b3773e9f2a78ce774b067a7ac8bf355a92f58b817d7f06f373e213f21fbef0468f7067c23c3070891f6d2196cd8be7137dd0f",
            "id": "78450927527c9a6019168530890ba2df1122c368b3ffd4dcdc119b79e75e14d9"
        },
        "transactions": [],
        "assets": [
            {
                "module": "random",
                "data": "0a10135a2d911b1cd29f8cc3a54e1af6cde1"
            }
        ]
    }
}

chain_getBlocksByIDs

Returns a set of blocks based on the ids passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getBlocksByIDs",
    "params": {
        "ids": [
            "78450927527c9a6019168530890ba2df1122c368b3ffd4dcdc119b79e75e14d9",
            "c888c0bce611918bb525a376f5ec31effd588cad366a2b8e504c8dd5f06a1d5c"
        ]
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": [
        {
            "header": {
                "version": 2,
                "timestamp": 1715577910,
                "height": 24753176,
                "previousBlockID": "c5e9cf17b025e13c782e6bef43b8e76968634ab68c934cbbe48099b63e9b777c",
                "stateRoot": "a77c2bcdb269b97211cb41c1a261c4020cd997321c12b618c667279be7eea1a0",
                "assetRoot": "ebe45cb0d0652741451adc01c31404345c666257f84fb327c99916fea3278b95",
                "eventRoot": "0ed6981a214144b82d9dc6ca2ff9330138a5140c1f53e8be92716d311b988480",
                "transactionRoot": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
                "validatorsHash": "00514e1869ada11a08667c52da0360a22a1ee26671ff4de313c79e60c768d924",
                "aggregateCommit": {
                    "height": 24753011,
                    "aggregationBits": "",
                    "certificateSignature": ""
                },
                "generatorAddress": "lskr75mdo4kob3m6rmsvxwtharv8sngnkc8vn77x4",
                "maxHeightPrevoted": 24753097,
                "maxHeightGenerated": 24753096,
                "impliesMaxPrevotes": true,
                "signature": "ae88998a090e1d810ea754802f9b3773e9f2a78ce774b067a7ac8bf355a92f58b817d7f06f373e213f21fbef0468f7067c23c3070891f6d2196cd8be7137dd0f",
                "id": "78450927527c9a6019168530890ba2df1122c368b3ffd4dcdc119b79e75e14d9"
            },
            "transactions": [],
            "assets": [
                {
                    "module": "random",
                    "data": "0a10135a2d911b1cd29f8cc3a54e1af6cde1"
                }
            ]
        },
        {
            "header": {
                "version": 2,
                "timestamp": 1715576480,
                "height": 24753035,
                "previousBlockID": "6d1e688445de330bcde7421fe9fc9caa723421e4c4f85506aa6a5567f8068968",
                "stateRoot": "0dd3e26abfe41f7049f2c127264c7425761a42358cfa5ceb31424f5a6fed4730",
                "assetRoot": "e3e6f495cc00dfd8cd4f7423b201c0dd1a6844f477c79eccceb928e2bb19cb59",
                "eventRoot": "a021050497201b605bb7f418408618a52f1c765ae79425f409cec46d9a2c033d",
                "transactionRoot": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
                "validatorsHash": "00514e1869ada11a08667c52da0360a22a1ee26671ff4de313c79e60c768d924",
                "aggregateCommit": {
                    "height": 24752899,
                    "aggregationBits": "",
                    "certificateSignature": ""
                },
                "generatorAddress": "lskmfjoweof4uwfmvxny5r6sjcxx95c84hojn2hua",
                "maxHeightPrevoted": 24752978,
                "maxHeightGenerated": 24752906,
                "impliesMaxPrevotes": true,
                "signature": "54b86e9076991d162269f401c9f3a3b8f0bc52700f7adcd511f1ea5e18bb3251201c9e205bc2db3e5b229c4aef66578ecd605149f72496aff2f390c7a67d7e0f",
                "id": "c888c0bce611918bb525a376f5ec31effd588cad366a2b8e504c8dd5f06a1d5c"
            },
            "transactions": [],
            "assets": [
                {
                    "module": "random",
                    "data": "0a1081186dece45ac5ce2d20a1409ee313a7"
                }
            ]
        }
    ]
}

chain_getBlockByHeight

Returns a block based on the height passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getBlockByHeight",
    "params": {
        "height": 24754239
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "header": {
            "version": 2,
            "timestamp": 1715588790,
            "height": 24754239,
            "previousBlockID": "08ffd3cc27e9ef6cf0a2b79ae6448942337f9e7991e1b3202ef3ed75d74638f3",
            "stateRoot": "34d7a608b456d11a03e9e516c32c40636ea3e7047d9286d44373a007b7fabfe8",
            "assetRoot": "1de632ce4dce3d391a63821962ae1c9446ef1b97794586bce90b7e2f588bfa0f",
            "eventRoot": "2432060b1ac7badd3ee7aa2f83ea57aeb96965e8e4fbca2a2f372b9f0dec48d0",
            "transactionRoot": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
            "validatorsHash": "b16c3e2b2e5e87b4dee60f68f0cd2c70a7ca6277c42add78e65704eb3173db78",
            "aggregateCommit": {
                "height": 24754038,
                "aggregationBits": "",
                "certificateSignature": ""
            },
            "generatorAddress": "lsk28y4tyecyzd65sd4gvd9ojo8mn3enydbooxnw5",
            "maxHeightPrevoted": 24754142,
            "maxHeightGenerated": 24754141,
            "impliesMaxPrevotes": true,
            "signature": "036e4e1786b5dc138f2cdde135dc2cdb3aa1be701e1b602670081e14acc5b5a61085874be32df55e680a727dec190b40716526b9c06ed03b6d8c5fc29ec1fb08",
            "id": "73a283c081d3434bdd86a5be20572c5e66205c83f5ca6f8be19e5971ed2746b1"
        },
        "transactions": [],
        "assets": [
            {
                "module": "random",
                "data": "0a10a0e0d98a2a015f669284e85dbed2a913"
            }
        ]
    }
}

chain_getBlocksByHeightBetween

Returns a set of blocks based on the range of height passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getBlocksByHeightBetween",
    "params": {
        "from": 24754240,
        "to": 24754243
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": [
        {
            "header": {
                "version": 2,
                "timestamp": 1715588830,
                "height": 24754243,
                "previousBlockID": "4faf1a6a3b6107ce5ec07e90172d79c7349a9d03f58516d07b974b3fbe5a760c",
                "stateRoot": "eef85a1c3514d7bbcfebf66629b624b5f111172c9e60fcc9df2eb5c4b3a4e755",
                "assetRoot": "988df12cd235efb4cc9561f93f801688f568c2e5f1d4fd4c0f4539637c6c3829",
                "eventRoot": "6c533209d53eb7580e924674f24ce8fbbff7c0bffb8c2cfa7c290eb3645f2a92",
                "transactionRoot": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
                "validatorsHash": "b16c3e2b2e5e87b4dee60f68f0cd2c70a7ca6277c42add78e65704eb3173db78",
                "aggregateCommit": {
                    "height": 24754064,
                    "aggregationBits": "",
                    "certificateSignature": ""
                },
                "generatorAddress": "lskrhqvvvsh9st2e9z7rk9xoecwwqso395fg5pfnb",
                "maxHeightPrevoted": 24754154,
                "maxHeightGenerated": 24754104,
                "impliesMaxPrevotes": true,
                "signature": "4ac401b4aca70b8c298b36a219c42632bc5b6413e11ed58dcab21fcf80e957d7663969232ccd4e55837711b2c750e7dbece4955eb36ed6017903df3054cb2c0d",
                "id": "a956f5bf41b85b1c9b11661d9ae784e31675723ac03006341b629af1232e3222"
            },
            "transactions": [],
            "assets": [
                {
                    "module": "random",
                    "data": "0a1039651bc6c781b3cbbb3fd9f062d146c5"
                }
            ]
        },
        {
            "header": {
                "version": 2,
                "timestamp": 1715588820,
                "height": 24754242,
                "previousBlockID": "a4ee36d99339fe56d4613d79eeed49e6bb81f6ff8769579abaf66d61e2c9fd9c",
                "stateRoot": "e3c0c7dffd84540de744c3da2f505392667a0bda52facf8908002e311d94f516",
                "assetRoot": "9c541bb3797b4205431e4d8364144f793bdcb8abe0c4b98726a951f71998c413",
                "eventRoot": "b4c1693a6486007b193d51cf987e67c544376771e1621c47a80e9d2c29a1e86c",
                "transactionRoot": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
                "validatorsHash": "b16c3e2b2e5e87b4dee60f68f0cd2c70a7ca6277c42add78e65704eb3173db78",
                "aggregateCommit": {
                    "height": 24754064,
                    "aggregationBits": "fbffffdffffffffffffbffff1f",
                    "certificateSignature": "a581a30af4db8ad6334124f23ad5cd688d4d74e1d383d4d8085a40580e0014be2fb2c039238cb7b0b91ff4cfe883a01908dfb56e463246526bc116a57f2aa993aa5df8a68e5e947f6c258d5351b70b853e69fd3a911438da0d9279793ecd42cd"
                },
                "generatorAddress": "lskapovqmhnmhga8a6e5xfcfcdhazt8c4adwwt9so",
                "maxHeightPrevoted": 24754154,
                "maxHeightGenerated": 24754189,
                "impliesMaxPrevotes": true,
                "signature": "e6422d2bd0a793ab57d44411fad0c07ca28752e0773b857375b63013dafa0b81148ee8007ad7b3e4bcf43e157ed6852ba682dfa3f83c80340290b384e37b5703",
                "id": "4faf1a6a3b6107ce5ec07e90172d79c7349a9d03f58516d07b974b3fbe5a760c"
            },
            "transactions": [],
            "assets": [
                {
                    "module": "random",
                    "data": "0a10bb77826a7be7d247d617376d66245df5"
                }
            ]
        },
...

chain_getTransactionByID

Returns a transaction based on the id passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getTransactionByID",
    "params": {
         "id": "02d6a96452cbfcc132867dc07a954163fb6f07df4096e795113c307135daaed2"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "module": "token",
        "command": "transfer",
        "params": "0a0800000000000000001080a4a8be99061a144185f90417e71daf412035953d8a9a759b2254992200",
        "nonce": "3177",
        "fee": "200000",
        "senderPublicKey": "82e748bd30098d0bebd1234ac55bd9fd3fec3536de4c23468f1cd7875607d83e",
        "signatures": [
            "98c6783d3b4e0168eea183272219ec6c2e657165daf2d3fb66d8442002ffe9d4213d6958fc7a29f8b188deee439272b24254fe69337128eca8159911621b0b03"
        ],
        "id": "02d6a96452cbfcc132867dc07a954163fb6f07df4096e795113c307135daaed2"
    }
}

chain_getTransactionsByIDs

Returns a set of transactions based on the ids passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getTransactionsByIDs",
    "params": {
        "ids": [
            "02d6a96452cbfcc132867dc07a954163fb6f07df4096e795113c307135daaed2"
        ]
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": [
        {
            "module": "token",
            "command": "transfer",
            "params": "0a0800000000000000001080a4a8be99061a144185f90417e71daf412035953d8a9a759b2254992200",
            "nonce": "3177",
            "fee": "200000",
            "senderPublicKey": "82e748bd30098d0bebd1234ac55bd9fd3fec3536de4c23468f1cd7875607d83e",
            "signatures": [
                "98c6783d3b4e0168eea183272219ec6c2e657165daf2d3fb66d8442002ffe9d4213d6958fc7a29f8b188deee439272b24254fe69337128eca8159911621b0b03"
            ],
            "id": "02d6a96452cbfcc132867dc07a954163fb6f07df4096e795113c307135daaed2"
        }
    ]
}

chain_getTransactionsByHeight

Returns a set of transactions based on the height of a block.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getTransactionsByHeight",
    "params": {
         "height": 24754279
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": [
        {
            "module": "token",
            "command": "transfer",
            "params": "0a08000000000000000010c298ee84d50a1a14b58eeda703ba159c4999453072be2995937ca3c52200",
            "nonce": "1448",
            "fee": "5500000",
            "senderPublicKey": "0bd7f8b3cab58d992db28e93b3c8c04d1276519cf91d8015d5f8c092fa9dd07f",
            "signatures": [
                "1716219e9817c79d05a92103be5cb3ad3ac4aeb243c37b251b6527af6d59c3050401b2986493ab40103685886fff09679b4cc0fe0aa882fd335bae5e5a70d20e"
            ],
            "id": "4a526ea4b5bef2221552ab6dfcb2b876786d44d5671a79924128f5a3a60e05c1"
        }
    ]
}

chain_getAssetsByHeight

Returns an asset based on the height of a block.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getAssetsByHeight",
    "params": {
         "height": 24754279
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": [
        {
            "module": "random",
            "data": "0a10e62efad775b4860845a39dc3793c798f"
        }
    ]
}

chain_getLastBlock

Returns the last generated block on the chain.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getLastBlock",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "header": {
            "version": 2,
            "timestamp": 1715589442,
            "height": 24754301,
            "previousBlockID": "521c22601e95ae85bfe118415a739664141f41e22d2b94c5bf48e3d0a926e680",
            "stateRoot": "bd30cbb02b061030f96ef2ed65b7ab2e7bba2b1150caab366a0abb68242c7ce6",
            "assetRoot": "a529ed14d1ccc5f0b746bb0eaf86852f122a3637e726cb3fad9f661e7df791d0",
            "eventRoot": "e5d9da460f3d29887b8329073b7b997b45f9ba031dc401f3c2c82e50ab9c59fa",
            "transactionRoot": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
            "validatorsHash": "12967f4a02a42f4763d4ad3ded6796527c2a264fd5f087acf699ed566239b649",
            "aggregateCommit": {
                "height": 24754146,
                "aggregationBits": "",
                "certificateSignature": ""
            },
            "generatorAddress": "lskf63p8348y9kcoctgugyyvjsfm2h9fnpdr8yua3",
            "maxHeightPrevoted": 24754241,
            "maxHeightGenerated": 24754264,
            "impliesMaxPrevotes": true,
            "signature": "57bdb5b2f5af704b93e96c64e1ba699318afd1d22e51307f4b2b064a702a2e3b3c1f289d3d2d0898ea1d9cbe1071b0ae123320ec70862276c4be220cb9bdbb02",
            "id": "3751d4d14d345ad2786667f2f6b96d3ad4fde45d05efb0e6ceada6d6222b1ea4"
        },
        "transactions": [],
        "assets": [
            {
                "module": "random",
                "data": "0a10842fd509450f6390d1ec019cecbbbeb2"
            }
        ]
    }
}

chain_getEvents

Returns the events generated on a given block height.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getEvents",
    "params": {
        "height": 24754301
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": [
        {
            "data": "0a14f29047a12f8b68360e7f87e311737e2e3adf1c9a1208000000000000000018abc0dd752000",
            "index": 0,
            "module": "token",
            "name": "mint",
            "topics": [
                "03",
                "f29047a12f8b68360e7f87e311737e2e3adf1c9a"
            ],
            "height": 24754301
        },
        {
            "data": "08abc0dd751000",
            "index": 1,
            "module": "dynamicReward",
            "name": "rewardMinted",
            "topics": [
                "03",
                "f29047a12f8b68360e7f87e311737e2e3adf1c9a"
            ],
            "height": 24754301
        }
    ]
}

chain_proveEvents

Returns the inclusion or non-inclusion proof, such as whether or not the key exists in the blockchain.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_proveEvents",
    "params": {
        "height": 24754301,
        "queries": [
            ""
        ]
    }
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": "1",
    "error": {
        "message": "Invalid input: `Query key length must be equal to key length`",
        "code": -32600
    }
}

chain_areHeadersContradicting

Checks, if the encoded header values passed to the endpoint contradict each other and returns a corresponding boolean value.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_areHeadersContradicting",
    "params": {
        "header1": "08021084c4bc9c06180f2220a3039b7cf0e497ff7c26f93c0823cb0d2f0697179abcf1a90cb7961d8c4fbaa42a142093269bbcc8150429875d6c84bd22de5677051a3220e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b8553a2059fcb3b3e83cf0374b5377aad44c34ab9fe14ba2d574a99f120de60be4ece185422081f9132f118a2da59555d22dd2530036e1a5821852d7ee344d3ef86c1b2aad8a4a20036bd00fc5609eface7fa1244a250c60f2edfefc4bb8348f688371a58d48039f5000580060016a20594e9cd7a13974426b906ea6c2dc59a0f40387184fc47c3200403ad5bbf294867206080012001a007a406fc1ef64c95d559fa4cdd4bd13a6de01a75dd00c2f516b939ad595b86f1f439fb8ac85f4c42bf570865a9c00aa70e5967a8d441e7f3a889a62cbb1ba2847f50e",
        "header2": "08021084c4bc9c06180f2220a3039b7cf0e497ff7c26f93c0823cb0d2f0697179abcf1a90cb7961d8c4fbaa42a142093269bbcc8150429875d6c84bd22de5677051a3220e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b8553a2059fcb3b3e83cf0374b5377aad44c34ab9fe14ba2d574a99f120de60be4ece185422081f9132f118a2da59555d22dd2530036e1a5821852d7ee344d3ef86c1b2aad8a4a20036bd00fc5609eface7fa1244a250c60f2edfefc4bb8348f688371a58d48039f5000580060016a20594e9cd7a13974426b906ea6c2dc59a0f40387184fc47c3200403ad5bbf294867206080012001a007a406fc1ef64c95d559fa4cdd4bd13a6de01a75dd00c2f516b939ad595b86f1f439fb8ac85f4c42bf570865a9c00aa70e5967a8d441e7f3a889a62cbb1ba2847f50e"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "valid": false
    }
}

chain_getGeneratorList

Returns a list of accounts generated by the chain.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "chain_getGeneratorList",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "list": [
            {
                "address": "lsk73z6rrmpvmb7cd6au8f68xc7oy4ueht5tdq426",
                "nextAllocatedTime": 1715589850
            },
            {
                "address": "lskmfjoweof4uwfmvxny5r6sjcxx95c84hojn2hua",
                "nextAllocatedTime": 1715589860
            },
            {
                "address": "lskr3but476prr56orxwam8uvs65hcmjmkgqwz2a6",
                "nextAllocatedTime": 1715589870
            },
            {
                "address": "lskbgyheqckfk2cxjhtfu96kfacdz4jkpbx5nb4rv",
                "nextAllocatedTime": 1715589880
            },
            {
                "address": "lskhgev6u5qyy6fv5j2ms989cgok4fre7dk3a7wp4",
                "nextAllocatedTime": 1715589890
            },
            {
                "address": "lskftsu2no2x645hwwszorxzqhcdnkcjj834wksb2",
                "nextAllocatedTime": 1715589900
            },
            {
                "address": "lskyvvm5ousez42c854htmmr8hvc939nkmvqwptkw",
                "nextAllocatedTime": 1715589910
            },
            {
                "address": "lsknxzsx868hbtaosfk5c8vprur966y77ftefsu3a",
                "nextAllocatedTime": 1715589920
            },
            {
                "address": "lskapovqmhnmhga8a6e5xfcfcdhazt8c4adwwt9so",
                "nextAllocatedTime": 1715589930
            },
            {
                "address": "lskbs8bkjrevz6a395s3x9w9kga7brvno4ed8hmvp",
                "nextAllocatedTime": 1715589940
            },
            {
                "address": "lskn2cvfhc755wcvmnobprasyc4z5vz8h5geetaoh",
                "nextAllocatedTime": 1715589950
            },
...

consensus_getBFTParameters

Returns specified Byzantine Fault Tolerance (BFT) parameters based on the height of a block.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "consensus_getBFTParameters",
    "params": {
         "height": 3622
    }
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": "1",
    "error": {
        "message": "",
        "code": -32600
    }
}

consensus_getBFTHeights

Returns maximum height for Prevoted, Precommitted, and Certified blocks.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "consensus_getBFTHeights",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "maxHeightPrevoted": 24754357,
        "maxHeightPrecommitted": 24754278,
        "maxHeightCertified": 24754278
    }
}

generator_estimateSafeStatus

Used to estimate safe status.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "generator_estimateSafeStatus",
    "params": {
        "timeShutdown": 100
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "height": 24759094,
        "maxHeightGenerated": 24759094,
        "maxHeightPrevoted": 24759094
    }
}

generator_getAllKeys

Returns all keys.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "generator_getAllKeys",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "keys": []
    }
}

generator_getStatus

Returns the status for all the validator accounts.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "generator_getStatus",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "status": []
    }
}

generator_hasKeys

Used to check if an account has keys or not.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "generator_hasKeys",
    "params": {
        "address": "lskcjt7kexdqkb3yuezbpb7ba5ozwwnsyw7xggmm4"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "hasKey": false
    }
}

generator_setKeys

Used for setting keys of a validator account. The request can have either a plain key object or an encrypted one.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "generator_setKeys",
    "params": {
        "address": "lske5sqed53fdcs4m9et28f2k7u9fk6hno9bauday",
        "type": "plain",
        "data": {
            "generatorKey": "b9e54121e5346cc04cc84bcf286d5e40d586ba5d39571daf57bd31bac3861a4a",
            "generatorPrivateKey": "b3c4de7f7932275b7a465045e918337ffd7b7b229cef8eba28f706de8759da95b9e54121e5346cc04cc84bcf286d5e40d586ba5d39571daf57bd31bac3861a4a",
            "blsKey": "92f020ce5e37befb86493a82686b0eedddb264350b0873cf1eeaa1fefe39d938f05f272452c1ef5e6ceb4d9b23687e31",
            "blsPrivateKey": "463dd3413051366ee658c2524dd0bec85f8459bf6d70439685746406604f950d"
        }
    }
}

Example response: 200

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

generator_setStatus

Used for setting the status of a generator.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "generator_setStatus",
    "params": {
        "address": "lske5sqed53fdcs4m9et28f2k7u9fk6hno9bauday",
        "height": 243,
        "maxHeightPrevoted": 175,
        "maxHeightGenerated": 142
    }
}

Example response: 200

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

generator_updateStatus

Used to update the status of a generator.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "generator_updateStatus",
    "params": {
        "address": "lskcjt7kexdqkb3yuezbpb7ba5ozwwnsyw7xggmm4",
        "height": 243,
        "maxHeightPrevoted": 175,
        "maxHeightGenerated": 142,
        "enable": false,
        "password": "close royal weasel lock clown tape beyond same joke strong board screen allow humble decide final illegal silly bread tomato fold vocal wolf cool"
    }
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": "1",
    "error": {
        "message": "Generator with address: lskcjt7kexdqkb3yuezbpb7ba5ozwwnsyw7xggmm4 does not have keys registered.",
        "code": -32600
    }
}

legacy_getBlockByID

Returns legacy block based on the id passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "legacy_getBlockByID",
    "params": {
        "id": "525b8c2a02547656a76aba602746c04fc387dd032eeff0ff21aed3c8911678b7"
    }
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": "1",
    "error": {
        "message": "Specified key 626c6f636b733a69643a525bc28c2a02547656c2a76ac2ba602746c3804fc383c287c39d032ec3afc3b0c3bf21c2aec393c388c2911678c2b7 does not exist",
        "code": -32600
    }
}

legacy_getBlockByHeight

Returns legacy block based on the height passed.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "legacy_getBlockByHeight",
    "params": {
        "height": 24754279
    }
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": "1",
    "error": {
        "message": "Specified key 626c6f636b733a6865696768743a0179c2b867 does not exist",
        "code": -32600
    }
}

system_getNodeInfo

Returns information about the blockchain node.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "system_getNodeInfo",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "version": "4.0.6",
        "networkVersion": "5.0",
        "chainID": "00000000",
        "lastBlockID": "196130351afbba27595b46dd1f3c3e5e743221245a890adeb8d83bb98f1fbfbf",
        "height": 24754893,
        "finalizedHeight": 24754742,
        "syncing": false,
        "unconfirmedTransactions": 1,
        "genesisHeight": 23390992,
        "genesis": {
            "block": {
                "fromFile": "./config/genesis_block.blob"
            },
            "blockTime": 10,
            "bftBatchSize": 103,
            "maxTransactionsSize": 15360,
            "minimumCertifyHeight": 23461753,
            "chainID": "00000000"
        },
        "network": {
            "version": "5.0",
            "port": 8001,
            "seedPeers": [
                {
                    "ip": "mainnet-seed-01.lisk.com",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-02.lisk-nodes.net",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-03.lisk.com",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-04.lisk-nodes.net",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-05.lisk.com",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-06.lisk-nodes.net",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-07.lisk.com",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-08.lisk-nodes.net",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-09.lisk.com",
                    "port": 7667
                },
                {
                    "ip": "mainnet-seed-10.lisk-nodes.net",
                    "port": 7667
                }
            ]
        }
    }
}

system_getMetadata

Returns metadata about the blockchain node.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "system_getMetadata",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "modules": [
            {
                "commands": [
                    {
                        "name": "registerMultisignature",
                        "params": {
                            "$id": "/auth/command/regMultisig",
                            "type": "object",
                            "properties": {
                                "numberOfSignatures": {
                                    "dataType": "uint32",
                                    "fieldNumber": 1,
                                    "minimum": 1,
                                    "maximum": 64
                                },
                                "mandatoryKeys": {
                                    "type": "array",
                                    "items": {
                                        "dataType": "bytes",
                                        "minLength": 32,
                                        "maxLength": 32
                                    },
                                    "fieldNumber": 2,
                                    "minItems": 0,
                                    "maxItems": 64
                                },
                                "optionalKeys": {
                                    "type": "array",
                                    "items": {
                                        "dataType": "bytes",
                                        "minLength": 32,
                                        "maxLength": 32
                                    },
                                    "fieldNumber": 3,
                                    "minItems": 0,
                                    "maxItems": 64
                                },
                                "signatures": {
                                    "type": "array",
                                    "items": {
                                        "dataType": "bytes",
                                        "minLength": 64,
                                        "maxLength": 64
                                    },
                                    "fieldNumber": 4
                                }
                            },
...

system_getSchema

Returns the common schema used by the Lisk blockchain.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "system_getSchema",
    "params": {}
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "block": {
            "$id": "/block",
            "type": "object",
            "properties": {
                "header": {
                    "dataType": "bytes",
                    "fieldNumber": 1
                },
                "transactions": {
                    "type": "array",
                    "items": {
                        "dataType": "bytes"
                    },
                    "fieldNumber": 2
                },
                "assets": {
                    "type": "array",
                    "items": {
                        "dataType": "bytes"
                    },
                    "fieldNumber": 3
                }
            },
            "required": [
                "header",
                "transactions",
                "assets"
            ]
        },
        "header": {
            "$id": "/block/header/3/without-id",
            "type": "object",
            "properties": {
                "version": {
                    "dataType": "uint32",
                    "fieldNumber": 1
                },
                "timestamp": {
                    "dataType": "uint32",
                    "fieldNumber": 2
                },
                "height": {
                    "dataType": "uint32",
                    "fieldNumber": 3
                },
...

system_getMetricsReport

Returns the metrics report from the application.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "system_getMetricsReport",
    "params": {}
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": "1",
    "error": {
        "message": "metrics is not enabled",
        "code": -32600
    }
}

random_setHashOnion

Sets the hash onion of a validator.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "random_setHashOnion",
    "params": {
        "address": "lskdwsyfmcko6mcd357446yatromr9vzgu7eb8y99",
        "seed": "e025160dfc93688a01c96ab9f3e0a29e",
        "count": 10000,
        "distance": 1000
    }
}

Example response: 200

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

random_isSeedRevealValid

Checks whether the seedReveal of a particular validator is valid.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "random_isSeedRevealValid",
    "params": {
        "generatorAddress": "lskdwsyfmcko6mcd357446yatromr9vzgu7eb8y99",
        "seedReveal": "c0f96ff4416b6c9ff0f641527dec0a27"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "valid": true
    }
}

random_getHashOnionSeeds

Retrieves the hash onion seeds of a validator.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "random_getHashOnionSeeds",
    "params": {
        "address": "lskdwsyfmcko6mcd357446yatromr9vzgu7eb8y99"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "seeds": []
    }
}

random_hasHashOnion

Checks if a validator has a hash onion.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "random_hasHashOnion",
    "params": {
        "address": "lskdwsyfmcko6mcd357446yatromr9vzgu7eb8y99"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "hasSeed": false,
        "remaining": 0
    }
}

random_getHashOnionUsage

Returns the hash onion usage for a validator.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "random_getHashOnionUsage",
    "params": {
        "address": "lskdwsyfmcko6mcd357446yatromr9vzgu7eb8y99"
    }
}

Example response: 200

{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
        "usedHashOnions": [
            {
                "count": 0,
                "height": 0
            }
        ],
        "seed": "e025160dfc93688a01c96ab9f3e0a29e"
    }
}

random_setHashOnionUsage

Sets the hash onion usage for a validator.

Method: POST

https://lsk.nownodes.io/rpc

Example body (raw)

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "random_setHashOnionUsage",
    "params": {
        "address": "lskdwsyfmcko6mcd357446yatromr9vzgu7eb8y99",
        "usedHashOnions": [
            {
                "count": 10,
                "height": 100
            }
        ]
    }
}

Example response: 200

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

Last updated