Skip to content

Paisa-AVAX/PaisaAVAX

Repository files navigation

PAISA Logo

PAISA — Donations for Migrants

Paisa is a Web3 mini-application that enables direct donations to vulnerable migrants, without banks or bureaucracy. Built on Sherry SDK, this app allows anyone in the world to contribute AVAX in a simple, transparent, and secure way.

🎥 Demo del Proyecto

Watch the video

🧠 App Model (Architecture Diagram)

You can explore our system model visually in Excalidraw:

🔗 View Application Diagram 🔗 Project Presentation


🧩 Key Features

  • 🔄 Random rotation of the active beneficiary (automatically updates to support different people)
  • 🎯 AVAX donations sent directly to the current beneficiary's wallet
  • 📡 Fully on-chain: beneficiary history, balance, and transactions

🔧 Tech Stack

  • Smart contracts in Solidity
  • Sherry SDK (Dynamic Actions)
  • Next.js 14 + App Router
  • wagmi + viem (for transaction serialization)
  • Supabase (image storage)
  • Blockchain: Avalanche Fuji (testnet)

🚀 Local Setup Instructions

  1. Clone the repository:
git clone https://github.com/Paisa-AVAX/PaisaAVAX.git
cd app/api/mi-app
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser at: http://localhost:3000/api/my-app

🔁 Sherry Integration

This app can be integrated directly at: https://app.sherry.social/home

📥 Form Metadata (GET endpoint):

  • Retrieves the current beneficiary's data from the smart contract.
  • Displays their story, image, and wallet.
  • Generates two dynamic actions:
    • Donate a specific amount of AVAX
    • Randomly change the current beneficiary

🔁 Dynamic Action /api/mi-app/refresh:

// Randomly change the currently active beneficiary
// Returns the serialized transaction to be executed onchain

🎯 Dynamic Action /api/mi-app:

// Accepts 'amount' via query or body
// Returns the serialized transaction to donate to the current beneficiary

📸 App Preview

🧑‍🎓 Current Beneficiary

avatar

🧾 Story

He fled Honduras after losing his carpentry shop to gang extortion. His eldest son was murdered, and now he dreams of rebuilding a safe life for his family.


🧠 Smart Contract Deployment

https://testnet.snowtrace.io/address/0x0c19e55972D233B16C090f8b4DB91c28b74A62d3

💬 Contributions

Want to improve or expand this app with support for stablecoins, Lens integration, or card payments? PRs and new ideas are welcome!


🤝 Credits

Developed by:

  • vr4ux23
  • Dany Kubs
  • zekibestia
  • Mich
  • Jorge E

Project submitted to the Triggers Not Apps Hackathon by Sherry + Avalanche.


About

Project submitted to the Triggers Not Apps Hackathon by Sherry + Avalanche.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors