Skip to main content
Tulip v1’s production contracts run on Robinhood Chain and integrate with the chain’s canonical Uniswap v4 deployment.

​
Core contracts

ContractResponsibility
TulipModelRegistryComputes ModelIDs, deploys canonical credits through the factory, stores model records, and tracks listing status.
TulipModelCreditFixed-supply ERC-20 Permit token bound to one immutable ModelID.
TulipV4MarketFactoryAtomically creates the model, token, pool, one-sided position, and locker registration.
TulipDynamicFeeHookReturns the current native v4 LP-fee override before swaps.
TulipV4LiquidityLockerPermanently owns launch LP NFTs and distributes accrued swap fees without changing principal.
TulipProviderOfferRegistryRegisters independent provider offers and stores delayed tariff histories.
TulipInferenceEscrowCustodies permit credits, verifies Gateway receipts, recomputes charges, and distributes settlement.

​
Important functions

​
Market creation and control

  • computeModelId(repository, revision, task) derives the canonical key.
  • commitLaunch(commitment) protects a creator-bound launch before its parameters enter the mempool.
  • launchModelAndMarket(params, launchSalt) consumes the prior-block commitment and performs the complete launch atomically.
  • previewCurve(curveConfigId, creditToken) returns token ordering, ticks, and starting price.
  • setMarketLpFee(modelId, newFee) schedules a pool-fee change within current bounds.
  • applyMarketLpFee(modelId) applies it after the one-hour safety delay; cancelMarketLpFeeUpdate(modelId) lets the creator cancel it first.
  • collectAndDistributeFees(tokenId, deadline) collects and splits accrued LP fees.

​
Provider offers

  • registerOffer(params) creates an active offer and tariff version 1.
  • proposeTariff(...) creates a delayed pending tariff.
  • activateTariff(offerId) activates it after the delay.
  • setPayout, updateManifest, and setStatus are operator controls.
  • quarantine and clearQuarantine are protocol owner controls.

​
Inference permits

  • openPermit(modelId, pinnedOfferId, amount, expiresAt) deposits credits.
  • topUpPermit(permitId, amount) increases an open permit.
  • requestClosePermit, cancelClosePermit, and closePermit manage delayed refunds.
  • settle and settleBatch verify signed usage receipts and distribute credits.

​
Privileged controls

The protocol owner can:
  • Change the global inference protocol fee.
  • Pause or retire model listings.
  • Add or disable curve presets.
  • Change allowed LP-fee bounds.
  • Quarantine provider offers.
  • Rotate the Gateway signer and protocol treasury.
The owner cannot mint more model credits, withdraw locked LP principal, replace a canonical pool, edit provider tariffs, or settle without a valid Gateway signature.

​
Immutability boundaries

The registry’s market factory can be set only once. The dynamic fee hook’s factory can be set only once. Each ModelID can bind only one pool and position. Each credit supply is established in its constructor.
The production contract suite has not been independently audited. This reference describes contract behavior, not a security certification. Verify transaction targets and emitted events in Blockscout.