v1.0.0

M4: Filecoin Service Liftoff

This major version bump signifies that FilecoinPay v1.0.0 is the long-term stable version intended for production use on Filecoin Mainnet.

Deployed

• Calibration: 0x09a0fDc2723fAd1A7b8e3e00eE5DF73841df55a0
• Mainnet: 0x23b1e018F08BB982348b15a86ee926eEBf7F4DAa

Added

• Performance optimization: Fee apportionment now occurs after settling all segments instead of per segment (#248)
  • Reduces redundant fee calculations
  • Simplifies bookkeeping in settlement operations
  • Applies network fee ceiling once instead of per segment
  • No breaking changes to public interfaces

Changed

• BREAKING: Contract name changed from Payments to FilecoinPayV1 for versioning scheme (#235, #247)
  • File renamed from src/Payments.sol to src/FilecoinPayV1.sol
  • All imports and references updated throughout codebase
  • Migration note: Existing integrations must update contract references to FilecoinPayV1
• Auction starting price updated to 0.0021 FIL (#245)

v0.6.0

Filecoin-Pay M3

Deployed

• Calibration: 0x6dB198201F900c17e86D267d7Df82567FB03df5E
• Mainnet: 0x7DaE6F488651ec5CEE38c9DFbd7d31223eAe1DDE

Added

• Support for ERC-3009 (Transfer with authorization) (#214)
• Support for relayers to submit deposit transactions (#217)
• Network fee charging in settlement operations (#224)
• IERC20 type improvements and label mapping keys (#225)
• Fee auction functionality (#229)
• feat: burn via precompile (#234)
• Pagination support for _getRailsForAddressAndToken (#237)
• feat!: Update auction starting price to 0.5 FIL (#243)

Changed

• Restored settlement permissions allowing any participant to settle rails (#221)

Fixed

• Network fee handling in settleTerminatedRailWithoutValidation (#223)
• Add completed security audit report to readme (#231)

v0.5.0

⚠️ DEPRECATION WARNING: These contracts will be deprecated before October 15, 2025, due to upcoming breaking changes.

DO NOT use these deployments for production applications or to store significant value. For updates and information about when the new set of Filecoin-Pay contracts will be deployed, track progress at: #232

Deployed

• Mainnet: [ADDRESS_TO_BE_UPDATED]
• Calibration: 0x1096025c9D6B29E12E2f04965F6E64d564Ce0750

Added

• Automated ABI publishing on release (#208)

Changed

• Updated alpha mainnet contract address in documentation (#213)
• Improved CI/CD workflow for project board management (#215)
• Settlement operations now accessible by any participant (payer, payee, or operator) (#219, #220)

Fixed

• Network fee handling in settleTerminatedRailWithoutValidation (#223)
• Settlement permission logic corrections (#220)