@drift-labs/sdk 2.142.0-beta.9 → 2.142.0

package/lib/browser/accounts/grpcMultiAccountSubscriber.js

@@ -31,13 +31,27 @@ const web3_js_1 = require("@solana/web3.js");
 const Buffer = __importStar(require("buffer"));
 const bs58_1 = __importDefault(require("bs58"));
 const grpc_1 = require("../isomorphic/grpc");
+function commitmentLevelToCommitment(commitmentLevel) {
+    switch (commitmentLevel) {
+        case grpc_1.CommitmentLevel.PROCESSED:
+            return 'processed';
+        case grpc_1.CommitmentLevel.CONFIRMED:
+            return 'confirmed';
+        case grpc_1.CommitmentLevel.FINALIZED:
+            return 'finalized';
+        default:
+            return 'confirmed';
+    }
+}
 class grpcMultiAccountSubscriber {
-    constructor(client, commitmentLevel, accountName, program, decodeBuffer, resubOpts, onUnsubscribe) {
+    constructor(client, commitmentLevel, accountName, program, decodeBuffer, resubOpts, onUnsubscribe, accountPropsMap) {
         this.isUnsubscribing = false;
         this.receivingData = false;
         this.subscribedAccounts = new Set();
         this.onChangeMap = new Map();
         this.dataMap = new Map();
+        this.accountPropsMap = new Map();
+        this.bufferMap = new Map();
         this.client = client;
         this.commitmentLevel = commitmentLevel;
         this.accountName = accountName;
@@ -45,8 +59,9 @@ class grpcMultiAccountSubscriber {
         this.decodeBufferFn = decodeBuffer;
         this.resubOpts = resubOpts;
         this.onUnsubscribe = onUnsubscribe;
+        this.accountPropsMap = accountPropsMap;
     }
-    static async create(grpcConfigs, accountName, program, decodeBuffer, resubOpts, clientProp, onUnsubscribe) {
+    static async create(grpcConfigs, accountName, program, decodeBuffer, resubOpts, clientProp, onUnsubscribe, accountPropsMap) {
         var _a, _b;
         const client = clientProp
             ? clientProp
@@ -54,7 +69,7 @@ class grpcMultiAccountSubscriber {
         const commitmentLevel = 
         // @ts-ignore :: isomorphic exported enum fails typescript but will work at runtime
         (_b = grpcConfigs.commitmentLevel) !== null && _b !== void 0 ? _b : grpc_1.CommitmentLevel.CONFIRMED;
-        return new grpcMultiAccountSubscriber(client, commitmentLevel, accountName, program, decodeBuffer, resubOpts, onUnsubscribe);
+        return new grpcMultiAccountSubscriber(client, commitmentLevel, accountName, program, decodeBuffer, resubOpts, onUnsubscribe, accountPropsMap);
     }
     setAccountData(accountPubkey, data, slot) {
         this.dataMap.set(accountPubkey, { data, slot });
@@ -65,7 +80,60 @@ class grpcMultiAccountSubscriber {
     getAccountDataMap() {
         return this.dataMap;
     }
+    async fetch() {
+        var _a;
+        try {
+            // Chunk account IDs into groups of 100 (getMultipleAccounts limit)
+            const chunkSize = 100;
+            const chunks = [];
+            const accountIds = Array.from(this.subscribedAccounts.values());
+            for (let i = 0; i < accountIds.length; i += chunkSize) {
+                chunks.push(accountIds.slice(i, i + chunkSize));
+            }
+            // Process all chunks concurrently
+            await Promise.all(chunks.map(async (chunk) => {
+                const accountAddresses = chunk.map((accountId) => new web3_js_1.PublicKey(accountId));
+                const rpcResponseAndContext = await this.program.provider.connection.getMultipleAccountsInfoAndContext(accountAddresses, {
+                    commitment: commitmentLevelToCommitment(this.commitmentLevel),
+                });
+                const rpcResponse = rpcResponseAndContext.value;
+                const currentSlot = rpcResponseAndContext.context.slot;
+                for (let i = 0; i < chunk.length; i++) {
+                    const accountId = chunk[i];
+                    const accountInfo = rpcResponse[i];
+                    if (accountInfo) {
+                        const prev = this.bufferMap.get(accountId);
+                        const newBuffer = accountInfo.data;
+                        if (prev && currentSlot < prev.slot) {
+                            continue;
+                        }
+                        if (prev &&
+                            prev.buffer &&
+                            newBuffer &&
+                            newBuffer.equals(prev.buffer)) {
+                            continue;
+                        }
+                        this.bufferMap.set(accountId, {
+                            buffer: newBuffer,
+                            slot: currentSlot,
+                        });
+                        const accountDecoded = this.program.coder.accounts.decode(this.capitalize(this.accountName), newBuffer);
+                        this.setAccountData(accountId, accountDecoded, currentSlot);
+                    }
+                }
+            }));
+        }
+        catch (error) {
+            if ((_a = this.resubOpts) === null || _a === void 0 ? void 0 : _a.logResubMessages) {
+                console.log(`[${this.accountName}] grpcMultiAccountSubscriber error fetching accounts:`, error);
+            }
+        }
+    }
     async subscribe(accounts, onChange) {
+        var _a;
+        if ((_a = this.resubOpts) === null || _a === void 0 ? void 0 : _a.logResubMessages) {
+            console.log(`[${this.accountName}] grpcMultiAccountSubscriber subscribe`);
+        }
         if (this.listenerId != null || this.isUnsubscribing) {
             return;
         }
@@ -73,9 +141,9 @@ class grpcMultiAccountSubscriber {
         for (const pk of accounts) {
             const key = pk.toBase58();
             this.subscribedAccounts.add(key);
-            this.onChangeMap.set(key, (data, ctx, buffer) => {
+            this.onChangeMap.set(key, (data, ctx, buffer, accountProps) => {
                 this.setAccountData(key, data, ctx.slot);
-                onChange(new web3_js_1.PublicKey(key), data, ctx, buffer);
+                onChange(new web3_js_1.PublicKey(key), data, ctx, buffer, accountProps);
             });
         }
         this.stream =
@@ -98,7 +166,7 @@ class grpcMultiAccountSubscriber {
             transactionsStatus: {},
         };
         this.stream.on('data', (chunk) => {
-            var _a;
+            var _a, _b;
             if (!chunk.account) {
                 return;
             }
@@ -108,6 +176,17 @@ class grpcMultiAccountSubscriber {
             if (!accountPubkey || !this.subscribedAccounts.has(accountPubkey)) {
                 return;
             }
+            // Touch resub timer on any incoming account update for subscribed keys
+            if ((_a = this.resubOpts) === null || _a === void 0 ? void 0 : _a.resubTimeoutMs) {
+                this.receivingData = true;
+                clearTimeout(this.timeoutId);
+                this.setTimeout();
+            }
+            // Skip processing if we already have data for this account at a newer slot
+            const existing = this.dataMap.get(accountPubkey);
+            if ((existing === null || existing === void 0 ? void 0 : existing.slot) !== undefined && existing.slot > slot) {
+                return;
+            }
             const accountInfo = {
                 owner: new web3_js_1.PublicKey(chunk.account.account.owner),
                 lamports: Number(chunk.account.account.lamports),
@@ -117,21 +196,36 @@ class grpcMultiAccountSubscriber {
             };
             const context = { slot };
             const buffer = accountInfo.data;
-            const data = this.decodeBufferFn
-                ? this.decodeBufferFn(buffer, accountPubkey)
-                : this.program.account[this.accountName].coder.accounts.decode(this.capitalize(this.accountName), buffer);
-            const handler = this.onChangeMap.get(accountPubkey);
-            if (handler) {
-                if ((_a = this.resubOpts) === null || _a === void 0 ? void 0 : _a.resubTimeoutMs) {
-                    this.receivingData = true;
-                    clearTimeout(this.timeoutId);
-                    handler(data, context, buffer);
-                    this.setTimeout();
+            // Check existing buffer for this account and skip if unchanged or slot regressed
+            const prevBuffer = this.bufferMap.get(accountPubkey);
+            if (prevBuffer && slot < prevBuffer.slot) {
+                return;
+            }
+            if (prevBuffer &&
+                prevBuffer.buffer &&
+                buffer &&
+                buffer.equals(prevBuffer.buffer)) {
+                return;
+            }
+            this.bufferMap.set(accountPubkey, { buffer, slot });
+            const accountProps = (_b = this.accountPropsMap) === null || _b === void 0 ? void 0 : _b.get(accountPubkey);
+            const handleDataBuffer = (context, buffer, accountProps) => {
+                const data = this.decodeBufferFn
+                    ? this.decodeBufferFn(buffer, accountPubkey, accountProps)
+                    : this.program.account[this.accountName].coder.accounts.decode(this.capitalize(this.accountName), buffer);
+                const handler = this.onChangeMap.get(accountPubkey);
+                if (handler) {
+                    handler(data, context, buffer, accountProps);
                 }
-                else {
-                    handler(data, context, buffer);
+            };
+            if (Array.isArray(accountProps)) {
+                for (const props of accountProps) {
+                    handleDataBuffer(context, buffer, props);
                 }
             }
+            else {
+                handleDataBuffer(context, buffer, accountProps);
+            }
         });
         return new Promise((resolve, reject) => {
             this.stream.write(request, (err) => {
@@ -140,7 +234,6 @@ class grpcMultiAccountSubscriber {
                     this.listenerId = 1;
                     if ((_a = this.resubOpts) === null || _a === void 0 ? void 0 : _a.resubTimeoutMs) {
                         this.receivingData = true;
-                        this.setTimeout();
                     }
                     resolve();
                 }

package/lib/browser/adminClient.d.ts

@@ -53,6 +53,8 @@ export declare class AdminClient extends DriftClient {
     getUpdateAdminIx(admin: PublicKey): Promise<TransactionInstruction>;
     updatePerpMarketCurveUpdateIntensity(perpMarketIndex: number, curveUpdateIntensity: number): Promise<TransactionSignature>;
     getUpdatePerpMarketCurveUpdateIntensityIx(perpMarketIndex: number, curveUpdateIntensity: number): Promise<TransactionInstruction>;
+    updatePerpMarketReferencePriceOffsetDeadbandPct(perpMarketIndex: number, referencePriceOffsetDeadbandPct: number): Promise<TransactionSignature>;
+    getUpdatePerpMarketReferencePriceOffsetDeadbandPctIx(perpMarketIndex: number, referencePriceOffsetDeadbandPct: number): Promise<TransactionInstruction>;
     updatePerpMarketTargetBaseAssetAmountPerLp(perpMarketIndex: number, targetBaseAssetAmountPerLP: number): Promise<TransactionSignature>;
     updatePerpMarketAmmSummaryStats(perpMarketIndex: number, updateAmmSummaryStats?: boolean, quoteAssetAmountWithUnsettledLp?: BN, netUnsettledFundingPnl?: BN, excludeTotalLiqFee?: boolean): Promise<TransactionSignature>;
     getUpdatePerpMarketAmmSummaryStatsIx(perpMarketIndex: number, updateAmmSummaryStats?: boolean, quoteAssetAmountWithUnsettledLp?: BN, netUnsettledFundingPnl?: BN, excludeTotalLiqFee?: boolean): Promise<TransactionInstruction>;
@@ -246,4 +248,6 @@ export declare class AdminClient extends DriftClient {
     getUpdateFeatureBitFlagsBuilderCodesIx(enable: boolean): Promise<TransactionInstruction>;
     updateFeatureBitFlagsBuilderReferral(enable: boolean): Promise<TransactionSignature>;
     getUpdateFeatureBitFlagsBuilderReferralIx(enable: boolean): Promise<TransactionInstruction>;
+    adminDisableUpdatePerpBidAskTwap(authority: PublicKey, disable: boolean): Promise<TransactionSignature>;
+    getAdminDisableUpdatePerpBidAskTwapIx(authority: PublicKey, disable: boolean): Promise<TransactionInstruction>;
 }

package/lib/browser/adminClient.js

@@ -550,6 +550,23 @@ class AdminClient extends driftClient_1.DriftClient {
             },
         });
     }
+    async updatePerpMarketReferencePriceOffsetDeadbandPct(perpMarketIndex, referencePriceOffsetDeadbandPct) {
+        const updatePerpMarketReferencePriceOffsetDeadbandPctIx = await this.getUpdatePerpMarketReferencePriceOffsetDeadbandPctIx(perpMarketIndex, referencePriceOffsetDeadbandPct);
+        const tx = await this.buildTransaction(updatePerpMarketReferencePriceOffsetDeadbandPctIx);
+        const { txSig } = await this.sendTransaction(tx, [], this.opts);
+        return txSig;
+    }
+    async getUpdatePerpMarketReferencePriceOffsetDeadbandPctIx(perpMarketIndex, referencePriceOffsetDeadbandPct) {
+        return await this.program.instruction.updatePerpMarketReferencePriceOffsetDeadbandPct(referencePriceOffsetDeadbandPct, {
+            accounts: {
+                admin: this.useHotWalletAdmin
+                    ? this.wallet.publicKey
+                    : this.getStateAccount().admin,
+                state: await this.getStatePublicKey(),
+                perpMarket: await (0, pda_1.getPerpMarketPublicKey)(this.program.programId, perpMarketIndex),
+            },
+        });
+    }
     async updatePerpMarketTargetBaseAssetAmountPerLp(perpMarketIndex, targetBaseAssetAmountPerLP) {
         const updatePerpMarketTargetBaseAssetAmountPerLpIx = await this.getUpdatePerpMarketTargetBaseAssetAmountPerLpIx(perpMarketIndex, targetBaseAssetAmountPerLP);
         const tx = await this.buildTransaction(updatePerpMarketTargetBaseAssetAmountPerLpIx);
@@ -2248,5 +2265,22 @@ class AdminClient extends driftClient_1.DriftClient {
             },
         });
     }
+    async adminDisableUpdatePerpBidAskTwap(authority, disable) {
+        const disableBidAskTwapUpdateIx = await this.getAdminDisableUpdatePerpBidAskTwapIx(authority, disable);
+        const tx = await this.buildTransaction(disableBidAskTwapUpdateIx);
+        const { txSig } = await this.sendTransaction(tx, [], this.opts);
+        return txSig;
+    }
+    async getAdminDisableUpdatePerpBidAskTwapIx(authority, disable) {
+        return await this.program.instruction.adminDisableUpdatePerpBidAskTwap(disable, {
+            accounts: {
+                admin: this.useHotWalletAdmin
+                    ? this.wallet.publicKey
+                    : this.getStateAccount().admin,
+                state: await this.getStatePublicKey(),
+                userStats: (0, pda_1.getUserStatsAccountPublicKey)(this.program.programId, authority),
+            },
+        });
+    }
 }
 exports.AdminClient = AdminClient;

package/lib/browser/constants/perpMarkets.js

@@ -1252,6 +1252,41 @@ exports.MainnetPerpMarkets = [
         pythFeedId: '0xf2b3ab1c49e35e881003c3c0482d18b181a1560b697b844c24c8f85aba1cab95',
         pythLazerId: 2316,
     },
+    {
+        fullName: 'ZCash',
+        category: ['Privacy'],
+        symbol: 'ZEC-PERP',
+        baseAssetSymbol: 'ZEC',
+        marketIndex: 79,
+        oracle: new web3_js_1.PublicKey('BXunfRSyiQWJHv88qMvE42mpMpksWEC8Bf13p2msnRms'),
+        launchTs: 1760366017000,
+        oracleSource: types_1.OracleSource.PYTH_LAZER,
+        pythFeedId: '0xbe9b59d178f0d6a97ab4c343bff2aa69caa1eaae3e9048a65788c529b125bb24',
+        pythLazerId: 66,
+    },
+    {
+        fullName: 'Mantle',
+        category: ['L1'],
+        symbol: 'MNT-PERP',
+        baseAssetSymbol: 'MNT',
+        marketIndex: 80,
+        oracle: new web3_js_1.PublicKey('Gy7cJ4U1nxMA44XXC3hwqkpcxEB1mZTYiwJVkaqZfU7u'),
+        launchTs: 1760366017000,
+        oracleSource: types_1.OracleSource.PYTH_LAZER,
+        pythFeedId: '0x4e3037c822d852d79af3ac80e35eb420ee3b870dca49f9344a38ef4773fb0585',
+        pythLazerId: 199,
+    },
+    {
+        fullName: '1KPUMP',
+        category: ['Launchpad'],
+        symbol: '1KPUMP-PERP',
+        baseAssetSymbol: '1KPUMP',
+        marketIndex: 81,
+        oracle: new web3_js_1.PublicKey('5r8RWTaRiMgr9Lph3FTUE3sGb1vymhpCrm83Bovjfcps'),
+        launchTs: 1760366017000,
+        oracleSource: types_1.OracleSource.PYTH_LAZER_1K,
+        pythLazerId: 1578,
+    },
 ];
 exports.PerpMarkets = {
     devnet: exports.DevnetPerpMarkets,

package/lib/browser/constants/spotMarkets.js

@@ -11,8 +11,8 @@ exports.DevnetSpotMarkets = [
         symbol: 'USDC',
         marketIndex: 0,
         poolId: 0,
-        oracle: new web3_js_1.PublicKey('En8hkHLkRe9d9DraYmBTrus518BvmVH448YcvmrFM6Ce'),
-        oracleSource: types_1.OracleSource.PYTH_STABLE_COIN_PULL,
+        oracle: new web3_js_1.PublicKey('9VCioxmni2gDLv11qufWzT3RDERhQE4iY5Gf7NTfYyAV'),
+        oracleSource: types_1.OracleSource.PYTH_LAZER_STABLE_COIN,
         mint: new web3_js_1.PublicKey('8zGuJQqwhZafTah7Uc7Z4tXRnguqkn5KLFAP8oV6PHe2'),
         precision: new anchor_1.BN(10).pow(numericConstants_1.SIX),
         precisionExp: numericConstants_1.SIX,
@@ -23,8 +23,8 @@ exports.DevnetSpotMarkets = [
         symbol: 'SOL',
         marketIndex: 1,
         poolId: 0,
-        oracle: new web3_js_1.PublicKey('BAtFj4kQttZRVep3UZS2aZRDixkGYgWsbqTBVDbnSsPF'),
-        oracleSource: types_1.OracleSource.PYTH_PULL,
+        oracle: new web3_js_1.PublicKey('3m6i4RFWEDw2Ft4tFHPJtYgmpPe21k56M3FHeWYrgGBz'),
+        oracleSource: types_1.OracleSource.PYTH_LAZER,
         mint: new web3_js_1.PublicKey(exports.WRAPPED_SOL_MINT),
         precision: numericConstants_1.LAMPORTS_PRECISION,
         precisionExp: numericConstants_1.LAMPORTS_EXP,

package/lib/browser/driftClient.d.ts

@@ -180,7 +180,26 @@ export declare class DriftClient {
     getMigrateReferrerIx(authority: PublicKey): Promise<TransactionInstruction>;
     resizeRevenueShareEscrowOrders(authority: PublicKey, numOrders: number, txParams?: TxParams): Promise<TransactionSignature>;
     getResizeRevenueShareEscrowOrdersIx(authority: PublicKey, numOrders: number): Promise<TransactionInstruction>;
+    /**
+     * Creates the transaction to add or update an approved builder.
+     * This allows the builder to receive revenue share from referrals.
+     *
+     * @param builder - The public key of the builder to add or update.
+     * @param maxFeeTenthBps - The maximum fee tenth bps to set for the builder.
+     * @param add - Whether to add or update the builder. If the builder already exists, `add = true` will update the `maxFeeTenthBps`, otherwise it will add the builder. If `add = false`, the builder's `maxFeeTenthBps` will be set to 0.
+     * @param txParams - The transaction parameters to use for the transaction.
+     * @returns The transaction to add or update an approved builder.
+     */
     changeApprovedBuilder(builder: PublicKey, maxFeeTenthBps: number, add: boolean, txParams?: TxParams): Promise<TransactionSignature>;
+    /**
+     * Creates the transaction instruction to add or update an approved builder.
+     * This allows the builder to receive revenue share from referrals.
+     *
+     * @param builder - The public key of the builder to add or update.
+     * @param maxFeeTenthBps - The maximum fee tenth bps to set for the builder.
+     * @param add - Whether to add or update the builder. If the builder already exists, `add = true` will update the `maxFeeTenthBps`, otherwise it will add the builder. If `add = false`, the builder's `maxFeeTenthBps` will be set to 0.
+     * @returns The transaction instruction to add or update an approved builder.
+     */
     getChangeApprovedBuilderIx(builder: PublicKey, maxFeeTenthBps: number, add: boolean): Promise<TransactionInstruction>;
     addSignedMsgWsDelegate(authority: PublicKey, delegate: PublicKey, txParams?: TxParams): Promise<TransactionSignature>;
     getAddSignedMsgWsDelegateIx(authority: PublicKey, delegate: PublicKey): Promise<TransactionInstruction>;
@@ -461,7 +480,9 @@ export declare class DriftClient {
      * @param user - The user to cancel the orders for. If provided, it will be prioritized over the subAccountId.
      * @returns The transaction signature.
      */
-    cancelOrdersByIds(orderIds?: number[], txParams?: TxParams, subAccountId?: number, user?: User): Promise<TransactionSignature>;
+    cancelOrdersByIds(orderIds?: number[], txParams?: TxParams, subAccountId?: number, user?: User, overrides?: {
+        authority?: PublicKey;
+    }): Promise<TransactionSignature>;
     /**
      * Returns the transaction instruction to cancel the provided order ids.
      *
@@ -470,7 +491,9 @@ export declare class DriftClient {
      * @param user - The user to cancel the orders for. If provided, it will be prioritized over the subAccountId.
      * @returns The transaction instruction to cancel the orders.
      */
-    getCancelOrdersByIdsIx(orderIds?: number[], subAccountId?: number, user?: User): Promise<TransactionInstruction>;
+    getCancelOrdersByIdsIx(orderIds?: number[], subAccountId?: number, user?: User, overrides?: {
+        authority?: PublicKey;
+    }): Promise<TransactionInstruction>;
     cancelOrders(marketType?: MarketType, marketIndex?: number, direction?: PositionDirection, txParams?: TxParams, subAccountId?: number): Promise<TransactionSignature>;
     getCancelOrdersIx(marketType: MarketType | null, marketIndex: number | null, direction: PositionDirection | null, subAccountId?: number): Promise<TransactionInstruction>;
     cancelAndPlaceOrders(cancelOrderParams: {
@@ -482,7 +505,9 @@ export declare class DriftClient {
     preparePlaceOrdersTx(params: OrderParams[], txParams?: TxParams, subAccountId?: number, optionalIxs?: TransactionInstruction[]): Promise<{
         placeOrdersTx: anchor.web3.Transaction | anchor.web3.VersionedTransaction;
     }>;
-    getPlaceOrdersIx(params: OptionalOrderParams[], subAccountId?: number): Promise<TransactionInstruction>;
+    getPlaceOrdersIx(params: OptionalOrderParams[], subAccountId?: number, overrides?: {
+        authority?: PublicKey;
+    }): Promise<TransactionInstruction>;
     getPlaceOrdersAndSetPositionMaxLevIx(params: OptionalOrderParams[], positionMaxLev: number, subAccountId?: number): Promise<TransactionInstruction[]>;
     fillPerpOrder(userAccountPublicKey: PublicKey, user: UserAccount, order?: Pick<Order, 'marketIndex' | 'orderId'>, makerInfo?: MakerInfo | MakerInfo[], referrerInfo?: ReferrerInfo, txParams?: TxParams, fillerSubAccountId?: number, fillerAuthority?: PublicKey, hasBuilderFee?: boolean): Promise<TransactionSignature>;
     getFillPerpOrderIx(userAccountPublicKey: PublicKey, userAccount: UserAccount, order: Pick<Order, 'marketIndex' | 'orderId'>, makerInfo?: MakerInfo | MakerInfo[], referrerInfo?: ReferrerInfo, fillerSubAccountId?: number, isSignedMsg?: boolean, fillerAuthority?: PublicKey, hasBuilderFee?: boolean): Promise<TransactionInstruction>;
@@ -605,7 +630,9 @@ export declare class DriftClient {
         signedCancelExistingOrdersTx?: Transaction;
         signedSettlePnlTx?: Transaction;
     }>;
-    getPlaceAndTakePerpOrderIx(orderParams: OptionalOrderParams, makerInfo?: MakerInfo | MakerInfo[], referrerInfo?: ReferrerInfo, successCondition?: PlaceAndTakeOrderSuccessCondition, auctionDurationPercentage?: number, subAccountId?: number): Promise<TransactionInstruction>;
+    getPlaceAndTakePerpOrderIx(orderParams: OptionalOrderParams, makerInfo?: MakerInfo | MakerInfo[], referrerInfo?: ReferrerInfo, successCondition?: PlaceAndTakeOrderSuccessCondition, auctionDurationPercentage?: number, subAccountId?: number, overrides?: {
+        authority?: PublicKey;
+    }): Promise<TransactionInstruction>;
     placeAndMakePerpOrder(orderParams: OptionalOrderParams, takerInfo: TakerInfo, referrerInfo?: ReferrerInfo, txParams?: TxParams, subAccountId?: number): Promise<TransactionSignature>;
     getPlaceAndMakePerpOrderIx(orderParams: OptionalOrderParams, takerInfo: TakerInfo, referrerInfo?: ReferrerInfo, subAccountId?: number): Promise<TransactionInstruction>;
     signSignedMsgOrderParamsMessage(orderParamsMessage: SignedMsgOrderParamsMessage | SignedMsgOrderParamsDelegateMessage, delegateSigner?: boolean): SignedMsgOrderParams;
@@ -737,7 +764,10 @@ export declare class DriftClient {
         bitFlags?: number;
         maxTs?: BN;
         policy?: number;
-    }, subAccountId?: number, userPublicKey?: PublicKey): Promise<TransactionInstruction>;
+    }, subAccountId?: number, overrides?: {
+        user?: User;
+        authority?: PublicKey;
+    }): Promise<TransactionInstruction>;
     /**
      * Modifies an open order by closing it and replacing it with a new order.
      * @param orderParams.userOrderId: The open order to modify

package/lib/browser/driftClient.js

@@ -768,12 +768,31 @@ class DriftClient {
             },
         });
     }
+    /**
+     * Creates the transaction to add or update an approved builder.
+     * This allows the builder to receive revenue share from referrals.
+     *
+     * @param builder - The public key of the builder to add or update.
+     * @param maxFeeTenthBps - The maximum fee tenth bps to set for the builder.
+     * @param add - Whether to add or update the builder. If the builder already exists, `add = true` will update the `maxFeeTenthBps`, otherwise it will add the builder. If `add = false`, the builder's `maxFeeTenthBps` will be set to 0.
+     * @param txParams - The transaction parameters to use for the transaction.
+     * @returns The transaction to add or update an approved builder.
+     */
     async changeApprovedBuilder(builder, maxFeeTenthBps, add, txParams) {
         const ix = await this.getChangeApprovedBuilderIx(builder, maxFeeTenthBps, add);
         const tx = await this.buildTransaction([ix], txParams);
         const { txSig } = await this.sendTransaction(tx, [], this.opts);
         return txSig;
     }
+    /**
+     * Creates the transaction instruction to add or update an approved builder.
+     * This allows the builder to receive revenue share from referrals.
+     *
+     * @param builder - The public key of the builder to add or update.
+     * @param maxFeeTenthBps - The maximum fee tenth bps to set for the builder.
+     * @param add - Whether to add or update the builder. If the builder already exists, `add = true` will update the `maxFeeTenthBps`, otherwise it will add the builder. If `add = false`, the builder's `maxFeeTenthBps` will be set to 0.
+     * @returns The transaction instruction to add or update an approved builder.
+     */
     async getChangeApprovedBuilderIx(builder, maxFeeTenthBps, add) {
         const authority = this.wallet.publicKey;
         const escrow = (0, pda_1.getRevenueShareEscrowAccountPublicKey)(this.program.programId, authority);
@@ -2456,8 +2475,8 @@ class DriftClient {
      * @param user - The user to cancel the orders for. If provided, it will be prioritized over the subAccountId.
      * @returns The transaction signature.
      */
-    async cancelOrdersByIds(orderIds, txParams, subAccountId, user) {
-        const { txSig } = await this.sendTransaction(await this.buildTransaction(await this.getCancelOrdersByIdsIx(orderIds, subAccountId, user), txParams), [], this.opts);
+    async cancelOrdersByIds(orderIds, txParams, subAccountId, user, overrides) {
+        const { txSig } = await this.sendTransaction(await this.buildTransaction(await this.getCancelOrdersByIdsIx(orderIds, subAccountId, user, overrides), txParams), [], this.opts);
         return txSig;
     }
     /**
@@ -2468,19 +2487,20 @@ class DriftClient {
      * @param user - The user to cancel the orders for. If provided, it will be prioritized over the subAccountId.
      * @returns The transaction instruction to cancel the orders.
      */
-    async getCancelOrdersByIdsIx(orderIds, subAccountId, user) {
-        var _a, _b;
+    async getCancelOrdersByIdsIx(orderIds, subAccountId, user, overrides) {
+        var _a, _b, _c;
         const userAccountPubKey = (_a = user === null || user === void 0 ? void 0 : user.userAccountPublicKey) !== null && _a !== void 0 ? _a : (await this.getUserAccountPublicKey(subAccountId));
         const userAccount = (_b = user === null || user === void 0 ? void 0 : user.getUserAccount()) !== null && _b !== void 0 ? _b : this.getUserAccount(subAccountId);
         const remainingAccounts = this.getRemainingAccounts({
             userAccounts: [userAccount],
             useMarketLastSlotCache: true,
         });
+        const authority = (_c = overrides === null || overrides === void 0 ? void 0 : overrides.authority) !== null && _c !== void 0 ? _c : this.wallet.publicKey;
         return await this.program.instruction.cancelOrdersByIds(orderIds, {
             accounts: {
                 state: await this.getStatePublicKey(),
                 user: userAccountPubKey,
-                authority: this.wallet.publicKey,
+                authority,
             },
             remainingAccounts,
         });
@@ -2536,7 +2556,8 @@ class DriftClient {
             placeOrdersTx: tx,
         };
     }
-    async getPlaceOrdersIx(params, subAccountId) {
+    async getPlaceOrdersIx(params, subAccountId, overrides) {
+        var _a;
         const user = await this.getUserAccountPublicKey(subAccountId);
         const readablePerpMarketIndex = [];
         const readableSpotMarketIndexes = [];
@@ -2567,12 +2588,13 @@ class DriftClient {
             }
         }
         const formattedParams = params.map((item) => (0, orderParams_1.getOrderParams)(item));
+        const authority = (_a = overrides === null || overrides === void 0 ? void 0 : overrides.authority) !== null && _a !== void 0 ? _a : this.wallet.publicKey;
         return await this.program.instruction.placeOrders(formattedParams, {
             accounts: {
                 state: await this.getStatePublicKey(),
                 user,
                 userStats: this.getUserStatsAccountPublicKey(),
-                authority: this.wallet.publicKey,
+                authority,
             },
             remainingAccounts,
         });
@@ -3532,7 +3554,8 @@ class DriftClient {
             signedSettlePnlTx: signedTxs.settlePnlTx,
         };
     }
-    async getPlaceAndTakePerpOrderIx(orderParams, makerInfo, referrerInfo, successCondition, auctionDurationPercentage, subAccountId) {
+    async getPlaceAndTakePerpOrderIx(orderParams, makerInfo, referrerInfo, successCondition, auctionDurationPercentage, subAccountId, overrides) {
+        var _a;
         orderParams = (0, orderParams_1.getOrderParams)(orderParams, { marketType: types_1.MarketType.PERP });
         const userStatsPublicKey = await this.getUserStatsAccountPublicKey();
         const user = await this.getUserAccountPublicKey(subAccountId);
@@ -3590,12 +3613,13 @@ class DriftClient {
             optionalParams =
                 ((auctionDurationPercentage !== null && auctionDurationPercentage !== void 0 ? auctionDurationPercentage : 100) << 8) | (successCondition !== null && successCondition !== void 0 ? successCondition : 0);
         }
+        const authority = (_a = overrides === null || overrides === void 0 ? void 0 : overrides.authority) !== null && _a !== void 0 ? _a : this.wallet.publicKey;
         return await this.program.instruction.placeAndTakePerpOrder(orderParams, optionalParams, {
             accounts: {
                 state: await this.getStatePublicKey(),
                 user,
                 userStats: userStatsPublicKey,
-                authority: this.wallet.publicKey,
+                authority,
             },
             remainingAccounts,
         });
@@ -4025,10 +4049,12 @@ class DriftClient {
      * @param userPublicKey: Optional - The public key of the user to modify the order for. This takes precedence over subAccountId.
      * @returns
      */
-    async getModifyOrderIx({ orderId, newDirection, newBaseAmount, newLimitPrice, newOraclePriceOffset, newTriggerPrice, newTriggerCondition, auctionDuration, auctionStartPrice, auctionEndPrice, reduceOnly, postOnly, bitFlags, maxTs, policy, }, subAccountId, userPublicKey) {
-        const user = userPublicKey !== null && userPublicKey !== void 0 ? userPublicKey : (await this.getUserAccountPublicKey(subAccountId));
+    async getModifyOrderIx({ orderId, newDirection, newBaseAmount, newLimitPrice, newOraclePriceOffset, newTriggerPrice, newTriggerCondition, auctionDuration, auctionStartPrice, auctionEndPrice, reduceOnly, postOnly, bitFlags, maxTs, policy, }, subAccountId, overrides) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const userPubKey = (_b = (_a = overrides === null || overrides === void 0 ? void 0 : overrides.user) === null || _a === void 0 ? void 0 : _a.getUserAccountPublicKey()) !== null && _b !== void 0 ? _b : (await this.getUserAccountPublicKey(subAccountId));
+        const userAccount = (_d = (_c = overrides === null || overrides === void 0 ? void 0 : overrides.user) === null || _c === void 0 ? void 0 : _c.getUserAccount()) !== null && _d !== void 0 ? _d : this.getUserAccount(subAccountId);
         const remainingAccounts = this.getRemainingAccounts({
-            userAccounts: [this.getUserAccount(subAccountId)],
+            userAccounts: [userAccount],
             useMarketLastSlotCache: true,
         });
         const orderParams = {
@@ -4047,12 +4073,13 @@ class DriftClient {
             policy: policy || null,
             maxTs: maxTs || null,
         };
+        const authority = (_g = (_e = overrides === null || overrides === void 0 ? void 0 : overrides.authority) !== null && _e !== void 0 ? _e : (_f = overrides === null || overrides === void 0 ? void 0 : overrides.user) === null || _f === void 0 ? void 0 : _f.getUserAccount().authority) !== null && _g !== void 0 ? _g : this.wallet.publicKey;
         return await this.program.instruction.modifyOrder(orderId, orderParams, {
             accounts: {
                 state: await this.getStatePublicKey(),
-                user,
+                user: userPubKey,
                 userStats: this.getUserStatsAccountPublicKey(),
-                authority: this.wallet.publicKey,
+                authority,
             },
             remainingAccounts,
         });

package/lib/browser/events/parse.d.ts

@@ -1,6 +1,8 @@
 import { Program, Event } from '@coral-xyz/anchor';
+import { CuUsageEvent } from './types';
 export declare function parseLogs(program: Program, logs: string[], programId?: string): Event[];
 export declare function parseLogsWithRaw(program: Program, logs: string[], programId?: string): {
     events: Event[];
     rawLogs: string[];
 };
+export declare function parseLogsForCuUsage(logs: string[], programId?: string): Event<CuUsageEvent>[];