Multi constraint pricing system #2988
Open
+97
−2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
… constraint-based-pricing-for-arbitrum-chains.mdx
|
@asomani-ocl is attempting to deploy a commit to the Offchain Labs - AF Billed Team on Vercel. A member of the Team first needs to authorize it. |
|
|
leeederek
requested changes
Jan 7, 2026
Member
leeederek
left a comment
leeederek
left a comment
There was a problem hiding this comment.
Let's avoid using Constraints in our public references (as much as possible). The entire new pricing algorithm is called Dynamic Pricing. I tried to catch and suggest changes where it made sense, but i might've missed a few. Thanks!
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-configure-your-chain/common-configurations/constraint-based-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
leeederek
approved these changes
Jan 9, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
…igurations/dynamic-pricing-for-arbitrum-chains.mdx Co-authored-by: Derek Lee <[email protected]>
|
Deployment failed with the following error: View Documentation: https://vercel.com/docs/accounts/team-members-and-roles |
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
|
|
||
| ## How to set multiple gas targets | ||
|
|
||
| You can call `SetGasPricingConstraints` on the [ArbOwner precompile](../../../for-devs/dev-tools-and-resources/partials/precompile-tables/_ArbOwner) with an array of gas targets (the code refers to these targets as "constraints"), where each constraint contains \[gasTargetPerSecond, adjustmentWindowSeconds, startingBacklogValue\]. |
Contributor
There was a problem hiding this comment.
Suggested change
| You can call `SetGasPricingConstraints` on the [ArbOwner precompile](../../../for-devs/dev-tools-and-resources/partials/precompile-tables/_ArbOwner) with an array of gas targets (the code refers to these targets as "constraints"), where each constraint contains \[gasTargetPerSecond, adjustmentWindowSeconds, startingBacklogValue\]. | |
| You can call `SetGasPricingConstraints` on the [ArbOwner precompile](../../../for-devs/dev-tools-and-resources/partials/precompile-tables/_ArbOwner) with an array of gas targets (the code refers to these targets as "constraints"), where each constraint contains `\[gasTargetPerSecond, adjustmentWindowSeconds, startingBacklogValue\]`. |
Member
There was a problem hiding this comment.
which word are you referring to
Contributor
There was a problem hiding this comment.
[gasTargetPerSecond, adjustmentWindowSeconds, startingBacklogValue]
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
| [State Growth Guidance](../../maintain-your-chain/guidance/state-growth): Impact of high gas targets on state growth and its consequences | ||
|
|
||
| - node_throughput \- Sustainable maximum throughput that the nodes can maintain without any issues. This is highly dependent on your specific hardware and chain workload. Offchain Labs will soon publish testing frameworks and tools that can be used to benchmark what throughput your nodes can handle for various workloads. | ||
| - gas_limit \- Theoretical max block size limit. With the introduction of the `MaxTxGasLimit`, the effective block gas limit is twice the `MaxBlockGasLimit`. We recommend using an in-between value of `MaxBlockGasLimit` and Effective Block gas limit `(MaxTxGasLimit + MaxBlockGasLimit)` for this parameter. |
Contributor
There was a problem hiding this comment.
@anegg0 we should add a link to the explanation in docs on effective block gas limit
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Show resolved
Hide resolved
Co-authored-by: Daniel Lumi <[email protected]>
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
...-chain/02-configure-your-chain/common-configurations/dynamic-pricing-for-arbitrum-chains.mdx
Outdated
Show resolved
Hide resolved
zk-Lumi
reviewed
Jan 14, 2026
|
|
||
| - node_throughput \- Sustainable maximum throughput that the nodes can maintain without any issues. This is highly dependent on your specific hardware and chain workload. Offchain Labs will soon publish testing frameworks and tools that can be used to benchmark what throughput your nodes can handle for various workloads. | ||
| - gas_limit \- Theoretical max block size limit. With the introduction of the `MaxTxGasLimit`, the effective block gas limit is twice the `MaxBlockGasLimit`. We recommend using an in-between value of `MaxBlockGasLimit` and Effective Block gas limit `(MaxTxGasLimit + MaxBlockGasLimit)` for this parameter. | ||
| - max_rate_of_increase_percent_per_second \- maximum allowed rate of increase in the fee per sec when the chain is working at the max capacity. |
Contributor
There was a problem hiding this comment.
Suggested change
| - max_rate_of_increase_percent_per_second \- maximum allowed rate of increase in the fee per sec when the chain is working at the max capacity. | |
| - `max_rate_of_increase_percent_per_second` \- maximum allowed rate of increase in the fee per sec when the chain is working at the max capacity. |
zk-Lumi
reviewed
Jan 14, 2026
|
|
||
| Refer to the definitions below to understand what each parameter means: | ||
|
|
||
| - gasTargetPerSecond \- the target gas processing rate for your Arbitrum chain \- it's the amount of gas the system aims to process each second under normal conditions. Any demand above this target will induce a gas price increase as a way to economically disincentivize usage until it gets reduced to the target. |
Contributor
There was a problem hiding this comment.
Suggested change
| - gasTargetPerSecond \- the target gas processing rate for your Arbitrum chain \- it's the amount of gas the system aims to process each second under normal conditions. Any demand above this target will induce a gas price increase as a way to economically disincentivize usage until it gets reduced to the target. | |
| - `gasTargetPerSecond` \- the target gas processing rate for your Arbitrum chain \- it's the amount of gas the system aims to process each second under normal conditions. Any demand above this target will induce a gas price increase as a way to economically disincentivize usage until it gets reduced to the target. |
zk-Lumi
reviewed
Jan 14, 2026
| Refer to the definitions below to understand what each parameter means: | ||
|
|
||
| - gasTargetPerSecond \- the target gas processing rate for your Arbitrum chain \- it's the amount of gas the system aims to process each second under normal conditions. Any demand above this target will induce a gas price increase as a way to economically disincentivize usage until it gets reduced to the target. | ||
| - adjustmentWindowSeconds \- time period with which the system will measure average gas demand/usage over to determine whether or not the gas price needs to be adjusted, relative to the gas target. A larger window results in more stable, predictable pricing, while a smaller window reacts aggressively to traffic spikes. |
Contributor
There was a problem hiding this comment.
Suggested change
| - adjustmentWindowSeconds \- time period with which the system will measure average gas demand/usage over to determine whether or not the gas price needs to be adjusted, relative to the gas target. A larger window results in more stable, predictable pricing, while a smaller window reacts aggressively to traffic spikes. | |
| - `adjustmentWindowSeconds` \- time period with which the system will measure average gas demand/usage over to determine whether or not the gas price needs to be adjusted, relative to the gas target. A larger window results in more stable, predictable pricing, while a smaller window reacts aggressively to traffic spikes. |
zk-Lumi
reviewed
Jan 14, 2026
|
|
||
| - gasTargetPerSecond \- the target gas processing rate for your Arbitrum chain \- it's the amount of gas the system aims to process each second under normal conditions. Any demand above this target will induce a gas price increase as a way to economically disincentivize usage until it gets reduced to the target. | ||
| - adjustmentWindowSeconds \- time period with which the system will measure average gas demand/usage over to determine whether or not the gas price needs to be adjusted, relative to the gas target. A larger window results in more stable, predictable pricing, while a smaller window reacts aggressively to traffic spikes. | ||
| - startingBacklogValue \- the initial amount of gas the system uses to set prices the **exact moment** the gasTargetPerSecond and adjustmentWindowSeconds get changed. |
Contributor
There was a problem hiding this comment.
Suggested change
| - startingBacklogValue \- the initial amount of gas the system uses to set prices the **exact moment** the gasTargetPerSecond and adjustmentWindowSeconds get changed. | |
| - `startingBacklogValue` \- the initial amount of gas the system uses to set prices the **exact moment** the gasTargetPerSecond and adjustmentWindowSeconds get changed. |
zk-Lumi
reviewed
Jan 14, 2026
|
|
||
| | Param | Arbitrum One Config | | ||
| | :-------------------------------------- | :------------------ | | ||
| | long_term_gas_target | 10 Mgas/s | |
Contributor
There was a problem hiding this comment.
Suggested change
| | long_term_gas_target | 10 Mgas/s | | |
| | `long_term_gas_target` | 10 Mgas/s | |
zk-Lumi
reviewed
Jan 14, 2026
| | Param | Arbitrum One Config | | ||
| | :-------------------------------------- | :------------------ | | ||
| | long_term_gas_target | 10 Mgas/s | | ||
| | node_throughput | 80 Mgas/s | |
Contributor
There was a problem hiding this comment.
Suggested change
| | node_throughput | 80 Mgas/s | | |
| | `node_throughput` | 80 Mgas/s | |
zk-Lumi
reviewed
Jan 14, 2026
| | :-------------------------------------- | :------------------ | | ||
| | long_term_gas_target | 10 Mgas/s | | ||
| | node_throughput | 80 Mgas/s | | ||
| | gas_limit | 128 Mgas/s | |
Contributor
There was a problem hiding this comment.
Suggested change
| | gas_limit | 128 Mgas/s | | |
| | `gas_limit` | 128 Mgas/s | |
zk-Lumi
reviewed
Jan 14, 2026
| | long_term_gas_target | 10 Mgas/s | | ||
| | node_throughput | 80 Mgas/s | | ||
| | gas_limit | 128 Mgas/s | | ||
| | max_rate_of_increase_percent_per_second | 20 | |
Contributor
There was a problem hiding this comment.
Suggested change
| | max_rate_of_increase_percent_per_second | 20 | | |
| | `max_rate_of_increase_percent_per_second` | 20 | |
zk-Lumi
reviewed
Jan 14, 2026
| | node_throughput | 80 Mgas/s | | ||
| | gas_limit | 128 Mgas/s | | ||
| | max_rate_of_increase_percent_per_second | 20 | | ||
| | long_term_adjustment_window_seconds | 86400 sec | |
Contributor
There was a problem hiding this comment.
Suggested change
| | long_term_adjustment_window_seconds | 86400 sec | | |
| | `long_term_adjustment_window_seconds` | 86400 sec | |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
6 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Thank you for contributing to our docs!
Please fill out the below to ensure your doc gets quickly approved and merged.
Description
Document type
Checklist
yarn startoryarn buildAdditional Notes