Market hours

The core already enforces the action table. Your UI should match it so users do not send a revert. Addresses: Addresses for the factory and each book’s oracle on Books.

Resolve the book's oracle

import { parseAbi } from "viem"
import { addresses } from "./addresses" // Addresses, testnet

const registryAbi = parseAbi([
  "function book(uint16 id) view returns (address collateral, address oracle, uint16 issuerId, uint16 tierId, uint128 borrowCap, bool borrowingEnabled, bool exists)",
])

const bookId = 8
const book = await client.readContract({
  address: addresses.registry,
  abi: registryAbi,
  functionName: "book",
  args: [bookId],
})

Read regime and price

Enum: LIVE=0, DARK=1, HALTED=2, CA_WINDOW=3, SEQ_DOWN=4.

const oracleAbi = parseAbi([
  "function regime() view returns (uint8)",
  "function price() view returns (uint256)",
])

const regime = await client.readContract({
  address: book.oracle,
  abi: oracleAbi,
  functionName: "regime",
})

const canIncreaseRisk = regime === 0
const canLiquidate = regime === 0 || regime === 1

let price: bigint | null = null
try {
  price = await client.readContract({
    address: book.oracle,
    abi: oracleAbi,
    functionName: "price",
  })
} catch {
  price = null // HALTED, CA_WINDOW, SEQ_DOWN, or dark past maxDarkDuration
}

enum Regime { LIVE, DARK, HALTED, CA_WINDOW, SEQ_DOWN }

interface IEquityOracle {
    function regime() external view returns (Regime);
    function price() external view returns (uint256);
}

function borrowEnabled(IEquityOracle oracle) internal view returns (bool) {
    return oracle.regime() == Regime.LIVE;
}

Gate the UI

Match the app copy. Market closed: disable the borrow slider, keep repay and add stock.

Control	Enable when
Borrow, take stock back	`LIVE` and not paused and `borrowingEnabled`
Repay, add stock	always
Show haircut banner	`DARK`
Show price paused	`HALTED`, `CA_WINDOW`, `SEQ_DOWN`, or `price()` revert

What can go wrong

price() reverts with PriceUnavailable(regime) or DarkDurationExceeded. Catch it. Do not retry-spam.
A zero sequencerFeed never yields SEQ_DOWN. Check the oracle immutables before you build a sequencer banner.
Cross-book accounts: each book has its own oracle. Gate per book, then AND for a multi-stock borrow.
borrowingEnabled is independent of regime. Both must be true to borrow.

The core already enforces the action table. Your UI should match it so users do not send a revert. Enum: LIVE=0, DARK=1, HALTED=2, CA_WINDOW=3, SEQ_DOWN=4. Only LIVE should enable borrow and withdraw. Repay and add stock always. Show a haircut banner in DARK. Show price paused when price() reverts. price() reverts with PriceUnavailable(regime) or DarkDurationExceeded. Catch it. Do not retry-spam. A zero sequencerFeed never yields SEQ_DOWN. Check the oracle immutables before you build a sequencer banner. ARCHITECTURE.md lists sequencer as required. The code makes it optional.

Regime table

`regime()`	Value	`price()`	Borrow, withdraw	Liquidate	Repay, add stock
`LIVE`	0	Fresh feed	Yes	Yes	Yes
`DARK`	1	Friday close minus haircut	No	Yes	Yes
`HALTED`	2	Reverts	No	No	Yes
`CA_WINDOW`	3	Reverts	No	No	Yes
`SEQ_DOWN`	4	Reverts	No	No	Yes

Next: Oracle, Market hours for users.

Introduction

Using Stockline

Concepts

Developers

Ecosystem

Resources

What can go wrong

Regime table

​What can go wrong

​Regime table

What can go wrong

Regime table