feat: update rpc docs

documentation/index.yaml

@@ -140,8 +140,8 @@ paths:
     $ref: ../web3rpc/rpc-specs/paths/kaia/configuration/clientVersion.yaml#/paths/~1kaia~1configuration~1clientVersion
   /kaia/configuration/gasPrice:
     $ref: ../web3rpc/rpc-specs/paths/kaia/configuration/gasPrice.yaml#/paths/~1kaia~1configuration~1gasPrice
-  /kaia/configuration/gasPriceAt:
-    $ref: ../web3rpc/rpc-specs/paths/kaia/configuration/gasPriceAt.yaml#/paths/~1kaia~1configuration~1gasPriceAt
+  # /kaia/configuration/gasPriceAt: # removed
+  #   $ref: ../web3rpc/rpc-specs/paths/kaia/configuration/gasPriceAt.yaml#/paths/~1kaia~1configuration~1gasPriceAt
   /kaia/configuration/getChainConfig:
     $ref: ../web3rpc/rpc-specs/paths/kaia/configuration/getChainConfig.yaml#/paths/~1kaia~1configuration~1getChainConfig
   /kaia/configuration/isParallelDBWrite:
@@ -350,8 +350,8 @@ paths:
     $ref: ../web3rpc/rpc-specs/paths/klay/gas/upperBoundGasPrice.yaml#/paths/~1klay~1gas~1upperBoundGasPrice
   /klay/gas/gasPrice:
     $ref: ../web3rpc/rpc-specs/paths/klay/gas/gasPrice.yaml#/paths/~1klay~1gas~1gasPrice
-  /klay/gas/gasPriceAt:
-    $ref: ../web3rpc/rpc-specs/paths/klay/gas/gasPriceAt.yaml#/paths/~1klay~1gas~1gasPriceAt
+  # /klay/gas/gasPriceAt: // removed
+  #   $ref: ../web3rpc/rpc-specs/paths/klay/gas/gasPriceAt.yaml#/paths/~1klay~1gas~1gasPriceAt
   # klay/miscellaneous
   /klay/miscellaneous/getStakingInfo:
     $ref: ../web3rpc/rpc-specs/paths/klay/miscellaneous/getStakingInfo.yaml#/paths/~1klay~1miscellaneous~1getStakingInfo

documentation/namespaces/kaia.yaml

@@ -129,8 +129,6 @@ paths:
     $ref: ../../web3rpc/rpc-specs/paths/kaia/configuration/chainID.yaml#/paths/~1kaia~1configuration~1chainID
   /kaia/configuration/clientVersion:
     $ref: ../../web3rpc/rpc-specs/paths/kaia/configuration/clientVersion.yaml#/paths/~1kaia~1configuration~1clientVersion
-  /kaia/configuration/gasPriceAt:
-    $ref: ../../web3rpc/rpc-specs/paths/kaia/configuration/gasPriceAt.yaml#/paths/~1kaia~1configuration~1gasPriceAt
   /kaia/configuration/gasPrice:
     $ref: ../../web3rpc/rpc-specs/paths/kaia/configuration/gasPrice.yaml#/paths/~1kaia~1configuration~1gasPrice
   /kaia/configuration/isParallelDBWrite:

documentation/namespaces/klay.yaml

@@ -171,8 +171,6 @@ paths:
     $ref: ../../web3rpc/rpc-specs/paths/klay/gas/upperBoundGasPrice.yaml#/paths/~1klay~1gas~1upperBoundGasPrice
   /klay/gas/maxPriorityFeePerGas:
     $ref: ../../web3rpc/rpc-specs/paths/klay/gas/maxPriorityFeePerGas.yaml#/paths/~1klay~1gas~1maxPriorityFeePerGas
-  /klay/gas/gasPriceAt:
-    $ref: ../../web3rpc/rpc-specs/paths/klay/gas/gasPriceAt.yaml#/paths/~1klay~1gas~1gasPriceAt
   /klay/gas/gasPrice:
     $ref: ../../web3rpc/rpc-specs/paths/klay/gas/gasPrice.yaml#/paths/~1klay~1gas~1gasPrice
   # klay/miscellaneous

web3rpc/rpc-specs/paths/eth/account/sign.yaml

@@ -17,17 +17,11 @@ paths:
         - eth
       operationId: sign
       description: |
