@theliem/xmarket-sdk 3.12.0 → 3.16.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 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 { PublicKey, SYSVAR_INSTRUCTIONS_PUBKEY, SystemProgram, SYSVAR_RENT_PUBKEY, ComputeBudgetProgram, TransactionMessage, VersionedTransaction, Transaction, TransactionInstruction, Ed25519Program, AddressLookupTableProgram, 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 BN4 from 'bn.js';
@@ -24,6 +24,7 @@ var SEEDS = {
   clobConfig: Buffer.from("clob_config"),
   order: Buffer.from("order"),
   feeConfig: Buffer.from("fee_config"),
+  referralConfig: Buffer.from("referral_config"),
   questionFee: Buffer.from("question_fee"),
   marketFee: Buffer.from("market_fee"),
   // Presale
@@ -224,6 +225,14 @@ var PDA = class {
       programIds.marketOracle
     );
   }
+  // ─── Referral Program ────────────────────────────────────────────────────
+  static referralConfig(owner, programIds) {
+    if (!programIds.referral) throw new Error("referral program ID not configured");
+    return PublicKey.findProgramAddressSync(
+      [SEEDS.referralConfig, owner.toBuffer()],
+      programIds.referral
+    );
+  }
   // ─── Admin Contract ──────────────────────────────────────────────────────
   static adminConfig(owner, programIds) {
     if (!programIds.adminContract) throw new Error("adminContract program ID not configured");
@@ -496,7 +505,7 @@ var QuestionStatus = /* @__PURE__ */ ((QuestionStatus2) => {
   QuestionStatus2["Resolved"] = "resolved";
   return QuestionStatus2;
 })(QuestionStatus || {});
-var FEE_DENOMINATOR = 1e6;
+var FEE_DENOMINATOR = 1e4;
 var XMarketError = class extends Error {
   constructor(message, code) {
     super(message);
@@ -561,6 +570,8 @@ var MarketClient = class {
     const [noMint] = PDA.noMint(conditionPda, this.programIds);
     const [mintAuthority] = PDA.mintAuthority(conditionPda, this.programIds);
     const [collateralVault] = PDA.collateralVault(params.collateralMint, this.programIds);
+    if (!this.programIds.feeManagement) throw new Error("feeManagement program ID not configured");
+    const [questionFeePda] = PDA.questionFee(conditionPda, this.programIds);
     const tx = await this.program.methods.createQuestionAdmin({
       questionId: Array.from(questionId),
       contentHash: Array.from(contentHash),
@@ -580,6 +591,8 @@ var MarketClient = class {
       mintAuthority,
       collateralVault,
       conditionalTokensProgram: this.programIds.conditionalTokens,
+      questionFee: questionFeePda,
+      feeManagementProgram: this.programIds.feeManagement,
       tokenProgram: TOKEN_2022_PROGRAM_ID,
       systemProgram: SystemProgram.programId,
       rent: SYSVAR_RENT_PUBKEY
@@ -778,9 +791,25 @@ var MarketClient = class {
    * @param creator         presale creator pubkey (stored in question)
    * @param currencyMint    collateral mint
    */
-  async approvePresale(presalePda, contentHash, hookProgram, authorizedClob, expirationTime, creator, currencyMint, caller = this.walletPubkey, payer = caller) {
+  async approvePresale(params) {
+    const {
+      presalePda,
+      contentHash,
+      hookProgram,
+      authorizedClob,
+      expirationTime,
+      creator,
+      currencyMint,
+      referralAddress,
+      companyAddress,
+      adminOwner
+    } = params;
+    const caller = params.caller ?? this.walletPubkey;
+    const payer = params.payer ?? caller;
     if (!this.programIds.presale) throw new Error("presale program ID not configured");
     if (!this.programIds.marketOracle) throw new Error("marketOracle program ID not configured");
+    if (!this.programIds.feeManagement) throw new Error("feeManagement program ID not configured");
+    if (!this.programIds.adminContract) throw new Error("adminContract program ID not configured");
     const questionId = presalePda.toBytes();
     const [questionPda] = PDA.question(this.configPda, questionId, this.programIds);
     const marketConfig = await this.fetchConfig();
@@ -793,7 +822,14 @@ var MarketClient = class {
     const [collateralVault] = PDA.collateralVault(currencyMint, this.programIds);
     const [marketOraclePda] = PDA.marketOraclePda(questionPda, this.programIds);
     const marketOracleVault = getAssociatedTokenAddressSync(currencyMint, marketOraclePda, true);
-    const tx = await this.program.methods.approvePresale({
+    const [questionFeePda] = PDA.questionFee(conditionPda, this.programIds);
+    const presaleVault = getAssociatedTokenAddressSync(currencyMint, presalePda, true);
+    const referralTokenAccount = getAssociatedTokenAddressSync(currencyMint, referralAddress);
+    const companyTokenAccount = getAssociatedTokenAddressSync(currencyMint, companyAddress);
+    const [adminConfig] = PDA.adminConfig(adminOwner, this.programIds);
+    const adminVault = getAssociatedTokenAddressSync(currencyMint, adminConfig, true);
+    const [claimRecord] = PDA.claimRecord(conditionPda.toBytes(), this.programIds);
+    const builder = this.program.methods.approvePresale({
       contentHash: Array.from(contentHash),
       hookProgram,
       authorizedClob,
@@ -814,15 +850,38 @@ var MarketClient = class {
       collateralVault,
       marketOracle: marketOraclePda,
       marketOracleVault,
+      presaleVault,
+      referralTokenAccount,
+      companyTokenAccount,
+      adminVault,
+      adminConfig,
+      claimRecord,
+      questionFee: questionFeePda,
+      feeManagementProgram: this.programIds.feeManagement,
       conditionalTokensProgram: this.programIds.conditionalTokens,
       presaleProgram: this.programIds.presale,
       marketOracleProgram: this.programIds.marketOracle,
+      adminProgram: this.programIds.adminContract,
       tokenProgram: TOKEN_PROGRAM_ID,
       token2022Program: TOKEN_2022_PROGRAM_ID,
       associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
       systemProgram: SystemProgram.programId,
       rent: SYSVAR_RENT_PUBKEY
-    }).transaction();
+    });
+    let tx;
+    if (params.lookupTable) {
+      const ix = await builder.instruction();
+      const cu = ComputeBudgetProgram.setComputeUnitLimit({ units: 14e5 });
+      const { blockhash } = await this.provider.connection.getLatestBlockhash();
+      const msg = new TransactionMessage({
+        payerKey: payer,
+        recentBlockhash: blockhash,
+        instructions: [cu, ix]
+      }).compileToV0Message([params.lookupTable]);
+      tx = new VersionedTransaction(msg);
+    } else {
+      tx = await builder.transaction();
+    }
     return { tx, questionPda, conditionPda, marketOraclePda, marketOracleVault };
   }
   /**
@@ -1312,6 +1371,49 @@ function buildBatchedEd25519Instruction(orders) {
   });
 }
 var IX_SYSVAR = SYSVAR_INSTRUCTIONS_PUBKEY;
+function serializeCollectFeeOrderToBytes(order) {
+  const buf = new Uint8Array(120);
+  buf.set(order.user.toBytes(), 0);
+  buf.set(order.condition.toBytes(), 32);
+  buf.set(order.tokenMint.toBytes(), 64);
+  buf.set(order.amount.toArrayLike(Buffer, "le", 8), 96);
+  buf.set(order.nonce.toArrayLike(Buffer, "le", 8), 104);
+  buf.set(order.expiry.toArrayLike(Buffer, "le", 8), 112);
+  return buf;
+}
+function buildBatchedCollectFeeEd25519Instruction(orders) {
+  const N = orders.length;
+  if (N === 0) throw new Error("At least 1 order required");
+  const MSG_SIZE = 120;
+  const SIG_SIZE = 64;
+  const PK_SIZE = 32;
+  const HEADER = 2 + N * 14;
+  const sigBase = HEADER;
+  const pkBase = sigBase + N * SIG_SIZE;
+  const msgBase = pkBase + N * PK_SIZE;
+  const totalSize = msgBase + N * MSG_SIZE;
+  const data = Buffer.alloc(totalSize);
+  data[0] = N;
+  data[1] = 0;
+  for (let i = 0; i < N; i++) {
+    const e = 2 + i * 14;
+    data.writeUInt16LE(sigBase + i * SIG_SIZE, e);
+    data.writeUInt16LE(65535, e + 2);
+    data.writeUInt16LE(pkBase + i * PK_SIZE, e + 4);
+    data.writeUInt16LE(65535, e + 6);
+    data.writeUInt16LE(msgBase + i * MSG_SIZE, e + 8);
+    data.writeUInt16LE(MSG_SIZE, e + 10);
+    data.writeUInt16LE(65535, e + 12);
+    data.set(orders[i].signature, sigBase + i * SIG_SIZE);
+    data.set(orders[i].order.user.toBytes(), pkBase + i * PK_SIZE);
+    data.set(serializeCollectFeeOrderToBytes(orders[i].order), msgBase + i * MSG_SIZE);
+  }
+  return new TransactionInstruction({
+    keys: [],
+    programId: Ed25519Program.programId,
+    data
+  });
+}
 function buildOrder(params) {
   return {
     maker: params.maker,
@@ -1429,10 +1531,17 @@ var ClobClient = class {
     if (!this.feeClient || !this.feeConfigOwner) return void 0;
     if (!this._companyAddress) {
       const cfg = await this.feeClient.fetchFeeConfig(this.feeConfigOwner);
-      if (cfg) this._companyAddress = cfg.companyAddress;
+      if (cfg) {
+        this._companyAddress = cfg.companyAddress;
+        this._referralVault = cfg.referralVault;
+      }
     }
     return this._companyAddress;
   }
+  async referralVault() {
+    await this.companyAddress();
+    return this._referralVault;
+  }
   get walletPubkey() {
     return this.provider.wallet.publicKey;
   }
@@ -1523,6 +1632,7 @@ var ClobClient = class {
     }
     if (this.programIds.feeManagement && this.feeConfigOwner) {
       const companyAddr = await this.companyAddress();
+      const refVault = await this.referralVault();
       addresses.push(
         this.programIds.feeManagement,
         PDA.feeConfig(this.feeConfigOwner, this.programIds)[0],
@@ -1532,6 +1642,10 @@ var ClobClient = class {
         addresses.push(getAssociatedTokenAddressSync(collateralMint, companyAddr));
       }
       addresses.push(payer);
+      if (refVault) {
+        addresses.push(refVault);
+      }
+      addresses.push(TOKEN_PROGRAM_ID);
     }
     const slot = await connection.getSlot("finalized");
     const [createIx, altAddress] = AddressLookupTableProgram.createLookupTable({
@@ -1566,8 +1680,8 @@ var ClobClient = class {
   async _sendLegacyTxSig(instructions) {
     const { connection } = this.provider;
     const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
-    const { Transaction: Transaction8 } = await import('@solana/web3.js');
-    const tx = new Transaction8();
+    const { Transaction: Transaction10 } = await import('@solana/web3.js');
+    const tx = new Transaction10();
     tx.recentBlockhash = blockhash;
     tx.feePayer = this.walletPubkey;
     tx.add(...instructions);
@@ -1593,10 +1707,10 @@ ${logs.join("\n")}`);
       connection.getAccountInfo(clobYesAta),
       connection.getAccountInfo(clobNoAta)
     ]);
-    const { createAssociatedTokenAccountIdempotentInstruction: createAssociatedTokenAccountIdempotentInstruction3 } = await import('@solana/spl-token');
+    const { createAssociatedTokenAccountIdempotentInstruction: createAssociatedTokenAccountIdempotentInstruction4 } = await import('@solana/spl-token');
     const ixs = [];
     if (!yesInfo) {
-      ixs.push(createAssociatedTokenAccountIdempotentInstruction3(
+      ixs.push(createAssociatedTokenAccountIdempotentInstruction4(
         this.walletPubkey,
         clobYesAta,
         clobConfig,
@@ -1605,7 +1719,7 @@ ${logs.join("\n")}`);
       ));
     }
     if (!noInfo) {
-      ixs.push(createAssociatedTokenAccountIdempotentInstruction3(
+      ixs.push(createAssociatedTokenAccountIdempotentInstruction4(
         this.walletPubkey,
         clobNoAta,
         clobConfig,
@@ -1789,7 +1903,8 @@ ${logs.join("\n")}`);
     let feeAccounts = [];
     if (takerSigned.order.fee.gtn(0) && this.programIds.feeManagement && this.feeConfigOwner) {
       const companyAddr = await this.companyAddress();
-      if (companyAddr) {
+      const refVault = await this.referralVault();
+      if (companyAddr && refVault) {
         const feeOverridePda = PDA.marketFeeOverride(condition, this.programIds)[0];
         const feeOverrideExists = await this.provider.connection.getAccountInfo(feeOverridePda);
         if (feeOverrideExists) {
@@ -1799,7 +1914,8 @@ ${logs.join("\n")}`);
             { pubkey: PDA.feeConfig(this.feeConfigOwner, this.programIds)[0], isSigner: false, isWritable: false },
             { pubkey: feeOverridePda, isSigner: false, isWritable: false },
             { pubkey: getAssociatedTokenAddressSync(collateralMint, companyAddr), isSigner: false, isWritable: true },
-            { pubkey: oracleVault, isSigner: false, isWritable: true }
+            { pubkey: oracleVault, isSigner: false, isWritable: true },
+            { pubkey: refVault, isSigner: false, isWritable: true }
           ];
         }
       }
@@ -2043,7 +2159,8 @@ ${logs.join("\n")}`);
     );
     if (yesSigned.order.fee.gtn(0) && this.programIds.feeManagement && this.feeConfigOwner) {
       const companyAddr = await this.companyAddress();
-      if (companyAddr) {
+      const refVault = await this.referralVault();
+      if (companyAddr && refVault) {
         const feeOverridePda = PDA.marketFeeOverride(condition, this.programIds)[0];
         const feeOverrideExists = await this.provider.connection.getAccountInfo(feeOverridePda);
         if (feeOverrideExists) {
@@ -2053,7 +2170,9 @@ ${logs.join("\n")}`);
             { pubkey: PDA.feeConfig(this.feeConfigOwner, this.programIds)[0], isSigner: false, isWritable: false },
             { pubkey: feeOverridePda, isSigner: false, isWritable: false },
             { pubkey: getAssociatedTokenAddressSync(collateralMint, companyAddr), isSigner: false, isWritable: true },
-            { pubkey: oracleVault, isSigner: false, isWritable: true }
+            { pubkey: oracleVault, isSigner: false, isWritable: true },
+            { pubkey: refVault, isSigner: false, isWritable: true },
+            { pubkey: TOKEN_PROGRAM_ID, isSigner: false, isWritable: false }
           );
         }
       }
@@ -2324,6 +2443,103 @@ ${logs.join("\n")}`);
     }
     return this._buildUnsignedVtx(ixs, alt, payer);
   }
+  // ─── batchCollectRedeemEarly ─────────────────────────────────────────────────
+  /**
+   * Build VersionedTransaction for batchCollectRedeemEarly.
+   *
+   * Flow: Ed25519 ix (user sigs) + batchCollectRedeemEarly ix.
+   * Each SignedCollectFeeOrder authorizes CLOB to collect `amount` winning tokens
+   * from that user, redeem via CTF, then distribute as fees.
+   *
+   * @param signedOrders  - Array of { order, signature } from winning users
+   * @param condition     - Market condition PDA
+   * @param outcomeIndex  - 0 = NO wins, 1 = YES wins
+   * @param operator      - Whitelisted operator pubkey (must sign)
+   * @param payer         - Fee payer pubkey (must sign)
+   * @param opts.marketOracleVault - MarketOracle vault for fee distribution
+   */
+  async buildBatchCollectRedeemEarlyTx(signedOrders, condition, outcomeIndex, operator, payer, opts) {
+    if (signedOrders.length === 0) throw new InvalidParamError("At least 1 order required");
+    const collateralMint = this.networkConfig.defaultCollateral.mint;
+    const cfg = await this.fetchConfig();
+    if (!cfg) throw new InvalidParamError("CLOB config not found on-chain");
+    const clobConfig = this.configPda();
+    const [yesMint] = PDA.yesMint(condition, this.programIds);
+    const [noMint] = PDA.noMint(condition, this.programIds);
+    const [collateralVault] = PDA.collateralVault(collateralMint, this.programIds);
+    const [vaultTokenAccount] = PDA.vaultToken(collateralMint, this.programIds);
+    const clobYesAta = getAssociatedTokenAddressSync(yesMint, clobConfig, true, TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = getAssociatedTokenAddressSync(noMint, clobConfig, true, TOKEN_2022_PROGRAM_ID);
+    const outcomeMint = outcomeIndex === 1 ? yesMint : noMint;
+    const [extraAccountMeta] = PDA.extraAccountMetaList(outcomeMint, this.programIds);
+    const [hookConfig] = PDA.hookConfig(this.programIds);
+    const [clobYesPosition] = PDA.position(condition, 1, clobConfig, this.programIds);
+    const [clobNoPosition] = PDA.position(condition, 0, clobConfig, this.programIds);
+    const userAccounts = [];
+    for (const { order } of signedOrders) {
+      const userTokenAta = getAssociatedTokenAddressSync(outcomeMint, order.user, false, TOKEN_2022_PROGRAM_ID);
+      const [userPosition] = PDA.position(condition, outcomeIndex, order.user, this.programIds);
+      userAccounts.push(
+        { pubkey: order.user, isSigner: false, isWritable: false },
+        { pubkey: userTokenAta, isSigner: false, isWritable: true },
+        { pubkey: userPosition, isSigner: false, isWritable: true }
+      );
+    }
+    const hookAccounts = [
+      { pubkey: extraAccountMeta, isSigner: false, isWritable: false },
+      { pubkey: hookConfig, isSigner: false, isWritable: false },
+      { pubkey: this.programIds.hook, isSigner: false, isWritable: false }
+    ];
+    let feeAccounts = [];
+    if (this.programIds.feeManagement && this.feeConfigOwner) {
+      const companyAddr = await this.companyAddress();
+      const refVault = await this.referralVault();
+      if (companyAddr && refVault) {
+        const feeOverridePda = PDA.marketFeeOverride(condition, this.programIds)[0];
+        const feeOverrideExists = await this.provider.connection.getAccountInfo(feeOverridePda);
+        if (feeOverrideExists) {
+          const oracleVault = opts?.marketOracleVault ?? payer;
+          feeAccounts = [
+            { pubkey: this.programIds.feeManagement, isSigner: false, isWritable: false },
+            { pubkey: PDA.feeConfig(this.feeConfigOwner, this.programIds)[0], isSigner: false, isWritable: false },
+            { pubkey: feeOverridePda, isSigner: false, isWritable: false },
+            { pubkey: getAssociatedTokenAddressSync(collateralMint, companyAddr), isSigner: false, isWritable: true },
+            { pubkey: oracleVault, isSigner: false, isWritable: true },
+            { pubkey: refVault, isSigner: false, isWritable: true }
+          ];
+        }
+      }
+    }
+    await this._ensureClobOutcomeAtas(yesMint, noMint, clobConfig, clobYesAta, clobNoAta);
+    const ed25519Ix = buildBatchedCollectFeeEd25519Instruction(signedOrders);
+    const collectIx = await this.program.methods.batchCollectRedeemEarly(
+      2,
+      // ix_index: Ed25519 ix is ix[2] (cuLimit=0, heapFrame=1, ed25519=2)
+      signedOrders.length,
+      outcomeIndex
+    ).accounts({
+      operator,
+      payer,
+      clobConfig,
+      condition,
+      collateralVault,
+      vaultTokenAccount,
+      feeRecipient: cfg.feeRecipient,
+      yesMint,
+      noMint,
+      clobYesAta,
+      clobNoAta,
+      clobYesPosition,
+      clobNoPosition,
+      ixSysvar: IX_SYSVAR,
+      conditionalTokensProgram: this.programIds.conditionalTokens,
+      tokenProgram: TOKEN_PROGRAM_ID,
+      token2022Program: TOKEN_2022_PROGRAM_ID,
+      systemProgram: SystemProgram.programId
+    }).remainingAccounts([...userAccounts, ...hookAccounts, ...feeAccounts]).instruction();
+    const cachedAlt = this._altCache.get(condition.toBase58());
+    return this._buildUnsignedVtx([ed25519Ix, collectIx], cachedAlt, payer);
+  }
   // ─── Queries ─────────────────────────────────────────────────────────────────
   async fetchConfig() {
     try {
@@ -2372,20 +2588,22 @@ var FeeManagementClient = class {
     this.provider = provider;
     this.programIds = programIds;
   }
-  async initFeeConfig(admin, companyAddress, referralAddress, presaleRevenueAddress, investorsMarketRev, companyMarketRev, agentsPresaleRev, companyPresaleRev, authority, payer) {
-    const [feeConfigPda] = PDA.feeConfig(authority, this.programIds);
+  async initFeeConfig(params) {
+    const [feeConfigPda] = PDA.feeConfig(params.authority, this.programIds);
     const sig = await this.program.methods.initialize({
-      admin,
-      companyAddress,
-      referralAddress,
-      presaleRevenueAddress,
-      investorsMarketRev,
-      companyMarketRev,
-      agentsPresaleRev,
-      companyPresaleRev
+      admin: params.admin,
+      companyAddress: params.companyAddress,
+      referralAddress: params.referralAddress,
+      presaleRevenueAddress: params.presaleRevenueAddress,
+      investorsMarketRev: params.investorsMarketRev,
+      companyMarketRev: params.companyMarketRev,
+      agentsPresaleRev: params.agentsPresaleRev,
+      companyPresaleRev: params.companyPresaleRev,
+      referralMarketRev: params.referralMarketRev,
+      referralVault: params.referralVault
     }).accounts({
-      authority,
-      payer,
+      authority: params.authority,
+      payer: params.payer,
       feeConfig: feeConfigPda,
       systemProgram: SystemProgram.programId
     }).signers([]).rpc();
@@ -2400,9 +2618,14 @@ var FeeManagementClient = class {
     }
   }
   /**
-   * Fetch per-question fees for a condition.
-   * Returns null if no fees have been set yet.
+   * Fetch per-market fees for a condition.
+   * Returns null if fees have not been initialized yet.
+   * Fees are set automatically via CPI when create_question_admin / approve_presale runs.
+   * Defaults: swapFee=200 (2%), redeemFee=0, mergeFee=2000 (20%), out of FEE_DENOMINATOR=10_000.
    */
+  async getMarketFee(conditionPda) {
+    return this.fetchQuestionFee(conditionPda);
+  }
   async fetchQuestionFee(conditionPda) {
     try {
       const [pda] = PDA.questionFee(conditionPda, this.programIds);
@@ -2419,28 +2642,30 @@ var FeeManagementClient = class {
     }
   }
   /**
-   * Set per-question fees for a condition.
+   * Set per-question fees for a condition (whitelist-only edit after market creation).
    * @param conditionPda   - condition PDA from the question
-   * @param mergeFee       - fee out of FEE_DENOMINATOR (1_000_000), e.g. 2_000 = 0.2%
+   * @param mergeFee       - fee out of FEE_DENOMINATOR (10_000), e.g. 2_000 = 20%
    * @param redeemFee      - fee out of FEE_DENOMINATOR
-   * @param swapFee        - trading fee out of FEE_DENOMINATOR
+   * @param swapFee        - trading fee out of FEE_DENOMINATOR, e.g. 200 = 2%
    * @param feeConfigOwner - pubkey that owns the fee_config PDA (usually market deployer)
    * @param authority      - signer authorized in fee_config whitelist / admin / owner
    * @param payer          - rent + tx fee payer
    */
-  async updateFeeConfig(companyAddress, referralAddress, presaleRevenueAddress, investorsMarketRev, companyMarketRev, agentsPresaleRev, companyPresaleRev, authority, payer) {
-    const [feeConfigPda] = PDA.feeConfig(authority, this.programIds);
+  async updateFeeConfig(params) {
+    const [feeConfigPda] = PDA.feeConfig(params.authority, this.programIds);
     const sig = await this.program.methods.updateConfig({
-      companyAddress,
-      referralAddress,
-      presaleRevenueAddress,
-      investorsMarketRev,
-      companyMarketRev,
-      agentsPresaleRev,
-      companyPresaleRev
+      companyAddress: params.companyAddress,
+      referralAddress: params.referralAddress,
+      presaleRevenueAddress: params.presaleRevenueAddress,
+      investorsMarketRev: params.investorsMarketRev,
+      companyMarketRev: params.companyMarketRev,
+      agentsPresaleRev: params.agentsPresaleRev,
+      companyPresaleRev: params.companyPresaleRev,
+      referralMarketRev: params.referralMarketRev,
+      referralVault: params.referralVault
     }).accounts({
-      authority,
-      payer,
+      authority: params.authority,
+      payer: params.payer,
       feeConfig: feeConfigPda
     }).signers([]).rpc();
     return { signature: sig };
@@ -2457,33 +2682,33 @@ var FeeManagementClient = class {
     }).signers([]).rpc();
     return { signature: sig };
   }
-  async buildDistributeFeeIx(conditionPda, amount, feeConfigOwner, sourceAta, companyAta, marketOracleVault, authority) {
+  /**
+   * Build editMarketFee transaction (whitelist-only).
+   * @param conditionPda   - condition PDA (market identifier)
+   * @param mergeFee       - out of FEE_DENOMINATOR (10_000), e.g. 2_000 = 20%
+   * @param redeemFee      - out of FEE_DENOMINATOR
+   * @param swapFee        - trading fee out of FEE_DENOMINATOR, e.g. 200 = 2%
+   * @param feeConfigOwner - owner of fee_config PDA
+   * @param authority      - whitelisted signer (signs tx externally)
+   * @param payer          - fee payer (can differ from authority)
+   */
+  async buildEditMarketFeeTx(conditionPda, mergeFee, redeemFee, swapFee, feeConfigOwner, authority, payer = authority) {
     const [feeConfigPda] = PDA.feeConfig(feeConfigOwner, this.programIds);
-    const [marketFeeOverridePda] = PDA.marketFeeOverride(conditionPda, this.programIds);
-    return this.program.methods.distributeFee(conditionPda, amount).accounts({
-      feeConfig: feeConfigPda,
-      marketFeeOverride: marketFeeOverridePda,
+    const [questionFeePda] = PDA.questionFee(conditionPda, this.programIds);
+    return this.program.methods.setQuestionFee(
+      Array.from(conditionPda.toBytes()),
+      mergeFee,
+      redeemFee,
+      swapFee
+    ).accounts({
       authority,
-      sourceAta,
-      companyAta,
-      marketOracleVault,
-      tokenProgram: new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA")
-    }).instruction();
-  }
-  async distributeFee(conditionPda, amount, feeConfigOwner, sourceAta, companyAta, marketOracleVault, authority) {
-    const [feeConfigPda] = PDA.feeConfig(feeConfigOwner, this.programIds);
-    const [marketFeeOverridePda] = PDA.marketFeeOverride(conditionPda, this.programIds);
-    const sig = await this.program.methods.distributeFee(conditionPda, amount).accounts({
+      payer,
       feeConfig: feeConfigPda,
-      marketFeeOverride: marketFeeOverridePda,
-      authority,
-      sourceAta,
-      companyAta,
-      marketOracleVault,
-      tokenProgram: new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA")
-    }).signers([]).rpc();
-    return { signature: sig };
+      questionFee: questionFeePda,
+      systemProgram: SystemProgram.programId
+    }).transaction();
   }
+  /** @deprecated use buildEditMarketFeeTx */
   async setQuestionFee(conditionPda, mergeFee, redeemFee, swapFee, feeConfigOwner, authority, payer) {
     const [feeConfigPda] = PDA.feeConfig(feeConfigOwner, this.programIds);
     const [questionFeePda] = PDA.questionFee(conditionPda, this.programIds);
@@ -2841,6 +3066,98 @@ var AdminClient = class {
     }).transaction();
   }
 };
+var ReferralClient = class {
+  constructor(program, provider, programIds) {
+    this.program = program;
+    this.provider = provider;
+    this.programIds = programIds;
+  }
+  get walletPubkey() {
+    return this.provider.wallet.publicKey;
+  }
+  referralVault(owner, collateralMint) {
+    const [configPda] = PDA.referralConfig(owner, this.programIds);
+    return getAssociatedTokenAddressSync(collateralMint, configPda, true);
+  }
+  async fetchConfig(owner) {
+    try {
+      const [pda] = PDA.referralConfig(owner, this.programIds);
+      const acc = await this.program.account.referralConfig.fetch(pda);
+      return {
+        owner: acc.owner,
+        collateralMint: acc.collateralMint,
+        whitelist: acc.whitelist.slice(0, acc.whitelistLen),
+        bump: acc.bump
+      };
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Build initialize tx — creates referral config PDA.
+   * Also prepends an ATA creation instruction for the referral vault (idempotent).
+   * Build-tx pattern.
+   */
+  async buildInitializeTx(collateralMint, owner = this.walletPubkey, payer = owner) {
+    if (!this.programIds.referral) throw new Error("referral program ID not configured");
+    const [configPda] = PDA.referralConfig(owner, this.programIds);
+    const vaultAta = getAssociatedTokenAddressSync(collateralMint, configPda, true);
+    const createVaultIx = createAssociatedTokenAccountIdempotentInstruction(
+      payer,
+      vaultAta,
+      configPda,
+      collateralMint
+    );
+    const initTx = await this.program.methods.initialize().accounts({
+      owner,
+      payer,
+      config: configPda,
+      collateralMint,
+      systemProgram: SystemProgram.programId
+    }).transaction();
+    const tx = new Transaction().add(createVaultIx, ...initTx.instructions);
+    return { tx, configPda, vaultAta };
+  }
+  /** Build add-to-whitelist tx. Build-tx pattern. */
+  async buildAddToWhitelistTx(address, owner = this.walletPubkey, payer = owner) {
+    if (!this.programIds.referral) throw new Error("referral program ID not configured");
+    const [configPda] = PDA.referralConfig(owner, this.programIds);
+    return this.program.methods.addToWhitelist(address).accounts({ owner, payer, config: configPda }).transaction();
+  }
+  /** Build remove-from-whitelist tx. Build-tx pattern. */
+  async buildRemoveFromWhitelistTx(address, owner = this.walletPubkey, payer = owner) {
+    if (!this.programIds.referral) throw new Error("referral program ID not configured");
+    const [configPda] = PDA.referralConfig(owner, this.programIds);
+    return this.program.methods.removeFromWhitelist(address).accounts({ owner, payer, config: configPda }).transaction();
+  }
+  /**
+   * Build batchSendUsds tx. Build-tx pattern.
+   * @param recipients    - wallet addresses to send to
+   * @param amounts       - corresponding amounts in token smallest units
+   * @param configOwner   - owner of referral config (used to derive config + vault)
+   * @param collateralMint - token mint
+   * @param authority     - whitelisted signer
+   * @param payer         - fee payer (can differ from authority)
+   */
+  async buildBatchSendUsdsTx(recipients, amounts, configOwner, collateralMint, authority = this.walletPubkey, payer = authority) {
+    if (!this.programIds.referral) throw new Error("referral program ID not configured");
+    if (recipients.length !== amounts.length) throw new Error("recipients and amounts must have same length");
+    if (recipients.length === 0) throw new Error("recipients array is empty");
+    const [configPda] = PDA.referralConfig(configOwner, this.programIds);
+    const referralVault = getAssociatedTokenAddressSync(collateralMint, configPda, true);
+    const recipientAtas = recipients.map(
+      (wallet) => getAssociatedTokenAddressSync(collateralMint, wallet)
+    );
+    return this.program.methods.batchSendUsds(amounts).accounts({
+      authority,
+      config: configPda,
+      referralVault,
+      tokenProgram: TOKEN_PROGRAM_ID
+    }).remainingAccounts(
+      recipientAtas.map((ata) => ({ pubkey: ata, isSigner: false, isWritable: true }))
+    ).transaction();
+  }
+};
 
 // src/idls/oracle.json
 var oracle_default = {
@@ -4260,9 +4577,59 @@ var question_market_default = {
           ],
           writable: true
         },
+        {
+          name: "presale_vault",
+          writable: true
+        },
+        {
+          name: "referral_token_account",
+          docs: [
+            "Referral address USDC ATA (receives agents_fee 10%)"
+          ],
+          writable: true
+        },
+        {
+          name: "company_token_account",
+          docs: [
+            "Company address USDC ATA (receives company_fee 10%)"
+          ],
+          writable: true
+        },
+        {
+          name: "admin_vault",
+          docs: [
+            "admin_contract vault ATA (receives botmm_revenue 80%)"
+          ],
+          writable: true
+        },
+        {
+          name: "admin_config",
+          docs: [
+            "admin_contract config PDA (seeds=[ADMIN_CONFIG_SEED, owner] \u2014 validated by admin_contract CPI)"
+          ]
+        },
+        {
+          name: "claim_record",
+          docs: [
+            "ClaimRecord PDA for this presale's conditionId (seeds=[CLAIM_RECORD_SEED, condition_id])",
+            "condition_id computed inside handler \u2014 seeds validated by admin_contract CPI"
+          ],
+          writable: true
+        },
         {
           name: "conditional_tokens_program"
         },
+        {
+          name: "question_fee",
+          docs: [
+            "QuestionFee PDA \u2014 initialized with default fees via CPI to fee-management"
+          ],
+          writable: true
+        },
+        {
+          name: "fee_management_program",
+          address: "DuYyXguB5PVSKg6E2p4XPrrXZSCJnuBhoGpkGCBN5bBb"
+        },
         {
           name: "presale_program",
           address: "2Rnw1VoEtsUMQ7wkvYZjDehqSqRob6uNkeymDfvKrquB"
@@ -4271,6 +4638,10 @@ var question_market_default = {
           name: "market_oracle_program",
           address: "ADWF4J3nCJ2kWnCtycuem2jhu7amUqJWQG3oa5xF67QJ"
         },
+        {
+          name: "admin_program",
+          address: "4NdD5962SfGqofmeyjfifJpdGnwTAiKaUKB5Z42UDc9T"
+        },
         {
           name: "token_program",
           address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
@@ -4914,12 +5285,53 @@ var question_market_default = {
           name: "conditional_tokens_program"
         },
         {
-          name: "token_program",
-          address: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
-        },
-        {
-          name: "system_program",
-          address: "11111111111111111111111111111111"
+          name: "question_fee",
+          docs: [
+            "QuestionFee PDA \u2014 initialized with default fees via CPI to fee-management.",
+            "Seed uses condition.key() bytes (consistent with existing set_question_fee SDK convention)."
+          ],
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  113,
+                  117,
+                  101,
+                  115,
+                  116,
+                  105,
+                  111,
+                  110,
+                  95,
+                  102,
+                  101,
+                  101
+                ]
+              },
+              {
+                kind: "account",
+                path: "condition"
+              }
+            ],
+            program: {
+              kind: "account",
+              path: "fee_management_program"
+            }
+          }
+        },
+        {
+          name: "fee_management_program",
+          address: "DuYyXguB5PVSKg6E2p4XPrrXZSCJnuBhoGpkGCBN5bBb"
+        },
+        {
+          name: "token_program",
+          address: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          name: "system_program",
+          address: "11111111111111111111111111111111"
         },
         {
           name: "rent",
@@ -6029,6 +6441,18 @@ var question_market_default = {
           {
             name: "creator",
             type: "pubkey"
+          },
+          {
+            name: "agents_fee",
+            type: "u64"
+          },
+          {
+            name: "company_fee",
+            type: "u64"
+          },
+          {
+            name: "botmm_revenue",
+            type: "u64"
           }
         ]
       }
@@ -8595,6 +9019,174 @@ var clob_exchange_default = {
         }
       ]
     },
+    {
+      name: "batch_collect_redeem_early",
+      docs: [
+        "Batch collect fee tokens from winning users after question resolution,",
+        "redeem them via CTF, and distribute USDS via fee_management."
+      ],
+      discriminator: [
+        87,
+        149,
+        45,
+        245,
+        249,
+        25,
+        207,
+        82
+      ],
+      accounts: [
+        {
+          name: "operator",
+          signer: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        },
+        {
+          name: "clob_config",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  99,
+                  108,
+                  111,
+                  98,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          name: "condition",
+          writable: true
+        },
+        {
+          name: "collateral_vault",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  99,
+                  111,
+                  108,
+                  108,
+                  97,
+                  116,
+                  101,
+                  114,
+                  97,
+                  108,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                kind: "account",
+                path: "condition.collateral_mint",
+                account: "Condition"
+              }
+            ],
+            program: {
+              kind: "account",
+              path: "conditional_tokens_program"
+            }
+          }
+        },
+        {
+          name: "vault_token_account",
+          writable: true
+        },
+        {
+          name: "fee_recipient",
+          docs: [
+            "CLOB's USDS ATA \u2014 receives USDS payout from redeem, then distribute_fee draws from it."
+          ],
+          writable: true
+        },
+        {
+          name: "yes_mint",
+          writable: true
+        },
+        {
+          name: "no_mint",
+          writable: true
+        },
+        {
+          name: "clob_yes_ata",
+          docs: [
+            "CLOB's YES ATA (Token-2022) \u2014 must be pre-initialized (created during prior matchOrders)."
+          ],
+          writable: true
+        },
+        {
+          name: "clob_no_ata",
+          docs: [
+            "CLOB's NO ATA (Token-2022) \u2014 must be pre-initialized."
+          ],
+          writable: true
+        },
+        {
+          name: "clob_yes_position",
+          writable: true
+        },
+        {
+          name: "clob_no_position",
+          writable: true
+        },
+        {
+          name: "ix_sysvar"
+        },
+        {
+          name: "conditional_tokens_program",
+          address: "A6N1F8MRsdgcojAx8p6FaECvw8mo8w6qJcWsbKQBANK4"
+        },
+        {
+          name: "token_program",
+          address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+        },
+        {
+          name: "token_2022_program",
+          address: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          name: "system_program",
+          address: "11111111111111111111111111111111"
+        }
+      ],
+      args: [
+        {
+          name: "ix_index",
+          type: "u8"
+        },
+        {
+          name: "order_count",
+          type: "u8"
+        },
+        {
+          name: "outcome_index",
+          type: "u8"
+        }
+      ]
+    },
     {
       name: "cancel_order",
       docs: [
@@ -8808,7 +9400,7 @@ var clob_exchange_default = {
     {
       name: "match_complementary",
       docs: [
-        "COMPLEMENTARY match: 1 taker (BUY) + N makers (SELL) via remaining_accounts."
+        "COMPLEMENTARY match: 1 taker (BUY or SELL) + N makers (opposite side) via remaining_accounts."
       ],
       discriminator: [
         100,
@@ -9101,9 +9693,6 @@ var clob_exchange_default = {
         },
         {
           name: "clob_usdc_ata",
-          docs: [
-            "USDC ATA owned by clob_config \u2014 receives USDC from vault after merge"
-          ],
           writable: true,
           pda: {
             seeds: [
@@ -9380,9 +9969,6 @@ 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: [
@@ -9440,30 +10026,18 @@ var clob_exchange_default = {
         },
         {
           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
         },
         {
@@ -10499,11 +11073,18 @@ var fee_management_default = {
         {
           name: "market_oracle_vault",
           docs: [
-            "Writable: tokens are transferred here when is_admin=false.",
+            "Writable: tokens are transferred here (investors share) when is_admin=false.",
             "For admin questions pass any writable account (no transfer occurs)."
           ],
           writable: true
         },
+        {
+          name: "referral_vault",
+          docs: [
+            "Must match fee_config.referral_vault."
+          ],
+          writable: true
+        },
         {
           name: "token_program",
           address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
@@ -10521,40 +11102,104 @@ var fee_management_default = {
       ]
     },
     {
-      name: "initialize",
+      name: "init_question_fee",
       discriminator: [
-        175,
-        175,
-        109,
-        31,
-        13,
-        152,
-        155,
-        237
+        115,
+        49,
+        110,
+        164,
+        33,
+        202,
+        115,
+        79
       ],
       accounts: [
-        {
-          name: "authority",
-          signer: true
-        },
         {
           name: "payer",
           writable: true,
           signer: true
         },
         {
-          name: "fee_config",
+          name: "question_fee",
           writable: true,
           pda: {
             seeds: [
               {
                 kind: "const",
                 value: [
-                  102,
-                  101,
+                  113,
+                  117,
                   101,
-                  95,
-                  99,
+                  115,
+                  116,
+                  105,
+                  111,
+                  110,
+                  95,
+                  102,
+                  101,
+                  101
+                ]
+              },
+              {
+                kind: "arg",
+                path: "condition_id"
+              }
+            ]
+          }
+        },
+        {
+          name: "system_program",
+          address: "11111111111111111111111111111111"
+        }
+      ],
+      args: [
+        {
+          name: "condition_id",
+          type: {
+            array: [
+              "u8",
+              32
+            ]
+          }
+        }
+      ]
+    },
+    {
+      name: "initialize",
+      discriminator: [
+        175,
+        175,
+        109,
+        31,
+        13,
+        152,
+        155,
+        237
+      ],
+      accounts: [
+        {
+          name: "authority",
+          signer: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        },
+        {
+          name: "fee_config",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  102,
+                  101,
+                  101,
+                  95,
+                  99,
                   111,
                   110,
                   102,
@@ -11214,6 +11859,19 @@ var fee_management_default = {
         235
       ]
     },
+    {
+      name: "QuestionFeeInitialized",
+      discriminator: [
+        147,
+        167,
+        20,
+        219,
+        32,
+        142,
+        227,
+        171
+      ]
+    },
     {
       name: "QuestionFeeUpdated",
       discriminator: [
@@ -11285,7 +11943,8 @@ var fee_management_default = {
           {
             name: "investors_market_rev",
             docs: [
-              "Market revenue split: investors + company (out of FEE_DENOMINATOR = 1_000_000)"
+              "Market revenue split \u2014 three parts must sum to FEE_DENOMINATOR (10_000).",
+              "investors_market_rev + company_market_rev + referral_market_rev == 10_000"
             ],
             type: "u32"
           },
@@ -11296,7 +11955,7 @@ var fee_management_default = {
           {
             name: "agents_presale_rev",
             docs: [
-              "Presale revenue split: agents + company (out of FEE_DENOMINATOR = 1_000_000)"
+              "Presale revenue split: agents + company (out of FEE_DENOMINATOR = 10_000)"
             ],
             type: "u32"
           },
@@ -11321,12 +11980,26 @@ var fee_management_default = {
             name: "bump",
             type: "u8"
           },
+          {
+            name: "referral_market_rev",
+            docs: [
+              "Share of market trading fees routed to referral_vault (e.g. 2_000 = 20%)"
+            ],
+            type: "u32"
+          },
+          {
+            name: "referral_vault",
+            docs: [
+              "ATA of referral program config PDA \u2014 receives referral_market_rev% of trading fees"
+            ],
+            type: "pubkey"
+          },
           {
             name: "_reserved",
             type: {
               array: [
                 "u8",
-                64
+                28
               ]
             }
           }
@@ -11453,6 +12126,14 @@ var fee_management_default = {
           {
             name: "company_presale_rev",
             type: "u32"
+          },
+          {
+            name: "referral_market_rev",
+            type: "u32"
+          },
+          {
+            name: "referral_vault",
+            type: "pubkey"
           }
         ]
       }
@@ -11596,7 +12277,7 @@ var fee_management_default = {
           {
             name: "merge_fee",
             docs: [
-              "Fees out of FEE_DENOMINATOR (1_000_000). E.g. 2_000 = 0.2%"
+              "Fees out of FEE_DENOMINATOR (10_000). E.g. 200 = 2%, 2_000 = 20%"
             ],
             type: "u64"
           },
@@ -11615,6 +12296,35 @@ var fee_management_default = {
         ]
       }
     },
+    {
+      name: "QuestionFeeInitialized",
+      type: {
+        kind: "struct",
+        fields: [
+          {
+            name: "condition_id",
+            type: {
+              array: [
+                "u8",
+                32
+              ]
+            }
+          },
+          {
+            name: "swap_fee",
+            type: "u64"
+          },
+          {
+            name: "redeem_fee",
+            type: "u64"
+          },
+          {
+            name: "merge_fee",
+            type: "u64"
+          }
+        ]
+      }
+    },
     {
       name: "QuestionFeeUpdated",
       type: {
@@ -11684,6 +12394,14 @@ var fee_management_default = {
           {
             name: "company_presale_rev",
             type: "u32"
+          },
+          {
+            name: "referral_market_rev",
+            type: "u32"
+          },
+          {
+            name: "referral_vault",
+            type: "pubkey"
           }
         ]
       }
@@ -15032,94 +15750,592 @@ var admin_contract_default = {
   ]
 };
 
-// src/sdk.ts
-var XMarketSDK = class {
-  // lazy-init in get admin()
-  constructor(config, wallet, marketOwner) {
-    this.networkConfig = config;
-    this.provider = new anchor5.AnchorProvider(
-      new Connection(config.rpcUrl, "confirmed"),
-      wallet,
-      { commitment: "confirmed", preflightCommitment: "confirmed" }
-    );
-    anchor5.setProvider(this.provider);
-    this._programIds = config.programIds;
-    this._marketOwner = marketOwner ?? wallet.publicKey;
-  }
-  _withAddress(idl, address) {
-    return { ...idl, address: address.toBase58() };
-  }
-  get oracle() {
-    if (!this._oracle) {
-      const program = new anchor5.Program(this._withAddress(oracle_default, this._programIds.oracle), this.provider);
-      this._oracle = new OracleClient(program, this.provider, this._programIds);
-    }
-    return this._oracle;
-  }
-  get hook() {
-    if (!this._hook) {
-      const program = new anchor5.Program(this._withAddress(hook_default, this._programIds.hook), this.provider);
-      this._hook = new HookClient(program, this.provider, this._programIds);
-    }
-    return this._hook;
-  }
-  get market() {
-    if (!this._market) {
-      const program = new anchor5.Program(this._withAddress(question_market_default, this._programIds.questionMarket), this.provider);
-      this._market = new MarketClient(program, this.provider, this._programIds, this._marketOwner);
-      this._market.ctfClient = this.ctf;
-    }
-    return this._market;
-  }
-  get ctf() {
-    if (!this._ctf) {
-      const program = new anchor5.Program(this._withAddress(conditional_tokens_default, this._programIds.conditionalTokens), this.provider);
-      this._ctf = new CtfClient(program, this.provider, this._programIds);
-    }
-    return this._ctf;
-  }
-  get clob() {
-    if (!this._clob) {
-      const program = new anchor5.Program(this._withAddress(clob_exchange_default, this._programIds.clobExchange), this.provider);
-      this._clob = new ClobClient(program, this.provider, this._programIds, this.networkConfig);
-      if (this.networkConfig.feeConfigOwner && this._programIds.feeManagement) {
-        this._clob.feeConfigOwner = this.networkConfig.feeConfigOwner;
-        this._clob.feeClient = this.fee;
-      }
-    }
-    return this._clob;
-  }
-  get fee() {
-    if (!this._fee) {
-      if (!this._programIds.feeManagement) throw new Error("feeManagement program ID not configured in NetworkConfig");
-      const program = new anchor5.Program(this._withAddress(fee_management_default, this._programIds.feeManagement), this.provider);
-      this._fee = new FeeManagementClient(program, this.provider, this._programIds);
-    }
-    return this._fee;
-  }
-  get presale() {
-    if (!this._presale) {
-      if (!this._programIds.presale) throw new Error("presale program ID not configured in NetworkConfig");
-      const program = new anchor5.Program(this._withAddress(presale_default, this._programIds.presale), this.provider);
-      this._presale = new PresaleClient(program, this.provider, this._programIds);
-    }
-    return this._presale;
-  }
-  get marketOracle() {
-    if (!this._marketOracle) {
-      if (!this._programIds.marketOracle) throw new Error("marketOracle program ID not configured in NetworkConfig");
-      const program = new anchor5.Program(this._withAddress(market_oracle_default, this._programIds.marketOracle), this.provider);
-      this._marketOracle = new MarketOracleClient(program, this.provider, this._programIds);
-    }
-    return this._marketOracle;
-  }
-  get admin() {
-    if (!this._admin) {
-      if (!this._programIds.adminContract) throw new Error("adminContract program ID not configured in NetworkConfig");
-      const program = new anchor5.Program(this._withAddress(admin_contract_default, this._programIds.adminContract), this.provider);
-      this._admin = new AdminClient(program, this.provider, this._programIds);
-    }
-    return this._admin;
+// src/idls/referral.json
+var referral_default = {
+  address: "7b5ohWDqrQ2KRcDJMWwj1dwgRkt5ZJdMavSmrXn9oBgL",
+  metadata: {
+    name: "referral",
+    version: "0.1.0",
+    spec: "0.1.0",
+    description: "Referral program for XMarket \u2014 whitelist-gated batch USDS distribution"
+  },
+  instructions: [
+    {
+      name: "add_to_whitelist",
+      discriminator: [
+        157,
+        211,
+        52,
+        54,
+        144,
+        81,
+        5,
+        55
+      ],
+      accounts: [
+        {
+          name: "owner",
+          signer: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        },
+        {
+          name: "config",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  114,
+                  101,
+                  102,
+                  101,
+                  114,
+                  114,
+                  97,
+                  108,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              },
+              {
+                kind: "account",
+                path: "config.owner",
+                account: "ReferralConfig"
+              }
+            ]
+          }
+        }
+      ],
+      args: [
+        {
+          name: "address",
+          type: "pubkey"
+        }
+      ]
+    },
+    {
+      name: "batch_send_usds",
+      discriminator: [
+        255,
+        33,
+        77,
+        124,
+        42,
+        207,
+        250,
+        162
+      ],
+      accounts: [
+        {
+          name: "authority",
+          docs: [
+            "Whitelisted caller (authority, signs tx)"
+          ],
+          signer: true
+        },
+        {
+          name: "config",
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  114,
+                  101,
+                  102,
+                  101,
+                  114,
+                  114,
+                  97,
+                  108,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              },
+              {
+                kind: "account",
+                path: "config.owner",
+                account: "ReferralConfig"
+              }
+            ]
+          }
+        },
+        {
+          name: "referral_vault",
+          docs: [
+            "Referral vault \u2014 source of transfers (ATA owned by config PDA)"
+          ],
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "account",
+                path: "config"
+              },
+              {
+                kind: "const",
+                value: [
+                  6,
+                  221,
+                  246,
+                  225,
+                  215,
+                  101,
+                  161,
+                  147,
+                  217,
+                  203,
+                  225,
+                  70,
+                  206,
+                  235,
+                  121,
+                  172,
+                  28,
+                  180,
+                  133,
+                  237,
+                  95,
+                  91,
+                  55,
+                  145,
+                  58,
+                  140,
+                  245,
+                  133,
+                  126,
+                  255,
+                  0,
+                  169
+                ]
+              },
+              {
+                kind: "account",
+                path: "config.collateral_mint",
+                account: "ReferralConfig"
+              }
+            ],
+            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: "token_program",
+          address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+        }
+      ],
+      args: [
+        {
+          name: "amounts",
+          type: {
+            vec: "u64"
+          }
+        }
+      ]
+    },
+    {
+      name: "initialize",
+      discriminator: [
+        175,
+        175,
+        109,
+        31,
+        13,
+        152,
+        155,
+        237
+      ],
+      accounts: [
+        {
+          name: "owner",
+          writable: true,
+          signer: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        },
+        {
+          name: "config",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  114,
+                  101,
+                  102,
+                  101,
+                  114,
+                  114,
+                  97,
+                  108,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              },
+              {
+                kind: "account",
+                path: "owner"
+              }
+            ]
+          }
+        },
+        {
+          name: "collateral_mint"
+        },
+        {
+          name: "system_program",
+          address: "11111111111111111111111111111111"
+        }
+      ],
+      args: []
+    },
+    {
+      name: "remove_from_whitelist",
+      discriminator: [
+        7,
+        144,
+        216,
+        239,
+        243,
+        236,
+        193,
+        235
+      ],
+      accounts: [
+        {
+          name: "owner",
+          signer: true
+        },
+        {
+          name: "payer",
+          writable: true,
+          signer: true
+        },
+        {
+          name: "config",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  114,
+                  101,
+                  102,
+                  101,
+                  114,
+                  114,
+                  97,
+                  108,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              },
+              {
+                kind: "account",
+                path: "config.owner",
+                account: "ReferralConfig"
+              }
+            ]
+          }
+        }
+      ],
+      args: [
+        {
+          name: "address",
+          type: "pubkey"
+        }
+      ]
+    }
+  ],
+  accounts: [
+    {
+      name: "ReferralConfig",
+      discriminator: [
+        102,
+        148,
+        171,
+        235,
+        148,
+        83,
+        250,
+        140
+      ]
+    }
+  ],
+  events: [
+    {
+      name: "BatchSent",
+      discriminator: [
+        116,
+        64,
+        207,
+        63,
+        56,
+        97,
+        15,
+        100
+      ]
+    },
+    {
+      name: "ReferralInitialized",
+      discriminator: [
+        129,
+        190,
+        249,
+        4,
+        198,
+        5,
+        141,
+        226
+      ]
+    }
+  ],
+  types: [
+    {
+      name: "BatchSent",
+      type: {
+        kind: "struct",
+        fields: [
+          {
+            name: "config",
+            type: "pubkey"
+          },
+          {
+            name: "sent_by",
+            type: "pubkey"
+          },
+          {
+            name: "recipients",
+            type: "u8"
+          }
+        ]
+      }
+    },
+    {
+      name: "ReferralConfig",
+      type: {
+        kind: "struct",
+        fields: [
+          {
+            name: "version",
+            type: "u8"
+          },
+          {
+            name: "owner",
+            type: "pubkey"
+          },
+          {
+            name: "collateral_mint",
+            type: "pubkey"
+          },
+          {
+            name: "whitelist",
+            type: {
+              array: [
+                "pubkey",
+                10
+              ]
+            }
+          },
+          {
+            name: "whitelist_len",
+            type: "u8"
+          },
+          {
+            name: "bump",
+            type: "u8"
+          },
+          {
+            name: "_reserved",
+            type: {
+              array: [
+                "u8",
+                64
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      name: "ReferralInitialized",
+      type: {
+        kind: "struct",
+        fields: [
+          {
+            name: "config",
+            type: "pubkey"
+          },
+          {
+            name: "owner",
+            type: "pubkey"
+          }
+        ]
+      }
+    }
+  ]
+};
+
+// src/sdk.ts
+var XMarketSDK = class {
+  constructor(config, wallet, marketOwner) {
+    this.networkConfig = config;
+    this.provider = new anchor5.AnchorProvider(
+      new Connection(config.rpcUrl, "confirmed"),
+      wallet,
+      { commitment: "confirmed", preflightCommitment: "confirmed" }
+    );
+    anchor5.setProvider(this.provider);
+    this._programIds = config.programIds;
+    this._marketOwner = marketOwner ?? wallet.publicKey;
+  }
+  _withAddress(idl, address) {
+    return { ...idl, address: address.toBase58() };
+  }
+  get oracle() {
+    if (!this._oracle) {
+      const program = new anchor5.Program(this._withAddress(oracle_default, this._programIds.oracle), this.provider);
+      this._oracle = new OracleClient(program, this.provider, this._programIds);
+    }
+    return this._oracle;
+  }
+  get hook() {
+    if (!this._hook) {
+      const program = new anchor5.Program(this._withAddress(hook_default, this._programIds.hook), this.provider);
+      this._hook = new HookClient(program, this.provider, this._programIds);
+    }
+    return this._hook;
+  }
+  get market() {
+    if (!this._market) {
+      const program = new anchor5.Program(this._withAddress(question_market_default, this._programIds.questionMarket), this.provider);
+      this._market = new MarketClient(program, this.provider, this._programIds, this._marketOwner);
+      this._market.ctfClient = this.ctf;
+    }
+    return this._market;
+  }
+  get ctf() {
+    if (!this._ctf) {
+      const program = new anchor5.Program(this._withAddress(conditional_tokens_default, this._programIds.conditionalTokens), this.provider);
+      this._ctf = new CtfClient(program, this.provider, this._programIds);
+    }
+    return this._ctf;
+  }
+  get clob() {
+    if (!this._clob) {
+      const program = new anchor5.Program(this._withAddress(clob_exchange_default, this._programIds.clobExchange), this.provider);
+      this._clob = new ClobClient(program, this.provider, this._programIds, this.networkConfig);
+      if (this.networkConfig.feeConfigOwner && this._programIds.feeManagement) {
+        this._clob.feeConfigOwner = this.networkConfig.feeConfigOwner;
+        this._clob.feeClient = this.fee;
+      }
+    }
+    return this._clob;
+  }
+  get fee() {
+    if (!this._fee) {
+      if (!this._programIds.feeManagement) throw new Error("feeManagement program ID not configured in NetworkConfig");
+      const program = new anchor5.Program(this._withAddress(fee_management_default, this._programIds.feeManagement), this.provider);
+      this._fee = new FeeManagementClient(program, this.provider, this._programIds);
+    }
+    return this._fee;
+  }
+  get presale() {
+    if (!this._presale) {
+      if (!this._programIds.presale) throw new Error("presale program ID not configured in NetworkConfig");
+      const program = new anchor5.Program(this._withAddress(presale_default, this._programIds.presale), this.provider);
+      this._presale = new PresaleClient(program, this.provider, this._programIds);
+    }
+    return this._presale;
+  }
+  get marketOracle() {
+    if (!this._marketOracle) {
+      if (!this._programIds.marketOracle) throw new Error("marketOracle program ID not configured in NetworkConfig");
+      const program = new anchor5.Program(this._withAddress(market_oracle_default, this._programIds.marketOracle), this.provider);
+      this._marketOracle = new MarketOracleClient(program, this.provider, this._programIds);
+    }
+    return this._marketOracle;
+  }
+  get admin() {
+    if (!this._admin) {
+      if (!this._programIds.adminContract) throw new Error("adminContract program ID not configured in NetworkConfig");
+      const program = new anchor5.Program(this._withAddress(admin_contract_default, this._programIds.adminContract), this.provider);
+      this._admin = new AdminClient(program, this.provider, this._programIds);
+    }
+    return this._admin;
+  }
+  get referral() {
+    if (!this._referral) {
+      if (!this._programIds.referral) throw new Error("referral program ID not configured in NetworkConfig");
+      const program = new anchor5.Program(this._withAddress(referral_default, this._programIds.referral), this.provider);
+      this._referral = new ReferralClient(program, this.provider, this._programIds);
+    }
+    return this._referral;
   }
 };
 var MAX_APPROVE_AMOUNT = new BN4("18446744073709551615");
@@ -15193,6 +16409,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, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, 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, ReferralClient, SEEDS, UnauthorizedError, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedCollectFeeEd25519Instruction, buildBatchedEd25519Instruction, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeCollectFeeOrderToBytes, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map