@thru/programs 0.2.39 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2616,6 +2616,145 @@ declare class ClobProgramAccountBuilder {
2616
2616
  finish(): ClobProgramAccount;
2617
2617
  }
2618
2618
 
2619
+ interface ClobAssetBalanceAllocation {
2620
+ market: string;
2621
+ authority: string;
2622
+ seatIndex: number;
2623
+ tokenSide: ClobTokenSide;
2624
+ mint: string | null;
2625
+ vault: string;
2626
+ freeAmount: bigint;
2627
+ statusFlags: number;
2628
+ tokenProgram: string;
2629
+ metadataReady: boolean;
2630
+ }
2631
+ interface ClobExchangeAssetBalance {
2632
+ authority: string;
2633
+ mint: string;
2634
+ tokenProgram: string;
2635
+ freeAmount: bigint;
2636
+ transferableAmount: bigint;
2637
+ allocations: ClobAssetBalanceAllocation[];
2638
+ }
2639
+ interface ClobTradingMarket {
2640
+ address: string;
2641
+ orderArena: string;
2642
+ bidsCbook: string;
2643
+ asksCbook: string;
2644
+ tokenProgram: string;
2645
+ baseMint: string | null;
2646
+ quoteMint: string | null;
2647
+ baseVault: string;
2648
+ quoteVault: string;
2649
+ marketAuthority: string;
2650
+ statusFlags: number;
2651
+ }
2652
+ interface ClobFundingSource {
2653
+ allocation: ClobAssetBalanceAllocation;
2654
+ amount: bigint;
2655
+ }
2656
+ declare const CLOB_MAX_ATOMIC_FUNDING_SOURCES = 64;
2657
+ interface ClobOrderFundingPlan {
2658
+ authority: string;
2659
+ targetMarket: string;
2660
+ targetTokenSide: ClobTokenSide;
2661
+ targetSeatIndex: number | null;
2662
+ mint: string;
2663
+ tokenProgram: string;
2664
+ requiredAmount: bigint;
2665
+ targetAmount: bigint;
2666
+ exchangeAvailableAmount: bigint;
2667
+ sources: ClobFundingSource[];
2668
+ shortfall: bigint;
2669
+ }
2670
+ interface PlanClobOrderFundingArgs {
2671
+ authority: string;
2672
+ targetMarket: ClobTradingMarket;
2673
+ side: ClobOrderSide;
2674
+ orderType?: ClobOrderType;
2675
+ price: bigint;
2676
+ quantity: bigint;
2677
+ allocations: ClobAssetBalanceAllocation[];
2678
+ targetSeatIndex?: number;
2679
+ }
2680
+ interface ClobInstructionPlanReview {
2681
+ instruction: 'exchange_deposit' | 'exchange_withdrawal' | 'funded_order';
2682
+ label: string;
2683
+ value: Record<string, string>;
2684
+ }
2685
+ interface ClobInstructionPlan {
2686
+ instructionData: InstructionData;
2687
+ readWriteAccounts: string[];
2688
+ readOnlyAccounts: string[];
2689
+ review: ClobInstructionPlanReview;
2690
+ }
2691
+ interface ClobTransactionPlan extends ClobInstructionPlan {
2692
+ programAddress: string;
2693
+ }
2694
+ interface ClobTokenAccountInitialization {
2695
+ instructionData: InstructionData;
2696
+ tokenProgram: string;
2697
+ tokenAccount: string;
2698
+ mint: string;
2699
+ owner: string;
2700
+ }
2701
+ interface WrapClobPlanWithTokenAccountInitializationArgs {
2702
+ plan: ClobInstructionPlan;
2703
+ clobProgram: string;
2704
+ initialization: ClobTokenAccountInitialization;
2705
+ }
2706
+ interface BuildClobExchangeDepositArgs {
2707
+ market: ClobTradingMarket;
2708
+ authority: string;
2709
+ walletTokenAccount: string;
2710
+ tokenSide: ClobTokenSide;
2711
+ amount: bigint;
2712
+ seatIndex: number | null;
2713
+ }
2714
+ interface BuildClobExchangeWithdrawalArgs {
2715
+ market: ClobTradingMarket;
2716
+ authority: string;
2717
+ walletTokenAccount: string;
2718
+ tokenSide: ClobTokenSide;
2719
+ amount: bigint;
2720
+ seatIndex: number;
2721
+ }
2722
+ interface BuildClobFundedOrderArgs {
2723
+ plan: ClobOrderFundingPlan;
2724
+ targetMarket: ClobTradingMarket;
2725
+ sourceMarkets?: ClobTradingMarket[];
2726
+ walletTokenAccount: string;
2727
+ price: bigint;
2728
+ quantity: bigint;
2729
+ orderType?: ClobOrderType;
2730
+ expirationTime: bigint;
2731
+ clientId?: Uint8Array;
2732
+ discardAfterMatch?: boolean;
2733
+ failIfOutsideBook?: boolean;
2734
+ }
2735
+ type ClobExchangeErrorCode = 'invalid_funding_amount' | 'market_paused' | 'market_post_only' | 'deposits_frozen' | 'withdrawals_frozen' | 'insufficient_funds' | 'too_many_funding_sources' | 'stale_balance' | 'funding_plan_mismatch';
2736
+ declare class ClobExchangeError extends Error {
2737
+ readonly code: ClobExchangeErrorCode;
2738
+ constructor(code: ClobExchangeErrorCode, message: string);
2739
+ }
2740
+ declare function aggregateClobExchangeBalances(allocations: ClobAssetBalanceAllocation[]): ClobExchangeAssetBalance[];
2741
+ declare function calculateClobOrderFundingAmount(args: {
2742
+ side: ClobOrderSide;
2743
+ price: bigint;
2744
+ quantity: bigint;
2745
+ }): bigint;
2746
+ declare function planClobOrderFunding(args: PlanClobOrderFundingArgs): ClobOrderFundingPlan;
2747
+ declare function validateClobOrderFundingPlanSeats(args: {
2748
+ plan: ClobOrderFundingPlan;
2749
+ targetSeats: ClobSeatEntry[];
2750
+ sourceSeatsByMarket?: Readonly<Record<string, ClobSeatEntry[]>>;
2751
+ }): void;
2752
+ declare function buildClobExchangeDepositInstructionPlan(args: BuildClobExchangeDepositArgs): ClobInstructionPlan;
2753
+ declare function buildClobExchangeWithdrawalInstructionPlan(args: BuildClobExchangeWithdrawalArgs): ClobInstructionPlan;
2754
+ declare function buildClobFundedOrderInstructionPlan(args: BuildClobFundedOrderArgs): ClobInstructionPlan;
2755
+ declare function concatClobInstructions(...instructions: InstructionData[]): InstructionData;
2756
+ declare function wrapClobPlanWithTokenAccountInitialization(args: WrapClobPlanWithTokenAccountInitializationArgs): ClobTransactionPlan;
2757
+
2619
2758
  declare const CLOB_INSTRUCTION_MARKET_RECORD = 0;
