Contracts, roles and addresses

Draft. The Knicks deployment is not yet live, and everything on this page is subject to change before deployment.

Each Knicks market is a set of contracts that ReferenceCurveFactory_v1 creates in one transaction, plus contracts deployed before that transaction or attached after it. The routers for the pair are deployed separately and fix both markets at construction.

Contracts per market

Contract	KNX	NYK	Created by
`ReferenceCurve_v1` (market curve)	Issues KNX against USDG	Issues NYK against KNX	`ReferenceCurveFactory_v1` (`createReferenceCurveWithRecovery`)
`ERC20IssuanceCurveBound_v1` (issuance token)	KNX	NYK	The factory, through `CurveBoundTokenDeployer_v1`
`AUT_Roles_v2` (role authorizer)	Yes	Yes	The factory
`SplitterTreasury_v1` (fee treasury)	Yes	Yes	The factory
`ReserveManager_v1` (reserve manager)	Endowed. Records endowment draws	Records NYK loans as positions	The factory
`CreditFacility_v1` (credit facility)	Yes. No address is granted `borrow`	Yes. Lends KNX against locked NYK	The factory
`ElevationTreasury_v1` (elevation treasury)	Yes	Yes	The factory
`StakingManager_v1` (staking manager)	Yes	Yes	The factory. The production launch route wires no staking strategy
`MarketFreezeGuardian_v1` (freeze guardian)	Yes	Yes	The factory, through `CurveBoundTokenDeployer_v1`
`Presale_v1` and its own `SplitterTreasury_v1`	Yes	Yes. Runs NYK early access	The launch route (`attachPresaleWithTreasury`)
`AdminExecutionCore` (admin execution core)	Yes	Yes	Deployed and configured before the launch route
`EndowmentController_v1` (endowment controller)	Yes	—	Deployed separately. `initialize` binds it to the KNX reserve manager and curve

From configuration to live market describes each creation step and the checks on it. Overview describes each contract’s job.

Roles and holders

Each market has its own AUT_Roles_v2. The roles and holders below are the same on KNX and NYK unless a row says otherwise. Roles at launch lists the functions each role can call.

Role	Held by	In this deployment
`DEFAULT_ADMIN_ROLE`	The market’s `AdminExecutionCore`, as the only holder, sealed	Grants public buying after early access. Calls the credit, splitter and spot tolerance setters
`ECONOMIC_ADMIN`	The market’s `AdminExecutionCore`	Opens the trading switches. Sets the buy and sell fees and the early access settings
`OPERATOR`	The operator address in the market’s launch configuration	Closes the trading switches
`REBALANCER`	The keeper address in the market’s launch configuration	Calls `rebalanceSegments` on the daily schedule
`ELEVATION_KEEPER`	The elevation keeper addresses in the market’s launch configuration	Calls the elevation treasury’s `elevate`
`ELEVATION_MODULE`	The market’s `ElevationTreasury_v1`	Calls the curve’s `elevate`
`PRESALE_MODULE`	The market’s `Presale_v1`	Buys on the curve for early-access purchases
`CREDIT_FACILITY_MODULE`	The market’s `CreditFacility_v1`	Buys on the curve and opens positions on the reserve manager
`STAKING_MODULE`	The market’s `StakingManager_v1`	Opens positions on the reserve manager
`PUBLIC_ROLE`	Every address	`sell`, credit `repay` and the staking entry points from launch. Curve `buy`, credit `buyAndBorrow` and credit `borrow` after `DEFAULT_ADMIN_ROLE` grants them
`ENDOWMENT_ADMIN_ROLE`	KNX only. Its role admin is `DEFAULT_ADMIN_ROLE`	Runs endowment setup and operates the controller: `setBeneficiary`, `arm`, `draw`
`ENDOWMENT_CONTROLLER_ROLE`	KNX only. Its role admin is `ENDOWMENT_ADMIN_ROLE`	The only role that can be granted the endowment draw and `setReferenceSellsClosed`

DEFAULT_ADMIN_ROLE creates ENDOWMENT_ADMIN_ROLE and ENDOWMENT_CONTROLLER_ROLE in one call to bootstrapEndowmentRoles. The call reverts if the roles already exist. The launch route does not call it. Some functions check a fixed address instead of a role. The approval Safe and the emergency Safe hold the freeze and reopen calls, and the protocol Safes hold the governance calls (Authorities outside the authorizer).

Routers for the pair

DeployPeripheryRouters_v1 deploys AtomicSellRouter_v1, AtomicLoopRouter_v1 and AtomicRepayRouter_v1 for one KNX and NYK pair. Each router’s constructor takes three addresses and reads three tokens from them. The router code uses Knicks-specific names for these fixed addresses:

Router name	Address in this deployment	Set by
`knxCurve`	The KNX `ReferenceCurve_v1`	Constructor argument (`KNX_CURVE` in the deploy script)
`knicksCurve`	The NYK `ReferenceCurve_v1`	Constructor argument (`KNICKS_CURVE`)
`facility`	The NYK `CreditFacility_v1`	Constructor argument (`KNICKS_CREDIT_FACILITY`)
`usdc`	USDG, the KNX collateral token	Read from `knxCurve`
`knx`	The KNX issuance token	Read from `knxCurve`
`nyk`	The NYK issuance token	Read from `knicksCurve`

The constructor reverts unless the NYK curve’s collateral token is the KNX token, the facility belongs to the NYK curve, and the three tokens are different contracts. The fixed addresses cannot be changed after construction. maxKnxFallback is a per-call parameter of AtomicLoopRouter_v1 and AtomicRepayRouter_v1 (Edge cases). AtomicBuyRouter_v1 fixes no markets. Each call to AtomicBuyRouter_v1 names the first and second market as arguments. The deploy script checks that each curve and the facility are proxies of their expected beacons. After deployment, the script reverts unless each router’s fixed addresses match the script’s inputs and each router already holds the permissions listed for it on both markets. The script grants no permission. The launch route leaves buyFor, sellTo, buyAndBorrowFor and repayFor ungranted (Permissions the routers need).

Code

Item	File
Market creation	ReferenceCurveFactory_v1.sol#L412-L517
`attachPresaleWithTreasury`	ReferenceCurveFactory_v1.sol#L521-L560
`bootstrapEndowmentRoles`	AUT_Roles_v2.sol#L485-L505
`EndowmentController_v1.initialize`	EndowmentController_v1.sol#L82-L100
Public mint selectors	LaunchPermissionSets_v1.sol#L152-L158
Router fixed addresses	AtomicRouterBase_v1.sol#L36-L47
Router constructor checks	AtomicRouterBase_v1.sol#L56-L84
Router deploy inputs	DeployPeripheryRouters_v1.s.sol#L36-L70
`_deploy`, `_assertRouters`, `_wiring`	DeployPeripheryRouters_v1.s.sol#L106-L179

_{Source: house-markets/contracts at 0ebbc89a (branch integration/v12-post-qa).}

Overview

How it works

Deployments

Reference

Contracts, roles and addresses

Contracts per market

Roles and holders

Routers for the pair

Code