@theliem/xmarket-sdk 3.9.0 → 3.11.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as anchor from '@coral-xyz/anchor';
 import * as _solana_web3_js from '@solana/web3.js';
-import { PublicKey, Transaction, Keypair, TransactionInstruction, AddressLookupTableAccount } from '@solana/web3.js';
+import { PublicKey, Transaction, Keypair, TransactionInstruction, AddressLookupTableAccount, VersionedTransaction } from '@solana/web3.js';
 import BN from 'bn.js';
 
 interface ProgramIds {
@@ -617,6 +617,8 @@ declare class ClobClient {
      * remaining_accounts per NO maker (5):
      *   [order_record, buyer_no_token, buyer_no_collateral, buyer_no_position, no_order_status]
      */
+    /** Build the match_mint_orders instruction (no signing, no sending). */
+    private _buildMintIx;
     private matchMintOrders;
     /**
      * MERGE: 1 YES seller (taker) + N NO sellers (makers).
@@ -627,6 +629,8 @@ declare class ClobClient {
      *   [order_record, seller_no_token, seller_no_collateral, seller_no_position, no_order_status]
      * After all makers, optional 5 fee accounts.
      */
+    /** Build the match_merge_orders instruction (no signing, no sending). */
+    private _buildMergeIx;
     private matchMergeOrders;
     /**
      * Auto-detect match type and execute 2-phase:
@@ -644,6 +648,7 @@ declare class ClobClient {
      */
     matchOrders(taker: SignedOrder, makers: SignedOrder[], opts?: {
         marketOracleVault?: PublicKey;
+        operatorWallet?: anchor.Wallet;
     }): Promise<TxResult>;
     /**
      * High-level match: caller passes price + quantity + keypair — SDK builds,
@@ -686,7 +691,32 @@ declare class ClobClient {
         taker?: PublicKey;
     }>, decimals?: number, opts?: {
         marketOracleVault?: PublicKey;
+        operatorWallet?: anchor.Wallet;
     }): Promise<TxResult>;
+    /**
+     * Build an unsigned VersionedTransaction for a set of match instructions.
+     * Callers sign and send externally — mirrors createQuestionAdmin pattern.
+     */
+    private _buildUnsignedVtx;
+    /**
+     * Build unsigned VersionedTransaction(s) for matching orders.
+     *
+     * Mirrors createQuestionAdmin pattern — SDK registers orders internally but
+     * returns the match tx unsigned. BE signs with both keypairs and sends:
+     *
+     *   const [vtx] = await sdk.clob.buildMatchOrdersTx(taker, makers, operatorPk, payerPk);
+     *   vtx.sign([feePayerKeypair, operatorKeypair]);
+     *   await connection.sendRawTransaction(vtx.serialize());
+     *
+     * Returns an array because NO-taker MINT/MERGE decomposes into N txs (one per YES maker).
+     * Most direct/single-pair cases return a single-element array.
+     *
+     * @param operator - Whitelisted CLOB operator pubkey (must sign)
+     * @param payer    - Fee payer pubkey (must sign, pays tx fee + rent)
+     */
+    buildMatchOrdersTx(taker: SignedOrder, makers: SignedOrder[], operator: PublicKey, payer: PublicKey, opts?: {
+        marketOracleVault?: PublicKey;
+    }): Promise<VersionedTransaction[]>;
     fetchConfig(): Promise<ClobConfig | null>;
     fetchOrderStatus(maker: PublicKey, nonce: anchor.BN): Promise<OrderStatus | null>;
     fetchOrderRecord(maker: PublicKey, nonce: anchor.BN): Promise<{
@@ -1078,6 +1108,18 @@ declare function detectMatchType(a: Order | SignedOrder, b: Order | SignedOrder)
 
 /** Maximum u64 — approve "unlimited" amount. */
 declare const MAX_APPROVE_AMOUNT: BN;
+/**
+ * Build a Transaction that creates YES and NO Token-2022 ATAs for a user
+ * (idempotent — safe to call even if they already exist).
+ *
+ * Required signer: payer (fee payer). No user signature needed.
+ *
+ * @param condition  - condition PDA
+ * @param user       - wallet that will own the ATAs
+ * @param payer      - fee payer wallet pubkey
+ * @param programIds - network program IDs
+ */
+declare function buildCreateUserAtasTx(condition: PublicKey, user: PublicKey, payer: PublicKey, programIds: ProgramIds): Transaction;
 /**
  * Build a Transaction that approves the CLOB config PDA to transfer collateral
  * (USDC) from the signer's ATA.
@@ -1099,4 +1141,4 @@ declare function buildApproveCollateralTx(collateralMint: PublicKey, signer: Pub
  */
 declare function buildApproveAllOutcomeTokensTx(condition: PublicKey, signer: PublicKey, payer: PublicKey, delegate: PublicKey, programIds: ProgramIds, amount?: BN): Transaction;
 
-export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, SEEDS, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };
+export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, SEEDS, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as anchor from '@coral-xyz/anchor';
 import * as _solana_web3_js from '@solana/web3.js';
-import { PublicKey, Transaction, Keypair, TransactionInstruction, AddressLookupTableAccount } from '@solana/web3.js';
+import { PublicKey, Transaction, Keypair, TransactionInstruction, AddressLookupTableAccount, VersionedTransaction } from '@solana/web3.js';
 import BN from 'bn.js';
 
 interface ProgramIds {
@@ -617,6 +617,8 @@ declare class ClobClient {
      * remaining_accounts per NO maker (5):
      *   [order_record, buyer_no_token, buyer_no_collateral, buyer_no_position, no_order_status]
      */
+    /** Build the match_mint_orders instruction (no signing, no sending). */
+    private _buildMintIx;
     private matchMintOrders;
     /**
      * MERGE: 1 YES seller (taker) + N NO sellers (makers).
@@ -627,6 +629,8 @@ declare class ClobClient {
      *   [order_record, seller_no_token, seller_no_collateral, seller_no_position, no_order_status]
      * After all makers, optional 5 fee accounts.
      */
+    /** Build the match_merge_orders instruction (no signing, no sending). */
+    private _buildMergeIx;
     private matchMergeOrders;
     /**
      * Auto-detect match type and execute 2-phase:
@@ -644,6 +648,7 @@ declare class ClobClient {
      */
     matchOrders(taker: SignedOrder, makers: SignedOrder[], opts?: {
         marketOracleVault?: PublicKey;
+        operatorWallet?: anchor.Wallet;
     }): Promise<TxResult>;
     /**
      * High-level match: caller passes price + quantity + keypair — SDK builds,
@@ -686,7 +691,32 @@ declare class ClobClient {
         taker?: PublicKey;
     }>, decimals?: number, opts?: {
         marketOracleVault?: PublicKey;
+        operatorWallet?: anchor.Wallet;
     }): Promise<TxResult>;
+    /**
+     * Build an unsigned VersionedTransaction for a set of match instructions.
+     * Callers sign and send externally — mirrors createQuestionAdmin pattern.
+     */
+    private _buildUnsignedVtx;
+    /**
+     * Build unsigned VersionedTransaction(s) for matching orders.
+     *
+     * Mirrors createQuestionAdmin pattern — SDK registers orders internally but
+     * returns the match tx unsigned. BE signs with both keypairs and sends:
+     *
+     *   const [vtx] = await sdk.clob.buildMatchOrdersTx(taker, makers, operatorPk, payerPk);
+     *   vtx.sign([feePayerKeypair, operatorKeypair]);
+     *   await connection.sendRawTransaction(vtx.serialize());
+     *
+     * Returns an array because NO-taker MINT/MERGE decomposes into N txs (one per YES maker).
+     * Most direct/single-pair cases return a single-element array.
+     *
+     * @param operator - Whitelisted CLOB operator pubkey (must sign)
+     * @param payer    - Fee payer pubkey (must sign, pays tx fee + rent)
+     */
+    buildMatchOrdersTx(taker: SignedOrder, makers: SignedOrder[], operator: PublicKey, payer: PublicKey, opts?: {
+        marketOracleVault?: PublicKey;
+    }): Promise<VersionedTransaction[]>;
     fetchConfig(): Promise<ClobConfig | null>;
     fetchOrderStatus(maker: PublicKey, nonce: anchor.BN): Promise<OrderStatus | null>;
     fetchOrderRecord(maker: PublicKey, nonce: anchor.BN): Promise<{
@@ -1078,6 +1108,18 @@ declare function detectMatchType(a: Order | SignedOrder, b: Order | SignedOrder)
 
 /** Maximum u64 — approve "unlimited" amount. */
 declare const MAX_APPROVE_AMOUNT: BN;
+/**
+ * Build a Transaction that creates YES and NO Token-2022 ATAs for a user
+ * (idempotent — safe to call even if they already exist).
+ *
+ * Required signer: payer (fee payer). No user signature needed.
+ *
+ * @param condition  - condition PDA
+ * @param user       - wallet that will own the ATAs
+ * @param payer      - fee payer wallet pubkey
+ * @param programIds - network program IDs
+ */
+declare function buildCreateUserAtasTx(condition: PublicKey, user: PublicKey, payer: PublicKey, programIds: ProgramIds): Transaction;
 /**
  * Build a Transaction that approves the CLOB config PDA to transfer collateral
  * (USDC) from the signer's ATA.
@@ -1099,4 +1141,4 @@ declare function buildApproveCollateralTx(collateralMint: PublicKey, signer: Pub
  */
 declare function buildApproveAllOutcomeTokensTx(condition: PublicKey, signer: PublicKey, payer: PublicKey, delegate: PublicKey, programIds: ProgramIds, amount?: BN): Transaction;
 
-export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, SEEDS, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };
+export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, SEEDS, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };

package/dist/index.js

@@ -1619,10 +1619,10 @@ ${logs.join("\n")}`);
       connection.getAccountInfo(clobYesAta),
       connection.getAccountInfo(clobNoAta)
     ]);
-    const { createAssociatedTokenAccountIdempotentInstruction: createAssociatedTokenAccountIdempotentInstruction2 } = await import('@solana/spl-token');
+    const { createAssociatedTokenAccountIdempotentInstruction: createAssociatedTokenAccountIdempotentInstruction3 } = await import('@solana/spl-token');
     const ixs = [];
     if (!yesInfo) {
-      ixs.push(createAssociatedTokenAccountIdempotentInstruction2(
+      ixs.push(createAssociatedTokenAccountIdempotentInstruction3(
         this.walletPubkey,
         clobYesAta,
         clobConfig,
@@ -1631,7 +1631,7 @@ ${logs.join("\n")}`);
       ));
     }
     if (!noInfo) {
-      ixs.push(createAssociatedTokenAccountIdempotentInstruction2(
+      ixs.push(createAssociatedTokenAccountIdempotentInstruction3(
         this.walletPubkey,
         clobNoAta,
         clobConfig,
@@ -1915,11 +1915,8 @@ ${logs.join("\n")}`);
    * remaining_accounts per NO maker (5):
    *   [order_record, buyer_no_token, buyer_no_collateral, buyer_no_position, no_order_status]
    */
-  async matchMintOrders(yesSigned, noMakers, collateralMint, _feeRecipient, operatorWallet, lookupTable) {
-    await Promise.all([
-      this.registerOrderIfNeeded(yesSigned),
-      ...noMakers.map((m) => this.registerOrderIfNeeded(m))
-    ]);
+  /** Build the match_mint_orders instruction (no signing, no sending). */
+  async _buildMintIx(yesSigned, noMakers, collateralMint, operator, payer) {
     const condition = yesSigned.order.condition;
     const taker = yesSigned.order.maker;
     const takerNonce = yesSigned.order.nonce;
@@ -1967,9 +1964,9 @@ ${logs.join("\n")}`);
       { pubkey: hookConfig, isSigner: false, isWritable: false },
       { pubkey: hookProgram, isSigner: false, isWritable: false }
     );
-    const matchIx = await this.program.methods.matchMintOrders(takerNonce, fillAmount, true).accounts({
-      operator: operatorWallet.publicKey,
-      payer: this.walletPubkey,
+    return this.program.methods.matchMintOrders(takerNonce, fillAmount, true).accounts({
+      operator,
+      payer,
       clobConfig,
       condition,
       taker,
@@ -1996,6 +1993,19 @@ ${logs.join("\n")}`);
       associatedTokenProgram: splToken.ASSOCIATED_TOKEN_PROGRAM_ID,
       systemProgram: web3_js.SystemProgram.programId
     }).remainingAccounts(remainingAccounts).instruction();
+  }
+  async matchMintOrders(yesSigned, noMakers, collateralMint, _feeRecipient, operatorWallet, lookupTable) {
+    await Promise.all([
+      this.registerOrderIfNeeded(yesSigned),
+      ...noMakers.map((m) => this.registerOrderIfNeeded(m))
+    ]);
+    const condition = yesSigned.order.condition;
+    const clobConfig = this.configPda();
+    const [yesMint] = PDA.yesMint(condition, this.programIds);
+    const [noMint] = PDA.noMint(condition, this.programIds);
+    const clobYesAta = splToken.getAssociatedTokenAddressSync(yesMint, clobConfig, true, splToken.TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = splToken.getAssociatedTokenAddressSync(noMint, clobConfig, true, splToken.TOKEN_2022_PROGRAM_ID);
+    const matchIx = await this._buildMintIx(yesSigned, noMakers, collateralMint, operatorWallet.publicKey, this.walletPubkey);
     await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
     const sig = await this.sendMatchTx([matchIx], lookupTable, operatorWallet);
     return { signature: sig };
@@ -2009,11 +2019,8 @@ ${logs.join("\n")}`);
    *   [order_record, seller_no_token, seller_no_collateral, seller_no_position, no_order_status]
    * After all makers, optional 5 fee accounts.
    */
-  async matchMergeOrders(yesSigned, noMakers, collateralMint, feeRecipient, operatorWallet, lookupTable, opts) {
-    await Promise.all([
-      this.registerOrderIfNeeded(yesSigned),
-      ...noMakers.map((m) => this.registerOrderIfNeeded(m))
-    ]);
+  /** Build the match_merge_orders instruction (no signing, no sending). */
+  async _buildMergeIx(yesSigned, noMakers, collateralMint, operator, payer, opts) {
     const condition = yesSigned.order.condition;
     const sellerYes = yesSigned.order.maker;
     const takerNonce = yesSigned.order.nonce;
@@ -2066,7 +2073,7 @@ ${logs.join("\n")}`);
         const feeOverridePda = PDA.marketFeeOverride(condition, this.programIds)[0];
         const feeOverrideExists = await this.provider.connection.getAccountInfo(feeOverridePda);
         if (feeOverrideExists) {
-          const oracleVault = opts?.marketOracleVault ?? this.walletPubkey;
+          const oracleVault = opts?.marketOracleVault ?? payer;
           remainingAccounts.push(
             { pubkey: this.programIds.feeManagement, isSigner: false, isWritable: false },
             { pubkey: PDA.feeConfig(this.feeConfigOwner, this.programIds)[0], isSigner: false, isWritable: false },
@@ -2077,9 +2084,9 @@ ${logs.join("\n")}`);
         }
       }
     }
-    const matchIx = await this.program.methods.matchMergeOrders(takerNonce, fillAmount, true).accounts({
-      operator: operatorWallet.publicKey,
-      payer: this.walletPubkey,
+    return this.program.methods.matchMergeOrders(takerNonce, fillAmount, true).accounts({
+      operator,
+      payer,
       clobConfig,
       condition,
       taker: sellerYes,
@@ -2105,6 +2112,19 @@ ${logs.join("\n")}`);
       associatedTokenProgram: splToken.ASSOCIATED_TOKEN_PROGRAM_ID,
       systemProgram: web3_js.SystemProgram.programId
     }).remainingAccounts(remainingAccounts).instruction();
+  }
+  async matchMergeOrders(yesSigned, noMakers, collateralMint, _feeRecipient, operatorWallet, lookupTable, opts) {
+    await Promise.all([
+      this.registerOrderIfNeeded(yesSigned),
+      ...noMakers.map((m) => this.registerOrderIfNeeded(m))
+    ]);
+    const condition = yesSigned.order.condition;
+    const clobConfig = this.configPda();
+    const [yesMint] = PDA.yesMint(condition, this.programIds);
+    const [noMint] = PDA.noMint(condition, this.programIds);
+    const clobYesAta = splToken.getAssociatedTokenAddressSync(yesMint, clobConfig, true, splToken.TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = splToken.getAssociatedTokenAddressSync(noMint, clobConfig, true, splToken.TOKEN_2022_PROGRAM_ID);
+    const matchIx = await this._buildMergeIx(yesSigned, noMakers, collateralMint, operatorWallet.publicKey, this.walletPubkey, opts);
     await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
     const sig = await this.sendMatchTx([matchIx], lookupTable, operatorWallet);
     return { signature: sig };
@@ -2129,7 +2149,7 @@ ${logs.join("\n")}`);
     const cfg = await this.fetchConfig();
     if (!cfg) throw new InvalidParamError("CLOB config not found on-chain");
     const feeRecipient = cfg.feeRecipient;
-    const operatorWallet = this.provider.wallet;
+    const operatorWallet = opts?.operatorWallet ?? this.provider.wallet;
     const alt = await this.ensureAlt(
       taker.order.condition,
       collateralMint,
@@ -2156,10 +2176,19 @@ ${logs.join("\n")}`);
     const allBuy = t.side === SIDE_BUY && makers.every((m) => m.order.side === SIDE_BUY);
     const allSell = t.side === SIDE_SELL && makers.every((m) => m.order.side === SIDE_SELL);
     if (!allBuy && !allSell) throw new InvalidParamError("MINT/MERGE: all orders must be same side");
-    if (t.tokenId !== 1) throw new InvalidParamError("MINT/MERGE: taker must be YES (tokenId=1)");
-    if (!makers.every((m) => m.order.tokenId === 0)) throw new InvalidParamError("MINT/MERGE: makers must be NO (tokenId=0)");
-    if (allBuy) return this.matchMintOrders(taker, makers, collateralMint, feeRecipient, operatorWallet, alt);
-    return this.matchMergeOrders(taker, makers, collateralMint, feeRecipient, operatorWallet, alt, opts);
+    const takerIsYes = t.tokenId === 1 && makers.every((m) => m.order.tokenId === 0);
+    const takerIsNo = t.tokenId === 0 && makers.every((m) => m.order.tokenId === 1);
+    if (!takerIsYes && !takerIsNo) throw new InvalidParamError("MINT/MERGE: orders must be complementary YES+NO pair");
+    if (takerIsYes) {
+      if (allBuy) return this.matchMintOrders(taker, makers, collateralMint, feeRecipient, operatorWallet, alt);
+      return this.matchMergeOrders(taker, makers, collateralMint, feeRecipient, operatorWallet, alt, opts);
+    }
+    let lastResult;
+    for (const yesMaker of makers) {
+      if (allBuy) lastResult = await this.matchMintOrders(yesMaker, [taker], collateralMint, feeRecipient, operatorWallet, alt);
+      else lastResult = await this.matchMergeOrders(yesMaker, [taker], collateralMint, feeRecipient, operatorWallet, alt, opts);
+    }
+    return lastResult;
   }
   /**
    * High-level match: caller passes price + quantity + keypair — SDK builds,
@@ -2208,6 +2237,124 @@ ${logs.join("\n")}`);
     const makersSigned = sortedMakers.map(buildSigned);
     return this.matchOrders(takerSigned, makersSigned, opts);
   }
+  /**
+   * Build an unsigned VersionedTransaction for a set of match instructions.
+   * Callers sign and send externally — mirrors createQuestionAdmin pattern.
+   */
+  async _buildUnsignedVtx(instructions, lookupTable, payer) {
+    const { connection } = this.provider;
+    const { blockhash } = await connection.getLatestBlockhash();
+    const cuLimit = web3_js.ComputeBudgetProgram.setComputeUnitLimit({ units: 14e5 });
+    const heapFrame = web3_js.ComputeBudgetProgram.requestHeapFrame({ bytes: 262144 });
+    const message = new web3_js.TransactionMessage({
+      payerKey: payer,
+      recentBlockhash: blockhash,
+      instructions: [cuLimit, heapFrame, ...instructions]
+    }).compileToV0Message(lookupTable ? [lookupTable] : []);
+    return new web3_js.VersionedTransaction(message);
+  }
+  /**
+   * Build unsigned VersionedTransaction(s) for matching orders.
+   *
+   * Mirrors createQuestionAdmin pattern — SDK registers orders internally but
+   * returns the match tx unsigned. BE signs with both keypairs and sends:
+   *
+   *   const [vtx] = await sdk.clob.buildMatchOrdersTx(taker, makers, operatorPk, payerPk);
+   *   vtx.sign([feePayerKeypair, operatorKeypair]);
+   *   await connection.sendRawTransaction(vtx.serialize());
+   *
+   * Returns an array because NO-taker MINT/MERGE decomposes into N txs (one per YES maker).
+   * Most direct/single-pair cases return a single-element array.
+   *
+   * @param operator - Whitelisted CLOB operator pubkey (must sign)
+   * @param payer    - Fee payer pubkey (must sign, pays tx fee + rent)
+   */
+  async buildMatchOrdersTx(taker, makers, operator, payer, opts) {
+    if (makers.length === 0) throw new InvalidParamError("At least 1 maker required");
+    const collateralMint = this.networkConfig.defaultCollateral.mint;
+    const cfg = await this.fetchConfig();
+    if (!cfg) throw new InvalidParamError("CLOB config not found on-chain");
+    const feeRecipient = cfg.feeRecipient;
+    const alt = await this.ensureAlt(taker.order.condition, collateralMint, taker, makers);
+    const t = taker.order;
+    const m0 = makers[0].order;
+    const SIDE_BUY = 0;
+    const SIDE_SELL = 1;
+    if (t.tokenId === m0.tokenId) {
+      let buySignedOrder, sellCandidates;
+      if (t.side === SIDE_BUY && makers.every((m) => m.order.side === SIDE_SELL)) {
+        buySignedOrder = taker;
+        sellCandidates = makers;
+      } else if (t.side === SIDE_SELL && makers.every((m) => m.order.side === SIDE_BUY)) {
+        await Promise.all([
+          this.registerOrderIfNeeded(taker),
+          ...makers.map((m) => this.registerOrderIfNeeded(m))
+        ]);
+        const ixs2 = [];
+        for (const buyMaker of makers) {
+          const built = await this.buildMatchComplementaryIxs(
+            buyMaker,
+            [taker],
+            collateralMint,
+            feeRecipient,
+            operator,
+            opts,
+            true,
+            true
+          );
+          ixs2.push(...built);
+        }
+        return [await this._buildUnsignedVtx(ixs2, alt, payer)];
+      } else {
+        throw new InvalidParamError("COMPLEMENTARY requires one BUY and one or more SELLs on same tokenId");
+      }
+      await Promise.all([
+        this.registerOrderIfNeeded(buySignedOrder),
+        ...sellCandidates.map((m) => this.registerOrderIfNeeded(m))
+      ]);
+      const ixs = await this.buildMatchComplementaryIxs(
+        buySignedOrder,
+        sellCandidates,
+        collateralMint,
+        feeRecipient,
+        operator,
+        opts
+      );
+      return [await this._buildUnsignedVtx(ixs, alt, payer)];
+    }
+    const allBuy = t.side === SIDE_BUY && makers.every((m) => m.order.side === SIDE_BUY);
+    const allSell = t.side === SIDE_SELL && makers.every((m) => m.order.side === SIDE_SELL);
+    if (!allBuy && !allSell) throw new InvalidParamError("MINT/MERGE: all orders must be same side");
+    const takerIsYes = t.tokenId === 1 && makers.every((m) => m.order.tokenId === 0);
+    const takerIsNo = t.tokenId === 0 && makers.every((m) => m.order.tokenId === 1);
+    if (!takerIsYes && !takerIsNo) throw new InvalidParamError("MINT/MERGE: orders must be complementary YES+NO pair");
+    const condition = t.condition;
+    const clobConfig = this.configPda();
+    const [yesMint] = PDA.yesMint(condition, this.programIds);
+    const [noMint] = PDA.noMint(condition, this.programIds);
+    const clobYesAta = splToken.getAssociatedTokenAddressSync(yesMint, clobConfig, true, splToken.TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = splToken.getAssociatedTokenAddressSync(noMint, clobConfig, true, splToken.TOKEN_2022_PROGRAM_ID);
+    if (takerIsYes) {
+      await Promise.all([
+        this.registerOrderIfNeeded(taker),
+        ...makers.map((m) => this.registerOrderIfNeeded(m))
+      ]);
+      await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
+      const ix = allBuy ? await this._buildMintIx(taker, makers, collateralMint, operator, payer) : await this._buildMergeIx(taker, makers, collateralMint, operator, payer, opts);
+      return [await this._buildUnsignedVtx([ix], alt, payer)];
+    }
+    const vtxs = [];
+    for (const yesMaker of makers) {
+      await Promise.all([
+        this.registerOrderIfNeeded(yesMaker),
+        this.registerOrderIfNeeded(taker)
+      ]);
+      await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
+      const ix = allBuy ? await this._buildMintIx(yesMaker, [taker], collateralMint, operator, payer) : await this._buildMergeIx(yesMaker, [taker], collateralMint, operator, payer, opts);
+      vtxs.push(await this._buildUnsignedVtx([ix], alt, payer));
+    }
+    return vtxs;
+  }
   // ─── Queries ─────────────────────────────────────────────────────────────────
   async fetchConfig() {
     try {
@@ -15007,6 +15154,33 @@ var XMarketSDK = class {
   }
 };
 var MAX_APPROVE_AMOUNT = new BN4__default.default("18446744073709551615");
+function buildCreateUserAtasTx(condition, user, payer, programIds) {
+  const [yesMint] = PDA.yesMint(condition, programIds);
+  const [noMint] = PDA.noMint(condition, programIds);
+  const yesAta = splToken.getAssociatedTokenAddressSync(yesMint, user, false, splToken.TOKEN_2022_PROGRAM_ID);
+  const noAta = splToken.getAssociatedTokenAddressSync(noMint, user, false, splToken.TOKEN_2022_PROGRAM_ID);
+  const tx = new web3_js.Transaction();
+  tx.feePayer = payer;
+  tx.add(
+    splToken.createAssociatedTokenAccountIdempotentInstruction(
+      payer,
+      yesAta,
+      user,
+      yesMint,
+      splToken.TOKEN_2022_PROGRAM_ID,
+      splToken.ASSOCIATED_TOKEN_PROGRAM_ID
+    ),
+    splToken.createAssociatedTokenAccountIdempotentInstruction(
+      payer,
+      noAta,
+      user,
+      noMint,
+      splToken.TOKEN_2022_PROGRAM_ID,
+      splToken.ASSOCIATED_TOKEN_PROGRAM_ID
+    )
+  );
+  return tx;
+}
 function buildApproveCollateralTx(collateralMint, signer, payer, delegate, amount = MAX_APPROVE_AMOUNT) {
   const ownerAta = splToken.getAssociatedTokenAddressSync(collateralMint, signer, false, splToken.TOKEN_PROGRAM_ID);
   const approveIx = splToken.createApproveInstruction(
@@ -15073,6 +15247,7 @@ exports.XMarketSDK = XMarketSDK;
 exports.buildApproveAllOutcomeTokensTx = buildApproveAllOutcomeTokensTx;
 exports.buildApproveCollateralTx = buildApproveCollateralTx;
 exports.buildBatchedEd25519Instruction = buildBatchedEd25519Instruction;
+exports.buildCreateUserAtasTx = buildCreateUserAtasTx;
 exports.buildOrder = buildOrder;
 exports.buildOrderFromPrice = buildOrderFromPrice;
 exports.deserializeSignedOrder = deserializeSignedOrder;