OffchainLabs · anegg0 · Nov 12, 2025 · Nov 13, 2025 · Nov 13, 2025 · Nov 13, 2025
diff --git a/.gitmodules b/.gitmodules
@@ -3,6 +3,3 @@
 	url = https://github.com/OffchainLabs/arbitrum-sdk
 	branch = main
 
-[submodule "stylus-by-example"]
-	path = submodules/stylus-by-example
-	url = https://github.com/offchainlabs/stylus-by-example.git
diff --git a/docs/build-decentralized-apps/01-quickstart-solidity-remix.mdx b/docs/build-decentralized-apps/01-quickstart-solidity-remix.mdx
@@ -5,7 +5,7 @@ author: symbolpunk
 user_story: As a web2 developer, I want to onboard into Arbitrum by building and deploying my first smart contract, and knowing how to build a web widget interacting with it.
 content_type: quickstart
 slug: /build-decentralized-apps/quickstart-solidity-remix
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import { VanillaAdmonition } from '@site/src/components/VanillaAdmonition/';

diff --git a/docs/build-decentralized-apps/02-how-to-estimate-gas.mdx b/docs/build-decentralized-apps/02-how-to-estimate-gas.mdx
@@ -3,7 +3,7 @@ title: 'How to estimate gas in Arbitrum'
 description: Learn how to estimate gas before submitting transactions.
 author: TucksonDev
 content_type: how-to
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 :::info Looking for Stylus guidance?

diff --git a/docs/build-decentralized-apps/03-public-chains.mdx b/docs/build-decentralized-apps/03-public-chains.mdx
@@ -3,7 +3,7 @@ title: 'Arbitrum chains overview'
 description: A high level description of the Arbitrum chains available
 user_story: As a developer, I want to understand the different Arbitrum chains and how they relate to each other.
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import { AddressExplorerLink as AEL } from '@site/src/components/AddressExplorerLink';

diff --git a/docs/build-decentralized-apps/04-cross-chain-messaging.mdx b/docs/build-decentralized-apps/04-cross-chain-messaging.mdx
@@ -3,7 +3,7 @@ title: 'Cross-chain messaging overview'
 description: Learn about cross-chain messaging in Arbitrum
 user_story: As a developer, I want to understand how cross-chain messaging works in Arbitrum.
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 The Arbitrum protocol and related tooling makes it easy for developers to build cross-chain applications; i.e., applications that involve sending messages from Ethereum to an Arbitrum chain, and/or from an Arbitrum chain to Ethereum.

diff --git a/docs/build-decentralized-apps/arbitrum-vs-ethereum/01-comparison-overview.mdx b/docs/build-decentralized-apps/arbitrum-vs-ethereum/01-comparison-overview.mdx
@@ -6,7 +6,7 @@ author: jose-franco
 sme: jose-franco
 target_audience: developers who want to build on Arbitrum
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 Arbitrum's design is to be as compatible and consistent with Ethereum as possible, from its high-level RPCs to its low-level bytecode and everything in between. <a data-quicklook-from="dapp">Decentralized app</a> developers with experience building on Ethereum will likely find that little to no new specific knowledge is required to build on Arbitrum.

diff --git a/docs/build-decentralized-apps/arbitrum-vs-ethereum/02-block-numbers-and-time.mdx b/docs/build-decentralized-apps/arbitrum-vs-ethereum/02-block-numbers-and-time.mdx
@@ -6,7 +6,7 @@ author: dzgoldman, jose-franco
 sme: jose-franco
 target_audience: developers who want to build on Arbitrum
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import { VanillaAdmonition } from '@site/src/components/VanillaAdmonition/';

diff --git a/docs/build-decentralized-apps/arbitrum-vs-ethereum/03-rpc-methods.mdx b/docs/build-decentralized-apps/arbitrum-vs-ethereum/03-rpc-methods.mdx
@@ -5,7 +5,7 @@ description: This concept page provides information about the differences betwee
 target_audience: developers who want to build on Arbitrum
 author: dzgoldman
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 Although the majority of RPC methods follow the same behavior as in Ethereum, some methods may produce a different result or add more information when used on an Arbitrum chain. This page covers the differences in response body fields you'll find when calling RPC methods on an Arbitrum chain vs on Ethereum.
@@ -142,7 +142,7 @@ If the sync process encounters an error while trying to collect the data above t
 :::info
 
 The `cargo-stylus` command-line tool uses the `stylusTracer` to replay transactions locally inside a debugger.
-More information can be found on [How to debug Stylus transactions using Cargo Stylus Replay](/stylus/how-tos/debugging-tx).
+More information can be found on [How to debug Stylus transactions using Cargo Stylus Replay](/stylus/cli-tools/debugging-tx).
 
 :::
 

