Skip to content

docs: tw-565-orbit-config-pt4 #2784

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 26 commits into from
Nov 3, 2025
Merged

docs: tw-565-orbit-config-pt4 #2784

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
4c78c85
Adding Arbitrum chain config: Timeboost
pete-vielhaber Oct 16, 2025
8f0a022
Adding Arbitrum chain config: BoLD
pete-vielhaber Oct 16, 2025
a9f9356
Adding Arbitrum chain config: Permissioned validators
pete-vielhaber Oct 16, 2025
e6c19d6
Adding Arbitrum chain config: L1 challenge period
pete-vielhaber Oct 16, 2025
aa4b231
Minor content edits
pete-vielhaber Oct 16, 2025
03790a7
Adding Arbitrum chain config: Timeboost, BoLD, Force Inclusion
pete-vielhaber Oct 16, 2025
d19482a
Removed a line from previous stashed changes
pete-vielhaber Oct 16, 2025
c39334f
Merge branch 'master' into orbit-config-pt4
anegg0 Oct 16, 2025
37dac53
Addressing comments
pete-vielhaber Oct 24, 2025
88a86bb
Merge branch 'master' into orbit-config-pt4
pete-vielhaber Oct 24, 2025
d4dbbfa
Merge branch 'master' into orbit-config-pt4
pete-vielhaber Oct 27, 2025
18cd671
yarn format
pete-vielhaber Oct 28, 2025
f913c1d
Merge branch 'master' into orbit-config-pt4
pete-vielhaber Oct 30, 2025
581e3d4
fix markdown table
anegg0 Oct 31, 2025
55036d8
add diagram with better resolution
anegg0 Oct 31, 2025
3169425
add diagram with better resolution
anegg0 Oct 31, 2025
3519b00
fix typo
anegg0 Nov 1, 2025
e9a0ce6
Merge pull request #2837 from OffchainLabs/fixes-orbit-config-pt4
anegg0 Nov 3, 2025
bdc9275
Update docs/launch-arbitrum-chain/partials/config-anytrust.mdx
pete-vielhaber Nov 3, 2025
e601c9a
Update docs/launch-arbitrum-chain/partials/config-anytrust.mdx
pete-vielhaber Nov 3, 2025
7c24757
Update docs/launch-arbitrum-chain/partials/config-bold.mdx
pete-vielhaber Nov 3, 2025
7f4a6e3
Update docs/launch-arbitrum-chain/partials/config-l1-challenge-period…
pete-vielhaber Nov 3, 2025
d278b5d
Update docs/launch-arbitrum-chain/partials/config-l1-challenge-period…
pete-vielhaber Nov 3, 2025
2bb20fe
Update docs/launch-arbitrum-chain/partials/config-l1-challenge-period…
pete-vielhaber Nov 3, 2025
908d75f
Merge branch 'master' into orbit-config-pt4
pete-vielhaber Nov 3, 2025
ad38600
yarn format
pete-vielhaber Nov 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions docs/launch-arbitrum-chain/01-a-gentle-introduction.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,9 +23,9 @@ If you'd prefer to learn by doing, see the [Orbit SDK Rollup creation example](h
- Arbitrum chains can be a <a data-quicklook-from='layer-2-l2'>Layer 2 (L2)</a> chain which settles directly to Ethereum, or a Layer 3 (L3) chain which can settle to any Ethereum L2, such as <a data-quicklook-from='arbitrum-one'>Arbitrum One</a>.

<ImageZoom
src="/img/orbit-settlement-layers.png"
src="/img/orbit-settlement-layers.svg"
alt="Arbitrum Orbit chain settlement layers"
className="img-600px"
className="img-800px"
/>

### What's an Arbitrum chain?
Expand All @@ -43,20 +43,20 @@ Arbitrum's protocols address this challenge by offloading some of the Ethereum n

### What key features should I consider?

