From 11bab12cd0f699971aedc77acadde60ef8f56f2c Mon Sep 17 00:00:00 2001
From: rmoreliovlabs <89464501+rmoreliovlabs@users.noreply.github.com>
Date: Fri, 22 Sep 2023 08:29:08 -0400
Subject: [PATCH] Update json-rpc.md

Updated some parameters description to add Map as an allowed value for the block reference parameter, for example in the eth_getBalance method.
---
 rsk/node/architecture/json-rpc.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/rsk/node/architecture/json-rpc.md b/rsk/node/architecture/json-rpc.md
index 94c4496a1..5d4d10bcf 100644
--- a/rsk/node/architecture/json-rpc.md
+++ b/rsk/node/architecture/json-rpc.md
@@ -625,7 +625,8 @@ Returns the balance of the account of given address.
 ##### Parameters
 
 1. `DATA`, 20 Bytes - address to check for balance.
-2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-RPC#the-default-block-parameter)
+2. `QUANTITY|TAG|MAP` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-
+RPC#the-default-block-parameter), or a map containing a block hash string, under the key `"blockHash"` or a string hexcadecimal number, under the key `"blockNumber"`.
 
 ##### Example Parameters
 ```js
@@ -663,7 +664,8 @@ Returns the value from a storage position at a given address.
 
 1. `DATA`, 20 Bytes - address of the storage.
 2. `QUANTITY` - integer of the position in the storage.
-3. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-RPC#the-default-block-parameter)
+3. `QUANTITY|TAG|MAP` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-
+RPC#the-default-block-parameter), or a map containing a block hash string, under the key `"blockHash"` or a string hexcadecimal number, under the key `"blockNumber"`.
 
 ##### Returns
 
@@ -726,7 +728,8 @@ Returns the number of transactions *sent* from an address.
 ##### Parameters
 
 1. `DATA`, 20 Bytes - address.
-2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-RPC#the-default-block-parameter)
+2. `QUANTITY|TAG|MAP` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-
+RPC#the-default-block-parameter), or a map containing a block hash string, under the key `"blockHash"` or a string hexcadecimal number, under the key `"blockNumber"`.
 
 ##### Example Parameters
 ```js
@@ -906,7 +909,8 @@ Returns code at a given address.
 ##### Parameters
 
 1. `DATA`, 20 Bytes - address.
-2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-RPC#the-default-block-parameter).
+2. `QUANTITY|TAG|MAP` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://github.com/ethereum/wiki/wiki/JSON-
+RPC#the-default-block-parameter), or a map containing a block hash string, under the key `"blockHash"` or a string hexcadecimal number, under the key `"blockNumber"`.
 
 ##### Example Parameters
 ```js
@@ -2110,4 +2114,4 @@ It is recommended to set reasonable values for these limits, considering the net
 | `rsk_getRawBlockHeaderByNumber` | YES | Obtains the RLP encoded block header used for SPV, if this is hashed using Keccack256 it gives the block hash. This function takes the block number (in hexa) or the string "latest" "pending" "genesis". |
 | `rsk_getRawBlockHeaderByHash` | YES | Obtains the RLP encoded block header used for SPV, if this is hashed using Keccack256 it gives the block hash. This function takes the block hash as parameter. |
 | `rsk_getRawTransactionReceiptByHash` | YES | Obtains the RLP encoded Transaction Receipt, if this is hashed using Keccack256 it gives the transaction receipt hash. This function takes the transaction hash as parameter.|
-| `rsk_getTransactionReceiptNodesByHash` | YES | Obtains an array of nodes of the transactions receipt Trie. This is used to hash up to the transaction receipt root. This function takes the block hash and transaction hash as parameters.|
\ No newline at end of file
+| `rsk_getTransactionReceiptNodesByHash` | YES | Obtains an array of nodes of the transactions receipt Trie. This is used to hash up to the transaction receipt root. This function takes the block hash and transaction hash as parameters.|