@theliem/xmarket-sdk 3.13.0 → 3.18.0

package/dist/index.js

@@ -50,6 +50,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
@@ -250,6 +251,14 @@ var PDA = class {
       programIds.marketOracle
     );
   }
+  // ─── Referral Program ────────────────────────────────────────────────────
+  static referralConfig(owner, programIds) {
+    if (!programIds.referral) throw new Error("referral program ID not configured");
+    return web3_js.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");
@@ -1388,6 +1397,49 @@ function buildBatchedEd25519Instruction(orders) {
   });
 }
 var IX_SYSVAR = web3_js.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 web3_js.TransactionInstruction({
+    keys: [],
+    programId: web3_js.Ed25519Program.programId,
+    data
+  });
+}
 function buildOrder(params) {
   return {
     maker: params.maker,
@@ -1505,10 +1557,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;
   }
@@ -1599,6 +1658,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],
@@ -1608,6 +1668,10 @@ var ClobClient = class {
         addresses.push(splToken.getAssociatedTokenAddressSync(collateralMint, companyAddr));
       }
       addresses.push(payer);
+      if (refVault) {
+        addresses.push(refVault);
+      }
+      addresses.push(splToken.TOKEN_PROGRAM_ID);
     }
     const slot = await connection.getSlot("finalized");
     const [createIx, altAddress] = web3_js.AddressLookupTableProgram.createLookupTable({
@@ -1642,8 +1706,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);
@@ -1669,10 +1733,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,
@@ -1681,7 +1745,7 @@ ${logs.join("\n")}`);
       ));
     }
     if (!noInfo) {
-      ixs.push(createAssociatedTokenAccountIdempotentInstruction3(
+      ixs.push(createAssociatedTokenAccountIdempotentInstruction4(
         this.walletPubkey,
         clobNoAta,
         clobConfig,
@@ -1865,7 +1929,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) {
@@ -1875,7 +1940,8 @@ ${logs.join("\n")}`);
             { pubkey: PDA.feeConfig(this.feeConfigOwner, this.programIds)[0], isSigner: false, isWritable: false },
             { pubkey: feeOverridePda, isSigner: false, isWritable: false },
             { pubkey: splToken.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 }
           ];
         }
       }
