This page publishes the Solidarity Basket white paper summary: mission, architecture of the on-chain vault, and operational boundaries between the website and the smart contract. It is intended for donors, beneficiary families, integrators, and reviewers.
1. Mission
Solidarity Basket helps families in Gaza publish transparent needs pages and receive crypto donations that are recorded on-chain. The platform aims to minimize custody risk: the website is a coordination layer; the BNB Smart Chain contract is the vault.
2. Architecture overview
A single Solidity contract, SolidarityBasket, holds BNB and USDT balances per beneficiary address. Donors call depositBNB or depositUSDT. Beneficiaries call withdrawBNB or withdrawUSDT. The contract is Ownable and protected with ReentrancyGuard; USDT is an immutable constructor argument.
Deployed address: 0x555400DE5f287bB7E2a7F1C1E26fEa9cDCdB2877.
3. Off-chain vs on-chain responsibilities
Off-chain (website / API): family registration, needs ledger, cart, USD display amounts, routing the user to the correct beneficiary address, indexing events for UX.
On-chain (contract): final transfer of BNB/USDT into the vault, per-beneficiary accounting, beneficiary-initiated withdrawal, public events.
4. Threat model (summary)
Mitigated by design: platform hot-wallet drain of donations (not used for primary path); cross-beneficiary balance theft (separate mappings); oracle manipulation inside the vault (no oracle). Remaining user risks: phishing of approvals, wrong network, wrong contract address — addressed by education and explicit address display.
5. Non-goals
The contract does not provide interest, lending, automated market making, or multi-sig social recovery. Keeping scope narrow is a deliberate security choice.
6. Source and verification
Review the verified contract on BscScan when available, compare function signatures with the public front-end ABI, and test with small amounts before large donations. This white paper page may be updated as the system evolves; the on-chain bytecode at a given address remains the source of truth for balances.