OffchainLabs · anegg0 · Nov 12, 2025 · Nov 13, 2025 · Nov 13, 2025 · Nov 13, 2025
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.

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';
@@ -20,6 +20,10 @@ The following tools will help you develop and test your decentralized apps (dApp
 
 [Foundry](https://github.com/foundry-rs/foundry) is a high-performance, portable, and modular toolkit designed for EVM application development, leveraging the Rust programming language. It offers a comprehensive suite of tools to streamline the process of creating, testing, and deploying smart contracts on the Ethereum, Arbitrum and, in general, any EVM network. Foundry facilitates seamless interaction with EVM smart contracts, transactions, and chain data, while also providing a local node and a user-friendly Solidity REPL environment for efficient development.
 
+## Truffle
+
+[Truffle](https://trufflesuite.com/) is a comprehensive suite of tools for smart contract development, providing an end-to-end solution for building, testing, debugging, and deploying on Ethereum, Arbitrum and other EVM-compatible chains. It features advanced debugging capabilities, fast EVM simulation with Ganache, a user-centric design with a VS Code extension, and robust parent and child chain support. Truffle prioritizes security and partners with ConsenSys Diligence to bring continuous security to projects, providing a seamless and secure developer experience.
+
 ## thirdweb
 
 [thirdweb SDK](https://portal.thirdweb.com/sdk) covers all aspects of the Web3 development stack, including connecting to user’s wallets, interacting with the blockchain and smart contracts, decentralized storage, authentication, and more; enabling you to build scalable and performant Web3 applications on any EVM-compatible blockchain. Out of the box, infrastructure is provided for everything required to create decentralized applications, including connection to the blockchain (RPC), decentralized storage (IPFS + pinning services), and tools to create powerful user experiences; such as gasless transactions, wallet connection components, FIAT on-ramps, data APIs, and more.

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 />