Donation Handler Smart Contract Research

[divine-comedian]

Create a smart contract that would handle all EVM chain donations made to Giveth projects. This would allow us to apply more features on top of the donation flow, automate certain processes and make donation tracking more reliable with less long-term effort.

Each Ethereum chain would need a donation handler deployed to it’s chain and handle EVM based donations made there.

Donors would now interact with a smart contract to send a donation to a project. This feature could be used for the following cases:

• Cart of Donations feature
• Donation API (this could replace it)
• on-chain indexing of donations, increasing reliability and less missed donations
• Trackable on-chain donation activity for grants applications
• Future AI Agent integrations

The purpose of this task is to deliver an integration plan for executing this feature.

Not in Scope:

• handling recurring donations
• non-EVM chains

For future Iterations:

• Users can donate to multiple projects at once in a single token in a single transaction
• Donations can be made outside of Giveth UI using donation handler smart contract functions

Deliverables

• Summary of required smart contract functions
• Contract structure outline
• Required BE infra to engage with smart contract
• necessary endpoints updates to/from FE
• required UI updates
• updates to donation verification
• draft donation service updates
• updates to queries to save donation in DB