Pallet partner attribution

[zees-dev]

Description

This PR introduces the Partner Attribution pallet which enables partner management and user attribution.
The pallet allows:

• Registration of partners with associated account addresses (EOA's)
• Management of partner accounts (update/remove)
• User attribution to partners
• Partner fee percentage management by privileged accounts
• Fee accumulation tracking for partners

Context & Background

The Partner Attribution pallet is designed to support Futureverse's partner ecosystem by enabling:

• A decentralized way to track and manage partner relationships
• Attribution of user activities to specific partners
• Fee distribution capabilities based on configurable percentages
• Transparent tracking of accumulated partner fees

Key components:

• Partner registration with owner and account management
• User attribution system with update/removal capabilities
• Privileged partner upgrades to set fee percentages
• Storage for partner information and user attributions

Notes & Additional Information

Technical Implementation Details:

• Partners are identified by unique incremental IDs
• Partner info includes owner account, recipient account, fee percentage and accumulated fees
• User attributions are stored in a dedicated mapping
• Integration with Futurepass system for account verification
  • Note: Only futurepasses can be associated to registered partners
• Fee percentages use Permill for precise percentage calculations
• Error handling for invalid operations and unauthorized access

TODOs

• Weight generation

---

Release Notes

Key Changes

Type of Change

• Runtime Changes
• Client Changes

API Changes

Storage Changes

Added

• PartnerAttribution: NextPartnerId - increment-only unique partner id
• PartnerAttribution: Partners - partner registration details
• PartnerAttribution: Attributions - futurepass -> partner attributions

Extrinsic Changes

Added

• PartnerAttribution: register_partner
• PartnerAttribution: update_partner_account
• PartnerAttribution: attribute_account
• PartnerAttribution: upgrade_partner

Event Changes

Added

• PartnerAttribution: PartnerRegistered
• PartnerAttribution: PartnerUpdated
• PartnerAttribution: PartnerRemoved
• PartnerAttribution: PartnerUpgraded
• PartnerAttribution: AccountAttributed

Error Messages

Added

• PartnerAttribution: NoAvailableIds
• PartnerAttribution: PartnerNotFound
• PartnerAttribution: PartnerAlreadyExists
• PartnerAttribution: Unauthorized
• PartnerAttribution: CallerNotFuturepass
• PartnerAttribution: AccountAlreadyAttributed

---

[JasonTulp]

Looking good! Would be useful adding a test for the EnsureFuturepass logic. Need to run benchmarks

[JasonTulp]

Lgtm, nice work 🚀

[surangap]

lgtm👍 Added a minor comment.