diff --git a/docs/api/http.md b/docs/api/http.md index 40143162..f3e236c5 100644 --- a/docs/api/http.md +++ b/docs/api/http.md @@ -1369,6 +1369,7 @@ The following are voting and SR related APIs: - [wallet/createwitness](#walletcreatewitness) - [wallet/updatewitness](#walletupdatewitness) - [wallet/listwitnesses](#walletlistwitnesses) +- [wallet/getpaginatednowwitnesslist](#walletgetpaginatednowwitnesslist) - [wallet/withdrawbalance](#walletwithdrawbalance) - [wallet/votewitnessaccount](#walletvotewitnessaccount) - [wallet/getBrokerage](#walletgetbrokerage) @@ -1418,6 +1419,23 @@ Parameter: None Return Value: A list of all Super Representative information. +#### wallet/getpaginatednowwitnesslist +Description: Query the real-time vote count of each witness and return a paginated list of witnesses, sorted by real-time vote count in descending order. +``` +curl -X POST http://127.0.0.1:8090/wallet/getpaginatednowwitnesslist -d '{ + "offset": 0, + "limit": 100, + "visible": true +}' +``` +Parameters: + +* `offset`: `long` type, indicates the starting index, must be `>=0`. +* `limit`: `long` type, indicates the number of witnesses to return, must be `>0`, with an upper limit of system constant `1000`. +* `visible`: `boolean` type, optional parameter, defaults to false, controls the format of the returned address. + +Return value: A paginated list of witnesses meeting the parameter conditions, sorted by real-time vote count in descending order. + #### wallet/withdrawbalance Description:** SR or users withdraw rewards to their balance. This can be done once every 24 hours. @@ -2042,6 +2060,23 @@ Parameter: None Return Value: A list of all witness information. +#### walletsolidity/getpaginatednowwitnesslist +Description: Query the real-time vote count of each witness and return a paginated list of witnesses, sorted by real-time vote count in descending order. +``` +curl -X POST http://127.0.0.1:8091/wallet/getpaginatednowwitnesslist -d '{ + "offset": 0, + "limit": 100, + "visible": true +}' +``` +Parameters: + +* `offset`: `long` type, indicates the starting index, must be `>=0`. +* `limit`: `long` type, indicates the number of witnesses to return, must be `>0`, with an upper limit of system constant `1000`. +* `visible`: `boolean` type, optional parameter, defaults to false, controls the format of the returned address. + +Return value: A paginated list of witnesses meeting the parameter conditions, sorted by real-time vote count in descending order. + ### TRC-10 Token #### walletsolidity/getassetissuelist diff --git a/docs/api/json-rpc.md b/docs/api/json-rpc.md index eca10d03..0b630a6d 100644 --- a/docs/api/json-rpc.md +++ b/docs/api/json-rpc.md @@ -940,6 +940,41 @@ Result ``` +### eth_getBlockReceipts + +*Returns transaction receipts for all transactions in the specified block. Returns null for the genesis block, blocks that have been pruned by light nodes, or blocks that have not yet been produced.* + +**Parameters** + +String - block number, it supports three types: block number represented as hexadecimal string, blockHash (with or without the "0x" prefix), or tags ("latest", "earliest", "finalized"). + +**Returns** + +An array of objects - An array of transaction receipt objects, each object matches the return value of [eth_getTransactionReceipt](#eth_gettransactionreceipt) + +**Example** + +```curl + +curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{ + + "jsonrpc": "2.0", + + "method": "eth_getBlockReceipts", + + "params": ["0x5416c22"], + + "id": 64 + +}' + +``` + +Result + +```json + {"jsonrpc":"2.0","id":1,"result":null} +``` ### eth_getWork diff --git a/docs/api/rpc.md b/docs/api/rpc.md index 7c2c25a1..38039650 100644 --- a/docs/api/rpc.md +++ b/docs/api/rpc.md @@ -79,6 +79,12 @@ rpc ListWitnesses (EmptyMessage) returns (WitnessList) {} ``` Nodes: FullNode and SolidityNode +## Get the paged list of witnesses in descending order by real-time vote count +```protobuf +rpc GetPaginatedNowWitnessList (PaginatedMessage) returns (WitnessList) {} +``` +Nodes: FullNode + ## Application for super representative ```protobuf rpc CreateWitness (WitnessCreateContract) returns (Transaction) {}