| Feature | Description |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Dedicated throughput | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-dedicated-throughput.mdx">More info</FloatingHoverModal> |
| EVM+ compatibility | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-evm-compatibility.mdx">EVM compatability</FloatingHoverModal> + <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-other-language-support.mdx">more languages like Rust programs supported</FloatingHoverModal> |
| Account abstraction | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-account-abstraction.mdx">Account abstraction</FloatingHoverModal> |
| Gas & Tokens | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-custom-gas-token.mdx">Custom gas token</FloatingHoverModal> or <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-native-eth.mdx">Native ETH</FloatingHoverModal> |
| Data availability | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-rollup.mdx">Rollup (ETH DA)</FloatingHoverModal>, <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-anytrust.mdx">AnyTrust</FloatingHoverModal>, <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-alt-da.mdx">Alt-DA</FloatingHoverModal> |
| Fast confirmations | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-fast-withdrawals.mdx">Fast withdrawals</FloatingHoverModal> |
| Security & validation | BoLD, Permissioned validators, <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-challenge-period-l1.mdx">Challenge period enforced on L1</FloatingHoverModal> |
| Safety Features | Force-inclusion & <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-customizable-governance.mdx">customizable governance</FloatingHoverModal> |
| MEV | Timeboost |
| Cost | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-data-posting-costs.mdx">Data posting costs</FloatingHoverModal> |
| Infrastructure | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-hardware.mdx">Hardware requirements</FloatingHoverModal> |
| Interop | TBD |
| Feature | Description |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Dedicated throughput | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-dedicated-throughput.mdx">More info</FloatingHoverModal> |
| EVM+ compatibility | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-evm-compatibility.mdx">EVM compatibility</FloatingHoverModal> + <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-other-language-support.mdx">more languages like Rust programs supported</FloatingHoverModal> |
| Account abstraction | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-account-abstraction.mdx">Account abstraction</FloatingHoverModal> |
| Gas & Tokens | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-custom-gas-token.mdx">Custom gas token</FloatingHoverModal> or <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-native-eth.mdx">Native ETH</FloatingHoverModal> |
| Data availability | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-rollup.mdx">Rollup (ETH DA)</FloatingHoverModal>, <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-anytrust.mdx">AnyTrust</FloatingHoverModal>, <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-alt-da.mdx">Alt-DA</FloatingHoverModal> |
| Fast confirmations | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-fast-withdrawals.mdx">Fast withdrawals</FloatingHoverModal> |
| Security & validation | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-bold.mdx">BoLD</FloatingHoverModal>, <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-permissioned-validators.mdx">Permissioned validators</FloatingHoverModal>, <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-l1-challenge-period.mdx">Challenge period enforced on L1</FloatingHoverModal> |
| Safety Features | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-force-inclusion.mdx">Force-inclusion</FloatingHoverModal> & <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-customizable-governance.mdx">customizable governance</FloatingHoverModal> |
| MEV | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-timeboost.mdx">Timeboost</FloatingHoverModal> |
| Cost | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-data-posting-costs.mdx">Data posting costs</FloatingHoverModal> |
| Infrastructure | <FloatingHoverModal href="/launch-arbitrum-chain/partials/config-hardware.mdx">Hardware requirements</FloatingHoverModal> |
| Interop | TBD |

### How do Arbitrum chains help the Ethereum ecosystem?

Expand Down
8 changes: 4 additions & 4 deletions docs/launch-arbitrum-chain/partials/config-anytrust.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@

## Cons of using AnyTrust

