Skip to content
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.

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

Timeboost gentle intro #1749

Open
wants to merge 21 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 10 commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
121 changes: 121 additions & 0 deletions arbitrum-docs/how-arbitrum-works/timeboost/gentle-introduction.md

Large diffs are not rendered by default.

39 changes: 37 additions & 2 deletions arbitrum-docs/partials/_glossary-partial.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@


### 🧱 State Transition Function {#-state-transition-function}
<p>
The STF (State Transition Function) defines how new blocks are produced from input messages (i.e. transactions) in an Arbitrum chain.
</p>

### Active Validator {#active-validator}
<p>
A staked <a href="/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 <a href="/intro/glossary#sequencer">Sequencer</a> ).
Expand Down Expand Up @@ -95,6 +100,16 @@ Arbitrum's "operating system" that trustlessly handles system-level operations;
A staked claim by an Arbitrum <a href="/intro/glossary#validator">Validator</a>. An assertion may, e.g., propose a new <a href="/intro/glossary#rblock">RBlock</a>, or may be a step in a <a href="/intro/glossary#challenge">Challenge</a>.
</p>

### Auction Contract {#auction-contract}
<p>
A smart contract that handles the state, accounting of funds for bids, and various operations of the <a href="/intro/glossary#timeboost">Timeboost</a> auction. The contract is deployed on the target chain for which Timeboost is enabled.
</p>

### Autonomous Auctioneer {#autonomous-auctioneer}
<p>
Off chain software that receives bids from <a href="/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 <a href="/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.
</p>

### Batch {#batch}
<p>
A group of Arbitrum transactions posted in a single transaction on the <a href="/intro/glossary#underlying-chain">Underlying Chain</a> into the <a href="/intro/glossary#fast-inbox">Fast Inbox</a> by the <a href="/intro/glossary#sequencer">Sequencer</a>.
Expand Down Expand Up @@ -245,6 +260,16 @@ A software application used for transacting with the Ethereum <a href="/intro/gl
The paradigm introduced by <a href="/intro/glossary#stylus">Stylus</a> in which Arbitrum's EVM compatibility is preserved while new features and improvements are introduced.
</p>

### Express Lane {#express-lane}
<p>
A component of <a href="/intro/glossary#timeboost">Timeboost</a>, the express lane is a special endpoint on the <a href="/intro/glossary#sequencer">Sequencer</a> that immediately sequences incoming, valid transactions signed by the current express lane controller.
</p>

### Express Lane Controller {#express-lane-controller}
<p>
An address, defined in the <a href="/intro/glossary#auction-contract">Auction Contract</a>, that is granted the privilege to use the <a href="/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.
</p>

### Fair Ordering Algorithm {#fair-ordering-algorithm}
<p>
BFT algorithm in which a committee comes to consensus on transaction ordering; current single-party <a href="/intro/glossary#sequencer">Sequencer</a> on Arbitrum may eventually be replaced by a fair-ordering committee.
Expand All @@ -260,6 +285,11 @@ A means by which a user can bypass an Arbitrum chain's <a href="/intro/glossary#
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 <a href="/intro/glossary#sequencer">Sequencer</a> or indirectly through the <a href="/intro/glossary#delayed-inbox">Delayed Inbox</a>.
</p>

### First Come First Serve (FCFS) {#first-come-first-serve-fcfs}
<p>
A type of <a href="/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.
</p>

### Force-Inclusion {#forceinclusion}
<p>
Censorship resistant path for including a message into an Arbitrum chain via the <a href="/intro/glossary#delayed-inbox">Delayed Inbox</a> on its <a href="/intro/glossary#parent-chain">Parent chain</a>; bypasses any Sequencer involvement.
Expand Down Expand Up @@ -466,9 +496,9 @@ The bow and arrow are commonly associated with the Hero's of Tales of Elleria.
Jump into the world of Elleria and go on adventures.
</p>