-        The sign method calculates a Klaytn-specific signature with:
+        The method calculates an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) signature: ```sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)))```
 
-        sign(keccak256("\x19Klaytn Signed Message:\n" + len(message) + message)))
+        **NOTE**: In versions earlier than Kaia v1.0.1, the method calculates an [KIP-97](https://kips.kaia.io/KIPs/kip-97) signature: sign(keccak256("\x19Klaytn Signed Message:\n" + len(message) + message)))
 
-        Adding a prefix to the message makes the calculated signature recognizable as a Klaytn-specific signature. This prevents misuse where a malicious dApp signs arbitrary data (e.g. transaction) and uses the signature for impersonation.
-
-        `eth_sign` will be failed to baobab/cypress network because it is signed in the EN node, which means that the EN must have the key that you want to sign with.
-        Steps to test `eth_sign`.
-          - Step 1: Setup a local EN node
-          - Step 2: <a href="#tag/personal/operation/newAccount" target="_blank">Create an account</a> into the EN node
-          - Step 3: <a href="#tag/personal/operation/unlockAccount" target="_blank">Unlock the account</a> for using in signing
+        The personal_ecRecover and kaia_recoverFromMessage methods can verify the signature.
 
         **JSONRPC:** `eth_sign`
 

web3rpc/rpc-specs/paths/eth/gas/gasPrice.yaml

@@ -17,12 +17,11 @@ paths:
         - eth
       operationId: gasPrice
       description: |
-        Returns a suggested gasPrice or maxFeePerGas. The suggested price depends on the hardfork status.
-        - Fixed unit price before Magma
-        - Twice the base fee before Kaia
-        - Base fee plus suggested priority fee after Kaia
+        Returns a recommended gasPrice for a new transaction.
 
-        **NOTE:** This API has different behavior from Ethereum's and returns a gas price of Klaytn instead of suggesting a gas price as in Ethereum.
+        - Before Magma, returns the fixed UnitPrice
+        - After Magma, returns the twice of next baseFee (2*baseFee)
+        - After Kaia, returns slightly buffered baseFee plus recommended tip (BaseFee * (1.10 or 1.15) + eth_maxPriorityFeePerGas)
 
         **JSONRPC:** `eth_gasPrice`
 
@@ -40,7 +39,7 @@ paths:
 
       responses:
         200:
-          description: Suggested price in kei.
+          description: Recommended gas price in kei.
           content:
             application/json:
               schema:
@@ -74,5 +73,5 @@ components:
         result:
           type: string
           format: hex
-          description: Suggested price in kei.
+          description: Recommended gas price in kei.
           example: "0xAE9F7BCC00"

web3rpc/rpc-specs/paths/eth/gas/maxPriorityFeePerGas.yaml

@@ -17,10 +17,11 @@ paths:
         - eth
       operationId: maxPriorityFeePerGas
       description: |
-        Returns a suggested gasPrice or maxPriorityFeePerGas. The suggested price depends on the hardfork status.
-          - Fixed unit price before Magma
-          - Zero before Kaia
-          - Suggested priority fee from fee history, after Kaia
+        Returns a recommended maxPriorityFeePerGas for a new transaction.
+
+        - Before Magma, returns the fixed UnitPrice
+        - After Magma, returns zero
+        - After Kaia, returns zero if network is uncongested (i.e. next baseFee at its lower bound), otherwise 60% percentile effective tip from previous 20 blocks (under default setting)
 
         **NOTE:** This API has different behavior from Ethereum's and returns a gas price of Klaytn instead of suggesting a gas price as in Ethereum.
 
@@ -36,7 +37,7 @@ paths:
 
       responses:
         200:
-          description: Suggested price in kei
+          description: Recommended maxPriorityFeePerGas in kei.
           content:
             application/json:
               schema:
@@ -76,6 +77,6 @@ components:
       properties:
         result:
           type: string
-          description: Suggested price in kei
+          description: Recommended maxPriorityFeePerGas in kei.
           format: hex
           example: "0xAE9F7BCC00"

web3rpc/rpc-specs/paths/eth/transaction/signTransaction.yaml

@@ -19,12 +19,6 @@ paths:
       description: |
         Signs a transaction that can be submitted to the network at a later time using with eth_sendRawTransaction.
 
-        `eth_signTransaction` will be failed to baobab/cypress network because it is signed in the EN node, which means that the EN must have the key that you want to sign with.
-        Steps to test `eth_signTransaction`.
-          - Step 1: Setup a local EN node
-          - Step 2: <a href="#tag/personal/operation/newAccount" target="_blank">Create an account</a> into the EN node
-          - Step 3: <a href="#tag/personal/operation/unlockAccount" target="_blank">Unlock the account</a> for using in signing
-
         **JSONRPC:** `eth_signTransaction`
 
       parameters:

web3rpc/rpc-specs/paths/kaia/account/sign.yaml

@@ -15,17 +15,11 @@ paths:
       operationId: .sign
       summary: "[Account] kaia_sign"
       description: |
-        The sign method calculates a Klaytn-specific signature with:
+        The method calculates an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) signature: ```sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)))```
 
