@drift-labs/sdk 2.30.0 → 2.31.0-beta.0

package/lib/adminClient.d.ts

@@ -19,6 +19,7 @@ export declare class AdminClient extends DriftClient {
     depositIntoPerpMarketFeePool(perpMarketIndex: number, amount: BN, sourceVault: PublicKey): Promise<TransactionSignature>;
     updateAdmin(admin: PublicKey): Promise<TransactionSignature>;
     updatePerpMarketCurveUpdateIntensity(perpMarketIndex: number, curveUpdateIntensity: number): Promise<TransactionSignature>;
+    updatePerpMarketTargetBaseAssetAmountPerLp(perpMarketIndex: number, targetBaseAssetAmountPerLP: number): Promise<TransactionSignature>;
     updatePerpMarketMarginRatio(perpMarketIndex: number, marginRatioInitial: number, marginRatioMaintenance: number): Promise<TransactionSignature>;
     updatePerpMarketImfFactor(perpMarketIndex: number, imfFactor: number, unrealizedPnlImfFactor: number): Promise<TransactionSignature>;
     updatePerpMarketBaseSpread(perpMarketIndex: number, baseSpread: number): Promise<TransactionSignature>;

package/lib/adminClient.js

@@ -292,6 +292,15 @@ class AdminClient extends driftClient_1.DriftClient {
             },
         });
     }
