Release v2026.02.10-1

Docker Image

ghcr.io/xmtp/contracts:v2026.02.10-1

What's Changed

• Fix Distribution Manager's call to Payer Report to use correct struct definition by @KevinSmall in #241
• Node registry upgrade in testnet-staging - config JSON by @KevinSmall in #244
• Fireblocks Prep: Adjust all upgrade and deploy scripts to have clear separation between ADMIN and DEPLOYER steps by @KevinSmall in #238
• Clarify units by @fbac in #245
• Pin slither in CI test runs by @KevinSmall in #257
• Config file upgrade testnet-dev distribution manager by @KevinSmall in #256
• Get start time from parameter registry by @neekolas in #254

Full Changelog: v2025.12.12-1...v2026.02.10-1

Release v2025.12.12-1

Docker Image

ghcr.io/xmtp/contracts:v2025.12.12-1

What's Changed

• During node registry deployment, update the admin and max canonical node values by @KevinSmall in #218
• Remove the testnet-gateways test environment by @KevinSmall in #220
• Canonical node count storage variable not used anymore, replace with enumerable set length by @KevinSmall in #219
• Scripts to snapshot public contract state to JSON by @KevinSmall in #214
• Config json file for testnet-dev node registry upgrade by @KevinSmall in #221
• Add mainnet support to scripts and add more contracts to snapshot by @KevinSmall in #222
• Config and environment files for mainnet deploy by @KevinSmall in #225
• Fix code verification for XMTP mainnet L3 by @KevinSmall in #227
• Helper script to bridge a single parameter from settlement chain to app chain parameter registry by @KevinSmall in #228
• Add Fireblocks JSON RPC by @KevinSmall in #229

Full Changelog: v2025.12.03-1...v2025.12.12-1

Release v2025.12.03-1

Docker Image

ghcr.io/xmtp/contracts:v2025.12.03-1

What's Changed

• Redeploy node registry, payer report manager, distribution manager in testnet-dev by @KevinSmall in #213
• PayerReportManager _sortUint32Array test suite by @fbac in #212
• Update config and environment json files after testnet upgrade and redeploy by @KevinSmall in #217

Full Changelog: v2025.11.26-1...v2025.12.03-1

Release v2025.11.26-1

Docker Image

ghcr.io/xmtp/contracts:v2025.11.26-1

What's Changed

• NodeRegistry updateAdmin check for zero address by @KevinSmall in #179
• Fix yarn coverage call by @KevinSmall in #180
• Parameter validation checks from audit by @KevinSmall in #181
• Add getCanonicalNodes() function by @fbac in #183
• Cheaper _enforceNodeIdsMatchRegistry by @fbac in #184
• EIP1967 Migrators by @mkysel in #169
• Delayed Review Comments by @mkysel in #186
• Upgrade script for node registry with contract state checks and environment JSON update by @KevinSmall in #187
• Fix upgrade script - do not write implementation address to environment json by @KevinSmall in #189
• Add contract name and version 1.0.0 to all base and environment contracts by @KevinSmall in #185
• Fresh release scripts for Node Registry and Payer Report Manager by @KevinSmall in #190
• Upgrade scripts for settlement chain proxy contracts by @KevinSmall in #191
• Update testnet-dev.json to reflect settlement chain contract upgrades by @KevinSmall in #192
• Add fresh release script for Distribution Manager, add entrypoints to update dependencies in individual deploy scripts by @KevinSmall in #193
• Config and environment json file updates after testnet-dev deploys by @KevinSmall in #194
• Config and environment json file updates after testnet-staging deploys by @KevinSmall in #197
• App chain upgrade scripts by @KevinSmall in #198
• Update config addresses after app chain upgrades for testnet-staging by @KevinSmall in #204
• PayerReportManager: Avoid double ABI encoding by @fbac in #205
• READMEs for executing scripts on settlement chain (upgrade and deploy) and app chain (upgrade) by @KevinSmall in #199
• Upgrade testnet-staging PayerReportManager to main by @fbac in #207
• Refactor scripts folder (no functional changes) by @KevinSmall in #206
• Cursor rule to suggest increasing contract version number by @KevinSmall in #208

