Deprecate old and document new RPC APIs (#19456)
This commit is contained in:
parent
7d2031d23b
commit
355a23c8f6
|
@ -30,9 +30,7 @@ gives a convenient interface for the RPC methods.
|
||||||
- [getClusterNodes](jsonrpc-api.md#getclusternodes)
|
- [getClusterNodes](jsonrpc-api.md#getclusternodes)
|
||||||
- [getEpochInfo](jsonrpc-api.md#getepochinfo)
|
- [getEpochInfo](jsonrpc-api.md#getepochinfo)
|
||||||
- [getEpochSchedule](jsonrpc-api.md#getepochschedule)
|
- [getEpochSchedule](jsonrpc-api.md#getepochschedule)
|
||||||
- [getFeeCalculatorForBlockhash](jsonrpc-api.md#getfeecalculatorforblockhash)
|
- [getFeeForMessage](jsonrpc-api.md#getfeeformessage)
|
||||||
- [getFeeRateGovernor](jsonrpc-api.md#getfeerategovernor)
|
|
||||||
- [getFees](jsonrpc-api.md#getfees)
|
|
||||||
- [getFirstAvailableBlock](jsonrpc-api.md#getfirstavailableblock)
|
- [getFirstAvailableBlock](jsonrpc-api.md#getfirstavailableblock)
|
||||||
- [getGenesisHash](jsonrpc-api.md#getgenesishash)
|
- [getGenesisHash](jsonrpc-api.md#getgenesishash)
|
||||||
- [getHealth](jsonrpc-api.md#gethealth)
|
- [getHealth](jsonrpc-api.md#gethealth)
|
||||||
|
@ -41,13 +39,13 @@ gives a convenient interface for the RPC methods.
|
||||||
- [getInflationRate](jsonrpc-api.md#getinflationrate)
|
- [getInflationRate](jsonrpc-api.md#getinflationrate)
|
||||||
- [getInflationReward](jsonrpc-api.md#getinflationreward)
|
- [getInflationReward](jsonrpc-api.md#getinflationreward)
|
||||||
- [getLargestAccounts](jsonrpc-api.md#getlargestaccounts)
|
- [getLargestAccounts](jsonrpc-api.md#getlargestaccounts)
|
||||||
|
- [getLatestBlockhash](jsonrpc-api.md#getlatestblockhash)
|
||||||
- [getLeaderSchedule](jsonrpc-api.md#getleaderschedule)
|
- [getLeaderSchedule](jsonrpc-api.md#getleaderschedule)
|
||||||
- [getMaxRetransmitSlot](jsonrpc-api.md#getmaxretransmitslot)
|
- [getMaxRetransmitSlot](jsonrpc-api.md#getmaxretransmitslot)
|
||||||
- [getMaxShredInsertSlot](jsonrpc-api.md#getmaxshredinsertslot)
|
- [getMaxShredInsertSlot](jsonrpc-api.md#getmaxshredinsertslot)
|
||||||
- [getMinimumBalanceForRentExemption](jsonrpc-api.md#getminimumbalanceforrentexemption)
|
- [getMinimumBalanceForRentExemption](jsonrpc-api.md#getminimumbalanceforrentexemption)
|
||||||
- [getMultipleAccounts](jsonrpc-api.md#getmultipleaccounts)
|
- [getMultipleAccounts](jsonrpc-api.md#getmultipleaccounts)
|
||||||
- [getProgramAccounts](jsonrpc-api.md#getprogramaccounts)
|
- [getProgramAccounts](jsonrpc-api.md#getprogramaccounts)
|
||||||
- [getRecentBlockhash](jsonrpc-api.md#getrecentblockhash)
|
|
||||||
- [getRecentPerformanceSamples](jsonrpc-api.md#getrecentperformancesamples)
|
- [getRecentPerformanceSamples](jsonrpc-api.md#getrecentperformancesamples)
|
||||||
- [getSignaturesForAddress](jsonrpc-api.md#getsignaturesforaddress)
|
- [getSignaturesForAddress](jsonrpc-api.md#getsignaturesforaddress)
|
||||||
- [getSignatureStatuses](jsonrpc-api.md#getsignaturestatuses)
|
- [getSignatureStatuses](jsonrpc-api.md#getsignaturestatuses)
|
||||||
|
@ -66,6 +64,7 @@ gives a convenient interface for the RPC methods.
|
||||||
- [getTransactionCount](jsonrpc-api.md#gettransactioncount)
|
- [getTransactionCount](jsonrpc-api.md#gettransactioncount)
|
||||||
- [getVersion](jsonrpc-api.md#getversion)
|
- [getVersion](jsonrpc-api.md#getversion)
|
||||||
- [getVoteAccounts](jsonrpc-api.md#getvoteaccounts)
|
- [getVoteAccounts](jsonrpc-api.md#getvoteaccounts)
|
||||||
|
- [isBlockhashValid](jsonrpc-api.md#isblockhashvalid)
|
||||||
- [minimumLedgerSlot](jsonrpc-api.md#minimumledgerslot)
|
- [minimumLedgerSlot](jsonrpc-api.md#minimumledgerslot)
|
||||||
- [requestAirdrop](jsonrpc-api.md#requestairdrop)
|
- [requestAirdrop](jsonrpc-api.md#requestairdrop)
|
||||||
- [sendTransaction](jsonrpc-api.md#sendtransaction)
|
- [sendTransaction](jsonrpc-api.md#sendtransaction)
|
||||||
|
@ -97,7 +96,11 @@ Unstable methods may see breaking changes in patch releases and may not be suppo
|
||||||
- [getConfirmedBlocks](jsonrpc-api.md#getconfirmedblocks)
|
- [getConfirmedBlocks](jsonrpc-api.md#getconfirmedblocks)
|
||||||
- [getConfirmedBlocksWithLimit](jsonrpc-api.md#getconfirmedblockswithlimit)
|
- [getConfirmedBlocksWithLimit](jsonrpc-api.md#getconfirmedblockswithlimit)
|
||||||
- [getConfirmedSignaturesForAddress2](jsonrpc-api.md#getconfirmedsignaturesforaddress2)
|
- [getConfirmedSignaturesForAddress2](jsonrpc-api.md#getconfirmedsignaturesforaddress2)
|
||||||
- [getConfirmedTransaction](jsonrpc-api.md#getconfirmedtransaction)
|
- [getConfirmedTransaction](jsonrpc-api.md#getconfirmedtransact)
|
||||||
|
- [getFeeCalculatorForBlockhash](jsonrpc-api.md#getfeecalculatorforblockhash)
|
||||||
|
- [getFeeRateGovernor](jsonrpc-api.md#getfeerategovernor)
|
||||||
|
- [getFees](jsonrpc-api.md#getfees)
|
||||||
|
- [getRecentBlockhash](jsonrpc-api.md#getrecentblockhash)
|
||||||
|
|
||||||
## Request Formatting
|
## Request Formatting
|
||||||
|
|
||||||
|
@ -1139,6 +1142,47 @@ Result:
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### getFeeForMessage
|
||||||
|
|
||||||
|
Get the fee the network will charge for a particular Message
|
||||||
|
|
||||||
|
#### Parameters:
|
||||||
|
|
||||||
|
- `blockhash: <string>` - The blockhash of this block, as base-58 encoded string
|
||||||
|
- `message: <string>` - Encoded Message
|
||||||
|
- `encoding: <string>` - (optional) Encoding used for the message data. Either `"base58"` (*slow*, **DEPRECATED**), or `"base64"`. (default: `"base58"`).
|
||||||
|
- `<object>` - (optional) [Commitment](jsonrpc-api.md#configuring-state-commitment) (used for retrieving blockhash)
|
||||||
|
|
||||||
|
#### Results:
|
||||||
|
|
||||||
|
- `<u64>` - Fee corresponding to the message at the specified blockhash
|
||||||
|
|
||||||
|
#### Example:
|
||||||
|
|
||||||
|
Request:
|
||||||
|
```bash
|
||||||
|
curl http://localhost:8899 -X POST -H "Content-Type: application/json" -d '
|
||||||
|
{
|
||||||
|
"id":1,
|
||||||
|
"jsonrpc":"2.0",
|
||||||
|
"method":"getFeeForMessage",
|
||||||
|
"params":[
|
||||||
|
"FxVKTksYShgKjnFG3RQUEo2AEesDb4ZHGY3NGJ7KHd7F","AQABAgIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEBAQAA",
|
||||||
|
"base64",
|
||||||
|
{
|
||||||
|
"commitment":"processed"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
'
|
||||||
|
```
|
||||||
|
|
||||||
|
Result:
|
||||||
|
```json
|
||||||
|
{"jsonrpc":"2.0","result":{"context":{"slot":5068},"value":5000},"id":1}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### getFirstAvailableBlock
|
### getFirstAvailableBlock
|
||||||
|
|
||||||
Returns the slot of the lowest confirmed block that has not been purged from the ledger
|
Returns the slot of the lowest confirmed block that has not been purged from the ledger
|
||||||
|
@ -1523,6 +1567,55 @@ Result:
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### getLatestBlockhash
|
||||||
|
|
||||||
|
Returns the latest blockhash
|
||||||
|
|
||||||
|
#### Parameters:
|
||||||
|
|
||||||
|
- `<object>` - (optional) [Commitment](jsonrpc-api.md#configuring-state-commitment) (used for retrieving blockhash)
|
||||||
|
|
||||||
|
#### Results:
|
||||||
|
|
||||||
|
- `RpcResponse<object>` - RpcResponse JSON object with `value` field set to a JSON object including:
|
||||||
|
- `blockhash: <string>` - a Hash as base-58 encoded string
|
||||||
|
- `lastValidBlockHeight: u64` - Slot
|
||||||
|
|
||||||
|
#### Example:
|
||||||
|
|
||||||
|
Request:
|
||||||
|
```bash
|
||||||
|
curl http://localhost:8899 -X POST -H "Content-Type: application/json" -d '
|
||||||
|
{
|
||||||
|
"id":1,
|
||||||
|
"jsonrpc":"2.0",
|
||||||
|
"method":"getLatestBlockhash",
|
||||||
|
"params":[
|
||||||
|
{
|
||||||
|
"commitment":"processed"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
'
|
||||||
|
```
|
||||||
|
|
||||||
|
Result:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"jsonrpc":"2.0",
|
||||||
|
"result":{
|
||||||
|
"context":{
|
||||||
|
"slot":2792
|
||||||
|
},
|
||||||
|
"value":{
|
||||||
|
"blockhash":"EkSnNWid2cvwEVnVx9aBqawnmiCNiDgp3gUdkDPTKN1N",
|
||||||
|
"lastValidBlockHeight":3090
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"id":1
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
### getLeaderSchedule
|
### getLeaderSchedule
|
||||||
|
|
||||||
Returns the leader schedule for an epoch
|
Returns the leader schedule for an epoch
|
||||||
|
@ -3153,6 +3246,49 @@ Result:
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### isBlockhashValid
|
||||||
|
|
||||||
|
Returns whether a blockhash is still valid or not
|
||||||
|
|
||||||
|
#### Parameters:
|
||||||
|
|
||||||
|
- `blockhash: <string>` - the blockhash of this block, as base-58 encoded string
|
||||||
|
- `<object>` - (optional) [Commitment](jsonrpc-api.md#configuring-state-commitment) (used for retrieving blockhash)
|
||||||
|
|
||||||
|
#### Results:
|
||||||
|
|
||||||
|
- `<bool>` - True if the blockhash is still valid
|
||||||
|
|
||||||
|
#### Example:
|
||||||
|
|
||||||
|
Request:
|
||||||
|
```bash
|
||||||
|
curl http://localhost:8899 -X POST -H "Content-Type: application/json" -d '
|
||||||
|
{
|
||||||
|
"id":45,
|
||||||
|
"jsonrpc":"2.0",
|
||||||
|
"method":"isBlockhashValid",
|
||||||
|
"params":[
|
||||||
|
"J7rBdM6AecPDEZp8aPq5iPSNKVkU5Q76F3oAV4eW5wsW",
|
||||||
|
{"commitment":"processed"}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
'
|
||||||
|
```
|
||||||
|
|
||||||
|
Result:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"jsonrpc":"2.0",
|
||||||
|
"result":{
|
||||||
|
"context":{
|
||||||
|
"slot":2483
|
||||||
|
},
|
||||||
|
"value":false
|
||||||
|
},"id":1
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
### minimumLedgerSlot
|
### minimumLedgerSlot
|
||||||
|
|
||||||
Returns the lowest slot that the node has information about in its ledger. This
|
Returns the lowest slot that the node has information about in its ledger. This
|
||||||
|
|
Loading…
Reference in New Issue