Endaoment Charity Donations

Donate to 501(c)(3) nonprofits onchain via Endaoment's smart contracts.

Quick Start

Find a Charity

Search by name or EIN:

./scripts/search.sh "27-1661997"         # EIN lookup (GiveDirectly)
./scripts/search.sh "Red Cross"          # Name search

Donate USDC (Base)

./scripts/donate.sh <ein> <amount_usdc>

Example: Donate $5 USDC to GiveDirectly:

./scripts/donate.sh 27-1661997 5

How It Works

The donate script uses Bankr's arbitrary transaction feature to:

1. Approve USDC to the Endaoment OrgFundFactory
2. Call deployOrgAndDonate(orgId, amount) which:
   • Deploys the charity's entity contract on Base (if not already deployed)
   • Donates the specified USDC amount

Popular Charities

See references/popular-charities.md for more.

Contract Addresses (Base)

Fees

• Org donations: 1.5% fee (e.g., $100 → $1.50 fee, $98.50 to charity)
• Fund donations: 0.05-0.50% tiered

Requirements

• Bankr skill with API key configured
• USDC balance on Base
• ETH on Base for gas (Bankr covers this)

Technical Details

Function Selectors

• approve(address,uint256): 0x095ea7b3
• deployOrgAndDonate(bytes32,uint256): 0xdb9e30cc

OrgId Encoding

The EIN (e.g., "11-1666852") is encoded as bytes32:

"11-1666852" → 0x31312d3136363638353200000000000000000000000000000000000000000000

Notes

• All donations are tax-deductible (US 501(c)(3) orgs)
• Donations are permissionless — anyone can donate
• Uses Bankr arbitrary transactions for contract interaction
• Works on Base; other chains require different addresses