@drift-labs/common 1.0.11 → 1.0.13

package/lib/drift/base/actions/builder/createRevenueShareEscrow.d.ts

@@ -0,0 +1,126 @@
+import { DriftClient } from '@drift-labs/sdk';
+import { Transaction, TransactionInstruction, VersionedTransaction, PublicKey } from '@solana/web3.js';
+import { WithTxnParams } from '../../types';
+interface CreateRevenueShareEscrowIxParams {
+    driftClient: DriftClient;
+    /**
+     * The authority (owner) of the revenue share escrow account to be created.
+     * This is typically the user/taker's public key.
+     */
+    authority: PublicKey;
+    /**
+     * Number of order slots to allocate in the escrow account.
+     * This determines how many concurrent builder orders can be tracked.
+     * Recommended: 8-32 for typical users, up to 128 maximum.
+     */
+    numOrders?: number;
+    /**
+     * The public key of the account that will pay for the revenue share escrow account rent.
+     * If not provided, the authority provided will be the payer.
+     */
+    payer?: PublicKey;
+}
+/**
+ * Creates a transaction instruction to initialize a `RevenueShareEscrow` account for a user.
+ *
+ * The RevenueShareEscrow account stores:
+ * - List of approved builders with their max fee caps
+ * - Pending builder fee orders waiting to be settled
+ *
+ * Users must initialize this account before they can place orders with builder codes.
+ *
+ * **Important**: `numOrders` determines CONCURRENT order capacity, not lifetime total orders.
+ * When the escrow is full, new orders will succeed but builder fees won't be tracked.
+ * See README_ORDER_LIMITS.md for capacity planning guidance.
+ *
+ * @param driftClient - The Drift client instance
+ * @param authority - The public key of the user who will own this escrow account
+ * @param numOrders - Number of concurrent order slots (default: 16, range: 1-128)
+ *   - 8: Casual traders (2-3 markets, occasional trading)
+ *   - 16: Active traders (3-5 markets, regular trading) ← Recommended default
+ *   - 32-64: Power users (many markets, frequent trading)
+ *   - 128: Maximum capacity (institutional usage)
+ * @param payer - The public key of the account that will pay for the revenue share escrow account rent
+ *
+ * @returns Promise resolving to a TransactionInstruction that initializes the revenue share escrow
+ *
+ * @example
+ * ```typescript
+ * // Default configuration (16 order slots)
+ * const instruction = await createRevenueShareEscrowIx({
+ *   driftClient,
+ *   authority: userPublicKey
+ * });
+ *
+ * // Custom configuration for power user
+ * const instruction = await createRevenueShareEscrowIx({
+ *   driftClient,
+ *   authority: userPublicKey,
+ *   numOrders: 32  // More concurrent capacity
+ * });
+ * ```
+ */
+export declare const createRevenueShareEscrowIx: ({ driftClient, authority, numOrders, payer, }: CreateRevenueShareEscrowIxParams) => Promise<TransactionInstruction>;
+interface CreateRevenueShareEscrowTxnParams extends WithTxnParams<CreateRevenueShareEscrowIxParams> {
+    /**
+     * The builder to add to the escrow account.
+     */
+    builder?: {
+        /**
+         * The public key of the builder to add to the escrow account.
+         */
+        builderAuthority: PublicKey;
+        /**
+         * The maximum fee the builder can charge, in tenths of basis points.
+         */
+        maxFeeTenthBps: number;
+    };
+}
+/**
+ * Creates a transaction to initialize a RevenueShareEscrow account for a user.
+ *
+ * The RevenueShareEscrow account stores:
+ * - List of approved builders with their max fee caps
+ * - Pending builder fee orders waiting to be settled
+ *
+ * Users must initialize this account before they can place orders with builder codes.
+ *
+ * **Important**: `numOrders` determines CONCURRENT order capacity, not lifetime total orders.
+ * When the escrow is full, new orders will succeed but builder fees won't be tracked.
+ * See README_ORDER_LIMITS.md for capacity planning guidance.
+ *
+ * @param driftClient - The Drift client instance
+ * @param authority - The public key of the user who will own this escrow account
+ * @param numOrders - Number of concurrent order slots (default: 16, range: 1-128)
+ *   - 8: Casual traders (2-3 markets, occasional trading)
+ *   - 16: Active traders (3-5 markets, regular trading) ← Recommended default
+ *   - 32-64: Power users (many markets, frequent trading)
+ *   - 128: Maximum capacity (institutional usage)
+ * @param payer - The public key of the account that will pay for the revenue share escrow account rent
+ * @param txParams - Optional transaction parameters for customizing the transaction
+ *
+ * @returns Promise resolving to a Transaction or VersionedTransaction ready for signing
+ *
+ * @example
+ * ```typescript
+ * // Default configuration (16 order slots)
+ * const transaction = await createRevenueShareEscrowTxn({
+ *   driftClient,
+ *   authority: userPublicKey,
+ *   txParams: { computeUnits: 300000 }
+ * });
+ *
+ * // Custom configuration for power user
+ * const transaction = await createRevenueShareEscrowTxn({
+ *   driftClient,
+ *   authority: userPublicKey,
+ *   numOrders: 32,  // More concurrent capacity
+ *   txParams: { computeUnits: 300000 }
+ * });
+ *
+ * // Sign and send the transaction
+ * const signature = await wallet.sendTransaction(transaction, connection);
+ * ```
+ */
+export declare const createRevenueShareEscrowTxn: (params: CreateRevenueShareEscrowTxnParams) => Promise<Transaction | VersionedTransaction>;
+export {};

