add new polygon-zkevm methods

Author: SahilAujla

evm_body.yaml

@@ -2250,6 +2250,36 @@ zkevm_getBroadcastURI:
           $ref: ./components/schemas.yaml#/Method
           default: zkevm_getBroadcastURI
 
+zkevm_estimateFee:
+  allOf:
+    - $ref: '#/common_request_fields'
+    - type: object
+      properties:
+        method:
+          $ref: ./components/schemas.yaml#/Method
+          default: zkevm_estimateFee
+        params:
+          type: array
+          minItems: 1
+          maxItems: 1
+          items:
+            $ref: '#/transaction_object'
+
+zkevm_estimateGasPrice:
+  allOf:
+    - $ref: '#/common_request_fields'
+    - type: object
+      properties:
+        method:
+          $ref: ./components/schemas.yaml#/Method
+          default: zkevm_estimateGasPrice
+        params:
+          type: array
+          minItems: 1
+          maxItems: 1
+          items:
+            $ref: '#/transaction_object'
+
 # ===================== Account Abstraction Methods =====================
 
 eth_sendUserOperation:

evm_examples.yaml

@@ -2808,6 +2808,10 @@ eth_getTransactionReceipt_zkevm:
       },
   }
 
+zkevm_estimateFee: {'jsonrpc': '2.0', 'id': 1, 'result': '0x1ff3e2c2fec0'}
+
+zkevm_estimateGasPrice: {'jsonrpc': '2.0', 'id': 1, 'result': '0x64848414'}
+
 # ========== Account Abstraction Method Examples ==========
 
 eth_sendUserOperation: { 'jsonrpc': '2.0', 'id': 1, 'result': '0x1234...5678' }

evm_responses.yaml

@@ -1433,6 +1433,30 @@ zkevm_getBroadcastURI:
       example:
         $ref: ./evm_examples.yaml#/zkevm_getBroadcastURI
 
+zkevm_estimateFee:
+  allOf:
+    - $ref: '#/common_response_fields'
+    - type: object
+      description: Returns the estimated fee for the transaction.
+      properties:
+        result:
+          type: string
+          description: The estimated fee for the transaction.
+      example:
+        $ref: ./evm_examples.yaml#/zkevm_estimateFee
+
+zkevm_estimateGasPrice:
+  allOf:
+    - $ref: '#/common_response_fields'
+    - type: object
+      description: Returns the estimated gas price.
+      properties:
+        result:
+          type: string
+          description: The estimated gas price.
+      example:
+        $ref: ./evm_examples.yaml#/zkevm_estimateGasPrice
+
 # ============= Account Abstraction ===============
 
 eth_sendUserOperation:

polygon-zkevm/zkevm_estimateFee.yaml

@@ -0,0 +1,55 @@
+openapi: 3.1.0
+info:
+  title: zkevm_estimateFee API - Polygon zkEVM
+  description: Estimates the transaction fee based on the current gas price and transaction complexity.
+  version: '1.0'
+servers:
+  - url: 'https://{network}.g.alchemy.com/v2/'
+    variables:
+      network:
+        enum:
+          - polygonzkevm-mainnet
+          - polygonzkevm-testnet
+          - polygonzkevm-cardona
+        default: polygonzkevm-cardona
+x-sandbox:
+  category:
+    type:
+      $ref: '../components/sandbox.yaml#/Category'
+    value: core
+paths:
+  /{apiKey}:
+    $ref: '#/components/pathItems/path'
+components:
+  pathItems:
+    path:
+      post:
+        operationId: zkevm-estimateFee-polygon-zkevm
+        summary: zkevm_estimateFee API - Polygon zkEVM
+        description: Estimates the transaction fee following the effective gas price rules.
+        parameters:
+          - name: apiKey
+            in: path
+            schema:
+              type: string
+              default: docs-demo
+              description: |
+                <style>
+                  .custom-style {
+                    color: #048FF4;
+                  }
+                </style>
+                For higher throughput, <span class="custom-style"><a href="https://alchemy.com/?a=docs-demo" target="_blank">create your own API key</a></span>
+            required: true
+        requestBody:
+          content:
+            application/json:
+              schema:
+                $ref: '../evm_body.yaml#/zkevm_estimateFee'
+        responses:
+          '200':
+            description: Successfully estimated the transaction fee.
+            content:
+              application/json:
+                schema:
+                  $ref: '../evm_responses.yaml#/zkevm_estimateFee'

polygon-zkevm/zkevm_estimateGasPrice.yaml

@@ -0,0 +1,55 @@
+openapi: 3.1.0
+info:
+  title: zkevm_estimateGasPrice API - Polygon zkEVM
+  description: Estimates the gas price needed to get a transaction processed within a target number of blocks.
+  version: '1.0'
+servers:
+  - url: 'https://{network}.g.alchemy.com/v2/'
+    variables:
+      network:
+        enum:
+          - polygonzkevm-mainnet
+          - polygonzkevm-testnet
+          - polygonzkevm-cardona
+        default: polygonzkevm-cardona
+x-sandbox:
+  category:
+    type:
+      $ref: '../components/sandbox.yaml#/Category'
+    value: core
+paths:
+  /{apiKey}:
+    $ref: '#/components/pathItems/path'
+components:
+  pathItems:
+    path:
+      post:
+        operationId: zkevm-estimateGasPrice-polygon-zkevm
+        summary: zkevm_estimateGasPrice API - Polygon zkEVM
+        description: Estimates the transaction gas price following the effective gas price rules.
+        parameters:
+          - name: apiKey
+            in: path
+            schema:
+              type: string
+              default: docs-demo
+              description: |
+                <style>
+                  .custom-style {
+                    color: #048FF4;
+                  }
+                </style>
+                For higher throughput, <span class="custom-style"><a href="https://alchemy.com/?a=docs-demo" target="_blank">create your own API key</a></span>
+            required: true
+        requestBody:
+          content:
+            application/json:
+              schema:
+                $ref: '../evm_body.yaml#/zkevm_estimateGasPrice'
+        responses:
+          '200':
+            description: Successfully estimated the gas price.
+            content:
+              application/json:
+                schema:
+                  $ref: '../evm_responses.yaml#/zkevm_estimateGasPrice'