@thru/programs 0.3.2 → 0.3.4

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.
@@ -1,4 +1,5 @@
1
1
  import { Account } from '@thru/sdk';
2
+ import { Thru } from '@thru/sdk/client';
2
3
 
3
4
  type __TnValidateResult$1 = {
4
5
  ok: boolean;
@@ -2755,6 +2756,123 @@ declare function buildClobFundedOrderInstructionPlan(args: BuildClobFundedOrderA
2755
2756
  declare function concatClobInstructions(...instructions: InstructionData[]): InstructionData;
2756
2757
  declare function wrapClobPlanWithTokenAccountInitialization(args: WrapClobPlanWithTokenAccountInitializationArgs): ClobTransactionPlan;
2757
2758
 
2759
+ interface ClobExchangeDataSource {
2760
+ getMarkets(): Promise<ClobMarketDiscovery>;
2761
+ getAssetAllocations(authority: string): Promise<ClobAssetBalanceAllocation[]>;
2762
+ }
2763
+ interface ClobUnavailableMarket {
2764
+ market: string;
2765
+ baseMint: string | null;
2766
+ quoteMint: string | null;
2767
+ reason: string;
2768
+ }
2769
+ interface ClobMarketDiscovery {
2770
+ markets: ClobTradingMarket[];
2771
+ unavailableMarkets: ClobUnavailableMarket[];
2772
+ }
2773
+ interface ClobWalletTokenAccountSnapshot {
2774
+ tokenAccount: string;
2775
+ amount: bigint;
2776
+ exists: boolean;
2777
+ }
2778
+ interface ClobExchangeAssetSnapshot {
2779
+ mint: string;
2780
+ tokenProgram: string;
2781
+ symbol: string | null;
2782
+ discoveryComplete: boolean;
2783
+ exchange: {
2784
+ freeAmount: bigint;
2785
+ transferableAmount: bigint;
2786
+ allocations: ClobAssetBalanceAllocation[];
2787
+ };
2788
+ wallet: ClobWalletTokenAccountSnapshot;
2789
+ }
2790
+ interface ClobExchangeAccountSnapshot {
2791
+ authority: string;
2792
+ assets: ClobExchangeAssetSnapshot[];
2793
+ unavailableMarkets: ClobUnavailableMarket[];
2794
+ }
2795
+ interface ClobBalanceEffect {
2796
+ location: 'wallet' | 'exchange';
2797
+ mint: string;
2798
+ tokenProgram: string;
2799
+ delta: bigint;
2800
+ market?: string;
2801
+ }
2802
+ interface ClobPreparedOperation {
2803
+ plan: ClobTransactionPlan;
2804
+ effects: ClobBalanceEffect[];
2805
+ }
2806
+ interface ClobPreparedDeposit extends ClobPreparedOperation {
2807
+ market: ClobTradingMarket;
2808
+ tokenSide: ClobTokenSide;
2809
+ seatIndex: number | null;
2810
+ walletTokenAccount: ClobWalletTokenAccountSnapshot;
2811
+ }
2812
+ interface ClobPreparedWithdrawal extends ClobPreparedOperation {
2813
+ market: ClobTradingMarket;
2814
+ tokenSide: ClobTokenSide;
2815
+ seatIndex: number;
2816
+ walletTokenAccount: ClobWalletTokenAccountSnapshot;
2817
+ }
2818
+ interface ClobPreparedOrder extends ClobPreparedOperation {
2819
+ market: ClobTradingMarket;
2820
+ funding: ClobOrderFundingPlan;
2821
+ sourceMarkets: ClobTradingMarket[];
2822
+ walletTokenAccount: ClobWalletTokenAccountSnapshot;
2823
+ }
2824
+ type ClobExchangeClientErrorCode = 'data_source_unavailable' | 'incomplete_market_metadata' | 'asset_not_found' | 'ambiguous_asset' | 'invalid_amount' | 'insufficient_wallet_balance' | 'insufficient_exchange_balance' | 'fragmented_balance' | 'invalid_token_account';
2825
+ declare class ClobExchangeClientError extends Error {
2826
+ readonly code: ClobExchangeClientErrorCode;
2827
+ readonly details?: Readonly<Record<string, string>>;
2828
+ constructor(code: ClobExchangeClientErrorCode, message: string, details?: Readonly<Record<string, string>>);
2829
+ }
2830
+ interface CreateClobExchangeClientArgs {
2831
+ thruClient: Thru;
2832
+ dataSource: ClobExchangeDataSource;
2833
+ tokenProgramAddress: string;
2834
+ clobProgramAddress?: string;
2835
+ }
2836
+ interface PrepareClobDepositArgs {
2837
+ authority: string;
2838
+ mint: string;
2839
+ amount: bigint;
2840
+ }
2841
+ interface PrepareClobWithdrawalArgs extends PrepareClobDepositArgs {
2842
+ }
2843
+ interface PrepareClobOrderArgs {
2844
+ authority: string;
2845
+ market: string | ClobTradingMarket;
2846
+ side: ClobOrderSide;
2847
+ orderType?: ClobOrderType;
2848
+ price: bigint;
2849
+ quantity: bigint;
2850
+ expirationTime?: bigint;
2851
+ clientId?: Uint8Array;
2852
+ discardAfterMatch?: boolean;
2853
+ failIfOutsideBook?: boolean;
2854
+ targetSeatIndex?: number;
2855
+ }
2856
+ interface ClobWithdrawalCapacity {
2857
+ mint: string;
2858
+ tokenProgram: string;
2859
+ total: bigint;
2860
+ maximumSingleAllocation: bigint;
2861
+ }
2862
+ interface ClobExchangeClient {
2863
+ getAccountSnapshot(args: {
2864
+ authority: string;
2865
+ }): Promise<ClobExchangeAccountSnapshot>;
2866
+ getWithdrawalCapacity(args: {
2867
+ authority: string;
2868
+ mint: string;
2869
+ }): Promise<ClobWithdrawalCapacity>;
2870
+ prepareDeposit(args: PrepareClobDepositArgs): Promise<ClobPreparedDeposit>;
2871
+ prepareWithdrawal(args: PrepareClobWithdrawalArgs): Promise<ClobPreparedWithdrawal>;
2872
+ prepareOrder(args: PrepareClobOrderArgs): Promise<ClobPreparedOrder>;
2873
+ }
2874
+ declare function createClobExchangeClient(args: CreateClobExchangeClientArgs): ClobExchangeClient;
2875
+
2758
2876
  declare const CLOB_INSTRUCTION_MARKET_RECORD = 0;
2759
2877
  declare const CLOB_INSTRUCTION_SEAT_CREATE = 1;
2760
2878
  declare const CLOB_INSTRUCTION_TOKEN_DEPOSIT = 2;
@@ -3101,4 +3219,4 @@ declare function encodeOrderFlags(args: {
3101
3219
  }): number;
3102
3220
  declare function assertClobActiveSeatIndex(value: number, label?: string): number;
3103
3221
 
3104
- 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_PROGRAM_ADDRESS, 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 };
3222
+ 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_PROGRAM_ADDRESS, 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 ClobBalanceEffect, type ClobCbook, type ClobCbookLevel, ClobError, ClobErrorBuilder, ClobEvent, ClobEventBuilder, type ClobExchangeAccountSnapshot, type ClobExchangeAssetBalance, type ClobExchangeAssetSnapshot, type ClobExchangeClient, ClobExchangeClientError, type ClobExchangeClientErrorCode, type ClobExchangeDataSource, ClobExchangeError, type ClobExchangeErrorCode, type ClobFundingSource, ClobInstruction, ClobInstructionBuilder, type ClobInstructionPlan, type ClobInstructionPlanReview, type ClobMarket, type ClobMarketDiscovery, type ClobOrderBookLevel, type ClobOrderBookOrder, type ClobOrderBookSnapshot, type ClobOrderEntry, type ClobOrderFundingPlan, type ClobOrderRemovalReason, type ClobOrderSide, type ClobOrderType, type ClobPreparedDeposit, type ClobPreparedOperation, type ClobPreparedOrder, type ClobPreparedWithdrawal, ClobProgramAccount, ClobProgramAccountBuilder, type ClobSeatEntry, type ClobTokenAccountInitialization, type ClobTokenSide, type ClobTradingMarket, type ClobTransactionPlan, type ClobUnavailableMarket, type ClobWalletTokenAccountSnapshot, type ClobWithdrawalCapacity, type CreateClobExchangeClientArgs, 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, type PrepareClobDepositArgs, type PrepareClobOrderArgs, type PrepareClobWithdrawalArgs, 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, createClobExchangeClient, createMarketCreateInstruction, createMarketRecordInstruction, createMarketSetStatusInstruction, createModifyOrderEntryInstruction, createOrderEntryInstruction, createSeatCreateInstruction, createSeatlessOrderEntryInstruction, createTokenDepositInstruction, createTokenWithdrawInstruction, encodeOrderFlags, parseCbookAccount, parseClobEvent, parseClobProgramAccount, parseMarketAccount, parseOrderArenaAccount, parseSeatArenaAccount, planClobOrderFunding, validateClobOrderFundingPlanSeats, wrapClobPlanWithTokenAccountInitialization };
@@ -1,4 +1,5 @@
1
1
  import { Account } from '@thru/sdk';