### Time boost {#time-boost}
### Timeboost {#timeboost}
<p>
A proposed (not currently live) transaction policy in which users can pay a fee to the <a href="/intro/glossary#sequencer">Sequencer</a> for a small ordering advantage. See [here](<a href="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.
A transaction ordering policy in which entities can bid for the right to access an express lane on the <a href="/intro/glossary#sequencer">Sequencer</a> for faster transaction inclusion. See the <a href="https://github.com/OffchainLabs/timeboost-design/tree/main">research specification</a> to learn more.
</p>

### 🐸 Toadstoolz {#toadstoolz}
Expand Down Expand Up @@ -501,6 +531,11 @@ Build a warm and prosperous town with friends in TownStory.
A user-initiated interaction with a Blockchain. Transactions are typically signed by users via wallets and are paid for via transaction fees.
</p>

### Transaction Ordering Policy {#transaction-ordering-policy}
<p>
The rules and logic employed by a chain to order incoming transactions into a block.
</p>

### ✨ Treasure DAO {#treasure-dao}
<p>
While exploring the Arbitrum ecosystem, you may see some shining stars.
Expand Down
9 changes: 8 additions & 1 deletion website/static/glossary.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
{
"-state-transition-function":{"title":"🧱 State Transition Function","text":"<p>\nThe STF (State Transition Function) defines how new blocks are produced from input messages (i.e. transactions) in an Arbitrum chain.\n</p>"},
"active-validator":{"title":"Active Validator","text":"<p>\nA staked <a href=\"/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 <a href=\"/intro/glossary#sequencer\">Sequencer</a> ).\n</p>"},
"address-alias":{"title":"Address Alias","text":"<p>\nAn address deterministically generated from an L1 contract address used on L2 to safely identify the source of an L1 to L2 message.\n</p>"},
"arb-token-bridge":{"title":"Arb Token Bridge","text":"<p>\nA series of contracts on an Arbitrum chain and its underlying chain that facilitate trustless movement of ERC-20 tokens between the two layers.\n</p>"},
Expand All @@ -18,6 +19,8 @@
"arbitrum-rollup-protocol":{"title":"Arbitrum Rollup Protocol","text":"<p>\nA trustless, permissionless Arbitrum protocol that uses its underlying base layer for data availability and inherits its security. This protocol is implemented by our <a href=\"/intro/glossary#arbitrum-one\">Arbitrum One</a> chain. \n</p>"},
"arbos":{"title":"ArbOS","text":"<p>\nArbitrum's \"operating system\" that trustlessly handles system-level operations; includes the ability to emulate the EVM.\n</p>"},
"assertion":{"title":"Assertion","text":"<p>\nA staked claim by an Arbitrum <a href=\"/intro/glossary#validator\">Validator</a>. An assertion may, e.g., propose a new <a href=\"/intro/glossary#rblock\">RBlock</a>, or may be a step in a <a href=\"/intro/glossary#challenge\">Challenge</a>.\n</p>"},
"auction-contract":{"title":"Auction Contract","text":"<p>\nA smart contract that handles the state, accounting of funds for bids, and various operations of the <a href=\"/intro/glossary#timeboost\">Timeboost</a> auction. The contract is deployed on the target chain for which Timeboost is enabled.\n</p>"},
"autonomous-auctioneer":{"title":"Autonomous Auctioneer","text":"<p>\nOff chain software that receives bids from <a href=\"/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 <a href=\"/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.\n</p>"},
"batch":{"title":"Batch","text":"<p>\nA group of Arbitrum transactions posted in a single transaction on the <a href=\"/intro/glossary#underlying-chain\">Underlying Chain</a> into the <a href=\"/intro/glossary#fast-inbox\">Fast Inbox</a> by the <a href=\"/intro/glossary#sequencer\">Sequencer</a>.\n</p>"},
"blockchain":{"title":"Blockchain","text":"<p>\nA distributed digital ledger that is used to record transactions and store data in a secure, transparent, and tamper-resistant way, notably in cryptocurrency protocols. \n</p>"},
"bls-signature":{"title":"BLS Signature","text":"<p>\nA cryptographic scheme that allows multiple signatures to be aggregated and compacted into one efficiently verifiable, constant-sized signature. Used in the <a href=\"/intro/glossary#arbitrum-anytrust-protocol\">Arbitrum AnyTrust Protocol</a> for the <a href=\"/intro/glossary#data-availability-committee-dac\">Data Availability Committee (DAC)</a>'s signatures.\n</p>"},
Expand Down Expand Up @@ -46,9 +49,12 @@
"espresso":{"title":"Espresso","text":"<p>\nProject partnering with <a href=\"/intro/glossary#offchain-labs\">Offchain Labs</a> for research and development around <a href=\"/intro/glossary#sequencer\">Sequencer</a> transaction ordering and <a href=\"/intro/glossary#shared-sequencing\">Shared Sequencing</a> technology. \n</p>"},
"ethereum-wallet":{"title":"Ethereum Wallet","text":"<p>\nA software application used for transacting with the Ethereum <a href=\"/intro/glossary#blockchain\">Blockchain</a>.\n</p>"},
"evm":{"title":"EVM+","text":"<p>\nThe paradigm introduced by <a href=\"/intro/glossary#stylus\">Stylus</a> in which Arbitrum's EVM compatibility is preserved while new features and improvements are introduced.\n</p>"},
"express-lane":{"title":"Express Lane","text":"<p>\nA component of <a href=\"/intro/glossary#timeboost\">Timeboost</a>, the express lane is a special endpoint on the <a href=\"/intro/glossary#sequencer\">Sequencer</a> that immediately sequences incoming, valid transactions signed by the current express lane controller. \n</p>"},
"express-lane-controller":{"title":"Express Lane Controller","text":"<p>\nAn address, defined in the <a href=\"/intro/glossary#auction-contract\">Auction Contract</a>, that is granted the privilege to use the <a href=\"/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.\n</p>"},
"fair-ordering-algorithm":{"title":"Fair Ordering Algorithm","text":"<p>\nBFT algorithm in which a committee comes to consensus on transaction ordering; current single-party <a href=\"/intro/glossary#sequencer\">Sequencer</a> on Arbitrum may eventually be replaced by a fair-ordering committee.\n</p>"},
"fast-exit--liquidity-exit":{"title":"Fast Exit / Liquidity Exit","text":"<p>\nA means by which a user can bypass an Arbitrum chain's <a href=\"/intro/glossary#challenge-period\">Challenge Period</a> when withdrawing fungible assets (or more generally, executing some \"fungible\" L2 to L1 operation); for trustless fast exits, a liquidity provider facilitates an atomic swap of the asset on L2 directly to L1.\n</p>"},
"fast-inbox":{"title":"Fast Inbox","text":"<p>\nContract 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 <a href=\"/intro/glossary#sequencer\">Sequencer</a> or indirectly through the <a href=\"/intro/glossary#delayed-inbox\">Delayed Inbox</a>.\n</p>"},
"first-come-first-serve-fcfs":{"title":"First Come First Serve (FCFS)","text":"<p>\nA type of <a href=\"/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.\n</p>"},
"forceinclusion":{"title":"Force-Inclusion","text":"<p>\nCensorship resistant path for including a message into an Arbitrum chain via the <a href=\"/intro/glossary#delayed-inbox\">Delayed Inbox</a> on its <a href=\"/intro/glossary#parent-chain\">Parent chain</a>; bypasses any Sequencer involvement.\n</p>"},
"fraud-proof":{"title":"Fraud proof","text":"<p>\nThe means by which an <a href=\"/intro/glossary#active-validator\">Active Validator</a> proves to its underlying chain that an invalid state transition has taken place.\n</p>"},
"gas-price-floor":{"title":"Gas Price Floor","text":"<p>\nProtocol-enforced minimum gas price on an Arbitrum chain; currently 0.1 gwei on <a href=\"/intro/glossary#arbitrum-one\">Arbitrum One</a> and 0.01 gwei on <a href=\"/intro/glossary#arbitrum-nova\">Arbitrum Nova</a>.\n</p>"},
Expand Down Expand Up @@ -87,11 +93,12 @@
"standarderc20-gateway":{"title":"StandardERC20 gateway","text":"<p>\n<a href=\"/intro/glossary#token-gateway\">Token Gateway</a> via which any underlying chain's ERC20 token can permissionlessly bridge; the StandardERC20 gateway contracts deploy a <a href=\"/intro/glossary#standard-arbtoken\">Standard Arb-Token</a> on the <a href=\"/intro/glossary#child-chain\">Child chain</a> for each bridged token.\n</p>"},
"stylus":{"title":"Stylus","text":"<p>\nUpgrade to the <a href=\"/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 (<a href=\"https://docs.arbitrum.io/stylus/stylus-gentle-introduction\">read more</a>).\n</p>"},
"tales-of-elleria":{"title":"Tales of Elleria","text":"<p>\nThe bow and arrow are commonly associated with the Hero's of Tales of Elleria.\n<br />\n\n<br />\nJump into the world of Elleria and go on adventures.\n</p>"},
"time-boost":{"title":"Time boost","text":"<p>\nA proposed (not currently live) transaction policy in which users can pay a fee to the <a href=\"/intro/glossary#sequencer\">Sequencer</a> for a small ordering advantage. See [here](<a href=\"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. \n</p>"},
"timeboost":{"title":"Timeboost","text":"<p>\nA transaction ordering policy in which entities can bid for the right to access an express lane on the <a href=\"/intro/glossary#sequencer\">Sequencer</a> for faster transaction inclusion. See the <a href=\"https://github.com/OffchainLabs/timeboost-design/tree/main\">research specification</a> to learn more. \n</p>"},
"toadstoolz":{"title":"Toadstoolz","text":"<p>\nHidden in the Croakshire, you will find the friendly Toadstoolz. \n<br />\n\n<br />\nThe iconic Toads of Arbitrum love to hunt BUGZ \n<br />\n and collect NFTs. !CROAK\n</p>"},
"token-gateway":{"title":"Token Gateway","text":"<p>\nA pair of contracts in the token bridge — one on the <a href=\"/intro/glossary#parent-chain\">Parent chain</a> , one on the <a href=\"/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 <a href=\"/intro/glossary#standarderc20-gateway\">StandardERC20 gateway</a> , the <a href=\"/intro/glossary#genericcustom-gateway\">Generic-Custom Gateway</a> , and the <a href=\"/intro/glossary#weth-gateway\">WETH Gateway</a>.\n</p>"},
"townstory-":{"title":"TownStory ","text":"<p>\nIf you see some homes along your road trip in the Arbitrum ecosystem, you've made it to TownStory.\n<br />\n\n<br />\nBuild a warm and prosperous town with friends in TownStory.\n</p>"},
"transaction":{"title":"Transaction","text":"<p>\nA user-initiated interaction with a Blockchain. Transactions are typically signed by users via wallets and are paid for via transaction fees. \n</p>"},
"transaction-ordering-policy":{"title":"Transaction Ordering Policy","text":"<p>\nThe rules and logic employed by a chain to order incoming transactions into a block.\n</p>"},
"treasure-dao":{"title":"Treasure DAO","text":"<p>\nWhile exploring the Arbitrum ecosystem, you may see some shining stars.\n<br />\n\n<br />\nThe iconic stars symbolize the magic of Treasure DAO. Treasure DAO is the decentralized gaming ecosystem connecting games and players on Arbitrum.\n</p>"},
"trustless":{"title":"Trustless","text":"<p>\nIn the context of Ethereum, trustless refers to the ability of a system to operate without reliance on a central authority or intermediary. Instead, users place their trust in math and protocols.\n<br />\n\n<br />\nThis is achieved through the use of cryptographic techniques and decentralized consensus mechanisms that let users verify the integrity of network transactions using open-source software. Trustless systems are considered to be more secure and resistant to fraud or tampering because they don't rely on a single point of failure that can be exploited by attackers.\n</p>\n\n<p>\n\n</p>\n\n"},
"underlying-chain":{"title":"Underlying Chain","text":"<p>\nSynonymous with <a href=\"/intro/glossary#parent-chain\">Parent chain</a>.\n</p>"},
Expand Down