@theliem/xmarket-sdk 3.10.0 → 3.12.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());
+     *
+     * All match types pack into a single VersionedTransaction — same as createQuestionAdmin pattern.
+     * NO-taker MINT/MERGE decomposes into N instructions but all packed in 1 tx.
+     *
+     * @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<{

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());
+     *
+     * All match types pack into a single VersionedTransaction — same as createQuestionAdmin pattern.
+     * NO-taker MINT/MERGE decomposes into N instructions but all packed in 1 tx.
+     *
+     * @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<{

package/dist/index.js

@@ -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,
@@ -2217,6 +2237,119 @@ ${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());
+   *
+   * All match types pack into a single VersionedTransaction — same as createQuestionAdmin pattern.
+   * NO-taker MINT/MERGE decomposes into N instructions but all packed in 1 tx.
+   *
+   * @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 ixs3 = await this.buildMatchComplementaryIxs(
+          taker,
+          makers,
+          collateralMint,
+          feeRecipient,
+          operator,
+          opts,
+          false
+        );
+        return this._buildUnsignedVtx(ixs3, 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 ixs2 = await this.buildMatchComplementaryIxs(
+        buySignedOrder,
+        sellCandidates,
+        collateralMint,
+        feeRecipient,
+        operator,
+        opts
+      );
+      return this._buildUnsignedVtx(ixs2, 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 this._buildUnsignedVtx([ix], alt, payer);
+    }
+    await Promise.all([
+      this.registerOrderIfNeeded(taker),
+      ...makers.map((m) => this.registerOrderIfNeeded(m))
+    ]);
+    await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
+    const ixs = [];
+    for (const yesMaker of makers) {
+      const ix = allBuy ? await this._buildMintIx(yesMaker, [taker], collateralMint, operator, payer) : await this._buildMergeIx(yesMaker, [taker], collateralMint, operator, payer, opts);
+      ixs.push(ix);
+    }
+    return this._buildUnsignedVtx(ixs, alt, payer);
+  }
   // ─── Queries ─────────────────────────────────────────────────────────────────
   async fetchConfig() {
     try {