@hadron-fi/sdk 0.3.1 → 0.3.3

package/dist/index.d.mts

@@ -65,7 +65,8 @@ interface DecodedMidpriceOracle {
     authority: PublicKey;
     sequence: bigint;
     midpriceQ32: bigint;
-    baseSpreadQ32: bigint;
+    /** Spread as a discount factor in Q32 (e.g. toQ32(0.9995) = 5 bps). */
+    spreadFactorQ32: bigint;
     lastUpdateSlot: bigint;
 }
 interface DecodedCurveMeta {
@@ -217,12 +218,14 @@ interface UpdateMidpriceParams {
     sequence?: bigint;
 }
 interface UpdateBaseSpreadParams {
-    baseSpreadQ32: bigint;
+    /** Spread as a discount factor in Q32 (e.g. toQ32(0.9995) = 5 bps). */
+    spreadFactorQ32: bigint;
     sequence?: bigint;
 }
 interface UpdateMidpriceAndBaseSpreadParams {
     midpriceQ32: bigint;
-    baseSpreadQ32: bigint;
+    /** Spread as a discount factor in Q32 (e.g. toQ32(0.9995) = 5 bps). */
+    spreadFactorQ32: bigint;
     sequence?: bigint;
 }
 interface SwitchCurveParams {
@@ -386,8 +389,10 @@ declare class Hadron {
     refetchStates(): Promise<void>;
     /** Get midprice as a floating-point number. */
     getMidprice(): number;
-    /** Get base spread as a floating-point number. */
-    getBaseSpread(): number;
+    /** Get spread factor as a floating-point number (e.g. 0.9995 = 5 bps). */
+    getSpreadFactor(): number;
+    /** Get spread in basis points (e.g. 5 for a 0.9995 factor). */
+    getSpreadBps(): number;
     /** Get the currently active curve slot indices. */
     getActiveCurveSlots(): {
         priceBid: number;
@@ -692,6 +697,10 @@ declare function toQ32(value: number): bigint;
 declare function fromQ32(q32: bigint): number;
 /** Convert a percentage (0.0 to 1.0) to Q32.32. */
 declare function pctToQ32(pct: number): bigint;
+/** Convert basis points to a spread factor in Q32 (e.g. 5 bps → toQ32(0.9995)). */
+declare function spreadBpsToQ32(bps: number): bigint;
+/** Convert a spread factor in Q32 to basis points (e.g. toQ32(0.9995) → 5). */
+declare function spreadQ32ToBps(q32: bigint): number;
 
 /**
  * Get the ATA address, and optionally return a create instruction if it doesn't exist.
@@ -731,9 +740,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).
@@ -867,4 +876,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, 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 };
+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, spreadBpsToQ32, spreadQ32ToBps, toQ32 };

package/dist/index.d.ts

@@ -65,7 +65,8 @@ interface DecodedMidpriceOracle {
     authority: PublicKey;
     sequence: bigint;
     midpriceQ32: bigint;
-    baseSpreadQ32: bigint;
+    /** Spread as a discount factor in Q32 (e.g. toQ32(0.9995) = 5 bps). */
+    spreadFactorQ32: bigint;
     lastUpdateSlot: bigint;
 }
 interface DecodedCurveMeta {
@@ -217,12 +218,14 @@ interface UpdateMidpriceParams {
     sequence?: bigint;
 }
 interface UpdateBaseSpreadParams {
-    baseSpreadQ32: bigint;
+    /** Spread as a discount factor in Q32 (e.g. toQ32(0.9995) = 5 bps). */
+    spreadFactorQ32: bigint;
     sequence?: bigint;
 }
 interface UpdateMidpriceAndBaseSpreadParams {
     midpriceQ32: bigint;
-    baseSpreadQ32: bigint;
+    /** Spread as a discount factor in Q32 (e.g. toQ32(0.9995) = 5 bps). */
+    spreadFactorQ32: bigint;
     sequence?: bigint;
 }
 interface SwitchCurveParams {
@@ -386,8 +389,10 @@ declare class Hadron {
     refetchStates(): Promise<void>;
     /** Get midprice as a floating-point number. */
     getMidprice(): number;
-    /** Get base spread as a floating-point number. */
-    getBaseSpread(): number;
+    /** Get spread factor as a floating-point number (e.g. 0.9995 = 5 bps). */
+    getSpreadFactor(): number;
+    /** Get spread in basis points (e.g. 5 for a 0.9995 factor). */
+    getSpreadBps(): number;
     /** Get the currently active curve slot indices. */
     getActiveCurveSlots(): {
         priceBid: number;
@@ -692,6 +697,10 @@ declare function toQ32(value: number): bigint;
 declare function fromQ32(q32: bigint): number;
 /** Convert a percentage (0.0 to 1.0) to Q32.32. */
 declare function pctToQ32(pct: number): bigint;
+/** Convert basis points to a spread factor in Q32 (e.g. 5 bps → toQ32(0.9995)). */
+declare function spreadBpsToQ32(bps: number): bigint;
+/** Convert a spread factor in Q32 to basis points (e.g. toQ32(0.9995) → 5). */
+declare function spreadQ32ToBps(q32: bigint): number;
 
 /**
  * Get the ATA address, and optionally return a create instruction if it doesn't exist.
@@ -731,9 +740,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).
@@ -867,4 +876,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, 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 };
+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, spreadBpsToQ32, spreadQ32ToBps, toQ32 };

package/dist/index.js

@@ -166,6 +166,12 @@ function fromQ32(q32) {
 function pctToQ32(pct) {
   return toQ32(pct);
 }
+function spreadBpsToQ32(bps) {
+  return toQ32(1 - bps / 1e4);
+}
+function spreadQ32ToBps(q32) {
+  return (1 - fromQ32(q32)) * 1e4;
+}
 
 // src/accounts/index.ts
 
@@ -275,9 +281,9 @@ function decodeMidpriceOracle(data) {
   const authority = new (0, _web3js.PublicKey)(buf.subarray(0, 32));
   const sequence = buf.readBigUInt64LE(32);
   const midpriceQ32 = buf.readBigUInt64LE(40);
-  const baseSpreadQ32 = buf.readBigUInt64LE(48);
+  const spreadFactorQ32 = buf.readBigUInt64LE(48);
   const lastUpdateSlot = buf.length >= MIDPRICE_ORACLE_SIZE ? buf.readBigUInt64LE(56) : 0n;
-  return { authority, sequence, midpriceQ32, baseSpreadQ32, lastUpdateSlot };
+  return { authority, sequence, midpriceQ32, spreadFactorQ32, lastUpdateSlot };
 }
 function decodeCurveMeta(data) {
   const buf = Buffer.from(data);
@@ -596,7 +602,8 @@ function buildWithdraw(user, configPda, mintX, mintY, tokenProgramX, tokenProgra
 
 
 
-function buildSwapExactIn(user, poolAddresses, mintX, mintY, tokenProgramX, tokenProgramY, params, programId = HADRON_PROGRAM_ID) {
+
+function buildSwapExactIn(user, poolAddresses, mintX, mintY, tokenProgramX, tokenProgramY, params, programId = HADRON_PROGRAM_ID, spreadConfigInitialized = false) {
   const data = Buffer.alloc(1 + 1 + 8 + 8 + 8);
   let offset = 0;
   data.writeUInt8(Discriminator.SwapExactIn, offset);
@@ -621,39 +628,50 @@ function buildSwapExactIn(user, poolAddresses, mintX, mintY, tokenProgramX, toke
     false,
     inputMintProgram
   );
+  const keys = [
+    { pubkey: tokenProgramX, isSigner: false, isWritable: false },
+    { pubkey: tokenProgramY, isSigner: false, isWritable: false },
+    { pubkey: poolAddresses.config, isSigner: false, isWritable: false },
+    {
+      pubkey: poolAddresses.midpriceOracle,
+      isSigner: false,
+      isWritable: false
+    },
+    { pubkey: poolAddresses.curveMeta, isSigner: false, isWritable: false },
+    {
+      pubkey: poolAddresses.curvePrefabs,
+      isSigner: false,
+      isWritable: true
+    },
+    { pubkey: poolAddresses.config, isSigner: false, isWritable: false },
+    // authority = pool address PDA
+    { pubkey: user, isSigner: true, isWritable: false },
+    { pubkey: userSource, isSigner: false, isWritable: true },
+    { pubkey: vaultSource, isSigner: false, isWritable: true },
+    { pubkey: vaultDest, isSigner: false, isWritable: true },
+    { pubkey: userDest, isSigner: false, isWritable: true },
+    { pubkey: feeConfigPda, isSigner: false, isWritable: false },
+    { pubkey: feeRecipientAta, isSigner: false, isWritable: true },
+    { pubkey: _web3js.SYSVAR_CLOCK_PUBKEY, isSigner: false, isWritable: false },
+    {
+      pubkey: poolAddresses.curveUpdates,
+      isSigner: false,
+      isWritable: true
+    }
+  ];
+  if (spreadConfigInitialized) {
+    const [spreadConfigPda] = getSpreadConfigAddress(
+      poolAddresses.config,
+      programId
+    );
+    keys.push(
+      { pubkey: spreadConfigPda, isSigner: false, isWritable: false },
+      { pubkey: _web3js.SYSVAR_INSTRUCTIONS_PUBKEY, isSigner: false, isWritable: false }
+    );
+  }
   return new (0, _web3js.TransactionInstruction)({
     programId,
-    keys: [
-      { pubkey: tokenProgramX, isSigner: false, isWritable: false },
-      { pubkey: tokenProgramY, isSigner: false, isWritable: false },
-      { pubkey: poolAddresses.config, isSigner: false, isWritable: false },
-      {
-        pubkey: poolAddresses.midpriceOracle,
-        isSigner: false,
-        isWritable: false
-      },
-      { pubkey: poolAddresses.curveMeta, isSigner: false, isWritable: false },
-      {
-        pubkey: poolAddresses.curvePrefabs,
-        isSigner: false,
-        isWritable: true
-      },
-      { pubkey: poolAddresses.config, isSigner: false, isWritable: false },
-      // authority = pool address PDA
-      { pubkey: user, isSigner: true, isWritable: false },
-      { pubkey: userSource, isSigner: false, isWritable: true },
-      { pubkey: vaultSource, isSigner: false, isWritable: true },
-      { pubkey: vaultDest, isSigner: false, isWritable: true },
-      { pubkey: userDest, isSigner: false, isWritable: true },
-      { pubkey: feeConfigPda, isSigner: false, isWritable: false },
-      { pubkey: feeRecipientAta, isSigner: false, isWritable: true },
-      { pubkey: _web3js.SYSVAR_CLOCK_PUBKEY, isSigner: false, isWritable: false },
-      {
-        pubkey: poolAddresses.curveUpdates,
-        isSigner: false,
-        isWritable: true
-      }
-    ],
+    keys,
     data
   });
 }
@@ -838,7 +856,7 @@ function buildUpdateBaseSpread(authority, midpriceOraclePda, params, programId =
   const data = Buffer.alloc(1 + 8 + 8);
   data.writeUInt8(Discriminator.UpdateBaseSpread, 0);
   data.writeBigUInt64LE(_nullishCoalesce(params.sequence, () => ( 0n)), 1);
-  data.writeBigUInt64LE(params.baseSpreadQ32, 9);
+  data.writeBigUInt64LE(params.spreadFactorQ32, 9);
   return new (0, _web3js.TransactionInstruction)({
     programId,
     keys: [
@@ -854,7 +872,7 @@ function buildUpdateMidpriceAndBaseSpread(authority, midpriceOraclePda, params,
   data.writeUInt8(Discriminator.UpdateMidpriceAndBaseSpread, 0);
   data.writeBigUInt64LE(_nullishCoalesce(params.sequence, () => ( 0n)), 1);
   data.writeBigUInt64LE(params.midpriceQ32, 9);
-  data.writeBigUInt64LE(params.baseSpreadQ32, 17);
+  data.writeBigUInt64LE(params.spreadFactorQ32, 17);
   return new (0, _web3js.TransactionInstruction)({
     programId,
     keys: [
@@ -1309,9 +1327,13 @@ var Hadron = class _Hadron {
   getMidprice() {
     return fromQ32(this.oracle.midpriceQ32);
   }
-  /** Get base spread as a floating-point number. */
-  getBaseSpread() {
-    return fromQ32(this.oracle.baseSpreadQ32);
+  /** Get spread factor as a floating-point number (e.g. 0.9995 = 5 bps). */
+  getSpreadFactor() {
+    return fromQ32(this.oracle.spreadFactorQ32);
+  }
+  /** Get spread in basis points (e.g. 5 for a 0.9995 factor). */
+  getSpreadBps() {
+    return (1 - fromQ32(this.oracle.spreadFactorQ32)) * 1e4;
   }
   /** Get the currently active curve slot indices. */
   getActiveCurveSlots() {
@@ -1375,7 +1397,8 @@ var Hadron = class _Hadron {
       this.config.tokenProgramX,
       this.config.tokenProgramY,
       params,
-      this.programId
+      this.programId,
+      this.config.spreadConfigInitialized
     );
   }
   /** Build set curve instruction. */
@@ -2288,5 +2311,7 @@ async function getOrCreateAta(connection, mint, owner, payer, tokenProgram = _sp
 
 
 
-exports.ABSOLUTE_MAX_CURVE_POINTS = ABSOLUTE_MAX_CURVE_POINTS; exports.ABSOLUTE_MAX_PREFAB_SLOTS = ABSOLUTE_MAX_PREFAB_SLOTS; exports.CONFIG_SEED = CONFIG_SEED; exports.CONFIG_SIZE = CONFIG_SIZE; exports.CURVE_META_SEED = CURVE_META_SEED; exports.CURVE_META_SIZE = CURVE_META_SIZE; exports.CURVE_POINT_LEN = CURVE_POINT_LEN; exports.CURVE_PREFABS_SEED = CURVE_PREFABS_SEED; exports.CURVE_SIDE_HEADER = CURVE_SIDE_HEADER; exports.CURVE_UPDATES_SEED = CURVE_UPDATES_SEED; exports.CURVE_UPDATES_SIZE = CURVE_UPDATES_SIZE; exports.CURVE_UPDATE_OP_SIZE = CURVE_UPDATE_OP_SIZE; exports.CurveType = CurveType; exports.CurveUpdateOpKind = CurveUpdateOpKind; exports.CurveXMode = CurveXMode; exports.DEFAULT_MAX_CURVE_POINTS = DEFAULT_MAX_CURVE_POINTS; exports.DEFAULT_MAX_PREFAB_SLOTS = DEFAULT_MAX_PREFAB_SLOTS; exports.Discriminator = Discriminator; exports.FEE_CONFIG_SEED = FEE_CONFIG_SEED; exports.FEE_CONFIG_SIZE = FEE_CONFIG_SIZE; exports.HADRON_PROGRAM_ID = HADRON_PROGRAM_ID; exports.Hadron = Hadron; exports.HadronOrderbook = HadronOrderbook; exports.Interpolation = Interpolation; exports.MAX_CURVE_UPDATE_OPS = MAX_CURVE_UPDATE_OPS; exports.MAX_SETCURVE_POINTS = MAX_SETCURVE_POINTS; exports.MIDPRICE_ORACLE_SEED = MIDPRICE_ORACLE_SEED; exports.MIDPRICE_ORACLE_SIZE = MIDPRICE_ORACLE_SIZE; exports.OracleMode = OracleMode; exports.POINT_DATA_SIZE = POINT_DATA_SIZE; exports.PoolState = PoolState; exports.Q32_ONE = Q32_ONE; exports.RiskMode = RiskMode; exports.SPREAD_CONFIG_SEED = SPREAD_CONFIG_SEED; exports.Side = Side; exports.buildAcceptAuthority = buildAcceptAuthority; exports.buildAllocateCurvePrefabs = buildAllocateCurvePrefabs; exports.buildApplyCurveUpdates = buildApplyCurveUpdates; exports.buildClosePool = buildClosePool; exports.buildDeposit = buildDeposit; exports.buildInitialize = buildInitialize; exports.buildInitializeFeeConfig = buildInitializeFeeConfig; exports.buildInitializeSpreadConfig = buildInitializeSpreadConfig; exports.buildNominateAuthority = buildNominateAuthority; exports.buildRotateFeeAdmin = buildRotateFeeAdmin; exports.buildSetCurve = buildSetCurve; exports.buildSetCurveBoth = buildSetCurveBoth; exports.buildSetPoolState = buildSetPoolState; exports.buildSetQuotingAuthority = buildSetQuotingAuthority; exports.buildSetRiskCurve = buildSetRiskCurve; exports.buildSetRiskCurveAbsolute = buildSetRiskCurveAbsolute; exports.buildSetRiskCurveAbsoluteBoth = buildSetRiskCurveAbsoluteBoth; exports.buildSetRiskCurveBoth = buildSetRiskCurveBoth; exports.buildSubmitCurveUpdates = buildSubmitCurveUpdates; exports.buildSwapExactIn = buildSwapExactIn; exports.buildSwitchPriceCurve = buildSwitchPriceCurve; exports.buildSwitchRiskCurve = buildSwitchRiskCurve; exports.buildUpdateBaseSpread = buildUpdateBaseSpread; exports.buildUpdateDeltaStaleness = buildUpdateDeltaStaleness; exports.buildUpdateFeeConfig = buildUpdateFeeConfig; exports.buildUpdateMidprice = buildUpdateMidprice; exports.buildUpdateMidpriceAndBaseSpread = buildUpdateMidpriceAndBaseSpread; exports.buildUpdateSpreadConfig = buildUpdateSpreadConfig; exports.buildWithdraw = buildWithdraw; exports.curvePrefabsSize = curvePrefabsSize; exports.decodeActiveCurves = decodeActiveCurves; exports.decodeConfig = decodeConfig; exports.decodeCurveMeta = decodeCurveMeta; exports.decodeCurveSide = decodeCurveSide; exports.decodeCurveUpdates = decodeCurveUpdates; exports.decodeFeeConfig = decodeFeeConfig; exports.decodeMidpriceOracle = decodeMidpriceOracle; exports.decodeSpreadConfig = decodeSpreadConfig; exports.derivePoolAddresses = derivePoolAddresses; exports.fromQ32 = fromQ32; exports.getConfigAddress = getConfigAddress; exports.getCurveMetaAddress = getCurveMetaAddress; exports.getCurvePrefabsAddress = getCurvePrefabsAddress; exports.getCurveUpdatesAddress = getCurveUpdatesAddress; exports.getFeeConfigAddress = getFeeConfigAddress; exports.getMidpriceOracleAddress = getMidpriceOracleAddress; exports.getOrCreateAta = getOrCreateAta; exports.getSpreadConfigAddress = getSpreadConfigAddress; exports.isSlotInitialized = isSlotInitialized; exports.pctToQ32 = pctToQ32; exports.toQ32 = toQ32;
+
+
+exports.ABSOLUTE_MAX_CURVE_POINTS = ABSOLUTE_MAX_CURVE_POINTS; exports.ABSOLUTE_MAX_PREFAB_SLOTS = ABSOLUTE_MAX_PREFAB_SLOTS; exports.CONFIG_SEED = CONFIG_SEED; exports.CONFIG_SIZE = CONFIG_SIZE; exports.CURVE_META_SEED = CURVE_META_SEED; exports.CURVE_META_SIZE = CURVE_META_SIZE; exports.CURVE_POINT_LEN = CURVE_POINT_LEN; exports.CURVE_PREFABS_SEED = CURVE_PREFABS_SEED; exports.CURVE_SIDE_HEADER = CURVE_SIDE_HEADER; exports.CURVE_UPDATES_SEED = CURVE_UPDATES_SEED; exports.CURVE_UPDATES_SIZE = CURVE_UPDATES_SIZE; exports.CURVE_UPDATE_OP_SIZE = CURVE_UPDATE_OP_SIZE; exports.CurveType = CurveType; exports.CurveUpdateOpKind = CurveUpdateOpKind; exports.CurveXMode = CurveXMode; exports.DEFAULT_MAX_CURVE_POINTS = DEFAULT_MAX_CURVE_POINTS; exports.DEFAULT_MAX_PREFAB_SLOTS = DEFAULT_MAX_PREFAB_SLOTS; exports.Discriminator = Discriminator; exports.FEE_CONFIG_SEED = FEE_CONFIG_SEED; exports.FEE_CONFIG_SIZE = FEE_CONFIG_SIZE; exports.HADRON_PROGRAM_ID = HADRON_PROGRAM_ID; exports.Hadron = Hadron; exports.HadronOrderbook = HadronOrderbook; exports.Interpolation = Interpolation; exports.MAX_CURVE_UPDATE_OPS = MAX_CURVE_UPDATE_OPS; exports.MAX_SETCURVE_POINTS = MAX_SETCURVE_POINTS; exports.MIDPRICE_ORACLE_SEED = MIDPRICE_ORACLE_SEED; exports.MIDPRICE_ORACLE_SIZE = MIDPRICE_ORACLE_SIZE; exports.OracleMode = OracleMode; exports.POINT_DATA_SIZE = POINT_DATA_SIZE; exports.PoolState = PoolState; exports.Q32_ONE = Q32_ONE; exports.RiskMode = RiskMode; exports.SPREAD_CONFIG_SEED = SPREAD_CONFIG_SEED; exports.Side = Side; exports.buildAcceptAuthority = buildAcceptAuthority; exports.buildAllocateCurvePrefabs = buildAllocateCurvePrefabs; exports.buildApplyCurveUpdates = buildApplyCurveUpdates; exports.buildClosePool = buildClosePool; exports.buildDeposit = buildDeposit; exports.buildInitialize = buildInitialize; exports.buildInitializeFeeConfig = buildInitializeFeeConfig; exports.buildInitializeSpreadConfig = buildInitializeSpreadConfig; exports.buildNominateAuthority = buildNominateAuthority; exports.buildRotateFeeAdmin = buildRotateFeeAdmin; exports.buildSetCurve = buildSetCurve; exports.buildSetCurveBoth = buildSetCurveBoth; exports.buildSetPoolState = buildSetPoolState; exports.buildSetQuotingAuthority = buildSetQuotingAuthority; exports.buildSetRiskCurve = buildSetRiskCurve; exports.buildSetRiskCurveAbsolute = buildSetRiskCurveAbsolute; exports.buildSetRiskCurveAbsoluteBoth = buildSetRiskCurveAbsoluteBoth; exports.buildSetRiskCurveBoth = buildSetRiskCurveBoth; exports.buildSubmitCurveUpdates = buildSubmitCurveUpdates; exports.buildSwapExactIn = buildSwapExactIn; exports.buildSwitchPriceCurve = buildSwitchPriceCurve; exports.buildSwitchRiskCurve = buildSwitchRiskCurve; exports.buildUpdateBaseSpread = buildUpdateBaseSpread; exports.buildUpdateDeltaStaleness = buildUpdateDeltaStaleness; exports.buildUpdateFeeConfig = buildUpdateFeeConfig; exports.buildUpdateMidprice = buildUpdateMidprice; exports.buildUpdateMidpriceAndBaseSpread = buildUpdateMidpriceAndBaseSpread; exports.buildUpdateSpreadConfig = buildUpdateSpreadConfig; exports.buildWithdraw = buildWithdraw; exports.curvePrefabsSize = curvePrefabsSize; exports.decodeActiveCurves = decodeActiveCurves; exports.decodeConfig = decodeConfig; exports.decodeCurveMeta = decodeCurveMeta; exports.decodeCurveSide = decodeCurveSide; exports.decodeCurveUpdates = decodeCurveUpdates; exports.decodeFeeConfig = decodeFeeConfig; exports.decodeMidpriceOracle = decodeMidpriceOracle; exports.decodeSpreadConfig = decodeSpreadConfig; exports.derivePoolAddresses = derivePoolAddresses; exports.fromQ32 = fromQ32; exports.getConfigAddress = getConfigAddress; exports.getCurveMetaAddress = getCurveMetaAddress; exports.getCurvePrefabsAddress = getCurvePrefabsAddress; exports.getCurveUpdatesAddress = getCurveUpdatesAddress; exports.getFeeConfigAddress = getFeeConfigAddress; exports.getMidpriceOracleAddress = getMidpriceOracleAddress; exports.getOrCreateAta = getOrCreateAta; exports.getSpreadConfigAddress = getSpreadConfigAddress; exports.isSlotInitialized = isSlotInitialized; exports.pctToQ32 = pctToQ32; exports.spreadBpsToQ32 = spreadBpsToQ32; exports.spreadQ32ToBps = spreadQ32ToBps; exports.toQ32 = toQ32;
 //# sourceMappingURL=index.js.map