@theliem/xmarket-sdk 3.4.2 → 3.6.0

package/dist/index.d.mts

@@ -563,6 +563,7 @@ declare class ClobClient {
     ensureAlt(condition: PublicKey, collateralMint: PublicKey, takerSigned: SignedOrder, makers: SignedOrder[]): Promise<AddressLookupTableAccount>;
     private _sendLegacyTxSig;
     private _sendLegacyTx;
+    private _ensureClobOutcomeAtas;
     /**
      * Send a match transaction as versioned (v0) with optional ALT.
      * Both operator wallet and payer (this.provider.wallet) sign.
@@ -595,13 +596,20 @@ declare class ClobClient {
     buildMatchComplementaryIxs(takerSigned: SignedOrder, makersSigned: SignedOrder[], collateralMint: PublicKey, feeRecipient: PublicKey, operator: PublicKey, opts?: {
         marketOracleVault?: PublicKey;
         fillAmount?: anchor.BN;
-    }): Promise<TransactionInstruction[]>;
+    }, useTakerPrice?: boolean): Promise<TransactionInstruction[]>;
     /**
      * COMPLEMENTARY: 1 taker (BUY) + N makers (SELL), same tokenId.
      * Phase 1: register taker + all makers in parallel.
      * Phase 2: 1 atomic match tx.
      */
     private matchComplementary;
+    /**
+     * 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.
+     */
+    private matchComplementarySellVsMultiBuy;
     /**
      * MINT: 1 YES buyer (taker) + N NO buyers (makers).
      * Phase 1: register taker + all NO makers in parallel.
@@ -638,6 +646,48 @@ declare class ClobClient {
     matchOrders(taker: SignedOrder, makers: SignedOrder[], opts?: {
         marketOracleVault?: PublicKey;
     }): Promise<TxResult>;
+    /**
+     * 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)
+     */
+    matchOrdersFromPrice(taker: {
+        keypair: {
+            publicKey: PublicKey;
+            secretKey: Uint8Array;
+        };
+        condition: PublicKey;
+        tokenId: number;
+        side: 0 | 1;
+        price: number;
+        quantity: number;
+        nonce?: BN;
+        expiry?: BN;
+        fee?: BN;
+        taker?: PublicKey;
+    }, makers: Array<{
+        keypair: {
+            publicKey: PublicKey;
+            secretKey: Uint8Array;
+        };
+        condition: PublicKey;
+        tokenId: number;
+        side: 0 | 1;
+        price: number;
+        quantity: number;
+        nonce?: BN;
+        expiry?: BN;
+        fee?: BN;
+        taker?: PublicKey;
+    }>, decimals?: number, opts?: {
+        marketOracleVault?: PublicKey;
+    }): Promise<TxResult>;
     fetchConfig(): Promise<ClobConfig | null>;
     fetchOrderStatus(maker: PublicKey, nonce: anchor.BN): Promise<OrderStatus | null>;
     fetchOrderRecord(maker: PublicKey, nonce: anchor.BN): Promise<{
@@ -939,6 +989,51 @@ declare function buildOrder(params: {
     fee?: BN;
     taker?: PublicKey;
 }): Order;
+/**
+ * Compute makerAmount / takerAmount from a limit price and quantity.
+ *
+ * ALWAYS use the order's own limit price (e.g., 51 for a 51% limit order).
+ * NEVER pass `averageMatchedPrice` — that is an output of the matching engine,
+ * not an order input. Using avgPrice here causes crossing checks to fail
+ * for any maker whose price equals the limit price exactly.
+ *
+ * BUY  YES (side=0): makerAmount = USDS spent = qty × price/100
+ *                    takerAmount = YES received = qty
+ * SELL YES (side=1): makerAmount = YES given   = qty
+ *                    takerAmount = USDS received = qty × price/100
+ *
+ * @param side      0 = BUY, 1 = SELL
+ * @param price     Limit price in percentage cents (e.g., 51 for 51% = $0.51/token)
+ * @param quantity  Whole token count (e.g., 11 for 11 YES tokens)
+ * @param decimals  Collateral token decimals (default 9 for USDS)
+ */
+declare function orderAmountsFromPrice(side: 0 | 1, price: number, quantity: number, decimals?: number): {
+    makerAmount: BN;
+    takerAmount: BN;
+};
+/**
+ * Build a fully-populated Order from human-readable price + quantity.
+ * Amounts are computed using the limit price — never use averageMatchedPrice.
+ *
+ * @param params.side      0 = BUY, 1 = SELL
+ * @param params.price     Limit price in percentage (e.g., 51 for 51%)
+ * @param params.quantity  Whole token count (e.g., 11 for 11 YES tokens)
+ * @param params.decimals  Collateral decimals (default 9 for USDS)
+ */
+declare function buildOrderFromPrice(params: {
+    maker: PublicKey;
+    condition: PublicKey;
+    tokenId: number;
+    side: 0 | 1;
+    price: number;
+    quantity: number;
+    decimals?: number;
+    nonce?: BN;
+    expiry?: BN;
+    createdAt?: BN;
+    fee?: BN;
+    taker?: PublicKey;
+}): Order;
 /**
  * Sign an order with a Keypair.
  * Uses Ed25519 (nacl.sign.detached) over the 178-byte canonical message.
@@ -1005,4 +1100,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, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, 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, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };

package/dist/index.d.ts

@@ -563,6 +563,7 @@ declare class ClobClient {
     ensureAlt(condition: PublicKey, collateralMint: PublicKey, takerSigned: SignedOrder, makers: SignedOrder[]): Promise<AddressLookupTableAccount>;
     private _sendLegacyTxSig;
     private _sendLegacyTx;
+    private _ensureClobOutcomeAtas;
     /**
      * Send a match transaction as versioned (v0) with optional ALT.
      * Both operator wallet and payer (this.provider.wallet) sign.
@@ -595,13 +596,20 @@ declare class ClobClient {
     buildMatchComplementaryIxs(takerSigned: SignedOrder, makersSigned: SignedOrder[], collateralMint: PublicKey, feeRecipient: PublicKey, operator: PublicKey, opts?: {
         marketOracleVault?: PublicKey;
         fillAmount?: anchor.BN;
-    }): Promise<TransactionInstruction[]>;
+    }, useTakerPrice?: boolean): Promise<TransactionInstruction[]>;
     /**
      * COMPLEMENTARY: 1 taker (BUY) + N makers (SELL), same tokenId.
      * Phase 1: register taker + all makers in parallel.
      * Phase 2: 1 atomic match tx.
      */
     private matchComplementary;
+    /**
+     * 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.
+     */
+    private matchComplementarySellVsMultiBuy;
     /**
      * MINT: 1 YES buyer (taker) + N NO buyers (makers).
      * Phase 1: register taker + all NO makers in parallel.
@@ -638,6 +646,48 @@ declare class ClobClient {
     matchOrders(taker: SignedOrder, makers: SignedOrder[], opts?: {
         marketOracleVault?: PublicKey;
     }): Promise<TxResult>;
+    /**
+     * 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)
+     */
+    matchOrdersFromPrice(taker: {
+        keypair: {
+            publicKey: PublicKey;
+            secretKey: Uint8Array;
+        };
+        condition: PublicKey;
+        tokenId: number;
+        side: 0 | 1;
+        price: number;
+        quantity: number;
+        nonce?: BN;
+        expiry?: BN;
+        fee?: BN;
+        taker?: PublicKey;
+    }, makers: Array<{
+        keypair: {
+            publicKey: PublicKey;
+            secretKey: Uint8Array;
+        };
+        condition: PublicKey;
+        tokenId: number;
+        side: 0 | 1;
+        price: number;
+        quantity: number;
+        nonce?: BN;
+        expiry?: BN;
+        fee?: BN;
+        taker?: PublicKey;
+    }>, decimals?: number, opts?: {
+        marketOracleVault?: PublicKey;
+    }): Promise<TxResult>;
     fetchConfig(): Promise<ClobConfig | null>;
     fetchOrderStatus(maker: PublicKey, nonce: anchor.BN): Promise<OrderStatus | null>;
     fetchOrderRecord(maker: PublicKey, nonce: anchor.BN): Promise<{
@@ -939,6 +989,51 @@ declare function buildOrder(params: {
     fee?: BN;
     taker?: PublicKey;
 }): Order;
+/**
+ * Compute makerAmount / takerAmount from a limit price and quantity.
+ *
+ * ALWAYS use the order's own limit price (e.g., 51 for a 51% limit order).
+ * NEVER pass `averageMatchedPrice` — that is an output of the matching engine,
+ * not an order input. Using avgPrice here causes crossing checks to fail
+ * for any maker whose price equals the limit price exactly.
+ *
+ * BUY  YES (side=0): makerAmount = USDS spent = qty × price/100
+ *                    takerAmount = YES received = qty
+ * SELL YES (side=1): makerAmount = YES given   = qty
+ *                    takerAmount = USDS received = qty × price/100
+ *
+ * @param side      0 = BUY, 1 = SELL
+ * @param price     Limit price in percentage cents (e.g., 51 for 51% = $0.51/token)
+ * @param quantity  Whole token count (e.g., 11 for 11 YES tokens)
+ * @param decimals  Collateral token decimals (default 9 for USDS)
+ */
+declare function orderAmountsFromPrice(side: 0 | 1, price: number, quantity: number, decimals?: number): {
+    makerAmount: BN;
+    takerAmount: BN;
+};
+/**
+ * Build a fully-populated Order from human-readable price + quantity.
+ * Amounts are computed using the limit price — never use averageMatchedPrice.
+ *
+ * @param params.side      0 = BUY, 1 = SELL
+ * @param params.price     Limit price in percentage (e.g., 51 for 51%)
+ * @param params.quantity  Whole token count (e.g., 11 for 11 YES tokens)
+ * @param params.decimals  Collateral decimals (default 9 for USDS)
+ */
+declare function buildOrderFromPrice(params: {
+    maker: PublicKey;
+    condition: PublicKey;
+    tokenId: number;
+    side: 0 | 1;
+    price: number;
+    quantity: number;
+    decimals?: number;
+    nonce?: BN;
+    expiry?: BN;
+    createdAt?: BN;
+    fee?: BN;
+    taker?: PublicKey;
+}): Order;
 /**
  * Sign an order with a Keypair.
  * Uses Ed25519 (nacl.sign.detached) over the 178-byte canonical message.
@@ -1005,4 +1100,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, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, 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, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };