Skip to content

Commit 9148705

Browse files
authored
new refund data methods (#624)
1 parent 3f68e1a commit 9148705

File tree

1 file changed

+37
-1
lines changed

1 file changed

+37
-1
lines changed

docs/flashbots-auction/advanced/rpc-endpoint.mdx

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -867,7 +867,7 @@ The response contains three fields:
867867

868868
### flashbots_getFeeRefundsByRecipient
869869

870-
The `flashbots_getFeeRefundsByRecipient` JSON-RPC method returns detailed information about [fee refunds](/flashbots-protect/gas-fee-refunds) that have been earned by a specific address. Our refund process calculates these values weekly.
870+
The `flashbots_getFeeRefundsByRecipient` JSON-RPC method returns detailed information about [fee refunds](/flashbots-protect/gas-fee-refunds) that have been earned by a specific address. Our refund process usually calculates these values with a 4 hour delay.
871871

872872
```json
873873
{
@@ -913,6 +913,42 @@ The `"cursor"` field is only included if there are more fee refunds to fetch. To
913913

914914
NOTE: This API currently only returns details for bundles included in block 20802497 and later. To see total fee refunds processed for a specific address since inception, use the `flashbots_getFeeRefundTotalsByRecipient` method.
915915

916+
### flashbots_getFeeRefundsByBundle
917+
918+
The `flashbots_getFeeRefundsByBundle` is similar to `flashbots_getFeeRefundsByRecipient` but returns result for the given bundle.
919+
920+
```json
921+
{
922+
"jsonrpc": "2.0",
923+
"id": 1,
924+
"method": "flashbots_getFeeRefundsByBundle",
925+
"params": [
926+
{
927+
bundle_hash, // String, the hash of the bundle
928+
}
929+
]
930+
}
931+
```
932+
933+
### flashbots_getFeeRefundsByBlock
934+
935+
The `flashbots_getFeeRefundsByBlock` is similar to `flashbots_getFeeRefundsByRecipient` but returns result for the given block.
936+
937+
```json
938+
{
939+
"jsonrpc": "2.0",
940+
"id": 1,
941+
"method": "flashbots_getFeeRefundsByBlock",
942+
"params": [
943+
{
944+
block_number, // String, hex-encoded block number (e.g. 0x15d0280)
945+
}
946+
]
947+
}
948+
```
949+
950+
951+
916952
### flashbots_setFeeRefundRecipient
917953

918954
The `flashbots_setFeeRefundRecipient` JSON-RPC method allows a user to "delegate" their [fee refunds](/flashbots-auction/advanced/gas-fee-refunds) to a specific wallet address. Two addresses must be provided, the first is the address associated with the signing key used to authenticate your request, while the second is the address to send refunds to.

0 commit comments

Comments
 (0)