@hadron-fi/sdk 0.3.0 → 0.3.2

package/dist/index.d.mts

@@ -85,6 +85,14 @@ interface DecodedFeeConfig {
     feeAdmin: PublicKey;
     feeRecipient: PublicKey;
 }
+interface DecodedSpreadConfig {
+    initialized: boolean;
+    bump: number;
+    numTriggers: number;
+    admin: PublicKey;
+    config: PublicKey;
+    triggers: SpreadTriggerInput[];
+}
 interface DecodedCurveUpdates {
     authority: PublicKey;
     curveMeta: PublicKey;
@@ -267,6 +275,48 @@ interface AllocateCurvePrefabsParams {
     maxPrefabSlots?: number;
     maxCurvePoints?: number;
 }
+type OrderSide = "bid" | "ask";
+interface PlaceOrderParams {
+    side: OrderSide;
+    /** Size in base tokens (human-readable, not atoms) */
+    size: number;
+    /** Spread from midprice in basis points */
+    spreadBps: number;
+}
+interface AmendOrderParams {
+    side: OrderSide;
+    /** 0-based index into the staged orders for that side */
+    level: number;
+    spreadBps?: number;
+    size?: number;
+}
+interface CancelOrderParams {
+    side: OrderSide;
+    level: number;
+}
+interface OrderbookLevel {
+    /** Absolute price (midprice * priceFactor) */
+    price: number;
+    /** Size at this level in base tokens */
+    size: number;
+    /** Cumulative size up to and including this level */
+    cumulative: number;
+}
+interface OrderbookState {
+    midprice: number;
+    bids: OrderbookLevel[];
+    asks: OrderbookLevel[];
+    inventory: {
+        base: number;
+        quote: number;
+    };
+}
+interface StagedOrder {
+    /** Size in base tokens (human-readable) */
+    size: number;
+    /** Spread from midprice in basis points */
+    spreadBps: number;
+}
 interface PoolAddresses {
     config: PublicKey;
     configBump: number;
@@ -394,10 +444,153 @@ declare class Hadron {
     setPoolState(authority: PublicKey, params: SetPoolStateParams): TransactionInstruction;
     /** Build update delta staleness instruction. */
     updateDeltaStaleness(authority: PublicKey, params: UpdateDeltaStalenessParams): TransactionInstruction;
+    /** Build initialize spread config instruction. */
+    initializeSpreadConfig(payer: PublicKey, authority: PublicKey, params: InitializeSpreadConfigParams): TransactionInstruction;
+    /** Build update spread config instruction (full replacement). */
+    updateSpreadConfig(admin: PublicKey, params: UpdateSpreadConfigParams): TransactionInstruction;
+    /**
+     * Fetch current spread triggers, append new ones, and return the update ix.
+     * If a trigger for the same account already exists, its spreadBps is updated.
+     */
+    addSpreadTriggers(admin: PublicKey, triggers: SpreadTriggerInput[]): Promise<TransactionInstruction>;
+    /**
+     * Fetch current spread triggers, remove the given accounts, and return the update ix.
+     */
+    removeSpreadTriggers(admin: PublicKey, accounts: PublicKey[]): Promise<TransactionInstruction>;
+    /** Fetch and decode the current spread config triggers from chain. */
+    private fetchSpreadTriggers;
     /** Build close pool instruction. */
     closePool(authority: PublicKey): TransactionInstruction;
 }
 
+/**
+ * High-level orderbook abstraction over a Hadron pool.
+ *
+ * Maps limit orders to risk curve points using `CurveXMode.Alternate`
+ * (absolute vault balance x-axis) and `RiskMode.Integrated`.
+ *
+ * ```ts
+ * const book = await HadronOrderbook.load({ connection, pool: poolAddress });
+ * book.placeOrder({ side: "bid", size: 100, spreadBps: 10 });
+ * book.placeOrder({ side: "ask", size: 100, spreadBps: 10 });
+ * const ixs = book.push(authority);
+ * ```
+ */
+declare class HadronOrderbook {
+    /** Underlying Hadron pool instance. */
+    readonly pool: Hadron;
+    /** Decimals for token X (base). */
+    readonly decimalsX: number;
+    /** Decimals for token Y (quote). */
+    readonly decimalsY: number;
+    /** Vault X balance at time of load (atoms). */
+    readonly initialVaultX: bigint;
+    /** Vault Y balance at time of load (atoms). */
+    readonly initialVaultY: bigint;
+    private bidOrders;
+    private askOrders;
+    private bidsDirty;
+    private asksDirty;
+    private priceCurvesSet;
+    private riskBidInitialized;
+    private riskAskInitialized;
+    private committedBidPoints;
+    private committedAskPoints;
+    private constructor();
+    /**
+     * Load an orderbook from an existing on-chain pool.
+     * Fetches decimals and vault balances, and reconstructs staged orders
+     * from the active risk curves.
+     */
+    static load(params: {
+        connection: Connection;
+        pool: PublicKey;
+    }): Promise<HadronOrderbook>;
+    /**
+     * Wrap an existing Hadron instance as an orderbook.
+     * Useful for tests or when you already have the pool loaded.
+     */
+    static fromPool(pool: Hadron, decimalsX: number, decimalsY: number, initialVaultX: bigint, initialVaultY: bigint): HadronOrderbook;
+    /**
+     * Place a new order. Orders are staged locally and pushed on-chain via `push()`.
+     * Orders on each side are sorted by spreadBps ascending (tightest first).
+     * @throws If more than 31 orders on a side.
+     */
+    placeOrder(params: PlaceOrderParams): void;
+    /**
+     * Amend an existing order at the given level index.
+     * Re-sorts if spread changes.
+     * @throws On invalid index.
+     */
+    amendOrder(params: AmendOrderParams): void;
+    /**
+     * Cancel the order at the given level index.
+     * @throws On invalid index.
+     */
+    cancelOrder(params: CancelOrderParams): void;
+    /** Cancel all orders on one or both sides. */
+    cancelAll(side?: OrderSide): void;
+    /** Read-only access to staged bid orders. */
+    getBids(): readonly StagedOrder[];
+    /** Read-only access to staged ask orders. */
+    getAsks(): readonly StagedOrder[];
+    /**
+     * Build transaction instructions to push the current staged orders on-chain.
+     *
+     * 1. On first push, sets flat price curves (factor=1.0, Step interpolation).
+     * 2. If risk curves not yet initialized, uses setRiskCurveAbsolute (sets headers).
+     * 3. On subsequent pushes, computes a minimal diff and uses curve updates
+     *    (submit + apply) when possible, falling back to full rewrite for large diffs.
+     */
+    push(authority: PublicKey): TransactionInstruction[];
+    /** Build an updateMidprice instruction. */
+    updateMidprice(authority: PublicKey, midprice: number, sequence?: bigint): TransactionInstruction;
+    /** Build a deposit instruction. */
+    deposit(user: PublicKey, params: DepositParams): TransactionInstruction;
+    /** Build a withdraw instruction. */
+    withdraw(user: PublicKey, params: WithdrawParams): TransactionInstruction;
+    /** Build a setPoolState instruction. */
+    setPoolState(authority: PublicKey, params: SetPoolStateParams): TransactionInstruction;
+    /**
+     * Get the current book state by reading on-chain risk curves + midprice.
+     * Reconstructs levels from curve points.
+     */
+    getBookState(): OrderbookState;
+    /**
+     * Compute the minimal set of curve update ops to transform `committed` into `desired`.
+     *
+     * Algorithm:
+     * 1. Scan left-to-right for factor-only diffs (amountIn unchanged) → Edit ops.
+     * 2. At the first structural diff (amountIn changed or length mismatch),
+     *    truncate-and-rebuild: remove all from that index to end, then add desired.
+     * 3. Returns the ops array.
+     */
+    static computeCurveOps(committed: CurvePoint[], desired: CurvePoint[], curveType: CurveType): CurveUpdateOp[];
+    /** Convert SetRiskCurveAbsolutePointInput[] to CurvePoint[] for diffing. */
+    private static toCommittedPoints;
+    /**
+     * Build full setRiskCurveAbsolute instructions for sides that need initialization.
+     * After sending, snapshots committed points and marks sides as initialized.
+     */
+    private buildFullRiskCurveIxs;
+    /**
+     * Build curve update instructions (submit + apply pairs) for both sides.
+     * Falls back to full setRiskCurve rewrite if diff is too large.
+     */
+    private buildCurveUpdateIxs;
+    /** Fallback: full setRiskCurve rewrite for both sides. */
+    private buildFallbackRewrite;
+    private buildBidRiskPoints;
+    private buildAskRiskPoints;
+    /**
+     * Reconstruct staged orders from on-chain risk curves (after load).
+     * Assumes curves were set via this class (CurveXMode.Alternate, RiskMode.Integrated, Step).
+     */
+    private reconstructFromCurves;
+    private reconstructSide;
+    private curveSideToLevels;
+}
+
 declare const HADRON_PROGRAM_ID: PublicKey;
 declare const CONFIG_SEED: Buffer<ArrayBuffer>;
 declare const MIDPRICE_ORACLE_SEED: Buffer<ArrayBuffer>;
@@ -463,6 +656,7 @@ declare function decodeCurveMeta(data: Uint8Array): DecodedCurveMeta;
  */
 declare function isSlotInitialized(initializedSlots: Uint8Array, curveType: CurveType, slot: number, maxSlots: number): boolean;
 declare function decodeFeeConfig(data: Uint8Array): DecodedFeeConfig;
+declare function decodeSpreadConfig(data: Uint8Array): DecodedSpreadConfig;
 declare function decodeCurveUpdates(data: Uint8Array): DecodedCurveUpdates;
 /**
  * Decode a single curve side from a CurvePrefabs account.
@@ -537,9 +731,9 @@ declare function buildWithdraw(user: PublicKey, configPda: PublicKey, mintX: Pub
  * user_source, vault_source, vault_dest, user_dest, fee_config,
  * fee_recipient_ata, clock, curve_updates.
  *
- * Optional (for introspection): spread_config, instructions_sysvar.
+ * When spread config is initialized: spread_config (#16) + instructions_sysvar (#17).
  */
-declare function buildSwapExactIn(user: PublicKey, poolAddresses: PoolAddresses, mintX: PublicKey, mintY: PublicKey, tokenProgramX: PublicKey, tokenProgramY: PublicKey, params: SwapParams, programId?: PublicKey): TransactionInstruction;
+declare function buildSwapExactIn(user: PublicKey, poolAddresses: PoolAddresses, mintX: PublicKey, mintY: PublicKey, tokenProgramX: PublicKey, tokenProgramY: PublicKey, params: SwapParams, programId?: PublicKey, spreadConfigInitialized?: boolean): TransactionInstruction;
 
 /**
  * Build a SetCurve instruction (price curve).
@@ -673,4 +867,4 @@ declare function buildUpdateDeltaStaleness(authority: PublicKey, configPda: Publ
  */
 declare function buildClosePool(authority: PublicKey, configPda: PublicKey, midpriceOraclePda: PublicKey, curveMetaPda: PublicKey, curvePrefabsPda: PublicKey, curveUpdatesPda: PublicKey, vaultX: PublicKey, vaultY: PublicKey, tokenProgramX: PublicKey, tokenProgramY: PublicKey, spreadConfigInitialized?: boolean, programId?: PublicKey): TransactionInstruction;
 
-export { ABSOLUTE_MAX_CURVE_POINTS, ABSOLUTE_MAX_PREFAB_SLOTS, type AllocateCurvePrefabsParams, CONFIG_SEED, CONFIG_SIZE, CURVE_META_SEED, CURVE_META_SIZE, CURVE_POINT_LEN, CURVE_PREFABS_SEED, CURVE_SIDE_HEADER, CURVE_UPDATES_SEED, CURVE_UPDATES_SIZE, CURVE_UPDATE_OP_SIZE, type CurvePoint, type CurveSide, CurveType, type CurveUpdateOp, CurveUpdateOpKind, CurveXMode, DEFAULT_MAX_CURVE_POINTS, DEFAULT_MAX_PREFAB_SLOTS, type DecodedConfig, type DecodedCurveMeta, type DecodedCurveUpdates, type DecodedFeeConfig, type DecodedMidpriceOracle, type DepositParams, Discriminator, FEE_CONFIG_SEED, FEE_CONFIG_SIZE, HADRON_PROGRAM_ID, Hadron, type InitializeFeeConfigParams, type InitializeParams, type InitializeSpreadConfigParams, Interpolation, MAX_CURVE_UPDATE_OPS, MAX_SETCURVE_POINTS, MIDPRICE_ORACLE_SEED, MIDPRICE_ORACLE_SIZE, type NominateAuthorityParams, OracleMode, POINT_DATA_SIZE, type PoolAddresses, PoolState, Q32_ONE, RiskMode, type RotateFeeAdminParams, SPREAD_CONFIG_SEED, type SetCurveBothParams, type SetCurveParams, type SetCurvePointInput, type SetPoolStateParams, type SetQuotingAuthorityParams, type SetRiskCurveAbsoluteBothParams, type SetRiskCurveAbsoluteParams, type SetRiskCurveAbsolutePointInput, type SetRiskCurveBothParams, type SetRiskCurveParams, type SetRiskCurvePointInput, Side, type SpreadTriggerInput, type SwapParams, type SwitchCurveParams, type UpdateBaseSpreadParams, type UpdateDeltaStalenessParams, type UpdateFeeConfigParams, type UpdateMidpriceAndBaseSpreadParams, type UpdateMidpriceParams, type UpdateSpreadConfigParams, type WithdrawParams, buildAcceptAuthority, buildAllocateCurvePrefabs, buildApplyCurveUpdates, buildClosePool, buildDeposit, buildInitialize, buildInitializeFeeConfig, buildInitializeSpreadConfig, buildNominateAuthority, buildRotateFeeAdmin, buildSetCurve, buildSetCurveBoth, buildSetPoolState, buildSetQuotingAuthority, buildSetRiskCurve, buildSetRiskCurveAbsolute, buildSetRiskCurveAbsoluteBoth, buildSetRiskCurveBoth, buildSubmitCurveUpdates, buildSwapExactIn, buildSwitchPriceCurve, buildSwitchRiskCurve, buildUpdateBaseSpread, buildUpdateDeltaStaleness, buildUpdateFeeConfig, buildUpdateMidprice, buildUpdateMidpriceAndBaseSpread, buildUpdateSpreadConfig, buildWithdraw, curvePrefabsSize, decodeActiveCurves, decodeConfig, decodeCurveMeta, decodeCurveSide, decodeCurveUpdates, decodeFeeConfig, decodeMidpriceOracle, derivePoolAddresses, fromQ32, getConfigAddress, getCurveMetaAddress, getCurvePrefabsAddress, getCurveUpdatesAddress, getFeeConfigAddress, getMidpriceOracleAddress, getOrCreateAta, getSpreadConfigAddress, isSlotInitialized, pctToQ32, toQ32 };
+export { ABSOLUTE_MAX_CURVE_POINTS, ABSOLUTE_MAX_PREFAB_SLOTS, type AllocateCurvePrefabsParams, type AmendOrderParams, CONFIG_SEED, CONFIG_SIZE, CURVE_META_SEED, CURVE_META_SIZE, CURVE_POINT_LEN, CURVE_PREFABS_SEED, CURVE_SIDE_HEADER, CURVE_UPDATES_SEED, CURVE_UPDATES_SIZE, CURVE_UPDATE_OP_SIZE, type CancelOrderParams, type CurvePoint, type CurveSide, CurveType, type CurveUpdateOp, CurveUpdateOpKind, CurveXMode, DEFAULT_MAX_CURVE_POINTS, DEFAULT_MAX_PREFAB_SLOTS, type DecodedConfig, type DecodedCurveMeta, type DecodedCurveUpdates, type DecodedFeeConfig, type DecodedMidpriceOracle, type DecodedSpreadConfig, type DepositParams, Discriminator, FEE_CONFIG_SEED, FEE_CONFIG_SIZE, HADRON_PROGRAM_ID, Hadron, HadronOrderbook, type InitializeFeeConfigParams, type InitializeParams, type InitializeSpreadConfigParams, Interpolation, MAX_CURVE_UPDATE_OPS, MAX_SETCURVE_POINTS, MIDPRICE_ORACLE_SEED, MIDPRICE_ORACLE_SIZE, type NominateAuthorityParams, OracleMode, type OrderSide, type OrderbookLevel, type OrderbookState, POINT_DATA_SIZE, type PlaceOrderParams, type PoolAddresses, PoolState, Q32_ONE, RiskMode, type RotateFeeAdminParams, SPREAD_CONFIG_SEED, type SetCurveBothParams, type SetCurveParams, type SetCurvePointInput, type SetPoolStateParams, type SetQuotingAuthorityParams, type SetRiskCurveAbsoluteBothParams, type SetRiskCurveAbsoluteParams, type SetRiskCurveAbsolutePointInput, type SetRiskCurveBothParams, type SetRiskCurveParams, type SetRiskCurvePointInput, Side, type SpreadTriggerInput, type StagedOrder, type SwapParams, type SwitchCurveParams, type UpdateBaseSpreadParams, type UpdateDeltaStalenessParams, type UpdateFeeConfigParams, type UpdateMidpriceAndBaseSpreadParams, type UpdateMidpriceParams, type UpdateSpreadConfigParams, type WithdrawParams, buildAcceptAuthority, buildAllocateCurvePrefabs, buildApplyCurveUpdates, buildClosePool, buildDeposit, buildInitialize, buildInitializeFeeConfig, buildInitializeSpreadConfig, buildNominateAuthority, buildRotateFeeAdmin, buildSetCurve, buildSetCurveBoth, buildSetPoolState, buildSetQuotingAuthority, buildSetRiskCurve, buildSetRiskCurveAbsolute, buildSetRiskCurveAbsoluteBoth, buildSetRiskCurveBoth, buildSubmitCurveUpdates, buildSwapExactIn, buildSwitchPriceCurve, buildSwitchRiskCurve, buildUpdateBaseSpread, buildUpdateDeltaStaleness, buildUpdateFeeConfig, buildUpdateMidprice, buildUpdateMidpriceAndBaseSpread, buildUpdateSpreadConfig, buildWithdraw, curvePrefabsSize, decodeActiveCurves, decodeConfig, decodeCurveMeta, decodeCurveSide, decodeCurveUpdates, decodeFeeConfig, decodeMidpriceOracle, decodeSpreadConfig, derivePoolAddresses, fromQ32, getConfigAddress, getCurveMetaAddress, getCurvePrefabsAddress, getCurveUpdatesAddress, getFeeConfigAddress, getMidpriceOracleAddress, getOrCreateAta, getSpreadConfigAddress, isSlotInitialized, pctToQ32, toQ32 };

package/dist/index.d.ts

@@ -85,6 +85,14 @@ interface DecodedFeeConfig {
     feeAdmin: PublicKey;
     feeRecipient: PublicKey;
 }
+interface DecodedSpreadConfig {
+    initialized: boolean;
+    bump: number;
+    numTriggers: number;
+    admin: PublicKey;
+    config: PublicKey;
+    triggers: SpreadTriggerInput[];
+}
 interface DecodedCurveUpdates {
     authority: PublicKey;
     curveMeta: PublicKey;
@@ -267,6 +275,48 @@ interface AllocateCurvePrefabsParams {
     maxPrefabSlots?: number;
     maxCurvePoints?: number;
 }
+type OrderSide = "bid" | "ask";
+interface PlaceOrderParams {
+    side: OrderSide;
+    /** Size in base tokens (human-readable, not atoms) */
+    size: number;
+    /** Spread from midprice in basis points */
+    spreadBps: number;
+}
+interface AmendOrderParams {
+    side: OrderSide;
+    /** 0-based index into the staged orders for that side */
+    level: number;
+    spreadBps?: number;
+    size?: number;
+}
+interface CancelOrderParams {
+    side: OrderSide;
+    level: number;
+}
+interface OrderbookLevel {
+    /** Absolute price (midprice * priceFactor) */
+    price: number;
+    /** Size at this level in base tokens */
+    size: number;
+    /** Cumulative size up to and including this level */
+    cumulative: number;
+}
+interface OrderbookState {
+    midprice: number;
+    bids: OrderbookLevel[];
+    asks: OrderbookLevel[];
+    inventory: {
+        base: number;
+        quote: number;
+    };
+}
+interface StagedOrder {
+    /** Size in base tokens (human-readable) */
+    size: number;
+    /** Spread from midprice in basis points */
+    spreadBps: number;
+}
 interface PoolAddresses {
     config: PublicKey;
     configBump: number;
@@ -394,10 +444,153 @@ declare class Hadron {
     setPoolState(authority: PublicKey, params: SetPoolStateParams): TransactionInstruction;
     /** Build update delta staleness instruction. */
     updateDeltaStaleness(authority: PublicKey, params: UpdateDeltaStalenessParams): TransactionInstruction;
+    /** Build initialize spread config instruction. */
+    initializeSpreadConfig(payer: PublicKey, authority: PublicKey, params: InitializeSpreadConfigParams): TransactionInstruction;
+    /** Build update spread config instruction (full replacement). */
+    updateSpreadConfig(admin: PublicKey, params: UpdateSpreadConfigParams): TransactionInstruction;
+    /**
+     * Fetch current spread triggers, append new ones, and return the update ix.
+     * If a trigger for the same account already exists, its spreadBps is updated.
+     */
+    addSpreadTriggers(admin: PublicKey, triggers: SpreadTriggerInput[]): Promise<TransactionInstruction>;
+    /**
+     * Fetch current spread triggers, remove the given accounts, and return the update ix.
+     */
+    removeSpreadTriggers(admin: PublicKey, accounts: PublicKey[]): Promise<TransactionInstruction>;
+    /** Fetch and decode the current spread config triggers from chain. */
+    private fetchSpreadTriggers;
     /** Build close pool instruction. */
     closePool(authority: PublicKey): TransactionInstruction;
 }
 
+/**
+ * High-level orderbook abstraction over a Hadron pool.
+ *
+ * Maps limit orders to risk curve points using `CurveXMode.Alternate`
+ * (absolute vault balance x-axis) and `RiskMode.Integrated`.
+ *
+ * ```ts
+ * const book = await HadronOrderbook.load({ connection, pool: poolAddress });
+ * book.placeOrder({ side: "bid", size: 100, spreadBps: 10 });
+ * book.placeOrder({ side: "ask", size: 100, spreadBps: 10 });
+ * const ixs = book.push(authority);
+ * ```
+ */
+declare class HadronOrderbook {
+    /** Underlying Hadron pool instance. */
+    readonly pool: Hadron;
+    /** Decimals for token X (base). */
+    readonly decimalsX: number;
+    /** Decimals for token Y (quote). */
+    readonly decimalsY: number;
+    /** Vault X balance at time of load (atoms). */
+    readonly initialVaultX: bigint;
+    /** Vault Y balance at time of load (atoms). */
+    readonly initialVaultY: bigint;
+    private bidOrders;
+    private askOrders;
+    private bidsDirty;
+    private asksDirty;
+    private priceCurvesSet;
+    private riskBidInitialized;
+    private riskAskInitialized;
+    private committedBidPoints;
+    private committedAskPoints;
+    private constructor();
+    /**
+     * Load an orderbook from an existing on-chain pool.
+     * Fetches decimals and vault balances, and reconstructs staged orders
+     * from the active risk curves.
+     */
+    static load(params: {
+        connection: Connection;
+        pool: PublicKey;
+    }): Promise<HadronOrderbook>;
+    /**
+     * Wrap an existing Hadron instance as an orderbook.
+     * Useful for tests or when you already have the pool loaded.
+     */
+    static fromPool(pool: Hadron, decimalsX: number, decimalsY: number, initialVaultX: bigint, initialVaultY: bigint): HadronOrderbook;
+    /**
+     * Place a new order. Orders are staged locally and pushed on-chain via `push()`.
+     * Orders on each side are sorted by spreadBps ascending (tightest first).
+     * @throws If more than 31 orders on a side.
+     */
+    placeOrder(params: PlaceOrderParams): void;
+    /**
+     * Amend an existing order at the given level index.
+     * Re-sorts if spread changes.
+     * @throws On invalid index.
+     */
+    amendOrder(params: AmendOrderParams): void;
+    /**
+     * Cancel the order at the given level index.
+     * @throws On invalid index.
+     */
+    cancelOrder(params: CancelOrderParams): void;
+    /** Cancel all orders on one or both sides. */
+    cancelAll(side?: OrderSide): void;
+    /** Read-only access to staged bid orders. */
+    getBids(): readonly StagedOrder[];
+    /** Read-only access to staged ask orders. */
+    getAsks(): readonly StagedOrder[];
+    /**
+     * Build transaction instructions to push the current staged orders on-chain.
+     *
+     * 1. On first push, sets flat price curves (factor=1.0, Step interpolation).
+     * 2. If risk curves not yet initialized, uses setRiskCurveAbsolute (sets headers).
+     * 3. On subsequent pushes, computes a minimal diff and uses curve updates
+     *    (submit + apply) when possible, falling back to full rewrite for large diffs.
+     */
+    push(authority: PublicKey): TransactionInstruction[];
+    /** Build an updateMidprice instruction. */
+    updateMidprice(authority: PublicKey, midprice: number, sequence?: bigint): TransactionInstruction;
+    /** Build a deposit instruction. */
+    deposit(user: PublicKey, params: DepositParams): TransactionInstruction;
+    /** Build a withdraw instruction. */
+    withdraw(user: PublicKey, params: WithdrawParams): TransactionInstruction;
+    /** Build a setPoolState instruction. */
+    setPoolState(authority: PublicKey, params: SetPoolStateParams): TransactionInstruction;
+    /**
+     * Get the current book state by reading on-chain risk curves + midprice.
+     * Reconstructs levels from curve points.
+     */
+    getBookState(): OrderbookState;
+    /**
+     * Compute the minimal set of curve update ops to transform `committed` into `desired`.
+     *
+     * Algorithm:
+     * 1. Scan left-to-right for factor-only diffs (amountIn unchanged) → Edit ops.
+     * 2. At the first structural diff (amountIn changed or length mismatch),
+     *    truncate-and-rebuild: remove all from that index to end, then add desired.
+     * 3. Returns the ops array.
+     */
+    static computeCurveOps(committed: CurvePoint[], desired: CurvePoint[], curveType: CurveType): CurveUpdateOp[];
+    /** Convert SetRiskCurveAbsolutePointInput[] to CurvePoint[] for diffing. */
+    private static toCommittedPoints;
+    /**
+     * Build full setRiskCurveAbsolute instructions for sides that need initialization.
+     * After sending, snapshots committed points and marks sides as initialized.
+     */
+    private buildFullRiskCurveIxs;
+    /**
+     * Build curve update instructions (submit + apply pairs) for both sides.
+     * Falls back to full setRiskCurve rewrite if diff is too large.
+     */
+    private buildCurveUpdateIxs;
+    /** Fallback: full setRiskCurve rewrite for both sides. */
+    private buildFallbackRewrite;
+    private buildBidRiskPoints;
+    private buildAskRiskPoints;
+    /**
+     * Reconstruct staged orders from on-chain risk curves (after load).
+     * Assumes curves were set via this class (CurveXMode.Alternate, RiskMode.Integrated, Step).
+     */
+    private reconstructFromCurves;
+    private reconstructSide;
+    private curveSideToLevels;
+}
+
 declare const HADRON_PROGRAM_ID: PublicKey;
 declare const CONFIG_SEED: Buffer<ArrayBuffer>;
 declare const MIDPRICE_ORACLE_SEED: Buffer<ArrayBuffer>;
@@ -463,6 +656,7 @@ declare function decodeCurveMeta(data: Uint8Array): DecodedCurveMeta;
  */
 declare function isSlotInitialized(initializedSlots: Uint8Array, curveType: CurveType, slot: number, maxSlots: number): boolean;
 declare function decodeFeeConfig(data: Uint8Array): DecodedFeeConfig;
+declare function decodeSpreadConfig(data: Uint8Array): DecodedSpreadConfig;
 declare function decodeCurveUpdates(data: Uint8Array): DecodedCurveUpdates;
 /**
  * Decode a single curve side from a CurvePrefabs account.
@@ -537,9 +731,9 @@ declare function buildWithdraw(user: PublicKey, configPda: PublicKey, mintX: Pub
  * user_source, vault_source, vault_dest, user_dest, fee_config,
  * fee_recipient_ata, clock, curve_updates.
  *
- * Optional (for introspection): spread_config, instructions_sysvar.
+ * When spread config is initialized: spread_config (#16) + instructions_sysvar (#17).
  */
-declare function buildSwapExactIn(user: PublicKey, poolAddresses: PoolAddresses, mintX: PublicKey, mintY: PublicKey, tokenProgramX: PublicKey, tokenProgramY: PublicKey, params: SwapParams, programId?: PublicKey): TransactionInstruction;
+declare function buildSwapExactIn(user: PublicKey, poolAddresses: PoolAddresses, mintX: PublicKey, mintY: PublicKey, tokenProgramX: PublicKey, tokenProgramY: PublicKey, params: SwapParams, programId?: PublicKey, spreadConfigInitialized?: boolean): TransactionInstruction;
 
 /**
  * Build a SetCurve instruction (price curve).
@@ -673,4 +867,4 @@ declare function buildUpdateDeltaStaleness(authority: PublicKey, configPda: Publ
  */
 declare function buildClosePool(authority: PublicKey, configPda: PublicKey, midpriceOraclePda: PublicKey, curveMetaPda: PublicKey, curvePrefabsPda: PublicKey, curveUpdatesPda: PublicKey, vaultX: PublicKey, vaultY: PublicKey, tokenProgramX: PublicKey, tokenProgramY: PublicKey, spreadConfigInitialized?: boolean, programId?: PublicKey): TransactionInstruction;
 
-export { ABSOLUTE_MAX_CURVE_POINTS, ABSOLUTE_MAX_PREFAB_SLOTS, type AllocateCurvePrefabsParams, CONFIG_SEED, CONFIG_SIZE, CURVE_META_SEED, CURVE_META_SIZE, CURVE_POINT_LEN, CURVE_PREFABS_SEED, CURVE_SIDE_HEADER, CURVE_UPDATES_SEED, CURVE_UPDATES_SIZE, CURVE_UPDATE_OP_SIZE, type CurvePoint, type CurveSide, CurveType, type CurveUpdateOp, CurveUpdateOpKind, CurveXMode, DEFAULT_MAX_CURVE_POINTS, DEFAULT_MAX_PREFAB_SLOTS, type DecodedConfig, type DecodedCurveMeta, type DecodedCurveUpdates, type DecodedFeeConfig, type DecodedMidpriceOracle, type DepositParams, Discriminator, FEE_CONFIG_SEED, FEE_CONFIG_SIZE, HADRON_PROGRAM_ID, Hadron, type InitializeFeeConfigParams, type InitializeParams, type InitializeSpreadConfigParams, Interpolation, MAX_CURVE_UPDATE_OPS, MAX_SETCURVE_POINTS, MIDPRICE_ORACLE_SEED, MIDPRICE_ORACLE_SIZE, type NominateAuthorityParams, OracleMode, POINT_DATA_SIZE, type PoolAddresses, PoolState, Q32_ONE, RiskMode, type RotateFeeAdminParams, SPREAD_CONFIG_SEED, type SetCurveBothParams, type SetCurveParams, type SetCurvePointInput, type SetPoolStateParams, type SetQuotingAuthorityParams, type SetRiskCurveAbsoluteBothParams, type SetRiskCurveAbsoluteParams, type SetRiskCurveAbsolutePointInput, type SetRiskCurveBothParams, type SetRiskCurveParams, type SetRiskCurvePointInput, Side, type SpreadTriggerInput, type SwapParams, type SwitchCurveParams, type UpdateBaseSpreadParams, type UpdateDeltaStalenessParams, type UpdateFeeConfigParams, type UpdateMidpriceAndBaseSpreadParams, type UpdateMidpriceParams, type UpdateSpreadConfigParams, type WithdrawParams, buildAcceptAuthority, buildAllocateCurvePrefabs, buildApplyCurveUpdates, buildClosePool, buildDeposit, buildInitialize, buildInitializeFeeConfig, buildInitializeSpreadConfig, buildNominateAuthority, buildRotateFeeAdmin, buildSetCurve, buildSetCurveBoth, buildSetPoolState, buildSetQuotingAuthority, buildSetRiskCurve, buildSetRiskCurveAbsolute, buildSetRiskCurveAbsoluteBoth, buildSetRiskCurveBoth, buildSubmitCurveUpdates, buildSwapExactIn, buildSwitchPriceCurve, buildSwitchRiskCurve, buildUpdateBaseSpread, buildUpdateDeltaStaleness, buildUpdateFeeConfig, buildUpdateMidprice, buildUpdateMidpriceAndBaseSpread, buildUpdateSpreadConfig, buildWithdraw, curvePrefabsSize, decodeActiveCurves, decodeConfig, decodeCurveMeta, decodeCurveSide, decodeCurveUpdates, decodeFeeConfig, decodeMidpriceOracle, derivePoolAddresses, fromQ32, getConfigAddress, getCurveMetaAddress, getCurvePrefabsAddress, getCurveUpdatesAddress, getFeeConfigAddress, getMidpriceOracleAddress, getOrCreateAta, getSpreadConfigAddress, isSlotInitialized, pctToQ32, toQ32 };
+export { ABSOLUTE_MAX_CURVE_POINTS, ABSOLUTE_MAX_PREFAB_SLOTS, type AllocateCurvePrefabsParams, type AmendOrderParams, CONFIG_SEED, CONFIG_SIZE, CURVE_META_SEED, CURVE_META_SIZE, CURVE_POINT_LEN, CURVE_PREFABS_SEED, CURVE_SIDE_HEADER, CURVE_UPDATES_SEED, CURVE_UPDATES_SIZE, CURVE_UPDATE_OP_SIZE, type CancelOrderParams, type CurvePoint, type CurveSide, CurveType, type CurveUpdateOp, CurveUpdateOpKind, CurveXMode, DEFAULT_MAX_CURVE_POINTS, DEFAULT_MAX_PREFAB_SLOTS, type DecodedConfig, type DecodedCurveMeta, type DecodedCurveUpdates, type DecodedFeeConfig, type DecodedMidpriceOracle, type DecodedSpreadConfig, type DepositParams, Discriminator, FEE_CONFIG_SEED, FEE_CONFIG_SIZE, HADRON_PROGRAM_ID, Hadron, HadronOrderbook, type InitializeFeeConfigParams, type InitializeParams, type InitializeSpreadConfigParams, Interpolation, MAX_CURVE_UPDATE_OPS, MAX_SETCURVE_POINTS, MIDPRICE_ORACLE_SEED, MIDPRICE_ORACLE_SIZE, type NominateAuthorityParams, OracleMode, type OrderSide, type OrderbookLevel, type OrderbookState, POINT_DATA_SIZE, type PlaceOrderParams, type PoolAddresses, PoolState, Q32_ONE, RiskMode, type RotateFeeAdminParams, SPREAD_CONFIG_SEED, type SetCurveBothParams, type SetCurveParams, type SetCurvePointInput, type SetPoolStateParams, type SetQuotingAuthorityParams, type SetRiskCurveAbsoluteBothParams, type SetRiskCurveAbsoluteParams, type SetRiskCurveAbsolutePointInput, type SetRiskCurveBothParams, type SetRiskCurveParams, type SetRiskCurvePointInput, Side, type SpreadTriggerInput, type StagedOrder, type SwapParams, type SwitchCurveParams, type UpdateBaseSpreadParams, type UpdateDeltaStalenessParams, type UpdateFeeConfigParams, type UpdateMidpriceAndBaseSpreadParams, type UpdateMidpriceParams, type UpdateSpreadConfigParams, type WithdrawParams, buildAcceptAuthority, buildAllocateCurvePrefabs, buildApplyCurveUpdates, buildClosePool, buildDeposit, buildInitialize, buildInitializeFeeConfig, buildInitializeSpreadConfig, buildNominateAuthority, buildRotateFeeAdmin, buildSetCurve, buildSetCurveBoth, buildSetPoolState, buildSetQuotingAuthority, buildSetRiskCurve, buildSetRiskCurveAbsolute, buildSetRiskCurveAbsoluteBoth, buildSetRiskCurveBoth, buildSubmitCurveUpdates, buildSwapExactIn, buildSwitchPriceCurve, buildSwitchRiskCurve, buildUpdateBaseSpread, buildUpdateDeltaStaleness, buildUpdateFeeConfig, buildUpdateMidprice, buildUpdateMidpriceAndBaseSpread, buildUpdateSpreadConfig, buildWithdraw, curvePrefabsSize, decodeActiveCurves, decodeConfig, decodeCurveMeta, decodeCurveSide, decodeCurveUpdates, decodeFeeConfig, decodeMidpriceOracle, decodeSpreadConfig, derivePoolAddresses, fromQ32, getConfigAddress, getCurveMetaAddress, getCurvePrefabsAddress, getCurveUpdatesAddress, getFeeConfigAddress, getMidpriceOracleAddress, getOrCreateAta, getSpreadConfigAddress, isSlotInitialized, pctToQ32, toQ32 };