---
title: quoteNextRaise
description: Read on-chain floor eligibility, the deterministic maximum-safe plan, and a typed ADR-004 witness.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Reads `FloorPolicyController.quoteNextFloorRaise` at a pinned block. The controller, not the SDK, chooses the plan. Use this before [raiseIfEligible](/developers/raise-if-eligible).

`quoteNextRaiseMany` is the same read over many markets in one multicall. That is the keeper discovery path.

## Import

```ts
import { createSv3Client } from "@repo/contract-client";
```

## Usage

```ts
const quote = await sv3.floor.quoteNextRaise(market);

quote.eligibility.eligible;
quote.eligibility.cooldownSeconds;
quote.plan.mode;
quote.plan.newFloorPriceWad;
quote.witness.expectedPlanHash;
quote.witness.deadline;
```

Many markets:

```ts
const quotes = await sv3.floor.quoteNextRaiseMany(markets);
const eligible = quotes.filter((q) => q.eligibility.eligible && q.plan.mode !== "None");
```

Factory-wide discovery uses `sv3.factory.getNextMarketSequence` and `sv3.factory.predictMarketAddresses`.

Related reads: [getQuoteState](/developers/get-quote-state) for the market snapshot. Policy bands: `sv3.floor.getPolicy(market)` and `sv3.floor.getEligibility(market)`.

## Return Value

`Promise<MarketFloorQuote>`

| Field                    | Meaning                                                                    |
| ------------------------ | -------------------------------------------------------------------------- |
| `market`                 | FloorMarket that was quoted                                                |
| `eligibility.eligible`   | Controller says a raise may execute now                                    |
| `eligibility.reason`     | Bytes32 reason when not eligible                                           |
| `eligibility.eligibleAt` | `lastRaise + cooldown`                                                     |
| `plan.mode`              | `None`, `PreserveArea`, `SurplusFunded`, or `Combined`                     |
| `plan.newFloorPriceWad`  | Proposed floor. Never below the current floor if the controller is correct |
| `witness`                | Freshness-bound fields the write path must echo                            |

`priceImpact` is always `null`. A raise is not a trade.

## Parameters

### market

- **Type:** `Address`

The FloorMarket proxy.

```ts
await sv3.floor.quoteNextRaise("0x…");
```

### markets (`quoteNextRaiseMany`)

- **Type:** `readonly Address[]`

Chunked multicall. Failed individual reads are skipped.

## Error

| Error                 | When                                                         |
| --------------------- | ------------------------------------------------------------ |
| `RpcUnavailableError` | `deployment.contracts.floorPolicyControllerProxy` is missing |
| Transport errors      | RPC / multicall failure                                      |

An ineligible market is not an error. `eligibility.eligible` is `false` and `plan.mode` is `None`.

## Tips

- Do not compute a floor target from spot or a TWAP. If you need a different plan than the controller, you are not using SV3's v1 policy.
- Re-quote immediately before signing. Eligibility can go stale between discovery and send.
- Indexer hints are optional. Chain-first factory scans keep liveness if the indexer is down.