@depthhq/maker-sdk 0.1.9 → 0.1.11

package/dist/backstop/backstop.d.ts

@@ -24,6 +24,7 @@ export declare class BackstopHandle {
         snapshot: BackstopSnapshot;
     }>;
     release(): Promise<BackstopRelease>;
+    renew(validForSeconds?: number): Promise<string>;
     close(): Promise<string>;
 }
 export declare class BackstopRelease {

package/dist/bot/bot.d.ts

@@ -21,6 +21,9 @@ export declare class MakerBot {
     private pricing?;
     private hedgeLease?;
     private pricingDirty;
+    private lastCleanup;
+    private lastFills;
+    private inventoryVersion?;
     private constructor();
     static create(options: {
         maker: MakerClient;
@@ -30,11 +33,13 @@ export declare class MakerBot {
     }): Promise<MakerBot>;
     private saveHedge;
     private hedgeTick;
+    private quoteWrite;
     private snapshot;
     private requestId;
     private reconcile;
     private fills;
     private cancel;
+    private replace;
     tick(): Promise<BotSnapshot>;
     stop(): void;
     close(): Promise<void>;

package/dist/bot/store.d.ts

@@ -8,9 +8,16 @@ export type BotState = {
     quote?: string;
     request?: QuoteInput;
     referencePrice?: bigint;
+    quoteWrite?: {
+        quote: string;
+        version: bigint;
+        release: boolean;
+    };
     replacement?: {
         prior: string;
         nonce: bigint;
+        request?: QuoteInput;
+        referencePrice?: bigint;
     };
     fills: Record<string, {
         signature: string;

package/dist/client/client.d.ts

@@ -131,6 +131,14 @@ export declare class MakerClient {
         revoke: (operator: PublicKey) => Promise<string>;
     };
     readonly quote: {
+        cleanup: (options?: {
+            limit?: number;
+            exclude?: string[];
+        }) => Promise<{
+            closed: number;
+            reclaimedLamports: bigint;
+            signature?: string;
+        }>;
         replacement: (prior: PublicKey, clientNonce: bigint) => QuoteReplacement;
         publish: (request: QuoteRequest) => Promise<QuoteHandle>;
         get: (id: PublicKey) => QuoteHandle;

package/dist/client/types.d.ts

@@ -48,6 +48,10 @@ export type QuoteState = {
     capacity: anchor.BN;
     expiry: anchor.BN;
     attachedOrders: number;
+    pendingComputation?: PublicKey;
+    marketRevision: anchor.BN;
+    oracleTimestamp: anchor.BN;
+    oracleReferenceE8: anchor.BN;
     replacementNonce: anchor.BN | null;
 };
 export type MarketState = {
@@ -56,6 +60,7 @@ export type MarketState = {
     settlementMint: PublicKey;
     vault: PublicKey;
     oracleTimestamp: anchor.BN;
+    oraclePriceE8: anchor.BN;
     pendingOrders: number;
     backstopOffer: PublicKey;
     activeQuoteCount: number;
@@ -68,6 +73,7 @@ export type MarketState = {
         maxMarketNotional: anchor.BN;
         maxQuoteLifetimeSeconds: number;
         maxOracleAgeSeconds: number;
+        maxQuoteDeviationBps: number;
         backstopMinCollateral: anchor.BN;
     };
 };

package/dist/index.js

@@ -26395,7 +26395,8 @@ import {
   marketAddress,
   quoteQueueAddress,
   protocolAddress,
-  SOL_USD_MARKET_ID as SOL_USD_MARKET_ID2
+  SOL_USD_MARKET_ID as SOL_USD_MARKET_ID2,
+  quoteBounds as quoteBounds3
 } from "@depthhq/bindings";
 import { DepthView } from "@depthhq/sdk/views";
 import { DepthRecovery } from "@depthhq/sdk/recovery";
@@ -26602,6 +26603,7 @@ import { PublicKey as PublicKey2 } from "@solana/web3.js";
 
 // src/bot/policy.ts
 import { positionPnl } from "@depthhq/sdk";
+import { quoteBounds } from "@depthhq/bindings";
 
 // src/hedge/policy.ts
 function validateHedgePolicy(policy) {
@@ -27068,6 +27070,21 @@ class BackstopHandle {
     });
     return new BackstopRelease(this, signature);
   }
+  async renew(validForSeconds = 86400) {
+    if (!this.client.options.wallet.publicKey.equals(this.client.options.maker))
+      throw new Error("Only the maker owner can renew backstop capacity");
+    if (!Number.isSafeInteger(validForSeconds) || validForSeconds < 1 || validForSeconds > 86400)
+      throw new RangeError("Backstop duration must be from 1 to 86400 seconds");
+    const current = await this.status();
+    const now = Math.floor(Date.now() / 1000);
+    if (current.status !== "active" || current.expiresAt <= now || now + validForSeconds <= current.expiresAt)
+      throw new Error("Renew an active, unexpired offer with a later expiry");
+    return this.client.program.methods.renewBackstop(new anchor2.BN(now + validForSeconds)).accountsPartial({
+      maker: this.client.options.maker,
+      market: this.client.marketAddress,
+      offer: this.id
+    }).rpc({ commitment: "confirmed" });
+  }
   async close() {
     if (!this.client.options.wallet.publicKey.equals(this.client.options.maker))
       throw new Error("Only the maker owner can close its backstop record");
@@ -27270,6 +27287,7 @@ function createCursorStore(genesis, maker, _directory) {
 // src/quote/quote.ts
 import * as anchor4 from "@anchor-lang/core";
 import { DepthError as DepthError2 } from "@depthhq/sdk";
+import { quoteBounds as quoteBounds2 } from "@depthhq/bindings";
 function name(value) {
   return Object.keys(value)[0] ?? "unknown";
 }
@@ -27359,6 +27377,12 @@ class QuoteHandle {
       }
       if (snapshot.status === "validated" || snapshot.status === "waiting") {
         const market = await this.client.read("Market", this.client.marketAddress);
+        const quote = await this.client.quoteState(this.id);
+        const reference = BigInt(quote.oracleReferenceE8.toString());
+        const price = BigInt(market.oraclePriceE8.toString());
+        const drift = price > reference ? price - reference : reference - price;
+        if (!quote.marketRevision.eq(market.revision) || market.oracleTimestamp.lt(quote.oracleTimestamp) || reference <= 0n || drift * 10000n > reference * BigInt(quoteBounds2(market.config.maxQuoteDeviationBps).driftBps) || quote.expiry.toNumber() <= Math.floor(Date.now() / 1000))
+          return this.cancel();
         const queueState = await this.client.read("QuoteQueue", this.client.quoteQueueAddress);
         if (!queueState.market.equals(this.client.marketAddress)) {
           throw new Error("Quote queue belongs to another market");
@@ -27478,11 +27502,16 @@ class QuoteHandle {
     return this.status();
   }
   async close() {
-    if (!this.client.options.wallet.publicKey.equals(this.client.options.maker))
-      throw new Error("Only the maker owner can reclaim quote rent");
     const snapshot = await this.status();
     if (!["cancelled", "filled", "rejected"].includes(snapshot.status) || snapshot.attachedOrders > 0)
       throw new Error("Release the quote and settle its orders before closing");
+    const actor = this.client.options.wallet.publicKey;
+    if (!actor.equals(this.client.options.maker)) {
+      const state = await this.client.quoteState(this.id);
+      if (!state.operator.equals(actor))
+        throw new Error("Only the maker or original payer can reclaim quote rent");
+      return this.client.program.methods.closeOperatorQuote().accountsPartial({ operator: actor, quote: this.id }).rpc({ commitment: "confirmed" });
+    }
     return this.client.program.methods.closeQuote().accountsPartial({ maker: this.client.options.maker, quote: this.id }).rpc({ commitment: "confirmed" });
   }
 }
@@ -27515,13 +27544,16 @@ class QuoteReplacement {
     }
   }
   async status() {
-    const prior = await this.client.quote.get(this.priorId).status();
-    if (prior.replacementNonce !== undefined && prior.replacementNonce !== this.nonce) {
+    const priorAccount = await this.client.options.connection.getAccountInfo(this.priorId, "confirmed");
+    const prior = priorAccount ? await this.client.quote.get(this.priorId).status() : undefined;
+    if (prior?.replacementNonce !== undefined && prior.replacementNonce !== this.nonce) {
       throw new Error("Prior quote is linked to a different successor");
     }
     const account = await this.client.options.connection.getAccountInfo(this.nextId, "confirmed");
     const next = account ? await this.client.quote.get(this.nextId).status() : undefined;
-    const stopped = ["cancelled", "filled"].includes(prior.status);
+    if (!prior && !next)
+      throw new Error("Replacement quotes are unavailable");
+    const stopped = !prior || ["cancelled", "filled", "rejected"].includes(prior.status);
     return {
       prior,
       next,
@@ -27529,7 +27561,21 @@ class QuoteReplacement {
       phase: next?.status === "active" || next?.status === "filled" ? "active" : next?.status === "rejected" ? "failed" : next ? "publishing" : stopped ? "ready" : "stopping"
     };
   }
+  async prepare(input) {
+    if (input.clientNonce !== undefined && input.clientNonce !== this.nonce)
+      throw new Error("Replacement terms use a different client nonce");
+    await this.begin();
+    return this.client.quote.publish({
+      ...input,
+      clientNonce: this.nonce
+    });
+  }
   async begin() {
+    if (!await this.client.options.connection.getAccountInfo(this.priorId, "confirmed")) {
+      if (await this.client.options.connection.getAccountInfo(this.nextId, "confirmed"))
+        return;
+      throw new Error("Replacement quotes are unavailable");
+    }
     const prior = await this.client.quoteState(this.priorId);
     const recorded = prior.replacementNonce == null ? undefined : BigInt(prior.replacementNonce.toString());
     if (recorded !== undefined && recorded !== this.nonce) {
@@ -27553,10 +27599,22 @@ class QuoteReplacement {
       throw new RangeError("Replacement timeout or polling interval is invalid");
     const deadline = Date.now() + timeoutMs;
     const previous = this.client.quote.get(this.priorId);
-    await this.begin();
+    const next = await this.prepare(input);
+    for (;; ) {
+      const snapshot = await next.status();
+      if (["validated", "waiting", "reserving", "active", "filled"].includes(snapshot.status))
+        break;
+      if (["rejected", "cancelled"].includes(snapshot.status))
+        throw new Error("Successor quote was rejected; prior quote remains available");
+      if (Date.now() >= deadline)
+        throw new Error(`Successor quote ${this.nextId.toBase58()} is still validating`);
+      await new Promise((resolve) => setTimeout(resolve, Math.min(pollMs, deadline - Date.now())));
+    }
+    if (!await this.client.options.connection.getAccountInfo(this.priorId, "confirmed"))
+      return next;
     for (;; ) {
       const snapshot = await previous.status();
-      if (["cancelled", "filled"].includes(snapshot.status))
+      if (["cancelled", "filled", "rejected"].includes(snapshot.status))
         break;
       if (["active", "closing"].includes(snapshot.status)) {
         if (snapshot.status === "active" || snapshot.attachedOrders === 0)
@@ -27569,14 +27627,56 @@ class QuoteReplacement {
       }
       await new Promise((resolve) => setTimeout(resolve, Math.min(pollMs, deadline - Date.now())));
     }
-    const request = { ...input, clientNonce: this.nonce };
-    const next = await this.client.quote.publish(request);
     if (!next.id.equals(this.nextId))
       throw new Error("Replacement quote address changed");
     return next;
   }
 }
 
+// src/quote/cleanup.ts
+import { ComputeBudgetProgram, Transaction as Transaction2 } from "@solana/web3.js";
+async function cleanupQuotes(client, options = {}) {
+  const limit = options.limit ?? 12;
+  if (!Number.isSafeInteger(limit) || limit < 1 || limit > 12)
+    throw new RangeError("Cleanup limit must be between 1 and 12");
+  const excluded = new Set(options.exclude);
+  const actor = client.options.wallet.publicKey;
+  const owner = actor.equals(client.options.maker);
+  const transaction = new Transaction2().add(ComputeBudgetProgram.setComputeUnitLimit({ units: 400000 }));
+  let closed = 0;
+  let reclaimedLamports = 0n;
+  let cursor;
+  do {
+    const page = await client.quote.list({ cursor, limit: 100 });
+    for (const item of page.items) {
+      if (excluded.has(item.id.toBase58()))
+        continue;
+      const state = await client.quoteState(item.id);
+      if (!["cancelled", "filled", "rejected"].includes(Object.keys(state.status)[0]) || state.attachedOrders !== 0 || !owner && !state.operator.equals(actor))
+        continue;
+      if (state.replacementNonce != null) {
+        const successor = client.quote.replacement(item.id, BigInt(state.replacementNonce.toString())).nextId;
+        if (!await client.options.connection.getAccountInfo(successor, "confirmed"))
+          continue;
+      }
+      const info = await client.options.connection.getAccountInfo(item.id, "confirmed");
+      if (!info)
+        continue;
+      transaction.add(await (owner ? client.program.methods.closeQuote().accountsPartial({ maker: actor, quote: item.id }) : client.program.methods.closeOperatorQuote().accountsPartial({ operator: actor, quote: item.id })).instruction());
+      reclaimedLamports += BigInt(info.lamports);
+      if (++closed === limit)
+        break;
+    }
+    cursor = closed < limit ? page.nextCursor ?? undefined : undefined;
+  } while (cursor);
+  if (!closed)
+    return { closed, reclaimedLamports };
+  const signature = await client.provider.sendAndConfirm(transaction, [], {
+    commitment: "confirmed"
+  });
+  return { closed, reclaimedLamports, signature };
+}
+
 // src/client/client.ts
 function pda(seeds) {
   return PublicKey7.findProgramAddressSync(seeds, DEPTH_PROGRAM_ID4)[0];
@@ -27595,7 +27695,7 @@ async function retryQuote(action, deadline) {
     try {
       return await action();
     } catch (error) {
-      if (!(error instanceof anchor6.AnchorError) || error.error.errorCode.code !== "WrongMarketAccountStatus" || Date.now() >= deadline)
+      if (!(error instanceof anchor6.AnchorError) || !["WrongMarketAccountStatus", "StaleMarketSnapshot"].includes(error.error.errorCode.code) || Date.now() >= deadline)
         throw error;
       await new Promise((resolve) => setTimeout(resolve, 1000));
     }
@@ -27828,6 +27928,7 @@ class MakerClient {
     }
   };
   quote = {
+    cleanup: (options) => cleanupQuotes(this, options),
     replacement: (prior, clientNonce) => new QuoteReplacement(this, prior, clientNonce),
     publish: async (request) => {
       const clientNonce = request.clientNonce ?? BigInt(new anchor6.BN(randomBytes3(8), "le").toString());
@@ -28122,6 +28223,8 @@ class MakerClient {
   };
   validateQuote(input, market) {
     const now = Math.floor(Date.now() / 1000);
+    const reference = BigInt(market.oraclePriceE8.toString());
+    const { preparationBps } = quoteBounds3(market.config.maxQuoteDeviationBps);
     if (!["draft", "active"].includes(stateName(market.status)))
       throw new Error("Market does not accept quotes");
     if (input.tiers.length === 0 || input.tiers.length > 4) {
@@ -28137,6 +28240,8 @@ class MakerClient {
       if (tier.bidE8 === 0n || tier.askE8 === 0n || tier.bidE8 >= tier.askE8) {
         throw new Error("Quote bid and ask are invalid");
       }
+      if (reference <= 0n || [tier.bidE8, tier.askE8].some((price) => (price > reference ? price - reference : reference - price) * 10000n > reference * BigInt(preparationBps)))
+        throw new Error("Quote prices exceed the preparation deviation limit");
     });
     u642(input.maxCapacity, "maxCapacity");
     if (input.maxCapacity < input.tiers.at(-1).size || input.maxCapacity > BigInt(market.config.maxAccountNotional.toString()) || input.maxCapacity > BigInt(market.config.maxMarketNotional.toString())) {

package/dist/index.node.js

@@ -24906,7 +24906,8 @@ import {
   marketAddress,
   quoteQueueAddress,
   protocolAddress,
-  SOL_USD_MARKET_ID as SOL_USD_MARKET_ID2
+  SOL_USD_MARKET_ID as SOL_USD_MARKET_ID2,
+  quoteBounds as quoteBounds3
 } from "@depthhq/bindings";
 import { DepthView } from "@depthhq/sdk/views";
 import { DepthRecovery } from "@depthhq/sdk/recovery";
@@ -25117,6 +25118,7 @@ import { PublicKey as PublicKey2 } from "@solana/web3.js";
 
 // src/bot/policy.ts
 import { positionPnl } from "@depthhq/sdk";
+import { quoteBounds } from "@depthhq/bindings";
 
 // src/hedge/policy.ts
 function validateHedgePolicy(policy) {
@@ -25585,6 +25587,21 @@ class BackstopHandle {
     });
     return new BackstopRelease(this, signature);
   }
+  async renew(validForSeconds = 86400) {
+    if (!this.client.options.wallet.publicKey.equals(this.client.options.maker))
+      throw new Error("Only the maker owner can renew backstop capacity");
+    if (!Number.isSafeInteger(validForSeconds) || validForSeconds < 1 || validForSeconds > 86400)
+      throw new RangeError("Backstop duration must be from 1 to 86400 seconds");
+    const current = await this.status();
+    const now = Math.floor(Date.now() / 1000);
+    if (current.status !== "active" || current.expiresAt <= now || now + validForSeconds <= current.expiresAt)
+      throw new Error("Renew an active, unexpired offer with a later expiry");
+    return this.client.program.methods.renewBackstop(new anchor2.BN(now + validForSeconds)).accountsPartial({
+      maker: this.client.options.maker,
+      market: this.client.marketAddress,
+      offer: this.id
+    }).rpc({ commitment: "confirmed" });
+  }
   async close() {
     if (!this.client.options.wallet.publicKey.equals(this.client.options.maker))
       throw new Error("Only the maker owner can close its backstop record");
@@ -25789,6 +25806,7 @@ function createCursorStore(genesis, maker, directory) {
 // src/quote/quote.ts
 import * as anchor4 from "@anchor-lang/core";
 import { DepthError as DepthError2 } from "@depthhq/sdk";
+import { quoteBounds as quoteBounds2 } from "@depthhq/bindings";
 function name(value) {
   return Object.keys(value)[0] ?? "unknown";
 }
@@ -25878,6 +25896,12 @@ class QuoteHandle {
       }
       if (snapshot.status === "validated" || snapshot.status === "waiting") {
         const market = await this.client.read("Market", this.client.marketAddress);
+        const quote = await this.client.quoteState(this.id);
+        const reference = BigInt(quote.oracleReferenceE8.toString());
+        const price = BigInt(market.oraclePriceE8.toString());
+        const drift = price > reference ? price - reference : reference - price;
+        if (!quote.marketRevision.eq(market.revision) || market.oracleTimestamp.lt(quote.oracleTimestamp) || reference <= 0n || drift * 10000n > reference * BigInt(quoteBounds2(market.config.maxQuoteDeviationBps).driftBps) || quote.expiry.toNumber() <= Math.floor(Date.now() / 1000))
+          return this.cancel();
         const queueState = await this.client.read("QuoteQueue", this.client.quoteQueueAddress);
         if (!queueState.market.equals(this.client.marketAddress)) {
           throw new Error("Quote queue belongs to another market");
@@ -25997,11 +26021,16 @@ class QuoteHandle {
     return this.status();
   }
   async close() {
-    if (!this.client.options.wallet.publicKey.equals(this.client.options.maker))
-      throw new Error("Only the maker owner can reclaim quote rent");
     const snapshot = await this.status();
     if (!["cancelled", "filled", "rejected"].includes(snapshot.status) || snapshot.attachedOrders > 0)
       throw new Error("Release the quote and settle its orders before closing");
+    const actor = this.client.options.wallet.publicKey;
+    if (!actor.equals(this.client.options.maker)) {
+      const state = await this.client.quoteState(this.id);
+      if (!state.operator.equals(actor))
+        throw new Error("Only the maker or original payer can reclaim quote rent");
+      return this.client.program.methods.closeOperatorQuote().accountsPartial({ operator: actor, quote: this.id }).rpc({ commitment: "confirmed" });
+    }
     return this.client.program.methods.closeQuote().accountsPartial({ maker: this.client.options.maker, quote: this.id }).rpc({ commitment: "confirmed" });
   }
 }
@@ -26036,13 +26065,16 @@ class QuoteReplacement {
     }
   }
   async status() {
-    const prior = await this.client.quote.get(this.priorId).status();
-    if (prior.replacementNonce !== undefined && prior.replacementNonce !== this.nonce) {
+    const priorAccount = await this.client.options.connection.getAccountInfo(this.priorId, "confirmed");
+    const prior = priorAccount ? await this.client.quote.get(this.priorId).status() : undefined;
+    if (prior?.replacementNonce !== undefined && prior.replacementNonce !== this.nonce) {
       throw new Error("Prior quote is linked to a different successor");
     }
     const account = await this.client.options.connection.getAccountInfo(this.nextId, "confirmed");
     const next = account ? await this.client.quote.get(this.nextId).status() : undefined;
-    const stopped = ["cancelled", "filled"].includes(prior.status);
+    if (!prior && !next)
+      throw new Error("Replacement quotes are unavailable");
+    const stopped = !prior || ["cancelled", "filled", "rejected"].includes(prior.status);
     return {
       prior,
       next,
@@ -26050,7 +26082,21 @@ class QuoteReplacement {
       phase: next?.status === "active" || next?.status === "filled" ? "active" : next?.status === "rejected" ? "failed" : next ? "publishing" : stopped ? "ready" : "stopping"
     };
   }
+  async prepare(input) {
+    if (input.clientNonce !== undefined && input.clientNonce !== this.nonce)
+      throw new Error("Replacement terms use a different client nonce");
+    await this.begin();
+    return this.client.quote.publish({
+      ...input,
+      clientNonce: this.nonce
+    });
+  }
   async begin() {
+    if (!await this.client.options.connection.getAccountInfo(this.priorId, "confirmed")) {
+      if (await this.client.options.connection.getAccountInfo(this.nextId, "confirmed"))
+        return;
+      throw new Error("Replacement quotes are unavailable");
+    }
     const prior = await this.client.quoteState(this.priorId);
     const recorded = prior.replacementNonce == null ? undefined : BigInt(prior.replacementNonce.toString());
     if (recorded !== undefined && recorded !== this.nonce) {
@@ -26074,10 +26120,22 @@ class QuoteReplacement {
       throw new RangeError("Replacement timeout or polling interval is invalid");
     const deadline = Date.now() + timeoutMs;
     const previous = this.client.quote.get(this.priorId);
-    await this.begin();
+    const next = await this.prepare(input);
+    for (;; ) {
+      const snapshot = await next.status();
+      if (["validated", "waiting", "reserving", "active", "filled"].includes(snapshot.status))
+        break;
+      if (["rejected", "cancelled"].includes(snapshot.status))
+        throw new Error("Successor quote was rejected; prior quote remains available");
+      if (Date.now() >= deadline)
+        throw new Error(`Successor quote ${this.nextId.toBase58()} is still validating`);
+      await new Promise((resolve) => setTimeout(resolve, Math.min(pollMs, deadline - Date.now())));
+    }
+    if (!await this.client.options.connection.getAccountInfo(this.priorId, "confirmed"))
+      return next;
     for (;; ) {
       const snapshot = await previous.status();
-      if (["cancelled", "filled"].includes(snapshot.status))
+      if (["cancelled", "filled", "rejected"].includes(snapshot.status))
         break;
       if (["active", "closing"].includes(snapshot.status)) {
         if (snapshot.status === "active" || snapshot.attachedOrders === 0)
@@ -26090,14 +26148,56 @@ class QuoteReplacement {
       }
       await new Promise((resolve) => setTimeout(resolve, Math.min(pollMs, deadline - Date.now())));
     }
-    const request = { ...input, clientNonce: this.nonce };
-    const next = await this.client.quote.publish(request);
     if (!next.id.equals(this.nextId))
       throw new Error("Replacement quote address changed");
     return next;
   }
 }
 
+// src/quote/cleanup.ts
+import { ComputeBudgetProgram, Transaction as Transaction2 } from "@solana/web3.js";
+async function cleanupQuotes(client, options = {}) {
+  const limit = options.limit ?? 12;
+  if (!Number.isSafeInteger(limit) || limit < 1 || limit > 12)
+    throw new RangeError("Cleanup limit must be between 1 and 12");
+  const excluded = new Set(options.exclude);
+  const actor = client.options.wallet.publicKey;
+  const owner = actor.equals(client.options.maker);
+  const transaction = new Transaction2().add(ComputeBudgetProgram.setComputeUnitLimit({ units: 400000 }));
+  let closed = 0;
+  let reclaimedLamports = 0n;
+  let cursor;
+  do {
+    const page = await client.quote.list({ cursor, limit: 100 });
+    for (const item of page.items) {
+      if (excluded.has(item.id.toBase58()))
+        continue;
+      const state = await client.quoteState(item.id);
+      if (!["cancelled", "filled", "rejected"].includes(Object.keys(state.status)[0]) || state.attachedOrders !== 0 || !owner && !state.operator.equals(actor))
+        continue;
+      if (state.replacementNonce != null) {
+        const successor = client.quote.replacement(item.id, BigInt(state.replacementNonce.toString())).nextId;
+        if (!await client.options.connection.getAccountInfo(successor, "confirmed"))
+          continue;
+      }
+      const info = await client.options.connection.getAccountInfo(item.id, "confirmed");
+      if (!info)
+        continue;
+      transaction.add(await (owner ? client.program.methods.closeQuote().accountsPartial({ maker: actor, quote: item.id }) : client.program.methods.closeOperatorQuote().accountsPartial({ operator: actor, quote: item.id })).instruction());
+      reclaimedLamports += BigInt(info.lamports);
+      if (++closed === limit)
+        break;
+    }
+    cursor = closed < limit ? page.nextCursor ?? undefined : undefined;
+  } while (cursor);
+  if (!closed)
+    return { closed, reclaimedLamports };
+  const signature = await client.provider.sendAndConfirm(transaction, [], {
+    commitment: "confirmed"
+  });
+  return { closed, reclaimedLamports, signature };
+}
+
 // src/client/client.ts
 function pda(seeds) {
   return PublicKey7.findProgramAddressSync(seeds, DEPTH_PROGRAM_ID4)[0];
@@ -26116,7 +26216,7 @@ async function retryQuote(action, deadline) {
     try {
       return await action();
     } catch (error) {
-      if (!(error instanceof anchor6.AnchorError) || error.error.errorCode.code !== "WrongMarketAccountStatus" || Date.now() >= deadline)
+      if (!(error instanceof anchor6.AnchorError) || !["WrongMarketAccountStatus", "StaleMarketSnapshot"].includes(error.error.errorCode.code) || Date.now() >= deadline)
         throw error;
       await new Promise((resolve) => setTimeout(resolve, 1000));
     }
@@ -26349,6 +26449,7 @@ class MakerClient {
     }
   };
   quote = {
+    cleanup: (options) => cleanupQuotes(this, options),
     replacement: (prior, clientNonce) => new QuoteReplacement(this, prior, clientNonce),
     publish: async (request) => {
       const clientNonce = request.clientNonce ?? BigInt(new anchor6.BN(randomBytes3(8), "le").toString());
@@ -26643,6 +26744,8 @@ class MakerClient {
   };
   validateQuote(input, market) {
     const now = Math.floor(Date.now() / 1000);
+    const reference = BigInt(market.oraclePriceE8.toString());
+    const { preparationBps } = quoteBounds3(market.config.maxQuoteDeviationBps);
     if (!["draft", "active"].includes(stateName(market.status)))
       throw new Error("Market does not accept quotes");
     if (input.tiers.length === 0 || input.tiers.length > 4) {
@@ -26658,6 +26761,8 @@ class MakerClient {
       if (tier.bidE8 === 0n || tier.askE8 === 0n || tier.bidE8 >= tier.askE8) {
         throw new Error("Quote bid and ask are invalid");
       }
+      if (reference <= 0n || [tier.bidE8, tier.askE8].some((price) => (price > reference ? price - reference : reference - price) * 10000n > reference * BigInt(preparationBps)))
+        throw new Error("Quote prices exceed the preparation deviation limit");
     });
     u642(input.maxCapacity, "maxCapacity");
     if (input.maxCapacity < input.tiers.at(-1).size || input.maxCapacity > BigInt(market.config.maxAccountNotional.toString()) || input.maxCapacity > BigInt(market.config.maxMarketNotional.toString())) {

package/dist/node.js

@@ -144,14 +144,23 @@ class BotStore {
       throw new Error("Maker bot checkpoint belongs to another wallet or network");
     if (state.referencePrice !== undefined && (typeof state.referencePrice !== "bigint" || state.referencePrice <= 0n))
       throw new Error("Maker bot checkpoint price is invalid");
-    for (const value of [state.request?.clientNonce, state.replacement?.nonce])
+    for (const value of [
+      state.request?.clientNonce,
+      state.replacement?.nonce,
+      state.replacement?.request?.clientNonce
+    ])
       if (value !== undefined && (typeof value !== "bigint" || value < 0n || value >= 1n << 64n))
         throw new Error("Maker bot checkpoint nonce is invalid");
     for (const value of [state.quote, state.replacement?.prior])
       if (value !== undefined && !/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(value))
         throw new Error("Maker bot checkpoint quote is invalid");
-    if (state.request && (!Number.isSafeInteger(state.request.expiresAt) || typeof state.request.maxCapacity !== "bigint" || state.request.maxCapacity <= 0n || !Array.isArray(state.request.tiers) || !state.request.tiers.length))
-      throw new Error("Maker bot checkpoint request is invalid");
+    if (state.quoteWrite && (!/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(state.quoteWrite.quote) || typeof state.quoteWrite.version !== "bigint" || typeof state.quoteWrite.release !== "boolean" || state.quoteWrite.version < 0n))
+      throw new Error("Quote write checkpoint is invalid");
+    for (const request of [state.request, state.replacement?.request])
+      if (request && (!Number.isSafeInteger(request.expiresAt) || typeof request.maxCapacity !== "bigint" || request.maxCapacity <= 0n || !Array.isArray(request.tiers) || !request.tiers.length))
+        throw new Error("Maker bot checkpoint request is invalid");
+    if (state.replacement?.request && state.replacement.request.clientNonce !== state.replacement.nonce)
+      throw new Error("Replacement checkpoint nonce is invalid");
     for (const fill of Object.values(state.fills))
       if (typeof fill.signature !== "string" || !Number.isSafeInteger(fill.slot) || fill.slot < 0)
         throw new Error("Maker bot checkpoint fill is invalid");
@@ -197,6 +206,7 @@ class BotStore {
 
 // src/bot/policy.ts
 import { positionPnl } from "@depthhq/sdk";
+import { quoteBounds } from "@depthhq/bindings";
 
 // src/hedge/policy.ts
 function validateHedgePolicy(policy) {
@@ -312,7 +322,8 @@ function botQuote(policy, market, position, nonce, now, pricing) {
   if (!tiers.length)
     return;
   const half = Math.ceil(policy.spreadBps / 2);
-  if (half > market.config.maxQuoteDeviationBps)
+  const preparation = quoteBounds(market.config.maxQuoteDeviationBps).preparationBps;
+  if (half > preparation)
     throw new Error("Maker spread exceeds oracle deviation policy");
   if (pricing)
     validateBook(pricing.book, now * 1000, pricing.maxPriceAgeMs);
@@ -333,7 +344,7 @@ function botQuote(policy, market, position, nonce, now, pricing) {
     const buy = pricing ? executionPrice(pricing.book.asks, units) : price;
     const bidE8 = sell * (10000n - bidCosts) / 10000n + skew;
     const askE8 = (buy * (10000n + askCosts) + 9999n) / 10000n + skew;
-    const bound = price * BigInt(market.config.maxQuoteDeviationBps);
+    const bound = price * BigInt(preparation);
     if (bidE8 < 100000000n || bidE8 >= askE8 || abs(bidE8 - price) * 10000n > bound || abs(askE8 - price) * 10000n > bound)
       throw new Error("Executable maker prices exceed oracle deviation bounds");
     return { size, bidE8, askE8 };
@@ -364,6 +375,9 @@ class MakerBot {
   pricing;
   hedgeLease;
   pricingDirty = false;
+  lastCleanup = 0;
+  lastFills = 0;
+  inventoryVersion;
   constructor(maker, policy, store, hedge) {
     this.maker = maker;
     this.policy = policy;
@@ -426,18 +440,50 @@ class MakerBot {
       return;
     const account = await this.maker.read("MarketAccount", this.maker.marketAccount(), "finalized");
     const confirmed = await this.maker.read("MarketAccount", this.maker.marketAccount());
+    const write = this.state.quoteWrite;
+    if (!this.state.hedge?.pending && (("reserving" in confirmed.status) || ("releasing" in confirmed.status))) {
+      const ids = [
+        this.state.quote,
+        write?.quote,
+        this.state.replacement ? this.maker.quote.replacement(new PublicKey(this.state.replacement.prior), this.state.replacement.nonce).nextId.toBase58() : undefined
+      ];
+      for (const id of new Set(ids.filter((id2) => Boolean(id2)))) {
+        const quote = await this.maker.quoteState(new PublicKey(id));
+        if ((("reserving" in quote.status) || ("releasing" in quote.status)) && quote.pendingComputation?.equals(confirmed.pendingComputation ?? PublicKey.default))
+          return "updating quote margin";
+      }
+    }
     let ready = "ready" in account.status && "ready" in confirmed.status && account.version.toString() === confirmed.version.toString();
-    if (ready && (!this.position || this.position.version !== BigInt(account.version.toString()) || this.dirty)) {
-      const prior = this.position?.version;
+    const currentVersion = BigInt(confirmed.version.toString());
+    const candidate = write && this.position && "ready" in confirmed.status && currentVersion === write.version + 1n && (this.inventoryVersion ?? this.position.version) >= write.version && (this.inventoryVersion ?? this.position.version) <= currentVersion;
+    const completedWrite = candidate && (await this.maker.quoteState(new PublicKey(write.quote))).status;
+    const ownCommit = completedWrite && (write.release ? "cancelled" in completedWrite || "filled" in completedWrite : ("active" in completedWrite));
+    if (ownCommit) {
+      this.inventoryVersion = currentVersion;
+      ready = true;
+      if (account.version.toString() === confirmed.version.toString()) {
+        this.state.quoteWrite = undefined;
+        await this.store.save(this.state);
+      }
+    }
+    if (ready && (!this.position || (this.inventoryVersion ?? this.position.version) !== currentVersion)) {
+      const prior = this.position;
       this.position = await this.maker.position.summary({ timeoutMs: 180000 });
       const fresh = await this.maker.read("MarketAccount", this.maker.marketAccount(), "finalized");
       const latest = await this.maker.read("MarketAccount", this.maker.marketAccount());
       ready = "ready" in fresh.status && "ready" in latest.status && fresh.version.toString() === latest.version.toString() && this.position.status === "ready" && this.position.version === BigInt(fresh.version.toString());
       if (ready) {
-        this.pricingDirty ||= prior !== this.position.version || this.dirty;
+        this.inventoryVersion = this.position.version;
+        if (write && this.position.version >= write.version) {
+          this.state.quoteWrite = undefined;
+          await this.store.save(this.state);
+        }
+        this.pricingDirty ||= prior !== undefined && (prior.position !== this.position.position || prior.collateral !== this.position.collateral);
         this.dirty = false;
       }
     }
+    if (ready)
+      this.dirty = false;
     const snapshot = await this.hedge.tick(this.state.hedge, () => this.saveHedge(), ready ? this.position?.position : undefined);
     if (snapshot.phase === "pending" || snapshot.phase === "blocked") {
       await this.cancel(true);
@@ -460,6 +506,20 @@ class MakerBot {
       maxPriceAgeMs: this.hedge.policy.maxPriceAgeMs
     };
   }
+  async quoteWrite(handle, release = false) {
+    const before = await this.maker.read("MarketAccount", this.maker.marketAccount());
+    const version = BigInt(before.version.toString());
+    const result = release ? await handle.cancel() : await handle.activate({ timeoutMs: 0 });
+    if ((release ? handle.releaseSignature : handle.reserveSignature) && "ready" in before.status && version === (this.inventoryVersion ?? this.position?.version)) {
+      this.state.quoteWrite = {
+        quote: handle.id.toBase58(),
+        version,
+        release
+      };
+      await this.store.save(this.state);
+    }
+    return result;
+  }
   snapshot(phase, reason) {
     return {
       phase,
@@ -483,6 +543,31 @@ class MakerBot {
   }
   async reconcile() {
     const state = this.state;
+    if (state.quote && !await this.maker.options.connection.getAccountInfo(new PublicKey(state.quote), "confirmed")) {
+      if (!state.request || state.request.expiresAt + 180 < Math.floor(Date.now() / 1000)) {
+        state.quote = undefined;
+        state.request = undefined;
+        state.referencePrice = undefined;
+        await this.store.save(state);
+      }
+    }
+    if (state.replacement) {
+      const flow = this.maker.quote.replacement(new PublicKey(state.replacement.prior), state.replacement.nonce);
+      const [prior, next] = await Promise.all([
+        this.maker.options.connection.getAccountInfo(new PublicKey(state.replacement.prior), "confirmed"),
+        this.maker.options.connection.getAccountInfo(flow.nextId, "confirmed")
+      ]);
+      if (!prior && next) {
+        state.quote = flow.nextId.toBase58();
+        state.request = state.replacement.request;
+        state.referencePrice = state.replacement.referencePrice;
+        state.replacement = undefined;
+        await this.store.save(state);
+      } else if (!prior && !next && (!state.replacement.request || state.replacement.request.expiresAt + 180 < Math.floor(Date.now() / 1000))) {
+        state.replacement = undefined;
+        await this.store.save(state);
+      }
+    }
     let cursor;
     const managed = [];
     do {
@@ -497,6 +582,7 @@ class MakerBot {
     const allowed = new Set([
       state.quote,
       state.replacement?.prior,
+      state.replacement ? this.maker.quote.replacement(new PublicKey(state.replacement.prior), state.replacement.nonce).nextId.toBase58() : undefined,
       this.requestId()?.toBase58()
     ].filter(Boolean));
     for (const id of managed)
@@ -507,6 +593,8 @@ class MakerBot {
       }
   }
   async fills() {
+    if (Date.now() - this.lastFills < 1e4)
+      return;
     const state = this.state;
     let before;
     let head;
@@ -532,9 +620,28 @@ class MakerBot {
       state.cursor = head;
       await this.store.save(state);
     }
+    this.lastFills = Date.now();
   }
   async cancel(preserve = false) {
     const state = this.state;
+    let successorPending = false;
+    if (state.replacement?.request) {
+      const next = this.maker.quote.replacement(new PublicKey(state.replacement.prior), state.replacement.nonce).nextId;
+      if (await this.maker.options.connection.getAccountInfo(next, "confirmed")) {
+        const handle2 = this.maker.quote.get(next);
+        const snapshot = await handle2.status();
+        if (!terminal.has(snapshot.status)) {
+          const result = [
+            "active",
+            "waiting",
+            "validated",
+            "validating",
+            "closing"
+          ].includes(snapshot.status) ? await this.quoteWrite(handle2, true) : snapshot;
+          successorPending = !terminal.has(result.status);
+        }
+      }
+    }
     if (!state.quote) {
       const request = this.requestId();
       if (request && await this.maker.options.connection.getAccountInfo(request, "confirmed"))
@@ -552,19 +659,75 @@ class MakerBot {
     const handle = this.maker.quote.get(new PublicKey(state.quote));
     const quote = await handle.status();
     if (terminal.has(quote.status)) {
+      if (successorPending)
+        return false;
       state.quote = undefined;
       state.request = undefined;
       state.referencePrice = undefined;
       if (!preserve)
         state.replacement = undefined;
-      this.dirty = true;
       await this.store.save(state);
       return true;
     }
     if (["active", "waiting", "validated", "validating", "closing"].includes(quote.status))
-      await handle.cancel();
+      await this.quoteWrite(handle, true);
     return false;
   }
+  async replace(market, now) {
+    const state = this.state;
+    const replacement = state.replacement;
+    const flow = this.maker.quote.replacement(new PublicKey(replacement.prior), replacement.nonce);
+    if (!replacement.request) {
+      const account = await this.maker.read("MarketAccount", this.maker.marketAccount());
+      if (!("ready" in account.status) || market.pendingOrders)
+        return this.snapshot("pending", "settlement in progress");
+      if (!this.position || this.position.version !== BigInt(account.version.toString())) {
+        this.position = await this.maker.position.summary({
+          timeoutMs: 180000
+        });
+        if (this.position.status !== "ready" || this.position.version !== BigInt(account.version.toString()))
+          return this.snapshot("pending", "maker view changed");
+      }
+      this.inventoryVersion = this.position.version;
+      this.dirty = false;
+      replacement.request = botQuote(this.policy, market, this.position, replacement.nonce, now, this.pricing);
+      if (!replacement.request)
+        return this.snapshot("pending", "inventory or collateral limit");
+      replacement.referencePrice = BigInt(market.oraclePriceE8.toString());
+      await this.store.save(state);
+    }
+    await flow.begin();
+    const exists = await this.maker.options.connection.getAccountInfo(flow.nextId, "confirmed");
+    const next = exists ? this.maker.quote.get(flow.nextId) : await this.maker.quote.publish(replacement.request);
+    const snapshot = await next.status();
+    if (snapshot.status === "validating" && replacement.request.expiresAt > now)
+      return this.snapshot("pending", "validating successor quote");
+    if (["rejected", "cancelled"].includes(snapshot.status) || replacement.request.expiresAt <= now) {
+      await this.cancel();
+      return this.snapshot("pending", "releasing expired successor");
+    }
+    const prior = this.maker.quote.get(new PublicKey(replacement.prior));
+    const previous = await prior.status();
+    const size = this.position.position;
+    const exposure = ((size < 0n ? -size : size) * BigInt(market.oraclePriceE8.toString()) + 99999999999n) / 100000000000n;
+    if (!terminal.has(previous.status) && ["validated", "waiting", "reserving"].includes(snapshot.status) && market.activeQuoteCount < 4 && exposure + previous.maxCapacity + snapshot.maxCapacity <= this.policy.maxInventoryNotional && BigInt(market.quotedNotional.toString()) + snapshot.maxCapacity <= BigInt(market.config.maxMarketNotional.toString())) {
+      await this.quoteWrite(next);
+      return this.snapshot("pending", "activating successor quote");
+    }
+    if (!terminal.has(previous.status)) {
+      if (["active", "waiting", "validated", "validating", "closing"].includes(previous.status))
+        await this.quoteWrite(prior, true);
+      return this.snapshot("pending", "releasing prior quote");
+    }
+    state.quote = flow.nextId.toBase58();
+    state.request = replacement.request;
+    state.referencePrice = replacement.referencePrice;
+    state.replacement = undefined;
+    this.pricingDirty = false;
+    await this.store.save(state);
+    await this.quoteWrite(next);
+    return this.snapshot("pending", "activating successor quote");
+  }
   async tick() {
     if (this.busy)
       throw new Error("Maker bot tick is already running");
@@ -573,6 +736,18 @@ class MakerBot {
     this.busy = true;
     try {
       const state = this.state;
+      if (Date.now() - this.lastCleanup >= 60000) {
+        await this.maker.quote.cleanup({
+          exclude: [
+            state.quoteWrite?.quote,
+            state.quote,
+            state.replacement?.prior,
+            this.requestId()?.toBase58(),
+            state.replacement ? this.maker.quote.replacement(new PublicKey(state.replacement.prior), state.replacement.nonce).nextId.toBase58() : undefined
+          ].filter((id) => Boolean(id))
+        });
+        this.lastCleanup = Date.now();
+      }
       let [market, lamports] = await Promise.all([
         this.maker.read("Market", this.maker.marketAddress),
         this.maker.options.connection.getBalance(this.maker.options.wallet.publicKey, "confirmed")
@@ -600,6 +775,8 @@ class MakerBot {
           return this.snapshot(stopped ? "stopped" : "pending", changed);
         }
       }
+      if (state.replacement)
+        return this.replace(market, now);
       if (!state.quote && this.requestId() && await this.maker.options.connection.getAccountInfo(this.requestId(), "confirmed")) {
         state.quote = this.requestId().toBase58();
         await this.store.save(state);
@@ -610,20 +787,13 @@ class MakerBot {
         if (terminal.has(quote.status)) {
           state.quote = undefined;
           state.request = undefined;
-          this.dirty = true;
           await this.store.save(state);
-        } else if (state.replacement) {
-          if (!["cancelled", "filled"].includes(quote.status)) {
-            await this.maker.quote.replacement(new PublicKey(state.replacement.prior), state.replacement.nonce).begin();
-            await this.cancel(true);
-            return this.snapshot("pending", "releasing prior quote");
-          }
         } else if (["validating", "validated", "waiting", "reserving"].includes(quote.status)) {
           const current = await this.maker.quoteState(handle2.id);
           if (current.expiry.toNumber() <= now && ["validating", "validated", "waiting"].includes(quote.status))
             await this.cancel();
           else
-            await handle2.activate({ timeoutMs: 0 });
+            await this.quoteWrite(handle2);
           return this.snapshot("pending", "activating quote");
         } else if (["closing", "releasing"].includes(quote.status)) {
           await this.cancel();
@@ -640,7 +810,7 @@ class MakerBot {
           this.pricingDirty = false;
           await this.store.save(state);
           await this.maker.quote.replacement(handle2.id, state.replacement.nonce).begin();
-          await this.cancel(true);
+          await this.replace(market, now);
           return this.snapshot("pending", "repricing quote");
         }
       }
@@ -659,7 +829,7 @@ class MakerBot {
         return this.snapshot("idle", "maker view refreshed");
       }
       if (!state.request) {
-        const request2 = botQuote(this.policy, market, this.position, state.replacement?.nonce ?? nonce(), now, this.pricing);
+        const request2 = botQuote(this.policy, market, this.position, nonce(), now, this.pricing);
         if (!request2)
           return this.snapshot("idle", "inventory or collateral limit");
         state.request = request2;
@@ -673,14 +843,13 @@ class MakerBot {
         await this.store.save(state);
         return this.snapshot("idle", "prepared quote expired");
       }
-      const handle = state.replacement ? await this.maker.quote.replacement(new PublicKey(state.replacement.prior), state.replacement.nonce).resume(request, { timeoutMs: 0 }) : await this.maker.quote.publish(request);
+      const handle = await this.maker.quote.publish(request);
       state.quote = handle.id.toBase58();
       state.replacement = undefined;
       await this.store.save(state);
-      await handle.activate({ timeoutMs: 0 });
+      await this.quoteWrite(handle);
       return this.snapshot("pending", "quote submitted");
     } catch (error) {
-      this.dirty = true;
       try {
         await this.cancel(true);
       } catch (cause) {

package/dist/quote/cleanup.d.ts

@@ -0,0 +1,9 @@
+import type { MakerClient } from "../client/client.js";
+export declare function cleanupQuotes(client: MakerClient, options?: {
+    limit?: number;
+    exclude?: string[];
+}): Promise<{
+    closed: number;
+    reclaimedLamports: bigint;
+    signature?: string;
+}>;

package/dist/quote/replacement.d.ts

@@ -3,7 +3,7 @@ import type { MakerClient } from "../client/client.js";
 import type { QuoteRequest } from "../client/types.js";
 import type { QuoteHandle, QuoteSnapshot } from "./quote.js";
 export type ReplacementSnapshot = {
-    prior: QuoteSnapshot;
+    prior?: QuoteSnapshot;
     next?: QuoteSnapshot;
     nextId: PublicKey;
     phase: "stopping" | "ready" | "publishing" | "active" | "failed";
@@ -15,6 +15,7 @@ export declare class QuoteReplacement {
     readonly nextId: PublicKey;
     constructor(client: MakerClient, priorId: PublicKey, nonce: bigint);
     status(): Promise<ReplacementSnapshot>;
+    prepare(input: QuoteRequest): Promise<QuoteHandle>;
     begin(): Promise<void>;
     resume(input: QuoteRequest, options?: {
         timeoutMs?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@depthhq/maker-sdk",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "publishConfig": {
     "access": "public"
   },
@@ -29,8 +29,8 @@
     "@solana/web3.js": "1.99.0",
     "buffer": "6.0.3",
     "viem": "2.38.0",
-    "@depthhq/bindings": "0.1.2",
-    "@depthhq/sdk": "0.1.6"
+    "@depthhq/bindings": "0.1.3",
+    "@depthhq/sdk": "0.1.7"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs maker-sdk",