drama-pm-client 0.4.9 → 0.4.10

package/dist/index.d.ts

@@ -57,6 +57,29 @@ export interface RefundParams {
     tokenAmount?: number | BN;
     closeAccount?: boolean;
 }
+/**
+ * Parameters for refundV2 - refunding both Yes and No positions in one transaction.
+ * Use this when a user has bet on both outcomes and wants to refund everything at once.
+ */
+export interface RefundV2Params {
+    user: PublicKey;
+    market: PublicKey;
+    bettingToken: PublicKey;
+    yesTokenAmount?: number | BN;
+    noTokenAmount?: number | BN;
+    closeYesAccount?: boolean;
+    closeNoAccount?: boolean;
+}
+/**
+ * Parameters for claim_burn_market instruction
+ * Combines claiming rewards (if won) and burning tokens (if lost) in one call.
+ * Always closes token accounts to reclaim rent.
+ */
+export interface ClaimBurnMarketParams {
+    user: PublicKey;
+    market: PublicKey;
+    bettingToken: PublicKey;
+}
 /**
  * Parameters for placeBetV2 - combines user bet and bonus account bet in one transaction
  * Requires both user and bonusAccount to sign the transaction
@@ -249,6 +272,62 @@ export declare class DramaPmClient {
      * Build a complete transaction to refund
      */
     buildRefundTx(params: RefundParams): Promise<Transaction>;
+    /**
+     * Refund both Yes and No positions in a single transaction.
+     *
+     * Use this method when a user has bet on both Yes and No outcomes and needs to
+     * refund all positions after the market has been resolved as "Refunded" (None).
+     *
+     * This method automatically:
+     * - Checks if the user has Yes tokens and/or No tokens
+     * - Only includes refund instructions for outcomes the user actually holds
+     * - Closes the token accounts after refunding (by default)
+     *
+     * @param params - RefundV2Params
+     * @param params.user - User's public key (signer)
+     * @param params.market - Market PDA address
+     * @param params.bettingToken - Betting token mint (e.g., USDC)
+     * @param params.yesTokenAmount - Optional. Amount of Yes tokens to refund. 0 or undefined = refund all.
+     * @param params.noTokenAmount - Optional. Amount of No tokens to refund. 0 or undefined = refund all.
+     * @param params.closeYesAccount - Optional. Whether to close the Yes token account after refund. Default: true
+     * @param params.closeNoAccount - Optional. Whether to close the No token account after refund. Default: true
+     *
+     * @returns Transaction containing refund instructions for both outcomes (if applicable)
+     *
+     * @example
+     * ```typescript
+     * // Basic usage: Refund all Yes and No tokens
+     * const tx = await client.buildRefundV2Tx({
+     *   user: userPublicKey,
+     *   market: marketPda,
+     *   bettingToken: usdcMint,
+     * });
+     *
+     * // Sign and send
+     * tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
+     * tx.feePayer = userPublicKey;
+     * await wallet.signTransaction(tx);
+     * await connection.sendRawTransaction(tx.serialize());
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Keep token accounts open (don't close them)
+     * const tx = await client.buildRefundV2Tx({
+     *   user: userPublicKey,
+     *   market: marketPda,
+     *   bettingToken: usdcMint,
+     *   closeYesAccount: false, // Keep Yes token account open
+     *   closeNoAccount: false,  // Keep No token account open
+     * });
+     * ```
+     *
+     * @remarks
+     * - The market must be in "Refunded" status for this method to work
+     * - If the user only has tokens on one side, only that side will be refunded
+     * - The returned transaction will be empty if the user has no tokens on either side
+     */
+    buildRefundV2Tx(params: RefundV2Params): Promise<Transaction>;
     /**
      * Resolve a market (Admin only)
      */
@@ -305,6 +384,20 @@ export declare class DramaPmClient {
      * @param closeAccount - Whether to close the losing token account after burning all tokens (default: false)
      */
     buildBurnMarketTokensTx(user: PublicKey, market: PublicKey, losingOutcome: Outcome, tokenAmount?: number | BN, closeAccount?: boolean): Promise<Transaction>;
+    /**
+     * Claim rewards if won, or burn tokens if lost, with optional account closure.
+     * This instruction combines claim_rewards and burn_market_tokens logic into a single call.
+     *
+     * @param params - ClaimBurnMarketParams
+     * @param userYesToken - User's YES token account (optional, pass null if user has no YES tokens)
+     * @param userNoToken - User's NO token account (optional, pass null if user has no NO tokens)
+     */
+    claimBurnMarket(params: ClaimBurnMarketParams, userYesToken: PublicKey | null, userNoToken: PublicKey | null): Promise<TransactionInstruction>;
+    /**
+     * Build a complete transaction to claim rewards (if won) or burn tokens (if lost)
+     * Automatically creates user outcome token accounts based on user's holdings
+     */
+    buildClaimBurnMarketTx(params: ClaimBurnMarketParams): Promise<Transaction>;
     /**
      * Fetch global config account data
      */