Networks
Multichain deployment map
What has to exist on a chain before the app can point at it: our contracts, the external dependencies, and what must be verified per deployment.
What has to exist on each chain before the app can point at it, derived by reading the contracts and deploy scripts.
Deploy targets are already wired in smart-contract/hardhat.config.js:
| network | chainId | compiler | notes |
|---|---|---|---|
abstractMainnet | 2741 | zksolc | zkSync stack |
abstractTestnet | 11124 | zksolc | zkSync stack |
ethereum | 1 | solc | |
sepolia | 11155111 | solc | |
base | 8453 | solc | |
baseTestnet | 84532 | solc | |
bsc | 56 | solc | native BNB |
bscTestnet | 97 | solc | native tBNB |
robinhood | 4663 | solc | |
robinhoodTestnet | 46630 | solc | |
arcTestnet | 5042002 | solc | native currency is USDC, 18 decimals |
1. Deployed per chain (ours)#
Diamond core — Diamond, DiamondCutFacet, DiamondInit, then cut in:
DiamondLoupeFacet, OwnershipFacet, ProtocolFacet, AgentPermissionFacet.
AgentPermissionFacetis what bounds Luca on-chain (per-agent spend budgets and token allowlists that hold even if the frontend is bypassed). It was written but historically never cut in. It must be in the facet list or the agent has no on-chain limits at all.
DEX V3 — KaleidoSwapV3Factory, SwapRouter, NFTDescriptor,
NonfungibleTokenPositionDescriptor, NonfungiblePositionManager, Quoter.
The last four take WETH9 as a constructor argument, so the wrapped native
must exist first.
Stablecoin — kfUSD, kafUSD, YieldTreasury (+ mock USDT/USDe on
testnets).
Staking — KLDVaultV2, StKLD, and the KLD token itself.
Oracle — PythPriceOracle, which takes Pyth's own contract address as a
constructor argument.
Testnet only — Faucet.
2. External per chain (not ours)#
| what | why it is per-chain |
|---|---|
| Wrapped native | WETH on Ethereum, WBNB on BNB, WPOL on Polygon; on Arc it wraps USDC. Not derivable from the native symbol. |
| Pyth contract | Different address on every chain. Note the price feed ids (ETH_USD etc. in constant.sol) are global and do not vary. |
| USDC | Canonical where it exists; a mock on testnets that lack one. |
3. Derived, must be verified per deployment#
POOL_INIT_CODE_HASH — the highest-risk value in the whole deploy.
The V3 periphery derives pool addresses via CREATE2 from this constant instead
of asking the factory, and the swap callback authenticates msg.sender
against the derived address. The hash is a property of the compiled bytecode,
and Kaleido targets two compilers: zksolc for Abstract, solc for every
other chain. Identical source produces different bytecode under each.
A wrong value does not fail at deploy. The factory still creates pools. It breaks at the first swap, against an address holding no code.
Run smart-contract/scripts/verify-pool-init-hash.js per deployment and record
the result in the registry.
4. Post-deploy configuration#
Deployment alone leaves the protocol inert. Required wiring:
setPythOracle(oracle)addCollateralToken(token, priceFeedId)per accepted collateraladdLoanableToken(token, priceFeedId)per loanable assetsetSwapRouter(router)setFeeVault,setBPS,setLiquidityBps- YieldTreasury: grant
YIELD_SOURCE_ROLEto kfUSD, register kfUSD as a yield source, add supported yield assets - kfUSD: set YieldTreasury, enable auto-transfer, configure collaterals
- kafUSD: set YieldTreasury, configure supported assets, cooldown