2
+ import { Thru } from '@thru/sdk/client';
2
3
 
3
4
  type __TnValidateResult$1 = {
4
5
  ok: boolean;
@@ -2755,6 +2756,123 @@ declare function buildClobFundedOrderInstructionPlan(args: BuildClobFundedOrderA
2755
2756
  declare function concatClobInstructions(...instructions: InstructionData[]): InstructionData;
2756
2757
  declare function wrapClobPlanWithTokenAccountInitialization(args: WrapClobPlanWithTokenAccountInitializationArgs): ClobTransactionPlan;
2757
2758
 
2759
+ interface ClobExchangeDataSource {
2760
+ getMarkets(): Promise<ClobMarketDiscovery>;
2761
+ getAssetAllocations(authority: string): Promise<ClobAssetBalanceAllocation[]>;
2762
+ }
2763
+ interface ClobUnavailableMarket {
2764
+ market: string;
2765
+ baseMint: string | null;
2766
+ quoteMint: string | null;
2767
+ reason: string;
2768
+ }
2769
+ interface ClobMarketDiscovery {
2770
+ markets: ClobTradingMarket[];
2771
+ unavailableMarkets: ClobUnavailableMarket[];
2772
+ }
2773
+ interface ClobWalletTokenAccountSnapshot {
2774
+ tokenAccount: string;
2775
+ amount: bigint;
2776
+ exists: boolean;
2777
+ }
2778
+ interface ClobExchangeAssetSnapshot {
2779
+ mint: string;
2780
+ tokenProgram: string;
2781
+ symbol: string | null;
2782
+ discoveryComplete: boolean;
2783
+ exchange: {
2784
+ freeAmount: bigint;
2785
+ transferableAmount: bigint;
2786
+ allocations: ClobAssetBalanceAllocation[];
2787
+ };
2788
+ wallet: ClobWalletTokenAccountSnapshot;
2789
+ }
2790
+ interface ClobExchangeAccountSnapshot {
2791
+ authority: string;
2792
+ assets: ClobExchangeAssetSnapshot[];
2793
+ unavailableMarkets: ClobUnavailableMarket[];
2794
+ }
2795
+ interface ClobBalanceEffect {
2796
+ location: 'wallet' | 'exchange';
2797
+ mint: string;
2798
+ tokenProgram: string;
2799
+ delta: bigint;
2800
+ market?: string;
2801
+ }
2802
+ interface ClobPreparedOperation {
2803
+ plan: ClobTransactionPlan;
2804
+ effects: ClobBalanceEffect[];
2805
+ }
2806
+ interface ClobPreparedDeposit extends ClobPreparedOperation {
2807
+ market: ClobTradingMarket;
2808
+ tokenSide: ClobTokenSide;
2809
+ seatIndex: number | null;
2810
+ walletTokenAccount: ClobWalletTokenAccountSnapshot;
2811
+ }
2812
+ interface ClobPreparedWithdrawal extends ClobPreparedOperation {
2813
+ market: ClobTradingMarket;
2814
+ tokenSide: ClobTokenSide;
2815
+ seatIndex: number;
2816
+ walletTokenAccount: ClobWalletTokenAccountSnapshot;
2817
+ }
2818
+ interface ClobPreparedOrder extends ClobPreparedOperation {
2819
+ market: ClobTradingMarket;
2820
+ funding: ClobOrderFundingPlan;
2821
+ sourceMarkets: ClobTradingMarket[];
2822
+ walletTokenAccount: ClobWalletTokenAccountSnapshot;
2823
+ }
2824
+ type ClobExchangeClientErrorCode = 'data_source_unavailable' | 'incomplete_market_metadata' | 'asset_not_found' | 'ambiguous_asset' | 'invalid_amount' | 'insufficient_wallet_balance' | 'insufficient_exchange_balance' | 'fragmented_balance' | 'invalid_token_account';
2825
+ declare class ClobExchangeClientError extends Error {
2826
+ readonly code: ClobExchangeClientErrorCode;
2827
+ readonly details?: Readonly<Record<string, string>>;
2828
+ constructor(code: ClobExchangeClientErrorCode, message: string, details?: Readonly<Record<string, string>>);
2829
+ }
2830
+ interface CreateClobExchangeClientArgs {
2831
+ thruClient: Thru;
2832
+ dataSource: ClobExchangeDataSource;
2833
+ tokenProgramAddress: string;
2834
+ clobProgramAddress?: string;
2835
+ }
2836
+ interface PrepareClobDepositArgs {
2837
+ authority: string;
2838
+ mint: string;
2839
+ amount: bigint;
2840
+ }
2841
+ interface PrepareClobWithdrawalArgs extends PrepareClobDepositArgs {
2842
+ }
2843
+ interface PrepareClobOrderArgs {
2844
+ authority: string;
2845
+ market: string | ClobTradingMarket;
2846
+ side: ClobOrderSide;
2847
+ orderType?: ClobOrderType;
2848
+ price: bigint;
2849
+ quantity: bigint;
2850
+ expirationTime?: bigint;
2851
+ clientId?: Uint8Array;
2852
+ discardAfterMatch?: boolean;
2853
+ failIfOutsideBook?: boolean;
2854
+ targetSeatIndex?: number;
2855
+ }
2856
+ interface ClobWithdrawalCapacity {
2857
+ mint: string;
2858
+ tokenProgram: string;
2859
+ total: bigint;
2860
+ maximumSingleAllocation: bigint;
2861
+ }
2862
+ interface ClobExchangeClient {
2863
+ getAccountSnapshot(args: {
2864
+ authority: string;
2865
+ }): Promise<ClobExchangeAccountSnapshot>;
2866
+ getWithdrawalCapacity(args: {
2867
+ authority: string;
2868
+ mint: string;
2869
+ }): Promise<ClobWithdrawalCapacity>;
2870
+ prepareDeposit(args: PrepareClobDepositArgs): Promise<ClobPreparedDeposit>;
2871
+ prepareWithdrawal(args: PrepareClobWithdrawalArgs): Promise<ClobPreparedWithdrawal>;
2872
+ prepareOrder(args: PrepareClobOrderArgs): Promise<ClobPreparedOrder>;
2873
+ }
2874
+ declare function createClobExchangeClient(args: CreateClobExchangeClientArgs): ClobExchangeClient;
2875
+
2758
2876
  declare const CLOB_INSTRUCTION_MARKET_RECORD = 0;
2759
2877
  declare const CLOB_INSTRUCTION_SEAT_CREATE = 1;
2760
2878
  declare const CLOB_INSTRUCTION_TOKEN_DEPOSIT = 2;
@@ -3101,4 +3219,4 @@ declare function encodeOrderFlags(args: {
3101
3219
  }): number;
3102
3220
  declare function assertClobActiveSeatIndex(value: number, label?: string): number;
3103
3221
 
3104
- 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_PROGRAM_ADDRESS, 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 };
3222
+ 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_PROGRAM_ADDRESS, 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 ClobBalanceEffect, type ClobCbook, type ClobCbookLevel, ClobError, ClobErrorBuilder, ClobEvent, ClobEventBuilder, type ClobExchangeAccountSnapshot, type ClobExchangeAssetBalance, type ClobExchangeAssetSnapshot, type ClobExchangeClient, ClobExchangeClientError, type ClobExchangeClientErrorCode, type ClobExchangeDataSource, ClobExchangeError, type ClobExchangeErrorCode, type ClobFundingSource, ClobInstruction, ClobInstructionBuilder, type ClobInstructionPlan, type ClobInstructionPlanReview, type ClobMarket, type ClobMarketDiscovery, type ClobOrderBookLevel, type ClobOrderBookOrder, type ClobOrderBookSnapshot, type ClobOrderEntry, type ClobOrderFundingPlan, type ClobOrderRemovalReason, type ClobOrderSide, type ClobOrderType, type ClobPreparedDeposit, type ClobPreparedOperation, type ClobPreparedOrder, type ClobPreparedWithdrawal, ClobProgramAccount, ClobProgramAccountBuilder, type ClobSeatEntry, type ClobTokenAccountInitialization, type ClobTokenSide, type ClobTradingMarket, type ClobTransactionPlan, type ClobUnavailableMarket, type ClobWalletTokenAccountSnapshot, type ClobWithdrawalCapacity, type CreateClobExchangeClientArgs, 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, type PrepareClobDepositArgs, type PrepareClobOrderArgs, type PrepareClobWithdrawalArgs, 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, createClobExchangeClient, createMarketCreateInstruction, createMarketRecordInstruction, createMarketSetStatusInstruction, createModifyOrderEntryInstruction, createOrderEntryInstruction, createSeatCreateInstruction, createSeatlessOrderEntryInstruction, createTokenDepositInstruction, createTokenWithdrawInstruction, encodeOrderFlags, parseCbookAccount, parseClobEvent, parseClobProgramAccount, parseMarketAccount, parseOrderArenaAccount, parseSeatArenaAccount, planClobOrderFunding, validateClobOrderFundingPlanSeats, wrapClobPlanWithTokenAccountInitialization };