From 7982b4b68dfcc295e5892e424db3fc2489b54ccd Mon Sep 17 00:00:00 2001 From: Leem Date: Mon, 15 Dec 2025 13:00:53 +0800 Subject: [PATCH 1/4] change in 4.8.1 of api --- docs/api/http.md | 41 +++++++++++++++++++++++++++++++++++++++-- docs/api/json-rpc.md | 36 ++++++++++++++++++++++++++++++++++++ docs/api/rpc.md | 6 ++++++ 3 files changed, 81 insertions(+), 2 deletions(-) diff --git a/docs/api/http.md b/docs/api/http.md index 8c37016b..1c84ea81 100644 --- a/docs/api/http.md +++ b/docs/api/http.md @@ -1333,6 +1333,7 @@ curl -X POST http://127.0.0.1:8090/wallet/updateasset -d '{ - [wallet/createwitness](#walletcreatewitness) - [wallet/updatewitness](#walletupdatewitness) - [wallet/listwitnesses](#walletlistwitnesses) +- [wallet/getpaginatednowwitnesslist](#walletgetpaginatednowwitnesslist) - [wallet/withdrawbalance](#walletwithdrawbalance) - [wallet/votewitnessaccount](#walletvotewitnessaccount) - [wallet/getBrokerage](#walletgetbrokerage) @@ -1382,6 +1383,23 @@ curl -X POST http://127.0.0.1:8090/wallet/listwitnesses 返回值：返回所有 SR 信息列表。 +#### wallet/getpaginatednowwitnesslist +作用：查询各个witness的实时得票数量并按得票数量的降序返回witness分页列表 +``` +curl -X POST http://127.0.0.1:8090/wallet/getpaginatednowwitnesslist -d '{ + "offset": 0, + "limit": 100, + "visible": true +}' +``` +参数： + +- `offset`：`long`型，表示起始下标，要求`>=0` +- `limit`：`long`型，表示返回的witness数，要求`>0` ，上限为系统常量`1000` +- `visible`： `boolean`型，可选参数，默认为false，控制返回的地址格式 + +返回值：满足参数条件的witness分页列表，按实时得票数量降序排序 + #### wallet/withdrawbalance 作用：超级代表或者用户提取奖励到 balance，每 24 个小时可以提现一次。 @@ -1975,7 +1993,7 @@ curl -X POST http://127.0.0.1:8090/walletsolidity/getdelegatedresourceaccountind 返回值： - 该接口返回一个包含双向代理关系列表的JSON对象。包含两个列表，一个是该帐户将资源委托给的地址列表(toAddress)，另一个是将资源委托给该帐户的地址列表(fromAddress) -### 投票和SR +### 投票和超级代表 #### walletsolidity/listwitnesses 作用：查询当前的所有 SR 列表。 @@ -1986,7 +2004,26 @@ curl -X POST http://127.0.0.1:8091/walletsolidity/listwitnesses 返回值：返回所有 SR 信息列表。 -### TRC10 通证 + +#### wallet/getpaginatednowwitnesslist +作用：查询各个witness的实时得票数量并按得票数量的降序返回witness分页列表 +``` +curl -X POST http://127.0.0.1:8091/walletsolidity/getpaginatednowwitnesslist -d '{ + "offset": 0, + "limit": 100, + "visible": true +}' +``` +参数： + +- `offset`：`long`型，表示起始下标，要求`>=0` +- `limit`：`long`型，表示返回的witness数，要求`>0` ，上限为系统常量`1000` +- `visible`： `boolean`型，可选参数，默认为false，控制返回的地址格式 + +返回值：满足参数条件的witness分页列表，按实时得票数量降序排序 + + +### TRC-10通证 #### walletsolidity/getassetissuelist 作用：查询所有Token列表 diff --git a/docs/api/json-rpc.md b/docs/api/json-rpc.md index 9fc85bca..5e457609 100644 --- a/docs/api/json-rpc.md +++ b/docs/api/json-rpc.md @@ -938,6 +938,42 @@ curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{ ``` +### eth_getBlockReceipts + +*通过`blockNumber`查询指定区块中的所有交易收据（Transaction Receipts）。对于创世块，轻节点已经裁剪的块和未生产的块返回`null`。* + +**参数** + +String - `blockNumber`：支持十六进制字符串表示的区块号、blockHash(有无0x开头均支持)或标签（ "latest"、"earliest"、"finalized"）三种类型 + +**返回值** + +An array of objects - 交易收据对象的数组，交易收据对象同[eth_getTransactionReceipt](#eth_gettransactionreceipt)的返回值 + +**示例** + +```curl + +curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{ + + "jsonrpc": "2.0", + + "method": "eth_getBlockReceipts", + + "params": ["0x377a8a2"], + + "id": 64 + +}' + +``` + +结果 + +```json + +``` + ### eth_getWork diff --git a/docs/api/rpc.md b/docs/api/rpc.md index f0af4b59..86d561d7 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 info, sorted 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) {} From 16335ff9b21cc5c985555eccfb4c543a13bbd2bb Mon Sep 17 00:00:00 2001 From: Leem Date: Mon, 15 Dec 2025 14:29:30 +0800 Subject: [PATCH 2/4] Simplify the description of the GetPaginatedNowWitnessList api --- docs/api/rpc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/rpc.md b/docs/api/rpc.md index 86d561d7..f29ed952 100644 --- a/docs/api/rpc.md +++ b/docs/api/rpc.md @@ -79,7 +79,7 @@ rpc ListWitnesses (EmptyMessage) returns (WitnessList) {} ``` Nodes: FullNode and SolidityNode -## Get the paged list of witnesses info, sorted in descending order by real-time vote count. +## Get the paged list of witnesses in descending order by real-time vote count ```protobuf rpc GetPaginatedNowWitnessList (PaginatedMessage) returns (WitnessList) {} ``` From 57497c5141c307dcb06d46a98ae590c48b466799 Mon Sep 17 00:00:00 2001 From: Leem Date: Mon, 15 Dec 2025 15:06:31 +0800 Subject: [PATCH 3/4] =?UTF-8?q?=E7=BB=99=E4=BA=86=E4=B8=AA=E8=BF=94?= =?UTF-8?q?=E5=9B=9E=E5=80=BC=E6=98=AFnull=E7=9A=84=E4=BE=8B=E5=AD=90?= =?UTF-8?q?=EF=BC=9B=E7=AD=894.8.1=E5=9C=A8shasta=E4=B8=8A=E7=BA=BF?= =?UTF-8?q?=E4=B9=8B=E5=90=8E=EF=BC=8C=E9=87=8D=E6=96=B0=E7=BB=99=E4=B8=80?= =?UTF-8?q?=E4=B8=AA=E8=BF=94=E5=9B=9E=E5=80=BC=E9=9D=9Enull=E7=9A=84?= =?UTF-8?q?=E4=BE=8B=E5=AD=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/json-rpc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api/json-rpc.md b/docs/api/json-rpc.md index 5e457609..57d8aaf5 100644 --- a/docs/api/json-rpc.md +++ b/docs/api/json-rpc.md @@ -960,7 +960,7 @@ curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{ "method": "eth_getBlockReceipts", - "params": ["0x377a8a2"], + "params": ["0x5416c22"], "id": 64 @@ -971,7 +971,7 @@ curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{ 结果 ```json - +{"jsonrpc":"2.0","id":64,"result":null} ``` From a477f25cda75f19087bdfe49a76ac438dac1ebad Mon Sep 17 00:00:00 2001 From: Leem Date: Mon, 15 Dec 2025 17:36:45 +0800 Subject: [PATCH 4/4] should be a solidity api --- docs/api/http.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/http.md b/docs/api/http.md index 1c84ea81..a701dd12 100644 --- a/docs/api/http.md +++ b/docs/api/http.md @@ -2005,7 +2005,7 @@ curl -X POST http://127.0.0.1:8091/walletsolidity/listwitnesses 返回值：返回所有 SR 信息列表。 -#### wallet/getpaginatednowwitnesslist +#### walletsolidity/getpaginatednowwitnesslist 作用：查询各个witness的实时得票数量并按得票数量的降序返回witness分页列表 ``` curl -X POST http://127.0.0.1:8091/walletsolidity/getpaginatednowwitnesslist -d '{