Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

远程RPC访问的method方法列表和params #70

Open
Amoroyang opened this issue Dec 25, 2019 · 1 comment
Open

远程RPC访问的method方法列表和params #70

Amoroyang opened this issue Dec 25, 2019 · 1 comment
Labels
question Further information is requested

Comments

@Amoroyang
Copy link

Amoroyang commented Dec 25, 2019

远程RPC访问的method方法列表和params,有文档吗?
目前只测试出一个方法curl -X POST
http://127.0.0.1:46657
-H 'Content-Type: application/json'
-d '{
"jsonrpc":"2.0",
"method":"info",
"params":[],
"id":"1"
}'

@needkane
Copy link
Member

你可以参照以下文档,不过近期我们打算重构整个RPC

介绍

众安链提供json_rpc 接口

访问json_rpc根路径,可以显示所有接口列表

接口列表

/core_version

查看众安链版本和运行的app版本

  • Method: GET
  • Example
curl http://127.0.0.1:46657/core_version
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        175,
            {
                "version":"f6e19e7d",
                "appname":"",
                "appversion":"alpha 0.2",
                "hash":""
            }
    ],
    "error":""
    
}

/dump_consensus_state

通过当前节点查看共识状态

  • Method: GET

  • Example

curl http://127.0.0.1:46657/dump_consensus_state
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        65,
        {
            "round_state":"RoundState
                    {
                        H:2640 
                        R:0 
                        S:RoundStepNewHeight
                        StartTime:2018-07-16 03:01:09.504559139 -0400 EDT m=+2140.159545756
                        CommitTime:2018-07-16 03:01:08.504559139 -0400 EDT m=+2139.159545756
                        Validators: ValidatorSet
                        {
                            Proposer: Validator
                            {
                                3BEEE425C4A5CE5C82BB33B3768AED456E090A5C 
                                PubKeyEd25519
                                {
                                    3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7
                                    
                                } 
                                VP:100 
                                A:0 
                                CA:true
                                
                            }
                            Validators:Validator
                            {
                                3BEEE425C4A5CE5C82BB33B3768AED456E090A5C 
                                PubKeyEd25519
                                {
                                    3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7
                                    
                                } 
                                VP:100 
                                A:0 
                                CA:true
                                
                            }
                        }  
                        Proposal:      \u003cnil\u003e\n  
                        ProposalBlock: nil-PartSet nil-Block\n  
                        LockedRound:   0\n  
                        LockedBlock:   nil-PartSet nil-Block\n  
                        Votes:  HeightVoteSet
                        {
                            H:2640 
                            R:0~0\n      
                            VoteSet
                                {
                                    H:2640 
                                    R:0 
                                    T:1 +2/3:\u003cnil\u003e BA
                                        {
                                            1:_
                                            
                                        } 
                                        map[]
                                    
                                }\n      
                            VoteSet
                                {
                                    H:2640 
                                    R:0 
                                    T:2 +2/3:\u003cnil\u003e BA
                                        {
                                            1:_
                                            
                                        } 
                                        map[]
                                    
                                }\n    
                            
                        }\n  
                        LastCommit: VoteSet
                            {
                                H:2639 
                                R:0 T:2 +2/3:63E2F5305DC9A7432F5EB4C3E2957590571BBE90:1:1FAFA258E472 BA
                                    {   
                                        1:X
                                        
                                    } 
                                    map[]
                                
                            }\n  
                            LastValidators:    ValidatorSet
                            {
                                Proposer: Validator
                                {
                                    3BEEE425C4A5CE5C82BB33B3768AED456E090A5C PubKeyEd25519
                                    {
                                        3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7
                                        
                                    } 
                                    VP:100 
                                    A:0 
                                    CA:true
                                    
                                }\n      
                                Validators:\n        
                                Validator
                                {
                                    3BEEE425C4A5CE5C82BB33B3768AED456E090A5C PubKeyEd25519
                                    {
                                        3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7
                                        
                                    } 
                                    VP:100 
                                    A:0 
                                    CA:true
                                    
                                }\n    
                                
                            }\n
                        
                    }",
                "peer_round_states":[]
            
        }
    ],
    "error":""
    
}

/genesis

查看创世文件内容

  • Method: GET
  • Example