2620
2759
  declare const CLOB_INSTRUCTION_SEAT_CREATE = 1;
2621
2760
  declare const CLOB_INSTRUCTION_TOKEN_DEPOSIT = 2;
@@ -2686,9 +2825,10 @@ interface MarketRecordArgs {
2686
2825
  tokenProgramAccountBytes: Uint8Array;
2687
2826
  baseVaultAccountBytes: Uint8Array;
2688
2827
  quoteVaultAccountBytes: Uint8Array;
2689
- marketAuthorityAccountBytes: Uint8Array;
2828
+ marketAuthorityAccountBytes?: Uint8Array;
2690
2829
  }
2691
2830
  interface MarketCreateArgs extends MarketRecordArgs {
2831
+ marketAuthorityAccountBytes: Uint8Array;
2692
2832
  lotSize: bigint;
2693
2833
  tickSize: bigint;
2694
2834
  baseMintAccountBytes: Uint8Array;
@@ -2958,5 +3098,6 @@ declare function encodeOrderFlags(args: {
2958
3098
  discardAfterMatch?: boolean;
2959
3099
  failIfOutsideBook?: boolean;
2960
3100
  }): number;
3101
+ declare function assertClobActiveSeatIndex(value: number, label?: string): number;
2961
3102
 
2962
- export { type AccountLookupContext, ArenaHeader, ArenaHeaderBuilder, CLOB_ARENA_HEADER_SIZE, CLOB_CBOOK_EMPTY_PRICE_IN_TICKS, CLOB_CBOOK_HEADER_SIZE, CLOB_CBOOK_LEVEL_SIZE, CLOB_CBOOK_MAX_PRICE_IN_TICKS, CLOB_CBOOK_MAX_SIZE, CLOB_CLIENT_ID_SIZE, CLOB_EVENT_MARKET_CREATED, CLOB_EVENT_MARKET_STATUS, CLOB_EVENT_ORDER_CANCELLED, CLOB_EVENT_ORDER_ENTRY_REMOVED, CLOB_EVENT_ORDER_FILLED, CLOB_EVENT_ORDER_MODIFIED, CLOB_EVENT_ORDER_POSTED, CLOB_EVENT_REMOVE_REASON_EVICTED, CLOB_EVENT_REMOVE_REASON_EXPIRED, CLOB_EVENT_REMOVE_REASON_FILLED, CLOB_EVENT_REMOVE_REASON_USER, CLOB_EVENT_SEAT_ASSIGNED, CLOB_EVENT_SIDE_BUY, CLOB_EVENT_SIDE_SELL, CLOB_EVENT_TOKEN_DEPOSIT, CLOB_EVENT_TOKEN_SIDE_BASE, CLOB_EVENT_TOKEN_SIDE_QUOTE, CLOB_EVENT_TOKEN_WITHDRAW, CLOB_INSTRUCTION_CREATE_ORDER_ENTRY, CLOB_INSTRUCTION_CREATE_SEATLESS_ORDER_ENTRY, CLOB_INSTRUCTION_MARKET_CREATE, CLOB_INSTRUCTION_MARKET_RECORD, CLOB_INSTRUCTION_MARKET_SET_STATUS, CLOB_INSTRUCTION_MODIFY_ORDER_ENTRY, CLOB_INSTRUCTION_SEAT_CREATE, CLOB_INSTRUCTION_TOKEN_DEPOSIT, CLOB_INSTRUCTION_TOKEN_WITHDRAW, CLOB_MARKET_ACCOUNT_SIZE, CLOB_MODIFY_FLAG_FAIL_IF_OUT_OF_RANGE, CLOB_MODIFY_FLAG_HAS_CLIENT_ID, CLOB_MODIFY_FLAG_HAS_ORDER_ID, CLOB_NULL_INDEX, CLOB_ORDER_ENTRY_SIZE, CLOB_ORDER_FLAG_BUY, CLOB_ORDER_FLAG_HAS_CLIENT_ID, CLOB_ORDER_TYPE_ALO, CLOB_ORDER_TYPE_FOK, CLOB_ORDER_TYPE_GTC, CLOB_ORDER_TYPE_IOC, CLOB_ORDER_TYPE_MTL, CLOB_SEATLESS_SEAT_IDX, CLOB_SEAT_ENTRY_SIZE, CLOB_STATUS_FLAG_DEPOSITS_FROZEN, CLOB_STATUS_FLAG_PAUSED, CLOB_STATUS_FLAG_POST_ONLY, CLOB_STATUS_FLAG_WITHDRAWALS_FROZEN, CbookAccount, CbookHeader, CbookHeaderBuilder, CbookLevel, CbookLevelBuilder, ClientId, type ClobArenaHeader, type ClobArenaSlot, type ClobCbook, type ClobCbookLevel, ClobError, ClobErrorBuilder, ClobEvent, ClobEventBuilder, ClobInstruction, ClobInstructionBuilder, type ClobMarket, type ClobOrderBookLevel, type ClobOrderBookOrder, type ClobOrderBookSnapshot, type ClobOrderEntry, type ClobOrderRemovalReason, type ClobOrderSide, type ClobOrderType, ClobProgramAccount, ClobProgramAccountBuilder, type ClobSeatEntry, type ClobTokenSide, type CreateOrderArgs, CreateOrderEntryInstruction, CreateOrderEntryInstructionBuilder, type CreateSeatlessOrderArgs, CreateSeatlessOrderEntryInstruction, CreateSeatlessOrderEntryInstructionBuilder, type InstructionData, MarketAccountBuilder, MarketAccount as MarketAccountView, type MarketCreateArgs, MarketCreateInstruction, MarketCreateInstructionBuilder, MarketCreatedEvent, MarketCreatedEventBuilder, type MarketRecordArgs, MarketRecordInstruction, MarketRecordInstructionBuilder, type MarketSetStatusArgs, MarketSetStatusInstruction, MarketSetStatusInstructionBuilder, type ModifyOrderArgs, ModifyOrderEntryInstruction, ModifyOrderEntryInstructionBuilder, OrderArenaAccount, OrderCancelledEvent, OrderCancelledEventBuilder, OrderEntryBuilder, OrderEntryRemovedEvent, OrderEntryRemovedEventBuilder, OrderEntry as OrderEntryView, OrderFilledEvent, OrderFilledEventBuilder, OrderModifiedEvent, OrderModifiedEventBuilder, OrderPostedEvent, OrderPostedEventBuilder, type ParsedClobEvent, type ParsedClobEventBase, SeatArenaAccount, SeatAssignedEvent, SeatAssignedEventBuilder, type SeatCreateArgs, SeatCreateInstruction, SeatCreateInstructionBuilder, SeatEntryBuilder, SeatEntry as SeatEntryView, TokenBalanceEvent, TokenBalanceEventBuilder, type TokenTransferArgs, TokenTransferInstruction, TokenTransferInstructionBuilder, buildOrderBookSnapshot, createMarketCreateInstruction, createMarketRecordInstruction, createMarketSetStatusInstruction, createModifyOrderEntryInstruction, createOrderEntryInstruction, createSeatCreateInstruction, createSeatlessOrderEntryInstruction, createTokenDepositInstruction, createTokenWithdrawInstruction, encodeOrderFlags, parseCbookAccount, parseClobEvent, parseClobProgramAccount, parseMarketAccount, parseOrderArenaAccount, parseSeatArenaAccount };
3103
+ export { type AccountLookupContext, ArenaHeader, ArenaHeaderBuilder, type BuildClobExchangeDepositArgs, type BuildClobExchangeWithdrawalArgs, type BuildClobFundedOrderArgs, CLOB_ARENA_HEADER_SIZE, CLOB_CBOOK_EMPTY_PRICE_IN_TICKS, CLOB_CBOOK_HEADER_SIZE, CLOB_CBOOK_LEVEL_SIZE, CLOB_CBOOK_MAX_PRICE_IN_TICKS, CLOB_CBOOK_MAX_SIZE, CLOB_CLIENT_ID_SIZE, CLOB_EVENT_MARKET_CREATED, CLOB_EVENT_MARKET_STATUS, CLOB_EVENT_ORDER_CANCELLED, CLOB_EVENT_ORDER_ENTRY_REMOVED, CLOB_EVENT_ORDER_FILLED, CLOB_EVENT_ORDER_MODIFIED, CLOB_EVENT_ORDER_POSTED, CLOB_EVENT_REMOVE_REASON_EVICTED, CLOB_EVENT_REMOVE_REASON_EXPIRED, CLOB_EVENT_REMOVE_REASON_FILLED, CLOB_EVENT_REMOVE_REASON_USER, CLOB_EVENT_SEAT_ASSIGNED, CLOB_EVENT_SIDE_BUY, CLOB_EVENT_SIDE_SELL, CLOB_EVENT_TOKEN_DEPOSIT, CLOB_EVENT_TOKEN_SIDE_BASE, CLOB_EVENT_TOKEN_SIDE_QUOTE, CLOB_EVENT_TOKEN_WITHDRAW, CLOB_INSTRUCTION_CREATE_ORDER_ENTRY, CLOB_INSTRUCTION_CREATE_SEATLESS_ORDER_ENTRY, CLOB_INSTRUCTION_MARKET_CREATE, CLOB_INSTRUCTION_MARKET_RECORD, CLOB_INSTRUCTION_MARKET_SET_STATUS, CLOB_INSTRUCTION_MODIFY_ORDER_ENTRY, CLOB_INSTRUCTION_SEAT_CREATE, CLOB_INSTRUCTION_TOKEN_DEPOSIT, CLOB_INSTRUCTION_TOKEN_WITHDRAW, CLOB_MARKET_ACCOUNT_SIZE, CLOB_MAX_ATOMIC_FUNDING_SOURCES, CLOB_MODIFY_FLAG_FAIL_IF_OUT_OF_RANGE, CLOB_MODIFY_FLAG_HAS_CLIENT_ID, CLOB_MODIFY_FLAG_HAS_ORDER_ID, CLOB_NULL_INDEX, CLOB_ORDER_ENTRY_SIZE, CLOB_ORDER_FLAG_BUY, CLOB_ORDER_FLAG_HAS_CLIENT_ID, CLOB_ORDER_TYPE_ALO, CLOB_ORDER_TYPE_FOK, CLOB_ORDER_TYPE_GTC, CLOB_ORDER_TYPE_IOC, CLOB_ORDER_TYPE_MTL, CLOB_SEATLESS_SEAT_IDX, CLOB_SEAT_ENTRY_SIZE, CLOB_STATUS_FLAG_DEPOSITS_FROZEN, CLOB_STATUS_FLAG_PAUSED, CLOB_STATUS_FLAG_POST_ONLY, CLOB_STATUS_FLAG_WITHDRAWALS_FROZEN, CbookAccount, CbookHeader, CbookHeaderBuilder, CbookLevel, CbookLevelBuilder, ClientId, type ClobArenaHeader, type ClobArenaSlot, type ClobAssetBalanceAllocation, type ClobCbook, type ClobCbookLevel, ClobError, ClobErrorBuilder, ClobEvent, ClobEventBuilder, type ClobExchangeAssetBalance, ClobExchangeError, type ClobExchangeErrorCode, type ClobFundingSource, ClobInstruction, ClobInstructionBuilder, type ClobInstructionPlan, type ClobInstructionPlanReview, type ClobMarket, type ClobOrderBookLevel, type ClobOrderBookOrder, type ClobOrderBookSnapshot, type ClobOrderEntry, type ClobOrderFundingPlan, type ClobOrderRemovalReason, type ClobOrderSide, type ClobOrderType, ClobProgramAccount, ClobProgramAccountBuilder, type ClobSeatEntry, type ClobTokenAccountInitialization, type ClobTokenSide, type ClobTradingMarket, type ClobTransactionPlan, type CreateOrderArgs, CreateOrderEntryInstruction, CreateOrderEntryInstructionBuilder, type CreateSeatlessOrderArgs, CreateSeatlessOrderEntryInstruction, CreateSeatlessOrderEntryInstructionBuilder, type InstructionData, MarketAccountBuilder, MarketAccount as MarketAccountView, type MarketCreateArgs, MarketCreateInstruction, MarketCreateInstructionBuilder, MarketCreatedEvent, MarketCreatedEventBuilder, type MarketRecordArgs, MarketRecordInstruction, MarketRecordInstructionBuilder, type MarketSetStatusArgs, MarketSetStatusInstruction, MarketSetStatusInstructionBuilder, type ModifyOrderArgs, ModifyOrderEntryInstruction, ModifyOrderEntryInstructionBuilder, OrderArenaAccount, OrderCancelledEvent, OrderCancelledEventBuilder, OrderEntryBuilder, OrderEntryRemovedEvent, OrderEntryRemovedEventBuilder, OrderEntry as OrderEntryView, OrderFilledEvent, OrderFilledEventBuilder, OrderModifiedEvent, OrderModifiedEventBuilder, OrderPostedEvent, OrderPostedEventBuilder, type ParsedClobEvent, type ParsedClobEventBase, type PlanClobOrderFundingArgs, SeatArenaAccount, SeatAssignedEvent, SeatAssignedEventBuilder, type SeatCreateArgs, SeatCreateInstruction, SeatCreateInstructionBuilder, SeatEntryBuilder, SeatEntry as SeatEntryView, TokenBalanceEvent, TokenBalanceEventBuilder, type TokenTransferArgs, TokenTransferInstruction, TokenTransferInstructionBuilder, type WrapClobPlanWithTokenAccountInitializationArgs, aggregateClobExchangeBalances, assertClobActiveSeatIndex, buildClobExchangeDepositInstructionPlan, buildClobExchangeWithdrawalInstructionPlan, buildClobFundedOrderInstructionPlan, buildOrderBookSnapshot, calculateClobOrderFundingAmount, concatClobInstructions, createMarketCreateInstruction, createMarketRecordInstruction, createMarketSetStatusInstruction, createModifyOrderEntryInstruction, createOrderEntryInstruction, createSeatCreateInstruction, createSeatlessOrderEntryInstruction, createTokenDepositInstruction, createTokenWithdrawInstruction, encodeOrderFlags, parseCbookAccount, parseClobEvent, parseClobProgramAccount, parseMarketAccount, parseOrderArenaAccount, parseSeatArenaAccount, planClobOrderFunding, validateClobOrderFundingPlanSeats, wrapClobPlanWithTokenAccountInitialization };
@@ -2616,6 +2616,145 @@ declare class ClobProgramAccountBuilder {
2616
2616
  finish(): ClobProgramAccount;
2617
2617
  }
2618
2618
 
2619
+ interface ClobAssetBalanceAllocation {
2620
+ market: string;
2621
+ authority: string;
2622
+ seatIndex: number;
2623
+ tokenSide: ClobTokenSide;
2624
+ mint: string | null;
2625
+ vault: string;
2626
+ freeAmount: bigint;
2627
+ statusFlags: number;
2628
+ tokenProgram: string;
2629
+ metadataReady: boolean;
2630
+ }
2631
+ interface ClobExchangeAssetBalance {
2632
+ authority: string;
2633
+ mint: string;
2634
+ tokenProgram: string;
2635
+ freeAmount: bigint;
2636
+ transferableAmount: bigint;
2637
+ allocations: ClobAssetBalanceAllocation[];
2638
+ }
2639
+ interface ClobTradingMarket {
2640
+ address: string;
2641
+ orderArena: string;
2642
+ bidsCbook: string;
2643
+ asksCbook: string;
2644
+ tokenProgram: string;
2645
+ baseMint: string | null;
2646
+ quoteMint: string | null;
2647
+ baseVault: string;
2648
+ quoteVault: string;
2649
+ marketAuthority: string;
2650
+ statusFlags: number;
2651
+ }
2652
+ interface ClobFundingSource {
2653
+ allocation: ClobAssetBalanceAllocation;
2654
+ amount: bigint;
2655
+ }
2656
+ declare const CLOB_MAX_ATOMIC_FUNDING_SOURCES = 64;
2657
+ interface ClobOrderFundingPlan {
2658
+ authority: string;
2659
+ targetMarket: string;
2660
+ targetTokenSide: ClobTokenSide;
2661
+ targetSeatIndex: number | null;
2662
+ mint: string;
2663
+ tokenProgram: string;
2664
+ requiredAmount: bigint;
2665
+ targetAmount: bigint;
2666
+ exchangeAvailableAmount: bigint;
2667
+ sources: ClobFundingSource[];
2668
+ shortfall: bigint;
2669
+ }
2670
+ interface PlanClobOrderFundingArgs {
2671
+ authority: string;
2672
+ targetMarket: ClobTradingMarket;
2673
+ side: ClobOrderSide;
2674
+ orderType?: ClobOrderType;
2675
+ price: bigint;
2676
+ quantity: bigint;
2677
+ allocations: ClobAssetBalanceAllocation[];
2678
+ targetSeatIndex?: number;
2679
+ }
2680
+ interface ClobInstructionPlanReview {
2681
+ instruction: 'exchange_deposit' | 'exchange_withdrawal' | 'funded_order';
2682
+ label: string;
2683
+ value: Record<string, string>;
2684
+ }
2685
+ interface ClobInstructionPlan {
2686
+ instructionData: InstructionData;
2687
+ readWriteAccounts: string[];
2688
+ readOnlyAccounts: string[];
2689
+ review: ClobInstructionPlanReview;
2690
+ }
2691
+ interface ClobTransactionPlan extends ClobInstructionPlan {
2692
+ programAddress: string;
2693
+ }
2694
+ interface ClobTokenAccountInitialization {
2695
+ instructionData: InstructionData;
2696
+ tokenProgram: string;
2697
+ tokenAccount: string;
2698
+ mint: string;
2699
+ owner: string;
2700
+ }
2701
+ interface WrapClobPlanWithTokenAccountInitializationArgs {
2702
+ plan: ClobInstructionPlan;
2703
+ clobProgram: string;
2704
+ initialization: ClobTokenAccountInitialization;
2705
+ }
2706
+ interface BuildClobExchangeDepositArgs {
2707
+ market: ClobTradingMarket;
2708
+ authority: string;
2709
+ walletTokenAccount: string;
2710
+ tokenSide: ClobTokenSide;
2711
+ amount: bigint;
2712
+ seatIndex: number | null;
2713
+ }
2714
+ interface BuildClobExchangeWithdrawalArgs {
2715
+ market: ClobTradingMarket;
2716
+ authority: string;
2717
+ walletTokenAccount: string;
2718
+ tokenSide: ClobTokenSide;
2719
+ amount: bigint;
2720
+ seatIndex: number;
2721
+ }
2722
+ interface BuildClobFundedOrderArgs {
2723
+ plan: ClobOrderFundingPlan;
2724
+ targetMarket: ClobTradingMarket;
2725
+ sourceMarkets?: ClobTradingMarket[];
2726
+ walletTokenAccount: string;
2727
+ price: bigint;
2728
+ quantity: bigint;
2729
+ orderType?: ClobOrderType;
2730
+ expirationTime: bigint;
2731
+ clientId?: Uint8Array;
2732
+ discardAfterMatch?: boolean;
2733
+ failIfOutsideBook?: boolean;
2734
+ }
2735
+ type ClobExchangeErrorCode = 'invalid_funding_amount' | 'market_paused' | 'market_post_only' | 'deposits_frozen' | 'withdrawals_frozen' | 'insufficient_funds' | 'too_many_funding_sources' | 'stale_balance' | 'funding_plan_mismatch';
2736
+ declare class ClobExchangeError extends Error {
2737
+ readonly code: ClobExchangeErrorCode;
2738
+ constructor(code: ClobExchangeErrorCode, message: string);
2739
+ }
2740
+ declare function aggregateClobExchangeBalances(allocations: ClobAssetBalanceAllocation[]): ClobExchangeAssetBalance[];
2741
+ declare function calculateClobOrderFundingAmount(args: {
2742
+ side: ClobOrderSide;
2743
+ price: bigint;
2744
+ quantity: bigint;
2745
+ }): bigint;
2746
+ declare function planClobOrderFunding(args: PlanClobOrderFundingArgs): ClobOrderFundingPlan;
2747
+ declare function validateClobOrderFundingPlanSeats(args: {
2748
+ plan: ClobOrderFundingPlan;
2749
+ targetSeats: ClobSeatEntry[];
2750
+ sourceSeatsByMarket?: Readonly<Record<string, ClobSeatEntry[]>>;
2751
+ }): void;
2752
+ declare function buildClobExchangeDepositInstructionPlan(args: BuildClobExchangeDepositArgs): ClobInstructionPlan;
2753
+ declare function buildClobExchangeWithdrawalInstructionPlan(args: BuildClobExchangeWithdrawalArgs): ClobInstructionPlan;
2754
+ declare function buildClobFundedOrderInstructionPlan(args: BuildClobFundedOrderArgs): ClobInstructionPlan;
2755
+ declare function concatClobInstructions(...instructions: InstructionData[]): InstructionData;
2756
+ declare function wrapClobPlanWithTokenAccountInitialization(args: WrapClobPlanWithTokenAccountInitializationArgs): ClobTransactionPlan;
2757
+
2619
2758
  declare const CLOB_INSTRUCTION_MARKET_RECORD = 0;
2620
2759
  declare const CLOB_INSTRUCTION_SEAT_CREATE = 1;
2621
2760
  declare const CLOB_INSTRUCTION_TOKEN_DEPOSIT = 2;
@@ -2686,9 +2825,10 @@ interface MarketRecordArgs {
2686
2825
  tokenProgramAccountBytes: Uint8Array;
2687
2826
  baseVaultAccountBytes: Uint8Array;
2688
2827
  quoteVaultAccountBytes: Uint8Array;
2689
- marketAuthorityAccountBytes: Uint8Array;
2828
+ marketAuthorityAccountBytes?: Uint8Array;
2690
2829
  }
2691
2830
  interface MarketCreateArgs extends MarketRecordArgs {
2831
+ marketAuthorityAccountBytes: Uint8Array;
2692
2832
  lotSize: bigint;
2693
2833
  tickSize: bigint;
2694
2834
  baseMintAccountBytes: Uint8Array;
@@ -2958,5 +3098,6 @@ declare function encodeOrderFlags(args: {
2958
3098
  discardAfterMatch?: boolean;
2959
3099
  failIfOutsideBook?: boolean;
2960
3100
  }): number;
3101
+ declare function assertClobActiveSeatIndex(value: number, label?: string): number;
2961
3102
 
2962
- export { type AccountLookupContext, ArenaHeader, ArenaHeaderBuilder, CLOB_ARENA_HEADER_SIZE, CLOB_CBOOK_EMPTY_PRICE_IN_TICKS, CLOB_CBOOK_HEADER_SIZE, CLOB_CBOOK_LEVEL_SIZE, CLOB_CBOOK_MAX_PRICE_IN_TICKS, CLOB_CBOOK_MAX_SIZE, CLOB_CLIENT_ID_SIZE, CLOB_EVENT_MARKET_CREATED, CLOB_EVENT_MARKET_STATUS, CLOB_EVENT_ORDER_CANCELLED, CLOB_EVENT_ORDER_ENTRY_REMOVED, CLOB_EVENT_ORDER_FILLED, CLOB_EVENT_ORDER_MODIFIED, CLOB_EVENT_ORDER_POSTED, CLOB_EVENT_REMOVE_REASON_EVICTED, CLOB_EVENT_REMOVE_REASON_EXPIRED, CLOB_EVENT_REMOVE_REASON_FILLED, CLOB_EVENT_REMOVE_REASON_USER, CLOB_EVENT_SEAT_ASSIGNED, CLOB_EVENT_SIDE_BUY, CLOB_EVENT_SIDE_SELL, CLOB_EVENT_TOKEN_DEPOSIT, CLOB_EVENT_TOKEN_SIDE_BASE, CLOB_EVENT_TOKEN_SIDE_QUOTE, CLOB_EVENT_TOKEN_WITHDRAW, CLOB_INSTRUCTION_CREATE_ORDER_ENTRY, CLOB_INSTRUCTION_CREATE_SEATLESS_ORDER_ENTRY, CLOB_INSTRUCTION_MARKET_CREATE, CLOB_INSTRUCTION_MARKET_RECORD, CLOB_INSTRUCTION_MARKET_SET_STATUS, CLOB_INSTRUCTION_MODIFY_ORDER_ENTRY, CLOB_INSTRUCTION_SEAT_CREATE, CLOB_INSTRUCTION_TOKEN_DEPOSIT, CLOB_INSTRUCTION_TOKEN_WITHDRAW, CLOB_MARKET_ACCOUNT_SIZE, CLOB_MODIFY_FLAG_FAIL_IF_OUT_OF_RANGE, CLOB_MODIFY_FLAG_HAS_CLIENT_ID, CLOB_MODIFY_FLAG_HAS_ORDER_ID, CLOB_NULL_INDEX, CLOB_ORDER_ENTRY_SIZE, CLOB_ORDER_FLAG_BUY, CLOB_ORDER_FLAG_HAS_CLIENT_ID, CLOB_ORDER_TYPE_ALO, CLOB_ORDER_TYPE_FOK, CLOB_ORDER_TYPE_GTC, CLOB_ORDER_TYPE_IOC, CLOB_ORDER_TYPE_MTL, CLOB_SEATLESS_SEAT_IDX, CLOB_SEAT_ENTRY_SIZE, CLOB_STATUS_FLAG_DEPOSITS_FROZEN, CLOB_STATUS_FLAG_PAUSED, CLOB_STATUS_FLAG_POST_ONLY, CLOB_STATUS_FLAG_WITHDRAWALS_FROZEN, CbookAccount, CbookHeader, CbookHeaderBuilder, CbookLevel, CbookLevelBuilder, ClientId, type ClobArenaHeader, type ClobArenaSlot, type ClobCbook, type ClobCbookLevel, ClobError, ClobErrorBuilder, ClobEvent, ClobEventBuilder, ClobInstruction, ClobInstructionBuilder, type ClobMarket, type ClobOrderBookLevel, type ClobOrderBookOrder, type ClobOrderBookSnapshot, type ClobOrderEntry, type ClobOrderRemovalReason, type ClobOrderSide, type ClobOrderType, ClobProgramAccount, ClobProgramAccountBuilder, type ClobSeatEntry, type ClobTokenSide, type CreateOrderArgs, CreateOrderEntryInstruction, CreateOrderEntryInstructionBuilder, type CreateSeatlessOrderArgs, CreateSeatlessOrderEntryInstruction, CreateSeatlessOrderEntryInstructionBuilder, type InstructionData, MarketAccountBuilder, MarketAccount as MarketAccountView, type MarketCreateArgs, MarketCreateInstruction, MarketCreateInstructionBuilder, MarketCreatedEvent, MarketCreatedEventBuilder, type MarketRecordArgs, MarketRecordInstruction, MarketRecordInstructionBuilder, type MarketSetStatusArgs, MarketSetStatusInstruction, MarketSetStatusInstructionBuilder, type ModifyOrderArgs, ModifyOrderEntryInstruction, ModifyOrderEntryInstructionBuilder, OrderArenaAccount, OrderCancelledEvent, OrderCancelledEventBuilder, OrderEntryBuilder, OrderEntryRemovedEvent, OrderEntryRemovedEventBuilder, OrderEntry as OrderEntryView, OrderFilledEvent, OrderFilledEventBuilder, OrderModifiedEvent, OrderModifiedEventBuilder, OrderPostedEvent, OrderPostedEventBuilder, type ParsedClobEvent, type ParsedClobEventBase, SeatArenaAccount, SeatAssignedEvent, SeatAssignedEventBuilder, type SeatCreateArgs, SeatCreateInstruction, SeatCreateInstructionBuilder, SeatEntryBuilder, SeatEntry as SeatEntryView, TokenBalanceEvent, TokenBalanceEventBuilder, type TokenTransferArgs, TokenTransferInstruction, TokenTransferInstructionBuilder, buildOrderBookSnapshot, createMarketCreateInstruction, createMarketRecordInstruction, createMarketSetStatusInstruction, createModifyOrderEntryInstruction, createOrderEntryInstruction, createSeatCreateInstruction, createSeatlessOrderEntryInstruction, createTokenDepositInstruction, createTokenWithdrawInstruction, encodeOrderFlags, parseCbookAccount, parseClobEvent, parseClobProgramAccount, parseMarketAccount, parseOrderArenaAccount, parseSeatArenaAccount };
3103
+ export { type AccountLookupContext, ArenaHeader, ArenaHeaderBuilder, type BuildClobExchangeDepositArgs, type BuildClobExchangeWithdrawalArgs, type BuildClobFundedOrderArgs, CLOB_ARENA_HEADER_SIZE, CLOB_CBOOK_EMPTY_PRICE_IN_TICKS, CLOB_CBOOK_HEADER_SIZE, CLOB_CBOOK_LEVEL_SIZE, CLOB_CBOOK_MAX_PRICE_IN_TICKS, CLOB_CBOOK_MAX_SIZE, CLOB_CLIENT_ID_SIZE, CLOB_EVENT_MARKET_CREATED, CLOB_EVENT_MARKET_STATUS, CLOB_EVENT_ORDER_CANCELLED, CLOB_EVENT_ORDER_ENTRY_REMOVED, CLOB_EVENT_ORDER_FILLED, CLOB_EVENT_ORDER_MODIFIED, CLOB_EVENT_ORDER_POSTED, CLOB_EVENT_REMOVE_REASON_EVICTED, CLOB_EVENT_REMOVE_REASON_EXPIRED, CLOB_EVENT_REMOVE_REASON_FILLED, CLOB_EVENT_REMOVE_REASON_USER, CLOB_EVENT_SEAT_ASSIGNED, CLOB_EVENT_SIDE_BUY, CLOB_EVENT_SIDE_SELL, CLOB_EVENT_TOKEN_DEPOSIT, CLOB_EVENT_TOKEN_SIDE_BASE, CLOB_EVENT_TOKEN_SIDE_QUOTE, CLOB_EVENT_TOKEN_WITHDRAW, CLOB_INSTRUCTION_CREATE_ORDER_ENTRY, CLOB_INSTRUCTION_CREATE_SEATLESS_ORDER_ENTRY, CLOB_INSTRUCTION_MARKET_CREATE, CLOB_INSTRUCTION_MARKET_RECORD, CLOB_INSTRUCTION_MARKET_SET_STATUS, CLOB_INSTRUCTION_MODIFY_ORDER_ENTRY, CLOB_INSTRUCTION_SEAT_CREATE, CLOB_INSTRUCTION_TOKEN_DEPOSIT, CLOB_INSTRUCTION_TOKEN_WITHDRAW, CLOB_MARKET_ACCOUNT_SIZE, CLOB_MAX_ATOMIC_FUNDING_SOURCES, CLOB_MODIFY_FLAG_FAIL_IF_OUT_OF_RANGE, CLOB_MODIFY_FLAG_HAS_CLIENT_ID, CLOB_MODIFY_FLAG_HAS_ORDER_ID, CLOB_NULL_INDEX, CLOB_ORDER_ENTRY_SIZE, CLOB_ORDER_FLAG_BUY, CLOB_ORDER_FLAG_HAS_CLIENT_ID, CLOB_ORDER_TYPE_ALO, CLOB_ORDER_TYPE_FOK, CLOB_ORDER_TYPE_GTC, CLOB_ORDER_TYPE_IOC, CLOB_ORDER_TYPE_MTL, CLOB_SEATLESS_SEAT_IDX, CLOB_SEAT_ENTRY_SIZE, CLOB_STATUS_FLAG_DEPOSITS_FROZEN, CLOB_STATUS_FLAG_PAUSED, CLOB_STATUS_FLAG_POST_ONLY, CLOB_STATUS_FLAG_WITHDRAWALS_FROZEN, CbookAccount, CbookHeader, CbookHeaderBuilder, CbookLevel, CbookLevelBuilder, ClientId, type ClobArenaHeader, type ClobArenaSlot, type ClobAssetBalanceAllocation, type ClobCbook, type ClobCbookLevel, ClobError, ClobErrorBuilder, ClobEvent, ClobEventBuilder, type ClobExchangeAssetBalance, ClobExchangeError, type ClobExchangeErrorCode, type ClobFundingSource, ClobInstruction, ClobInstructionBuilder, type ClobInstructionPlan, type ClobInstructionPlanReview, type ClobMarket, type ClobOrderBookLevel, type ClobOrderBookOrder, type ClobOrderBookSnapshot, type ClobOrderEntry, type ClobOrderFundingPlan, type ClobOrderRemovalReason, type ClobOrderSide, type ClobOrderType, ClobProgramAccount, ClobProgramAccountBuilder, type ClobSeatEntry, type ClobTokenAccountInitialization, type ClobTokenSide, type ClobTradingMarket, type ClobTransactionPlan, type CreateOrderArgs, CreateOrderEntryInstruction, CreateOrderEntryInstructionBuilder, type CreateSeatlessOrderArgs, CreateSeatlessOrderEntryInstruction, CreateSeatlessOrderEntryInstructionBuilder, type InstructionData, MarketAccountBuilder, MarketAccount as MarketAccountView, type MarketCreateArgs, MarketCreateInstruction, MarketCreateInstructionBuilder, MarketCreatedEvent, MarketCreatedEventBuilder, type MarketRecordArgs, MarketRecordInstruction, MarketRecordInstructionBuilder, type MarketSetStatusArgs, MarketSetStatusInstruction, MarketSetStatusInstructionBuilder, type ModifyOrderArgs, ModifyOrderEntryInstruction, ModifyOrderEntryInstructionBuilder, OrderArenaAccount, OrderCancelledEvent, OrderCancelledEventBuilder, OrderEntryBuilder, OrderEntryRemovedEvent, OrderEntryRemovedEventBuilder, OrderEntry as OrderEntryView, OrderFilledEvent, OrderFilledEventBuilder, OrderModifiedEvent, OrderModifiedEventBuilder, OrderPostedEvent, OrderPostedEventBuilder, type ParsedClobEvent, type ParsedClobEventBase, type PlanClobOrderFundingArgs, SeatArenaAccount, SeatAssignedEvent, SeatAssignedEventBuilder, type SeatCreateArgs, SeatCreateInstruction, SeatCreateInstructionBuilder, SeatEntryBuilder, SeatEntry as SeatEntryView, TokenBalanceEvent, TokenBalanceEventBuilder, type TokenTransferArgs, TokenTransferInstruction, TokenTransferInstructionBuilder, type WrapClobPlanWithTokenAccountInitializationArgs, aggregateClobExchangeBalances, assertClobActiveSeatIndex, buildClobExchangeDepositInstructionPlan, buildClobExchangeWithdrawalInstructionPlan, buildClobFundedOrderInstructionPlan, buildOrderBookSnapshot, calculateClobOrderFundingAmount, concatClobInstructions, createMarketCreateInstruction, createMarketRecordInstruction, createMarketSetStatusInstruction, createModifyOrderEntryInstruction, createOrderEntryInstruction, createSeatCreateInstruction, createSeatlessOrderEntryInstruction, createTokenDepositInstruction, createTokenWithdrawInstruction, encodeOrderFlags, parseCbookAccount, parseClobEvent, parseClobProgramAccount, parseMarketAccount, parseOrderArenaAccount, parseSeatArenaAccount, planClobOrderFunding, validateClobOrderFundingPlanSeats, wrapClobPlanWithTokenAccountInitialization };