+    async updatePerpMarketTargetBaseAssetAmountPerLp(perpMarketIndex, targetBaseAssetAmountPerLP) {
+        return await this.program.rpc.updatePerpMarketTargetBaseAssetAmountPerLp(targetBaseAssetAmountPerLP, {
+            accounts: {
+                admin: this.wallet.publicKey,
+                state: await this.getStatePublicKey(),
+                perpMarket: await (0, pda_1.getPerpMarketPublicKey)(this.program.programId, perpMarketIndex),
+            },
+        });
+    }
     async updatePerpMarketMarginRatio(perpMarketIndex, marginRatioInitial, marginRatioMaintenance) {
         const tx = await this.program.transaction.updatePerpMarketMarginRatio(marginRatioInitial, marginRatioMaintenance, {
             accounts: {

package/lib/idl/drift.json

@@ -1,5 +1,5 @@
 {
-    "version": "2.30.0",
+    "version": "2.31.0-beta.0",
     "name": "drift",
     "instructions": [
         {
@@ -3644,6 +3644,32 @@
                 }
             ]
         },
+        {
+            "name": "updatePerpMarketTargetBaseAssetAmountPerLp",
+            "accounts": [
+                {
+                    "name": "admin",
+                    "isMut": false,
+                    "isSigner": true
+                },
+                {
+                    "name": "state",
+                    "isMut": false,
+                    "isSigner": false
+                },
+                {
+                    "name": "perpMarket",
+                    "isMut": true,
+                    "isSigner": false
+                }
+            ],
+            "args": [
+                {
+                    "name": "targetBaseAssetAmountPerLp",
+                    "type": "i32"
+                }
+            ]
+        },
         {
             "name": "updateLpCooldownTime",
             "accounts": [
@@ -6449,7 +6475,8 @@
                     {
                         "name": "lastOracleNormalisedPrice",
                         "docs": [
-                            "the last seen oracle price partially shrunk toward the amm reserve price"
+                            "the last seen oracle price partially shrunk toward the amm reserve price",
+                            "precision: PRICE_PRECISION"
                         ],
                         "type": "i64"
                     },
@@ -6463,21 +6490,24 @@
                     {
                         "name": "lastBidPriceTwap",
                         "docs": [
-                            "average estimate of bid price over funding_period"
+                            "average estimate of bid price over funding_period",
+                            "precision: PRICE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
                         "name": "lastAskPriceTwap",
                         "docs": [
-                            "average estimate of ask price over funding_period"
+                            "average estimate of ask price over funding_period",
+                            "precision: PRICE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
                         "name": "lastMarkPriceTwap",
                         "docs": [
-                            "average estimate of (bid+ask)/2 price over funding_period"
+                            "average estimate of (bid+ask)/2 price over funding_period",
+                            "precision: PRICE_PRECISION"
                         ],
                         "type": "u64"
                     },
@@ -6499,14 +6529,15 @@
                         "name": "lastOracleConfPct",
                         "docs": [
                             "the pct size of the oracle confidence interval",
-                            "PERCENTAGE_PRECISION"
+                            "precision: PERCENTAGE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
                         "name": "netRevenueSinceLastFunding",
                         "docs": [
-                            "the total_fee_minus_distribution change since the last funding update"
+                            "the total_fee_minus_distribution change since the last funding update",
+                            "precision: QUOTE_PRECISION"
                         ],
                         "type": "i64"
                     },
@@ -6527,28 +6558,32 @@
                     {
                         "name": "orderStepSize",
                         "docs": [
-                            "the base step size (increment) of orders"
+                            "the base step size (increment) of orders",
+                            "precision: BASE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
                         "name": "orderTickSize",
                         "docs": [
-                            "the price tick size of orders"
+                            "the price tick size of orders",
+                            "precision: PRICE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
                         "name": "minOrderSize",
                         "docs": [
-                            "the minimum base size of an order"
+                            "the minimum base size of an order",
+                            "precision: BASE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
                         "name": "maxPositionSize",
                         "docs": [
-                            "the max base size a single user can have"
+                            "the max base size a single user can have",
+                            "precision: BASE_PRECISION"
                         ],
                         "type": "u64"
                     },
@@ -6584,14 +6619,16 @@
                     {
                         "name": "markStd",
                         "docs": [
-                            "estimate of standard deviation of the fill (mark) prices"
+                            "estimate of standard deviation of the fill (mark) prices",
+                            "precision: PRICE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
                         "name": "oracleStd",
                         "docs": [
-                            "estimate of standard deviation of the oracle price at each update"
+                            "estimate of standard deviation of the oracle price at each update",
+                            "precision: PRICE_PRECISION"
                         ],
                         "type": "u64"
                     },
@@ -6668,7 +6705,8 @@
                     {
                         "name": "ammJitIntensity",
                         "docs": [
-                            "the jit intensity of AMM. larger intensity means larger participation in jit. 0 means no jit participation."
+                            "the jit intensity of AMM. larger intensity means larger participation in jit. 0 means no jit participation.",
+                            "(0, 100] is intensity for protocol-owned AMM. (100, 200] is intensity for user LP-owned AMM."
                         ],
                         "type": "u8"
                     },
@@ -6688,12 +6726,20 @@
                         ],
                         "type": "bool"
                     },
+                    {
+                        "name": "targetBaseAssetAmountPerLp",
+                        "docs": [
+                            "the target value for `base_asset_amount_per_lp`, used during AMM JIT with LP split",
+                            "precision: BASE_PRECISION"
+                        ],
+                        "type": "i32"
+                    },
                     {
                         "name": "padding",
                         "type": {
                             "array": [
                                 "u8",
-                                48
+                                44
                             ]
                         }
                     }
@@ -7703,6 +7749,12 @@
                     },
                     {
                         "name": "OrderFillWithPhoenix"
+                    },
+                    {
+                        "name": "OrderFilledWithAMMJitLPSplit"
+                    },
+                    {
+                        "name": "OrderFilledWithLPJit"
                     }
                 ]
             }
@@ -7919,6 +7971,23 @@
                 ]
             }
         },
+        {
+            "name": "AMMLiquiditySplit",
+            "type": {
+                "kind": "enum",
+                "variants": [
+                    {
+                        "name": "ProtocolOwned"
+                    },
+                    {
+                        "name": "LPOwned"
+                    },
+                    {
+                        "name": "Shared"
+                    }
+                ]
+            }
+        },
         {
             "name": "SpotBalanceType",
             "type": {

package/lib/types.d.ts

@@ -218,6 +218,12 @@ export declare class OrderActionExplanation {
     static readonly ORDER_FILLED_WITH_AMM_JIT: {
         orderFilledWithAmmJit: {};
     };
+    static readonly ORDER_FILLED_WITH_AMM_JIT_LP_SPLIT: {
+        orderFilledWithAmmJitLpSplit: {};
+    };
+    static readonly ORDER_FILLED_WITH_LP_JIT: {
+        orderFilledWithAmmJitLpSplit: {};
+    };
     static readonly ORDER_FILLED_WITH_MATCH: {
         orderFilledWithMatch: {};
     };
@@ -786,6 +792,7 @@ export type AMM = {
     maxSpread: number;
     baseAssetAmountPerLp: BN;
     quoteAssetAmountPerLp: BN;
+    targetBaseAssetAmountPerLp: number;
     ammJitIntensity: number;
     maxOpenInterest: BN;
     maxBaseAssetReserve: BN;

package/lib/types.js

@@ -134,6 +134,12 @@ OrderActionExplanation.ORDER_FILLED_WITH_AMM = {
 OrderActionExplanation.ORDER_FILLED_WITH_AMM_JIT = {
     orderFilledWithAmmJit: {},
 };
+OrderActionExplanation.ORDER_FILLED_WITH_AMM_JIT_LP_SPLIT = {
+    orderFilledWithAmmJitLpSplit: {},
+};
+OrderActionExplanation.ORDER_FILLED_WITH_LP_JIT = {
+    orderFilledWithAmmJitLpSplit: {},
+};
 OrderActionExplanation.ORDER_FILLED_WITH_MATCH = {
     orderFilledWithMatch: {},
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@drift-labs/sdk",
-	"version": "2.30.0",
+	"version": "2.31.0-beta.0",
 	"main": "lib/index.js",
 	"types": "lib/index.d.ts",
 	"author": "crispheaney",

package/src/adminClient.ts

@@ -544,6 +544,25 @@ export class AdminClient extends DriftClient {
 		);
 	}
 
+	public async updatePerpMarketTargetBaseAssetAmountPerLp(
+		perpMarketIndex: number,
+		targetBaseAssetAmountPerLP: number
+	): Promise<TransactionSignature> {
+		return await this.program.rpc.updatePerpMarketTargetBaseAssetAmountPerLp(
+			targetBaseAssetAmountPerLP,
+			{
+				accounts: {
+					admin: this.wallet.publicKey,
+					state: await this.getStatePublicKey(),
+					perpMarket: await getPerpMarketPublicKey(
+						this.program.programId,
+						perpMarketIndex
+					),
+				},
+			}
+		);
+	}
+
 	public async updatePerpMarketMarginRatio(
 		perpMarketIndex: number,
 		marginRatioInitial: number,

package/src/idl/drift.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.30.0",
+  "version": "2.31.0-beta.0",
   "name": "drift",
   "instructions": [
     {
@@ -3644,6 +3644,32 @@
         }
       ]
     },
+    {
+      "name": "updatePerpMarketTargetBaseAssetAmountPerLp",
+      "accounts": [
+        {
+          "name": "admin",
+          "isMut": false,
+          "isSigner": true
+        },
+        {
+          "name": "state",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "perpMarket",
+          "isMut": true,
+          "isSigner": false
+        }
+      ],
+      "args": [
+        {
+          "name": "targetBaseAssetAmountPerLp",
+          "type": "i32"
+        }
+      ]
+    },
     {
       "name": "updateLpCooldownTime",
       "accounts": [
@@ -6449,7 +6475,8 @@
           {
             "name": "lastOracleNormalisedPrice",
             "docs": [
-              "the last seen oracle price partially shrunk toward the amm reserve price"
+              "the last seen oracle price partially shrunk toward the amm reserve price",
+              "precision: PRICE_PRECISION"
             ],
             "type": "i64"
           },
@@ -6463,21 +6490,24 @@
           {
             "name": "lastBidPriceTwap",
             "docs": [
-              "average estimate of bid price over funding_period"
+              "average estimate of bid price over funding_period",
+              "precision: PRICE_PRECISION"
             ],
             "type": "u64"
           },
           {
             "name": "lastAskPriceTwap",
             "docs": [
-              "average estimate of ask price over funding_period"
+              "average estimate of ask price over funding_period",
+              "precision: PRICE_PRECISION"
             ],
             "type": "u64"
           },
           {
             "name": "lastMarkPriceTwap",
             "docs": [
-              "average estimate of (bid+ask)/2 price over funding_period"
+              "average estimate of (bid+ask)/2 price over funding_period",
+              "precision: PRICE_PRECISION"
             ],
             "type": "u64"
           },
@@ -6499,14 +6529,15 @@
             "name": "lastOracleConfPct",
             "docs": [
               "the pct size of the oracle confidence interval",
-              "PERCENTAGE_PRECISION"
+              "precision: PERCENTAGE_PRECISION"
             ],
             "type": "u64"
           },
           {
             "name": "netRevenueSinceLastFunding",
             "docs": [
-              "the total_fee_minus_distribution change since the last funding update"
+              "the total_fee_minus_distribution change since the last funding update",
+              "precision: QUOTE_PRECISION"
             ],
             "type": "i64"
           },
@@ -6527,28 +6558,32 @@
           {
             "name": "orderStepSize",
             "docs": [
-              "the base step size (increment) of orders"
+              "the base step size (increment) of orders",
+              "precision: BASE_PRECISION"
             ],
             "type": "u64"
           },
           {
             "name": "orderTickSize",
             "docs": [
-              "the price tick size of orders"
+              "the price tick size of orders",
+              "precision: PRICE_PRECISION"
             ],
             "type": "u64"
           },
           {
             "name": "minOrderSize",
             "docs": [
-              "the minimum base size of an order"
+              "the minimum base size of an order",
+              "precision: BASE_PRECISION"
             ],
             "type": "u64"
           },
           {
             "name": "maxPositionSize",
             "docs": [
-              "the max base size a single user can have"
+              "the max base size a single user can have",
+              "precision: BASE_PRECISION"
             ],
             "type": "u64"
           },
@@ -6584,14 +6619,16 @@
           {
             "name": "markStd",
             "docs": [
-              "estimate of standard deviation of the fill (mark) prices"
+              "estimate of standard deviation of the fill (mark) prices",
+              "precision: PRICE_PRECISION"
             ],
             "type": "u64"
           },
           {
             "name": "oracleStd",
             "docs": [
-              "estimate of standard deviation of the oracle price at each update"
+              "estimate of standard deviation of the oracle price at each update",
+              "precision: PRICE_PRECISION"
             ],
             "type": "u64"
           },
@@ -6668,7 +6705,8 @@
           {
             "name": "ammJitIntensity",
             "docs": [
-              "the jit intensity of AMM. larger intensity means larger participation in jit. 0 means no jit participation."
+              "the jit intensity of AMM. larger intensity means larger participation in jit. 0 means no jit participation.",
+              "(0, 100] is intensity for protocol-owned AMM. (100, 200] is intensity for user LP-owned AMM."
             ],
             "type": "u8"
           },
@@ -6688,12 +6726,20 @@
             ],
             "type": "bool"
           },
+          {
+            "name": "targetBaseAssetAmountPerLp",
+            "docs": [
+              "the target value for `base_asset_amount_per_lp`, used during AMM JIT with LP split",
+              "precision: BASE_PRECISION"
+            ],
+            "type": "i32"
+          },
           {
             "name": "padding",
             "type": {
               "array": [
                 "u8",
-                48
+                44
               ]
             }
           }
@@ -7703,6 +7749,12 @@
           },
           {
             "name": "OrderFillWithPhoenix"
+          },
+          {
+            "name": "OrderFilledWithAMMJitLPSplit"
+          },
+          {
+            "name": "OrderFilledWithLPJit"
           }
         ]
       }
@@ -7919,6 +7971,23 @@
         ]
       }
     },
+    {
+      "name": "AMMLiquiditySplit",
+      "type": {
+        "kind": "enum",
+        "variants": [
+          {
+            "name": "ProtocolOwned"
+          },
+          {
+            "name": "LPOwned"
+          },
+          {
+            "name": "Shared"
+          }
+        ]
+      }
+    },
     {
       "name": "SpotBalanceType",
       "type": {

package/src/types.ts

@@ -133,6 +133,12 @@ export class OrderActionExplanation {
 	static readonly ORDER_FILLED_WITH_AMM_JIT = {
 		orderFilledWithAmmJit: {},
 	};
+	static readonly ORDER_FILLED_WITH_AMM_JIT_LP_SPLIT = {
+		orderFilledWithAmmJitLpSplit: {},
+	};
+	static readonly ORDER_FILLED_WITH_LP_JIT = {
+		orderFilledWithAmmJitLpSplit: {},
+	};
 	static readonly ORDER_FILLED_WITH_MATCH = {
 		orderFilledWithMatch: {},
 	};
@@ -730,6 +736,7 @@ export type AMM = {
 
 	baseAssetAmountPerLp: BN;
 	quoteAssetAmountPerLp: BN;
+	targetBaseAssetAmountPerLp: number;
 
 	ammJitIntensity: number;
 	maxOpenInterest: BN;

package/tests/dlob/helpers.ts

@@ -114,6 +114,7 @@ export const mockAMM: AMM = {
 	totalSocialLoss: new BN(0),
 	baseAssetAmountPerLp: new BN(0),
 	quoteAssetAmountPerLp: new BN(0),
+	targetBaseAssetAmountPerLp: 0,
 
 	quoteBreakEvenAmountLong: new BN(0),
 	quoteBreakEvenAmountShort: new BN(0),