Introduction
Overview of the Dumpster protocol, the three-program architecture, and the TypeScript SDK surface.
Introduction
Protocol + SDK docs for Dumpster
Dumpster is a Gorbagana launchpad with a bonding curve, permissionless migration into DumpsterSwap, and a TypeScript SDK for building integration flows against the on-chain programs.
Quick Links
Protocol Overview
Three-program architecture, token lifecycle, and program responsibilities.
Launching a Coin
Required inputs, launch flow, and how creator fees start.
Bonding Curve
How curve pricing moves, what rounding matters, and when trading switches venues.
SDK Installation
Install @dumpster-cash/dumpster-sdk and the client dependencies it expects.
Quick Start
Fetch state, preview a trade, and build your first transaction.
Programs & Addresses
Canonical program IDs and where each program fits in the flow.
System Overview
Program
Dumpster
Launches tokens, runs curve trading, accrues creator fees, and handles migration into DumpsterSwap.
- Creates Token-2022 mints with metadata.
- Handles curve buys, sells, and migration.
- Tracks creator-fee accrual on the curve side.
Program
DumpsterSwap
Constant-product AMM used after migration for swaps, LP deposits, and LP withdrawals.
- Creates pools for migrated tokens.
- Supports swaps, deposits, and withdrawals.
- Tracks LP supply and AMM-side creator fee vaults.
Program
DumpsterFees
Shared fee configuration used by both trading programs.
- Stores market-cap-tiered fee schedules.
- Provides flat fees for non-canonical pools.
- Keeps fee behavior consistent across the curve and the AMM.
Start here if you need to
- understand the launch-to-AMM lifecycle
- build trades, migrations, and fee flows with the SDK
- verify program addresses and fee behavior
- debug integration failures