Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 2 additions & 0 deletions content/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -905,6 +905,8 @@ navigation:
- section: Sponsor gas
path: wallets/pages/transactions/sponsor-gas/overview.mdx
contents:
- page: Dashboard guide
path: wallets/pages/transactions/sponsor-gas/dashboard-guide.mdx
- page: Full sponsorship
path: wallets/pages/transactions/sponsor-gas/index.mdx
- page: Conditional sponsorship rules
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@ An example of spending rules is included in the screenshot below:

Creating a gas policy through Alchemy Dashboard

<Info>
The Gas Sponsorship dashboard has been redesigned. For a walkthrough of the new surface, including each policy type and how to monitor spend, see the [dashboard guide to Gas Sponsorship policies](/docs/wallets/transactions/sponsor-gas/dashboard-guide).
</Info>

### Video Tutorial

Prefer a video guide? Watch the video below for a step-by-step walkthrough, or follow the written tutorial.
Expand All @@ -35,7 +39,7 @@ Start by [creating a new application](https://dashboard.alchemy.com/signup) or u

## Step 2: Draft a New Policy

Log in and navigate to the "Gas Policies" section and click the [create a policy](https://dashboard.alchemy.com/gas-policies/new) button.
Log in and navigate to the "Gas Policies" section and click the [create a policy](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) button.

![Create Policy](https://alchemyapi-res.cloudinary.com/image/upload/v1764180249/docs/tutorials/smart-wallets/gas-manager-apis/aa17e8c-Screenshot_2023-05-23_at_3.39.26_PM.png)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Pricing varies by country and requires specific area codes to be enabled for you
## Prerequisites

* Early access to SMS auth configured on your account: [Request early access!](mailto:wallets@alchemy.com)
* A configured app with [smart wallets](/docs/wallets/pages/react/quickstart.mdx) and a [gas sponsorship policy](https://dashboard.alchemy.com/gas-manager/policy/create).
* A configured app with [smart wallets](/docs/wallets/pages/react/quickstart.mdx) and a [gas sponsorship policy](https://dashboard.alchemy.com/apps/latest/gas-sponsorship).
* SDK version ≥v4.53.0

## Implementation
Expand Down
4 changes: 2 additions & 2 deletions content/wallets/pages/concepts/smart-account-client.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ The `SmartWalletClient` extends viem's [Client](https://viem.sh/docs/clients/cus
## Prerequisites

* [API key](https://dashboard.alchemy.com/apps)
* (Optional) [A gas policyID](https://dashboard.alchemy.com/gas-manager/policy/create)
* (Optional) [A gas policyID](https://dashboard.alchemy.com/apps/latest/gas-sponsorship)
* `@alchemy/wallet-apis` and `viem` installed (see the [quickstart](/docs/wallets/quickstart))

## Implementation
Expand All @@ -24,7 +24,7 @@ The `SmartWalletClient` extends viem's [Client](https://viem.sh/docs/clients/cus

1. Replace the placeholders:
* API key from your [Alchemy dashboard](https://dashboard.alchemy.com/apps)
* Policy ID from your [gas policy](https://dashboard.alchemy.com/gas-manager/policy/create)
* Policy ID from your [gas policy](https://dashboard.alchemy.com/apps/latest/gas-sponsorship)
* Signer from [authentication](/docs/wallets/authentication/login-methods/email-otp#step-4-check-authentication-status) or your own signer
2. Create the client using `createSmartWalletClient` — the client defaults to EIP-7702 using the signer's address

Expand Down
2 changes: 1 addition & 1 deletion content/wallets/pages/core/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ your client.

2. Create a **`configuration`** in the [`Wallet APIs` dashboard](https://dashboard.alchemy.com/services/smart-wallets/configuration) to enable login methods.

3. Create a policy in your [gas manager dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) to set rules for sponsorship.
3. Create a policy in your [gas manager dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) to set rules for sponsorship.

If your setup allows, store both the policy and API key in a `.env` so you can use them in the following steps. Otherwise you can hold onto them for the next section where you will make use of them!

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Gas manager policies can only be tied to one app. To resolve this issue ensure:

### This userOp's cost will put the team over their MAX token limit for this network.

This userOp will cause you to exceed your sponsorship limit. Increase your limit by buying gas credits in USD through the [Gas Manager Dashboard](https://dashboard.alchemy.com/gas-manager).
This userOp will cause you to exceed your sponsorship limit. Increase your limit by buying gas credits in USD through the [Gas Manager Dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship).

### Policy's max spend per spender exceeded.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ slug: wallets/reference/gas-manager-faqs
### How much gas can I sponsor?

Sponsor as much gas as you want. Gas is fronted up to a base limit based on your tier, and added to your monthly bill. Note that both gas sponsorship and ERC-20 gas payments contribute towards your limit.
If you need more gas, boost your limits by buying gas manager credits in USD via the [Gas Manager Dashboard](https://dashboard.alchemy.com/gas-manager). This is a one time purchase that is applied to your bill at the end of the month and rolls over until it is used up.
If you need more gas, boost your limits by buying gas manager credits in USD via the [Gas Manager Dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship). This is a one time purchase that is applied to your bill at the end of the month and rolls over until it is used up.

| Tier | Mainnet Base Limit | Testnet Limit | Team Policy Creation Limit |
| ---------- | --------------------------------------- | -------------------------- | -------------------------- |
Expand Down Expand Up @@ -45,7 +45,7 @@ The ERC-20 Gas Manager supports any token supported by the [Token Prices By Addr

### Supported ERC-20 tokens

You can browse and enable the tokens below in the **Tokens & Networks** panel of the [Gas Manager Dashboard](https://dashboard.alchemy.com/gas-manager).
You can browse and enable the tokens below in the **Tokens & Networks** panel of the [Gas Manager Dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship).

<Info>
**Need a token or network that isn't listed?** Contact us at
Expand Down
2 changes: 1 addition & 1 deletion content/wallets/pages/guide-template.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Example:

* API key from your [dashboard](https://dashboard.alchemy.com/apps)
* [Wallet APIs installed and configured in your project](/docs/wallets/pages/react/setup.mdx).
* [A "pay gas with any token" policy](https://dashboard.alchemy.com/gas-manager/policy/create).
* [A "pay gas with any token" policy](https://dashboard.alchemy.com/apps/latest/gas-sponsorship).

## Implementation

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ A gas manager policy defines which transactions (userOps) are eligible for gas s

To learn more about policy configuration, refer to the guide on [setting up a gas manager policy](/docs/setup-a-gas-manager-policy).

Once you have decided on policy rules for your app, create a policy in the [Gas Manager dashboard](https://dashboard.alchemy.com/gas-manager/policy/create/?a=api-docs).
Once you have decided on policy rules for your app, create a policy in the [Gas Manager dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship).

Now you should have a Gas policy created with a policy id you can use to sponsor gas for your users.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ A gas manager policy defines which transactions (userOps) are eligible for gas s
* **URL**: the webhook URL the Gas Manager will make a POST request to every time you request gas sponsorship
* **Sponsor on error or timeout**: when selected, the userOp will be sponsored in the event of an error or timeout.

Create a policy via the [Gas Manager dashboard](https://dashboard.alchemy.com/gas-manager/policy/create/?a=api-docs) or the [Create policy API](https://www.alchemy.com/docs/wallets/api/gas-manager-admin-api/admin-api-endpoints/create-policy).
Create a policy via the [Gas Manager dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) or the [Create policy API](https://www.alchemy.com/docs/wallets/api/gas-manager-admin-api/admin-api-endpoints/create-policy).

### 3. Get Gas Manager's signature

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ If you want to use APIs directly, follow these steps.

### 2. Create a Gas Manager policy

To enable your users to pay gas using an ERC-20 token, you need to create a “Pay gas with any token” Policy via the [Gas Manager dashboard](https://dashboard.alchemy.com/gas-manager/policy/create). You can customize the policy with the following:
To enable your users to pay gas using an ERC-20 token, you need to create a “Pay gas with any token” Policy via the [Gas Manager dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship). You can customize the policy with the following:

* Receiving address: an address of your choosing where the users' ERC20 tokens will be sent to as they pay for gas (this is orchestrated by the paymaster contract and happens automatically at the time of the transaction).
* Tokens: the tokens the user should be able to pay gas with. Learn more [here](/docs/reference/gas-manager-faqs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ NEXT_PUBLIC_ALCHEMY_API_KEY=YOUR_ALCHEMY_API_KEY
NEXT_PUBLIC_ALCHEMY_POLICY_ID=YOUR_PAYMASTER_POLICY_ID
```

Remember: you must create a [`Configuration`](https://dashboard.alchemy.com/services/smart-wallets/configuration) and a [`Paymaster Policy`](https://dashboard.alchemy.com/services/gas-manager/configuration) if you want to use Wallet APIs.
Remember: you must create a [`Configuration`](https://dashboard.alchemy.com/services/smart-wallets/configuration) and a [`Paymaster Policy`](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) if you want to use Wallet APIs.

<Warning>
Both the `Configuration` and the `Policy ID` must be linked to the application
Expand Down
2 changes: 1 addition & 1 deletion content/wallets/pages/react/getting-started/setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ To use Wallet APIs, you need to:

2. Create a **`configuration`** in the [`Wallet APIs` dashboard](https://dashboard.alchemy.com/services/smart-wallets/configuration) to enable login methods.

3. Create a policy in your [gas manager dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) to set rules for sponsorship.
3. Create a policy in your [gas manager dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) to set rules for sponsorship.

Create a `.env` at root of your project:

Expand Down
2 changes: 1 addition & 1 deletion content/wallets/pages/react/solana-wallets/get-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ createConfig({
commitment: "confirmed",
}
),
policyId: "<PolicyId>" // Optional - gas/rent sponsorship policy ID: https://dashboard.alchemy.com/gas-manager
policyId: "<PolicyId>" // Optional - gas/rent sponsorship policy ID: https://dashboard.alchemy.com/apps/latest/gas-sponsorship
}
}
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ This recipe shows how to programmatically create a smart wallet: you’ll genera
```bash
# Get your app API key: https://dashboard.alchemy.com/apps
ALCHEMY_API_KEY=YOUR_API_KEY
# Get your gas sponsorship policy ID: https://dashboard.alchemy.com/services/gas-manager/configuration
# Get your gas sponsorship policy ID: https://dashboard.alchemy.com/apps/latest/gas-sponsorship
ALCHEMY_POLICY_ID=YOUR_POLICY_ID
# Generate a secure access key for server wallet authentication - see step 3 below
ACCESS_KEY=your-secure-access-key-here
Expand Down
2 changes: 1 addition & 1 deletion content/wallets/pages/shared/create-gas-policy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ A gas manager policy is a set of rules that define which transactions are eligib

To learn more about policy configuration, refer to the guide on [setting up a gas manager policy](https://alchemy.com/docs/setup-a-gas-manager-policy/?a=ak-docs).

Once you have decided on policy rules for your app, [create a policy](https://dashboard.alchemy.com/gas-manager/policy/create/?a=ak-docs) in the Gas Manager dashboard.
Once you have decided on policy rules for your app, [create a policy](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) in the Gas Manager dashboard.

You should now have a gas policy created with a policy id you can use to sponsor gas for your users.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ console.log("Transaction sent:", id);

## Solana support

Server wallets also work on Solana. To start sending sponsored transactions on Solana, set up a Solana sponsor gas policy in the [dashboard](https://dashboard.alchemy.com/gas-manager) and follow the guide below.
Server wallets also work on Solana. To start sending sponsored transactions on Solana, set up a Solana sponsor gas policy in the [dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) and follow the guide below.

<CodeBlocks>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ await connection.sendTransaction(signedTransaction);

To sponsor transaction fees on Solana:

1. Set up your [sponsorship policy](https://dashboard.alchemy.com/services/gas-manager/configuration) in the dashboard to retrieve a **policy ID**
1. Set up your [sponsorship policy](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) in the dashboard to retrieve a **policy ID**
2. Add sponsorship to the prepared transaction before signing and sending

```ts sponsored-solana-transaction-signer.tsx
Expand All @@ -115,7 +115,7 @@ async function signTransaction(
const transaction = await signer.addSponsorship(
instructions,
connection,
"<policyId>", // Replace with your solana sponsorship policy ID: https://dashboard.alchemy.com/services/gas-manager/configuration
"<policyId>", // Replace with your solana sponsorship policy ID: https://dashboard.alchemy.com/apps/latest/gas-sponsorship
);

// Sign the transaction using the Solana wallet
Expand Down
2 changes: 1 addition & 1 deletion content/wallets/pages/smart-wallets/quickstart/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ To use this guide, you'll need:

* An account you can sign with (e.g. an [authentication provider](/docs/wallets/signer/what-is-a-signer#alchemy-signer) or an EOA)
* An API key — [create an app](https://dashboard.alchemy.com/apps) to get one
* A [gas manager policy ID](https://dashboard.alchemy.com/gas-manager/policy/create) if sponsoring gas
* A [gas manager policy ID](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) if sponsoring gas

<Tip title="Don't have an API key?" icon="star">
Start using the Wallets API today! [Get started for
Expand Down
4 changes: 2 additions & 2 deletions content/wallets/pages/third-party/signers/openfort.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Upgrade existing Openfort embedded wallets to Wallet APIs to enable gasless tran
* Go to the [Alchemy Dashboard](https://dashboard.alchemy.com/)
* Create or select an app and copy the API key
* Gas sponsorship Policy ID (Gas Manager):
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) and copy its Policy ID
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) and copy its Policy ID
* Openfort Publishable Key:
* Go to the [Openfort Dashboard](https://dashboard.openfort.xyz/)
* Create or select a project and copy the Publishable Key
Expand Down Expand Up @@ -220,7 +220,7 @@ Upgrade existing Openfort embedded wallets to Wallet APIs to enable gasless tran
* Go to the [Alchemy Dashboard](https://dashboard.alchemy.com/)
* Create or select an app and copy the API key
* Gas sponsorship Policy ID (Gas Manager):
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) and copy its Policy ID
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) and copy its Policy ID
* Openfort Publishable Key:
* Go to the [Openfort Dashboard](https://dashboard.openfort.xyz/)
* Create or select a project and copy the Publishable Key
Expand Down
4 changes: 2 additions & 2 deletions content/wallets/pages/third-party/signers/privy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Upgrade existing Privy wallets to Wallet APIs to enable gasless transactions, ba
* Go to the [Alchemy Dashboard](https://dashboard.alchemy.com/)
* Create or select an app and copy the API key
* Gas sponsorship Policy ID (Gas Manager):
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) and copy its Policy ID
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) and copy its Policy ID
* Privy App ID:
* Go to the [Privy Dashboard](https://dashboard.privy.io/)
* Create or select an app and copy the App ID
Expand Down Expand Up @@ -346,7 +346,7 @@ Upgrade existing Privy wallets to Wallet APIs to enable gasless transactions, ba
* Go to the [Alchemy Dashboard](https://dashboard.alchemy.com/)
* Create or select an app and copy the API key
* Gas sponsorship Policy ID (Gas Manager):
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) and copy its Policy ID
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) and copy its Policy ID
* Privy App ID & Secret:
* Go to the [Privy Dashboard](https://dashboard.privy.io/)
* Create or select an app and copy the App ID and App Secret
Expand Down
4 changes: 2 additions & 2 deletions content/wallets/pages/third-party/signers/turnkey.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Upgrade existing Turnkey wallets to Wallet APIs to enable gasless transactions,
* Go to the [Alchemy Dashboard](https://dashboard.alchemy.com/)
* Create or select an app and copy the API key
* Gas sponsorship Policy ID (Gas Manager):
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) and copy its Policy ID
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) and copy its Policy ID
* Turnkey Organization ID & Auth Proxy Config ID:
* Go to the [Turnkey Dashboard](https://app.turnkey.com/)
* Create or select an organization and copy the Organization ID
Expand Down Expand Up @@ -229,7 +229,7 @@ Upgrade existing Turnkey wallets to Wallet APIs to enable gasless transactions,
* Go to the [Alchemy Dashboard](https://dashboard.alchemy.com/)
* Create or select an app and copy the API key
* Gas sponsorship Policy ID (Gas Manager):
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/services/gas-manager/configuration) and copy its Policy ID
* Create a gas sponsorship policy in the [dashboard](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) and copy its Policy ID
* Turnkey Credentials:
* Go to the [Turnkey Dashboard](https://app.turnkey.com/)
* Create or select an organization and copy the Organization ID
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
You'll need the following env variables:

* `ALCHEMY_API_KEY`: An [Alchemy API key](https://dashboard.alchemy.com/apps)
* `ALCHEMY_POLICY_ID`: A [Gas Manager](https://dashboard.alchemy.com/gas-manager/policy/create) policy ID
* `ALCHEMY_POLICY_ID`: A [Gas Manager](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) policy ID
* `PRIVATE_KEY`: A private key for a signer

<CodeBlocks>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ When requesting a cross-chain swap quote, you can specify either a `fromAmount`
Before you begin, ensure you have:

* An [Alchemy API key](https://dashboard.alchemy.com/apps)
* If you're sponsoring gas, then a [Gas Manager](https://dashboard.alchemy.com/gas-manager/policy/create) policy
* If you're sponsoring gas, then a [Gas Manager](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) policy
* A small amount of tokens for testing (~$1 worth is enough!)
* **Important**: You'll need to send these tokens to your smart wallet address to be able to swap!
* A signer to own the account and sign messages
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ Clicking the button sends the error context to an AI model that analyzes the fai
</Accordion>

<Accordion title="Sponsorship Failure">
Gas sponsorship was rejected by the gas manager policy. Verify that your [gas policy](https://dashboard.alchemy.com/gas-manager) is active, has sufficient balance, and that the transaction meets your sponsorship rules.
Gas sponsorship was rejected by the gas manager policy. Verify that your [gas policy](https://dashboard.alchemy.com/apps/latest/gas-sponsorship) is active, has sufficient balance, and that the transaction meets your sponsorship rules.
</Accordion>

<Accordion title="Session Key Error">
Expand Down
Loading
Loading