package/lib/drift/base/actions/builder/createRevenueShareEscrow.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRevenueShareEscrowTxn = exports.createRevenueShareEscrowIx = void 0;
+const manageBuilder_1 = require("./manageBuilder");
+/**
+ * Creates a transaction instruction to initialize a `RevenueShareEscrow` account for a user.
+ *
+ * The RevenueShareEscrow account stores:
+ * - List of approved builders with their max fee caps
+ * - Pending builder fee orders waiting to be settled
+ *
+ * Users must initialize this account before they can place orders with builder codes.
+ *
+ * **Important**: `numOrders` determines CONCURRENT order capacity, not lifetime total orders.
+ * When the escrow is full, new orders will succeed but builder fees won't be tracked.
+ * See README_ORDER_LIMITS.md for capacity planning guidance.
+ *
+ * @param driftClient - The Drift client instance
+ * @param authority - The public key of the user who will own this escrow account
+ * @param numOrders - Number of concurrent order slots (default: 16, range: 1-128)
+ *   - 8: Casual traders (2-3 markets, occasional trading)
+ *   - 16: Active traders (3-5 markets, regular trading) ← Recommended default
+ *   - 32-64: Power users (many markets, frequent trading)
+ *   - 128: Maximum capacity (institutional usage)
+ * @param payer - The public key of the account that will pay for the revenue share escrow account rent
+ *
+ * @returns Promise resolving to a TransactionInstruction that initializes the revenue share escrow
+ *
+ * @example
+ * ```typescript
+ * // Default configuration (16 order slots)
+ * const instruction = await createRevenueShareEscrowIx({
+ *   driftClient,
+ *   authority: userPublicKey
+ * });
+ *
+ * // Custom configuration for power user
+ * const instruction = await createRevenueShareEscrowIx({
+ *   driftClient,
+ *   authority: userPublicKey,
+ *   numOrders: 32  // More concurrent capacity
+ * });
+ * ```
+ */
+const createRevenueShareEscrowIx = async ({ driftClient, authority, numOrders = 16, payer, }) => {
+    return driftClient.getInitializeRevenueShareEscrowIx(authority, numOrders, {
+        payer: payer !== null && payer !== void 0 ? payer : authority,
+    });
+};
+exports.createRevenueShareEscrowIx = createRevenueShareEscrowIx;
+/**
+ * Creates a transaction to initialize a RevenueShareEscrow account for a user.
+ *
+ * The RevenueShareEscrow account stores:
+ * - List of approved builders with their max fee caps
+ * - Pending builder fee orders waiting to be settled
+ *
+ * Users must initialize this account before they can place orders with builder codes.
+ *
+ * **Important**: `numOrders` determines CONCURRENT order capacity, not lifetime total orders.
+ * When the escrow is full, new orders will succeed but builder fees won't be tracked.
+ * See README_ORDER_LIMITS.md for capacity planning guidance.
+ *
+ * @param driftClient - The Drift client instance
+ * @param authority - The public key of the user who will own this escrow account
+ * @param numOrders - Number of concurrent order slots (default: 16, range: 1-128)
+ *   - 8: Casual traders (2-3 markets, occasional trading)
+ *   - 16: Active traders (3-5 markets, regular trading) ← Recommended default
+ *   - 32-64: Power users (many markets, frequent trading)
+ *   - 128: Maximum capacity (institutional usage)
+ * @param payer - The public key of the account that will pay for the revenue share escrow account rent
+ * @param txParams - Optional transaction parameters for customizing the transaction
+ *
+ * @returns Promise resolving to a Transaction or VersionedTransaction ready for signing
+ *
+ * @example
+ * ```typescript
+ * // Default configuration (16 order slots)
+ * const transaction = await createRevenueShareEscrowTxn({
+ *   driftClient,
+ *   authority: userPublicKey,
+ *   txParams: { computeUnits: 300000 }
+ * });
+ *
+ * // Custom configuration for power user
+ * const transaction = await createRevenueShareEscrowTxn({
+ *   driftClient,
+ *   authority: userPublicKey,
+ *   numOrders: 32,  // More concurrent capacity
+ *   txParams: { computeUnits: 300000 }
+ * });
+ *
+ * // Sign and send the transaction
+ * const signature = await wallet.sendTransaction(transaction, connection);
+ * ```
+ */
+const createRevenueShareEscrowTxn = async (params) => {
+    var _a;
+    const createIx = await (0, exports.createRevenueShareEscrowIx)(params);
+    const ixs = [createIx];
+    if (params.builder) {
+        const addBuilderIx = await (0, manageBuilder_1.manageBuilderIx)({
+            driftClient: params.driftClient,
+            authority: params.authority,
+            builderAuthority: params.builder.builderAuthority,
+            maxFeeTenthBps: params.builder.maxFeeTenthBps,
+            payer: (_a = params.payer) !== null && _a !== void 0 ? _a : params.authority,
+        });
+        ixs.push(addBuilderIx);
+    }
+    return params.driftClient.buildTransaction(ixs, params.txParams);
+};
+exports.createRevenueShareEscrowTxn = createRevenueShareEscrowTxn;
+//# sourceMappingURL=createRevenueShareEscrow.js.map