- **Introduced trust assumptions**: Relies on the DAC's honesty and availability, which adds a layer of trust not present in full trustless rollups. This could be a risk if committee members collude or fail.
- **Reduced decentralization and security guarantees**: Lacks the full trustlessness, permissionlessness, and censorship resistance of Rollups, as not all data is posted to Ethereum by default. This makes it less suitable for high-value DeFi or applications requiring Ethereum-level security.
- **Potential for fallback mode issues**: If the DAC quorum isn't met, the chain reverts to Rollup mode, which could increase costs temporarily and introduce delays similar to standard Rollups.
- **Liquidity and adoption changes**: May face lower liquidity or ecosystem integration compared to rollup-based chains like Arbitrum One, potentially limiting interoperability for certain dApps.
- **Introduced trust assumptions**: Relies on the DAC's honesty and availability, which adds a layer of trust not present in full trustless Rollups. This trust assumption could be a risk if committee members collude or fail.
- **Reduced decentralization and security guarantees**: Lacks the full trustlessness, permissionlessness, and censorship resistance of Rollups, as not all data is posted to Ethereum by default. This lack of data posting makes it less suitable for high-value DeFi or applications requiring Ethereum-level security.
- **Potential for fallback mode issues**: If the DAC cannot come to a quorum, the chain reverts to Rollup mode, which could increase costs temporarily and introduce delays similar to standard Rollups.
- **Liquidity and adoption changes**: May face lower liquidity or ecosystem integration compared to Rollup-based chains like Arbitrum One, potentially limiting interoperability with certain <a data-quicklook-from="dapp">apps</a>.
- **Not optimal for all use cases**: For applications handling significant financial value or needing maximum security, the trade-offs in decentralization could outweigh the benefits.
8 changes: 8 additions & 0 deletions docs/launch-arbitrum-chain/partials/config-bold.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
BoLD (Bounded Liquidity Delay) is a dispute resolution protocol that enables permissionless validation, allowing anyone to propose, challenge, and defend chain states by bonding `ETH`, with disputes resolved in a fixed-time window (typically around 7-14 days, depending on the chain). For Arbitrum chains, BoLD is available as an optional upgrade via the Nitro stack, enhancing decentralization and security while setting states to a parent chain like Ethereum or Arbitrum One.

| Feature | Pros | Cons |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Validation & Decentraliation | - Enables permissionless validation, allowing anyone to propose and defend states, increasing resilience and inclusivity <br /> - Supports trustless bonding pools, letting groups pool `ETH` to participate without high individual capital barriers, promoting broader decentralization | - High bond requirements (e.g., potentially thousands of `ETH` for assertions) may centralize participation to well-funded entities, limiting smaller validators. <br /> - No built-in protocol-level incentives for validators could lead to free-riding, where parties rely on others to defend the chain. |
| Security & Dispute Resolution | - Mitigates delay attacks by enforcing a bounded dispute window (e.g., ~7 days plus grace periods), ensuring predictable resolution even against multiple malicious challengers. <br /> - Enhances withdrawal security to the parent chain by limiting indefinite delays, and includes features like Delay Buffer for censorship resistance. <br /> - A single honest party can win disputes against any number of dishonest ones, with audited code for reliability. | - Disputes can still delay all withdrawals (up to ~14 days total), impacting user experience and liquidity. <br /> - For lower-TVL Arbitrum chains, high bonds might need adjustment, trading off security against centralization risks or vulnerability to spam. <br /> - Potential censorship risks for L3 Arbitrum chains (e.g., parent chain is censored, delays could extend up to 50 days in extreme cases, though mitigated). |
| Economics & Incentives | - Bonds deter actors, with honest parties refunded plus a 1% defender's bounty and gas reimbursements, plus potential service fees (3-4% annualized `ETH` yield) from chain owners. <br /> - Fixed costs and resource ratios prevent dishonest parties from inflating expenses for honest validators. | - Significant capital lockup in bonds creates opportunity costs and risks (e.g., loss if proven wrong), potentially prohibitive for smaller chains. <br /> - KYC requirements for fee eligibility may exclude some participants, like those in sanctioned regions. <br /> - Operational costs for onchain proofs and disputes (gas, computation), add complexity and expenses. |
| Implementations & Maturity | - Modular upgrade for Arbitrum chains <br /> - Community testing via testnets and visualizers available for easier adoption | - Increased protocol complexity may require additional tooling and expertise to manage. <br /> - Reliance on parent chain for final proofs; issues there could affect Arbitrum chain disputes. |
Loading