@theliem/xmarket-sdk 3.4.2 → 3.6.0

package/dist/index.mjs

@@ -2,7 +2,7 @@ import * as anchor5 from '@coral-xyz/anchor';
 import { PublicKey, SYSVAR_INSTRUCTIONS_PUBKEY, SystemProgram, SYSVAR_RENT_PUBKEY, ComputeBudgetProgram, Transaction, TransactionInstruction, Ed25519Program, AddressLookupTableProgram, TransactionMessage, VersionedTransaction, Connection } from '@solana/web3.js';
 import { createHash } from 'crypto';
 import { TOKEN_2022_PROGRAM_ID, getAssociatedTokenAddressSync, ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_PROGRAM_ID, createAssociatedTokenAccountIdempotentInstruction, createApproveInstruction } from '@solana/spl-token';
-import BN5 from 'bn.js';
+import BN4 from 'bn.js';
 import * as nacl from 'tweetnacl';
 
 // src/sdk.ts
@@ -1312,6 +1312,108 @@ function buildBatchedEd25519Instruction(orders) {
   });
 }
 var IX_SYSVAR = SYSVAR_INSTRUCTIONS_PUBKEY;
+function buildOrder(params) {
+  return {
+    maker: params.maker,
+    condition: params.condition,
+    tokenId: params.tokenId,
+    side: params.side,
+    makerAmount: params.makerAmount,
+    takerAmount: params.takerAmount,
+    nonce: params.nonce ?? new BN4(Date.now()),
+    expiry: params.expiry ?? new BN4(0),
+    createdAt: params.createdAt ?? new BN4(Math.floor(Date.now() / 1e3)),
+    fee: params.fee ?? new BN4(0),
+    taker: params.taker ?? new PublicKey(new Uint8Array(32)),
+    signer: params.maker
+  };
+}
+function orderAmountsFromPrice(side, price, quantity, decimals = 9) {
+  const PRICE_PRECISION = new BN4(1e6);
+  const DENOM = new BN4(100).mul(PRICE_PRECISION);
+  const base = new BN4(10).pow(new BN4(decimals));
+  const priceScaled = new BN4(Math.round(price * 1e6));
+  const quantityBase = new BN4(quantity).mul(base);
+  const collateral = quantityBase.mul(priceScaled).div(DENOM);
+  return side === 0 ? { makerAmount: collateral, takerAmount: quantityBase } : { makerAmount: quantityBase, takerAmount: collateral };
+}
+function buildOrderFromPrice(params) {
+  const { makerAmount, takerAmount } = orderAmountsFromPrice(
+    params.side,
+    params.price,
+    params.quantity,
+    params.decimals ?? 9
+  );
+  return buildOrder({ ...params, makerAmount, takerAmount });
+}
+function signOrderWithKeypair(order, keypair) {
+  const message = serializeOrderToBytes(order);
+  const signature = nacl.sign.detached(message, keypair.secretKey);
+  return { order, signature };
+}
+function getOrderSignBytes(order) {
+  return serializeOrderToBytes(order);
+}
+function serializeSignedOrder(signed) {
+  const orderBytes = serializeOrderToBytes(signed.order);
+  const buf = new Uint8Array(242);
+  buf.set(orderBytes, 0);
+  buf.set(signed.signature, 178);
+  return buf;
+}
+function deserializeSignedOrder(bytes) {
+  if (bytes.length !== 242) throw new InvalidParamError("SignedOrder must be 242 bytes");
+  const readPubkey = (offset) => new PublicKey(bytes.slice(offset, offset + 32));
+  const readU64 = (offset) => new BN4(bytes.slice(offset, offset + 8), "le");
+  const readI64 = (offset) => new BN4(bytes.slice(offset, offset + 8), "le");
+  const order = {
+    maker: readPubkey(0),
+    condition: readPubkey(32),
+    tokenId: bytes[64],
+    side: bytes[65],
+    makerAmount: readU64(66),
+    takerAmount: readU64(74),
+    nonce: readU64(82),
+    expiry: readI64(90),
+    createdAt: readI64(98),
+    fee: readU64(106),
+    taker: readPubkey(114),
+    signer: readPubkey(146)
+  };
+  const signature = bytes.slice(178, 242);
+  return { order, signature };
+}
+function verifySignedOrder(signed) {
+  const message = serializeOrderToBytes(signed.order);
+  return nacl.sign.detached.verify(
+    message,
+    signed.signature,
+    signed.order.signer.toBytes()
+  );
+}
+function detectMatchType(a, b) {
+  const _a = "order" in a ? a.order : a;
+  const _b = "order" in b ? b.order : b;
+  return _detectMatchType(_a, _b);
+}
+function _detectMatchType(a, b) {
+  const SIDE_BUY = 0;
+  if (a.tokenId === b.tokenId) {
+    const aBuy2 = a.side === SIDE_BUY;
+    const bBuy2 = b.side === SIDE_BUY;
+    if (aBuy2 !== bBuy2) return "COMPLEMENTARY";
+    throw new InvalidParamError(
+      "Orders with same tokenId must be one BUY and one SELL (COMPLEMENTARY)"
+    );
+  }
+  const aBuy = a.side === SIDE_BUY;
+  const bBuy = b.side === SIDE_BUY;
+  if (aBuy && bBuy) return "MINT";
+  if (!aBuy && !bBuy) return "MERGE";
+  throw new InvalidParamError(
+    "Orders with different tokenIds must both be BUY (MINT) or both SELL (MERGE)"
+  );
+}
 
 // src/programs/clob.ts
 var ClobClient = class {
@@ -1381,15 +1483,39 @@ var ClobClient = class {
       takerOrderRecord
     ];
     if (feeRecipientAddr) addresses.push(feeRecipientAddr);
+    const [collateralVault] = PDA.collateralVault(collateralMint, this.programIds);
+    const [vaultToken] = PDA.vaultToken(collateralMint, this.programIds);
+    const [mintAuth] = PDA.mintAuthority(condition, this.programIds);
+    const [extraMetaNo] = PDA.extraAccountMetaList(noMint, this.programIds);
+    const clobUsdcAta = getAssociatedTokenAddressSync(collateralMint, clobConfigPda, true);
+    const clobYesAta = getAssociatedTokenAddressSync(yesMint, clobConfigPda, true, TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = getAssociatedTokenAddressSync(noMint, clobConfigPda, true, TOKEN_2022_PROGRAM_ID);
+    const [clobYesPos] = PDA.position(condition, 1, clobConfigPda, this.programIds);
+    const [clobNoPos] = PDA.position(condition, 0, clobConfigPda, this.programIds);
+    addresses.push(
+      collateralVault,
+      vaultToken,
+      mintAuth,
+      extraMetaNo,
+      clobUsdcAta,
+      clobYesAta,
+      clobNoAta,
+      clobYesPos,
+      clobNoPos,
+      collateralMint,
+      ASSOCIATED_TOKEN_PROGRAM_ID
+    );
     for (const m of makers) {
       const seller = m.order.maker;
-      const [sellerPos] = PDA.position(condition, tokenId, seller, this.programIds);
+      const makerTokenId = m.order.tokenId;
+      const makerMint = makerTokenId === 1 ? yesMint : noMint;
+      const [sellerPos] = PDA.position(condition, makerTokenId, seller, this.programIds);
       const [sellerStatus] = PDA.orderStatus(seller, m.order.nonce, this.programIds);
       const [sellerRecord] = PDA.orderRecord(seller, m.order.nonce, this.programIds);
       addresses.push(
         seller,
         sellerRecord,
-        getAssociatedTokenAddressSync(outcomeMint, seller, false, TOKEN_2022_PROGRAM_ID),
+        getAssociatedTokenAddressSync(makerMint, seller, false, TOKEN_2022_PROGRAM_ID),
         getAssociatedTokenAddressSync(collateralMint, seller),
         sellerPos,
         sellerStatus
@@ -1461,6 +1587,36 @@ ${logs.join("\n")}`);
   async _sendLegacyTx(instructions) {
     await this._sendLegacyTxSig(instructions);
   }
+  async _ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta) {
+    const { connection } = this.provider;
+    const [yesInfo, noInfo] = await Promise.all([
+      connection.getAccountInfo(clobYesAta),
+      connection.getAccountInfo(clobNoAta)
+    ]);
+    const { createAssociatedTokenAccountIdempotentInstruction: createAssociatedTokenAccountIdempotentInstruction2 } = await import('@solana/spl-token');
+    const ixs = [];
+    if (!yesInfo) {
+      ixs.push(createAssociatedTokenAccountIdempotentInstruction2(
+        this.walletPubkey,
+        clobYesAta,
+        clobConfig,
+        yesMint,
+        TOKEN_2022_PROGRAM_ID
+      ));
+    }
+    if (!noInfo) {
+      ixs.push(createAssociatedTokenAccountIdempotentInstruction2(
+        this.walletPubkey,
+        clobNoAta,
+        clobConfig,
+        noMint,
+        TOKEN_2022_PROGRAM_ID
+      ));
+    }
+    if (ixs.length > 0) {
+      await this._sendLegacyTx(ixs);
+    }
+  }
   /**
    * Send a match transaction as versioned (v0) with optional ALT.
    * Both operator wallet and payer (this.provider.wallet) sign.
@@ -1468,11 +1624,12 @@ ${logs.join("\n")}`);
   async sendMatchTx(instructions, lookupTable, whitelistedWallet) {
     const { connection } = this.provider;
     const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
-    const cuLimit = ComputeBudgetProgram.setComputeUnitLimit({ units: 8e5 });
+    const cuLimit = ComputeBudgetProgram.setComputeUnitLimit({ units: 14e5 });
+    const heapFrame = ComputeBudgetProgram.requestHeapFrame({ bytes: 262144 });
     const message = new TransactionMessage({
       payerKey: this.walletPubkey,
       recentBlockhash: blockhash,
-      instructions: [cuLimit, ...instructions]
+      instructions: [cuLimit, heapFrame, ...instructions]
     }).compileToV0Message(lookupTable ? [lookupTable] : []);
     const vtx = new VersionedTransaction(message);
     const signers = [this.provider.wallet.payer];
@@ -1481,7 +1638,7 @@ ${logs.join("\n")}`);
     }
     vtx.sign(signers);
     const sig = await connection.sendRawTransaction(vtx.serialize(), {
-      skipPreflight: true
+      skipPreflight: false
     });
     const result = await connection.confirmTransaction(
       { signature: sig, blockhash, lastValidBlockHeight },
@@ -1593,7 +1750,7 @@ ${logs.join("\n")}`);
    *   [extraAccountMetaList, hookConfig, hookProgram]
    *   [feeManagement, fee_config, mkt_override, company_ata, oracle_vault]  (when fee > 0)
    */
-  async buildMatchComplementaryIxs(takerSigned, makersSigned, collateralMint, feeRecipient, operator, opts) {
+  async buildMatchComplementaryIxs(takerSigned, makersSigned, collateralMint, feeRecipient, operator, opts, useTakerPrice = false) {
     const condition = takerSigned.order.condition;
     const tokenId = takerSigned.order.tokenId;
     const taker = takerSigned.order.maker;
@@ -1643,7 +1800,7 @@ ${logs.join("\n")}`);
         ];
       }
     }
-    const matchIx = await this.program.methods.matchComplementary(takerNonce, fillAmount).accounts({
+    const matchIx = await this.program.methods.matchComplementary(takerNonce, fillAmount, useTakerPrice).accounts({
       operator,
       payer: this.walletPubkey,
       clobConfig: this.configPda(),
@@ -1684,6 +1841,49 @@ ${logs.join("\n")}`);
     const sig = await this.sendMatchTx(ixs, lookupTable, operatorWallet);
     return { signature: sig };
   }
+  /**
+   * 1 SELL taker vs N BUY makers.
+   * Rust program only supports BUY-as-taker, so we decompose into N instructions
+   * (BUY_i as taker, SELL as single maker) combined into one atomic transaction.
+   * Engine must use limitPrice for BUY.makerAmount to pass per-pair crossing check.
+   */
+  async matchComplementarySellVsMultiBuy(sellTaker, buyMakers, collateralMint, feeRecipient, operatorWallet, lookupTable, opts) {
+    await Promise.all([
+      this.registerOrderIfNeeded(sellTaker),
+      ...buyMakers.map((m) => this.registerOrderIfNeeded(m))
+    ]);
+    const sell = sellTaker.order;
+    const crossingBuys = buyMakers.filter((b) => {
+      const buy = b.order;
+      const lhs = BigInt(buy.makerAmount.toString()) * BigInt(sell.makerAmount.toString());
+      const rhs = BigInt(buy.takerAmount.toString()) * BigInt(sell.takerAmount.toString());
+      return lhs >= rhs;
+    });
+    if (crossingBuys.length === 0) {
+      throw new InvalidParamError("COMPLEMENTARY: no BUY maker orders cross with the SELL taker");
+    }
+    if (crossingBuys.length < buyMakers.length) {
+      console.warn(`[matchOrders] SELL+BUY: filtered ${buyMakers.length - crossingBuys.length} non-crossing BUY(s)`);
+    }
+    const allIxs = [];
+    for (const buyMaker of crossingBuys) {
+      const ixs = await this.buildMatchComplementaryIxs(
+        buyMaker,
+        // BUY as taker
+        [sellTaker],
+        // SELL as maker
+        collateralMint,
+        feeRecipient,
+        operatorWallet.publicKey,
+        opts,
+        true
+        // useTakerPrice: SELL gets filled at BUY's price (maker's price per doc)
+      );
+      allIxs.push(...ixs);
+    }
+    const sig = await this.sendMatchTx(allIxs, lookupTable, operatorWallet);
+    return { signature: sig };
+  }
   /**
    * MINT: 1 YES buyer (taker) + N NO buyers (makers).
    * Phase 1: register taker + all NO makers in parallel.
@@ -1701,6 +1901,7 @@ ${logs.join("\n")}`);
     const taker = yesSigned.order.maker;
     const takerNonce = yesSigned.order.nonce;
     const fillAmount = new anchor5.BN("18446744073709551615");
+    const clobConfig = this.configPda();
     const [yesMint] = PDA.yesMint(condition, this.programIds);
     const [noMint] = PDA.noMint(condition, this.programIds);
     const [mintAuthority] = PDA.mintAuthority(condition, this.programIds);
@@ -1711,6 +1912,15 @@ ${logs.join("\n")}`);
     const takerYesToken = getAssociatedTokenAddressSync(yesMint, taker, false, TOKEN_2022_PROGRAM_ID);
     const [takerYesPosition] = PDA.position(condition, 1, taker, this.programIds);
     const [takerOrderStatus] = PDA.orderStatus(taker, takerNonce, this.programIds);
+    const clobUsdcAta = getAssociatedTokenAddressSync(collateralMint, clobConfig, true);
+    const clobYesAta = getAssociatedTokenAddressSync(yesMint, clobConfig, true, TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = getAssociatedTokenAddressSync(noMint, clobConfig, true, TOKEN_2022_PROGRAM_ID);
+    const [clobYesPos] = PDA.position(condition, 1, clobConfig, this.programIds);
+    const [clobNoPos] = PDA.position(condition, 0, clobConfig, this.programIds);
+    const [extraMetaYes] = PDA.extraAccountMetaList(yesMint, this.programIds);
+    const [extraMetaNo] = PDA.extraAccountMetaList(noMint, this.programIds);
+    const [hookConfig] = PDA.hookConfig(this.programIds);
+    const hookProgram = this.programIds.hook;
     const remainingAccounts = [];
     for (const nm of noMakers) {
       const noMaker = nm.order.maker;
@@ -1720,6 +1930,7 @@ ${logs.join("\n")}`);
       const [noPosition] = PDA.position(condition, 0, noMaker, this.programIds);
       const [noStatus] = PDA.orderStatus(noMaker, nm.order.nonce, this.programIds);
       remainingAccounts.push(
+        { pubkey: noMaker, isSigner: false, isWritable: false },
         { pubkey: noRecord, isSigner: false, isWritable: false },
         { pubkey: noToken, isSigner: false, isWritable: true },
         { pubkey: noCollateral, isSigner: false, isWritable: true },
@@ -1727,10 +1938,16 @@ ${logs.join("\n")}`);
         { pubkey: noStatus, isSigner: false, isWritable: true }
       );
     }
+    remainingAccounts.push(
+      { pubkey: extraMetaYes, isSigner: false, isWritable: false },
+      { pubkey: extraMetaNo, isSigner: false, isWritable: false },
+      { pubkey: hookConfig, isSigner: false, isWritable: false },
+      { pubkey: hookProgram, isSigner: false, isWritable: false }
+    );
     const matchIx = await this.program.methods.matchMintOrders(takerNonce, fillAmount).accounts({
       operator: operatorWallet.publicKey,
       payer: this.walletPubkey,
-      clobConfig: this.configPda(),
+      clobConfig,
       condition,
       taker,
       takerOrderRecord,
@@ -1738,16 +1955,25 @@ ${logs.join("\n")}`);
       takerYesToken,
       takerYesPosition,
       takerOrderStatus,
+      clobUsdcAta,
+      clobYesAta,
+      clobNoAta,
+      clobYesPosition: clobYesPos,
+      clobNoPosition: clobNoPos,
       collateralVault,
       vaultTokenAccount,
+      collateralMint,
       yesMint,
       noMint,
       mintAuthority,
-      clobAuthority: this.configPda(),
+      clobAuthority: clobConfig,
       conditionalTokensProgram: this.programIds.conditionalTokens,
       collateralTokenProgram: TOKEN_PROGRAM_ID,
+      token2022Program: TOKEN_2022_PROGRAM_ID,
+      associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
       systemProgram: SystemProgram.programId
     }).remainingAccounts(remainingAccounts).instruction();
+    await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
     const sig = await this.sendMatchTx([matchIx], lookupTable, operatorWallet);
     return { signature: sig };
   }
@@ -1769,9 +1995,9 @@ ${logs.join("\n")}`);
     const sellerYes = yesSigned.order.maker;
     const takerNonce = yesSigned.order.nonce;
     const fillAmount = new anchor5.BN("18446744073709551615");
+    const clobConfig = this.configPda();
     const [yesMint] = PDA.yesMint(condition, this.programIds);
     const [noMint] = PDA.noMint(condition, this.programIds);
-    const [mintAuthority] = PDA.mintAuthority(condition, this.programIds);
     const [collateralVault] = PDA.collateralVault(collateralMint, this.programIds);
     const [vaultTokenAccount] = PDA.vaultToken(collateralMint, this.programIds);
     const [takerOrderRecord] = PDA.orderRecord(sellerYes, takerNonce, this.programIds);
@@ -1779,6 +2005,15 @@ ${logs.join("\n")}`);
     const [takerYesPosition] = PDA.position(condition, 1, sellerYes, this.programIds);
     const takerCollateral = getAssociatedTokenAddressSync(collateralMint, sellerYes);
     const [takerOrderStatus] = PDA.orderStatus(sellerYes, takerNonce, this.programIds);
+    const clobUsdcAta = getAssociatedTokenAddressSync(collateralMint, clobConfig, true);
+    const clobYesAta = getAssociatedTokenAddressSync(yesMint, clobConfig, true, TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = getAssociatedTokenAddressSync(noMint, clobConfig, true, TOKEN_2022_PROGRAM_ID);
+    const [clobYesPos] = PDA.position(condition, 1, clobConfig, this.programIds);
+    const [clobNoPos] = PDA.position(condition, 0, clobConfig, this.programIds);
+    const [extraMetaYes] = PDA.extraAccountMetaList(yesMint, this.programIds);
+    const [extraMetaNo] = PDA.extraAccountMetaList(noMint, this.programIds);
+    const [hookConfig] = PDA.hookConfig(this.programIds);
+    const hookProgram = this.programIds.hook;
     const remainingAccounts = [];
     for (const nm of noMakers) {
       const noMaker = nm.order.maker;
@@ -1788,6 +2023,7 @@ ${logs.join("\n")}`);
       const [noPosition] = PDA.position(condition, 0, noMaker, this.programIds);
       const [noStatus] = PDA.orderStatus(noMaker, nm.order.nonce, this.programIds);
       remainingAccounts.push(
+        { pubkey: noMaker, isSigner: false, isWritable: false },
         { pubkey: noRecord, isSigner: false, isWritable: false },
         { pubkey: noToken, isSigner: false, isWritable: true },
         { pubkey: noCollateral, isSigner: false, isWritable: true },
@@ -1795,6 +2031,12 @@ ${logs.join("\n")}`);
         { pubkey: noStatus, isSigner: false, isWritable: true }
       );
     }
+    remainingAccounts.push(
+      { pubkey: extraMetaYes, isSigner: false, isWritable: false },
+      { pubkey: extraMetaNo, isSigner: false, isWritable: false },
+      { pubkey: hookConfig, isSigner: false, isWritable: false },
+      { pubkey: hookProgram, isSigner: false, isWritable: false }
+    );
     if (yesSigned.order.fee.gtn(0) && this.programIds.feeManagement && this.feeConfigOwner) {
       const companyAddr = await this.companyAddress();
       if (companyAddr) {
@@ -1811,7 +2053,7 @@ ${logs.join("\n")}`);
     const matchIx = await this.program.methods.matchMergeOrders(takerNonce, fillAmount).accounts({
       operator: operatorWallet.publicKey,
       payer: this.walletPubkey,
-      clobConfig: this.configPda(),
+      clobConfig,
       condition,
       taker: sellerYes,
       takerOrderRecord,
@@ -1819,17 +2061,24 @@ ${logs.join("\n")}`);
       takerYesPosition,
       takerCollateral,
       takerOrderStatus,
+      clobUsdcAta,
+      clobYesAta,
+      clobNoAta,
+      clobYesPosition: clobYesPos,
+      clobNoPosition: clobNoPos,
       collateralVault,
       vaultTokenAccount,
+      collateralMint,
       yesMint,
       noMint,
-      mintAuthority,
-      feeRecipient,
-      clobAuthority: this.configPda(),
+      clobAuthority: clobConfig,
       conditionalTokensProgram: this.programIds.conditionalTokens,
       collateralTokenProgram: TOKEN_PROGRAM_ID,
+      token2022Program: TOKEN_2022_PROGRAM_ID,
+      associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
       systemProgram: SystemProgram.programId
     }).remainingAccounts(remainingAccounts).instruction();
+    await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
     const sig = await this.sendMatchTx([matchIx], lookupTable, operatorWallet);
     return { signature: sig };
   }
@@ -1870,38 +2119,22 @@ ${logs.join("\n")}`);
         buySignedOrder = taker;
         sellCandidates = makers;
       } else if (t.side === SIDE_SELL && makers.every((m) => m.order.side === SIDE_BUY)) {
-        buySignedOrder = makers[0];
-        sellCandidates = [taker, ...makers.slice(1)];
+        return this.matchComplementarySellVsMultiBuy(taker, makers, collateralMint, feeRecipient, operatorWallet, alt, opts);
       } else {
         throw new InvalidParamError("COMPLEMENTARY requires one BUY and one or more SELLs on same tokenId");
       }
-      const budget = BigInt(buySignedOrder.order.makerAmount.toString());
-      const totalAsk = sellCandidates.reduce(
-        (s, m) => s + BigInt(m.order.takerAmount.toString()),
-        BigInt(0)
-      );
-      let finalSells;
-      if (budget >= totalAsk) {
-        finalSells = sellCandidates;
-      } else {
-        const sorted = [...sellCandidates].sort((a, b) => {
-          const pa = BigInt(a.order.takerAmount.toString()) * BigInt(b.order.makerAmount.toString());
-          const pb = BigInt(b.order.takerAmount.toString()) * BigInt(a.order.makerAmount.toString());
-          return pa < pb ? -1 : pa > pb ? 1 : 0;
-        });
-        finalSells = [];
-        let remaining = budget;
-        for (const s of sorted) {
-          const cost = BigInt(s.order.takerAmount.toString());
-          if (remaining >= cost) {
-            finalSells.push(s);
-            remaining -= cost;
-          }
-        }
-        if (finalSells.length === 0) {
-          throw new InvalidParamError("COMPLEMENTARY: taker budget insufficient for any maker");
-        }
-        console.warn(`[matchOrders] budget ${budget} < totalAsk ${totalAsk}: matched ${finalSells.length}/${sellCandidates.length} makers`);
+      const buy = buySignedOrder.order;
+      const finalSells = sellCandidates.filter((s) => {
+        const sell = s.order;
+        const lhs = BigInt(buy.makerAmount.toString()) * BigInt(sell.makerAmount.toString());
+        const rhs = BigInt(buy.takerAmount.toString()) * BigInt(sell.takerAmount.toString());
+        return lhs >= rhs;
+      });
+      if (finalSells.length === 0) {
+        throw new InvalidParamError("COMPLEMENTARY: no maker orders cross with the buy order");
+      }
+      if (finalSells.length < sellCandidates.length) {
+        console.warn(`[matchOrders] filtered ${sellCandidates.length - finalSells.length} non-crossing maker(s)`);
       }
       return this.matchComplementary(buySignedOrder, finalSells, collateralMint, feeRecipient, operatorWallet, alt, opts);
     }
@@ -1913,6 +2146,53 @@ ${logs.join("\n")}`);
     if (allBuy) return this.matchMintOrders(taker, makers, collateralMint, feeRecipient, operatorWallet, alt);
     return this.matchMergeOrders(taker, makers, collateralMint, feeRecipient, operatorWallet, alt, opts);
   }
+  /**
+   * High-level match: caller passes price + quantity + keypair — SDK builds,
+   * signs, and submits in one call. No manual amount calculation needed.
+   *
+   * Amounts are computed from each order's own limit `price` (percentage, e.g. 51 for 51%).
+   * NEVER pass averageMatchedPrice — that is an engine output, not an order input.
+   *
+   * @param taker   { keypair, condition, tokenId, side, price, quantity, nonce?, expiry? }
+   * @param makers  Array of same shape
+   * @param decimals Collateral decimals (default 9 for USDS)
+   */
+  async matchOrdersFromPrice(taker, makers, decimals = 9, opts) {
+    const nacl2 = await import('tweetnacl');
+    const buildSigned = (p) => {
+      const order = buildOrderFromPrice({
+        maker: p.keypair.publicKey,
+        condition: p.condition,
+        tokenId: p.tokenId,
+        side: p.side,
+        price: p.price,
+        quantity: p.quantity,
+        decimals,
+        nonce: p.nonce,
+        expiry: p.expiry,
+        fee: p.fee,
+        taker: p.taker
+      });
+      const msg = serializeOrderToBytes(order);
+      const sig = nacl2.default.sign.detached(msg, p.keypair.secretKey);
+      return { order, signature: sig };
+    };
+    const takerSigned = buildSigned(taker);
+    const sortedMakers = [...makers].sort((a, b) => {
+      const sameToken = a.tokenId === taker.tokenId && b.tokenId === taker.tokenId;
+      const isDirectBuy = taker.side === 0 && sameToken;
+      const isDirectSell = taker.side === 1 && sameToken;
+      const isMint = taker.side === 0 && taker.tokenId === 1;
+      const isMerge = taker.side === 1 && taker.tokenId === 1;
+      if (isDirectBuy) return a.price - b.price;
+      if (isDirectSell) return b.price - a.price;
+      if (isMint) return b.price - a.price;
+      if (isMerge) return a.price - b.price;
+      return 0;
+    });
+    const makersSigned = sortedMakers.map(buildSigned);
+    return this.matchOrders(takerSigned, makersSigned, opts);
+  }
   // ─── Queries ─────────────────────────────────────────────────────────────────
   async fetchConfig() {
     try {
@@ -8552,6 +8832,10 @@ var clob_exchange_default = {
         {
           name: "fill_amount",
           type: "u64"
+        },
+        {
+          name: "use_taker_price",
+          type: "bool"
         }
       ]
     },
@@ -8604,7 +8888,8 @@ var clob_exchange_default = {
           }
         },
         {
-          name: "condition"
+          name: "condition",
+          writable: true
         },
         {
           name: "taker"
@@ -8680,27 +8965,98 @@ var clob_exchange_default = {
           }
         },
         {
-          name: "collateral_vault",
+          name: "clob_usdc_ata",
+          docs: [
+            "USDC ATA owned by clob_config \u2014 receives USDC from vault after merge"
+          ],
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "account",
+                path: "clob_config"
+              },
+              {
+                kind: "account",
+                path: "collateral_token_program"
+              },
+              {
+                kind: "account",
+                path: "collateral_mint"
+              }
+            ],
+            program: {
+              kind: "const",
+              value: [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          name: "clob_yes_ata",
           writable: true
         },
         {
-          name: "vault_token_account",
+          name: "clob_no_ata",
           writable: true
         },
         {
-          name: "yes_mint",
+          name: "clob_yes_position",
           writable: true
         },
         {
-          name: "no_mint",
+          name: "clob_no_position",
           writable: true
         },
         {
-          name: "mint_authority",
+          name: "collateral_vault",
           writable: true
         },
         {
-          name: "fee_recipient",
+          name: "vault_token_account",
+          writable: true
+        },
+        {
+          name: "collateral_mint"
+        },
+        {
+          name: "yes_mint",
+          writable: true
+        },
+        {
+          name: "no_mint",
           writable: true
         },
         {
@@ -8734,6 +9090,14 @@ var clob_exchange_default = {
           name: "collateral_token_program",
           address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
         },
+        {
+          name: "token_2022_program",
+          address: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          name: "associated_token_program",
+          address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
         {
           name: "system_program",
           address: "11111111111111111111111111111111"
@@ -8799,7 +9163,8 @@ var clob_exchange_default = {
           }
         },
         {
-          name: "condition"
+          name: "condition",
+          writable: true
         },
         {
           name: "taker"
@@ -8874,6 +9239,94 @@ var clob_exchange_default = {
             ]
           }
         },
+        {
+          name: "clob_usdc_ata",
+          docs: [
+            "USDC ATA owned by clob_config \u2014 receives combined USDC, then split_position pulls from here"
+          ],
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "account",
+                path: "clob_config"
+              },
+              {
+                kind: "account",
+                path: "collateral_token_program"
+              },
+              {
+                kind: "account",
+                path: "collateral_mint"
+              }
+            ],
+            program: {
+              kind: "const",
+              value: [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          name: "clob_yes_ata",
+          docs: [
+            "YES Token-2022 ATA owned by clob_config \u2014 receives YES from split, then transferred to taker"
+          ],
+          writable: true
+        },
+        {
+          name: "clob_no_ata",
+          docs: [
+            "NO Token-2022 ATA owned by clob_config \u2014 receives NO from split, then transferred to makers"
+          ],
+          writable: true
+        },
+        {
+          name: "clob_yes_position",
+          docs: [
+            "YES Position PDA for clob_config (set by CTF split_position init_if_needed)"
+          ],
+          writable: true
+        },
+        {
+          name: "clob_no_position",
+          docs: [
+            "NO Position PDA for clob_config (set by CTF split_position init_if_needed)"
+          ],
+          writable: true
+        },
         {
           name: "collateral_vault",
           writable: true
@@ -8882,6 +9335,9 @@ var clob_exchange_default = {
           name: "vault_token_account",
           writable: true
         },
+        {
+          name: "collateral_mint"
+        },
         {
           name: "yes_mint",
           writable: true
@@ -8925,6 +9381,14 @@ var clob_exchange_default = {
           name: "collateral_token_program",
           address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
         },
+        {
+          name: "token_2022_program",
+          address: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          name: "associated_token_program",
+          address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
         {
           name: "system_program",
           address: "11111111111111111111111111111111"
@@ -14515,91 +14979,7 @@ var XMarketSDK = class {
     return this._admin;
   }
 };
-function buildOrder(params) {
-  return {
-    maker: params.maker,
-    condition: params.condition,
-    tokenId: params.tokenId,
-    side: params.side,
-    makerAmount: params.makerAmount,
-    takerAmount: params.takerAmount,
-    nonce: params.nonce ?? new BN5(Date.now()),
-    expiry: params.expiry ?? new BN5(0),
-    createdAt: params.createdAt ?? new BN5(Math.floor(Date.now() / 1e3)),
-    fee: params.fee ?? new BN5(0),
-    taker: params.taker ?? new PublicKey(new Uint8Array(32)),
-    signer: params.maker
-  };
-}
-function signOrderWithKeypair(order, keypair) {
-  const message = serializeOrderToBytes(order);
-  const signature = nacl.sign.detached(message, keypair.secretKey);
-  return { order, signature };
-}
-function getOrderSignBytes(order) {
-  return serializeOrderToBytes(order);
-}
-function serializeSignedOrder(signed) {
-  const orderBytes = serializeOrderToBytes(signed.order);
-  const buf = new Uint8Array(242);
-  buf.set(orderBytes, 0);
-  buf.set(signed.signature, 178);
-  return buf;
-}
-function deserializeSignedOrder(bytes) {
-  if (bytes.length !== 242) throw new InvalidParamError("SignedOrder must be 242 bytes");
-  const readPubkey = (offset) => new PublicKey(bytes.slice(offset, offset + 32));
-  const readU64 = (offset) => new BN5(bytes.slice(offset, offset + 8), "le");
-  const readI64 = (offset) => new BN5(bytes.slice(offset, offset + 8), "le");
-  const order = {
-    maker: readPubkey(0),
-    condition: readPubkey(32),
-    tokenId: bytes[64],
-    side: bytes[65],
-    makerAmount: readU64(66),
-    takerAmount: readU64(74),
-    nonce: readU64(82),
-    expiry: readI64(90),
-    createdAt: readI64(98),
-    fee: readU64(106),
-    taker: readPubkey(114),
-    signer: readPubkey(146)
-  };
-  const signature = bytes.slice(178, 242);
-  return { order, signature };
-}
-function verifySignedOrder(signed) {
-  const message = serializeOrderToBytes(signed.order);
-  return nacl.sign.detached.verify(
-    message,
-    signed.signature,
-    signed.order.signer.toBytes()
-  );
-}
-function detectMatchType(a, b) {
-  const _a = "order" in a ? a.order : a;
-  const _b = "order" in b ? b.order : b;
-  return _detectMatchType(_a, _b);
-}
-function _detectMatchType(a, b) {
-  const SIDE_BUY = 0;
-  if (a.tokenId === b.tokenId) {
-    const aBuy2 = a.side === SIDE_BUY;
-    const bBuy2 = b.side === SIDE_BUY;
-    if (aBuy2 !== bBuy2) return "COMPLEMENTARY";
-    throw new InvalidParamError(
-      "Orders with same tokenId must be one BUY and one SELL (COMPLEMENTARY)"
-    );
-  }
-  const aBuy = a.side === SIDE_BUY;
-  const bBuy = b.side === SIDE_BUY;
-  if (aBuy && bBuy) return "MINT";
-  if (!aBuy && !bBuy) return "MERGE";
-  throw new InvalidParamError(
-    "Orders with different tokenIds must both be BUY (MINT) or both SELL (MERGE)"
-  );
-}
-var MAX_APPROVE_AMOUNT = new BN5("18446744073709551615");
+var MAX_APPROVE_AMOUNT = new BN4("18446744073709551615");
 function buildApproveCollateralTx(collateralMint, signer, payer, delegate, amount = MAX_APPROVE_AMOUNT) {
   const ownerAta = getAssociatedTokenAddressSync(collateralMint, signer, false, TOKEN_PROGRAM_ID);
   const approveIx = createApproveInstruction(
@@ -14643,6 +15023,6 @@ function buildApproveAllOutcomeTokensTx(condition, signer, payer, delegate, prog
   return tx;
 }
 
-export { AccountNotFoundError, AdminClient, ClobClient, CtfClient, FEE_DENOMINATOR, FeeManagementClient, HookClient, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, OracleClient, PDA, PresaleClient, QuestionStatus, SEEDS, UnauthorizedError, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildOrder, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };
+export { AccountNotFoundError, AdminClient, ClobClient, CtfClient, FEE_DENOMINATOR, FeeManagementClient, HookClient, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, OracleClient, PDA, PresaleClient, QuestionStatus, SEEDS, UnauthorizedError, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map