package/lib/drift/base/actions/builder/createRevenueShareEscrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRevenueShareEscrow.js","sourceRoot":"","sources":["../../../../../src/drift/base/actions/builder/createRevenueShareEscrow.ts"],"names":[],"mappings":";;;AAQA,mDAAkD;AAsBlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACI,MAAM,0BAA0B,GAAG,KAAK,EAAE,EAChD,WAAW,EACX,SAAS,EACT,SAAS,GAAG,EAAE,EACd,KAAK,GAC6B,EAAmC,EAAE;IACvE,OAAO,WAAW,CAAC,iCAAiC,CAAC,SAAS,EAAE,SAAS,EAAE;QAC1E,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,SAAS;KACzB,CAAC,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,0BAA0B,8BASrC;AAmBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACI,MAAM,2BAA2B,GAAG,KAAK,EAC/C,MAAyC,EACK,EAAE;;IAChD,MAAM,QAAQ,GAAG,MAAM,IAAA,kCAA0B,EAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEvB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAe,EAAC;YAC1C,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB;YACjD,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc;YAC7C,KAAK,EAAE,MAAA,MAAM,CAAC,KAAK,mCAAI,MAAM,CAAC,SAAS;SACvC,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAClE,CAAC,CAAC;AAnBW,QAAA,2BAA2B,+BAmBtC","sourcesContent":["import { DriftClient } from '@drift-labs/sdk';\nimport {\n\tTransaction,\n\tTransactionInstruction,\n\tVersionedTransaction,\n\tPublicKey,\n} from '@solana/web3.js';\nimport { WithTxnParams } from '../../types';\nimport { manageBuilderIx } from './manageBuilder';\n\ninterface CreateRevenueShareEscrowIxParams {\n\tdriftClient: DriftClient;\n\t/**\n\t * The authority (owner) of the revenue share escrow account to be created.\n\t * This is typically the user/taker's public key.\n\t */\n\tauthority: PublicKey;\n\t/**\n\t * Number of order slots to allocate in the escrow account.\n\t * This determines how many concurrent builder orders can be tracked.\n\t * Recommended: 8-32 for typical users, up to 128 maximum.\n\t */\n\tnumOrders?: number;\n\t/**\n\t * The public key of the account that will pay for the revenue share escrow account rent.\n\t * If not provided, the authority provided will be the payer.\n\t */\n\tpayer?: PublicKey;\n}\n\n/**\n * Creates a transaction instruction to initialize a `RevenueShareEscrow` account for a user.\n *\n * The RevenueShareEscrow account stores:\n * - List of approved builders with their max fee caps\n * - Pending builder fee orders waiting to be settled\n *\n * Users must initialize this account before they can place orders with builder codes.\n *\n * **Important**: `numOrders` determines CONCURRENT order capacity, not lifetime total orders.\n * When the escrow is full, new orders will succeed but builder fees won't be tracked.\n * See README_ORDER_LIMITS.md for capacity planning guidance.\n *\n * @param driftClient - The Drift client instance\n * @param authority - The public key of the user who will own this escrow account\n * @param numOrders - Number of concurrent order slots (default: 16, range: 1-128)\n *   - 8: Casual traders (2-3 markets, occasional trading)\n *   - 16: Active traders (3-5 markets, regular trading) ← Recommended default\n *   - 32-64: Power users (many markets, frequent trading)\n *   - 128: Maximum capacity (institutional usage)\n * @param payer - The public key of the account that will pay for the revenue share escrow account rent\n *\n * @returns Promise resolving to a TransactionInstruction that initializes the revenue share escrow\n *\n * @example\n * ```typescript\n * // Default configuration (16 order slots)\n * const instruction = await createRevenueShareEscrowIx({\n *   driftClient,\n *   authority: userPublicKey\n * });\n *\n * // Custom configuration for power user\n * const instruction = await createRevenueShareEscrowIx({\n *   driftClient,\n *   authority: userPublicKey,\n *   numOrders: 32  // More concurrent capacity\n * });\n * ```\n */\nexport const createRevenueShareEscrowIx = async ({\n\tdriftClient,\n\tauthority,\n\tnumOrders = 16,\n\tpayer,\n}: CreateRevenueShareEscrowIxParams): Promise<TransactionInstruction> => {\n\treturn driftClient.getInitializeRevenueShareEscrowIx(authority, numOrders, {\n\t\tpayer: payer ?? authority,\n\t});\n};\n\ninterface CreateRevenueShareEscrowTxnParams\n\textends WithTxnParams<CreateRevenueShareEscrowIxParams> {\n\t/**\n\t * The builder to add to the escrow account.\n\t */\n\tbuilder?: {\n\t\t/**\n\t\t * The public key of the builder to add to the escrow account.\n\t\t */\n\t\tbuilderAuthority: PublicKey;\n\t\t/**\n\t\t * The maximum fee the builder can charge, in tenths of basis points.\n\t\t */\n\t\tmaxFeeTenthBps: number;\n\t};\n}\n\n/**\n * Creates a transaction to initialize a RevenueShareEscrow account for a user.\n *\n * The RevenueShareEscrow account stores:\n * - List of approved builders with their max fee caps\n * - Pending builder fee orders waiting to be settled\n *\n * Users must initialize this account before they can place orders with builder codes.\n *\n * **Important**: `numOrders` determines CONCURRENT order capacity, not lifetime total orders.\n * When the escrow is full, new orders will succeed but builder fees won't be tracked.\n * See README_ORDER_LIMITS.md for capacity planning guidance.\n *\n * @param driftClient - The Drift client instance\n * @param authority - The public key of the user who will own this escrow account\n * @param numOrders - Number of concurrent order slots (default: 16, range: 1-128)\n *   - 8: Casual traders (2-3 markets, occasional trading)\n *   - 16: Active traders (3-5 markets, regular trading) ← Recommended default\n *   - 32-64: Power users (many markets, frequent trading)\n *   - 128: Maximum capacity (institutional usage)\n * @param payer - The public key of the account that will pay for the revenue share escrow account rent\n * @param txParams - Optional transaction parameters for customizing the transaction\n *\n * @returns Promise resolving to a Transaction or VersionedTransaction ready for signing\n *\n * @example\n * ```typescript\n * // Default configuration (16 order slots)\n * const transaction = await createRevenueShareEscrowTxn({\n *   driftClient,\n *   authority: userPublicKey,\n *   txParams: { computeUnits: 300000 }\n * });\n *\n * // Custom configuration for power user\n * const transaction = await createRevenueShareEscrowTxn({\n *   driftClient,\n *   authority: userPublicKey,\n *   numOrders: 32,  // More concurrent capacity\n *   txParams: { computeUnits: 300000 }\n * });\n *\n * // Sign and send the transaction\n * const signature = await wallet.sendTransaction(transaction, connection);\n * ```\n */\nexport const createRevenueShareEscrowTxn = async (\n\tparams: CreateRevenueShareEscrowTxnParams\n): Promise<Transaction | VersionedTransaction> => {\n\tconst createIx = await createRevenueShareEscrowIx(params);\n\tconst ixs = [createIx];\n\n\tif (params.builder) {\n\t\tconst addBuilderIx = await manageBuilderIx({\n\t\t\tdriftClient: params.driftClient,\n\t\t\tauthority: params.authority,\n\t\t\tbuilderAuthority: params.builder.builderAuthority,\n\t\t\tmaxFeeTenthBps: params.builder.maxFeeTenthBps,\n\t\t\tpayer: params.payer ?? params.authority,\n\t\t});\n\n\t\tixs.push(addBuilderIx);\n\t}\n\n\treturn params.driftClient.buildTransaction(ixs, params.txParams);\n};\n"]}

