ethereum-optimism · sbvegan · Dec 2, 2025 · Nov 19, 2025 · Dec 2, 2025 · Dec 2, 2025
@@ -49,7 +49,7 @@
 *   [On OP Sepolia](https://testnet-explorer.optimism.io/address/0x420000000000000000000000000000000000000F)

 This is a push Oracle.
 OP Mainnet (and the testnets) updates the gas price parameters onchain whenever those parameters change.
 The L1 gas price, which can be volatile, is only pushed once every 5 minutes, and each time can change only by up to 20%.

 *   [Blocknative](https://docs.blocknative.com/gas-prediction) provides real-time gas estimation powered by predictive modeling to forecast gas price distribution for select OP Stack chains, including OP Mainnet and Base. The [API](https://docs.blocknative.com/gas-prediction) is also available on Ethereum Mainnet to estimate base fee costs.
@@ -60,9 +60,9 @@

 The price feeds are delivered by an aggregate of [first-party oracles](https://docs.api3.org/oev-searchers/glossary.html#first-party-oracles) using signed data and support [OEV recapture]().
 [https://docs.api3.org/dapps/integration/security-considerations.html#oracle-extractable-value-oev](https://docs.api3.org/dapps/integration/security-considerations.html#oracle-extractable-value-oev)
 Unlike traditional data feeds, reading [API3 price feeds](https://docs.api3.org/oev-searchers/in-depth/#dapps-catalog) enables dApps to auction off the right to update the price feeds to searcher bots which facilitates more efficient liquidation processes for users and LPs of DeFi money markets. The OEV recaptured is returned to the dApp.

 API3's QRNG provides dApps with truly random numbers based on quantum mechanics at no charge. More details [here](https://api3.org/)

 ### Chainlink

@@ -73,7 +73,7 @@
 Those feeds are available on the production network @ [Op Mainnet](https://docs.chain.link/data-feeds/price-feeds/addresses?network=optimism\&page=1#optimism-mainnet).

 *   Data Feeds: Chainlink Data Feeds provide a secure, reliable, and decentralized source of off-chain data to power unique smart contract use cases for DeFi and beyond.
 *   Automation: Chainlink Automation is an ultra-reliable and performant smart contract automation solution enabling developers to quickly scale their operations in a verifiable, decentralized, and cost-efficient manner, to build next-generation apps.
 *   CCIP: Chainlink CCIP provides a secure interoperability protocol for powering token transfers and sending arbitrary messages cross-chain.

 This is a push Oracle. See the [Using Data Feeds guide](https://docs.chain.link/docs/get-the-latest-price/) to learn how to use the Chainlink feeds.
@@ -84,8 +84,8 @@

 The first Oracle on Ethereum, Chronicle's decentralized Oracle network was originally built within MakerDAO for the development of DAI and is now available to builders on OP Mainnet and the Superchain.

 *   **Data Feeds**: Builders can choose from 65+ data feeds, including crypto assets, yield rates, and RWAs. Chronicle's data is sourced via custom-built data models, only utilizing Tier 1 Primary Sources, such as the markets where tokens are actively traded, including Coinbase, Binance, Uniswap, and Curve.
 *   **Transparency & Integrity**: Chronicle's Oracle network is fully transparent and verifiable. Via [The Chronicle](https://chroniclelabs.org/dashboard/oracle/DAI/USD?blockchain=OPT\&txn=0x53e60e6e79eb938e5ca3ca6c56b0795e003dd6b3a17cfd810ca5042b3d33b680\&contract=0x104916d38828DA8B83a88A1775Aa058e1F0B1647), the data supply chain for any Oracle can be viewed in real-time and historically, including data sources and the identity of all Validators/Signers. Users can cryptographically challenge the integrity of every Oracle update using the 'verify' feature. Data is independently sourced by a [community of Validators](https://chroniclelabs.org/validators), including Gitcoin, Etherscan, Infura, DeFi Saver, and MakerDAO.
 *   **Gas Efficiency:** Pioneering the Schnorr-based Oracle architecture, Chronicle's Oracles use 60-80% less gas per update than other Oracle providers. This lowest cost per update allows Push Oracle updates to be made more regularly, ensuring more accurate and granular data reporting.

 Every Oracle implementation is customized to fit your needs. Implement one of our existing data models or contact Chronicle to develop custom Oracle data feeds via [Discord](https://discord.gg/CjgvJ9EspJ) or [Email](mailto:gm@chroniclelabs.org). Developers can dive deeper into Chronicle Protocol's architecture and unique design choices [via the docs](https://docs.chroniclelabs.org/).
@@ -94,18 +94,18 @@

 [Gelato VRF](https://www.gelato.network/) enables smart contracts on Optimism to access verifiable randomness. Gelato VRF offers real randomness for blockchain applications by leveraging Drand, a trusted decentralized source for random numbers.

 Gelato VRF (Verifiable Random Function) provides trustable randomness on EVM-compatible blockchains. Here's a brief overview:

 *   Contract Deployment: Use GelatoVRFConsumerBase.sol as an interface for requesting random numbers.
 *   Requesting Randomness: Emit the RequestedRandomness event to signal the need for a random number.
 *   Processing: Gelato VRF fetches the random number from Drand.
 *   Delivery: The fulfillRandomness function delivers the random number to the requesting contract.

 Ready to integrate? Head over to the [Gelato VRF Quick Start Guide](https://docs.gelato.network/web3-services/vrf/quick-start).

 ### Pyth Network

 The Pyth Network is a financial oracle network which delivers over 400 low-latency, high-fidelity price feeds across cryptocurrencies, FX pairs, equities, ETFs, and commodities.

 *   Pyth's price data is sourced from over [95 first-party sources](https://pyth.network/publishers) including exchanges, market makers, and financial services providers.
 *   Pyth [Price Feeds](https://www.pyth.network/developers/price-feed-ids) offer both the real-time spot price of the asset as well as an accompanying confidence interval band around that price
@@ -136,7 +136,6 @@
 3.  **actively maintained developer tool** that aligns with OP's commitment to a magical developer experience (e.g., easy-to-use, easy-to-integrate, great DevX, highly-rated by community, etc.)
 
 For teams that are supporting but still establishing a user base, we encourage you to share your tool on the [community oracles page](https://github.com/ethereum-optimism/developers/blob/main/community/tools/oracles.md).
-You can also promote your tool in the [developer forum](https://github.com/ethereum-optimism/developers/discussions/categories/show-and-tell) and sign up to share your tool at the next [demo day](https://community.optimism.io/docs/contribute/demo-day/?utm_source=op-docs&utm_medium=docs).
 
 ## Next steps
 

@@ -48,12 +48,12 @@

 The Superscan currently includes:

 *   Mainnet - OP Mainnet, Base, Zora, Mode, Cyber, Orderly, Fraxtal, Public Goods Network
 *   Testnet - Zora, Mode, Orderly, Fraxtal

 ## Once Upon

 If you're building on multiple chains, Once Upon's [Superchain block explorer](https://www.onceupon.gg/) consolidates transaction data across all OP Chains, offering developers a unified view of all Superchain activity, including testnets.

 Once Upon currently supports:

@@ -63,7 +63,7 @@

 ## Tenderly

 Tenderly's [Developer Explorer](https://docs.tenderly.co/developer-explorer?mtm_campaign=ext-docs&mtm_kwd=optimism) for OP Mainnet and OP Sepolia allows you to monitor and inspect transactions, providing a high level of detail and additional tools:

 Tenderly Developer Explorer lets you:

@@ -88,9 +88,6 @@
 2.  **established user base** and OP ecosystem engagement such as governance participation, [Community Discord](https://discord.gg/optimism) or [Superchain Developer Discord](https://guild.xyz/superchain-devs) participation, etc.; and
 3.  **actively maintained developer tool** that aligns with OP's commitment to a magical developer experience (e.g., easy-to-use, easy-to-integrate, great DevX, highly rated by the community, etc.)
 
-For teams that are supporting but still establishing a user base, we encourage you to share your tool on the [community block explorers page](https://github.com/ethereum-optimism/developers/blob/main/community/tools/block-explorers.md).
-You can also promote your tool in the [developer forum](https://github.com/ethereum-optimism/developers/discussions/categories/show-and-tell) and sign up to share your tool at the next [demo day](https://community.optimism.io/docs/contribute/demo-day/?utm_source=op-docs&utm_medium=docs).
-
 ## Next Steps
 
 *   Please visit the [community block explorers page](https://github.com/ethereum-optimism/developers/blob/main/community/tools/block-explorers.md) for a listing of third-party block explorers used by the Optimism developer community.

@@ -54,9 +54,6 @@ Developer teams who want to feature products/tools on this page must meet the fo
 2.  **established user base** and OP ecosystem engagement such as governance participation, [Community Discord](https://discord.gg/optimism) or [Superchain Developer Discord](https://guild.xyz/superchain-devs) participation, etc.; and
 3.  **actively maintained developer tool** that aligns with OP's commitment to a magical developer experience (e.g., easy-to-use, easy-to-integrate, great DevX, highly rated by the community, etc.)
 
-For teams that are supporting but still establishing a user base, we encourage you to share your tool on the [community faucets page](https://github.com/ethereum-optimism/developers/blob/main/community/tools/faucets.md).
-You can also promote your tool in the [developer forum](https://github.com/ethereum-optimism/developers/discussions/categories/show-and-tell) and sign up to share your tool at the next [demo day](https://community.optimism.io/docs/contribute/demo-day/?utm_source=op-docs&utm_medium=docs).
-
 ## Next steps
 
 *   If you're new to onchain development, check out [Optimism Unleashed](https://cryptozombies.io/en/optimism) by CryptoZombies and [Superchain Builder NFT](https://web.archive.org/web/20231218203510/https://blog.thirdweb.com/guides/optimism-superchain-faucet-nft/) by ThirdWeb.

@@ -15,9 +15,9 @@
 *   Sponsor the gas fees for transactions
 *   Enable users to pay gas in the token(s) of their choice

 ## Bundlers

 The OP Stack includes support for the `eth_sendRawTransactionConditional` RPC method to assist bundlers on shared 4337 mempools. See the [specification](/op-stack/features/send-raw-transaction-conditional) for how this method is implemented in op-geth.

 If used by the chain operator, also see the supplemental [op-txproxy](/operators/chain-operators/tools/op-txproxy) service which may apply additional restrictions prior to reaching the block builder.

@@ -31,27 +31,27 @@

 ## Account abstraction tools

 Ready to enable account abstraction experiences in your app? Here's some helpful information on account abstraction infrastructure like ERC-4337 bundler and gas manager APIs that are available on OP Mainnet:

 *   [Alchemy](https://www.alchemy.com/account-abstraction): 
    Account Kit is a complete solution for account abstraction. Using Account Kit, you can create a smart contract wallet for every user that leverages account abstraction to simplify every step of your app's onboarding experience. It also offers Gas Manager and Bundler APIs for sponsoring gas and batching transactions.

 *   [Biconomy](https://docs.biconomy.io/): is an Account Abstraction toolkit that enables you to provide the simplest UX for your app or wallet. It offers modular smart accounts, as well as paymasters and bundlers as a service for sponsoring gas and executing transactions at scale.

 *   [GroupOS](https://docs.groupos.xyz/introduction/group-os): provides Smart Wallets that are ERC-4337 compliant smart wallets, offering full flexibility, programmability and extensibility as well as out-of-the-box toolkit groups need to gaslessly onboard and activate wallets to games, applications, and/or protocols.

 *   [Openfort](https://openfort.io/docs): is an open-source alternative to wallet infrastructure solutions. The core offerings—Openfort Kit, Invisible Wallet, and Cross-app Wallet - enable rapid integration of wallet functionality, intuitive onboarding, and flexible user journeys for any application or ecosystem.

 *   [Pimlico](https://docs.pimlico.io/): provides an infrastructure platform that makes building smart accounts simpler. If you are developing an ERC-4337 smart account, they provide bundlers, verifying paymasters, ERC-20 paymasters, and much more.

 *   [Reown](https://reown.com/?utm_source=optimism&utm_medium=docs&utm_campaign=backlinks) gives developers the tools to build user experiences that make digital ownership effortless, intuitive, and secure. Using Reown's AppKit SDK, you can enable your users to create a smart wallet using their social logins, configure a paymaster to sponsor gas fees, enable chain abstraction and a lot more.

 *   [Safe](https://docs.safe.global/home/what-is-safe): provides modular smart account infrastructure and account abstraction stack via their Safe\{Core\} Account Abstraction SDK, API, and Protocol.

 *   [Stackup](https://docs.stackup.sh/docs): provides smart account tooling for building account abstraction within your apps. They offer Paymaster and Bundler APIs for sponsoring gas and sending account abstraction transactions.

 *   [thirdweb](https://portal.thirdweb.com/react/v5/account-abstraction/get-started?utm_source=opdocs&utm_medium=docs):
    offers the complete tool-kit to leverage account abstraction technology to enable seamless user experiences for your users. This includes Account Factory contracts that lets your users spin up Smart Accounts, Bundler for UserOps support, and Paymaster to enable gas sponsorships. 

 ## Helpful tips

@@ -65,5 +65,3 @@
 1.  **ongoing partnership** with Optimism whether formal agreement, RPGF, RFP, collaborated on specific initiatives, etc.;
 2.  **established user base** and OP ecosystem engagement such as governance participation, [Community Discord](https://discord.gg/optimism) or [Superchain Developer Discord](https://guild.xyz/superchain-devs) participation, etc.; and
 3.  **actively maintained developer tool** that aligns with OP's commitment to a magical developer experience (e.g., easy-to-use, easy-to-integrate, great DevX, highly rated by the community, etc.)
-
-For teams that are supporting but still establishing a user base, we encourage you to share your tool in the [developer forum](https://github.com/ethereum-optimism/developers/discussions/categories/show-and-tell) and sign up to share your tool at the next [demo day](https://community.optimism.io/docs/contribute/demo-day/?utm_source=op-docs&utm_medium=docs).
@@ -100,9 +100,6 @@ The [Superchain Registry](/superchain/superchain-registry) is the authoritative
 4.  **Seek guidance:**
     Consult the [developer support](https://github.com/ethereum-optimism/developers/discussions) team for clarifications on standardization.
 
-5.  **Contribute to the ecosystem:**
-    Engage with the [Optimism Collective](https://community.optimism.io/?utm_source=op-docs&utm_medium=docs) to share feedback and propose improvements.
-
 ## References
 
 *   [OP Stack Specifications](https://specs.optimism.io/protocol/configurability.html?utm_source=op-docs&utm_medium=docs)

@@ -9,7 +9,7 @@

 The Holocene upgrade is a protocol upgrade. Learn more about it in the [Holocene notice page](https://docs.optimism.io/notices/holocene-changes). This guide shows you how to take your OP Stack chain from the L2 Output Oracle System to a permissioned Fault Proof System contract version associated with the Holocene upgrade. 

 After upgrading to OP Stack contracts v1.8.0 and enabling permissioned fault proofs, all pending (unfinalized) withdrawal proofs created on L1 are invalidated. This means that withdrawals must be manually reproven by users after the upgrade; the process is not automatic.

 ### Formatting config files

@@ -209,6 +209,5 @@
 
 ## Additional Resources
 
-*   [Optimism Documentation](https://community.optimism.io/docs/)
 *   [superchain-ops Repository](https://github.com/ethereum-optimism/superchain-ops)
 *   [Optimism Monorepo](https://github.com/ethereum-optimism/optimism)
@@ -5,11 +5,6 @@ description: Learn about the different ways you can contribute to Optimism Docs.
 
 Optimism Docs (docs.optimism.io) is an open-source project, and we welcome your contributions. Here's how you can help grow and support the Optimism Collective.
 
-<Info>
-  We recently migrated our technical docs from community.optimism.io --> docs.optimism.io.
-  So, if you contributed to either repo in 2023, don't forget to claim your [POAP token](#claim-your-gitpoap)!
-</Info>
-
 ## Ways to contribute
 
 *   [Edit existing content](#how-to-work-on-docsoptimismio): make tweaks to existing content using the ✏️ **Edit this page on GitHub** or ❤️ **Share general feedback** links on the right-side of any page.

@@ -12,7 +12,6 @@ Every contribution makes a difference — no contribution is too small. If you'r
 ## Component contributions
 
 The OP Stack is a decentralized development stack and is constantly evolving as new layers and modules are developed. Anyone can contribute components that can be considered part of the OP Stack as long as those components fit the stack's [design principles and goals](/op-stack/protocol/design-principles).
-To start contributing components to the stack, check out some of these [useful ideas](https://github.com/ethereum-optimism/ecosystem-contributions) and get to building! And don't forget that projects can also receive grants from the Collective via [RetroPGF](https://community.optimism.io/docs/citizen-house/how-retro-funding-works/?utm_source=op-docs&utm_medium=docs).
 
 ## Codebase contributions
 

@@ -347,11 +347,11 @@
     },
     {
       "source": "/identity/optimist-profile",
-      "destination": "https://community.optimism.io/identity/overview"
+      "destination": "/governance/gov-faq"
     },
     {
       "source": "/chain/identity/optimist-profile",
-      "destination": "https://community.optimism.io/identity/overview"
+      "destination": "/governance/gov-faq"
     },
     {
       "source": "/app-developers/tools/overview",
@@ -2194,6 +2194,20 @@
           }
         ]
       },
+      {
+        "tab": "How Optimism Evolves",
+        "groups": [
+          {
+            "group": "How Optimism Evolves",
+            "pages": [
+              "governance/protocol-upgrades",
+              "governance/capital-allocation",
+              "governance/evolution-and-experimentation",
+              "governance/gov-faq"
+            ]
+          }
+        ]
+      },
       {
         "tab": "Notices",
         "groups": [
@@ -2246,11 +2260,6 @@
     ],
     "global": {
       "anchors": [
-        {
-          "anchor": "Community Hub",
-          "href": "https://community.optimism.io/",
-          "icon": "users"
-        },
         {
           "anchor": "Status",
           "href": "https://status.optimism.io",

@@ -0,0 +1,74 @@
+---
+title: Capital Allocation
+description: Learn how Optimism allocates capital for long-term success.
+---
+
+## How does Optimism ensure long-term success?
+
+Optimism strives to create a sustainable ecosystem flywheel. In this flywheel, revenue contributed by OP Chains to the Optimism Collective funds open-source development and drives ecosystem growth, which strengthens the OP Stack and attracts more end-users, apps, integration partners, and chains. 
+
+In implementing this flywheel, Optimism uses a public decision making process designed to prevent short-term profit seeking at the expense of the platform, while ensuring organizations contributing the OP Stack remain accountable to tokenholders and customers. This process includes a capital allocation model, designed to avoid many of the common failure modes of corporate governance, aiming to ensure the product always remains at the cutting edge. 
+
+For more details, please see the Operating Manual. 
+
+![capital alloction](/public/img/governance/capital-allocation.png)
+
+ ## How does Optimism generate revenue?
+
+OP Chains in the Superchain earn transaction fees whenever users send transactions onchain, including for payments, trading, identity, and other applications. Each chain also pays costs to publish its activity to Ethereum for security. 
+
+OP Chains contribute a portion of their revenue to Optimism. This treasury is used to drive growth, provide shared infrastructure, and fund open source contributions that benefit the Superchain. 
+
+Superchain member chains contribute the greater of:
+
+- 15% of net transaction fee profit (transaction fees earned on L2 - costs paid to Ethereum L1), or
+- 2.5% of gross transaction fees
+
+OP Mainnet contributes 100% of its revenue to this shared treasury. 
+
+You can find more information about revenue in the [here](governance/capital-allocation.mdx).
+
+You can also find the list of wallets across L1 and OP Mainnet where the Optimism Collective Revenue earned sits [here](https://docs.google.com/spreadsheets/d/1f-uIW_PzlGQ_XFAmsf9FYiUf0N9l_nePwDVrw0D5MXY/edit?gid=155717474#gid=155717474), on the right-hand side of the Collective Contribution page.
+
+- OP Treasury Address for Foundation Allocated Budget: `0x2A82Ae142b2e62Cb7D10b55E323ACB1Cab663a26`
+    - This address hold the remaining OP tokens allocated to the Foundation, which the Foundation requires governance approval to access (via annual FND budget proposals).
+- OP Treasury Address for Foundation Approved Budget: `0x2501c477D0A35545a387Aa4A3EEe4292A9a8B3F0`
+    - This is the Foundation's OP Treasury which is available for the Foundation to utilize as the Foundation's budget granted through the initial token allocation. Transactions from this wallet are typically internal operational movements per the Foundation's needs.
+    - Additional token may be moved from `0x2…a26` to `0x2…3F0` based on governance approval of budgets.
+- OP Foundation Grants Wallet: `0x19793c7824Be70ec58BB673CA42D2779d12581BE`
+    - This Foundation wallet is used to make private OP grants. This is topped up from the OP Treasury Foundation Approved Budget wallet `0x2…B3F0` as needed.
+- OP Foundation Locked Grants Wallet: `0xE4553b743E74dA3424Ac51f8C1E586fd43aE226F`
+    - This Foundation wallet is used to hold OP for one year lockups. This is topped up from the OP Foundation Grants Wallet `0x1...81BE` as needed.
+
+## How is the treasury managed?
+
+The treasury is currently stewarded by the Foundation, but is subject to oversight by key stakeholder groups, via Optimism's public decision making process. Specifically, tokenholders, chains, apps, and users are asked to oversee annual budgets, which enable the Foundation to deploy the treasury into initiatives aimed at generated the sustainable flywheel described above. 
+
+Foundation Budget Reports can be found [here](https://gov.optimism.io/c/updates-and-announcements/foundation-budgets/) on the governance forum.
+
+The OP Token Unlock (Estimated) sheet can be found [here](https://docs.google.com/spreadsheets/d/1qVMhLmmch3s6XSbiBe8hgD4ntMkPIOhc1WrhsYsQc7M/edit?usp=sharing). 
+
+You can find more information via the Operating Manual [here](https://github.com/ethereum-optimism/OPerating-manual/blob/main/manual.md). 
+
+## What is Optimism's commitment to Open Source Software?
+
+Optimism has always been committed to funding open-source software. OP Labs, a core contributor to the OP Stack, is registered as a public benefit corporation with a mission to enhance and enshrine access to public goods. The OP Stack is MIT licensed and Optimism dedicates a significant portion of its treasury to funding public goods and open-source software.
+
+Optimism operates various grant programs to incentivize and reward open-source contributions. Grant programs can be found via [atlas.optimism.io](http://atlas.optimism.io). 
+
+## What can I do with the OP Token?
+
+The OP token was created in May of 2022, with an initial supply of 4,294,967,296 OP tokens. The token was launched as a governance token to enable tokenholders to weigh in on technical and economic decisions that impact Optimism, such as protocol upgrades and capital allocation. The Optimism Foundation estimates the total supply of circulating OP tokens to increase as detailed in [this sheet](https://docs.google.com/spreadsheets/d/1qVMhLmmch3s6XSbiBe8hgD4ntMkPIOhc1WrhsYsQc7M/). 
+
+Tokenholders can use OP to vote on:
+
+- Protocol Upgrades
+- Token Allocations
+- Adjusting Inflation
+- Removing the Director of the Optimism Foundation
+- Dissolutions
+- Elections (and representative removal)
+- Protecting the rights of tokenholders by consenting to any changes to the founding documents of the Optimism Foundation, if those changes would materially reduce their rights.
+- Ratification of Governing Documents
+
+You can find full details of what Tokenholders can vote with the Operating Manual [here](https://github.com/ethereum-optimism/OPerating-manual/blob/main/manual.md). You can sign up to vote with your tokens [here](https://vote.optimism.io/delegates).