-        sign(keccak256("\x19Klaytn Signed Message:\n" + len(message) + message)))
+        **NOTE**: In versions earlier than Kaia v1.0.1, the method calculates an [KIP-97](https://kips.kaia.io/KIPs/kip-97) signature: sign(keccak256("\x19Klaytn Signed Message:\n" + len(message) + message)))
 
-        Adding a prefix to the message makes the calculated signature recognizable as a Klaytn-specific signature. This prevents misuse where a malicious dApp can sign arbitrary data, e.g., transaction, and use the signature to impersonate the victim.
-
-        `kaia_sign` will be failed to baobab/cypress network because it is signed in the EN node, which means that the EN must have the key that you want to sign with.
-        Steps to test `kaia_sign`.
-          - Step 1: Setup a local EN node
-          - Step 2: <a href="#tag/personal/operation/newAccount" target="_blank">Create an account</a> into the EN node
-          - Step 3: <a href="#tag/personal/operation/unlockAccount" target="_blank">Unlock the account</a> for using in signing
+        The personal_ecRecover and kaia_recoverFromMessage methods can verify the signature.
 
         **JSONRPC:** `kaia_sign`
 

web3rpc/rpc-specs/paths/kaia/configuration/gasPrice.yaml

@@ -15,8 +15,12 @@ paths:
       operationId: .gasPrice
       summary: "[Configuration] kaia_gasPrice"
       description: |
-        Returns a suggestion for a gas price in peb.
-
+        Returns a recommended gasPrice for a new transaction.
+
+        - Before Magma, returns the fixed UnitPrice
+        - After Magma, returns the twice of next baseFee (2*baseFee)
+        - After Kaia, returns slightly buffered baseFee plus recommended tip (BaseFee * (1.10 or 1.15) + eth_maxPriorityFeePerGas)
+
         **JSONRPC:** `kaia_gasPrice`
       tags:
         - kaia
@@ -35,7 +39,7 @@ paths:
 
       responses:
         200:
-          description: Returns a suggestion for a gas price in peb.
+          description: Recommended gas price in kei.
           content:
             application/json:
               schema:
@@ -46,7 +50,7 @@ paths:
                       result:
                         type: string
                         format: hex
-                        description: "Integer of the current gas price in peb"
+                        description: Recommended gas price in kei.
                         example: "0xAE9F7BCC00"
 
       x-codeSamples:

web3rpc/rpc-specs/paths/kaia/gas/maxPriorityFeePerGas.yaml

@@ -15,7 +15,11 @@ paths:
       operationId: .maxPriorityFeePerGas
       summary: "[Gas] kaia_maxPriorityFeePerGas"
       description: |
-        Returns a suggestion for a gas tip cap for dynamic fee transactions in peb.
+        Returns a recommended maxPriorityFeePerGas for a new transaction.
+
+        - Before Magma, returns the fixed UnitPrice
+        - After Magma, returns zero
+        - After Kaia, returns zero if network is uncongested (i.e. next baseFee at its lower bound), otherwise 60% percentile effective tip from previous 20 blocks (under default setting)
 
         **NOTE:** This API is effective after Klaytn v1.8.0
 
@@ -38,7 +42,7 @@ paths:
 
       responses:
         200:
-          description: Returns a suggestion for a gas tip cap for dynamic fee transactions in peb.
+          description: Recommended maxPriorityFeePerGas in kei.
           content:
             application/json:
               schema:
@@ -49,7 +53,7 @@ paths:
                       result:
                         type: string
                         format: hex
-                        description: "Integer of the current max priority fee per gas"
+                        description: Recommended maxPriorityFeePerGas in kei.
                         example: "0xAE9F7BCC00"
 
       x-codeSamples:

web3rpc/rpc-specs/paths/kaia/index.yaml

@@ -127,8 +127,6 @@ paths:
     $ref: ./configuration/chainID.yaml#/paths/~1kaia~1configuration~1chainID
   /kaia/configuration/clientVersion:
     $ref: ./configuration/clientVersion.yaml#/paths/~1kaia~1configuration~1clientVersion
-  /kaia/configuration/gasPriceAt:
-    $ref: ./configuration/gasPriceAt.yaml#/paths/~1kaia~1configuration~1gasPriceAt
   /kaia/configuration/gasPrice:
     $ref: ./configuration/gasPrice.yaml#/paths/~1kaia~1configuration~1gasPrice
   /kaia/configuration/isParallelDBWrite:

web3rpc/rpc-specs/paths/kaia/miscellaneous/recoverFromMessage.yaml

@@ -15,7 +15,11 @@ paths:
       operationId: .recoverFromMessage
       summary: "[Miscellaneous] kaia_recoverFromMessage"
       description: |
-        Using this API, users can recover from message data.
+        This method recovers or verifies an ECDSA signature signed by a private key associated with the given address.
+
+        The signature has to be signed by the private key that constitutes the account, e.g. "natural" private key of a Legacy account, one of the keys of a WeightedMultisig account.
+
+        Both [EIP-191](https://eips.ethereum.org/EIPS/eip-191) and [KIP-97](https://kips.kaia.io/KIPs/kip-97) signatures are accepted.
 
         **JSONRPC:** `kaia_recoverFromMessage`
       tags:

web3rpc/rpc-specs/paths/kaia/transaction/signTransactionAsFeePayer.yaml

@@ -17,12 +17,6 @@ paths:
       description: |
         Constructs a transaction with given parameters and signs the transaction with a fee payer's private key. This method can be used either to generate a fee payer signature or to make a final raw transaction that is ready to submit to Klaytn network. In case you just want to extract the fee-payer signature, simply take the feePayerSignatures from the result. Note that the raw transaction is not final if the sender's signature is not attached (that is, signatures in tx is empty).
 
-        `kaia_signTransactionAsFeePayer` will be failed to baobab/cypress network because it is signed in the EN node, which means that the EN must have the key that you want to sign with.
-        Steps to test `kaia_signTransactionAsFeePayer`.
-          - Step 1: Setup a local EN node
-          - Step 2: <a href="#tag/personal/operation/newAccount" target="_blank">Create an account</a> into the EN node
-          - Step 3: <a href="#tag/personal/operation/unlockAccount" target="_blank">Unlock the account</a> for using in signing
-
         **JSONRPC:** `kaia_signTransactionAsFeePayer`
 
       tags:

web3rpc/rpc-specs/paths/klay/account/sign.yaml

@@ -15,17 +15,11 @@ paths:
       operationId: sign
       summary: "[Account] klay_sign"
       description: |
-        The sign method calculates a Klaytn-specific signature with:
+        The method calculates an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) signature: ```sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)))```
 
-        sign(keccak256("\x19Klaytn Signed Message:\n" + len(message) + message)))
+        **NOTE**: In versions earlier than Kaia v1.0.1, the method calculates an [KIP-97](https://kips.kaia.io/KIPs/kip-97) signature: sign(keccak256("\x19Klaytn Signed Message:\n" + len(message) + message)))
 
-        Adding a prefix to the message makes the calculated signature recognizable as a Klaytn-specific signature. This prevents misuse where a malicious dApp can sign arbitrary data, e.g., transaction, and use the signature to impersonate the victim.
-
-        `klay_sign` will be failed to baobab/cypress network because it is signed in the EN node, which means that the EN must have the key that you want to sign with.
-        Steps to test `klay_sign`.
-          - Step 1: Setup a local EN node
-          - Step 2: <a href="#tag/personal/operation/newAccount" target="_blank">Create an account</a> into the EN node
-          - Step 3: <a href="#tag/personal/operation/unlockAccount" target="_blank">Unlock the account</a> for using in signing
+        The personal_ecRecover and kaia_recoverFromMessage methods can verify the signature.
 
         **JSONRPC:** `klay_sign`