package/lib/drift/base/actions/builder/index.d.ts

@@ -0,0 +1,3 @@
+export * from './createRevenueShareAccount';
+export * from './createRevenueShareEscrow';
+export * from './manageBuilder';

package/lib/drift/base/actions/builder/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./createRevenueShareAccount"), exports);
+__exportStar(require("./createRevenueShareEscrow"), exports);
+__exportStar(require("./manageBuilder"), exports);
+//# sourceMappingURL=index.js.map

package/lib/drift/base/actions/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/drift/base/actions/builder/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,6DAA2C;AAC3C,kDAAgC","sourcesContent":["export * from './createRevenueShareAccount';\nexport * from './createRevenueShareEscrow';\nexport * from './manageBuilder';\n"]}

package/lib/drift/base/actions/builder/manageBuilder.d.ts

@@ -0,0 +1,157 @@
+import { DriftClient } from '@drift-labs/sdk';
+import { Transaction, TransactionInstruction, VersionedTransaction, PublicKey } from '@solana/web3.js';
+import { WithTxnParams } from '../../types';
+interface ManageBuilderIxParams {
+    driftClient: DriftClient;
+    /**
+     * The public key of the builder to manage.
+     * This is the builder's authority address that owns their RevenueShare account.
+     */
+    builderAuthority: PublicKey;
+    /**
+     * Maximum fee the builder can charge, in tenths of basis points.
+     *
+     * Examples:
+     * - 10 = 1 bps = 0.01%
+     * - 50 = 5 bps = 0.05%
+     * - 100 = 10 bps = 0.1%
+     * - 1000 = 100 bps = 1%
+     *
+     * Special values:
+     * - Set to 0 to revoke the builder (they remain in list but cannot be used)
+     */
+    maxFeeTenthBps: number;
+    /**
+     * The public key of the authority to add the builder to the approved builders list.
+     */
+    authority: PublicKey;
+    /**
+     * The public key of the wallet that will pay for the transaction.
+     * If not provided, the authority provided will be the payer.
+     */
+    payer?: PublicKey;
+}
+/**
+ * Creates a transaction instruction to manage a builder's approval status and fee cap.
+ *
+ * This unified function handles all builder management operations:
+ * - **Approve**: Add a new builder to the approved list
+ * - **Update**: Modify an existing builder's max fee cap
+ * - **Revoke**: Disable a builder by setting their max fee to 0
+ *
+ * ## Behavior:
+ *
+ * ### If builder NOT in list:
+ * - Adds builder with specified `maxFeeTenthBps`
+ *
+ * ### If builder already in list:
+ * - Updates builder's `maxFeeTenthBps` to new value
+ * - Set to 0 to revoke (builder stays in list but cannot be used)
+ *
+ * ## Revocation Constraints:
+ * When setting `maxFeeTenthBps = 0`, the builder cannot have active orders:
+ * - No Open orders using this builder
+ * - No Completed (unsettled) orders using this builder
+ * - Error: `CannotRevokeBuilderWithOpenOrders` if constraint violated
+ *
+ * **Prerequisites**:
+ * - User must have initialized a RevenueShareEscrow account
+ * - Builder must have initialized a RevenueShare account (for receiving fees)
+ *
+ * @param driftClient - The Drift client instance
+ * @param builderAuthority - The public key of the builder to manage
+ * @param maxFeeTenthBps - Maximum fee cap in tenths of basis points
+ *
+ * @returns Promise resolving to a TransactionInstruction
+ *
+ * @example
+ * ```typescript
+ * // Approve a new builder with 5 bps max fee
+ * const ix = await manageBuilderIx({
+ *   driftClient,
+ *   builderAuthority: new PublicKey('BuilderAddress...'),
+ *   maxFeeTenthBps: 50  // 5 bps = 0.05%
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Update existing builder to 10 bps max fee
+ * const ix = await manageBuilderIx({
+ *   driftClient,
+ *   builderAuthority: builderPubkey,
+ *   maxFeeTenthBps: 100  // 10 bps = 0.1%
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Revoke builder (set max fee to 0)
+ * // IMPORTANT: Must settle all builder's orders first!
+ * const ix = await manageBuilderIx({
+ *   driftClient,
+ *   builderAuthority: builderPubkey,
+ *   maxFeeTenthBps: 0  // Revoked
+ * });
+ * ```
+ */
+export declare const manageBuilderIx: (params: ManageBuilderIxParams) => Promise<TransactionInstruction>;
+/**
+ * Creates a transaction to manage a builder's approval status and fee cap.
+ *
+ * This unified function handles all builder management operations:
+ * - **Approve**: Add a new builder to the approved list
+ * - **Update**: Modify an existing builder's max fee cap
+ * - **Revoke**: Disable a builder by setting their max fee to 0
+ *
+ * ## Behavior:
+ *
+ * ### If builder NOT in list:
+ * - Adds builder with specified `maxFeeTenthBps`
+ *
+ * ### If builder already in list:
+ * - Updates builder's `maxFeeTenthBps` to new value
+ * - Set to 0 to revoke (builder stays in list but cannot be used)
+ *
+ * ## Revocation Constraints:
+ * When setting `maxFeeTenthBps = 0`, the builder cannot have active orders:
+ * - No Open orders using this builder
+ * - No Completed (unsettled) orders using this builder
+ * - Error: `CannotRevokeBuilderWithOpenOrders` if constraint violated
+ *
+ * **Prerequisites**:
+ * - User must have initialized a RevenueShareEscrow account
+ * - Builder must have initialized a RevenueShare account (for receiving fees)
+ *
+ * @param driftClient - The Drift client instance
+ * @param builderAuthority - The public key of the builder to manage
+ * @param maxFeeTenthBps - Maximum fee cap in tenths of basis points
+ * @param txParams - Optional transaction parameters for customizing the transaction
+ *
+ * @returns Promise resolving to a Transaction or VersionedTransaction ready for signing
+ *
+ * @example
+ * ```typescript
+ * // Approve a new builder with 2 bps max fee
+ * const tx = await manageBuilderTxn({
+ *   driftClient,
+ *   builderAuthority: new PublicKey('BuilderAddress...'),
+ *   maxFeeTenthBps: 20,
+ *   txParams: { computeUnits: 200000 }
+ * });
+ *
+ * const signature = await wallet.sendTransaction(tx, connection);
+ * ```
+
+ * @example
+ * ```typescript
+ * // Update existing builder's fee
+ * await manageBuilderTxn({
+ *   driftClient,
+ *   builderAuthority: builderPubkey,
+ *   maxFeeTenthBps: 100  // Increase to 10 bps
+ * });
+ * ```
+ */
+export declare const manageBuilderTxn: (params: WithTxnParams<ManageBuilderIxParams>) => Promise<Transaction | VersionedTransaction>;
+export {};

