@trufnetwork/sdk-js 0.5.10 → 0.6.1

package/dist/types/types/orderbook.d.ts

@@ -0,0 +1,376 @@
+/**
+ * Order Book Types for TRUF.NETWORK Prediction Markets
+ *
+ * Binary prediction markets where outcomes are YES (true) or NO (false).
+ * Prices are in cents (1-99), representing probability.
+ */
+/** Valid bridge identifiers for collateral */
+export type BridgeIdentifier = "hoodi_tt2" | "sepolia_bridge" | "ethereum_bridge";
+/** Full market information */
+export interface MarketInfo {
+    /** Unique market identifier */
+    id: number;
+    /** SHA256 hash of query components (32 bytes) */
+    hash: Uint8Array;
+    /** ABI-encoded query tuple */
+    queryComponents: Uint8Array;
+    /** Bridge used for collateral */
+    bridge: BridgeIdentifier;
+    /** Unix timestamp when market settles */
+    settleTime: number;
+    /** Whether market has been settled */
+    settled: boolean;
+    /** Winning outcome (null if not settled) */
+    winningOutcome: boolean | null;
+    /** Unix timestamp when settled (null if not settled) */
+    settledAt: number | null;
+    /** Maximum bid-ask spread allowed (1-50 cents) */
+    maxSpread: number;
+    /** Minimum order size (string for large values) */
+    minOrderSize: string;
+    /** Unix timestamp when market was created */
+    createdAt: number;
+    /** Creator's wallet address (20 bytes) */
+    creator: Uint8Array;
+}
+/** Lighter market summary for listings */
+export interface MarketSummary {
+    /** Unique market identifier */
+    id: number;
+    /** SHA256 hash of query components (32 bytes) */
+    hash: Uint8Array;
+    /** Unix timestamp when market settles */
+    settleTime: number;
+    /** Whether market has been settled */
+    settled: boolean;
+    /** Winning outcome (null if not settled) */
+    winningOutcome: boolean | null;
+    /** Maximum bid-ask spread allowed (1-50 cents) */
+    maxSpread: number;
+    /** Minimum order size (string for large values) */
+    minOrderSize: string;
+    /** Unix timestamp when market was created */
+    createdAt: number;
+}
+/** Market collateral validation result */
+export interface MarketValidation {
+    /** Whether YES/NO token counts match */
+    validTokenBinaries: boolean;
+    /** Whether vault balance matches expected collateral */
+    validCollateral: boolean;
+    /** Total YES shares (NUMERIC as string) */
+    totalTrue: string;
+    /** Total NO shares (NUMERIC as string) */
+    totalFalse: string;
+    /** Vault balance (NUMERIC as string) */
+    vaultBalance: string;
+    /** Expected collateral (NUMERIC as string) */
+    expectedCollateral: string;
+    /** Value locked in open buy orders (NUMERIC as string) */
+    openBuysValue: string;
+}
+/** Single order book entry */
+export interface OrderBookEntry {
+    /** Wallet address of order owner (20 bytes) */
+    walletAddress: Uint8Array;
+    /**
+     * Price in cents:
+     * - Negative (-99 to -1): Buy order at |price| cents
+     * - Zero (0): Holding (shares owned, not listed)
+     * - Positive (1 to 99): Sell order at price cents
+     */
+    price: number;
+    /** Number of shares */
+    amount: number;
+    /** Unix timestamp of last update (used for FIFO ordering) */
+    lastUpdated: number;
+}
+/** User's position in a market */
+export interface UserPosition {
+    /** Market identifier */
+    queryId: number;
+    /** Outcome: true=YES, false=NO */
+    outcome: boolean;
+    /**
+     * Price in cents:
+     * - Negative: Buy order
+     * - Zero: Holding
+     * - Positive: Sell order
+     */
+    price: number;
+    /** Number of shares */
+    amount: number;
+    /** Unix timestamp of last update */
+    lastUpdated: number;
+}
+/** Aggregated depth at a price level */
+export interface DepthLevel {
+    /** Price level in cents */
+    price: number;
+    /** Total shares in buy orders at this price */
+    buyVolume: number;
+    /** Total shares in sell orders at this price */
+    sellVolume: number;
+}
+/** Best bid/ask prices for a market outcome */
+export interface BestPrices {
+    /** Best bid price (null if no bids) */
+    bestBid: number | null;
+    /** Best ask price (null if no asks) */
+    bestAsk: number | null;
+    /** Spread between best ask and bid (null if either missing) */
+    spread: number | null;
+}
+/** User's locked collateral across all markets */
+export interface UserCollateral {
+    /** Total locked collateral in wei (NUMERIC(78,0) as string) */
+    totalLocked: string;
+    /** Collateral locked in buy orders (NUMERIC as string) */
+    buyOrdersLocked: string;
+    /** Value of owned shares (NUMERIC as string) */
+    sharesValue: string;
+}
+/** Fee distribution summary for a market */
+export interface DistributionSummary {
+    /** Unique distribution identifier */
+    distributionId: number;
+    /** Market identifier */
+    queryId: number;
+    /** Total fees distributed (NUMERIC as string) */
+    totalFees: string;
+    /** Unix timestamp when distributed */
+    distributedAt: number;
+}
+/** Per-LP reward detail */
+export interface LPRewardDetail {
+    /** LP's wallet address (20 bytes) */
+    walletAddress: Uint8Array;
+    /** Reward amount (NUMERIC as string) */
+    rewardAmount: string;
+    /** Share percentage of total rewards (0-100) */
+    sharePercentage: number;
+}
+/** Reward history for a participant */
+export interface RewardHistory {
+    /** Distribution identifier */
+    distributionId: number;
+    /** Market identifier */
+    queryId: number;
+    /** Reward amount (NUMERIC as string) */
+    rewardAmount: string;
+    /** Share percentage of total rewards */
+    totalRewardPercent: number;
+    /** Unix timestamp when distributed */
+    distributedAt: number;
+}
+/** Input for creating a new market */
+export interface CreateMarketInput {
+    /** Bridge identifier for collateral */
+    bridge: BridgeIdentifier;
+    /** ABI-encoded query components */
+    queryComponents: Uint8Array;
+    /** Unix timestamp for market settlement */
+    settleTime: number;
+    /** Maximum bid-ask spread (1-50 cents) */
+    maxSpread: number;
+    /** Minimum order size (use string for large values to avoid JS safe integer limits) */
+    minOrderSize: number | string;
+}
+/** Input for placing buy or sell orders */
+export interface PlaceOrderInput {
+    /** Market identifier */
+    queryId: number;
+    /** Outcome: true=YES, false=NO */
+    outcome: boolean;
+    /** Price in cents (1-99) */
+    price: number;
+    /** Number of shares */
+    amount: number;
+}
+/** Input for split limit orders (market making) */
+export interface PlaceSplitLimitOrderInput {
+    /** Market identifier */
+    queryId: number;
+    /** YES price in cents (1-99). NO price will be 100 - truePrice */
+    truePrice: number;
+    /** Number of share pairs to create */
+    amount: number;
+}
+/** Input for canceling an order */
+export interface CancelOrderInput {
+    /** Market identifier */
+    queryId: number;
+    /** Outcome: true=YES, false=NO */
+    outcome: boolean;
+    /** Price of order to cancel (cannot be 0) */
+    price: number;
+}
+/** Input for modifying a buy order */
+export interface ChangeBidInput {
+    /** Market identifier */
+    queryId: number;
+    /** Outcome: true=YES, false=NO */
+    outcome: boolean;
+    /** Current price (must be negative) */
+    oldPrice: number;
+    /** New price (must be negative) */
+    newPrice: number;
+    /** New amount */
+    newAmount: number;
+}
+/** Input for modifying a sell order */
+export interface ChangeAskInput {
+    /** Market identifier */
+    queryId: number;
+    /** Outcome: true=YES, false=NO */
+    outcome: boolean;
+    /** Current price (must be non-negative) */
+    oldPrice: number;
+    /** New price (must be non-negative) */
+    newPrice: number;
+    /** New amount */
+    newAmount: number;
+}
+/** Input for listing markets */
+export interface ListMarketsInput {
+    /**
+     * Filter by settlement status:
+     * - null/undefined: All markets
+     * - true: Unsettled markets only
+     * - false: Settled markets only
+     */
+    settledFilter?: boolean | null;
+    /** Maximum number of markets to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/** Base input for binary market creation helpers */
+export interface BaseBinaryMarketInput {
+    /** Data provider's Ethereum address */
+    dataProvider: string;
+    /** Stream ID (32 characters) */
+    streamId: string;
+    /** Unix timestamp for price/value check */
+    timestamp: number;
+    /** Block height for data snapshot */
+    frozenAt: number;
+    /** Bridge identifier for collateral */
+    bridge: BridgeIdentifier;
+    /** Unix timestamp for market settlement */
+    settleTime: number;
+    /** Maximum bid-ask spread (1-50 cents) */
+    maxSpread: number;
+    /** Minimum order size (use string for large values to avoid JS safe integer limits) */
+    minOrderSize: number | string;
+}
+/** Input for price above/below threshold markets */
+export interface CreatePriceThresholdMarketInput extends BaseBinaryMarketInput {
+    /** Price threshold (as decimal string, e.g., "50000.00") */
+    threshold: string;
+}
+/** Input for value in range markets */
+export interface CreateValueInRangeMarketInput extends BaseBinaryMarketInput {
+    /** Minimum value of range (as decimal string) */
+    minValue: string;
+    /** Maximum value of range (as decimal string) */
+    maxValue: string;
+}
+/** Input for value equals markets */
+export interface CreateValueEqualsMarketInput extends BaseBinaryMarketInput {
+    /** Target value (as decimal string) */
+    targetValue: string;
+    /** Acceptable tolerance (as decimal string) */
+    tolerance: string;
+}
+/** @internal Raw market info from database */
+export interface RawMarketInfo {
+    id: number;
+    hash: string;
+    query_components: string;
+    bridge: string;
+    settle_time: number;
+    settled: boolean;
+    winning_outcome: boolean | null;
+    settled_at: number | null;
+    max_spread: number;
+    min_order_size: string | number;
+    created_at: number;
+    creator: string;
+}
+/** @internal Raw market summary from database */
+export interface RawMarketSummary {
+    id: number;
+    hash: string;
+    settle_time: number;
+    settled: boolean;
+    winning_outcome: boolean | null;
+    max_spread: number;
+    min_order_size: string | number;
+    created_at: number;
+}
+/** @internal Raw order book entry from database */
+export interface RawOrderBookEntry {
+    wallet_address: string;
+    price: number;
+    amount: number;
+    last_updated: number;
+}
+/** @internal Raw user position from database */
+export interface RawUserPosition {
+    query_id: number;
+    outcome: boolean;
+    price: number;
+    amount: number;
+    last_updated: number;
+}
+/** @internal Raw depth level from database */
+export interface RawDepthLevel {
+    price: number | string;
+    buy_volume: number | string;
+    sell_volume: number | string;
+}
+/** @internal Raw best prices from database */
+export interface RawBestPrices {
+    best_bid: number | null;
+    best_ask: number | null;
+    spread: number | null;
+}
+/** @internal Raw user collateral from database */
+export interface RawUserCollateral {
+    total_locked: string;
+    buy_orders_locked: string;
+    shares_value: string;
+}
+/** @internal Raw market validation from database */
+export interface RawMarketValidation {
+    valid_token_binaries: boolean;
+    valid_collateral: boolean;
+    total_true: string;
+    total_false: string;
+    vault_balance: string;
+    expected_collateral: string;
+    open_buys_value: string;
+}
+/** @internal Raw distribution summary from database */
+export interface RawDistributionSummary {
+    distribution_id: number;
+    query_id: number;
+    total_fees: string;
+    distributed_at: number;
+}
+/** @internal Raw LP reward detail from database */
+export interface RawLPRewardDetail {
+    wallet_address: string;
+    reward_amount: string;
+    share_percentage: number;
+}
+/** @internal Raw reward history from database */
+export interface RawRewardHistory {
+    distribution_id: number;
+    query_id: number;
+    reward_amount: string;
+    total_reward_percent: number;
+    distributed_at: number;
+}
+//# sourceMappingURL=orderbook.d.ts.map

package/dist/types/types/orderbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderbook.d.ts","sourceRoot":"","sources":["../../../src/types/orderbook.ts"],"names":[],"mappings":"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"}

package/dist/types/util/AttestationEncoding.d.ts

@@ -5,6 +5,13 @@
  * the node's request_attestation action. It uses kwil-js's native encoding
  * to ensure perfect compatibility with kwil-db's EncodedValue.MarshalBinary() format.
  */
+/**
+ * Type hint for specifying explicit types when encoding arguments.
+ * Use Utils.DataType from kwil-js (e.g., Utils.DataType.Numeric(36, 18))
+ *
+ * DataInfo structure: { name: VarType, is_array: boolean, metadata?: number[] }
+ */
+export type TypeHint = any;
 /**
  * Encodes action arguments into canonical bytes using kwil-js utilities.
  *
@@ -13,10 +20,11 @@
  * Each encoded_arg uses kwil-db's EncodedValue.MarshalBinary() format.
  *
  * @param args - Array of arguments to encode
+ * @param types - Optional map of argument index to type hint (for NUMERIC, etc.)
  * @returns Encoded bytes
  * @throws Error if any argument cannot be encoded
  */
-export declare function encodeActionArgs(args: any[]): Uint8Array;
+export declare function encodeActionArgs(args: any[], types?: Record<number, TypeHint>): Uint8Array;
 /**
  * Reads a uint32 value in little-endian format
  *

package/dist/types/util/AttestationEncoding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttestationEncoding.d.ts","sourceRoot":"","sources":["../../../src/util/AttestationEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,UAAU,CA2CxD;AAiBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,GAAG,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AA+CD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,MAAU,GACjB;IAAE,KAAK,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAuChD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,GAAG,CAkClE;AA4CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAsDzE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAqClE;AA8BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,UAAU,GAAG,wBAAwB,CA6IrF"}
+{"version":3,"file":"AttestationEncoding.d.ts","sourceRoot":"","sources":["../../../src/util/AttestationEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,UAAU,CA6C1F;AAiBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,GAAG,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AA+CD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,MAAU,GACjB;IAAE,KAAK,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAuChD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,GAAG,CAkClE;AA4CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAsDzE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAqClE;AA8BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,UAAU,GAAG,wBAAwB,CA6IrF"}

package/dist/types/util/orderbookHelpers.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Order Book Helper Utilities
+ *
+ * Provides encoding functions for query components and byte conversion utilities.
+ */
+/**
+ * Encodes action arguments for order book queries using Kwil's native encoding.
+ *
+ * @param dataProvider - Data provider's Ethereum address
+ * @param streamId - Stream ID (32 characters)
+ * @param timestamp - Unix timestamp for price/value check
+ * @param threshold - Threshold value (as decimal string, e.g., "50000.00")
+ * @param frozenAt - Block height for data snapshot (0 for latest)
+ * @returns Kwil-encoded bytes compatible with call_dispatch
+ *
+ * @example
+ * ```typescript
+ * const args = encodeActionArgs(
+ *   "0x1234567890abcdef1234567890abcdef12345678",
+ *   "my_stream_id____________________", // 32 chars
+ *   1700000000,
+ *   "50000.00",
+ *   0
+ * );
+ * ```
+ */
+export declare function encodeActionArgs(dataProvider: string, streamId: string, timestamp: number, threshold: string, frozenAt: number): Uint8Array;
+/**
+ * Encodes action arguments for range-based markets using Kwil's native encoding.
+ *
+ * @param dataProvider - Data provider's Ethereum address
+ * @param streamId - Stream ID
+ * @param timestamp - Unix timestamp
+ * @param minValue - Minimum value of range
+ * @param maxValue - Maximum value of range
+ * @param frozenAt - Block height (0 for latest)
+ * @returns Kwil-encoded bytes compatible with call_dispatch
+ */
+export declare function encodeRangeActionArgs(dataProvider: string, streamId: string, timestamp: number, minValue: string, maxValue: string, frozenAt: number): Uint8Array;
+/**
+ * Encodes action arguments for value equals markets using Kwil's native encoding.
+ *
+ * @param dataProvider - Data provider's Ethereum address
+ * @param streamId - Stream ID
+ * @param timestamp - Unix timestamp
+ * @param targetValue - Target value
+ * @param tolerance - Acceptable tolerance
+ * @param frozenAt - Block height (0 for latest)
+ * @returns Kwil-encoded bytes compatible with call_dispatch
+ */
+export declare function encodeEqualsActionArgs(dataProvider: string, streamId: string, timestamp: number, targetValue: string, tolerance: string, frozenAt: number): Uint8Array;
+/**
+ * Encodes full query components for market creation.
+ *
+ * The query components are ABI-encoded as a tuple:
+ * (address dataProvider, bytes32 streamId, string actionId, bytes args)
+ *
+ * @param dataProvider - Data provider's Ethereum address
+ * @param streamId - Stream ID (will be padded to 32 bytes)
+ * @param actionId - Action identifier (e.g., "price_above_threshold")
+ * @param args - Pre-encoded action arguments from encodeActionArgs()
+ * @returns ABI-encoded query components
+ *
+ * @example
+ * ```typescript
+ * const args = encodeActionArgs(...);
+ * const queryComponents = encodeQueryComponents(
+ *   "0x1234567890abcdef1234567890abcdef12345678",
+ *   "my_stream_id____________________",
+ *   "price_above_threshold",
+ *   args
+ * );
+ * ```
+ */
+export declare function encodeQueryComponents(dataProvider: string, streamId: string, actionId: string, args: Uint8Array): Uint8Array;
+/**
+ * Converts a string to bytes32, padding with zeros if needed.
+ *
+ * @param str - String to convert (max 32 characters)
+ * @returns bytes32 as hex string
+ */
+export declare function stringToBytes32(str: string): string;
+/**
+ * Converts a hex string to Uint8Array.
+ *
+ * @param hex - Hex string (with or without 0x prefix)
+ * @returns Uint8Array
+ *
+ * @example
+ * ```typescript
+ * const bytes = hexToBytes("0x1234abcd");
+ * const bytes2 = hexToBytes("1234abcd");
+ * ```
+ */
+export declare function hexToBytes(hex: string): Uint8Array;
+/**
+ * Converts a database bytes value (hex or base64) to Uint8Array.
+ * kwil-js may return BYTEA as hex or base64 depending on version/context.
+ *
+ * @param value - Hex string, base64 string, or Uint8Array
+ * @returns Uint8Array
+ */
+export declare function dbBytesToUint8Array(value: string | Uint8Array): Uint8Array;
+/**
+ * Converts a Uint8Array to hex string with 0x prefix.
+ *
+ * @param bytes - Uint8Array to convert
+ * @returns Hex string with 0x prefix
+ *
+ * @example
+ * ```typescript
+ * const hex = bytesToHex(new Uint8Array([0x12, 0x34]));
+ * // Returns "0x1234"
+ * ```
+ */
+export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Validates a price value for order operations.
+ *
+ * @param price - Price to validate (1-99)
+ * @param operation - Operation name for error message
+ * @throws Error if price is invalid
+ */
+export declare function validatePrice(price: number, operation: string): void;
+/**
+ * Validates an amount value for order operations.
+ *
+ * @param amount - Amount to validate (must be positive)
+ * @param operation - Operation name for error message
+ * @throws Error if amount is invalid
+ */
+export declare function validateAmount(amount: number, operation: string): void;
+/**
+ * Validates a bridge identifier.
+ *
+ * @param bridge - Bridge identifier to validate
+ * @throws Error if bridge is invalid
+ */
+export declare function validateBridge(bridge: string): void;
+/**
+ * Validates max spread for market creation.
+ *
+ * @param maxSpread - Max spread to validate (1-50)
+ * @throws Error if maxSpread is invalid
+ */
+export declare function validateMaxSpread(maxSpread: number): void;
+/**
+ * Validates settle time for market creation.
+ *
+ * @param settleTime - Unix timestamp to validate (must be in future)
+ * @throws Error if settleTime is invalid
+ */
+export declare function validateSettleTime(settleTime: number): void;
+/**
+ * Converts settled filter boolean to the value for Kuneiform.
+ *
+ * @param filter - Boolean filter (null/undefined=all, true=unsettled, false=settled)
+ * @returns Boolean or null (null=all, true/false=filter by settled status)
+ */
+export declare function settledFilterToBoolean(filter: boolean | null | undefined): boolean | null;
+//# sourceMappingURL=orderbookHelpers.d.ts.map

package/dist/types/util/orderbookHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderbookHelpers.d.ts","sourceRoot":"","sources":["../../../src/util/orderbookHelpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,UAAU,CAgBZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,CAiBZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,UAAU,CAiBZ;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,GACf,UAAU,CAUZ;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAGlD;AAuCD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,UAAU,GACzB,UAAU,CAaZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAUtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAK3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GACjC,OAAO,GAAG,IAAI,CAKhB"}

package/dist/types/util/orderbookHelpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orderbookHelpers.test.d.ts.map

package/dist/types/util/orderbookHelpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderbookHelpers.test.d.ts","sourceRoot":"","sources":["../../../src/util/orderbookHelpers.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trufnetwork/sdk-js",
-  "version": "0.5.10",
+  "version": "0.6.1",
   "description": "TRUF.NETWORK SDK for JavaScript/TypeScript",
   "type": "module",
   "keywords": [