OffchainLabs · anegg0 · Nov 13, 2024 · Nov 13, 2024 · Nov 13, 2024 · Nov 14, 2024
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,5 @@
 .vscode
 arbitrum-docs/sdk
 arbitrum-docs/stylus-by-example
+.vercel
+.DS_Store
diff --git a/...-orbit-chain/orbit-gentle-introduction.md → ...h-orbit-chain/01-a-gentle-introduction.md b/...-orbit-chain/orbit-gentle-introduction.md → ...h-orbit-chain/01-a-gentle-introduction.md
diff --git a/...h-orbit-chain/02-configure-your-chain/advanced-configurations/01-layer-leap.mdx b/...h-orbit-chain/02-configure-your-chain/advanced-configurations/01-layer-leap.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Layer leap'
+description: 'Learn how to configure Layer Leap on your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...t-chain/02-configure-your-chain/advanced-configurations/02-fast-withdrawals.mdx b/...t-chain/02-configure-your-chain/advanced-configurations/02-fast-withdrawals.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Fast withdrawals'
+description: 'Learn how to configure fast withdrawals on your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...bit-chain/02-configure-your-chain/advanced-configurations/03-aep-fee-router.mdx b/...bit-chain/02-configure-your-chain/advanced-configurations/03-aep-fee-router.mdx
@@ -0,0 +1,7 @@
+---
+title: 'AEP fee router'
+description: 'Learn how to configure your Orbit chain AEP fee router.'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...-chain/how-tos/use-a-custom-gas-token.mdx → ...figurations/01-use-a-custom-gas-token.mdx b/...-chain/how-tos/use-a-custom-gas-token.mdx → ...figurations/01-use-a-custom-gas-token.mdx
diff --git a/...configure-your-chain/common-configurations/02-customizable-challenge-period.mdx b/...configure-your-chain/common-configurations/02-customizable-challenge-period.mdx
@@ -0,0 +1,10 @@
+---
+title: 'Customizable Challenge Period'
+description: 'Learn how to customize your Orbit chain's challenge period'
+author: 
+sme: 
+content_type: how-to
+---
+
+- **Challenge Period Blocks**: Time until assertions are confirmed, allowing challenges.
+- **Extra Challenge Period Blocks**: Additional waiting time before a challenge period expires.
diff --git a/...gure-your-chain/common-configurations/03-stake-and-validator-configurations.mdx b/...gure-your-chain/common-configurations/03-stake-and-validator-configurations.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Stake and validator configurations'
+description: 'Learn how to configure your Orbit chain with a custom stake and validator configurations'
+author:
+sme:
+content_type: how-to
+---
+
+- **Base Stake**: Minimum stake required for validators.
+- **Stake Token**: Token used for staking.
+- **Loser Stake Escrow**: Address for escrowed funds from losing validators.
diff --git a/...-chain/02-configure-your-chain/common-configurations/04-arbos-configuration.mdx b/...-chain/02-configure-your-chain/common-configurations/04-arbos-configuration.mdx
@@ -0,0 +1,7 @@
+---
+title: 'ArbOS configuration'
+description: 'Learn how to configure ArbOS on your Orbit chain'
+author: jose-franco
+sme: jose-franco
+content_type: how-to
+---
diff --git a/...ain/02-configure-your-chain/common-configurations/05-gas-optimization-tools.mdx b/...ain/02-configure-your-chain/common-configurations/05-gas-optimization-tools.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Gas Optimization Tools'
+description: 'Learn how to configure gas optimization tools for your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...orbit-chain/02-configure-your-chain/common-configurations/06-fee-management.mdx b/...orbit-chain/02-configure-your-chain/common-configurations/06-fee-management.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Fee Management'
+description: 'Learn how to configure fee management for your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...nfigure-your-chain/common-configurations/07-batch-posting-assertion-control.mdx b/...nfigure-your-chain/common-configurations/07-batch-posting-assertion-control.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Batch Posting and Assertion Control'
+description: 'Learn how to configure batch posting and assertion control for your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...-configure-your-chain/common-configurations/08-sequencer-timing-adjustments.mdx b/...-configure-your-chain/common-configurations/08-sequencer-timing-adjustments.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Sequencer Timing Adjustments'
+description: 'Learn how to configure sequencer timing adjustments for your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...t-chain/02-configure-your-chain/common-configurations/09-per-batch-gas-cost.mdx b/...t-chain/02-configure-your-chain/common-configurations/09-per-batch-gas-cost.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Per batch gas cost'
+description: 'Learn how to configure per batch gas cost  for your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/.../02-configure-your-chain/common-configurations/10-smart-contract-size-limit.mdx b/.../02-configure-your-chain/common-configurations/10-smart-contract-size-limit.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Smart contract size limit'
+description: 'Learn how to configure smart contract size limits on your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...chain/02-configure-your-chain/common-configurations/11-customizing-anytrust.mdx b/...chain/02-configure-your-chain/common-configurations/11-customizing-anytrust.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Customizing AnyTrust'
+description: 'Learn how to customize AnyTrust on your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...bit-chain/aep-fee-router-introduction.mdx → ...gurations/aep-fee-router-introduction.mdx b/...bit-chain/aep-fee-router-introduction.mdx → ...gurations/aep-fee-router-introduction.mdx
diff --git a/...unch-orbit-chain/how-tos/arbos-upgrade.md → ...in/common-configurations/arbos-upgrade.md b/...unch-orbit-chain/how-tos/arbos-upgrade.md → ...in/common-configurations/arbos-upgrade.md
diff --git a/...rbit-chain/how-tos/calculate-aep-fees.mdx → ...mon-configurations/calculate-aep-fees.mdx b/...rbit-chain/how-tos/calculate-aep-fees.mdx → ...mon-configurations/calculate-aep-fees.mdx
diff --git a/...-orbit-chain/how-tos/fast-withdrawals.mdx → ...ommon-configurations/fast-withdrawals.mdx b/...-orbit-chain/how-tos/fast-withdrawals.mdx → ...ommon-configurations/fast-withdrawals.mdx
diff --git a/...t-chain/how-tos/set-up-aep-fee-router.mdx → ...-configurations/set-up-aep-fee-router.mdx b/...t-chain/how-tos/set-up-aep-fee-router.mdx → ...-configurations/set-up-aep-fee-router.mdx
diff --git a/arbitrum-docs/launch-orbit-chain/02-start-your-journey.mdx b/arbitrum-docs/launch-orbit-chain/02-start-your-journey.mdx
@@ -0,0 +1,10 @@
+---
+title: 'Start your journey into Orbit'
+sidebar_label: 'Orbit: get started'
+description: 'Learn how to get started with Orbit'
+sidebar_position: '2'
+author: 'anegg0'
+sme: 'mahsamoosavi'
+editor: 'anegg0'
+target_audience: 'Prospective chain owners, and operators'
+---
diff --git a/...-tos/orbit-sdk-configuring-orbit-chain.md → ...orbit-chain/01-configuring-orbit-chain.md b/...-tos/orbit-sdk-configuring-orbit-chain.md → ...orbit-chain/01-configuring-orbit-chain.md
diff --git a/...w-tos/orbit-sdk-deploying-rollup-chain.md → ...-orbit-chain/02-deploying-rollup-chain.md b/...w-tos/orbit-sdk-deploying-rollup-chain.md → ...-orbit-chain/02-deploying-rollup-chain.md
diff --git a/...tos/orbit-sdk-deploying-anytrust-chain.md → ...rbit-chain/03-deploying-anytrust-chain.md b/...tos/orbit-sdk-deploying-anytrust-chain.md → ...rbit-chain/03-deploying-anytrust-chain.md
diff --git a/...t-sdk-deploying-custom-gas-token-chain.md → ...in/04-deploying-custom-gas-token-chain.md b/...t-sdk-deploying-custom-gas-token-chain.md → ...in/04-deploying-custom-gas-token-chain.md
diff --git a/...w-tos/orbit-sdk-deploying-token-bridge.md → ...-orbit-chain/05-deploying-token-bridge.md b/...w-tos/orbit-sdk-deploying-token-bridge.md → ...-orbit-chain/05-deploying-token-bridge.md
diff --git a/...e/monitoring-tools-and-considerations.mdx → ...6-monitoring-tools-and-considerations.mdx b/...e/monitoring-tools-and-considerations.mdx → ...6-monitoring-tools-and-considerations.mdx
diff --git a/.../launch-orbit-chain/03-deploy-an-orbit-chain/07-canonical-factory-contracts.mdx b/.../launch-orbit-chain/03-deploy-an-orbit-chain/07-canonical-factory-contracts.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Canonical Factory Contracts'
+description: 'Learn how to deploy Canonical factory contracts on your Orbit chain'
+author:
+sme:
+content_type: how-to
+---
diff --git a/arbitrum-docs/launch-orbit-chain/03-orbit-license.mdx b/arbitrum-docs/launch-orbit-chain/03-orbit-license.mdx
@@ -0,0 +1,10 @@
+---
+title: 'The Orbit license'
+sidebar_label: 'Orbit license'
+description: ''
+sidebar_position: 2
+author:
+sme:
+editor: anegg0
+target_audience:
+---
diff --git a/arbitrum-docs/launch-orbit-chain/04-maintain-your-chain/01-bridging.mdx b/arbitrum-docs/launch-orbit-chain/04-maintain-your-chain/01-bridging.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Bridging'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
diff --git a/arbitrum-docs/launch-orbit-chain/04-maintain-your-chain/02-monitoring.mdx b/arbitrum-docs/launch-orbit-chain/04-maintain-your-chain/02-monitoring.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Monitoring'
+description: 'Learn how to configure your Orbit chain with a custom stake and validator configurations'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...ch-orbit-chain/04-maintain-your-chain/03-ownership-structure-access-control.mdx b/...ch-orbit-chain/04-maintain-your-chain/03-ownership-structure-access-control.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Ownership Structure and Access Control'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...ch-orbit-chain/04-maintain-your-chain/guidance/01-decentralization-security.mdx b/...ch-orbit-chain/04-maintain-your-chain/guidance/01-decentralization-security.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Decentralization and Security'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...ocs/launch-orbit-chain/04-maintain-your-chain/guidance/02-guidance-on-altda.mdx b/...ocs/launch-orbit-chain/04-maintain-your-chain/guidance/02-guidance-on-altda.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Guidance on AltDA'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...n/how-tos/orbit-managing-state-growth.mdx → ...n-your-chain/guidance/03-state-growth.mdx b/...n/how-tos/orbit-managing-state-growth.mdx → ...n-your-chain/guidance/03-state-growth.mdx
diff --git a/...ow-tos/orbit-managing-gas-speed-limit.mdx → ...ur-chain/guidance/04-state-size-limit.mdx b/...ow-tos/orbit-managing-gas-speed-limit.mdx → ...ur-chain/guidance/04-state-size-limit.mdx
diff --git a/...h-orbit-chain/how-tos/customize-arbos.mdx → ...-customize-your-chain/customize-arbos.mdx b/...h-orbit-chain/how-tos/customize-arbos.mdx → ...-customize-your-chain/customize-arbos.mdx
diff --git a/...it-chain/how-tos/customize-precompile.mdx → ...omize-your-chain/customize-precompile.mdx b/...it-chain/how-tos/customize-precompile.mdx → ...omize-your-chain/customize-precompile.mdx
diff --git a/...nch-orbit-chain/how-tos/customize-stf.mdx → ...05-customize-your-chain/customize-stf.mdx b/...nch-orbit-chain/how-tos/customize-stf.mdx → ...05-customize-your-chain/customize-stf.mdx
diff --git a/...bit-chain/how-tos/usdc-standard-bridge.md → ...-integrations/01-bridged-usdc-standard.md b/...bit-chain/how-tos/usdc-standard-bridge.md → ...-integrations/01-bridged-usdc-standard.md
diff --git a/...orbit-chain/infra-options-orbit-chains.md → ...-integrations/02-third-party-providers.md b/...orbit-chain/infra-options-orbit-chains.md → ...-integrations/02-third-party-providers.md
diff --git a/arbitrum-docs/launch-orbit-chain/06-third-party-integrations/03-integrations.mdx b/arbitrum-docs/launch-orbit-chain/06-third-party-integrations/03-integrations.mdx
@@ -0,0 +1,13 @@
+---
+title: 'Integrations'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
+
+## Compatible third-party integrations
+
+## LayerZero OFT
+
+## xERC20 Gateway
diff --git a/arbitrum-docs/launch-orbit-chain/07-orbit-node-runners/orbit-node-providers.mdx b/arbitrum-docs/launch-orbit-chain/07-orbit-node-runners/orbit-node-providers.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Orbit Node Providers'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
diff --git a/arbitrum-docs/launch-orbit-chain/08-ecosystem-support/01-orbit-portal.mdx b/arbitrum-docs/launch-orbit-chain/08-ecosystem-support/01-orbit-portal.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Orbit Portal'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...-docs/launch-orbit-chain/08-ecosystem-support/03-get-listed-orbit-platforms.mdx b/...-docs/launch-orbit-chain/08-ecosystem-support/03-get-listed-orbit-platforms.mdx
@@ -0,0 +1,7 @@
+---
+title: 'Get listed on Orbit platforms'
+description: 'PLACEHOLDER'
+author:
+sme:
+content_type: how-to
+---
diff --git a/...n/how-tos/add-orbit-chain-to-bridge-ui.md → ...m-support/add-orbit-chain-to-bridge-ui.md b/...n/how-tos/add-orbit-chain-to-bridge-ui.md → ...m-support/add-orbit-chain-to-bridge-ui.md
diff --git a/...t-chain/troubleshooting-building-orbit.md → ...hooting/troubleshooting-building-orbit.md b/...t-chain/troubleshooting-building-orbit.md → ...hooting/troubleshooting-building-orbit.md
diff --git a/arbitrum-docs/launch-orbit-chain/how-tos/customize-deployment-configuration.md b/arbitrum-docs/launch-orbit-chain/how-tos/customize-deployment-configuration.md
@@ -81,4 +81,4 @@ When deploying your Orbit chain, this address must be a standard Ethereum wallet
 
 ## Additional configuration parameters
 