New Contributors

• @KevinSmall made their first contribution in #179

Full Changelog: v0.6.0...v2025.11.26-1

Release v0.6.0

Docker Image

ghcr.io/xmtp/contracts:v0.6.0

What's Changed

• feat: Add recipient to SettlementChainGateway.Deposit event by @deluca-mike in #123
• fix: Remove indexing of ParameterSet arguments by @deluca-mike in #122
• Deploy proxies and fix stack depth issue by @mkysel in #128
• Make addresses actually reproducible by @mkysel in #129
• Documentation by @fbac in #130
• Documentation on payer reports by @fbac in #131
• doc: Updates to some docs and Proxy/Factory/Migration documentation by @deluca-mike in #132
• Copy and style edits for smart contract docs by @jhaaaa in #133
• doc: fixed parameter bridging flow by @deluca-mike in #135
• Allow larger wei conversions by impoving multiplication order by @mkysel in #138
• Expand docs with ParameterRegistry keys by @fbac in #137
• Update foundry to newest stable by @mkysel in #145
• Remove integration tests by @mkysel in #146
• Track withdrawals with nonce by @fbac in #147
• Include max fees in the Deposit event by @fbac in #142
• Extend UsageSettled by @fbac in #143
• Fix XMTP-1 audit error by @mkysel in #150
• Enforce boundary checks for getPayerReport by @mkysel in #160
• Check PayerReport uniqueness by @fbac in #161
• fix: XMTP-2 and XMTP-3 audit issues by @deluca-mike in #163
• Require payer report submission to be consistent with the canonical set of nodes by @mkysel in #162
• doc: TODO cleanup by @deluca-mike in #168
• fix: Prevent protocol fee withdrawals if recipient is zero (XMTP-11) by @deluca-mike in #166
• fix: use abi.encode for hashing arrays (XMTP-10) by @deluca-mike in #165

Full Changelog: v0.5.5...v0.6.0

Release v0.5.5

Docker Image

ghcr.io/xmtp/contracts:v0.5.5

What's Changed

• feat: improved DepositSplitter by @deluca-mike in #120
• fix: gateway deposit bug by @deluca-mike in #121

Full Changelog: v0.5.3...v0.5.5

Release v0.5.3

Docker Image

ghcr.io/xmtp/contracts:v0.5.3

What's Changed

• Settlement chain smart contract overview docs by @jhaaaa in #116
• feat: DepositReceived and WithdrawalReceived by @deluca-mike in #117
• feat: testnet-staging and testnet deployed by @deluca-mike in #118

New Contributors

• @jhaaaa made their first contribution in #116

Full Changelog: v0.5.2...v0.5.3

Release v0.5.2

Docker Image

ghcr.io/xmtp/contracts:v0.5.2

What's Changed

• feat: deposit splitter by @deluca-mike in #111
• feat: migration tests and scripts by @deluca-mike in #114

Full Changelog: v0.5.1...v0.5.2

Release v0.5.1

Docker Image

ghcr.io/xmtp/contracts:v0.5.1

What's Changed

• fix: store endMinuteSinceEpoch as part of PayerReport by @fbac in #110

Full Changelog: v0.5.0...v0.5.1

Release v0.5.0

Docker Image

ghcr.io/xmtp/contracts:v0.5.0

What's Changed

• feat: Protocol Fees by @deluca-mike in #97
• feat: Integrate fee token by @deluca-mike in #90
• feat: Parameter keys as strings by @deluca-mike in #98
• feat: decouple factory, parameter registry, and tokens from environment by @deluca-mike in #102
• feat: broadcaster migration and payer report update by @deluca-mike in #105
• feat: upgradeable factory by @deluca-mike in #106
• feat: groupId is bytes16 by @deluca-mike in #107
• feat: cleanup and fixes by @deluca-mike in #108
• feat: deploy testnet-dev and mainnet factory/token by @deluca-mike in #109

Full Changelog: v0.4.4...v0.5.0