diff --git a/docs/build-decentralized-apps/arbitrum-vs-ethereum/04-solidity-support.mdx b/docs/build-decentralized-apps/arbitrum-vs-ethereum/04-solidity-support.mdx
@@ -5,7 +5,7 @@ description: This concept page provides information about the differences betwee
 target_audience: developers who want to build on Arbitrum
 author: dzgoldman
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 Arbitrum chains are Ethereum-compatible and, therefore, allow you to trustlessly deploy Solidity smart contracts, as well as contracts written in Vyper or any other language that compiles to EVM bytecode. However, when calling certain properties and functions on a Solidity smart contract, there are some differences between the result you'd obtain if that contract were on Ethereum and the result on Arbitrum.

diff --git a/docs/build-decentralized-apps/custom-gas-token-sdk.mdx b/docs/build-decentralized-apps/custom-gas-token-sdk.mdx
@@ -5,7 +5,7 @@ author: Mehdi Salehi
 sme: Mehdi Salehi
 target_audience: 'Developers deploying and maintaining Arbitrum chains.'
 sidebar_position: 2
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 Arbitrum SDK is a TypeScript library for client-side interactions with Arbitrum. It provides common helper functionality as well as access to the underlying smart contract interfaces.

diff --git a/docs/build-decentralized-apps/nodeinterface/01-overview.mdx b/docs/build-decentralized-apps/nodeinterface/01-overview.mdx
@@ -3,7 +3,7 @@ title: 'NodeInterface overview'
 description: A high level description of what the NodeInterface is and how it works
 user_story: As a developer, I want to understand what the NodeInterface is and how it works.
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 <!-- todo: remove this doc, redirect to existing ref doc -->

diff --git a/docs/build-decentralized-apps/nodeinterface/02-reference.mdx b/docs/build-decentralized-apps/nodeinterface/02-reference.mdx
@@ -3,7 +3,7 @@ title: 'NodeInterface reference'
 description: A reference page of the NodeInterface available on Arbitrum chains
 user_story: As a developer, I want to understand the specific methods available in the NodeInterface
 content_type: reference
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 The Arbitrum Nitro software includes a special `NodeInterface` contract available at address `0xc8` that is only accessible via RPCs (it's not actually deployed onchain, and thus can't be called by smart contracts). This reference page documents the specific calls available in the `NodeInterface`. For a more conceptual description of what it is and how it works, please refer to the [`NodeInterface` conceptual page](/build-decentralized-apps/nodeinterface/01-overview.mdx).

diff --git a/docs/build-decentralized-apps/oracles/01-overview.mdx b/docs/build-decentralized-apps/oracles/01-overview.mdx
@@ -5,7 +5,7 @@ description: A high level description of what oracles are
 user_story: As a developer, I want to understand what oracles are and how they work.
 content_type: concept
 sidebar_label: Oracles
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import ImageZoom from '@site/src/components/ImageZoom';

diff --git a/docs/build-decentralized-apps/precompiles/01-overview.mdx b/docs/build-decentralized-apps/precompiles/01-overview.mdx
@@ -3,7 +3,7 @@ title: 'Precompiles overview'
 description: A high level description of what precompiles are and how they work
 user_story: As a developer, I want to understand what precompiles are and how they work.
 content_type: concept
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 Precompiles are predefined smart contracts that have special addresses and provide specific functionality which is executed not at the EVM bytecode level, but natively by the Arbitrum client itself. Precompiles are primarily used to introduce specific functions that would be computationally expensive if executed in EVM bytecode, and functions that facilitate the interaction between the parent chain and the child chain. By having them natively in the Arbitrum client, they can be optimized for performance.

diff --git a/docs/build-decentralized-apps/precompiles/02-reference.mdx b/docs/build-decentralized-apps/precompiles/02-reference.mdx
@@ -3,7 +3,7 @@ title: 'Precompiles reference'
 description: A reference page of all precompiles available on Arbitrum chains
 user_story: As a developer, I want to understand the most useful precompiles available on Arbitrum chains and how to use them.
 content_type: reference
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 ArbOS provides child chain-specific precompiles with methods smart contracts can call the same way they can solidity functions. This reference page exhaustively documents the specific calls ArbOS makes available through precompiles. For a more conceptual description of what precompiles are and how they work, please refer to the [precompiles conceptual page](/build-decentralized-apps/precompiles/01-overview.mdx).

diff --git a/docs/build-decentralized-apps/reference/01-node-providers.mdx b/docs/build-decentralized-apps/reference/01-node-providers.mdx
@@ -3,7 +3,7 @@ title: 'RPC endpoints and providers'
 description: Find available RPC endpoints and providers in the ecosystem
 reader_audience: developers who want to build on Arbitrum
 content_type: overview
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import ArbitrumRpcEndpoints from '../../partials/_reference-arbitrum-rpc-endpoints-partial.mdx';

