@drift-labs/sdk 2.71.0-beta.0 → 2.71.0-beta.2

package/src/idl/drift.json

@@ -2039,6 +2039,27 @@
         }
       ]
     },
+    {
+      "name": "updatePrelaunchOracle",
+      "accounts": [
+        {
+          "name": "state",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "perpMarket",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "oracle",
+          "isMut": true,
+          "isSigner": false
+        }
+      ],
+      "args": []
+    },
     {
       "name": "updatePerpBidAskTwap",
       "accounts": [
@@ -4894,6 +4915,72 @@
           }
         }
       ]
+    },
+    {
+      "name": "initializePrelaunchOracle",
+      "accounts": [
+        {
+          "name": "admin",
+          "isMut": true,
+          "isSigner": true
+        },
+        {
+          "name": "prelaunchOracle",
+          "isMut": true,
+          "isSigner": false
+        },
+        {
+          "name": "state",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "rent",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "systemProgram",
+          "isMut": false,
+          "isSigner": false
+        }
+      ],
+      "args": [
+        {
+          "name": "params",
+          "type": {
+            "defined": "PrelaunchOracleParams"
+          }
+        }
+      ]
+    },
+    {
+      "name": "updatePrelaunchOracleParams",
+      "accounts": [
+        {
+          "name": "admin",
+          "isMut": true,
+          "isSigner": true
+        },
+        {
+          "name": "prelaunchOracle",
+          "isMut": true,
+          "isSigner": false
+        },
+        {
+          "name": "state",
+          "isMut": false,
+          "isSigner": false
+        }
+      ],
+      "args": [
+        {
+          "name": "params",
+          "type": {
+            "defined": "PrelaunchOracleParams"
+          }
+        }
+      ]
     }
   ],
   "accounts": [
@@ -5122,6 +5209,47 @@
         ]
       }
     },
+    {
+      "name": "PrelaunchOracle",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "price",
+            "type": "i64"
+          },
+          {
+            "name": "maxPrice",
+            "type": "i64"
+          },
+          {
+            "name": "confidence",
+            "type": "u64"
+          },
+          {
+            "name": "lastUpdateSlot",
+            "type": "u64"
+          },
+          {
+            "name": "ammLastUpdateSlot",
+            "type": "u64"
+          },
+          {
+            "name": "perpMarketIndex",
+            "type": "u16"
+          },
+          {
+            "name": "padding",
+            "type": {
+              "array": [
+                "u8",
+                70
+              ]
+            }
+          }
+        ]
+      }
+    },
     {
       "name": "PerpMarket",
       "type": {
@@ -6340,6 +6468,9 @@
           },
           {
             "name": "lpShares",
+            "docs": [
+              "precision: AMM_RESERVE_PRECISION"
+            ],
             "type": "u64"
           },
           {
@@ -6356,10 +6487,16 @@
           },
           {
             "name": "liquidatorFee",
+            "docs": [
+              "precision: QUOTE_PRECISION"
+            ],
             "type": "u64"
           },
           {
             "name": "ifFee",
+            "docs": [
+              "precision: QUOTE_PRECISION"
+            ],
             "type": "u64"
           }
         ]
@@ -6392,10 +6529,16 @@
           },
           {
             "name": "liabilityTransfer",
+            "docs": [
+              "precision: token mint precision"
+            ],
             "type": "u128"
           },
           {
             "name": "ifFee",
+            "docs": [
+              "precision: token mint precision"
+            ],
             "type": "u64"
           }
         ]
@@ -6564,6 +6707,9 @@
           },
           {
             "name": "lastOracleDelay",
+            "docs": [
+              "number of slots since last update"
+            ],
             "type": "i64"
           },
           {
@@ -6582,6 +6728,9 @@
           },
           {
             "name": "lastOraclePriceTwapTs",
+            "docs": [
+              "unix_timestamp of last snapshot"
+            ],
             "type": "i64"
           }
         ]
@@ -6622,11 +6771,38 @@
           },
           {
             "name": "lastIndexPriceTwapTs",
+            "docs": [
+              "unix_timestamp of last snapshot"
+            ],
             "type": "i64"
           }
         ]
       }
     },