-There are a number of [additional parameters](/launch-orbit-chain/reference/additional-configuration-parameters) that are not presented in the deployment UI, but are still configurable for more advanced chain deployers.
+There are a number of [additional parameters](/launch-orbit-chain/reference/orbit-configuration-parameters) that are not presented in the deployment UI, but are still configurable for more advanced chain deployers.
diff --git a/arbitrum-docs/launch-orbit-chain/how-tos/how-to-configure-your-chain.mdx b/arbitrum-docs/launch-orbit-chain/how-tos/how-to-configure-your-chain.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Guidance on how to configure your Orbit chain'
+sidebar_label: 'Configure your Orbit chain'
+description: 'Learn how to configure your Orbit chain'
+author: 'anegg0'
+sme: 'anegg0'
+target_audience: 'Developers deploying and maintaining Orbit chains.'
+sidebar_position: '6'
+user_story: 'As a current or prospective Orbit chain owner or operator, I need to understand how to configure my chain to satisfy my requirements'
+content_type: 'how-to'
+---
diff --git a/arbitrum-docs/launch-orbit-chain/orbit-supported-parent-chains.mdx b/arbitrum-docs/launch-orbit-chain/orbit-supported-parent-chains.mdx
@@ -0,0 +1,63 @@
+---
+title: 'Supported parent chains'
+sidebar_label: 'Supported parent chains'
+description: 'List of chains officially supported in Orbit'
+sidebar_position: '2'
+author: 'mahsamoosavi'
+sme: 'mahsamoosavi'
+editor: 'anegg0'
+target_audience: 'Orbit chains owners and operators'
+---
+
+This page lists the parent chains that are officially supported in Orbit, including mainnets, testnets, and options for local development. While the Orbit SDK provides functionality to enable custom parent chains, support is limited to the chains explicitly listed on this page. Developers are welcome to use the Orbit SDK to configure and deploy custom parent chains; however, such setups, including deploying the required creator and template contracts, are beyond the scope of our official support.
+
+:::caution Supported Chains Only
+
+Please note that we cannot guarantee compatibility or offer assistance for custom configurations outside of the supported chains detailed below.
+
+:::
+
+#### Supported chains
+
+<div class="chain-cards">
+
+- **Ethereum Mainnet**  
+  **Chain ID:** `1`
+
+- **Arbitrum One**  
+  **Chain ID:** `42161`
+
+- **Arbitrum Nova**  
+  **Chain ID:** `42170`
+
+- **Base**  
+  **Chain ID:** `8453`
+
+- **Sepolia**  
+  **Chain ID:** `11155111`
+
+- **Holesky**  
+  **Chain ID:** `17000`
+
+- **Arbitrum Sepolia**  
+  **Chain ID:** `421613`
+
+- **Base Sepolia**  
+  **Chain ID:** `84531`
+
+- **Nitro Testnode L1**  
+  **Chain ID:** `1337`
+
+- **Nitro Testnode L2**  
+  **Chain ID:** `412346`
+
+- **Nitro Testnode L3**  
+  **Chain ID:** `333333`
+
+</div>
+
+### Adding custom parent chains
+
+Although Orbit primarily supports a predefined set of chains, it provides developers with the flexibility to add custom parent chains through [the `registerCustomParentChain` function of the Orbit SDK](https://github.com/OffchainLabs/arbitrum-orbit-sdk/blob/729facd4d50156d7a84cf1204552c900eb86655c/src/chains.ts#L102). This capability enables integration with chains beyond the officially supported list, offering opportunities for customization and expanding the Orbit ecosystem.
+
+However, adding a custom chain requires deploying essential contracts, such as the creator contract and template contract, on the target chain. These contracts are fundamental for ensuring the proper functioning of the Orbit framework on the custom chain.
diff --git a/arbitrum-docs/launch-orbit-chain/reference/additional-configuration-parameters.md b/arbitrum-docs/launch-orbit-chain/reference/additional-configuration-parameters.md
diff --git a/arbitrum-docs/launch-orbit-chain/reference/orbit-batch-poster-configuration.mdx b/arbitrum-docs/launch-orbit-chain/reference/orbit-batch-poster-configuration.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Orbit chains: batch poster configuration parameters'
+sidebar_label: 'sequencer orbit batch poster configuration'
+description: 'Learn how to configure a sequencer on your Orbit chain'
+author: 'anegg0'
+sme: 'anegg0'
+target_audience: 'Prospective chain owners, and operators'
+sidebar_position: '6'
+user_story: 'As a current or prospective Orbit chain owner or operator, I need to understand how to configure my batch poster'
+content_type: 'reference'
+---
diff --git a/arbitrum-docs/launch-orbit-chain/reference/orbit-configuration-parameters.mdx b/arbitrum-docs/launch-orbit-chain/reference/orbit-configuration-parameters.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Configuration parameters: Orbit chains'
+sidebar_label: 'Configuration parameters'
+description: 'Learn about Orbit configuration parameters'
+author: 'anegg0'
+sme: 'anegg0'
+target_audience: 'Prospective chain owners, and operators'
+sidebar_position: '6'
+user_story: 'As a current or prospective Orbit chain owner or operator, I need to understand how to configure my chain'
+content_type: 'reference'
+---
diff --git a/arbitrum-docs/launch-orbit-chain/reference/orbit-fast-block-times.mdx b/arbitrum-docs/launch-orbit-chain/reference/orbit-fast-block-times.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Configuration: fast block times'
+sidebar_label: 'Configuration: fast block times'
+description: 'Learn about Orbit fast block times'
+author: 'anegg0'
+sme: 'anegg0'
+taget_audience: 'Prospective chain owners, and operators'
+sidebar_position: '6'
+user_story: 'As a current or prospective Orbit chain owner or operator, I need to understand how to configure my chain for fast block times'
+content_type: 'reference'
+---
diff --git a/arbitrum-docs/launch-orbit-chain/reference/orbit-sequencer-configuration.mdx b/arbitrum-docs/launch-orbit-chain/reference/orbit-sequencer-configuration.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Orbit chains: sequencer configuration parameters'
+sidebar_label: 'Sequencer configuration parameters'
+description: 'Learn how to configure a sequencer on your Orbit chain'
+author: 'anegg0'
+sme: 'anegg0'
+target_audience: 'Prospective chain owners, and operators'
+sidebar_position: '6'
+user_story: 'As a current or prospective Orbit chain owner or operator, I need to understand how to configure my chains sequencer'
+content_type: 'reference'
+---
diff --git a/arbitrum-docs/launch-orbit-chain/reference/orbit-smart-contract-size-limit.mdx b/arbitrum-docs/launch-orbit-chain/reference/orbit-smart-contract-size-limit.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Smart contract size limit'
+sidebar_label: 'Smart contract size limit'
+description: 'Learn about Orbit Smart contract size limit'
+author: 'anegg0'
+sme: 'anegg0'
+taget_audience: 'Prospective chain owners, and operators'
+sidebar_position: '2'
+user_story: 'As a current or prospective Orbit chain owner or operator, I need to understand smart contracts size limits'
+content_type: 'reference'
+---
Original file line number	Diff line number	Diff line change
Expand Up		@@ -81,4 +81,4 @@ When deploying your Orbit chain, this address must be a standard Ethereum wallet

		## Additional configuration parameters

		There are a number of [additional parameters](/launch-orbit-chain/reference/additional-configuration-parameters) that are not presented in the deployment UI, but are still configurable for more advanced chain deployers.
		There are a number of [additional parameters](/launch-orbit-chain/reference/orbit-configuration-parameters) that are not presented in the deployment UI, but are still configurable for more advanced chain deployers.