v0.3.0

[sscovil]

Major Architecture Redesign

This release introduces a complete rewrite of EVMAuth with modular architecture, dual token standard support, and enterprise-ready features for authorization state management.

Key Features

Dual Token Standard Support

• EVMAuth1155: Full ERC-1155 compliance with batch operations, URI-based metadata, and receiver hooks
• EVMAuth6909: ERC-6909 compliance offering simpler transfers, granular approvals, and on-chain metadata

Core Improvements

Token Management

• Sequential token IDs starting at 1, assigned automatically via createToken(EVMAuthTokenConfig config)
• Unified configuration with updateToken(uint256 id, EVMAuthTokenConfig config)
• Non-transferable tokens option for things like licenses and identity tokens
• Time-to-live (TTL) for automatic token expiration

Payment System

• Multiple payment methods per token:
  • Native currency (ETH, POL, etc.)
  • Multiple ERC-20 tokens with independent pricing
  • Set price to 0 to disable specific payment methods
• Treasury management for collecting purchase revenue
• Reentrancy protection on all purchase functions

Contract Infrastructure

• Upgradeable by default using OpenZeppelin's UUPSUpgradeable pattern
• ERC-7201 namespaced storage for upgrade safety
• Modular base contracts for clean separation of concerns
• Pausable operations for emergency situations

Token Expiration & Cleanup

• Improved expired token cleanup with efficient time-bucket system
• Public pruneBalanceRecords(address account, uint256 id) for manual cleanup
• Automatic pruning during transfers and balance checks
• Bounded balance records to prevent gas issues

Updated Roles

• TOKEN_MANAGER_ROLE: Configure tokens and metadata
• ACCESS_MANAGER_ROLE: Pause/unpause and freeze/unfreeze accounts
• TREASURER_ROLE: Update treasury address
• MINTER_ROLE: Issue tokens programmatically
• BURNER_ROLE: Burn tokens from accounts
• UPGRADE_MANAGER_ROLE: Authorize contract upgrades

Documentation & Testing

• Comprehensive architectural diagrams
• Detailed deployment guides
• Cast command cheat sheet
• Significantly improved test coverage
• Auto-generated documentation

Migration Notes

Breaking Changes

• Complete contract redeployment required (not upgradeable from v0.2.x)
• New initialization pattern replaces constructor
• Role names and permissions restructured
• Blacklist functionality replaced with account freezing

---

This discussion was created from the release v0.3.0.