Skip to main content
Tulip v1 separates canonical on-chain markets, off-chain inference routing, and read-only market telemetry. No single service sits in every execution path.
Version 1 uses Hugging Face as its model registry and inference endpoint vendor. That adapter is the current data-plane implementation, not a permanent protocol restriction. Future versions may add vendor integrations while preserving existing v1 identities and markets.

System map

On-chain control plane

The contracts establish:
  • Deterministic model identity.
  • One canonical credit and pool per model.
  • Fixed credit supply.
  • Permanently locked launch liquidity.
  • Creator-scheduled native LP-fee changes within protocol bounds and a one-hour activation delay.
  • Permissionless provider offers and delayed tariff versions.
  • Model-bound credit permits and exact offer-bound settlement.
All swap balance changes occur in the canonical Uniswap v4 PoolManager.

Gateway data plane

The Gateway handles actions that contracts cannot perform directly:
  • Private endpoint credentials.
  • Endpoint capability discovery and health checks.
  • Prompt tokenization.
  • Offer selection and pre-output failover.
  • Maximum-charge reservations.
  • OpenAI-compatible request forwarding.
  • Usage metering and EIP-712 receipt signing.
  • Batched receipt submission.
The Gateway cannot move arbitrary wallet funds. Settlement is limited to credits already deposited in a permit and to charges recomputed by the escrow from an effective on-chain tariff.

Indexer telemetry plane

The indexer discovers markets from factory events and follows matching PoolManager swaps. It provides prices, TVL estimates, volume, trades, and OHLCV candles. The indexer does not quote, route, approve, or execute swaps. A stale indexer can make charts unavailable but cannot block the AMM.

Trust boundaries

BoundaryEnforced guaranteesRemaining trust
ContractsIdentity, supply, pool binding, fee bounds, permits, tariff math, receipt replay protection, distributionsGovernance keys and implementation risk; production contracts have not been independently audited
Uniswap v4Pool accounting, swaps, positions, eventsRobinhood Chain and deployed Uniswap contracts
GatewayEndpoint verification, routing, reservation, metering, receipt signingCorrect gateway operation and signer security
ProviderEndpoint availability and model executionCorrect inference and truthful upstream usage
Hugging Face (v1)Endpoint hosting and repository availabilityPlatform availability and provider account configuration
IndexerReorg-aware telemetry derived from eventsDatabase and RPC freshness

Failure behavior

  • A model market may launch and trade before any provider registers; inference remains unavailable until an eligible offer becomes active.
  • A provider outage does not stop credit trading.
  • Indexer downtime does not stop swaps or inference settlement.
  • A Gateway outage stops new routed inference but not credit custody, permit closure, or AMM trading.
  • A paused model blocks eligible inference while its ERC-20 and pool remain on-chain.
  • Locked liquidity has no administrative withdrawal path.