From 4746616c2c96925868ca7a3d12ebee496554b3a7 Mon Sep 17 00:00:00 2001 From: Dan Date: Fri, 9 Jan 2026 15:40:47 -0600 Subject: [PATCH] docs(aa-infra): add polygon network restrictions --- fern/docs.yml | 6 ++ .../pages/overview/supported-chains.mdx | 65 +++++++++---------- .../resources/chain-reference/polygon-pos.mdx | 52 +++++++++++++++ 3 files changed, 90 insertions(+), 33 deletions(-) create mode 100644 fern/wallets/pages/resources/chain-reference/polygon-pos.mdx diff --git a/fern/docs.yml b/fern/docs.yml index db6949584..bcc842bd6 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -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 diff --git a/fern/wallets/pages/overview/supported-chains.mdx b/fern/wallets/pages/overview/supported-chains.mdx index 52328ee5c..d51db7e60 100644 --- a/fern/wallets/pages/overview/supported-chains.mdx +++ b/fern/wallets/pages/overview/supported-chains.mdx @@ -18,8 +18,7 @@ We’re constantly expanding support and can quickly spin up new chains on reque - 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). The chain identifiers (e.g. base-mainnet) are used for RPC endpoint URLs: @@ -27,36 +26,36 @@ https://NETWORK_IDENTIFIER.g.alchemy.com/v2/API_KEY. -| 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) | ✅ | ✅ | diff --git a/fern/wallets/pages/resources/chain-reference/polygon-pos.mdx b/fern/wallets/pages/resources/chain-reference/polygon-pos.mdx new file mode 100644 index 000000000..d3444e7bf --- /dev/null +++ b/fern/wallets/pages/resources/chain-reference/polygon-pos.mdx @@ -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**. + + + 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). + + +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. + + + 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). + + +Users that attempt to use a sponsored transaction with a different API may see the following Solidity error: + + + ```Solidity + error SenderNotAllowed(address sender); + ``` +