Introduce RoyaltyWorkflows for IP Revenue Claiming

[sebsadface]

Description

This PR introduces the RoyaltyWorkflows contract, which allows IP royalty token holders to claim revenue across multiple revenue tokens and snapshots in a single function call.

Key Functions and Use Cases:

• transferToVaultAndSnapshotAndClaimByTokenBatch:

  • What it does: Transfers royalties from descendant IPs to the ancestor IP’s royalty vault, takes a snapshot, and claims all available revenue for the IP in the latest snapshot.
  • Use Case: For IP royalty token holders who want to claim both their direct revenue and royalties from descendant IPs.

• transferToVaultAndSnapshotAndClaimBySnapshotBatch:

  • What it does: Same as transferToVaultAndSnapshotAndClaimByTokenBatch, but also claims revenue from specific snapshots.
  • Use Case: For IP royalty token holders who want to claim both direct revenue and descendant royalties from the latest snapshot and previously taken snapshots.

• snapshotAndClaimByTokenBatch:

  • What it does: Takes a snapshot of the IP’s royalty vault and claims all available revenue in each revenue token for the IP.
  • Use Case: For IP royalty token holders who want to claim the current revenue in their IP’s royalty vault (which may or may not include descendant royalties).

• snapshotAndClaimBySnapshotBatch:

  • What it does: Same as snapshotAndClaimByTokenBatch, but also includes claims from specific snapshots.
  • Use Case: For IP royalty token holders who want to claim the current revenue in their IP’s royalty vault from the latest snapshot and previously taken snapshots.

Additional Changes:

• Added deployment and upgrade scripts for RoyaltyWorkflows.
• Updated Users.t.sol and MockERC20.sol to support royalty workflow testing.

Test Plan

Added test cases for each new function. Tests simulate a IP graph structure with different policies, licenses, and revenue tokens to test function behaviors. For details, see test/workflows/RoyaltyWorkflows.t.sol.
All new and existing tests pass locally.

Related Issue

Closes #34

[kingster-will]

LGTM.