curl http://127.0.0.1:46657/genesis
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        1,
            {
                "genesis":
                {
                    "genesis_time":"2018-07-13T06:44:38.885Z",
                    "chain_id":"rendez-jWjhVn",
                    "validators":[
                        {
                            "pub_key":[
                                1,
                                "3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7"
                                ],
                            "amount":100,
                            "name":"",
                            "is_ca":true,
                            "rpc":""
                            
                        }
                    ],
                    "app_hash":"",
                    "plugins":"specialop,querycache"
                    
                }
                
            }
        ],
        "error":""
    
}

/healthinfo

查看当前节点的健康状态

  • Method: GET

  • Response Body

    • status - 200表示正常,非200则异常
  • Example

curl http://127.0.0.1:46657/healthinfo
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        5,
        {
            "status":200
            
        }
    ],
    "error":""
}

/info

获取运行的app相关信息

  • Method: GET
  • Example
curl http://127.0.0.1:46657/info
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        113,
        {
            "data":"default app with evm-1.5.9",
            "version":"alpha 0.2",
            "last_block_height":2160,
            "last_block_app_hash":"56E81F171BCC55A6FF8345E692C0F86E5B48E01B996CADC001622FB5E363B421"
            
        }
    ],
    "error":""
    
}

/last_height

查看节点最新高度

  • Method: GET

  • Example

curl http://127.0.0.1:46657/last_height
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        4,
        {
            "last_height":2273
            
        }
    ],
    "error":""
    
}

/net_info

查看网络信息

  • Method: GET
  • Example
curl http://127.0.0.1:46657/net_info
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        33,
        {
            "listening":true,
            "listeners":[
                "Listener(@192.168.126.215:46656)"
            ],
            "peers":[]
            
        }
    ],
    "error":""
    
}

/num_archived_blocks

查看已归档的数据块个数

  • Method: GET
  • Example
curl http://127.0.0.1:46657/num_archived_blocks
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        100,
        {
            "num":0
            
        }
    ],
    "error":""
    
}

/num_unconfirmed_txs

查看未确认的交易数量

  • Method: GET
  • Example
curl http://127.0.0.1:46657/num_unconfirmed_txs
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        97,
        {
            "n_txs":0,
            "txs":[]
            
        }
    ],
    "error":""
    
}

/status

查看当前链状态,包括节点信息、最新块高度和哈希、运行的app 哈希

  • Method: GET
  • Example
curl http://127.0.0.1:46657/status
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        32,
        {
            "node_info":{
                "pub_key":[
                    1,
                    "3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7"
                ],
                "signd_pub_key":"",
                "moniker":"anonymous",
                "network":"rendez-jWjhVn",
                "remote_addr":"tcp://0.0.0.0:46657",
                "listen_addr":"192.168.126.215:46656",
                "version":"0.9.0",
                "other":[
                    "wire_version=0.6.0",
                    "p2p_version=0.3.5",
                    "node_start_at=1531722329","revision=f6e19e7d"
                ]
                
            },
            "pub_key":[
                1,
                "3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7"
            ],
            "latest_block_hash":"EF37EB8D5527C2440978D4651A57BB77759BD467",
            "latest_app_hash":"56E81F171BCC55A6FF8345E692C0F86E5B48E01B996CADC001622FB5E363B421",
            "latest_block_height":3388,
            "latest_block_time":1531725230461000000
            
        }
    ],
    "error":""
    
}

/unconfirmed_txs

查看未确认的交易列表

  • Method: GET
  • Example
curl http://127.0.0.1:46657/unconfirmed_txs
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        97,
        {
            "n_txs":0,
            "txs":[]
            
        }
    ],
    "error":""
    
}

/unsafe_flush_mempool

查看刷新mempool后的结果

  • Method: GET
  • Example
curl http://127.0.0.1:46657/unsafe_flush_mempool
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        164,
        {}
    ],
    "error":""
    
}

/validators

查看validator列表

  • Method: GET
  • Example
curl http://127.0.0.1:46657/validators
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        64,
        {
            "block_height":3684,
            "validators":[
                {
                    "address":"3BEEE425C4A5CE5C82BB33B3768AED456E090A5C",
                    "pub_key":[
                        1,
                        "3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7"
                    ],
                    "voting_power":100,
                    "accum":0,
                    "is_ca":true
                    
                }
            ]
            
        }
    ],
    "error":""
    
}

