> 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/launchpad/contracts.md).

# Contracts at a glance

| Contract          | File                         | Purpose                                                                                                           | Notable functions                                           |
| ----------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| **FireRegistry**  | `fire/src/FireRegistry.sol`  | Protocol config (fees, defaults, guardian)                                                                        | Admin setters                                               |
| **FireLaunch**    | `fire/src/FireLaunch.sol`    | Token factory + V3 pool initialization                                                                            | `ignite()`, `recordGraduationCondition()`                   |
| **FireToken**     | `fire/src/FireToken.sol`     | ERC-20 with EIP-2612 `permit()` and infinite Permit2 allowance, plus skim hook on buys and linear creator vesting | `releaseVested()`, `vestedAmount()`, `releasableAmount()`   |
| **FireGraduator** | `fire/src/FireGraduator.sol` | Bonding-curve lifecycle and fee collection                                                                        | `createPositions()`, `claimFees()`, `graduate()`            |
| **FuelVault**     | `fire/src/FuelVault.sol`     | Credit system (skim + gifts). Surfaced as the **Tip Jar** in `kumbaya.xyz`; gift calls = user-facing tips         | `deposit()`, `giftWithSig()`, `withdraw()`, `executeBurn()` |
| **FireStream**    | `fire/src/FireStream.sol`    | Fee distribution from graduated NFT                                                                               | `receiveNFT()`, `claimFees()`                               |

For deployed addresses, see [**Contract Addresses**](/developers/networks-and-contracts/contract-addresses.md).

> 🛡 **Audit:** All six contracts - including `FireToken` - are covered by the BlockSec audit. No critical or high findings remain open. See [**Audit & security**](/developers/audit-and-security.md) for the full report and Uniswap V3 audit lineage.

For per-contract function/error reference, read the source directly at [github.com/Kumbaya-xyz/fire/tree/main/src](https://github.com/Kumbaya-xyz/fire/tree/main/src). The contracts are short and well-named.