A decentralized launchpad where the community — not a corporation — validates a cause.
ProofOfHeart empowers everyday people to rally behind the causes they believe in. By leveraging blockchain transparency and community-driven governance, it removes gatekeepers from the fundraising process and puts trust back where it belongs: in the hands of the people.
This repository contains the Soroban smart contract that powers the on-chain logic for campaign management, contributions, fund withdrawal, refunds, and revenue sharing.
Vision — A world where any meaningful cause can receive support without needing permission from a centralized authority.
Mission — To build an open, transparent launchpad that lets communities discover, validate, and fund causes through decentralized consensus — ensuring that every voice counts and every contribution is accounted for on-chain.
- Community First — Causes are validated by the people, not by a corporate board.
- Radical Transparency — Every decision and transaction lives on-chain for anyone to verify.
- Permissionless Participation — Anyone can propose, support, or challenge a cause.
- Trust Through Code — Smart contracts enforce the rules, removing the need for intermediaries.
| Layer | Technology |
|---|---|
| Blockchain | Stellar |
| Smart Contract Platform | Soroban |
| Language | Rust |
| SDK | soroban-sdk 20.1.0 |
- Create Campaign — Launch a new fundraising campaign with a title, description, funding goal, deadline, and category (
Learner,EducationalStartup,Educator,Publisher). - Cancel Campaign — Campaign creators can cancel an active campaign at any time, enabling contributor refunds.
- Admin Verification — Platform admin can mark a campaign as verified via
verify_campaign. - Community Voting Verification — Token holders can vote and verify via
verify_campaign_with_votesbased on quorum and approval threshold.
- Contribute — Anyone can contribute tokens to an active campaign before the deadline.
- Withdraw Funds — Once the funding goal is met, the campaign creator can withdraw raised funds (minus a configurable platform fee, max 10%).
- Claim Refund — Contributors can reclaim their tokens if a campaign is cancelled or fails to reach its goal by the deadline.
- Deposit Revenue —
EducationalStartupcampaigns can opt into revenue sharing; the creator deposits revenue back into the contract. - Claim Revenue — Contributors to a revenue-sharing campaign can claim their proportional share of deposited revenue.
get_campaign— Retrieve campaign details by ID.get_contribution— Check a contributor's amount for a given campaign.get_revenue_pool— View the total revenue pool for a campaign.get_revenue_claimed— Check how much revenue a contributor has already claimed.
- Authorization requirements for every public method:
docs/AUTHORIZATION.md - Campaign lifecycle state machine:
docs/CAMPAIGN_LIFECYCLE.md
- Rust
- Soroban CLI
wasm32-unknown-unknowntarget:rustup target add wasm32-unknown-unknown
# Clone the repository
git clone https://github.com/Iris-IV/ProofOfHeart-stellar.git
cd ProofOfHeart-stellar
# Build the contract
cargo build --target wasm32-unknown-unknown --releasecargo testFor detailed instructions on deploying the contract to Stellar testnet and mainnet, see the Deployment Guide. It covers:
- Soroban CLI setup and configuration
- Testnet deployment with copy-pasteable examples
- Mainnet deployment and cost considerations
- Contract initialization with admin, token, and fee parameters
- Token setup for the platform
- Verification and troubleshooting
ProofOfHeart-stellar/
├── Cargo.toml # Project manifest & dependencies
└── src/
├── lib.rs # Smart contract implementation
└── test.rs # Unit tests
| Repository | Description |
|---|---|
| ProofOfHeart-frontend | Next.js frontend application |
We welcome contributors of all experience levels! For detailed setup instructions, coding standards, and PR guidelines, see CONTRIBUTING.md.
Licensed under the MIT License. See LICENSE for details.