@theliem/xmarket-sdk 3.13.0 → 3.16.0

package/dist/index.d.mts

@@ -13,6 +13,7 @@ interface ProgramIds {
     presale?: PublicKey;
     marketOracle?: PublicKey;
     adminContract?: PublicKey;
+    referral?: PublicKey;
 }
 interface CollateralConfig {
     mint: PublicKey;
@@ -214,6 +215,21 @@ interface SignedOrder {
     /** Ed25519 signature (64 bytes) from order.maker over serializeOrderToBytes() */
     signature: Uint8Array;
 }
+/** Authorization for CLOB to collect fee_amount winning tokens after question resolution. */
+interface CollectFeeOrder {
+    user: PublicKey;
+    condition: PublicKey;
+    tokenMint: PublicKey;
+    amount: BN;
+    nonce: BN;
+    /** Unix timestamp, 0 = no expiry */
+    expiry: BN;
+}
+interface SignedCollectFeeOrder {
+    order: CollectFeeOrder;
+    /** Ed25519 signature (64 bytes) from order.user over serializeCollectFeeOrderToBytes() */
+    signature: Uint8Array;
+}
 declare class XMarketError extends Error {
     code?: string | undefined;
     constructor(message: string, code?: string | undefined);
@@ -529,7 +545,21 @@ declare class FeeManagementClient {
     private readonly provider;
     private readonly programIds;
     constructor(program: anchor.Program, provider: anchor.AnchorProvider, programIds: ProgramIds);
-    initFeeConfig(admin: PublicKey, companyAddress: PublicKey, referralAddress: PublicKey, presaleRevenueAddress: PublicKey, investorsMarketRev: number, companyMarketRev: number, agentsPresaleRev: number, companyPresaleRev: number, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
+    initFeeConfig(params: {
+        admin: PublicKey;
+        companyAddress: PublicKey;
+        referralAddress: PublicKey;
+        presaleRevenueAddress: PublicKey;
+        investorsMarketRev: number;
+        companyMarketRev: number;
+        agentsPresaleRev: number;
+        companyPresaleRev: number;
+        /** Share routed to referral vault (e.g. 2_000 = 20%). Must satisfy referral+company+investors=10_000 */
+        referralMarketRev: number;
+        referralVault: PublicKey;
+        authority: PublicKey;
+        payer: PublicKey;
+    }): Promise<TxResult>;
     fetchFeeConfig(owner: PublicKey): Promise<any | null>;
     /**
      * Fetch per-market fees for a condition.
@@ -549,10 +579,32 @@ declare class FeeManagementClient {
      * @param authority      - signer authorized in fee_config whitelist / admin / owner
      * @param payer          - rent + tx fee payer
      */
-    updateFeeConfig(companyAddress: PublicKey, referralAddress: PublicKey, presaleRevenueAddress: PublicKey, investorsMarketRev: number, companyMarketRev: number, agentsPresaleRev: number, companyPresaleRev: number, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
+    updateFeeConfig(params: {
+        companyAddress: PublicKey;
+        referralAddress: PublicKey;
+        presaleRevenueAddress: PublicKey;
+        investorsMarketRev: number;
+        companyMarketRev: number;
+        agentsPresaleRev: number;
+        companyPresaleRev: number;
+        referralMarketRev: number;
+        referralVault: PublicKey;
+        authority: PublicKey;
+        payer: PublicKey;
+    }): Promise<TxResult>;
     setMarketFeeOverride(conditionPda: PublicKey, investors: number, company: number, isAdmin: boolean, feeConfigOwner: PublicKey, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
-    buildDistributeFeeIx(conditionPda: PublicKey, amount: BN, feeConfigOwner: PublicKey, sourceAta: PublicKey, companyAta: PublicKey, marketOracleVault: PublicKey, authority: PublicKey): Promise<TransactionInstruction>;
-    distributeFee(conditionPda: PublicKey, amount: BN, feeConfigOwner: PublicKey, sourceAta: PublicKey, companyAta: PublicKey, marketOracleVault: PublicKey, authority: PublicKey): Promise<TxResult>;
+    /**
+     * 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)
+     */
+    buildEditMarketFeeTx(conditionPda: PublicKey, mergeFee: BN, redeemFee: BN, swapFee: BN, feeConfigOwner: PublicKey, authority: PublicKey, payer?: PublicKey): Promise<Transaction>;
+    /** @deprecated use buildEditMarketFeeTx */
     setQuestionFee(conditionPda: PublicKey, mergeFee: BN, redeemFee: BN, swapFee: BN, feeConfigOwner: PublicKey, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
 }
 
@@ -566,6 +618,8 @@ declare class ClobClient {
     feeConfigOwner?: PublicKey;
     /** Cached company_address from fee_config to avoid repeated RPC calls */
     private _companyAddress?;
+    /** Cached referral_vault from fee_config */
+    private _referralVault?;
     /** ALT cache: condition.toBase58() → loaded ALT account */
     private _altCache;
     constructor(program: anchor.Program, provider: anchor.AnchorProvider, programIds: ProgramIds, networkConfig: {
@@ -574,6 +628,7 @@ declare class ClobClient {
         };
     });
     private companyAddress;
+    private referralVault;
     get walletPubkey(): PublicKey;
     /**
      * Get or create an ALT for a condition.
@@ -736,6 +791,23 @@ declare class ClobClient {
     buildMatchOrdersTx(taker: SignedOrder, makers: SignedOrder[], operator: PublicKey, payer: PublicKey, opts?: {
         marketOracleVault?: PublicKey;
     }): Promise<VersionedTransaction>;
+    /**
+     * 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
+     */
+    buildBatchCollectRedeemEarlyTx(signedOrders: SignedCollectFeeOrder[], condition: PublicKey, outcomeIndex: 0 | 1, operator: PublicKey, payer: PublicKey, opts?: {
+        marketOracleVault?: PublicKey;
+    }): Promise<VersionedTransaction>;
     fetchConfig(): Promise<ClobConfig | null>;
     fetchOrderStatus(maker: PublicKey, nonce: anchor.BN): Promise<OrderStatus | null>;
     fetchOrderRecord(maker: PublicKey, nonce: anchor.BN): Promise<{
@@ -884,6 +956,46 @@ declare class AdminClient {
     distributeMarket(conditionId: Uint8Array, amount: anchor.BN, collateralMint: PublicKey, marketOracleVault: PublicKey, owner: PublicKey, claimer?: PublicKey, payer?: PublicKey): Promise<Transaction>;
 }
 
+interface ReferralConfigInfo {
+    owner: PublicKey;
+    collateralMint: PublicKey;
+    whitelist: PublicKey[];
+    bump: number;
+}
+declare class ReferralClient {
+    private readonly program;
+    private readonly provider;
+    private readonly programIds;
+    constructor(program: anchor.Program, provider: anchor.AnchorProvider, programIds: ProgramIds);
+    get walletPubkey(): PublicKey;
+    referralVault(owner: PublicKey, collateralMint: PublicKey): PublicKey;
+    fetchConfig(owner: PublicKey): Promise<ReferralConfigInfo | null>;
+    /**
+     * Build initialize tx — creates referral config PDA.
+     * Also prepends an ATA creation instruction for the referral vault (idempotent).
+     * Build-tx pattern.
+     */
+    buildInitializeTx(collateralMint: PublicKey, owner?: PublicKey, payer?: PublicKey): Promise<{
+        tx: Transaction;
+        configPda: PublicKey;
+        vaultAta: PublicKey;
+    }>;
+    /** Build add-to-whitelist tx. Build-tx pattern. */
+    buildAddToWhitelistTx(address: PublicKey, owner?: PublicKey, payer?: PublicKey): Promise<Transaction>;
+    /** Build remove-from-whitelist tx. Build-tx pattern. */
+    buildRemoveFromWhitelistTx(address: PublicKey, owner?: PublicKey, payer?: PublicKey): Promise<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)
+     */
+    buildBatchSendUsdsTx(recipients: PublicKey[], amounts: BN[], configOwner: PublicKey, collateralMint: PublicKey, authority?: PublicKey, payer?: PublicKey): Promise<Transaction>;
+}
+
 declare class XMarketSDK {
     readonly provider: anchor.AnchorProvider;
     readonly networkConfig: NetworkConfig;
@@ -898,6 +1010,7 @@ declare class XMarketSDK {
     private _presale?;
     private _marketOracle?;
     private _admin?;
+    private _referral?;
     constructor(config: NetworkConfig, wallet: anchor.Wallet, marketOwner?: PublicKey);
     private _withAddress;
     get oracle(): OracleClient;
@@ -909,6 +1022,7 @@ declare class XMarketSDK {
     get presale(): PresaleClient;
     get marketOracle(): MarketOracleClient;
     get admin(): AdminClient;
+    get referral(): ReferralClient;
 }
 
 declare const SEEDS: {
@@ -929,6 +1043,7 @@ declare const SEEDS: {
     readonly clobConfig: Buffer<ArrayBuffer>;
     readonly order: Buffer<ArrayBuffer>;
     readonly feeConfig: Buffer<ArrayBuffer>;
+    readonly referralConfig: Buffer<ArrayBuffer>;
     readonly questionFee: Buffer<ArrayBuffer>;
     readonly marketFee: Buffer<ArrayBuffer>;
     readonly presale: Buffer<ArrayBuffer>;
@@ -968,6 +1083,7 @@ declare class PDA {
     static userBuyRecord(presalePda: PublicKey, user: PublicKey, programIds: Pick<ProgramIds, "presale">): [PublicKey, number];
     static marketOraclePda(questionPda: PublicKey, programIds: Pick<ProgramIds, "marketOracle">): [PublicKey, number];
     static userClaimRecord(marketOraclePda: PublicKey, user: PublicKey, programIds: Pick<ProgramIds, "marketOracle">): [PublicKey, number];
+    static referralConfig(owner: PublicKey, programIds: Pick<ProgramIds, "referral">): [PublicKey, number];
     static adminConfig(owner: PublicKey, programIds: Pick<ProgramIds, "adminContract">): [PublicKey, number];
     static claimRecord(conditionId: Uint8Array, programIds: Pick<ProgramIds, "adminContract">): [PublicKey, number];
 }
@@ -1008,6 +1124,25 @@ declare function buildBatchedEd25519Instruction(orders: SignedOrder[]): Transact
  * Pass this as `ixSysvar` to all match_* instruction accounts.
  */
 declare const IX_SYSVAR: _solana_web3_js.PublicKey;
+/**
+ * Convert SignedOrder to the shape anchor expects for SignedOrder struct.
+ * The signature must be passed as a fixed-size array of 64 numbers.
+ */
+/**
+ * Serialize a CollectFeeOrder to 120 bytes — must match Rust `CollectFeeOrder::to_signable_bytes()`.
+ *   [0..32]    user pubkey
+ *   [32..64]   condition pubkey
+ *   [64..96]   token_mint pubkey
+ *   [96..104]  amount (u64 le)
+ *   [104..112] nonce (u64 le)
+ *   [112..120] expiry (i64 le)
+ */
+declare function serializeCollectFeeOrderToBytes(order: CollectFeeOrder): Uint8Array;
+/**
+ * Build a batched Ed25519 precompile instruction for N signed CollectFeeOrders.
+ * Same layout as buildBatchedEd25519Instruction but with 120-byte messages.
+ */
+declare function buildBatchedCollectFeeEd25519Instruction(orders: SignedCollectFeeOrder[]): TransactionInstruction;
 
 /**
  * High-level order utilities — build, sign, serialize, verify, detect match type.
@@ -1160,4 +1295,4 @@ declare function buildApproveCollateralTx(collateralMint: PublicKey, signer: Pub
  */
 declare function buildApproveAllOutcomeTokensTx(condition: PublicKey, signer: PublicKey, payer: PublicKey, delegate: PublicKey, programIds: ProgramIds, amount?: BN): Transaction;
 
-export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, SEEDS, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };
+export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type CollectFeeOrder, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, ReferralClient, type ReferralConfigInfo, SEEDS, type SignedCollectFeeOrder, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedCollectFeeEd25519Instruction, buildBatchedEd25519Instruction, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeCollectFeeOrderToBytes, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };

package/dist/index.d.ts

@@ -13,6 +13,7 @@ interface ProgramIds {
     presale?: PublicKey;
     marketOracle?: PublicKey;
     adminContract?: PublicKey;
+    referral?: PublicKey;
 }
 interface CollateralConfig {
     mint: PublicKey;
@@ -214,6 +215,21 @@ interface SignedOrder {
     /** Ed25519 signature (64 bytes) from order.maker over serializeOrderToBytes() */
     signature: Uint8Array;
 }
+/** Authorization for CLOB to collect fee_amount winning tokens after question resolution. */
+interface CollectFeeOrder {
+    user: PublicKey;
+    condition: PublicKey;
+    tokenMint: PublicKey;
+    amount: BN;
+    nonce: BN;
+    /** Unix timestamp, 0 = no expiry */
+    expiry: BN;
+}
+interface SignedCollectFeeOrder {
+    order: CollectFeeOrder;
+    /** Ed25519 signature (64 bytes) from order.user over serializeCollectFeeOrderToBytes() */
+    signature: Uint8Array;
+}
 declare class XMarketError extends Error {
     code?: string | undefined;
     constructor(message: string, code?: string | undefined);
@@ -529,7 +545,21 @@ declare class FeeManagementClient {
     private readonly provider;
     private readonly programIds;
     constructor(program: anchor.Program, provider: anchor.AnchorProvider, programIds: ProgramIds);
-    initFeeConfig(admin: PublicKey, companyAddress: PublicKey, referralAddress: PublicKey, presaleRevenueAddress: PublicKey, investorsMarketRev: number, companyMarketRev: number, agentsPresaleRev: number, companyPresaleRev: number, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
+    initFeeConfig(params: {
+        admin: PublicKey;
+        companyAddress: PublicKey;
+        referralAddress: PublicKey;
+        presaleRevenueAddress: PublicKey;
+        investorsMarketRev: number;
+        companyMarketRev: number;
+        agentsPresaleRev: number;
+        companyPresaleRev: number;
+        /** Share routed to referral vault (e.g. 2_000 = 20%). Must satisfy referral+company+investors=10_000 */
+        referralMarketRev: number;
+        referralVault: PublicKey;
+        authority: PublicKey;
+        payer: PublicKey;
+    }): Promise<TxResult>;
     fetchFeeConfig(owner: PublicKey): Promise<any | null>;
     /**
      * Fetch per-market fees for a condition.
@@ -549,10 +579,32 @@ declare class FeeManagementClient {
      * @param authority      - signer authorized in fee_config whitelist / admin / owner
      * @param payer          - rent + tx fee payer
      */
-    updateFeeConfig(companyAddress: PublicKey, referralAddress: PublicKey, presaleRevenueAddress: PublicKey, investorsMarketRev: number, companyMarketRev: number, agentsPresaleRev: number, companyPresaleRev: number, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
+    updateFeeConfig(params: {
+        companyAddress: PublicKey;
+        referralAddress: PublicKey;
+        presaleRevenueAddress: PublicKey;
+        investorsMarketRev: number;
+        companyMarketRev: number;
+        agentsPresaleRev: number;
+        companyPresaleRev: number;
+        referralMarketRev: number;
+        referralVault: PublicKey;
+        authority: PublicKey;
+        payer: PublicKey;
+    }): Promise<TxResult>;
     setMarketFeeOverride(conditionPda: PublicKey, investors: number, company: number, isAdmin: boolean, feeConfigOwner: PublicKey, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
-    buildDistributeFeeIx(conditionPda: PublicKey, amount: BN, feeConfigOwner: PublicKey, sourceAta: PublicKey, companyAta: PublicKey, marketOracleVault: PublicKey, authority: PublicKey): Promise<TransactionInstruction>;
-    distributeFee(conditionPda: PublicKey, amount: BN, feeConfigOwner: PublicKey, sourceAta: PublicKey, companyAta: PublicKey, marketOracleVault: PublicKey, authority: PublicKey): Promise<TxResult>;
+    /**
+     * 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)
+     */
+    buildEditMarketFeeTx(conditionPda: PublicKey, mergeFee: BN, redeemFee: BN, swapFee: BN, feeConfigOwner: PublicKey, authority: PublicKey, payer?: PublicKey): Promise<Transaction>;
+    /** @deprecated use buildEditMarketFeeTx */
     setQuestionFee(conditionPda: PublicKey, mergeFee: BN, redeemFee: BN, swapFee: BN, feeConfigOwner: PublicKey, authority: PublicKey, payer: PublicKey): Promise<TxResult>;
 }
 
@@ -566,6 +618,8 @@ declare class ClobClient {
     feeConfigOwner?: PublicKey;
     /** Cached company_address from fee_config to avoid repeated RPC calls */
     private _companyAddress?;
+    /** Cached referral_vault from fee_config */
+    private _referralVault?;
     /** ALT cache: condition.toBase58() → loaded ALT account */
     private _altCache;
     constructor(program: anchor.Program, provider: anchor.AnchorProvider, programIds: ProgramIds, networkConfig: {
@@ -574,6 +628,7 @@ declare class ClobClient {
         };
     });
     private companyAddress;
+    private referralVault;
     get walletPubkey(): PublicKey;
     /**
      * Get or create an ALT for a condition.
@@ -736,6 +791,23 @@ declare class ClobClient {
     buildMatchOrdersTx(taker: SignedOrder, makers: SignedOrder[], operator: PublicKey, payer: PublicKey, opts?: {
         marketOracleVault?: PublicKey;
     }): Promise<VersionedTransaction>;
+    /**
+     * 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
+     */
+    buildBatchCollectRedeemEarlyTx(signedOrders: SignedCollectFeeOrder[], condition: PublicKey, outcomeIndex: 0 | 1, operator: PublicKey, payer: PublicKey, opts?: {
+        marketOracleVault?: PublicKey;
+    }): Promise<VersionedTransaction>;
     fetchConfig(): Promise<ClobConfig | null>;
     fetchOrderStatus(maker: PublicKey, nonce: anchor.BN): Promise<OrderStatus | null>;
     fetchOrderRecord(maker: PublicKey, nonce: anchor.BN): Promise<{
@@ -884,6 +956,46 @@ declare class AdminClient {
     distributeMarket(conditionId: Uint8Array, amount: anchor.BN, collateralMint: PublicKey, marketOracleVault: PublicKey, owner: PublicKey, claimer?: PublicKey, payer?: PublicKey): Promise<Transaction>;
 }
 
+interface ReferralConfigInfo {
+    owner: PublicKey;
+    collateralMint: PublicKey;
+    whitelist: PublicKey[];
+    bump: number;
+}
+declare class ReferralClient {
+    private readonly program;
+    private readonly provider;
+    private readonly programIds;
+    constructor(program: anchor.Program, provider: anchor.AnchorProvider, programIds: ProgramIds);
+    get walletPubkey(): PublicKey;
+    referralVault(owner: PublicKey, collateralMint: PublicKey): PublicKey;
+    fetchConfig(owner: PublicKey): Promise<ReferralConfigInfo | null>;
+    /**
+     * Build initialize tx — creates referral config PDA.
+     * Also prepends an ATA creation instruction for the referral vault (idempotent).
+     * Build-tx pattern.
+     */
+    buildInitializeTx(collateralMint: PublicKey, owner?: PublicKey, payer?: PublicKey): Promise<{
+        tx: Transaction;
+        configPda: PublicKey;
+        vaultAta: PublicKey;
+    }>;
+    /** Build add-to-whitelist tx. Build-tx pattern. */
+    buildAddToWhitelistTx(address: PublicKey, owner?: PublicKey, payer?: PublicKey): Promise<Transaction>;
+    /** Build remove-from-whitelist tx. Build-tx pattern. */
+    buildRemoveFromWhitelistTx(address: PublicKey, owner?: PublicKey, payer?: PublicKey): Promise<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)
+     */
+    buildBatchSendUsdsTx(recipients: PublicKey[], amounts: BN[], configOwner: PublicKey, collateralMint: PublicKey, authority?: PublicKey, payer?: PublicKey): Promise<Transaction>;
+}
+
 declare class XMarketSDK {
     readonly provider: anchor.AnchorProvider;
     readonly networkConfig: NetworkConfig;
@@ -898,6 +1010,7 @@ declare class XMarketSDK {
     private _presale?;
     private _marketOracle?;
     private _admin?;
+    private _referral?;
     constructor(config: NetworkConfig, wallet: anchor.Wallet, marketOwner?: PublicKey);
     private _withAddress;
     get oracle(): OracleClient;
@@ -909,6 +1022,7 @@ declare class XMarketSDK {
     get presale(): PresaleClient;
     get marketOracle(): MarketOracleClient;
     get admin(): AdminClient;
+    get referral(): ReferralClient;
 }
 
 declare const SEEDS: {
@@ -929,6 +1043,7 @@ declare const SEEDS: {
     readonly clobConfig: Buffer<ArrayBuffer>;
     readonly order: Buffer<ArrayBuffer>;
     readonly feeConfig: Buffer<ArrayBuffer>;
+    readonly referralConfig: Buffer<ArrayBuffer>;
     readonly questionFee: Buffer<ArrayBuffer>;
     readonly marketFee: Buffer<ArrayBuffer>;
     readonly presale: Buffer<ArrayBuffer>;
@@ -968,6 +1083,7 @@ declare class PDA {
     static userBuyRecord(presalePda: PublicKey, user: PublicKey, programIds: Pick<ProgramIds, "presale">): [PublicKey, number];
     static marketOraclePda(questionPda: PublicKey, programIds: Pick<ProgramIds, "marketOracle">): [PublicKey, number];
     static userClaimRecord(marketOraclePda: PublicKey, user: PublicKey, programIds: Pick<ProgramIds, "marketOracle">): [PublicKey, number];
+    static referralConfig(owner: PublicKey, programIds: Pick<ProgramIds, "referral">): [PublicKey, number];
     static adminConfig(owner: PublicKey, programIds: Pick<ProgramIds, "adminContract">): [PublicKey, number];
     static claimRecord(conditionId: Uint8Array, programIds: Pick<ProgramIds, "adminContract">): [PublicKey, number];
 }
@@ -1008,6 +1124,25 @@ declare function buildBatchedEd25519Instruction(orders: SignedOrder[]): Transact
  * Pass this as `ixSysvar` to all match_* instruction accounts.
  */
 declare const IX_SYSVAR: _solana_web3_js.PublicKey;
+/**
+ * Convert SignedOrder to the shape anchor expects for SignedOrder struct.
+ * The signature must be passed as a fixed-size array of 64 numbers.
+ */
+/**
+ * Serialize a CollectFeeOrder to 120 bytes — must match Rust `CollectFeeOrder::to_signable_bytes()`.
+ *   [0..32]    user pubkey
+ *   [32..64]   condition pubkey
+ *   [64..96]   token_mint pubkey
+ *   [96..104]  amount (u64 le)
+ *   [104..112] nonce (u64 le)
+ *   [112..120] expiry (i64 le)
+ */
+declare function serializeCollectFeeOrderToBytes(order: CollectFeeOrder): Uint8Array;
+/**
+ * Build a batched Ed25519 precompile instruction for N signed CollectFeeOrders.
+ * Same layout as buildBatchedEd25519Instruction but with 120-byte messages.
+ */
+declare function buildBatchedCollectFeeEd25519Instruction(orders: SignedCollectFeeOrder[]): TransactionInstruction;
 
 /**
  * High-level order utilities — build, sign, serialize, verify, detect match type.
@@ -1160,4 +1295,4 @@ declare function buildApproveCollateralTx(collateralMint: PublicKey, signer: Pub
  */
 declare function buildApproveAllOutcomeTokensTx(condition: PublicKey, signer: PublicKey, payer: PublicKey, delegate: PublicKey, programIds: ProgramIds, amount?: BN): Transaction;
 
-export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, SEEDS, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedEd25519Instruction, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };
+export { AccountNotFoundError, AdminClient, type AdminConfigInfo, type ClaimRecordInfo, ClobClient, type ClobConfig, type CollateralConfig, type CollateralVault, type CollectFeeOrder, type Condition, type CreateQuestionParams, CtfClient, type CtfConfig, FEE_DENOMINATOR, FeeManagementClient, HookClient, type HookConfig, IX_SYSVAR, InvalidParamError, MAX_APPROVE_AMOUNT, MarketClient, MarketOracleClient, type MarketOracleInfo, type MatchType, type NetworkConfig, type NetworkName, OracleClient, type OracleConfig, type Order, type OrderStatus, PDA, type Position, PresaleClient, type PresaleInfo, type ProgramIds, type Question, type QuestionFee, type QuestionMarketConfig, type QuestionResult, QuestionStatus, ReferralClient, type ReferralConfigInfo, SEEDS, type SignedCollectFeeOrder, type SignedOrder, type TxResult, UnauthorizedError, type UserBuyRecord, type UserClaimRecord, XMarketError, XMarketSDK, buildApproveAllOutcomeTokensTx, buildApproveCollateralTx, buildBatchedCollectFeeEd25519Instruction, buildBatchedEd25519Instruction, buildCreateUserAtasTx, buildOrder, buildOrderFromPrice, deserializeSignedOrder, detectMatchType, generateContentHash, generateQuestionId, getOrderSignBytes, orderAmountsFromPrice, serializeCollectFeeOrderToBytes, serializeOrderToBytes, serializeSignedOrder, signOrder, signOrderWithKeypair, verifySignedOrder };