/za_surveillance

查看当前链运行状态,包括节点个数、validator个数、运行时长

  • Method: GET
  • Example
curl http://127.0.0.1:46657/za_surveillance
{
    "jsonrpc":"2.0",
    "id":"",
    "result":[
        144,
        {
            "NanoSecsPerTx":0,
            "Height":3813,
            "Addr":"tcp://0.0.0.0:46657",
            "IsValidator":true,
            "NumValidators":1,
            "NumPeers":0,
            "RunningTime":3334,
            "PubKey":"3C80281B26B48BB8BD3A24396C090E444616D169C15DDA32CAD7D4AD6E936DB7"
            
        }
    ],
    "error":""

}

/block?height=[heigth]

通过块高度查看对应块信息

  • Method: GET
  • Request Parameter
    • height:块高度值
  • Example
curl http://127.0.0.1:46657/block?height=6

/blockchain?minHeight=[min]&maxHeight=[max]

查看一定范围内的区块列表

  • Method: GET
  • Request Parameter
    • min:查询范围的最小值
    • max:查询范围的最大值
  • Example
curl http://127.0.0.1:46657/blockchain?minHeight=1&maxHeight=6

/broadcast_tx_async?tx=[tx]

广播异步交易

  • Method: GET

/broadcast_tx_commit

广播同步交易

  • Method: POST
  • Example
curl -X POST -d '
    {
        "jsonrpc":"2.0",
        "id":"",
        "method":"broadcast_tx_commit",
        "params":[
            "F904AE8080843B9ACA008080B9045F608060405233600260006101000A81548173FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF021916908373FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF16021790555034801561005157600080FD5B5060405160208061043F8339810180604052810190808051906020019092919050505080600160006101000A81548173FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF021916908373FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1602179055505061037A806100C56000396000F300608060405260043610610062576000357C0100000000000000000000000000000000000000000000000000000000900463FFFFFFFF1680631135E96E14610067578063725F4FA7146100BE578063E5841A16146100E9578063FF51AFC914610116575B600080FD5B34801561007357600080FD5B5061007C61016D565B604051808273FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1673FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF16815260200191505060405180910390F35B3480156100CA57600080FD5B506100D3610197565B6040518082815260200191505060405180910390F35B3480156100F557600080FD5B506101146004803603810190808035906020019092919050505061029A565B005B34801561012257600080FD5B5061012B610346565B604051808273FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1673FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF16815260200191505060405180910390F35B6000600160009054906101000A900473FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF16905090565B6000600160009054906101000A900473FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1673FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1663E4624D456040518163FFFFFFFF167C0100000000000000000000000000000000000000000000000000000000028152600401602060405180830381600087803B15801561021F57600080FD5B505AF1158015610233573D6000803E3D6000FD5B505050506040513D602081101561024957600080FD5B8101908080519060200190929190505050600081905550600080541415610292577FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF6000819055505B600054905090565B600160009054906101000A900473FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1673FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1663F2D9A532826040518263FFFFFFFF167C010000000000000000000000000000000000000000000000000000000002815260040180828152602001915050600060405180830381600087803B15801561032B57600080FD5B505AF115801561033F573D6000803E3D6000FD5B5050505050565B6000339050905600A165627A7A7230582040DFD277CCB2611F09FA2E92AA99AA3F8DF86FCC499CC9070EB568A3B812A7260029000000000000000000000000A8B702CCF5157F7446325A4222A7DD2564D8A5421CA0ECE3EC33698F01E2AA28B6A447F9BD12DAD38F20CC4EA635021473163245E73AA01B696E8DF4DCD371F8F4651DFB8F0FAA8559B9EB57B8C12D26F71F49003B7641"
            ]
        
    }'
    http://127.0.0.1:46657

/query

查看运行的app信息

  • Method: POST
  • Example
curl -X POST -d '{"jsonrpc":"2.0","id":"","method":"query","params":["01F21D46A76D8E4CFC61BE99E58178C6DD17AAF627"]}' http://127.0.0.1:46657
{
    "isSuccess":true,
    "result":"0"
    
}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
question Further information is requested
Projects
None yet
Development

No branches or pull requests

2 participants