mcpField
E
endaoment

endaoment

github.com/bankrbotOther1.2k201 installsUpdated 5d ago
Repository

About endaoment

Endaoment Charity Donations is a skill for donating USDC to 501(c)(3) nonprofits through Endaoment contracts on Base. It includes charity search by name or EIN and scripts that use Bankr to approve funds and execute donations.

Key features

  1. 01Search charities by name or EIN
  2. 02Donate USDC on Base
  3. 03Approve USDC for donations
  4. 04Deploy charity entity contracts when needed
  5. 05Reference popular charities and EINs

Use cases

  1. 01Finding a nonprofit by EIN
  2. 02Making a USDC donation to a charity
  3. 03Donating to a listed popular nonprofit

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bankrbot/skills --skill endaoment

After installing, type/endaomentin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

catalog.json
references/
popular-charities.md
scripts/
donate.sh
search.sh

Details

From the project README

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

CharityEIN
GiveDirectly27-1661997
North Shore Animal League America11-1666852
American Red Cross53-0196605
Doctors Without Borders13-3433452
ASPCA13-1623829

See references/popular-charities.md for more.

Contract Addresses (Base)

ContractAddress
Registry0x237b53bcfbd3a114b549dfec96a9856808f45c94
OrgFundFactory0x10fd9348136dcea154f752fe0b6db45fc298a589
USDC0x833589fcd6edb6e08f4c7c32d4f71b54bda02913

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

Comments

Markdown supported