> For the complete documentation index, see [llms.txt](https://docs.kumbaya.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kumbaya.xyz/developers/readme.md).

# 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

| Section                                                                              | What it covers                                                                                                                                                       |
| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**Overview**](/developers/overview.md)                                              | Architecture at a glance, what's open vs. gated, how the pieces fit together                                                                                         |
| [**Networks & Contracts**](/developers/networks-and-contracts/contract-addresses.md) | Deployed contract addresses on MegaETH mainnet and testnet                                                                                                           |
| [**DEX Integration**](/developers/dex-integration/overview.md)                       | Quoting, swapping, and reading pool state on the V3 fork                                                                                                             |
| [**Launchpad**](/developers/launchpad/overview.md)                                   | Token launches, bonding curves, graduation, fee streaming                                                                                                            |
| [**SDKs**](/developers/sdks/quickstart.md)                                           | The `@kumbaya_xyz/*` packages on npm                                                                                                                                 |
| [**APIs**](/developers/apis/exchange-api.md)                                         | Hosted REST APIs: Exchange (`exchange.kumbaya.xyz`), Client (`clients.kumbaya.xyz`), Search (`search.kumbaya.xyz`)                                                   |
| [**Resources**](/developers/resources/integrator-kit.md)                             | Integrator kit, ABIs, token list                                                                                                                                     |
| [**Building Agents**](/developers/building-agents/overview.md)                       | The [Agent Kit](/developers/building-agents/agent-kit.md) (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**](/developers/sdks/quickstart.md) - you'll get a price quote on MegaETH in about a dozen lines of TypeScript.

**Building an agent or bot?** The [**Kumbaya Agent Kit**](/developers/building-agents/agent-kit.md) gives an LLM the whole platform as MCP tools with no glue code. For the from-scratch path, see [**Building Agents → Overview**](/developers/building-agents/overview.md) - the SIWE-based onboarding flow, on-chain entry points, and copy-pasteable recipes.

## Three things worth knowing up front

1. **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**](/developers/networks-and-contracts/contract-addresses.md).
2. **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**](/developers/launchpad/overview.md) for the naming background.)
3. **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**](https://github.com/Kumbaya-xyz/fire) (private) - Kumbaya launchpad contracts and tests (the `Fire*` contract family)
* [**integrator-kit**](https://github.com/Kumbaya-xyz/integrator-kit) - addresses, ABIs, Foundry integration tests
* [**sdks**](https://github.com/Kumbaya-xyz/sdks) (private) - `@kumbaya_xyz/*` packages
* [**v3-core**](https://github.com/Kumbaya-xyz/v3-core) / [**v3-periphery**](https://github.com/Kumbaya-xyz/v3-periphery) (private) - Kumbaya's V3 fork

## Help

* GitHub issues on the relevant repo
* Twitter [@kumbaya\_xyz](https://twitter.com/kumbaya_xyz)
* Email: <support@kumbaya.xyz>