Skip to content

docs(aa-infra): add polygon network restrictions #922

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
dancoombs wants to merge 1 commit into
base: main
Choose a base branch
from
+90 −33
Open

docs(aa-infra): add polygon network restrictions #922

Show file tree
Hide file tree
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
6 changes: 6 additions & 0 deletions fern/docs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1241,6 +1241,12 @@ navigation:
- section: Resources
skip-slug: true
contents:
- section: Chain Reference
slug: resources/chain-reference
contents:
- page: Polygon PoS
slug: polygon-pos
path: wallets/pages/resources/chain-reference/polygon-pos.mdx
- page: Features
slug: wallets/resources/features
path: wallets/pages/features.mdx
Expand Down
65 changes: 32 additions & 33 deletions fern/wallets/pages/overview/supported-chains.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,45 +18,44 @@ We’re constantly expanding support and can quickly spin up new chains on reque
</Info>

<Tip>
Alchemy Smart Wallets will be supported on **Monad mainnet** and **MegaETH
mainnet** Day 1 (coming soon).
Alchemy Smart Wallets will be supported on **MegaETH mainnet** Day 1 (coming soon).
</Tip>

The chain identifiers (e.g. base-mainnet) are used for RPC endpoint URLs:
https://NETWORK_IDENTIFIER.g.alchemy.com/v2/API_KEY.

<StickyTable>

| Chain | Mainnet | Testnet | Bundler | Gas Sponsorship |
| ------------- | ---------------------------- | ---------------------------- | ------- | --------------- |
| AnimeChain | ✅ 69000 (anime-mainnet) | ✅ 6900 (anime-sepolia) | ✅ | ✅ |
| Arbitrum Nova | ✅ 42170 (arbnova-mainnet) | ❌ | ✅ | ✅ |
| Arbitrum One | ✅ 42161 (arb-mainnet) | ✅ 421614 (arb-sepolia) | ✅ | ✅ |
| Base | ✅ 8453 (base-mainnet) | ✅ 84532 (base-sepolia) | ✅ | ✅ |
| BNB | ✅ 56 (bnb-mainnet) | ✅ 97 (bnb-testnet) | ✅ | ✅ |
| BeraChain | ✅ 80094 (berachain-mainnet) | ✅ 80084 (berachain-bartio) | ✅ | ✅ |
| Celo | ✅ 42220 (celo-mainnet) | ✅ 44787 (celo-alfajores) | ✅ | ✅ |
| Ethereum | ✅ 1 (eth-mainnet) | ✅ 11155111 (eth-sepolia) | ✅ | ✅ |
| Frax | ✅ 252 (frax-mainnet) | ❌ | ✅ | ✅ |
| Hyperliquid | ✅ 999 (hyperliquid-mainnet) | ✅ 998 (hyperliquid-testnet) | ✅ | ✅ |
| Ink | ✅ 57073 (ink-mainnet) | ✅ 763373 (ink-sepolia) | ✅ | ✅ |
| Monad | ❌ | ✅ 10143 (monad-testnet) | ✅ | ✅ |
| opBNB | ✅ 204 (opbnb-mainnet) | ✅ 5611 (opbnb-testnet) | ✅ | ✅ |
| Optimism | ✅ 10 (opt-mainnet) | ✅ 11155420 (opt-sepolia) | ✅ | ✅ |
| Polygon | ✅ 137 (polygon-mainnet) | ✅ 80002 (polygon-amoy) | ✅ | ✅ |
| Polynomial | ✅ 8008 (polynomial-mainnet) | ✅ 8009 (polynomial-sepolia) | ✅ | ✅ |
| Race | ✅ 6805 (race-mainnet) | ✅ 6806 (race-sepolia) | ✅ | ✅ |
| Rise | ❌ | ✅ 11155931 (rise-testnet) | ✅ | ✅ |
| Shape | ✅ 360 (shape-mainnet) | ✅ 11011 (shape-sepolia) | ✅ | ✅ |
| Solana | ✅ (solana-mainnet) | ✅ solana-devnet | ❌ | ✅ |
| Soneium | ✅ 1868 (soneium-mainnet) | ✅ 1946 (soneium-minato) | ✅ | ✅ |
| Story | ✅ 1514 (story-mainnet) | ✅ 1315 (story-aeneid) | ✅ | ✅ |
| UniChain | ✅ 130 (unichain-mainnet) | ✅ 1301 (unichain-sepolia) | ✅ | ✅ |
| WorldChain | ✅ 480 (worldchain-mainnet) | ✅ 4801 (worldchain-sepolia) | ✅ | ✅ |
| Zora | ✅ 7777777 (zora-mainnet) | ✅ 999999999 (zora-sepolia) | ✅ | ✅ |
| Boba | ✅ 288 (boba-mainnet) | ✅ 28882 (boba-sepolia) | ✅ | ✅ |
| Degen | ✅ 666666666 (degen-mainnet) | ❌ | ❌ | ❌ |
| Openloot | ❌ | ✅ 905905 (openloot-sepolia) | ✅ | ✅ |
| Tea | ❌ | ✅ 10218 (tea-sepolia) | ✅ | ✅ |
| Chain | Mainnet | Testnet | Bundler | Gas Sponsorship |
| --------------------------------------------------------- | ---------------------------- | ---------------------------- | ------- | --------------- |
| AnimeChain | ✅ 69000 (anime-mainnet) | ✅ 6900 (anime-sepolia) | ✅ | ✅ |
| Arbitrum Nova | ✅ 42170 (arbnova-mainnet) | ❌ | ✅ | ✅ |
| Arbitrum One | ✅ 42161 (arb-mainnet) | ✅ 421614 (arb-sepolia) | ✅ | ✅ |
| Base | ✅ 8453 (base-mainnet) | ✅ 84532 (base-sepolia) | ✅ | ✅ |
| BNB | ✅ 56 (bnb-mainnet) | ✅ 97 (bnb-testnet) | ✅ | ✅ |
| BeraChain | ✅ 80094 (berachain-mainnet) | ✅ 80084 (berachain-bartio) | ✅ | ✅ |
| Celo | ✅ 42220 (celo-mainnet) | ✅ 44787 (celo-alfajores) | ✅ | ✅ |
| Ethereum | ✅ 1 (eth-mainnet) | ✅ 11155111 (eth-sepolia) | ✅ | ✅ |
| Frax | ✅ 252 (frax-mainnet) | ❌ | ✅ | ✅ |
| Hyperliquid | ✅ 999 (hyperliquid-mainnet) | ✅ 998 (hyperliquid-testnet) | ✅ | ✅ |
| Ink | ✅ 57073 (ink-mainnet) | ✅ 763373 (ink-sepolia) | ✅ | ✅ |
| Monad | ✅ 143 (monad-mainnet) | ✅ 10143 (monad-testnet) | ✅ | ✅ |
| opBNB | ✅ 204 (opbnb-mainnet) | ✅ 5611 (opbnb-testnet) | ✅ | ✅ |
| Optimism | ✅ 10 (opt-mainnet) | ✅ 11155420 (opt-sepolia) | ✅ | ✅ |
| [Polygon](/wallets/resources/chain-reference/polygon-pos) | ✅ 137 (polygon-mainnet) | ✅ 80002 (polygon-amoy) | ✅ | ✅ |
| Polynomial | ✅ 8008 (polynomial-mainnet) | ✅ 8009 (polynomial-sepolia) | ✅ | ✅ |
| Race | ✅ 6805 (race-mainnet) | ✅ 6806 (race-sepolia) | ✅ | ✅ |
| Rise | ❌ | ✅ 11155931 (rise-testnet) | ✅ | ✅ |
| Shape | ✅ 360 (shape-mainnet) | ✅ 11011 (shape-sepolia) | ✅ | ✅ |
| Solana | ✅ (solana-mainnet) | ✅ solana-devnet | ❌ | ✅ |
| Soneium | ✅ 1868 (soneium-mainnet) | ✅ 1946 (soneium-minato) | ✅ | ✅ |
| Story | ✅ 1514 (story-mainnet) | ✅ 1315 (story-aeneid) | ✅ | ✅ |
| UniChain | ✅ 130 (unichain-mainnet) | ✅ 1301 (unichain-sepolia) | ✅ | ✅ |
| WorldChain | ✅ 480 (worldchain-mainnet) | ✅ 4801 (worldchain-sepolia) | ✅ | ✅ |
| Zora | ✅ 7777777 (zora-mainnet) | ✅ 999999999 (zora-sepolia) | ✅ | ✅ |
| Boba | ✅ 288 (boba-mainnet) | ✅ 28882 (boba-sepolia) | ✅ | ✅ |
| Degen | ✅ 666666666 (degen-mainnet) | ❌ | ❌ | ❌ |
| Openloot | ❌ | ✅ 905905 (openloot-sepolia) | ✅ | ✅ |
| Tea | ❌ | ✅ 10218 (tea-sepolia) | ✅ | ✅ |

