shape: donations panel

[lorenzo-ranciaffi]

Pull Request Description

Notion
Figma

What does this PR change?

This PR introduces the tipping feature: every creator can set a wallet address in the scene's scene.json file.
Users that crosses the scene (either by navmap or from the minimap) are shown a button that opens a modal to send the tip to the creator.

This feature requires two feature flags:

1. alfa-donations to enable the feature itself
2. alfa-recommended-donation-amount which has a main variant that contains an array of decimals (3 values) for the recommended donation amount

Test Instructions

Prerequisites

• launch the client with the args --dclenv zone --debug --donations-ui

Test Steps

1. Go to a scene that has the creator's wallet address set (9,49 and eax.dcl.eth work)
2. You can also select the same scene from the navmap
3. Open the tip panel
4. Verify that that:
   1. the scene name is correctly presented
   2. the creator address is correctly presented (it can be a DCL user, in that case you should see the name and profile pic, only the address otherwise)
   3. you can always copy the beneficiary address to the clipboard
   4. you are presented with multiple tipping choices
   5. your current balance is accurately shown
   6. tipping 0 MANA is not allowed (disabled button + error message)
   7. tipping an amount greater than your current balance is not allowed (disabled button + error message)
   8. the amount in MANA you selected is converted in real-time in USD
5. Pressing Send tip leads you to a new panel that opens the browser
6. After validating the transaction on the browser, you see a new screen:
   1. if the transaction was successful, after clicking OK on the fancy screen your avatar plays the money emote
   2. if the transaction fails, you are prompted to try again or close the panel
7. If the tip receiving address is a valid DCL user, they should get an in-game notification about the tip

Additional Testing Notes

• In order to test the functionality you need to have Amoy MANA on your wallet

Quality Checklist

• Changes have been tested locally
• Documentation has been updated (if required)
• Performance impact has been considered
• For SDK features: Test scene is included

Code Review Reference

Please review our Code Review Standards before submitting.

[github-actions]

Windows and Mac build successful in Unity Cloud! You can find a link to the downloadable artifact below.

Name	Link
Commit	66c6b14
Logs	https://github.com/decentraland/unity-explorer/actions/runs/21251634400
Download Windows	https://github.com/decentraland/unity-explorer/suites/55102845202/artifacts/5220877382
Download Windows S3	https://explorer-artifacts.decentraland.org/@dcl/unity-explorer/branch/shape/donations/pr-17803-66c6b14/Decentraland_windows64.zip
Download Mac	https://github.com/decentraland/unity-explorer/suites/55102845202/artifacts/5221460385
Download Mac S3	https://explorer-artifacts.decentraland.org/@dcl/unity-explorer/branch/shape/donations/pr-17803-66c6b14/Decentraland_macos.zip
Built on	2026-01-22T15:45:54Z

[github-actions]

New build in progress, come back later!

[fcolarich]

Looks great! left some comments, most are just suggestions, but I think the ProfilePicture ones should be addressed so we can phase out the deprecated Setup method and use the new Bind one

[davidejensen]

Nothing to add other than what @fcolarich already spotted, Nice!!!

[balducciv]

A smoke test of this functionality has passed in both Mac and Windows.
Additionally, the new code implemented for the notifications was tested and passed.

Send Tip

Sender

• Sender web flow happy path ✅
• Sender plays money emote ✅

Recipient notification

• email ✅
• Synchronic notification ✅
• Notifications panel ✅

Sender side:

send.tip.-.mac.mp4

Receiver end:

new.tip.received.notification.mp4