Welcome
Kumbaya is a DEX and social launchpad on MegaETH. This space is for developers, integrators, and partners who want to build on top of Kumbaya - whether that's routing swaps through our pools, embedding the Kumbaya launchpad in your app, or pulling pool data into a dashboard.
What's here
Architecture at a glance, what's open vs. gated, how the pieces fit together
Deployed contract addresses on MegaETH mainnet and testnet
Quoting, swapping, and reading pool state on the V3 fork
Token launches, bonding curves, graduation, fee streaming
The @kumbaya_xyz/* packages on npm
Hosted REST APIs: Exchange (exchange.kumbaya.xyz), Client (clients.kumbaya.xyz), Search (search.kumbaya.xyz)
Integrator kit, ABIs, token list
The Agent Kit (MCP servers + skills), SIWE auth, programmatic launches, registry reads, recipes - for AI agents and bots
Building on Kumbaya in 5 minutes
If you just want to see something working, head straight to SDK Quickstart - you'll get a price quote on MegaETH in about a dozen lines of TypeScript.
Building an agent or bot? The Kumbaya Agent Kit gives an LLM the whole platform as MCP tools with no glue code. For the from-scratch path, see Building Agents → Overview - the SIWE-based onboarding flow, on-chain entry points, and copy-pasteable recipes.
Three things worth knowing up front
Kumbaya's DEX is a Uniswap V3 fork with one meaningful protocol-level change: the contract supports a wider protocol-fee range (up to 50% vs. Uniswap's 25% cap), though the values currently set in production sit within Uniswap's standard range. Pools and positions are otherwise V3-compatible. The pool init code hash is different from upstream Uniswap - see Contract Addresses.
Tokens launched via the Kumbaya launchpad go through a bonding curve before becoming ordinary V3 pools. Until graduation, swaps still go through V3 - they're just routed against tightly-packed seed positions. After graduation, the LP becomes a full-range NFT and trades like any other V3 pool. (The launchpad's smart contracts are prefixed
Fire*-FireLaunch,FireGraduator, etc. - see the launchpad Overview for the naming background.)Refer to Uniswap's V3 docs at https://developers.uniswap.org/docs/protocols/v3/overview for everything we don't re-document here. Do not reference V2 or V4 guides - they don't apply.
Repos and links
fire (private) - Kumbaya launchpad contracts and tests (the
Fire*contract family)integrator-kit - addresses, ABIs, Foundry integration tests
sdks (private) -
@kumbaya_xyz/*packagesv3-core / v3-periphery (private) - Kumbaya's V3 fork
Help
GitHub issues on the relevant repo
Twitter @kumbaya_xyz
Email: support@kumbaya.xyz
Last updated