Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions docs/api/http.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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 in descending order by real-time vote count.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line 1423
Description: Query the real-time vote count of each witness and return a paginated list of witnesses, sorted in descending order by real-time vote count.
->
Description: Queries real-time vote counts and returns a paginated list of witnesses, sorted by 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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

line 1435
'visible': 'boolean' type, optional parameter, defaults to false, controls the format of the returned address.
->
'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 in descending order by real-time vote count.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line 1437
Return value: A paginated list of witnesses meeting the parameter conditions, sorted in descending order by real-time vote count.
->
Return value: A paginated list of witnesses, 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.

Expand Down Expand Up @@ -2042,6 +2060,23 @@ Parameter: None

Return Value: A list of all witness information.

#### wallet/getpaginatednowwitnesslist
Description: Query the real-time vote count of each witness and return a paginated list of witnesses, sorted in descending order by real-time vote count.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line 2064
Description: Query the real-time vote count of each witness and return a paginated list of witnesses, sorted in descending order by real-time vote count.
->
Description: Queries real-time vote counts and returns a paginated list of witnesses, sorted by 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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

line 2076
'visible': 'boolean' type, optional parameter, defaults to false, controls the format of the returned address.
->
'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 in descending order by real-time vote count.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line 2078
Return value: A paginated list of witnesses meeting the parameter conditions, sorted in descending order by real-time vote count.
->
Return value: A paginated list of witnesses, sorted by real-time vote count in descending order.


### TRC-10 Token

#### walletsolidity/getassetissuelist
Expand Down
35 changes: 35 additions & 0 deletions docs/api/json-rpc.md
Original file line number Diff line number Diff line change
Expand Up @@ -940,6 +940,41 @@ Result

```

### eth_getBlockReceipts

*Return the transaction receipts for all transactions in the specified block. For the genesis block, blocks that have been pruned by light nodes, and blocks that have not yet been produced, it returns null.*

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line 945
Return the transaction receipts for all transactions in the specified block. For the genesis block, blocks that have been pruned by light nodes, and blocks that have not yet been produced, it returns null.
->
Returns transaction receipts for all transactions in the specified block. Returns null for the genesis block, blocks 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").
Copy link

@GordonLtron GordonLtron Dec 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

String - block number, -> String - Block identifier.
block number -> a block number
hexadecimal string -> a hexadecimal string


**Returns**

An array of objects - An array of transaction receipt objects, the object is the same as the return value of [eth_getTransactionReceipt](#eth_gettransactionreceipt)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

An array of transaction receipt objects, -> .
the object is the same as -> Each object matches


**Example**

```curl

curl -X POST 'https://api.shasta.trongrid.io/jsonrpc' --data '{

"jsonrpc": "2.0",

"method": "eth_getBlockReceipts",

"params": ["0x377a8a2"],

"id": 64

}'

```

Result

```json

```

### eth_getWork

Expand Down
6 changes: 6 additions & 0 deletions docs/api/rpc.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link

@GordonLtron GordonLtron Dec 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line 82
( Get the paged list of witnesses info, sorted in descending order by real-time vote count. )
->
( Get a paginated list of witness information, sorted by real-time vote count in descending order. )


Follow the format using beforehand ( Paginated Now Witness List ) is better

```protobuf
rpc GetPaginatedNowWitnessList (PaginatedMessage) returns (WitnessList) {}
```
Nodes: FullNode

## Application for super representative
```protobuf
rpc CreateWitness (WitnessCreateContract) returns (Transaction) {}
Expand Down