> 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/resources/integrator-kit.md).

# Integrator Kit

The [**`integrator-kit`**](https://github.com/Kumbaya-xyz/integrator-kit) repo is the operational source of truth for integrators: addresses, ABIs, and Foundry tests that exercise the live deployments on MegaETH.

## What's in it

| Path             | Contents                                                                                                                                                                                                                                                                                 |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `addresses/`     | One JSON file per chain (`megaETH-mainnet.json`, `megaETH-testnet.json`) with all deployed addresses                                                                                                                                                                                     |
| `abis/`          | 13 contract ABIs: ERC-20, V3 Factory & Pool, NonfungiblePositionManager, Permit2, QuoterV2, SwapRouter02, UniversalRouter, TickLens, etc.                                                                                                                                                |
| `scripts/`       | `fetch-abis.ts` (regenerate ABIs from artifacts) and `compare-bytecode.ts` (validate against Uniswap V3)                                                                                                                                                                                 |
| `tests/megaETH/` | Foundry Solidity integration tests that hit the live MegaETH deployments - useful as reference for quoting, swapping, pool address derivation, WETH wrapping                                                                                                                             |
| `audits/`        | Signed audit reports - currently the [BlockSec audit of the Kumbaya launchpad contracts](https://github.com/Kumbaya-xyz/integrator-kit/blob/main/audits/blocksec_Kumbaya-xyz_Fire_v1.0-signed.pdf). See [**Audit & security**](/developers/audit-and-security.md) for the full breakdown |
| `README.md`      | Full integration guide with installation and example commands                                                                                                                                                                                                                            |

## When to reach for it

* **Confirming a contract address** - `addresses/megaETH-mainnet.json` is canonical
* **Pulling an ABI for off-chain encoding** - copy from `abis/`
* **Sanity-checking your integration** - clone the repo, run the Foundry tests, compare against your own behavior
* **Verifying our V3 fork is bytecode-equivalent to upstream** (where it should be) - `compare-bytecode.ts`

## Launchpad addresses

Note: integrator-kit currently holds **DEX addresses only**. The Kumbaya launchpad (`Fire*`) contract addresses are listed in the consolidated table in [**Contract Addresses**](/developers/networks-and-contracts/contract-addresses.md).

> The `fire/addresses/megaETH-mainnet.json` file in the [`fire`](https://github.com/Kumbaya-xyz/fire) repo is an **initial-deployment snapshot** - addresses are still accurate, but other fields like `paused` and `requiredVestingDuration` may have been changed by governance since deploy. For live config values, read the registry on-chain (see [Live registry config](/developers/building-agents/registry-config.md)).