ethereum-optimism · bradleycamacho · Feb 26, 2025 · Feb 18, 2025 · Feb 21, 2025 · Feb 21, 2025
@@ -1,5 +1,6 @@
 {
   "pectra-changes": "Preparing for Pectra breaking changes",
   "holocene-changes": "Preparing for Holocene breaking changes",
-  "sdk-deprecation": "Preparing for Optimism SDK deprecation"
+  "sdk-deprecation": "Preparing for Optimism SDK deprecation",
+  "custom-gas-tokens-deprecation": "Preparing for Custom Gas Tokens deprecation"
 }
@@ -0,0 +1,58 @@
+---
+title: Deprecation of the Custom Gas Tokens
+lang: en-US
+description: This page outlines the details of the Custom Gas Tokens deprecation and points towards alternatives
+---
+
+## Deprecation of Custom Gas Tokens
+
+The Custom Gas Token beta feature has been deprecated. Beta features give developers access to early versions of highly requested features, allowing us to validate demand through usage data and user feedback. Since May 2024, usage of the custom gas token beta feature has steadily declined as ERC-4337 and robust paymaster services gained traction. 
+
+Based on this trend, the beta feature was deprecated instead of being moved to the OP Stack standard configuration. While the custom gas token code has been removed from the Optimism monorepo, chains can choose to maintain their own OP Stack Fork at their own risk. Future upgrades to the OP Stack will not be compatible with custom gas tokens. Options for existing chains that use custom gas tokens and new chains are discussed below.
+
+Additionally, advancements in Account Abstraction (AA) tooling now enable gas payments in any token, offering better alternatives for the limited number of chains that require this feature.
+
+
+## Highlights
+
+*   Code removal: The Custom Gas Token code has been removed from the Optimism monorepo in the following PRs [1](https://github.com/ethereum-optimism/optimism/pull/13686), [2](https://github.com/ethereum-optimism/optimism/pull/13921), [3](https://github.com/ethereum-optimism/optimism/pull/1409).
+*   Use AA Tooling: New chains looking to enable Custom Gas Token functionality should utilize paymasters to enable the same functionality
+*   End of developer support: OP Labs Developer Support will no longer address CGT-related issues or requests.
+
+## Options for new chains
+
+The Optimism ecosystem is focusing on interoperability within the Superchain, with efforts and incentives directed towards [standard configured chains](/superchain/standard-configuration). Some options are:
+
+*   All new chains launch with the standard ETH gas token configuration.
+*   Utilize Account Abstraction tooling to allow users to pay gas fees in alternative tokens instead of relying on Custom Gas Tokens.
+    *   For example, a given chain can maintain ETH as its protocol gas token while using AA tooling to permit payments in their native token.
+
+There are many account abstractions providers in the space. You should find the correct one for your needs, but we've [compiled a list](/app-developers/tools/build/account-abstraction#account-abstraction-tools) to get you started.  
+
+## Options for existing chains
+
+For existing chains that utilize Custom Gas Token, there are a few paths forward:
+
+*   You can continue to operate your chain as is and not pull in the latest upgrades to the OP Stack.
+*   At your own risk, you can start maintaining an OP Stack fork that adds back in the CGT code, upstreaming the latest OP stack upgrades into your fork- which was removed from the Optimism monorepo in the following PRs [1](https://github.com/ethereum-optimism/optimism/pull/13686), [2](https://github.com/ethereum-optimism/optimism/pull/13921), [3](https://github.com/ethereum-optimism/optimism/pull/1409).
+*   You can launch a new standard configuration chain and coordinate a migration of applications and users from your current Custom Gas Token chain to the new chain.
+
+## Risks of continued use of Custom Gas Tokens
+
+For any chain considering CGT post-deprecation, be aware of the following risks:
+
+*   Fee mechanism flaws: Fees are charged as a scalar on blob fees denominated in ETH. This means CGT chains will either drastically overcharge or undercharge users for transaction fees relative to their L1 Data Availability costs.
+
+*   Higher overhead for RaaS providers: Managing CGT chains requires RaaS providers to assume additional risk exposure to the custom gas token asset.
+
+*   Security concerns: The CGT code modifies the L1 `OptimismPortal`, where all native assets are stored, and will not have undergone third-party auditing.
+
+*   Lack of future compatibility: Without official support from core protocol developers, there is no guarantee that future OP Stack upgrades will function properly with CGT-based chains.
+
+### Need help?
+
+For further assistance or questions about this migration, feel free to reach out through the following channels:
+
+*   Connect with us on [Discord](https://discord.gg/optimism) for community support
+*   Join us on our [developer forum](https://github.com/ethereum-optimism/developers/discussions) for discussions, questions, and general support.
+*   Open an [issue on our GitHub repository](https://github.com/ethereum-optimism/docs/issues) for documentation-related concerns
@@ -967,37 +967,6 @@ instead of the older output oracle mechanism.
 
 ***
 
-### Custom Gas Token
-
-The Custom Gas Token configuration lets OP Stack chain operators deploy their 
-chain allowing a specific ERC-20 token to be deposited in as the native token 
-to pay for gas fees. Learn more [here](/stack/beta-features/custom-gas-token).
-
-***
-
-#### useCustomGasToken
-
-UseCustomGasToken is a flag to indicate that a custom gas token should be used.
-
-*   **Type:** boolean
-*   **Default value:** None
-*   **Recommended value:** 
-*   **Notes:** 
-*   **Standard Config Requirement:**  Non-standard feature.
-
-***
-
-#### customGasTokenAddress
-
-CustomGasTokenAddress is the address of the ERC20 token to be used to pay for
-gas on L2.
-
-*   **Type:** Address
-*   **Default value:** None
-*   **Recommended value:** 
-*   **Notes:** Must not be `address(0)`.
-*   **Standard Config Requirement:**  Non-standard feature.
-
 ### Alt-DA Mode
 
 Alt-DA Mode enables seamless integration of various Data Availability (DA) 

@@ -10,15 +10,13 @@ import { Card, Cards } from 'nextra/components'
 
 # Features
 
-This section provides information on various features for chain operators. You'll find guides and overviews to help you understand and work with topics such as running an alternative data availability mode chain, implementing the bridged USDC standard on the OP Stack, running a custom gas token chain, OP Stack preinstalls, and span batches.
+This section provides information on various features for chain operators. You'll find guides and overviews to help you understand and work with topics such as running an alternative data availability mode chain, implementing the bridged USDC standard on the OP Stack, OP Stack preinstalls, and span batches.
 
 <Cards>
   <Card title="How to run an alt Da mode chain" href="/operators/chain-operators/features/alt-da-mode" />
 
   <Card title="Bridged usdc standard on the op stack" href="/operators/chain-operators/features/bridged-usdc-standard" />
 
-  <Card title="How to run a custom gas token chain" href="/operators/chain-operators/features/custom-gas-token" />
-
   <Card title="Op stack preinstalls" href="/operators/chain-operators/features/preinstalls" />
 
   <Card title="Span batches" href="/operators/chain-operators/features/span-batches" />

@@ -1,7 +1,6 @@
 {
     "preinstalls": "Preinstalls",
     "alt-da-mode": "Run an Alt-DA Mode chain",
-    "custom-gas-token": "Run a custom gas token chain",
     "span-batches": "Use and enable span batches on your chain",
     "bridged-usdc-standard": "Bridged USDC Standard for the OP Stack"
 }
@@ -29,11 +29,6 @@ You should use at least the following compatible op\* versions when running your
 *   op-batcher/v1.9.1
 *   [Latest version of op-geth](https://github.com/ethereum-optimism/op-geth/releases/latest)
 
-
-<Callout type="info">
-  If you are trying to launch an Alt-DA Mode Chain using a custom gas token, follow the contract deployment instructions in our [Custom Gas Token docs](/operators/chain-operators/features/custom-gas-token).
-</Callout>
-
 <Steps>
   ### Setup your DA server
 

@@ -54,10 +54,4 @@ Explore our current beta features below. Each feature includes links to detailed
 
 {' '}
 
-<Card
-  title="Custom Gas Token"
-  href="/stack/beta-features/custom-gas-token"
-  icon={<img src="/img/icons/shapes.svg" />}
-/>
-
 </Cards>
@@ -1,4 +1,3 @@
 {
-  "custom-gas-token": "Custom gas token",
   "alt-da-mode": "Alt-DA Mode"
 }