docs: add rundler_getUserOperationGasPrice api spec (#1159)

* docs: add rundler_getUserOperationGasPrice api spec

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: update maxFeePerGas example

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: jakehobbs

src/openrpc/alchemy/bundler/bundler.yaml

@@ -135,6 +135,50 @@ methods:
           name: Estimated priority fee
           value: "0xb1770efb14906e509893b6190359658208ae64d0c56e22f748a1b0869885559e"
 
+  - name: rundler_getUserOperationGasPrice
+    description: |
+      Returns gas price recommendations for setting fees in your user operations. The response includes current required fees and suggested fees with buffers for faster inclusion.
+    params: []
+    result:
+      name: Gas price recommendation
+      description: Gas price recommendation containing current fees and suggested fees with buffers.
+      schema:
+        type: object
+        required: ["currentPriorityFee", "baseFee", "blockNumber", "suggested"]
+        properties:
+          currentPriorityFee:
+            type: string
+            description: The current minimum priority fee required by the bundler (same as `rundler_maxPriorityFeePerGas`).
+          baseFee:
+            type: string
+            description: The current pending base fee for the next block (without bundler overhead).
+          blockNumber:
+            type: string
+            description: The block number this estimate is based on.
+          suggested:
+            type: object
+            description: Suggested fees with configurable buffers for faster inclusion.
+            required: ["maxPriorityFeePerGas", "maxFeePerGas"]
+            properties:
+              maxPriorityFeePerGas:
+                type: string
+                description: Priority fee with buffer above the current minimum (default 30% buffer).
+              maxFeePerGas:
+                type: string
+                description: Bundler-inflated base fee with buffer plus suggested priority fee (default 50% base fee buffer).
+    examples:
+      - name: rundler_getUserOperationGasPrice example
+        params: []
+        result:
+          name: Gas price recommendation
+          value:
+            currentPriorityFee: "0x59682f00"
+            baseFee: "0x165a0bc00"
+            blockNumber: "0x12a3b4c"
+            suggested:
+              maxPriorityFeePerGas: "0x746a5280"
+              maxFeePerGas: "0x28CDB6C80"
+
   - name: eth_getUserOperationReceipt
     description: |
       Get the `UserOperationReceipt` based on the `userOpHash`.