@@ -2119,7 +2185,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) {
@@ -2129,7 +2196,9 @@ ${logs.join("\n")}`);
             { pubkey: PDA.feeConfig(this.feeConfigOwner, this.programIds)[0], isSigner: false, isWritable: false },
             { pubkey: feeOverridePda, isSigner: false, isWritable: false },
             { pubkey: splToken.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: splToken.TOKEN_PROGRAM_ID, isSigner: false, isWritable: false }
           );
         }
       }
@@ -2400,6 +2469,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 = splToken.getAssociatedTokenAddressSync(yesMint, clobConfig, true, splToken.TOKEN_2022_PROGRAM_ID);
+    const clobNoAta = splToken.getAssociatedTokenAddressSync(noMint, clobConfig, true, splToken.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 = splToken.getAssociatedTokenAddressSync(outcomeMint, order.user, false, splToken.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: splToken.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: splToken.TOKEN_PROGRAM_ID,
+      token2022Program: splToken.TOKEN_2022_PROGRAM_ID,
+      systemProgram: web3_js.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 {
@@ -2448,20 +2614,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: web3_js.SystemProgram.programId
     }).signers([]).rpc();
@@ -2509,19 +2677,21 @@ var FeeManagementClient = class {
    * @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 };
@@ -2538,33 +2708,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 web3_js.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 web3_js.PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA")
-    }).signers([]).rpc();
-    return { signature: sig };
+      questionFee: questionFeePda,
+      systemProgram: web3_js.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);
@@ -2582,6 +2752,25 @@ var FeeManagementClient = class {
     }).signers([]).rpc();
     return { signature: sig };
   }
+  /**
+   * Build addToWhitelist tx — authority (admin/owner) signs externally.
+   * Whitelist members can call editMarketFee / setQuestionFee.
+   */
+  /** Build addToWhitelist tx — authority (admin/owner) signs externally. */
+  async buildAddToWhitelistTx(address, feeConfigOwner, authority) {
+    const [feeConfigPda] = PDA.feeConfig(feeConfigOwner, this.programIds);
+    return this.program.methods.addToWhitelist(address).accounts({ authority, feeConfig: feeConfigPda }).transaction();
+  }
+  /** Build removeFromWhitelist tx — authority (admin/owner) signs externally. */
+  async buildRemoveFromWhitelistTx(address, feeConfigOwner, authority) {
+    const [feeConfigPda] = PDA.feeConfig(feeConfigOwner, this.programIds);
+    return this.program.methods.removeFromWhitelist(address).accounts({ authority, feeConfig: feeConfigPda }).transaction();
+  }
+  /** Build setAdmin tx — only owner signs externally. */
+  async buildSetAdminTx(newAdmin, feeConfigOwner, authority) {
+    const [feeConfigPda] = PDA.feeConfig(feeConfigOwner, this.programIds);
+    return this.program.methods.setAdmin(newAdmin).accounts({ authority, feeConfig: feeConfigPda }).transaction();
+  }
 };
 var PresaleClient = class {
   constructor(program, provider, programIds) {
@@ -2922,6 +3111,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 splToken.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 = splToken.getAssociatedTokenAddressSync(collateralMint, configPda, true);
+    const createVaultIx = splToken.createAssociatedTokenAccountIdempotentInstruction(
+      payer,
+      vaultAta,
+      configPda,
+      collateralMint
+    );
+    const initTx = await this.program.methods.initialize().accounts({
+      owner,
+      payer,
+      config: configPda,
+      collateralMint,
+      systemProgram: web3_js.SystemProgram.programId
+    }).transaction();
+    const tx = new web3_js.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 = splToken.getAssociatedTokenAddressSync(collateralMint, configPda, true);
+    const recipientAtas = recipients.map(
+      (wallet) => splToken.getAssociatedTokenAddressSync(collateralMint, wallet)
+    );
+    return this.program.methods.batchSendUsds(amounts).accounts({
+      authority,
+      config: configPda,
+      referralVault,
+      tokenProgram: splToken.TOKEN_PROGRAM_ID
+    }).remainingAccounts(
+      recipientAtas.map((ata) => ({ pubkey: ata, isSigner: false, isWritable: true }))
+    ).transaction();
+  }
+};
 
 // src/idls/oracle.json
 var oracle_default = {
@@ -8784,84 +9065,252 @@ var clob_exchange_default = {
       ]
     },
     {
-      name: "cancel_order",
+      name: "batch_collect_redeem_early",
       docs: [
-        "Cancel an order \u2014 close OrderRecord PDA, return rent to maker."
+        "Batch collect fee tokens from winning users after question resolution,",
+        "redeem them via CTF, and distribute USDS via fee_management."
       ],
       discriminator: [
-        95,
-        129,
-        237,
-        240,
-        8,
-        49,
-        223,
-        132
+        87,
+        149,
+        45,
+        245,
+        249,
+        25,
+        207,
+        82
       ],
       accounts: [
         {
-          name: "maker",
-          docs: [
-            "Must be the order maker/signer"
-          ],
+          name: "operator",
           signer: true
         },
         {
-          name: "order_record",
+          name: "payer",
+          writable: true,
+          signer: true
+        },
+        {
+          name: "clob_config",
           writable: true,
           pda: {
             seeds: [
               {
                 kind: "const",
                 value: [
+                  99,
+                  108,
                   111,
-                  114,
-                  100,
-                  101,
-                  114,
+                  98,
                   95,
-                  114,
-                  101,
                   99,
                   111,
-                  114,
-                  100
+                  110,
+                  102,
+                  105,
+                  103
                 ]
-              },
-              {
-                kind: "account",
-                path: "maker"
-              },
-              {
-                kind: "arg",
-                path: "nonce"
               }
             ]
           }
         },
         {
-          name: "system_program",
-          address: "11111111111111111111111111111111"
-        }
-      ],
-      args: [
+          name: "condition",
+          writable: true
+        },
         {
-          name: "nonce",
-          type: "u64"
-        }
-      ]
-    },
-    {
-      name: "force_reset_clob",
-      discriminator: [
-        96,
-        95,
-        187,
-        95,
-        65,
-        135,
-        120,
-        204
+          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: [
+        "Cancel an order \u2014 close OrderRecord PDA, return rent to maker."
+      ],
+      discriminator: [
+        95,
+        129,
+        237,
+        240,
+        8,
+        49,
+        223,
+        132
+      ],
+      accounts: [
+        {
+          name: "maker",
+          docs: [
+            "Must be the order maker/signer"
+          ],
+          signer: true
+        },
+        {
+          name: "order_record",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  111,
+                  114,
+                  100,
+                  101,
+                  114,
+                  95,
+                  114,
+                  101,
+                  99,
+                  111,
+                  114,
+                  100
+                ]
+              },
+              {
+                kind: "account",
+                path: "maker"
+              },
+              {
+                kind: "arg",
+                path: "nonce"
+              }
+            ]
+          }
+        },
+        {
+          name: "system_program",
+          address: "11111111111111111111111111111111"
+        }
+      ],
+      args: [
+        {
+          name: "nonce",
+          type: "u64"
+        }
+      ]
+    },
+    {
+      name: "force_reset_clob",
+      discriminator: [
+        96,
+        95,
+        187,
+        95,
+        65,
+        135,
+        120,
+        204
       ],
       accounts: [
         {
@@ -8996,7 +9445,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,
@@ -9289,9 +9738,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: [
@@ -9568,9 +10014,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: [
@@ -9628,30 +10071,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
         },
         {
@@ -10565,11 +10996,6 @@ var fee_management_default = {
           name: "authority",
           signer: true
         },
-        {
-          name: "payer",
-          writable: true,
-          signer: true
-        },
         {
           name: "fee_config",
           writable: true,
@@ -10687,11 +11113,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"
@@ -10854,11 +11287,6 @@ var fee_management_default = {
           name: "authority",
           signer: true
         },
-        {
-          name: "payer",
-          writable: true,
-          signer: true
-        },
         {
           name: "fee_config",
           writable: true,
@@ -10912,11 +11340,6 @@ var fee_management_default = {
           name: "authority",
           signer: true
         },
-        {
-          name: "payer",
-          writable: true,
-          signer: true
-        },
         {
           name: "fee_config",
           writable: true,
@@ -11550,7 +11973,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"
           },
@@ -11561,7 +11985,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"
           },
@@ -11586,12 +12010,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
               ]
             }
           }
@@ -11718,6 +12156,14 @@ var fee_management_default = {
           {
             name: "company_presale_rev",
             type: "u32"
+          },
+          {
+            name: "referral_market_rev",
+            type: "u32"
+          },
+          {
+            name: "referral_vault",
+            type: "pubkey"
           }
         ]
       }
@@ -11978,6 +12424,14 @@ var fee_management_default = {
           {
             name: "company_presale_rev",
             type: "u32"
+          },
+          {
+            name: "referral_market_rev",
+            type: "u32"
+          },
+          {
+            name: "referral_vault",
+            type: "pubkey"
           }
         ]
       }
@@ -15326,20 +15780,510 @@ 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__namespace.AnchorProvider(
-      new web3_js.Connection(config.rpcUrl, "confirmed"),
-      wallet,
-      { commitment: "confirmed", preflightCommitment: "confirmed" }
-    );
-    anchor5__namespace.setProvider(this.provider);
-    this._programIds = config.programIds;
-    this._marketOwner = marketOwner ?? wallet.publicKey;
-  }
+// 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__namespace.AnchorProvider(
+      new web3_js.Connection(config.rpcUrl, "confirmed"),
+      wallet,
+      { commitment: "confirmed", preflightCommitment: "confirmed" }
+    );
+    anchor5__namespace.setProvider(this.provider);
+    this._programIds = config.programIds;
+    this._marketOwner = marketOwner ?? wallet.publicKey;
+  }
   _withAddress(idl, address) {
     return { ...idl, address: address.toBase58() };
   }
@@ -15415,6 +16359,14 @@ var XMarketSDK = class {
     }
     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__namespace.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__default.default("18446744073709551615");
 function buildCreateUserAtasTx(condition, user, payer, programIds) {
@@ -15503,12 +16455,14 @@ exports.OracleClient = OracleClient;
 exports.PDA = PDA;
 exports.PresaleClient = PresaleClient;
 exports.QuestionStatus = QuestionStatus;
+exports.ReferralClient = ReferralClient;
 exports.SEEDS = SEEDS;
 exports.UnauthorizedError = UnauthorizedError;
 exports.XMarketError = XMarketError;
 exports.XMarketSDK = XMarketSDK;
 exports.buildApproveAllOutcomeTokensTx = buildApproveAllOutcomeTokensTx;
 exports.buildApproveCollateralTx = buildApproveCollateralTx;
+exports.buildBatchedCollectFeeEd25519Instruction = buildBatchedCollectFeeEd25519Instruction;
 exports.buildBatchedEd25519Instruction = buildBatchedEd25519Instruction;
 exports.buildCreateUserAtasTx = buildCreateUserAtasTx;
 exports.buildOrder = buildOrder;
@@ -15519,6 +16473,7 @@ exports.generateContentHash = generateContentHash;
 exports.generateQuestionId = generateQuestionId;
 exports.getOrderSignBytes = getOrderSignBytes;
 exports.orderAmountsFromPrice = orderAmountsFromPrice;
+exports.serializeCollectFeeOrderToBytes = serializeCollectFeeOrderToBytes;
 exports.serializeOrderToBytes = serializeOrderToBytes;
 exports.serializeSignedOrder = serializeSignedOrder;
 exports.signOrder = signOrder;