diff --git a/docs/build-decentralized-apps/reference/02-contract-addresses.mdx b/docs/build-decentralized-apps/reference/02-contract-addresses.mdx
@@ -6,7 +6,7 @@ author: anegg0
 sme: anegg0
 user_story: As a current or prospective Arbitrum user I need to know to what addresses Arbitrum contracts have been deployed.
 content_type: reference
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import ArbitrumContractAddresses from '../../partials/_reference-arbitrum-contract-addresses-partial.mdx';

diff --git a/docs/build-decentralized-apps/reference/03-chain-params.mdx b/docs/build-decentralized-apps/reference/03-chain-params.mdx
@@ -3,7 +3,7 @@ title: 'Chain parameters'
 description: Information about important system parameters for public Arbitrum chains
 user_story: As a developer, I want to understand the system parameters for the public Arbitrum chains.
 content_type: overview
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 | Param                | Description                                                                                               | Arbitrum One                                                                                | Arbitrum Nova                                                                           | Arb Sepolia                                                                                   |

diff --git a/docs/build-decentralized-apps/reference/04-development-frameworks.mdx b/docs/build-decentralized-apps/reference/04-development-frameworks.mdx
@@ -3,7 +3,7 @@ title: 'Development frameworks'
 description: An overview of popular development frameworks that exist in the Arbitrum ecosystem
 user_story: As a developer, I want to understand the popular development frameworks that exist in the Arbitrum ecosystem.
 content_type: overview
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import KnowMoreToolsBox from '../../for-devs/partials/_know-more-tools-box-partial.mdx';

diff --git a/docs/build-decentralized-apps/reference/05-web3-libraries-tools.mdx b/docs/build-decentralized-apps/reference/05-web3-libraries-tools.mdx
@@ -3,7 +3,7 @@ title: 'Web3 libraries and tools'
 description: An overview of some popular Web3 libraries that help developers interact with the Ethereum and Arbitrum blockchains.
 user_story: As a developer, I want to understand what Web3 libraries and tools are available in the Ethereum and Arbitrum ecosystems.
 content_type: overview
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import KnowMoreToolsBox from '../../for-devs/partials/_know-more-tools-box-partial.mdx';

diff --git a/docs/build-decentralized-apps/reference/06-monitoring-tools-block-explorers.mdx b/docs/build-decentralized-apps/reference/06-monitoring-tools-block-explorers.mdx
@@ -3,7 +3,7 @@ title: 'Monitoring tools and block explorers'
 description: An overview of popular monitoring tools and block explorers that exist in the Arbitrum ecosystem
 user_story: As a developer, I want to understand what monitoring tools and block explorers are available in the Arbitrum ecosystem.
 content_type: overview
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import KnowMoreToolsBox from '../../for-devs/partials/_know-more-tools-box-partial.mdx';

diff --git a/docs/build-decentralized-apps/reference/07-debugging-tools.mdx b/docs/build-decentralized-apps/reference/07-debugging-tools.mdx
@@ -3,7 +3,7 @@ title: 'Debugging tools'
 description: An overview of popular debugging tools that exist in the Arbitrum ecosystem
 user_story: As a developer, I want to understand what debugging tools are available in the Arbitrum ecosystem.
 content_type: overview
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import KnowMoreToolsBox from '../../for-devs/partials/_know-more-tools-box-partial.mdx';

diff --git a/docs/build-decentralized-apps/reference/08-mainnet-risks.mdx b/docs/build-decentralized-apps/reference/08-mainnet-risks.mdx
@@ -2,7 +2,7 @@
 title: 'Arbitrum: Understanding the risks'
 description: 'Understand the risks associated with cutting-edge software development'
 author: dzgoldman
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 # Arbitrum: Understanding the risks

diff --git a/docs/build-decentralized-apps/token-bridging/01-overview.mdx b/docs/build-decentralized-apps/token-bridging/01-overview.mdx
@@ -5,7 +5,7 @@ author: dzgoldman
 user_story: As a developer, I want to understand how the token bridge works and what options exist to bridge assets between layers.
 content_type: overview
 sidebar_position: 1
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 Token bridging is a fundamental aspect of any Layer 2 (child chain) protocol. Arbitrum uses its ability to pass messages between parent and child chains (see [Cross-chain messaging](/build-decentralized-apps/04-cross-chain-messaging.mdx)) to enable projects to move assets between Ethereum and an Arbitrum chain trustlessly, and vice versa. Any asset and asset type in principle can be bridged, including `ETH`, `ERC-20` tokens, and `ERC-721` tokens, among others.