</StickyTable>
52 changes: 52 additions & 0 deletions fern/wallets/pages/resources/chain-reference/polygon-pos.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
title: Polygon PoS Smart Wallet Reference
---

Polygon PoS is supported in both our Wallet APIs and our Low-Level Infra APIs.
It has access to our capabilities such as EIP-7702 support, gas sponsorship, transaction batching, and more.

The Polygon PoS network lacks a reliable private mempool for our bundler to submit its transactions through. This leads
to a few restrictions that we must enforce in order to protect our bundler and users from front-running attacks.

## Network Restrictions

### MEV Protection

Transactions are submitted to the Polygon Mainnet and Polygon Amoy public mempools. We do not offer any MEV protection for users on Polygon POS.

### Transactions

On Polygon Mainnet transactions (user operations) submitted through either our Wallet APIs or our Low-Level Bundler API **must use the Alchemy Gas Manager**.

<Info>
We will begin enforcing this on 01/30/2026.

Request support by reaching out to wallets@alchemy.com or filling out this
[form](https://alchemy.chilipiper.com/router/wallet-services-chain-support-requests).
</Info>

This is done to ensure the following:

1. The onchain account itself is not restricted in anyway. If the user wishes to upgrade/delegate their account or use their account with another provider, they can.
2. All transactions submitted through our bundler are protected from front-running as our Gas Manager requires transactions to be submitted through trusted EOAs.

### Gas Sponsorship

On Polygon Mainnet and Polygon Amoy transactions that are sponsored by our Gas Manager **must** be submitted through either our Wallet APIs or Low-Level Bundler API.

This is due to the new logic in our Gas Manager contracts that requires transactions to be submitted through trusted EOAs.

<Info>
We will begin enforcing this on 01/30/2026.

Request support by reaching out to wallets@alchemy.com or filling out this
[form](https://alchemy.chilipiper.com/router/wallet-services-chain-support-requests).
</Info>

Users that attempt to use a sponsored transaction with a different API may see the following Solidity error:

<CodeBlocks>
```Solidity
error SenderNotAllowed(address sender);
```
</CodeBlocks>
Loading