You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: arbitrum-docs/how-arbitrum-works/bold/partials/_bold-public-preview-banner-partial.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -4,4 +4,4 @@ The BoLD dispute protocol is currently deployed on a public testnet (that posts
4
4
5
5
To provide feedback, click the _Request an update_ button at the top of this document, [join the Arbitrum Discord](https://discord.gg/arbitrum), or reach out to our team directly by completing [this form](http://bit.ly/3yy6EUK).
Copy file name to clipboardExpand all lines: arbitrum-docs/how-arbitrum-works/inside-arbitrum-nitro.md
+6-2
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,15 @@
1
1
---
2
+
title: 'Inside Arbitrum Nitro'
3
+
sidebar_label: 'Deep dive: Inside Arbitrum'
4
+
description: 'Learn the fundamentals of Nitro, Arbitrum stack.'
2
5
author: dzgoldman
6
+
sme: dzgoldman
7
+
user_story: As a current or prospective Arbitrum user, I need learn more about Nitros design.
8
+
content_type: get-started
3
9
---
4
10
5
11
import ImageWithCaption from '@site/src/components/ImageCaptions/';
6
12
7
-
# Inside Arbitrum Nitro
8
-
9
13
This document is a deep-dive explanation of Arbitrum Nitro’s design and the rationale for it. This isn’t API documentation, nor is it a guided tour of the code--look elsewhere for those. “Inside Arbitrum Nitro” is for people who want to understand Nitro's design.
10
14
11
15
The body of this document will describe Arbitrum Rollup, the primary use case of the Nitro technology and the one used on the Arbitrum One chain. There is a variant use case, called AnyTrust, which is used by the Arbitrum Nova chain. AnyTrust is covered by a section at the end of this document.
Copy file name to clipboardExpand all lines: arbitrum-docs/how-arbitrum-works/why-nitro.md
+2-3
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,12 @@
1
1
---
2
+
title: Nitro vs. Classic
2
3
author: dzgoldman
3
4
---
4
5
5
-
# Why Nitro?
6
+
Why Nitro?
6
7
7
8
Nitro represents the latest step in the evolution of Arbitrum technology; it is an upgrade from the tech stack first released on the mainnet Arbitrum One chain, which we now refer to as “Arbitrum Classic” (and several steps beyond what was described in the [initial Arbitrum whitepaper back in 2018](https://www.usenix.org/system/files/conference/usenixsecurity18/sec18-kalodner.pdf)). Here, we’ll explain the rationale behind the Nitro upgrade, and outline Nitro’s core benefits over the classic system.
8
9
9
-
### Nitro vs. Classic
10
-
11
10
Viewed from a distance, the Classic and Nitro systems do similar things: both seek to create an execution environment as close to the EVM as possible which operates as a second layer to Ethereum; i.e., safety of the L2 virtual machine’s state updates can be guaranteed and enforced via succinct fraud proofs on Ethereum itself.
12
11
13
12
In Arbitrum Classic, this was achieved via a custom-made virtual machine, which we call the Arbitrum Virtual Machine (AVM). The implementation of Arbitrum’s L2 state machine—known as [“ArbOS”](/how-arbitrum-works/arbos/introduction.md) — is effectively a program that is compiled and uploaded to the AVM; ArbOS includes (among other things) the ability to emulate EVM execution.
Copy file name to clipboardExpand all lines: arbitrum-docs/launch-orbit-chain/aep-fee-router-introduction.mdx
+1-1
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ content_type: get-started
10
10
11
11
## What is the Arbitrum expansion program?
12
12
13
-
The [Arbitrum Expansion Program](https://forum.arbitrum.foundation/t/the-arbitrum-expansion-program-and-developer-guild/20722) (AEP) allows Orbit chains to deploy on *any chain*permissionlessly. As part of the [AEP license](https://docs.arbitrum.foundation/assets/files/Arbitrum%20Expansion%20Program%20Jan182024-4f08b0c2cb476a55dc153380fa3e64b0.pdf), Orbit chains deployed outside of Arbitrum One and Arbitrum Nova must pay 10% of their **Net Protocol Revenue** to the Arbitrum DAO.
13
+
The [Arbitrum Expansion Program](https://forum.arbitrum.foundation/t/the-arbitrum-expansion-program-and-developer-guild/20722) (AEP) allows Orbit chains to deploy on *any chain*permissionlessly. As part of the [AEP license](https://docs.arbitrum.foundation/assets/files/Arbitrum%20Expansion%20Program%20Jan182024-4f08b0c2cb476a55dc153380fa3e64b0.pdf), Orbit chains deployed outside of Arbitrum One and Arbitrum Nova must pay 10% of their **Net Protocol Revenue** to the Arbitrum DAO.
14
14
15
15
The Arbitrum Expansion Program and Developer Guild are initiatives launched in collaboration with Offchain Labs to promote the development of customized Arbitrum chains using the Orbit framework. The Expansion Program simplifies the process for teams to create Layer 2 (L2) and Layer 3 (L3) chains, offering self-service tools and customization options.
Copy file name to clipboardExpand all lines: arbitrum-docs/launch-orbit-chain/how-tos/calculate-aep-fees.mdx
+1-1
Original file line number
Diff line number
Diff line change
@@ -100,7 +100,7 @@ If you are an L3 or higher chain with a custom gas token, your custom gas token
100
100
101
101
### Non-Ethereum L1
102
102
103
-
If your Orbit chain is deployed on a non-Ethereum L1 (e.g., Solana, BNB Chain), your fees must be manually transferred to a DAO-controlled address.
103
+
If your Orbit chain is deployed on a non-Ethereum L1 (e.g., Solana, BNB Chain), your fees must be manually transferred to a Foundation-controlled address.
| Gentle introduction | Onboard a specific reader audience with tailored questions and answers |[A gentle introduction to Orbit](/launch-orbit-chain/orbit-gentle-introduction.md)|
116
116
| Quickstart | Onboard a specific reader audience with step-by-step "learn by doing" instructions |[Quickstart: Build dApps](/build-decentralized-apps/01-quickstart-solidity-hardhat.md)|
117
-
| How-to | Provide task-oriented procedural guidance |[How to run a local dev node](/run-arbitrum-node/04-run-local-dev-node.md)|
117
+
| How-to | Provide task-oriented procedural guidance |[How to run a full chain simulation](/run-arbitrum-node/04-run-local-full-chain-simulation.md)|
118
118
| Concept | Explain what things are and how they work |[Token bridging](/build-decentralized-apps/token-bridging/03-token-bridge-erc20.md) <br/>[Nodes and networks](https://docs.prylabs.network/docs/concepts/nodes-networks)|
119
119
| FAQ | Address frequently asked questions |[FAQ: Run a node](../node-running/faq.md)|
120
120
| Troubleshooting | List common troubleshooting scenarios and solutions |[Troubleshooting: Run a node](/run-arbitrum-node/06-troubleshooting.md)|
Copy file name to clipboardExpand all lines: arbitrum-docs/partials/_glossary-partial.mdx
+34-82
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,10 @@
1
1
2
2
3
+
### 🧱 State Transition Function {#-state-transition-function}
4
+
<p>
5
+
The STF (State Transition Function) defines how new blocks are produced from input messages (i.e. transactions) in an Arbitrum chain.
6
+
</p>
7
+
3
8
### Active Validator {#active-validator}
4
9
<p>
5
10
A staked <ahref="/intro/glossary#validator">Validator</a> that makes disputable assertions to advance the state of an Arbitrum chain or to challenge the validity of others' assertions. (Not to be confused with the <ahref="/intro/glossary#sequencer">Sequencer</a> ).
A staked claim by an Arbitrum <ahref="/intro/glossary#validator">Validator</a>. An assertion may, e.g., propose a new <ahref="/intro/glossary#rblock">RBlock</a>, or may be a step in a <ahref="/intro/glossary#challenge">Challenge</a>.
96
101
</p>
97
102
103
+
### Auction Contract {#auction-contract}
104
+
<p>
105
+
A smart contract that handles the state, accounting of funds for bids, and various operations of the <ahref="/intro/glossary#timeboost">Timeboost</a> auction. The contract is deployed on the target chain for which Timeboost is enabled.
Off chain software that receives bids from <ahref="/intro/glossary#timeboost">Timeboost</a> participants, processes and validates bids, and then posts the top valid bid (or top two valid bids in the case of a tie) to the <ahref="/intro/glossary#auction-contract">Auction Contract</a> to resolve the on-going Timeboost auction. The autonomous auctioneer, for a given chain, is provisioned & deployed by an entity designated by the chain's owner.
111
+
</p>
112
+
98
113
### Batch {#batch}
99
114
<p>
100
115
A group of Arbitrum transactions posted in a single transaction on the <ahref="/intro/glossary#underlying-chain">Underlying Chain</a> into the <ahref="/intro/glossary#fast-inbox">Fast Inbox</a> by the <ahref="/intro/glossary#sequencer">Sequencer</a>.
@@ -120,15 +135,6 @@ Short for "Bounded Liquidity Delay"; latest version of the Arbitrum <a href="/in
120
135
A set of smart contracts for sending <ahref="/intro/glossary#crosschain-message">Cross-chain message</a>s between blockchains. Every <ahref="/intro/glossary#arbitrum-chain">Arbitrum chain</a> includes a bridge to/from its <ahref="/intro/glossary#parent-chain">Parent chain</a>.
121
136
</p>
122
137
123
-
### 🧢 CAP Finance {#cap-finance}
124
-
<p>
125
-
Widely considered the most degen community on Arbitrum.
126
-
<br />
127
-
128
-
<br />
129
-
<ahref="https://cap.io/">CAP</a> is a decentralized trading protocol. It's designed to be fast and easy to use by anyone.
130
-
</p>
131
-
132
138
### Chain Owner {#chain-owner}
133
139
<p>
134
140
An entity (i.e., a smart contract) with affordance to carry out critical upgrades to an Arbitrum chain's core protocol; this includes upgrading protocol contracts, setting core system parameters, and adding and removing other chain owners.
@@ -221,15 +227,6 @@ Web application built and maintained by <a href="/intro/glossary#offchain-labs">
221
227
A step in the <ahref="/intro/glossary#challenge-protocol">Challenge protocol</a> in which two challenging parties interactively narrow down their disagreement until they reach a <ahref="/intro/glossary#one-step-proof">One Step Proof</a>.
222
228
</p>
223
229
224
-
### 💎 Dopex {#dopex}
225
-
<p>
226
-
A shiny gem in the Arbitrum community.
227
-
<br />
228
-
229
-
<br />
230
-
Commonly associated with the esteemed Diamond Pepe's NFT and Dopex community. Dopex is a decentralized options exchange protocol on Arbitrum.
231
-
</p>
232
-
233
230
### ☕ Espresso {#espresso}
234
231
<p>
235
232
Project partnering with <ahref="/intro/glossary#offchain-labs">Offchain Labs</a> for research and development around <ahref="/intro/glossary#sequencer">Sequencer</a> transaction ordering and <ahref="/intro/glossary#shared-sequencing">Shared Sequencing</a> technology.
@@ -245,6 +242,16 @@ A software application used for transacting with the Ethereum <a href="/intro/gl
245
242
The paradigm introduced by <ahref="/intro/glossary#stylus">Stylus</a> in which Arbitrum's EVM compatibility is preserved while new features and improvements are introduced.
246
243
</p>
247
244
245
+
### Express Lane {#express-lane}
246
+
<p>
247
+
A component of <ahref="/intro/glossary#timeboost">Timeboost</a>, the express lane is a special endpoint on the <ahref="/intro/glossary#sequencer">Sequencer</a> that immediately sequences incoming, valid transactions signed by the current express lane controller.
248
+
</p>
249
+
250
+
### Express Lane Controller {#express-lane-controller}
251
+
<p>
252
+
An address, defined in the <ahref="/intro/glossary#auction-contract">Auction Contract</a>, that is granted the privilege to use the <ahref="/intro/glossary#express-lane">Express Lane</a>. These privileges are granted after verifying that the incoming transactions were properly signed by the express lane controller, among other checks.
BFT algorithm in which a committee comes to consensus on transaction ordering; current single-party <ahref="/intro/glossary#sequencer">Sequencer</a> on Arbitrum may eventually be replaced by a fair-ordering committee.
@@ -260,6 +267,11 @@ A means by which a user can bypass an Arbitrum chain's <a href="/intro/glossary#
260
267
Contract that holds a sequence of messages sent by clients to an Arbitrum Chain; a message can be put into the fast Inbox directly by the <ahref="/intro/glossary#sequencer">Sequencer</a> or indirectly through the <ahref="/intro/glossary#delayed-inbox">Delayed Inbox</a>.
261
268
</p>
262
269
270
+
### First Come First Serve (FCFS) {#first-come-first-serve-fcfs}
271
+
<p>
272
+
A type of <ahref="/intro/glossary#transaction-ordering-policy">Transaction Ordering Policy</a> used by the sequencer in Arbitrum chains whereby incoming transactions are sequenced into a block in the order that the transactions arrived.
273
+
</p>
274
+
263
275
### Force-Inclusion {#forceinclusion}
264
276
<p>
265
277
Censorship resistant path for including a message into an Arbitrum chain via the <ahref="/intro/glossary#delayed-inbox">Delayed Inbox</a> on its <ahref="/intro/glossary#parent-chain">Parent chain</a>; bypasses any Sequencer involvement.
@@ -290,15 +302,6 @@ A particular <a href="/intro/glossary#custom-gateway">Custom gateway</a> via whi
290
302
An execution-layer client that defines the Ethereum state transition function and handles network-layer logic like transaction memory pooling. <ahref="/intro/glossary#arbitrum-nitro">Arbitrum Nitro</a> utilizes a fork of Geth to implement Arbitrum's state transition function.
291
303
</p>
292
304
293
-
### 🫐 GMX {#gmx}
294
-
<p>
295
-
If you've seen some blueberries wandering around on crypto Twitter, you might wonder .. where did they come from?
296
-
<br />
297
-
298
-
<br />
299
-
The iconic blueberries come from the community of the decentralized exchange, GMX.
300
-
</p>
301
-
302
305
### Ink {#ink}
303
306
<p>
304
307
The equivalent of gas in the <ahref="/intro/glossary#stylus">Stylus</a> vm. Ink is introduced for finer granularity than gas offers since Stylus's operations are considerably cheaper than their EVM analogs.
@@ -418,15 +421,6 @@ A protocol design space in which multiple rollups use the same entity as their <
418
421
A computer program whose operations are defined and executed within a blockchain consensus protocol.
419
422
</p>
420
423
421
-
### 🐵 Smolverse {#smolverse}
422
-
<p>
423
-
Near the core of Arbitrum community is Smolverse, a world filled with Smol Brains and Smol Bodies.
424
-
<br />
425
-
426
-
<br />
427
-
If you see any Smol's with giga brains, swole arms or hear the sound of "EEEE" in the Arbitrum community, you've encountered the Smol Brains and Smol Bodies.
428
-
</p>
429
-
430
424
### Soft Confirmation {#soft-confirmation}
431
425
<p>
432
426
A semi-trusted promise from the <ahref="/intro/glossary#sequencer">Sequencer</a> to post a user's transaction in the near future; soft-confirmations happen prior to posting on the <ahref="/intro/glossary#parent-chain">Parent chain</a>, and thus can be given near-instantaneously (i.e., faster than the parent chain's block times)
@@ -457,57 +451,24 @@ An token contract on an Arbitrum chain deployed via the <a href="/intro/glossary
457
451
Upgrade to the <ahref="/intro/glossary#arbitrum-nitro">Arbitrum Nitro</a> virtual machine that allows smart contract support for languages like Rust and C++ by taking advantage of Nitro's use of WASM. Currently on testnet (<ahref="https://docs.arbitrum.io/stylus/stylus-gentle-introduction">read more</a>).
458
452
</p>
459
453
460
-
### 🏹 Tales of Elleria {#tales-of-elleria}
461
-
<p>
462
-
The bow and arrow are commonly associated with the Hero's of Tales of Elleria.
463
-
<br />
464
-
465
-
<br />
466
-
Jump into the world of Elleria and go on adventures.
467
-
</p>
468
-
469
-
### Time boost {#time-boost}
454
+
### Timeboost {#timeboost}
470
455
<p>
471
-
A proposed (not currently live) transaction policy in which users can pay a fee to the <ahref="/intro/glossary#sequencer">Sequencer</a> for a small ordering advantage. See [here](<ahref="https://medium.com/offchainlabs/time-boost-a-new-transaction-ordering-policy-for-arbitrum-5b3066382d62">https://medium.com/offchainlabs/time-boost-a-new-transaction-ordering-policy-for-arbitrum-5b3066382d62</a>) for more.
472
-
</p>
473
-
474
-
### 🐸 Toadstoolz {#toadstoolz}
475
-
<p>
476
-
Hidden in the Croakshire, you will find the friendly Toadstoolz.
477
-
<br />
478
-
479
-
<br />
480
-
The iconic Toads of Arbitrum love to hunt BUGZ
481
-
<br />
482
-
and collect NFTs. !CROAK
456
+
A transaction ordering policy in which entities can bid for the right to access an express lane on the <ahref="/intro/glossary#sequencer">Sequencer</a> for faster transaction inclusion. See the <ahref="https://github.com/OffchainLabs/timeboost-design/tree/main">research specification</a> to learn more.
483
457
</p>
484
458
485
459
### Token Gateway {#token-gateway}
486
460
<p>
487
461
A pair of contracts in the token bridge — one on the <ahref="/intro/glossary#parent-chain">Parent chain</a> , one on the <ahref="/intro/glossary#child-chain">Child chain</a> — that provide a particular mechanism for handling the transfer of tokens between layers. Token gateways currently active in the bridge include the <ahref="/intro/glossary#standarderc20-gateway">StandardERC20 gateway</a> , the <ahref="/intro/glossary#genericcustom-gateway">Generic-Custom Gateway</a> , and the <ahref="/intro/glossary#weth-gateway">WETH Gateway</a>.
488
462
</p>
489
463
490
-
### 🏡 TownStory {#townstory-}
491
-
<p>
492
-
If you see some homes along your road trip in the Arbitrum ecosystem, you've made it to TownStory.
493
-
<br />
494
-
495
-
<br />
496
-
Build a warm and prosperous town with friends in TownStory.
497
-
</p>
498
-
499
464
### Transaction {#transaction}
500
465
<p>
501
466
A user-initiated interaction with a Blockchain. Transactions are typically signed by users via wallets and are paid for via transaction fees.
While exploring the Arbitrum ecosystem, you may see some shining stars.
507
-
<br />
508
-
509
-
<br />
510
-
The iconic stars symbolize the magic of Treasure DAO. Treasure DAO is the decentralized gaming ecosystem connecting games and players on Arbitrum.
471
+
The rules and logic employed by a chain to order incoming transactions into a block.
511
472
</p>
512
473
513
474
### Trustless {#trustless}
@@ -555,13 +516,4 @@ A <a href="/intro/glossary#validator">Validator</a> that never stakes / never t
555
516
<ahref="/intro/glossary#token-gateway">Token Gateway</a> for handing the bridging of wrapped Ether (WETH). WETH is unwrapped on L1 and rewrapped on L1 upon depositing (and vice-versa upon withdrawing), ensuring WETH on L2 always remains collateralized.
556
517
</p>
557
518
558
-
### 👺 Zeeverse {#zeeverse}
559
-
<p>
560
-
As you're exploring the Arbitrum world, you may bump into a world filled with monsters and Zee's.
561
-
<br />
562
-
563
-
<br />
564
-
Explore a mythical Spirit Realm as a young Shaman and take part in strategic turn-based battles to help protect Zeeverse from the looming corrupted forces.
0 commit comments