package/lib/drift/base/actions/builder/manageBuilder.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.manageBuilderTxn = exports.manageBuilderIx = void 0;
+/**
+ * Creates a transaction instruction to manage a builder's approval status and fee cap.
+ *
+ * This unified function handles all builder management operations:
+ * - **Approve**: Add a new builder to the approved list
+ * - **Update**: Modify an existing builder's max fee cap
+ * - **Revoke**: Disable a builder by setting their max fee to 0
+ *
+ * ## Behavior:
+ *
+ * ### If builder NOT in list:
+ * - Adds builder with specified `maxFeeTenthBps`
+ *
+ * ### If builder already in list:
+ * - Updates builder's `maxFeeTenthBps` to new value
+ * - Set to 0 to revoke (builder stays in list but cannot be used)
+ *
+ * ## Revocation Constraints:
+ * When setting `maxFeeTenthBps = 0`, the builder cannot have active orders:
+ * - No Open orders using this builder
+ * - No Completed (unsettled) orders using this builder
+ * - Error: `CannotRevokeBuilderWithOpenOrders` if constraint violated
+ *
+ * **Prerequisites**:
+ * - User must have initialized a RevenueShareEscrow account
+ * - Builder must have initialized a RevenueShare account (for receiving fees)
+ *
+ * @param driftClient - The Drift client instance
+ * @param builderAuthority - The public key of the builder to manage
+ * @param maxFeeTenthBps - Maximum fee cap in tenths of basis points
+ *
+ * @returns Promise resolving to a TransactionInstruction
+ *
+ * @example
+ * ```typescript
+ * // Approve a new builder with 5 bps max fee
+ * const ix = await manageBuilderIx({
+ *   driftClient,
+ *   builderAuthority: new PublicKey('BuilderAddress...'),
+ *   maxFeeTenthBps: 50  // 5 bps = 0.05%
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Update existing builder to 10 bps max fee
+ * const ix = await manageBuilderIx({
+ *   driftClient,
+ *   builderAuthority: builderPubkey,
+ *   maxFeeTenthBps: 100  // 10 bps = 0.1%
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Revoke builder (set max fee to 0)
+ * // IMPORTANT: Must settle all builder's orders first!
+ * const ix = await manageBuilderIx({
+ *   driftClient,
+ *   builderAuthority: builderPubkey,
+ *   maxFeeTenthBps: 0  // Revoked
+ * });
+ * ```
+ */
+const manageBuilderIx = async (params) => {
+    const { driftClient, builderAuthority, maxFeeTenthBps, authority, payer } = params;
+    const isRevoke = maxFeeTenthBps === 0;
+    return driftClient.getChangeApprovedBuilderIx(builderAuthority, maxFeeTenthBps, !isRevoke, // add = true (approve/update), false (revoke)
+    {
+        authority,
+        payer: payer !== null && payer !== void 0 ? payer : authority,
+    });
+};
+exports.manageBuilderIx = manageBuilderIx;
+/**
+ * Creates a transaction to manage a builder's approval status and fee cap.
+ *
+ * This unified function handles all builder management operations:
+ * - **Approve**: Add a new builder to the approved list
+ * - **Update**: Modify an existing builder's max fee cap
+ * - **Revoke**: Disable a builder by setting their max fee to 0
+ *
+ * ## Behavior:
+ *
+ * ### If builder NOT in list:
+ * - Adds builder with specified `maxFeeTenthBps`
+ *
+ * ### If builder already in list:
+ * - Updates builder's `maxFeeTenthBps` to new value
+ * - Set to 0 to revoke (builder stays in list but cannot be used)
+ *
+ * ## Revocation Constraints:
+ * When setting `maxFeeTenthBps = 0`, the builder cannot have active orders:
+ * - No Open orders using this builder
+ * - No Completed (unsettled) orders using this builder
+ * - Error: `CannotRevokeBuilderWithOpenOrders` if constraint violated
+ *
+ * **Prerequisites**:
+ * - User must have initialized a RevenueShareEscrow account
+ * - Builder must have initialized a RevenueShare account (for receiving fees)
+ *
+ * @param driftClient - The Drift client instance
+ * @param builderAuthority - The public key of the builder to manage
+ * @param maxFeeTenthBps - Maximum fee cap in tenths of basis points
+ * @param txParams - Optional transaction parameters for customizing the transaction
+ *
+ * @returns Promise resolving to a Transaction or VersionedTransaction ready for signing
+ *
+ * @example
+ * ```typescript
+ * // Approve a new builder with 2 bps max fee
+ * const tx = await manageBuilderTxn({
+ *   driftClient,
+ *   builderAuthority: new PublicKey('BuilderAddress...'),
+ *   maxFeeTenthBps: 20,
+ *   txParams: { computeUnits: 200000 }
+ * });
+ *
+ * const signature = await wallet.sendTransaction(tx, connection);
+ * ```
+
+ * @example
+ * ```typescript
+ * // Update existing builder's fee
+ * await manageBuilderTxn({
+ *   driftClient,
+ *   builderAuthority: builderPubkey,
+ *   maxFeeTenthBps: 100  // Increase to 10 bps
+ * });
+ * ```
+ */
+const manageBuilderTxn = async (params) => {
+    return params.driftClient.buildTransaction(await (0, exports.manageBuilderIx)(params), params.txParams);
+};
+exports.manageBuilderTxn = manageBuilderTxn;
+//# sourceMappingURL=manageBuilder.js.map