+    {
+      "name": "PrelaunchOracleParams",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "perpMarketIndex",
+            "type": "u16"
+          },
+          {
+            "name": "price",
+            "type": {
+              "option": "i64"
+            }
+          },
+          {
+            "name": "maxPrice",
+            "type": {
+              "option": "i64"
+            }
+          }
+        ]
+      }
+    },
     {
       "name": "OrderParams",
       "type": {
@@ -6931,14 +7107,16 @@
           {
             "name": "baseAssetAmountPerLp",
             "docs": [
-              "accumulated base asset amount since inception per lp share"
+              "accumulated base asset amount since inception per lp share",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "quoteAssetAmountPerLp",
             "docs": [
-              "accumulated quote asset amount since inception per lp share"
+              "accumulated quote asset amount since inception per lp share",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
@@ -6954,14 +7132,16 @@
           {
             "name": "baseAssetReserve",
             "docs": [
-              "`x` reserves for constant product mm formula (x * y = k)"
+              "`x` reserves for constant product mm formula (x * y = k)",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "quoteAssetReserve",
             "docs": [
-              "`y` reserves for constant product mm formula (x * y = k)"
+              "`y` reserves for constant product mm formula (x * y = k)",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
@@ -6969,189 +7149,216 @@
             "name": "concentrationCoef",
             "docs": [
               "determines how close the min/max base asset reserve sit vs base reserves",
-              "allow for decreasing slippage without increasing liquidity and v.v."
+              "allow for decreasing slippage without increasing liquidity and v.v.",
+              "precision: PERCENTAGE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "minBaseAssetReserve",
             "docs": [
-              "minimum base_asset_reserve allowed before AMM is unavailable"
+              "minimum base_asset_reserve allowed before AMM is unavailable",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "maxBaseAssetReserve",
             "docs": [
-              "maximum base_asset_reserve allowed before AMM is unavailable"
+              "maximum base_asset_reserve allowed before AMM is unavailable",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "sqrtK",
             "docs": [
-              "`sqrt(k)` in constant product mm formula (x * y = k). stored to avoid drift caused by integer math issues"
+              "`sqrt(k)` in constant product mm formula (x * y = k). stored to avoid drift caused by integer math issues",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "pegMultiplier",
             "docs": [
-              "normalizing numerical factor for y, its use offers lowest slippage in cp-curve when market is balanced"
+              "normalizing numerical factor for y, its use offers lowest slippage in cp-curve when market is balanced",
+              "precision: PEG_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "terminalQuoteAssetReserve",
             "docs": [
-              "y when market is balanced. stored to save computation"
+              "y when market is balanced. stored to save computation",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "baseAssetAmountLong",
             "docs": [
-              "tracks number of total longs in market (regardless of counterparty)"
+              "always non-negative. tracks number of total longs in market (regardless of counterparty)",
+              "precision: BASE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "baseAssetAmountShort",
             "docs": [
-              "tracks number of total shorts in market (regardless of counterparty)"
+              "always non-positive. tracks number of total shorts in market (regardless of counterparty)",
+              "precision: BASE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "baseAssetAmountWithAmm",
             "docs": [
-              "tracks net position (longs-shorts) in market with AMM as counterparty"
+              "tracks net position (longs-shorts) in market with AMM as counterparty",
+              "precision: BASE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "baseAssetAmountWithUnsettledLp",
             "docs": [
-              "tracks net position (longs-shorts) in market with LPs as counterparty"
+              "tracks net position (longs-shorts) in market with LPs as counterparty",
+              "precision: BASE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "maxOpenInterest",
             "docs": [
-              "max allowed open interest, blocks trades that breach this value"
+              "max allowed open interest, blocks trades that breach this value",
+              "precision: BASE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "quoteAssetAmount",
             "docs": [
-              "sum of all user's perp quote_asset_amount in market"
+              "sum of all user's perp quote_asset_amount in market",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "quoteEntryAmountLong",
             "docs": [
-              "sum of all long user's quote_entry_amount in market"
+              "sum of all long user's quote_entry_amount in market",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "quoteEntryAmountShort",
             "docs": [
-              "sum of all short user's quote_entry_amount in market"
+              "sum of all short user's quote_entry_amount in market",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "quoteBreakEvenAmountLong",
             "docs": [
-              "sum of all long user's quote_break_even_amount in market"
+              "sum of all long user's quote_break_even_amount in market",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "quoteBreakEvenAmountShort",
             "docs": [
-              "sum of all short user's quote_break_even_amount in market"
+              "sum of all short user's quote_break_even_amount in market",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "userLpShares",
             "docs": [
-              "total user lp shares of sqrt_k (protocol owned liquidity = sqrt_k - last_funding_rate)"
+              "total user lp shares of sqrt_k (protocol owned liquidity = sqrt_k - last_funding_rate)",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "lastFundingRate",
             "docs": [
-              "last funding rate in this perp market (unit is quote per base)"
+              "last funding rate in this perp market (unit is quote per base)",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i64"
           },
           {
             "name": "lastFundingRateLong",
             "docs": [
-              "last funding rate for longs in this perp market (unit is quote per base)"
+              "last funding rate for longs in this perp market (unit is quote per base)",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i64"
           },
           {
             "name": "lastFundingRateShort",
             "docs": [
-              "last funding rate for shorts in this perp market (unit is quote per base)"
+              "last funding rate for shorts in this perp market (unit is quote per base)",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i64"
           },
           {
             "name": "last24hAvgFundingRate",
             "docs": [
-              "estimate of last 24h of funding rate perp market (unit is quote per base)"
+              "estimate of last 24h of funding rate perp market (unit is quote per base)",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i64"
           },
           {
             "name": "totalFee",
             "docs": [
-              "total fees collected by this perp market"
+              "total fees collected by this perp market",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "totalMmFee",
             "docs": [
-              "total fees collected by the vAMM's bid/ask spread"
+              "total fees collected by the vAMM's bid/ask spread",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "totalExchangeFee",
             "docs": [
-              "total fees collected by exchange fee schedule"
+              "total fees collected by exchange fee schedule",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "totalFeeMinusDistributions",
             "docs": [
-              "total fees minus any recognized upnl and pool withdraws"
+              "total fees minus any recognized upnl and pool withdraws",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i128"
           },
           {
             "name": "totalFeeWithdrawn",
             "docs": [
-              "sum of all fees from fee pool withdrawn to revenue pool"
+              "sum of all fees from fee pool withdrawn to revenue pool",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "totalLiquidationFee",
             "docs": [
-              "all fees collected by market for liquidations"
+              "all fees collected by market for liquidations",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "u128"
           },
@@ -7179,28 +7386,32 @@
           {
             "name": "askBaseAssetReserve",
             "docs": [
-              "transformed base_asset_reserve for users going long"
+              "transformed base_asset_reserve for users going long",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "askQuoteAssetReserve",
             "docs": [
-              "transformed quote_asset_reserve for users going long"
+              "transformed quote_asset_reserve for users going long",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "bidBaseAssetReserve",
             "docs": [
-              "transformed base_asset_reserve for users going short"
+              "transformed base_asset_reserve for users going short",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
           {
             "name": "bidQuoteAssetReserve",
             "docs": [
-              "transformed quote_asset_reserve for users going short"
+              "transformed quote_asset_reserve for users going short",
+              "precision: AMM_RESERVE_PRECISION"
             ],
             "type": "u128"
           },
@@ -8690,6 +8901,9 @@
           },
           {
             "name": "PythStableCoin"
+          },
+          {
+            "name": "Prelaunch"
           }
         ]
       }
@@ -8747,6 +8961,9 @@
           },
           {
             "name": "SettlePnlWithPosition"
+          },
+          {
+            "name": "Liquidation"
           }
         ]
       }
@@ -8764,6 +8981,9 @@
           },
           {
             "name": "Withdraw"
+          },
+          {
+            "name": "Liquidation"
           }
         ]
       }

package/src/oracles/oracleClientCache.ts

@@ -2,18 +2,23 @@ import { OracleClient } from './types';
 import { OracleSource } from '../types';
 import { getOracleClient } from '../factory/oracleClient';
 import { Connection } from '@solana/web3.js';
+import { Program } from '@coral-xyz/anchor';
 
 export class OracleClientCache {
 	cache = new Map<string, OracleClient>();
 	public constructor() {}
 
-	public get(oracleSource: OracleSource, connection: Connection) {
+	public get(
+		oracleSource: OracleSource,
+		connection: Connection,
+		program: Program
+	) {
 		const key = Object.keys(oracleSource)[0];
 		if (this.cache.has(key)) {
 			return this.cache.get(key);
 		}
 
-		const client = getOracleClient(oracleSource, connection);
+		const client = getOracleClient(oracleSource, connection, program);
 		this.cache.set(key, client);
 		return client;
 	}

package/src/oracles/prelaunchOracleClient.ts

@@ -0,0 +1,36 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { OracleClient, OraclePriceData } from './types';
+import { Program } from '@coral-xyz/anchor';
+import { PrelaunchOracle } from '../types';
+
+export class PrelaunchOracleClient implements OracleClient {
+	private connection: Connection;
+	private program: Program;
+
+	public constructor(connection: Connection, program: Program) {
+		this.connection = connection;
+		this.program = program;
+	}
+
+	public async getOraclePriceData(
+		pricePublicKey: PublicKey
+	): Promise<OraclePriceData> {
+		const accountInfo = await this.connection.getAccountInfo(pricePublicKey);
+		return this.getOraclePriceDataFromBuffer(accountInfo.data);
+	}
+
+	public getOraclePriceDataFromBuffer(buffer: Buffer): OraclePriceData {
+		const prelaunchOracle =
+			this.program.account.prelaunchOracle.coder.accounts.decodeUnchecked(
+				'PrelaunchOracle',
+				buffer
+			) as PrelaunchOracle;
+
+		return {
+			price: prelaunchOracle.price,
+			slot: prelaunchOracle.ammLastUpdateSlot,
+			confidence: prelaunchOracle.confidence,
+			hasSufficientNumberOfDataPoints: true,
+		};
+	}
+}

package/src/types.ts

@@ -96,6 +96,7 @@ export class OracleSource {
 	// static readonly SWITCHBOARD = { switchboard: {} };
 	static readonly QUOTE_ASSET = { quoteAsset: {} };
 	static readonly PYTH_STABLE_COIN = { pythStableCoin: {} };
+	static readonly Prelaunch = { prelaunch: {} };
 }
 
 export class OrderType {
@@ -1060,6 +1061,15 @@ export type OracleGuardRails = {
 	};
 };
 
+export type PrelaunchOracle = {
+	price: BN;
+	maxPrice: BN;
+	confidence: BN;
+	ammLastUpdateSlot: BN;
+	lastUpdateSlot: BN;
+	perpMarketIndex: number;
+};
+
 export type MarginCategory = 'Initial' | 'Maintenance';
 
 export type InsuranceFundStake = {