diff --git a/docs/build-decentralized-apps/token-bridging/02-token-bridge-ether.mdx b/docs/build-decentralized-apps/token-bridging/02-token-bridge-ether.mdx
@@ -5,7 +5,7 @@ author: dzgoldman
 user_story: As a developer, I want to understand how bridging ether works on Arbitrum
 content_type: concept
 sidebar_position: 2
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import ImageZoom from '@site/src/components/ImageZoom';

diff --git a/docs/build-decentralized-apps/token-bridging/03-token-bridge-erc20.mdx b/docs/build-decentralized-apps/token-bridging/03-token-bridge-erc20.mdx
@@ -5,7 +5,7 @@ author: dzgoldman
 user_story: As a developer, I want to understand how ERC-20 token bridging works on Arbitrum, and the architecture of the token bridge.
 content_type: concept
 sidebar_position: 3
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 import ImageZoom from '@site/src/components/ImageZoom';

diff --git a/...ntralized-apps/token-bridging/bridge-tokens-programmatically/01-get-started.mdx b/...ntralized-apps/token-bridging/bridge-tokens-programmatically/01-get-started.mdx
@@ -3,7 +3,7 @@ title: 'Get started with token bridging'
 description: Learn the different options available to bridge tokens programmatically
 user_story: As a developer, I want to understand how to bridge tokens between Ethereum and Arbitrum.
 content_type: overview
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 Token bridging is a fundamental aspect of any child chain protocol. It allows projects to quickly integrate with the Arbitrum ecosystem by leveraging their existing parent chain tokens.

diff --git a/...en-bridging/bridge-tokens-programmatically/02-how-to-bridge-tokens-standard.mdx b/...en-bridging/bridge-tokens-programmatically/02-how-to-bridge-tokens-standard.mdx
@@ -3,7 +3,7 @@ title: "Bridge tokens via Arbitrum's standard `ERC-20` gateway"
 description: Learn how to programmatically bridge tokens between Ethereum and Arbitrum using Arbitrum’s standard ER-C20 gateway
 user_story: As a developer, I want to understand how to bridge tokens between Ethereum and Arbitrum using the standard ER-C20 gateway.
 content_type: how-to
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 In this how-to, you’ll learn how to bridge your own token between Ethereum (parent chain) and Arbitrum (child chain), using [Arbitrum’s standard `ERC20` gateway](/build-decentralized-apps/token-bridging/03-token-bridge-erc20.mdx#default-standard-bridging). For alternative ways of bridging tokens, don’t forget to check out this [overview](/build-decentralized-apps/token-bridging/bridge-tokens-programmatically/01-get-started.mdx).

diff --git a/...dging/bridge-tokens-programmatically/03-how-to-bridge-tokens-generic-custom.mdx b/...dging/bridge-tokens-programmatically/03-how-to-bridge-tokens-generic-custom.mdx
@@ -3,7 +3,7 @@ title: 'Bridge tokens via Arbitrum’s generic-custom gateway'
 description: Learn how to use the generic-custom gateway to bridge tokens programmatically
 user_story: As a developer, I want to understand how to bridge tokens between Ethereum and Arbitrum using the generic-custom gateway
 content_type: how-to
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 In this how-to, you’ll learn how to bridge your own token between Ethereum (parent chain) and Arbitrum (child chain), using [Arbitrum’s generic-custom gateway](/build-decentralized-apps/token-bridging/03-token-bridge-erc20.mdx#the-arbitrum-generic-custom-gateway). For alternative ways of bridging tokens, don’t forget to check out this [overview](/build-decentralized-apps/token-bridging/bridge-tokens-programmatically/01-get-started.mdx).

diff --git a/...dging/bridge-tokens-programmatically/04-how-to-bridge-tokens-custom-gateway.mdx b/...dging/bridge-tokens-programmatically/04-how-to-bridge-tokens-custom-gateway.mdx
@@ -3,7 +3,7 @@ title: 'How to bridge tokens via a custom gateway'
 description: Learn how to set up a custom gateway using Arbitrum's Token Bridge to bridge tokens programmatically
 reader_audience: developers who want to build on Ethereum/Arbitrum and bridge tokens between layers
 content_type: how-to
-displayed_sidebar: buildAppsSidebar
+displayed_sidebar: buildSoliditySidebar
 ---
 
 :::caution Do you really need a custom gateway?

diff --git a/docs/for-users/contribute.mdx b/docs/for-users/contribute.mdx
@@ -0,0 +1,8 @@
+---
+title: 'Contribute docs'
+description: "Learn how to contribute to Arbitrum's documentation"
+---
+
+import ContributeDocsPartial from '../partials/_contribute-docs-partial.mdx';
+
+<ContributeDocsPartial />