Skip to main content

Concept Map

Signals v1 can be modeled as a small dependency graph. Each layer fixes a piece of meaning, and later layers assume earlier meaning is already pinned down.

The dependency chain is:

  1. Grid: settlement meaning
  2. Curve: pricing meaning
  3. Execution: depth and fee overlays on top of base pricing
  4. Finality: a day resolves to one tick and positions become claimable

Everything else in v1 is either a consequence of this chain or an explicit trust surface around it.

Shared objects and notation

Most pages reuse the same objects and the same notation:

  • Market grid parameters: bounds [L,U)[L, U), spacing ss, tick count nn
  • Pricing state qq and tick prices pi(q)p_i(q)
  • Depth α\alpha as the scale of price impact
  • Fee policy as an overlay on base cost
  • Settlement timeline: TsetT_\text{set}, Δsettle\Delta_\text{settle}, Δops\Delta_\text{ops}, Δclaim\Delta_\text{claim}
  • Settlement tick τ\tau and the half-open payout rule

The mechanism can be summarized as "grid + curve + daily tick." The grid turns a real-world value into an index. The curve turns trades into a deterministic state transition. The daily lifecycle turns a market day into a finalized tick and a claim window.

For reference, the same symbols appear in the core equations:

tick(x)=clamp ⁣(xLs,0,n1)\text{tick}(x) = \mathrm{clamp}\!\left(\left\lfloor\frac{x - L}{s}\right\rfloor, 0, n-1\right) p(R;q)=iRpi(q)p(R; q) = \sum_{i \in R} p_i(q) baseCost(x;q,R)=C(q+x1R)C(q)\text{baseCost}(x; q, R) = C(q + x \mathbf{1}_R) - C(q)

and the claim rule reads a finalized tick τ\tau against a half-open interval.

A worked example

This section ties the four layers together once, end to end. The goal is not to pick realistic numbers. The goal is to show how the objects compose into one deterministic mechanism.

Assume a market defines bounds [L,U)=[0,100)[L,U)=[0,100) with spacing s=1s=1. Then there are n=(UL)/s=100n=(U-L)/s=100 ticks, with indices 0,1,,990,1,\dots,99.

If a settlement value is x=42.7x=42.7, tick mapping is just "binning":

tick(x)=xLs=42.7=42\text{tick}(x)=\left\lfloor \frac{x-L}{s}\right\rfloor = \lfloor 42.7 \rfloor = 42

Now take a range R=[40,50)R=[40,50), which is ticks 4040 through 4949 under the half-open convention. Range pricing reads from the curve state. At a given state qq, the range price mass is:

p(R;q)=i=4049pi(q)p(R;q) = \sum_{i=40}^{49} p_i(q)

If a trader buys quantity xposx_\text{pos} on that range, the fee-free base cost is a state transition on the curve:

baseCost=C ⁣(q+xpos1R)C(q)\text{baseCost} = C\!\left(q + x_\text{pos}\mathbf{1}_R\right) - C(q)

Execution is "base cost plus overlay." A fee policy produces an explicit fee amount, and the trade settles as:

effectiveCost=baseCost+fee\text{effectiveCost} = \text{baseCost} + \text{fee}

Finally, finality locks the day into one tick. After oracle sampling and the post-settlement decision window, the market is finalized with a settlement tick τ\tau. Claims do not need a counterparty. A claim reads only the position range [,u)[\ell,u), the size, and the tick τ\tau. The half-open rule decides whether τ[,u)\tau\in[\ell,u) and pays deterministically.

This worked example is intentionally repetitive: every page in the docs is either defining one of the objects above or explaining what happens when the objects are composed.

Grid meaning

The grid defines settlement meaning. A market does not settle on a floating-point value; it settles on a tick index. Bounds LL and UU and spacing ss define a finite set of tick buckets. The tick mapping rule fixes three edge cases up front:

  • boundary semantics: half-open ranges remove overlap at tick edges
  • out-of-range behavior: values below LL clamp into the first tick; values at or above UU clamp into the last tick
  • resolution: spacing sets the finest settlement granularity the market can express

The grid turns a continuous question into a finite state space. The protocol can then write a deterministic payout rule in terms of tick membership.

