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_blockchain_state

get_blockchain_state返回区块链的当前信息,包括峰值、同步信息、难度、内存池大小等等。

请求参数

响应结果

get_blockchain_state调用返回一个JSON对象,其blockchain_state字段包含了区块链的 当前状态数据。

示例代码

请求:

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 '{"":""}' -H "Content-Type: application/json" \
     -X POST https://localhost:8555/get_blockchain_state

响应:

{
    "blockchain_state": {
        "difficulty": 20,
        "genesis_challenge_initialized": true,
        "mempool_size": 0,
        "peak": {
            "challenge_block_info_hash": "0x1145fc6914b8eaa5e13dea570e45926d0d2667bddec0921f0b34a3285d029f8b",
            "challenge_vdf_output": {
                "data": "0x0100d006028bb46edf6c72ff633870f7fea2e18b3aac538bbb92ceb12c3ff235407ec8ed323f0d8b505bac8e576322a6ddd92e6b9def8ca587196e76ef7aef01b3184dc87695e42731e64df85a84611f2b717ad7ca030e6fb19e2a8eb2eb4595db030200"
            },
            "deficit": 15,
            "farmer_puzzle_hash": "0x562469d301d49d306ee6aec4a680171f4590b5f4a1ae920f782abe7557b51c94",
            "fees": 0,
            "finished_challenge_slot_hashes": [
                "0xd80b5ab28a3c219019b65e80d9150525bc6baf6b1a60118264210833fbfaedfc"
            ],
            "finished_infused_challenge_slot_hashes": [
                "0x8824efc5d30caf5d465ead1100ac6830692d2f749bbe5ddfaf24566183562a63"
            ],
            "finished_reward_slot_hashes": [
                "0xa1a60027906da23c8386acda82afd9935d332a3aed199711915e11e46018f7d3"
            ],
            "header_hash": "0x36c15c1bf22e0d9b84f40f4eaf8070ec0b10a00e40d6fab2d31544bcc78bc561",
            "height": 123029,
            "infused_challenge_vdf_output": null,
            "overflow": false,
            "pool_puzzle_hash": "0x562469d301d49d306ee6aec4a680171f4590b5f4a1ae920f782abe7557b51c94",
            "prev_hash": "0xe9aa0c40ac529bbfd258ff7c457860a99dac6afcdbb4ffb3da8f2290d377271e",
            "prev_transaction_block_hash": "0xe9aa0c40ac529bbfd258ff7c457860a99dac6afcdbb4ffb3da8f2290d377271e",
            "prev_transaction_block_height": 123028,
            "required_iters": 1079116,
            "reward_claims_incorporated": [
                {
                    "amount": 1750000000000,
                    "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000001e094",
                    "puzzle_hash": "0x3c32c6b636535e39e37e0218e7206c66806803c7ea724eda48aff17eb5ec6081"
                },
                {
                    "amount": 250000000000,
                    "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb0000000000000000000000000001e094",
                    "puzzle_hash": "0x3c32c6b636535e39e37e0218e7206c66806803c7ea724eda48aff17eb5ec6081"
                }
            ],
            "reward_infusion_new_challenge": "0x6e5dcf6ae0ef350b38e02ab7f911f0834a76e87d5598a851afda9c967db47c65",
            "signage_point_index": 4,
            "sub_epoch_summary_included": null,
            "sub_slot_iters": 1216371183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb"
        ],4816,
            "timestamp": 1618304972,
            "total_iters": 410719057740,
            "weight": 1511211
        },
        "space": 339652100035216512,
        "sub_slot_iters": 121634816,
        "sync": {
            "sync_mode": false,
            "sync_progress_height": 0,
            "sync_tip_height": 0,
            "synced": true
        }
    },
    "success": true
}