BeanPool Icon BeanPool
How It Works The Rules Features Get Started

Getting Started with BeanPool

BeanPool is an invite-only community network where everyone starts at zero. Here is a step-by-step guide to accepting an invitation, securing your decentralized identity, and unlocking your starting credit line to trade.

Key Concept: BeanPool is entirely peer-to-peer. There are no corporate banks or middlemen. You control your own data and build reputation by trading directly with your neighbors.

1.Get an Invite Code

Because BeanPool is built on a web of trust, you cannot sign up without an invitation. You must receive an invite code from an active member of your local community.

  • Invite codes are usually shared as a text link (e.g. bean-xxxx-xxxx) or via a QR code you can scan.
  • If you do not know anyone in the network, visit local community markets, workshops, or connect with organizers running a local node.

2.Access the App

Each local community runs its own independent server (node). You can access the app across any platform:

  • Native iOS & Android Apps: Download BeanPool directly from the Apple App Store or Google Play Store for the best performance, instant notifications, and hardware passkey protection.
  • Web App (PWA): Open your community's unique node address in any mobile or desktop browser and tap "Add to Home Screen" for instant offline-capable access.

3.Create Your Secure Identity

Launch the app, select "I have an invite code", and paste your code. Then, choose your custody preference:

  • Choose a Public Callsign: This is your display name (e.g., @BakerBob) seen across the ledger and marketplace.
  • Dual-Custody Key Setup:
    • Hardware Passkeys / Seed Phrase: Private keys remain encrypted in your device's SecureStore with an offline recovery seed.
    • Encrypted SSO Cloud Backup: 1-click encrypted backup via Apple ID or Google OAuth to effortlessly restore your account on new devices.
    • Social Guardian Recovery: Appoint trusted community vouchers/friends to hold encrypted recovery shards in case your device is ever lost.

4.Post Your First Offer (Unlocks Your Credit)

To keep the economy balanced and reciprocal, BeanPool uses the **Offer Covenant** (see Rules §4). New accounts start with a credit line of zero, meaning they can only spend beans they already hold.

  • To open your credit line, go to the marketplace and post at least one Offer (e.g., general labor, fresh produce, baking, tutoring, or tools for loan).
  • Listing your first active offer automatically unlocks a credit floor of −200 Beans (≈ 5 hours of community time).
  • This credit line allows you to immediately accept offers or post Needs to hire others, even though you start with 0 Beans!

5.Make Your First Trade

Now that your credit line is open, you can begin participating in your local economy:

  • Browse and Connect: Check out the Marketplace or view the interactive **Community Map** to find offers in your neighborhood. Tap "Message" on any post to open an encrypted chat with the author.
  • The Escrow Safe-Guard: When you buy a service or good, the Beans are held safely in **escrow** *(held in trust by the system)*. The seller only receives the Beans after you confirm the job is completed, keeping both parties secure.
  • Build Reputation: Once your trade completes, both you and your partner can rate each other and sign receipts. Completing trades grows your trust score and automatically expands your credit line.
What's Next? As you complete trades with multiple unique partners, your credit line will dynamically deepen (down to −2000 Beans), and you'll advance to Resident, Steward, or Elder status!
BeanPool Icon BeanPool

Decentralized mutual credit & federated community exchange.

GitHub How It Works Getting Started The Rules Child Safety Privacy Policy Terms of Service

Open source under MIT license. Made with love by communities, for communities.