Kayenfi V3 Core Contracts

This repository contains the core smart contracts for the KayenFi V3 Protocol. For higher level contracts, see the kayenfi-v3-periphery repository.

Deployed Contracts & Configuration

CHILIZ Testnet (Chain ID: 88882)

Contract Addresses

| Contract | Address | Transaction Hash | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | KayenfiV3Factory | 0xcF82734905f611258926ef5617d0b87640cC99F9 | 0xb30a4484cc52e6509eec8ba3a3051433af21fdea7b56a63b8d6990be77de0afa |

Deployment Date: 2026-01-05
Block Number: 31322895

Admin Variables

| Variable | Contract | Address | Description | | --------- | ---------------- | -------------------------------------------- | ------------------------------------------------------- | | owner | KayenfiV3Factory | 0x6954a3aA9343aeA582D40331BcD52c38e95a3283 | Admin address that can set owner and enable fee amounts |

Chain Configuration

| Variable | Address | Description | | --------- | -------------------------------------------- | ------------------- | | WETH9 | 0x678c34581db0a7808d0aC669d7025f1408C9a3C6 | Wrapped ETH address |

Fee Amounts

The factory comes with three fee tiers enabled by default:

| Fee (in basis points) | Tick Spacing | | --------------------- | ------------ | | 500 (0.05%) | 10 | | 3000 (0.3%) | 60 | | 10000 (1%) | 200 |

CHILIZ Mainnet

Contract Addresses

| Contract | Address | | -------------------- | ------- | | KayenfiV3Factory | TBD |

Admin Variables

| Variable | Contract | Address | Description | | --------- | ---------------- | ------- | ------------------------------------------------------- | | owner | KayenfiV3Factory | TBD | Admin address that can set owner and enable fee amounts |

Chain Configuration

| Variable | Address | Description | | --------- | ------- | ------------------- | | WETH9 | TBD | Wrapped ETH address |

Deploy

Secrets Setup

Create a secrets.json file in the package root directory with the following structure:

{
  "privateKey": "your_private_key_with_0x_prefix"
}

Note: The secrets.json file is already in .gitignore and will not be committed to the repository.

Deployment Scripts

# Deploy Factory
yarn deploy:spicy

Using Solidity Interfaces

The KayenFi v3 interfaces are available for import into solidity smart contracts via the npm artifact @kayenfi/v3-core, e.g.:

import '@kayenfi/v3-core/contracts/interfaces/IKayenfiV3Pool.sol';

contract MyContract {
  IKayenfiV3Pool pool;

  function doSomethingWithPool() {
    // pool.swap(...);
  }
}

Local Deployment

In order to deploy this code to a local testnet, you should install the npm package @kayenfi/v3-core and import the factory bytecode located at @kayenfi/v3-core/artifacts/contracts/KayenfiV3Factory.sol/KayenfiV3Factory.json. For example:

import {
  abi as FACTORY_ABI,
  bytecode as FACTORY_BYTECODE,
} from '@kayenfi/v3-core/artifacts/contracts/KayenfiV3Factory.sol/KayenfiV3Factory.json'

// deploy the bytecode

This will ensure that you are testing against the same bytecode that is deployed to mainnet and public testnets, and all KayenFi code will correctly interoperate with your local deployment.

Licensing

The primary license for Kayenfi V3 Core is the Business Source License 1.1 (BUSL-1.1), see LICENSE. However, some files are dual licensed under GPL-2.0-or-later:

• All files in contracts/interfaces/ may also be licensed under GPL-2.0-or-later (as indicated in their SPDX headers), see contracts/interfaces/LICENSE
• Several files in contracts/libraries/ may also be licensed under GPL-2.0-or-later (as indicated in their SPDX headers), see contracts/libraries/LICENSE

Other Exceptions

• contracts/libraries/FullMath.sol is licensed under MIT (as indicated in its SPDX header), see contracts/libraries/LICENSE_MIT
• All files in contracts/test remain unlicensed (as indicated in their SPDX headers).