From 51594066743782ce503b1b33841bf4cc09374042 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABl=20Blanchemain?= Date: Thu, 23 Apr 2026 17:51:54 -0700 Subject: [PATCH 1/2] add stub priority fees page (TW-740) Stub for the ArbOS 60 priority-fee collection feature. Real content to follow from SME (Vanessa Bridge) once drafted in Notion. Note: feature requires a separate Constitutional vote to activate. --- .../common/gas/priority-fees.mdx | 10 ++++++++++ sidebars.js | 5 +++++ 2 files changed, 15 insertions(+) create mode 100644 docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx diff --git a/docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx b/docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx new file mode 100644 index 0000000000..3ea98be699 --- /dev/null +++ b/docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx @@ -0,0 +1,10 @@ +--- +title: 'Priority fees' +sidebar_label: 'Priority fees' +description: 'Documentation for the priority-fee collection feature introduced in ArbOS 60 Elara.' +content_type: concept +author: '[TBD]' +sme: '[TBD]' +--- + +Stub for the priority-fee collection page introduced in ArbOS 60 "Elara". Content to be added by SME (Vanessa Bridge) — see [TW-740](https://linear.app/offchain-labs/issue/TW-740). diff --git a/sidebars.js b/sidebars.js index bc4cc21172..e30fab6210 100644 --- a/sidebars.js +++ b/sidebars.js @@ -430,6 +430,11 @@ const sidebars = { id: 'launch-arbitrum-chain/configure-your-chain/common/gas/dynamic-pricing-for-arbitrum-chains', label: 'Dynamic Pricing for Arbitrum Chains', }, + { + type: 'doc', + id: 'launch-arbitrum-chain/configure-your-chain/common/gas/priority-fees', + label: 'Priority fees', + }, ], }, { From 553c5812babc74ab5c855b4533d544d7b942ad2a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABl=20Blanchemain?= Date: Tue, 5 May 2026 13:42:05 -0700 Subject: [PATCH 2/2] fill in priority-fees content from Notion draft (Vanessa Bridge) Replaces the stub with the SME-drafted content covering: - Activation gate (Constitutional vote requirement) as prominent caution - ArbOwner.setCollectTips() usage - Activation/receipt timing caveat (known issue when enabling mid-block) - The two requirements for tip-based ordering (collection + sequencer logic) - References to the Constitutional AIP and ArbOwner source Source: https://www.notion.so/arbitrum/Priority-fees-collection-ArbOS-60-34b01a3f59f8814ea643e85330c90c56 Awaiting Vanessa's review on the MDX rendering before flipping out of draft. --- .../common/gas/priority-fees.mdx | 61 +++++++++++++++++-- 1 file changed, 56 insertions(+), 5 deletions(-) diff --git a/docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx b/docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx index 3ea98be699..34e50959eb 100644 --- a/docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx +++ b/docs/launch-arbitrum-chain/02-configure-your-chain/common/gas/priority-fees.mdx @@ -1,10 +1,61 @@ --- -title: 'Priority fees' +title: 'Priority fees collection' sidebar_label: 'Priority fees' -description: 'Documentation for the priority-fee collection feature introduced in ArbOS 60 Elara.' +description: "How to enable priority-fee (tip) collection on an Arbitrum chain in ArbOS 60 'Elara', and the additional requirements for tip-based transaction ordering." content_type: concept -author: '[TBD]' -sme: '[TBD]' +author: 'gaelblanchemain' +sme: 'vbridge-hash' --- -Stub for the priority-fee collection page introduced in ArbOS 60 "Elara". Content to be added by SME (Vanessa Bridge) — see [TW-740](https://linear.app/offchain-labs/issue/TW-740). +ArbOS 60 ("Elara") introduces the **capability** for chain owners to collect priority fees (tips) on their Arbitrum chain. The feature ships disabled, and a chain owner can enable it through a deliberate, two-step action. + + + +For Arbitrum One and Nova, enabling this feature requires an **additional Constitutional DAO vote** — it isn't activated as part of the ArbOS 60 upgrade itself. The upgrade only makes tip collection *possible* for chains that opt in. + + + +## How to enable tip collection + +The chain owner calls the [`ArbOwner` precompile](/build-decentralized-apps/precompiles/02-reference.mdx#arbowner) at `0x0000000000000000000000000000000000000070`: + +```solidity +// Enable tip collection +IArbOwner(address(0x70)).setCollectTips(true); + +// Disable it again +IArbOwner(address(0x70)).setCollectTips(false); + +// Read the current state +bool collecting = IArbOwner(address(0x70)).getCollectTips(); +``` + +`ArbOwner` is access-controlled — only the chain owner (typically the DAO or a designated operator address) can call these methods. The implementation is in [`precompiles/ArbOwner.go`](https://github.com/OffchainLabs/nitro/blob/6dce8d13902649a1acdfd3f2504129f1f5612358/precompiles/ArbOwner.go#L666). + +## How tips are collected + +Once enabled, any `priorityFee` (EIP-1559 `maxPriorityFeePerGas`) included in a transaction is collected the same way all other gas fees are, and routed into an onchain account. No separate infrastructure is needed. + +## Activation and receipt timing + +If tip-paying transactions land in the same block but **before** the transaction that enables fee collection, tips aren't collected from those earlier transactions — but their receipts will report tips as if they were. This is a known issue. + +To avoid it, the chain owner can either: + +- enable tip collection inside a delayed transaction, or +- ensure the enabling transaction is the first (or only) transaction in its block. + +## Tip-based transaction ordering + +Enabling collection alone does **not** change how transactions are ordered. For priority fees to actually influence sequencing, the chain needs **both**: + +1. **`setCollectTips(true)`** — activates fee collection via `ArbOwner`. +2. **Updated sequencer logic** — the sequencer must be configured to read the `PriorityFee` field when sorting transactions. + +Without step 2, the sequencer continues to use its existing ordering rules (such as [Timeboost](/how-arbitrum-works/timeboost/gentle-introduction.mdx)) regardless of the priority fee attached to a transaction. + +## References + +- [Constitutional AIP: ArbOS 60 Elara — Priority fees](https://forum.arbitrum.foundation/t/constitutional-aip-arbos-60-elara/30601) +- [`ArbOwner` precompile reference](/build-decentralized-apps/precompiles/02-reference.mdx#arbowner) +- [`setCollectTips` source](https://github.com/OffchainLabs/nitro/blob/6dce8d13902649a1acdfd3f2504129f1f5612358/precompiles/ArbOwner.go#L666)