package/lib/drift/base/actions/builder/manageBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manageBuilder.js","sourceRoot":"","sources":["../../../../../src/drift/base/actions/builder/manageBuilder.ts"],"names":[],"mappings":";;;AAwCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACI,MAAM,eAAe,GAAG,KAAK,EACnC,MAA6B,EACK,EAAE;IACpC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,GACxE,MAAM,CAAC;IAER,MAAM,QAAQ,GAAG,cAAc,KAAK,CAAC,CAAC;IAEtC,OAAO,WAAW,CAAC,0BAA0B,CAC5C,gBAAgB,EAChB,cAAc,EACd,CAAC,QAAQ,EAAE,8CAA8C;IACzD;QACC,SAAS;QACT,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,SAAS;KACzB,CACD,CAAC;AACH,CAAC,CAAC;AAjBW,QAAA,eAAe,mBAiB1B;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACI,MAAM,gBAAgB,GAAG,KAAK,EACpC,MAA4C,EACE,EAAE;IAChD,OAAO,MAAM,CAAC,WAAW,CAAC,gBAAgB,CACzC,MAAM,IAAA,uBAAe,EAAC,MAAM,CAAC,EAC7B,MAAM,CAAC,QAAQ,CACf,CAAC;AACH,CAAC,CAAC;AAPW,QAAA,gBAAgB,oBAO3B","sourcesContent":["import { DriftClient } from '@drift-labs/sdk';\nimport {\n\tTransaction,\n\tTransactionInstruction,\n\tVersionedTransaction,\n\tPublicKey,\n} from '@solana/web3.js';\nimport { WithTxnParams } from '../../types';\n\ninterface ManageBuilderIxParams {\n\tdriftClient: DriftClient;\n\t/**\n\t * The public key of the builder to manage.\n\t * This is the builder's authority address that owns their RevenueShare account.\n\t */\n\tbuilderAuthority: PublicKey;\n\t/**\n\t * Maximum fee the builder can charge, in tenths of basis points.\n\t *\n\t * Examples:\n\t * - 10 = 1 bps = 0.01%\n\t * - 50 = 5 bps = 0.05%\n\t * - 100 = 10 bps = 0.1%\n\t * - 1000 = 100 bps = 1%\n\t *\n\t * Special values:\n\t * - Set to 0 to revoke the builder (they remain in list but cannot be used)\n\t */\n\tmaxFeeTenthBps: number;\n\t/**\n\t * The public key of the authority to add the builder to the approved builders list.\n\t */\n\tauthority: PublicKey;\n\t/**\n\t * The public key of the wallet that will pay for the transaction.\n\t * If not provided, the authority provided will be the payer.\n\t */\n\tpayer?: PublicKey;\n}\n\n/**\n * Creates a transaction instruction to manage a builder's approval status and fee cap.\n *\n * This unified function handles all builder management operations:\n * - **Approve**: Add a new builder to the approved list\n * - **Update**: Modify an existing builder's max fee cap\n * - **Revoke**: Disable a builder by setting their max fee to 0\n *\n * ## Behavior:\n *\n * ### If builder NOT in list:\n * - Adds builder with specified `maxFeeTenthBps`\n *\n * ### If builder already in list:\n * - Updates builder's `maxFeeTenthBps` to new value\n * - Set to 0 to revoke (builder stays in list but cannot be used)\n *\n * ## Revocation Constraints:\n * When setting `maxFeeTenthBps = 0`, the builder cannot have active orders:\n * - No Open orders using this builder\n * - No Completed (unsettled) orders using this builder\n * - Error: `CannotRevokeBuilderWithOpenOrders` if constraint violated\n *\n * **Prerequisites**:\n * - User must have initialized a RevenueShareEscrow account\n * - Builder must have initialized a RevenueShare account (for receiving fees)\n *\n * @param driftClient - The Drift client instance\n * @param builderAuthority - The public key of the builder to manage\n * @param maxFeeTenthBps - Maximum fee cap in tenths of basis points\n *\n * @returns Promise resolving to a TransactionInstruction\n *\n * @example\n * ```typescript\n * // Approve a new builder with 5 bps max fee\n * const ix = await manageBuilderIx({\n *   driftClient,\n *   builderAuthority: new PublicKey('BuilderAddress...'),\n *   maxFeeTenthBps: 50  // 5 bps = 0.05%\n * });\n * ```\n *\n * @example\n * ```typescript\n * // Update existing builder to 10 bps max fee\n * const ix = await manageBuilderIx({\n *   driftClient,\n *   builderAuthority: builderPubkey,\n *   maxFeeTenthBps: 100  // 10 bps = 0.1%\n * });\n * ```\n *\n * @example\n * ```typescript\n * // Revoke builder (set max fee to 0)\n * // IMPORTANT: Must settle all builder's orders first!\n * const ix = await manageBuilderIx({\n *   driftClient,\n *   builderAuthority: builderPubkey,\n *   maxFeeTenthBps: 0  // Revoked\n * });\n * ```\n */\nexport const manageBuilderIx = async (\n\tparams: ManageBuilderIxParams\n): Promise<TransactionInstruction> => {\n\tconst { driftClient, builderAuthority, maxFeeTenthBps, authority, payer } =\n\t\tparams;\n\n\tconst isRevoke = maxFeeTenthBps === 0;\n\n\treturn driftClient.getChangeApprovedBuilderIx(\n\t\tbuilderAuthority,\n\t\tmaxFeeTenthBps,\n\t\t!isRevoke, // add = true (approve/update), false (revoke)\n\t\t{\n\t\t\tauthority,\n\t\t\tpayer: payer ?? authority,\n\t\t}\n\t);\n};\n\n/**\n * Creates a transaction to manage a builder's approval status and fee cap.\n *\n * This unified function handles all builder management operations:\n * - **Approve**: Add a new builder to the approved list\n * - **Update**: Modify an existing builder's max fee cap\n * - **Revoke**: Disable a builder by setting their max fee to 0\n *\n * ## Behavior:\n *\n * ### If builder NOT in list:\n * - Adds builder with specified `maxFeeTenthBps`\n *\n * ### If builder already in list:\n * - Updates builder's `maxFeeTenthBps` to new value\n * - Set to 0 to revoke (builder stays in list but cannot be used)\n *\n * ## Revocation Constraints:\n * When setting `maxFeeTenthBps = 0`, the builder cannot have active orders:\n * - No Open orders using this builder\n * - No Completed (unsettled) orders using this builder\n * - Error: `CannotRevokeBuilderWithOpenOrders` if constraint violated\n *\n * **Prerequisites**:\n * - User must have initialized a RevenueShareEscrow account\n * - Builder must have initialized a RevenueShare account (for receiving fees)\n *\n * @param driftClient - The Drift client instance\n * @param builderAuthority - The public key of the builder to manage\n * @param maxFeeTenthBps - Maximum fee cap in tenths of basis points\n * @param txParams - Optional transaction parameters for customizing the transaction\n *\n * @returns Promise resolving to a Transaction or VersionedTransaction ready for signing\n *\n * @example\n * ```typescript\n * // Approve a new builder with 2 bps max fee\n * const tx = await manageBuilderTxn({\n *   driftClient,\n *   builderAuthority: new PublicKey('BuilderAddress...'),\n *   maxFeeTenthBps: 20,\n *   txParams: { computeUnits: 200000 }\n * });\n *\n * const signature = await wallet.sendTransaction(tx, connection);\n * ```\n\n * @example\n * ```typescript\n * // Update existing builder's fee\n * await manageBuilderTxn({\n *   driftClient,\n *   builderAuthority: builderPubkey,\n *   maxFeeTenthBps: 100  // Increase to 10 bps\n * });\n * ```\n */\nexport const manageBuilderTxn = async (\n\tparams: WithTxnParams<ManageBuilderIxParams>\n): Promise<Transaction | VersionedTransaction> => {\n\treturn params.driftClient.buildTransaction(\n\t\tawait manageBuilderIx(params),\n\t\tparams.txParams\n\t);\n};\n"]}

package/lib/drift/base/actions/index.d.ts

@@ -2,3 +2,4 @@ export * from './user';
 export * from './trade';
 export * from './perp';
 export * from './spot';
+export * from './builder';

package/lib/drift/base/actions/index.js

@@ -18,4 +18,5 @@ __exportStar(require("./user"), exports);
 __exportStar(require("./trade"), exports);
 __exportStar(require("./perp"), exports);
 __exportStar(require("./spot"), exports);
+__exportStar(require("./builder"), exports);
 //# sourceMappingURL=index.js.map

package/lib/drift/base/actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/drift/base/actions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,0CAAwB;AACxB,yCAAuB;AACvB,yCAAuB","sourcesContent":["export * from './user';\nexport * from './trade';\nexport * from './perp';\nexport * from './spot';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/drift/base/actions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,0CAAwB;AACxB,yCAAuB;AACvB,yCAAuB;AACvB,4CAA0B","sourcesContent":["export * from './user';\nexport * from './trade';\nexport * from './perp';\nexport * from './spot';\nexport * from './builder';\n"]}

package/lib/drift/base/actions/trade/cancelOrder.d.ts

@@ -1,5 +1,12 @@
-import { DriftClient, TxParams, User } from '@drift-labs/sdk';
-import { Transaction, TransactionInstruction, VersionedTransaction } from '@solana/web3.js';
+import { DriftClient, User } from '@drift-labs/sdk';
+import { Transaction, TransactionInstruction, VersionedTransaction, PublicKey } from '@solana/web3.js';
+import { WithTxnParams } from '../../types';
+interface CreateCancelOrdersIxParams {
+    driftClient: DriftClient;
+    user: User;
+    orderIds: number[];
+    mainSignerOverride?: PublicKey;
+}
 /**
  * Creates a transaction instruction to cancel multiple orders by their order IDs.
  *
@@ -19,7 +26,7 @@ import { Transaction, TransactionInstruction, VersionedTransaction } from '@sola
  *
  * ```
  */
-export declare const createCancelOrdersIx: (driftClient: DriftClient, orderIds: number[], user: User) => Promise<TransactionInstruction>;
+export declare const createCancelOrdersIx: (params: CreateCancelOrdersIxParams) => Promise<TransactionInstruction>;
 /**
  * Creates a transaction to cancel multiple orders by their IDs.
  *
@@ -44,4 +51,5 @@ export declare const createCancelOrdersIx: (driftClient: DriftClient, orderIds:
  * const signature = await wallet.sendTransaction(transaction, connection);
  * ```
  */
-export declare const createCancelOrdersTxn: (driftClient: DriftClient, user: User, orderIds: number[], txParams?: TxParams) => Promise<Transaction | VersionedTransaction>;
+export declare const createCancelOrdersTxn: (params: WithTxnParams<CreateCancelOrdersIxParams>) => Promise<Transaction | VersionedTransaction>;
+export {};