Chia RPC API手册

FullNode Api
get_blockchain_state/查询区块链状态 get_block/查询指定区块 get_blocks/查询指定高度区间的区块 get_block_record_by_height/查询指定高度的区块记录 get_block_record/查询指定哈希的区块记录 get_block_records/查询指定高度区间的区块记录 get_unfinished_block_headers/查询未完成区块 get_network_space/查询网络总空间 get_additions_and_removals/查询添加和删除记录 get_initial_freeze_period/查询初始冻结期 get_network_info/查询网络信息 get_coin_records_by_puzzle_hash/查询指定哈希的coin记录 get_coin_record_by_name/查询指定名称的coin记录 push_tx/提交交易 get_all_mempool_tx_ids/返回内存池全部交易ID get_all_mempool_items/返回内存池全部交易 get_mempool_item_by_tx_id/返回内存池指定交易
Wallet Api
log_in/登录钱包 get_public_keys/查询根公钥 get_private_key/查询根私钥 generate_mnemonic/生成助记词 add_key/添加私钥 delete_key/删除私钥 delete_all_keys/删除全部私钥 get_sync_status/查询钱包同步状态 get_height_info/查询钱包高度信息 farm_block/模拟耕种区块 get_initial_freeze_period/查询初始冻结周期 get_network_info/查询网络信息 get_wallets/查询私钥地址 create_new_wallet/创建新钱包 get_wallet_balance/查询钱包余额 get_transaction/查询指定交易记录 get_transactions/查询交易记录 get_next_address/返回下一个地址 send_transaction/发送交易 create_backup/创建钱包备份 get_transaction_count/查询钱包交易数量 get_farmed_amount/查询奖励信息
Harvester Api
get_plots/查询全部绘图 refresh_plots/刷新绘图 delete_plot/删除绘图 add_plot_directory/添加绘图目录 get_plot_directories/查询绘图目录 remove_plot_directory/删除绘图目录
Farmer Api
get_signage_point/查询指定的signage点 get_signage_points/查询signage点清单 get_reward_targets/查询耕种目标地址 set_reward_targets/设置耕种目标地址
公共Api
get_connections/查询连接节点 open_connection/连接节点 close_connection/断开节点连接 stop_node/终止节点运行
在线工具推荐: Three.js AI纹理开发包 - YOLO合成数据生成器 - GLTF/GLB在线编辑 - 3D模型格式在线转换 - 可编程3D场景编辑器

get_block

get_block调用返回指定哈希的区块数据。

请求参数

  • header_hash:要查询的区块的哈希

响应结果

get_block调用返回一个JSON对象,其block字段包含了所查询区块的详细数据。

示例代码

请求:

curl --insecure --cert ~/.chia/mainnet/config/ssl/full_node/private_full_node.crt \
     --key ~/.chia/mainnet/config/ssl/full_node/private_full_node.key \
     -d '{"header_hash": "0xd780d22c7a87c9e01d98b49a0910f6701c3b95015741316b3fda042e5d7b81d2"}' \
     -H "Content-Type: application/json" \
     -X POST https://localhost:8555/get_block

响应结果:

