Skip to content

[docs-agent] Rename BSO policy type to Gas Sponsorship (EVM); add low-level API policy-creation step #1516

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
alchemy-bot wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[docs-agent] Rename BSO policy type to Gas Sponsorship (EVM); add low-level API policy-creation step #1516

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions content/wallets/pages/transactions/sponsor-gas/bundler-sponsored-operations.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ BSOs instead operate at the bundler level: they use your Gas Manager policy to c
## How to use BSO sponsorship

1. Create a BSO Gas Manager policy in your [dashboard](https://dashboard.alchemy.com/). Configure:
* **Policy Type**: select **Bundler Sponsored Operations**
* **Policy Type**: select **Gas Sponsorship (EVM)**
* **Max Spend Per UO**: the maximum spend per transaction - we will retry up to this limit
2. **Include the policy ID** in your requests when sending transactions.

Expand Down Expand Up @@ -78,8 +78,9 @@ const { id } = await client.sendCalls({

### Low-level APIs

See the [Bundler API Quickstart](/docs/reference/bundler-api-quickstart) for full examples. Two extra steps are required:
See the [Bundler API Quickstart](/docs/reference/bundler-api-quickstart) for full examples. Three extra steps are required:

* Create a **Gas Sponsorship (EVM)** policy in your [dashboard](https://dashboard.alchemy.com/) and copy the policy ID.
* Set the `x-alchemy-policy-id` header on the bundler transport (via `fetchOptions.headers`).
* Zero out `maxFeePerGas`, `maxPriorityFeePerGas`, and `preVerificationGas` on the user operation. All three must be zero, the bundler treats that as the signal to cover gas under the BSO policy and fills in the actual values server-side.

Expand Down Expand Up @@ -150,7 +151,7 @@ BSO gas is priced as the onchain settlement cost plus a BSO service fee for adva
## Requirements

* A valid API key with Bundler API access
* A configured Gas Manager policy of type **Bundler Sponsored Operations** with Max Spend Per UO set
* A configured Gas Manager policy of type **Gas Sponsorship (EVM)** with Max Spend Per UO set
* Wallet APIs SDK or equivalent setup for creating and signing transactions

<Warning>
Expand Down
Loading