Reference: Market Design.

Curve meaning

The CLMSR curve defines pricing meaning. One global pricing state qq induces a normalized tick price vector pi(q)p_i(q). A contiguous range is priced as a sum of tick prices, and a range trade is a structured update to the same global state.

Two properties follow mechanically:

  • all ranges share the same liquidity because they read from the same qq
  • fee-free cost depends only on the start state and end state, not trade order

In particular, a sequence of fee-free trades that moves the state through q0q1qkq_0 \to q_1 \to \dots \to q_k has total cashflow C(qk)C(q0)C(q_k)-C(q_0). This is the mathematical core of path independence in CLMSR.

Reference: CLMSR Pricing Curve.

Execution meaning

Execution in v1 is the combination of a state-defined base cost and an explicit fee overlay.

Depth α\alpha scales price impact. Higher depth compresses slippage for a given state update; lower depth makes the curve more sensitive. In the current release, depth is fixed per market at creation, but it can differ across markets.

Fees are applied after base pricing. This produces two stable quantities for any trade:

  • base cost or proceeds from CLMSR
  • effective cost or proceeds after the fee overlay

This decomposition makes execution analysis well-posed: slippage is mechanical movement on the curve, while fees are an explicit overlay.

References: Liquidity Depth and Slippage, Fees and Effective Price.

Finality meaning

Finality defines when settlement meaning is locked. Each market day is anchored at a settlement timestamp TsetT_\text{set} and three timeline windows:

  • SettlementOpen sample window: Δsettle\Delta_\text{settle}
  • decision window: Δops\Delta_\text{ops}
  • claim delay: Δclaim=Δsettle+Δops\Delta_\text{claim}=\Delta_\text{settle}+\Delta_\text{ops}

Oracle settlement uses a signed pull model. Anyone can submit signed samples during the sample window. A deterministic closest-to-TsetT_\text{set} rule selects a single candidate sample, with a tie-breaker to the past. Finalization is a permissioned state transition that fixes one settlement tick for the day.

Claims read only the finalized tick τ\tau and the half-open payout rule. If a market is not finalized, claims remain closed.

References: Oracle and Settlement, Market Lifecycle, Positions and Payouts.

Accounting coupling

Maker-side accounting is discrete in v1. Trading moves the curve continuously during the day, but maker-side results are realized once per day at the batch boundary after settlement. This couples three objects to the same day key:

  • a finalized settlement tick
  • a payout reserve escrow for claimable positions
  • a maker-side accounting update that realizes net results and fees

References: LP Vault and Daily Batches, Capital Stack and Fee Waterfall.

Trust surfaces

Signals v1 is transparent but not fully trustless. The mechanism surfaces are deterministic given explicit assumptions, but two assumptions remain external:

  • oracle truth: signatures and timing rules can be checked, but data truth is external
  • governance authority: upgrades and permissioned lifecycle actions are a trust surface in v1

References: Trust & Safety Overview, Governance and Trust Model, Failure Modes and Fallbacks, Threat Model, Known Limitations.

Where the definitions live

Signals uses the same idea from two angles: an English-level statement of what the mechanism does, and a formal definition of how the state transition is computed. When reading the docs, treat the following pages as definition sites.

ConceptDefinition siteWhat is being fixed
Grid and tick meaningMarket Designtick mapping, spacing alignment, half-open range semantics
Curve and base pricingCLMSR Pricing CurveC(q)C(q), pi(q)p_i(q), range trades as qq+x1Rq\to q+x\mathbf{1}_R
Depth and slippageLiquidity Depth and Slippagehow α\alpha scales price impact, small-trade approximations
Fees and effective priceFees and Effective Pricefee overlay definition and how it composes with base pricing
Finality and timingMarket Lifecycleday phases, time gates, claim delay, state machine
Oracle candidate ruleOracle and Settlementadmissible samples, deterministic candidate selection, tick finalization
Payout semanticsPositions and Payoutshalf-open payout rule as a function of settlement tick

Most other pages should be read as implications and composition. They are useful, but they are not where meaning is first defined.

For notation and exact definitions used across pages, see Glossary and Units and Rounding. The full formal specification lives in the Whitepaper.