Arbitrum Nitro Contracts v3.2.0

v3.2.0

Highlights

Custom Data Availability Support

This release introduces a pluggable interface for custom DA providers. Chains can now implement ICustomDAProofValidator to support alternative data availability solutions beyond the built-in DAS and blob support.

Improved Base Stake Management

Base stake changes are now split into increaseBaseStake and decreaseBaseStake functions. Decreasing stake is restricted to permissioned chains with additional safety checks to prevent fund extraction attacks.

Deterministic Factory Deployment

Factory contracts now deploy to deterministic addresses via Create2, simplifying multi-chain deployments and verification.

Breaking Changes

Interface Changes

• IRollupAdmin.setBaseStake(uint256) → decreaseBaseStake(uint256, uint64) + increaseBaseStake(uint256)
• IRollupEventInbox.rollupInitialized(uint256, string) → rollupInitialized(uint256, string, uint256)

Constructor Changes

• RollupCreator now requires all template parameters at construction
• OneStepProverHostIo requires customDAValidator address (use address(0) for default behavior)

Removed Functionality

• BridgeCreator.updateTemplates() and updateERC20Templates() - templates are now immutable
• ValidatorWalletCreator.setTemplate() - template is now immutable
• FactoryDeployerHelper contract removed entirely

What's Changed

• feat: reduce base stake by @yahgwai in #391
• feat: add CustomDA proof validation interface by @Tristan-Wilson in #357
• feat: set optional dataCostEstimate on rollup initialization by @TucksonDev in #388
• feat: use create2 for factory deployment by @godzillaba in #358
• feat: deployOsp script by @gzeoneth in #367
• feat: ResourceConstraintManager by @gzeoneth in #389
• chore: pin precompiles to v50 by @gzeoneth in #394
• docs: update rollup creation instructions by @TucksonDev in #392
• Rename empty genesis assertion hash function by @TucksonDev in #386

New Contributors

• @TucksonDev made their first contribution in #342
• @mkykadir made their first contribution in #381
• @MishkaRogachev made their first contribution in #385
• @Tristan-Wilson made their first contribution in #357

Full Changelog: https://github.com/OffchainLabs/nitro-contracts/compare/v3.1.1..v3.2.0

Arbitrum Nitro Contracts v3.2.0-beta.0

What's Changed

• feat: reduce base stake by @yahgwai in #391
• feat: add CustomDA proof validation interface by @Tristan-Wilson in #357
• feat: set optional dataCostEstimate on rollup initialization by @TucksonDev in #388
• feat: use create2 for factory deployment by @godzillaba in #358
• feat: deployOsp script by @gzeoneth in #367
• feat: ResourceConstraintManager by @gzeoneth in #389
• chore: pin precompiles to v50 by @gzeoneth in #394
• docs: update rollup creation instructions by @TucksonDev in #392
• Rename empty genesis assertion hash function by @TucksonDev in #386

setting base to main for review

Arbitrum Nitro Contracts v3.1.1

What's Changed

This patch release includes ERC20MigrationOutbox and some minor improvement to the StylusDeployer factory. Existing chain deployments are not required to upgrade.

• feat: bubble up error in stylus init by @gzeoneth in #338
• chore: moving mocks and precompile interfaces by @gzeoneth in #354
• feat: ERC20MigrationOutbox by @gzeoneth in #339

New Contributors

• @TucksonDev made their first contribution in #342

Full Changelog: v3.1.0...v3.1.1

Arbitrum Nitro Contracts v3.1.0

NOTICE: The release contains breaking change to the previous v2.x version with new abi and storage layout. Please follow our guide when upgrading from previous versions and checkout the diff in `test/signatures` and `test/storage` when upgrading from unsupported versions.
NOTICE: Rollup MUST be migrated when upgrading from previous versions, do NOT upgrade the rollup contracts in-place

What's Changed

Support rollup mode when using custom fee token when a pricer is configured.

• Support for rollup mode when using fee token by @gvladika #252
• Stylus deployer by @yahgwai in #294
• chore: bump dependencies by @gzeoneth in #308
• Adds the setWasmMaxSize precompile function to ArbOwner by @eljobe in #316
• add custom hardhat network for bold scripts by @godzillaba in #317
• fix: v3 rollup deployment tool by @gzeoneth in #312

Full Changelog: v3.0.0...v3.1.0

Arbitrum Nitro Contracts v3.0.1-beta.1

What's Changed

• Stylus deployer by @yahgwai in #294
• Add methods to enable/disable and check the EIP-7623 feature by @eljobe in #311
• chore: bump dependencies by @gzeoneth in #308
• Adds the setWasmMaxSize precompile function to ArbOwner by @eljobe in #316
• Multi redeem public by @eljobe in #313
• add custom hardhat network for bold scripts by @godzillaba in #317
• Update BOLD prepare script for orbit by @godzillaba in #297
• SelfDestruct helper contracts for unit testing SelfDestruct by @amsanghi in #319
• fix: v3 rollup deployment tool by @gzeoneth in #312
• fix: hardhat deploy getContract is deprecated by @gzeoneth in #322

Full Changelog: v3.0.1-beta.0...v3.0.1-beta.1

Arbitrum Nitro Contracts v3.0.1-beta.0

What's Changed

• Use stable foundry on develop by @godzillaba in #298
• ArbOS11To32UpgradeTest develop base branch by @diegoximenes in #286
• chore: bigmap mock and update metadata hash script by @gzeoneth in #299

Full Changelog: v3.0.0...v3.0.1-beta.0

Arbitrum Nitro Contracts v2.1.3

What's Changed

• Apply 7702 patch by @yahgwai in #291

Full Changelog: v2.1.2...v2.1.3

Arbitrum Nitro Contracts v2.1.2

What's Changed

• Formatting updates for foundry from v0.2.0 to v0.3.0 by @yahgwai in #293
• Decimals patch version - v2.1.2 by @yahgwai in #292

Full Changelog: v2.1.1...v2.1.2

Arbitrum Nitro Contracts v3.0.0

NOTICE: The release contains breaking change to the previous version including new abi and storage layout. Please follow our guide when upgrading from previous versions and checkout the diff in `test/signatures` and `test/storage` when upgrading from unsupported versions.
NOTICE: Rollup MUST be migrated when upgrading from previous versions, do NOT upgrade the rollup contracts in-place

What's Changed

Introducing BoLD, the new challenge resolution protocol for Arbitrum chains.

• feat: bold by @gzeoneth in #193

This release also included some bug fixes:

• fix: eip 7702 by @gzeoneth in #259
• Handle "no zero transfer" tokens by @godzillaba in #250
• small AbsBridge::enqueueSequencerMessage gas optimization by @godzillaba in #230
• refactor: move hardcoded value to config by @gzeoneth in #270
• use create2 in BridgeCreator by @godzillaba in #265

There are also changes to the formatting rules that lead to some big diff, see:

• fix: formating and enable checks in ci by @gzeoneth in #208

Full Changelog: v2.1.1...v3.0.0

Arbitrum Nitro Contracts v3.0.0-beta.1

What's Changed

• update links in README.md by @0xallan in #276
• test: improve coverage by @gzeoneth in #280

Full Changelog: v3.0.0-beta.0...v3.0.0-beta.1