{
    "block": {
        "challenge_chain_ip_proof": {
            "normalized_to_identity": true,
            "witness": "0x0100fd641357188b5e18f962148c1ceb8e0816c25c657cf0fd971c1a6ed528cea74529c585eef17df64fa2037b2ed1d3ba4035f7a6caad4e67ca7a41bed242e0e51ac603130ce5c7c6f5f3d22cad0d95403ab6619ef81076115248582f325bc90e0a0100",
            "witness_type": 0
        },
        "challenge_chain_sp_proof": {
            "normalized_to_identity": true,
            "witness": "0x030040c178e0d3470733621c74dde8614c0421d03ad2ce3bb7cad3616646e3762b35568fbae23139119f7affdc7201f45ee284cc76be6e341c795ccb5779cf102305a31bae2f870ea52c87fb0803a4493a2eb1a2cbbce7e467938cb73447edde2d1b0100",
            "witness_type": 0
        },
        "finished_sub_slots": [],
        "foliage": {
            "foliage_block_data": {
                "extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9",
                "farmer_reward_puzzle_hash": "0x3d8765d3a597ec1d99663f6c9816d915b9f68613ac94009884c4addaefcce6af",
                "pool_signature": "0x95bc50737062a206ed36172634a2cebcb8cf045d044969baabb8504c99668d160635452c31389d16714d5bd61fc46b081975aca7f36a9aa8323ef38d5c751b13cc01cd7dc04d979ea0dd82ab8ef394d49998cf2865d4411d5a05bcf4bb8f2627",
                "pool_target": {
                    "max_height": 0,
                    "puzzle_hash": "0xd23da14695a188ae5708dd152263c4db883eb27edeb936178d4d988b8f3ce5fc"
                },
                "unfinished_reward_block_hash": "0x72befeb88e0b6612e0c5ddc94bf6b64bb2097579d418aede6d6006951720ddb3"
            },
            "foliage_block_data_signature": "0xaa11b01a2bc6bd1d6cdf030b9699aa1ee30a5d318f1fafc66489b1d41d096500f4aaddea9eed4f44e853ad9905d421660a216242c0d39b8fca8ac69964d78d701731940d30d6645320cfa570a1679f5308941093118ba94c279e7158c37f6d37",
            "foliage_transaction_block_hash": "0x8a32059ed30637d342ad40a7324fdbd14d4060eb91ba381480e52bb249e34648",
            "foliage_transaction_block_signature": "0xafe1dbb908edd6b466115fbd9755f86462a36d94da5b94aa00c9f7708b6f8c5df7b877e813f87c9bbbdef691845414da10449d51a6ac8ef86c5befb4511a2b7da4c82a38a9e14b3d94b96c7219ee5abd930ecee202ba697d6d27a6a7f914d999",
            "prev_block_hash": "0xccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb",
            "reward_block_hash": "0xbdde7b5b2bc6025c07a9f5233d8eae167bea654146b272652262b362524c3e85"
        },
        "foliage_transaction_block": {
            "additions_root": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "filter_hash": "0x6e340b9cffb37a989ca544e6bb780a2c78901d3fb33738768511a30617afa01d",
            "prev_transaction_block_hash": "0xccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb",
            "removals_root": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "timestamp": 1616162474,
            "transactions_info_hash": "0x4d65bf0d9286451647b8bff948b0e8cf7ad57125958eb84d4d32a7cfde441e03"
        },
        "infused_challenge_chain_ip_proof": null,
        "reward_chain_block": {
            "challenge_chain_ip_vdf": {
                "challenge": "0xccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb",
                "number_of_iterations": 11798946,
                "output": {
                    "data": "0x0000dafd52467f3f66cf25c7de3e432188b9c3000b95a09170ace441a214cffc5fa65a39a66f11085fea9c7a121cf7f86a74142506b6d51d6036097bff862707185dbba577707c248f2fca5877337e56905879a2ee840d28860c50ebcacaaaf53a660100"
                }
            },
            "challenge_chain_sp_signature": "0x94ef18a3cb94e91b987eaab5e7d2ed33ca69598b2278c4bea87ac6ef0217842b9db79bb6906719f671971ab328d2a47709cea008e64e5099d563757b78c3ed8bb0f7757294eca643b08e7ab4410e5628037ddc4cf47f613fedfbfb97672d2b08",
            "challenge_chain_sp_vdf": {
                "challenge": "0xccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb",
                "number_of_iterations": 4194304,
                "output": {
                    "data": "0x0300445cbcaa176166d9a50b9699e9394be46766c8f6494a1a9afd95bb5dc652ee42101278ad7358baf4ae727e4f5a6f732e3a8c26d9d11365081275a6d4b36dda63a905baffdaebab3311d8d6e2f356edf3bb1cf90e5654e688869d66d1c60676440100"
                }
            },
            "height": 0,
            "infused_challenge_chain_ip_vdf": null,
            "is_transaction_block": true,
            "pos_ss_cc_challenge_hash": "0xccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb",
            "proof_of_space": {
                "challenge": "0xbd9c2a80bbb08c340c365a96af54d60319cc7695436e11b8b2a2f8cf147bc872",
                "plot_public_key": "0xa5288853edf400f6152f1e3c5fb9ee5055d4d9d02d79a35a00183b0064a8d9bb3571f04ee3cbc4432a7ce7413d5dacaa",
                "pool_contract_puzzle_hash": null,
                "pool_public_key": "0xa15afd4ef858cdc97769e61d79a0b03d5bf108d46f2bc47d7cd549ce43f350a121821a9834c0a68c267306718c2c2bf8",
                "proof": "0x8d7c7c7763847953a9b3e56d8145b8a712b2bc8116c0dfc2db7cbbf270ef253b8539877e992b32087f5a45c218acaf21a02d8ceded9d19fd67b74c6aa91a164e69d13ad99e0559ead07b7237809de00e8a412683e5acfa407675c09bac790d94ae40b5998c21f1522635dfaf235ad1b5853120f3876f6e0fab04d3945887063c78ab3e1babbd30da02a120f59511143411be53db3c8b40815ee8f82aee2863643540d524c8f7042cb4b63861da7f0e35e7ed41f97bd24b9d9294090bee1eb9a2410946048519772665a7f414f20776a5ca215d1af269e591e033e96c8611dda93a6e00d58929bd3a734f2886c273c55b70c2348689b19d5234d778a48620c79d",
                "size": 32
            },
            "reward_chain_ip_vdf": {
                "challenge": "0xccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb",
                "number_of_iterations": 11798946,
                "output": {
                    "data": "0x0000dafd52467f3f66cf25c7de3e432188b9c3000b95a09170ace441a214cffc5fa65a39a66f11085fea9c7a121cf7f86a74142506b6d51d6036097bff862707185dbba577707c248f2fca5877337e56905879a2ee840d28860c50ebcacaaaf53a660100"
                }
            },
            "reward_chain_sp_signature": "0x94ef18a3cb94e91b987eaab5e7d2ed33ca69598b2278c4bea87ac6ef0217842b9db79bb6906719f671971ab328d2a47709cea008e64e5099d563757b78c3ed8bb0f7757294eca643b08e7ab4410e5628037ddc4cf47f613fedfbfb97672d2b08",
            "reward_chain_sp_vdf": {
                "challenge": "0xccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb",
                "number_of_iterations": 4194304,
                "output": {
                    "data": "0x0300445cbcaa176166d9a50b9699e9394be46766c8f6494a1a9afd95bb5dc652ee42101278ad7358baf4ae727e4f5a6f732e3a8c26d9d11365081275a6d4b36dda63a905baffdaebab3311d8d6e2f356edf3bb1cf90e5654e688869d66d1c60676440100"
                }
            },
            "signage_point_index": 2,
            "total_iters": 11798946,
            "weight": 7
        },
        "reward_chain_ip_proof": {
            "normalized_to_identity": false,
            "witness": "0x0100069fef389d0cab01b732a1f9df5a613791a675c6d374a273815ac52456791f5b54990e239101092f8c9b1f10f00831b3081a8bacb4ed30a4f1a3b880985627231bde6dfab8a923543cf4a479c167a4efaa99bc757bed4ae8ce323ee425fd0a2301000000000000280230d9e99169933c68691769e36eafc2c5cd77643c5764ae881670d73ce5b6f354a5530100da6ad4bdeebea9ee562f5ecd75941b87b562ab3dfdb11f7ecc32a95da2b43860014153be21b70af27f78a24186be61eb7d3e1b8a45e4f7c92faa03d5427d432769726ffbad69c860cef51f0da30c18aa2b717612ea592de302be3278d950291b0100000000000078062c873f93d42f5aea24607ed244308cdbd7e7312bf6d0ed7d540d38ec6e643794862f0100e9794b47a84b25a60816aed4aef701c72188c5f7d5a44ed96a0e06a36b9a7915f3c38697fbb289a6fdafb2fa4c8169c4a7997f6a1b84a8f33219734cbeb50d2ef55570c7d06e3583acdbe993d8e521ce3211704eb316761ea8f94bb50cb9110a0100",
            "witness_type": 2
        },
        "reward_chain_sp_proof": {
            "normalized_to_identity": false,
            "witness": "0x0200b32e249915029b85ba7307fd4102d3352c52a30032d44639b2eb5d3a77497e269b9d9a9be91cd89d32a011a519c889a2f23ae1b08d56c99581afb57c29eed22a33ac88fd3f2075d7312ab4fe9b2ba3f7b714bc3b8d20ec0254d560819356eb40010000000000000e38a0a555927b04d5972453306cd46576785f0077db62f16adab830cd191ae3d1c63cf100000317fd6f5378f72c4ec504b2e460a9669de31dd1026e7dca756c67130a02a0ddf594a206ec70c9c6b06829608b3ccb1b3439a34ac99ac94eba7ef0730198387877ea6845834b56c13371c079b2201fd1e5e49cfe1fc716daeab329b55cbbb82c010000000000002aaaa8f5c834580070be7b0d3c5a49290b71ca8f8759d4beb423841c97f92b6b6409b02d030059b7199e86a68a9114d14ef44778600845068fe30d768acce03bfae6d0271a653f1317fe678e4e8546f76b2d9ce7cc52afdbd9fa6882ad916856f445e355937945ea840bd29058b8652404f8e5d3e13c78cfd2c5cd3fe9e6f404395d8e9b33800100",
            "witness_type": 2
        },
        "transactions_generator": null,
        "transactions_generator_ref_list": [],
        "transactions_info": {
            "aggregated_signature": "0xc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
            "cost": 0,
            "fees": 0,
            "generator_refs_root": "0x0101010101010101010101010101010101010101010101010101010101010101",
            "generator_root": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "reward_claims_incorporated": []
        }
    },
    "success": true
}