@lightconexyz/lightcone-sdk 0.1.0

package/dist/program/types.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderSide = exports.MarketStatus = void 0;
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Market status enum matching on-chain representation
+ */
+var MarketStatus;
+(function (MarketStatus) {
+    MarketStatus[MarketStatus["Pending"] = 0] = "Pending";
+    MarketStatus[MarketStatus["Active"] = 1] = "Active";
+    MarketStatus[MarketStatus["Resolved"] = 2] = "Resolved";
+    MarketStatus[MarketStatus["Cancelled"] = 3] = "Cancelled";
+})(MarketStatus || (exports.MarketStatus = MarketStatus = {}));
+/**
+ * Order side enum
+ * BID = buyer wants base tokens (pays quote)
+ * ASK = seller offers base tokens (receives quote)
+ */
+var OrderSide;
+(function (OrderSide) {
+    OrderSide[OrderSide["BID"] = 0] = "BID";
+    OrderSide[OrderSide["ASK"] = 1] = "ASK";
+})(OrderSide || (exports.OrderSide = OrderSide = {}));
+//# sourceMappingURL=types.js.map

package/dist/program/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/program/types.ts"],"names":[],"mappings":";;;AAEA,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;GAEG;AACH,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,qDAAW,CAAA;IACX,mDAAU,CAAA;IACV,uDAAY,CAAA;IACZ,yDAAa,CAAA;AACf,CAAC,EALW,YAAY,4BAAZ,YAAY,QAKvB;AAED;;;;GAIG;AACH,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,uCAAO,CAAA;IACP,uCAAO,CAAA;AACT,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB","sourcesContent":["import { PublicKey, Transaction } from \"@solana/web3.js\";\n\n// ============================================================================\n// ENUMS\n// ============================================================================\n\n/**\n * Market status enum matching on-chain representation\n */\nexport enum MarketStatus {\n  Pending = 0,\n  Active = 1,\n  Resolved = 2,\n  Cancelled = 3,\n}\n\n/**\n * Order side enum\n * BID = buyer wants base tokens (pays quote)\n * ASK = seller offers base tokens (receives quote)\n */\nexport enum OrderSide {\n  BID = 0,\n  ASK = 1,\n}\n\n// ============================================================================\n// ACCOUNT TYPES\n// ============================================================================\n\n/**\n * Exchange account - singleton central state\n * PDA: [\"central_state\"]\n * Size: 88 bytes\n */\nexport interface Exchange {\n  discriminator: Buffer; // 8 bytes\n  authority: PublicKey; // 32 bytes - initial admin\n  operator: PublicKey; // 32 bytes - can perform operational tasks\n  marketCount: bigint; // u64 - incremented for each market\n  paused: boolean; // u8 - 0 = active, 1 = paused\n  bump: number; // u8\n}\n\n/**\n * Market account\n * PDA: [\"market\", market_id (u64)]\n * Size: 120 bytes\n */\nexport interface Market {\n  discriminator: Buffer; // 8 bytes\n  marketId: bigint; // u64 - auto-assigned, sequential\n  numOutcomes: number; // u8 - 2-6 outcomes supported\n  status: MarketStatus; // u8\n  winningOutcome: number; // u8\n  hasWinningOutcome: boolean; // u8\n  bump: number; // u8\n  oracle: PublicKey; // 32 bytes - who can settle the market\n  questionId: Buffer; // 32 bytes\n  conditionId: Buffer; // 32 bytes - derived from oracle + questionId + numOutcomes\n}\n\n/**\n * Order status account - tracks partial fills and cancellations\n * PDA: [\"order_status\", order_hash (32 bytes)]\n * Size: 24 bytes\n */\nexport interface OrderStatus {\n  discriminator: Buffer; // 8 bytes\n  remaining: bigint; // u64 - maker_amount not yet filled\n  isCancelled: boolean; // u8\n}\n\n/**\n * User nonce account - replay protection\n * PDA: [\"user_nonce\", user_pubkey (32 bytes)]\n * Size: 16 bytes\n */\nexport interface UserNonce {\n  discriminator: Buffer; // 8 bytes\n  nonce: bigint; // u64 - incremented per order\n}\n\n/**\n * Position account - user's state in a market\n * PDA: [\"position\", owner (32 bytes), market (32 bytes)]\n * Size: 80 bytes\n */\nexport interface Position {\n  discriminator: Buffer; // 8 bytes\n  owner: PublicKey; // 32 bytes\n  market: PublicKey; // 32 bytes\n  bump: number; // u8\n}\n\n/**\n * Orderbook account - links market to token pair and lookup table\n * PDA: [\"orderbook\", mint_a (32 bytes), mint_b (32 bytes)]\n * Size: 144 bytes\n */\nexport interface Orderbook {\n  discriminator: Buffer; // 8 bytes\n  market: PublicKey; // 32 bytes\n  mintA: PublicKey; // 32 bytes\n  mintB: PublicKey; // 32 bytes\n  lookupTable: PublicKey; // 32 bytes\n  bump: number; // u8\n}\n\n// ============================================================================\n// ORDER TYPES\n// ============================================================================\n\n/**\n * Signed order format (225 bytes)\n * Full order with all fields for submission, cancellation, and hashing\n */\nexport interface SignedOrder {\n  nonce: number; // u32 - order ID + replay protection (serialized as u64 LE on wire)\n  maker: PublicKey; // 32 bytes - signer\n  market: PublicKey; // 32 bytes\n  baseMint: PublicKey; // 32 bytes - token being bought/sold\n  quoteMint: PublicKey; // 32 bytes - payment token\n  side: OrderSide; // u8 - 0=BID, 1=ASK\n  makerAmount: bigint; // u64 - what maker gives\n  takerAmount: bigint; // u64 - what maker receives\n  expiration: bigint; // i64 - unix timestamp, 0=no expiration\n  signature: Buffer; // 64 bytes - Ed25519 signature\n}\n\n/**\n * Compact order format (29 bytes)\n * Transaction-optimized version: nonce is u32, no maker field (derived on-chain from Position PDA)\n */\nexport interface Order {\n  nonce: number; // u32 (4 bytes) - truncated from SignedOrder's u64 nonce\n  side: OrderSide; // u8\n  makerAmount: bigint; // u64\n  takerAmount: bigint; // u64\n  expiration: bigint; // i64\n}\n\n// ============================================================================\n// PARAMETER TYPES\n// ============================================================================\n\n/**\n * Parameters for initialize instruction\n */\nexport interface InitializeParams {\n  authority: PublicKey;\n}\n\n/**\n * Parameters for createMarket instruction\n */\nexport interface CreateMarketParams {\n  authority: PublicKey;\n  numOutcomes: number; // 2-6\n  oracle: PublicKey;\n  questionId: Buffer; // 32 bytes\n}\n\n/**\n * Metadata for a single outcome token\n */\nexport interface OutcomeMetadata {\n  name: string;\n  symbol: string;\n  uri: string;\n}\n\n/**\n * Parameters for addDepositMint instruction\n */\nexport interface AddDepositMintParams {\n  authority: PublicKey;\n  marketId: bigint;\n  depositMint: PublicKey;\n  outcomeMetadata: OutcomeMetadata[];\n}\n\n/**\n * Parameters for mintCompleteSet instruction\n */\nexport interface MintCompleteSetParams {\n  user: PublicKey;\n  market: PublicKey;\n  depositMint: PublicKey;\n  amount: bigint;\n}\n\n/**\n * Parameters for mergeCompleteSet instruction\n */\nexport interface MergeCompleteSetParams {\n  user: PublicKey;\n  market: PublicKey;\n  depositMint: PublicKey;\n  amount: bigint;\n}\n\n/**\n * Parameters for cancelOrder instruction\n */\nexport interface CancelOrderParams {\n  maker: PublicKey;\n  order: SignedOrder;\n}\n\n/**\n * Parameters for incrementNonce instruction\n */\nexport interface IncrementNonceParams {\n  user: PublicKey;\n}\n\n/**\n * Parameters for settleMarket instruction\n */\nexport interface SettleMarketParams {\n  oracle: PublicKey;\n  marketId: bigint;\n  winningOutcome: number;\n}\n\n/**\n * Parameters for redeemWinnings instruction\n */\nexport interface RedeemWinningsParams {\n  user: PublicKey;\n  market: PublicKey;\n  depositMint: PublicKey;\n  amount: bigint;\n}\n\n/**\n * Parameters for setPaused instruction\n */\nexport interface SetPausedParams {\n  authority: PublicKey;\n  paused: boolean;\n}\n\n/**\n * Parameters for setOperator instruction\n */\nexport interface SetOperatorParams {\n  authority: PublicKey;\n  newOperator: PublicKey;\n}\n\n/**\n * Parameters for withdrawFromPosition instruction\n */\nexport interface WithdrawFromPositionParams {\n  user: PublicKey;\n  market: PublicKey;\n  mint: PublicKey; // Can be deposit mint or conditional mint\n  amount: bigint;\n  outcomeIndex: number; // u8 outcome index\n}\n\n/**\n * Parameters for activateMarket instruction\n */\nexport interface ActivateMarketParams {\n  authority: PublicKey;\n  marketId: bigint;\n}\n\n/**\n * Parameters for matchOrdersMulti instruction\n */\nexport interface MatchOrdersMultiParams {\n  operator: PublicKey;\n  market: PublicKey;\n  baseMint: PublicKey;\n  quoteMint: PublicKey;\n  takerOrder: SignedOrder;\n  makerOrders: SignedOrder[];\n  makerFillAmounts: bigint[]; // Per maker - what each maker gives\n  takerFillAmounts: bigint[]; // Per maker - what taker gives to each maker\n  fullFillBitmask: number; // u8 bitmask: bit 7 = taker, bits 0..n = makers\n}\n\n/**\n * Parameters for setAuthority instruction\n */\nexport interface SetAuthorityParams {\n  currentAuthority: PublicKey;\n  newAuthority: PublicKey;\n}\n\n/**\n * Parameters for createOrderbook instruction\n */\nexport interface CreateOrderbookParams {\n  payer: PublicKey;\n  market: PublicKey;\n  mintA: PublicKey;\n  mintB: PublicKey;\n  recentSlot: bigint;\n}\n\n// ============================================================================\n// BUILDER RESULT TYPES\n// ============================================================================\n\n/**\n * Result from transaction builders\n */\nexport interface BuildResult<T = Record<string, PublicKey>> {\n  /** Unsigned transaction ready for signing */\n  transaction: Transaction;\n  /** Key accounts involved in the transaction */\n  accounts: T;\n  /** Serialize transaction to base64 */\n  serialize: () => string;\n}\n\n/**\n * Accounts returned from initialize\n */\nexport interface InitializeAccounts {\n  exchange: PublicKey;\n}\n\n/**\n * Accounts returned from createMarket\n */\nexport interface CreateMarketAccounts {\n  exchange: PublicKey;\n  market: PublicKey;\n}\n\n/**\n * Accounts returned from addDepositMint\n */\nexport interface AddDepositMintAccounts {\n  market: PublicKey;\n  vault: PublicKey;\n  mintAuthority: PublicKey;\n  conditionalMints: PublicKey[];\n}\n\n/**\n * Accounts returned from mintCompleteSet\n */\nexport interface MintCompleteSetAccounts {\n  position: PublicKey;\n  vault: PublicKey;\n  conditionalMints: PublicKey[];\n}\n\n/**\n * Accounts returned from mergeCompleteSet\n */\nexport interface MergeCompleteSetAccounts {\n  position: PublicKey;\n  vault: PublicKey;\n  conditionalMints: PublicKey[];\n}\n\n/**\n * Accounts returned from cancelOrder\n */\nexport interface CancelOrderAccounts {\n  orderStatus: PublicKey;\n}\n\n/**\n * Accounts returned from incrementNonce\n */\nexport interface IncrementNonceAccounts {\n  userNonce: PublicKey;\n}\n\n/**\n * Accounts returned from settleMarket\n */\nexport interface SettleMarketAccounts {\n  exchange: PublicKey;\n  market: PublicKey;\n}\n\n/**\n * Accounts returned from redeemWinnings\n */\nexport interface RedeemWinningsAccounts {\n  position: PublicKey;\n  vault: PublicKey;\n  winningMint: PublicKey;\n}\n\n/**\n * Accounts returned from activateMarket\n */\nexport interface ActivateMarketAccounts {\n  exchange: PublicKey;\n  market: PublicKey;\n}\n\n/**\n * Accounts returned from matchOrdersMulti\n */\nexport interface MatchOrdersMultiAccounts {\n  takerOrderStatus: PublicKey;\n  takerPosition: PublicKey;\n  makerOrderStatuses: PublicKey[];\n  makerPositions: PublicKey[];\n}\n\n// ============================================================================\n// ORDER CREATION TYPES\n// ============================================================================\n\n/**\n * Parameters for creating a bid order\n */\nexport interface BidOrderParams {\n  nonce: number;\n  maker: PublicKey;\n  market: PublicKey;\n  baseMint: PublicKey; // Token to buy\n  quoteMint: PublicKey; // Token to pay with\n  makerAmount: bigint; // Quote tokens to give\n  takerAmount: bigint; // Base tokens to receive\n  expiration?: bigint; // 0 = no expiration\n}\n\n/**\n * Parameters for creating an ask order\n */\nexport interface AskOrderParams {\n  nonce: number;\n  maker: PublicKey;\n  market: PublicKey;\n  baseMint: PublicKey; // Token to sell\n  quoteMint: PublicKey; // Token to receive\n  makerAmount: bigint; // Base tokens to give\n  takerAmount: bigint; // Quote tokens to receive\n  expiration?: bigint; // 0 = no expiration\n}\n"]}

package/dist/program/utils.d.ts

@@ -0,0 +1,91 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Convert a bigint to little-endian bytes
+ * @param value - The value to convert
+ * @param bytes - Number of bytes in the output
+ */
+export declare function toLeBytes(value: bigint, bytes: number): Buffer;
+/**
+ * Convert little-endian bytes to bigint
+ * @param buffer - The buffer to convert
+ */
+export declare function fromLeBytes(buffer: Buffer): bigint;
+/**
+ * Convert a bigint to big-endian bytes
+ * @param value - The value to convert
+ * @param bytes - Number of bytes in the output
+ */
+export declare function toBeBytes(value: bigint, bytes: number): Buffer;
+/**
+ * Convert big-endian bytes to bigint
+ * @param buffer - The buffer to convert
+ */
+export declare function fromBeBytes(buffer: Buffer): bigint;
+/**
+ * Convert a number to u8 buffer
+ */
+export declare function toU8(value: number): Buffer;
+/**
+ * Convert a bigint to u64 little-endian buffer
+ */
+export declare function toU64Le(value: bigint): Buffer;
+/**
+ * Convert a number to u32 little-endian buffer
+ */
+export declare function toU32Le(value: number): Buffer;
+/**
+ * Convert a bigint to i64 little-endian buffer (signed)
+ */
+export declare function toI64Le(value: bigint): Buffer;
+/**
+ * Convert a buffer to i64 (signed)
+ */
+export declare function fromI64Le(buffer: Buffer): bigint;
+/**
+ * Compute keccak256 hash of data
+ * @param data - The data to hash
+ * @returns 32-byte hash buffer
+ */
+export declare function keccak256(data: Buffer): Buffer;
+/**
+ * Derive condition ID from oracle, question ID, and number of outcomes
+ * This matches the on-chain derivation: keccak256(oracle || questionId || numOutcomes)
+ */
+export declare function deriveConditionId(oracle: PublicKey, questionId: Buffer, numOutcomes: number): Buffer;
+/**
+ * Derive Associated Token Address
+ * @param mint - The token mint
+ * @param owner - The owner of the ATA
+ * @param token2022 - Whether to use Token-2022 program
+ */
+export declare function getAssociatedTokenAddress(mint: PublicKey, owner: PublicKey, token2022?: boolean): PublicKey;
+/**
+ * Get ATA for a conditional token (always Token-2022)
+ */
+export declare function getConditionalTokenAta(mint: PublicKey, owner: PublicKey): PublicKey;
+/**
+ * Get ATA for a deposit token (SPL Token)
+ */
+export declare function getDepositTokenAta(mint: PublicKey, owner: PublicKey): PublicKey;
+/**
+ * Serialize a string with u16 length prefix (little-endian)
+ */
+export declare function serializeString(str: string): Buffer;
+/**
+ * Deserialize a string with u16 length prefix
+ * @returns [string, bytesConsumed]
+ */
+export declare function deserializeString(buffer: Buffer, offset: number): [string, number];
+/**
+ * Validate that a number is within the valid outcomes range
+ */
+export declare function validateOutcomes(numOutcomes: number): void;
+/**
+ * Validate that an outcome index is valid for a market
+ */
+export declare function validateOutcomeIndex(outcomeIndex: number, numOutcomes: number): void;
+/**
+ * Validate that a buffer is exactly 32 bytes
+ */
+export declare function validate32Bytes(buffer: Buffer, name: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/program/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/program/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOhD;AAMD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAOR;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,OAAe,GACzB,SAAS,CASX;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,SAAS,GACf,SAAS,CAEX;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,SAAS,GACf,SAAS,CAEX;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAM1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIlE"}

package/dist/program/utils.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLeBytes = toLeBytes;
+exports.fromLeBytes = fromLeBytes;
+exports.toBeBytes = toBeBytes;
+exports.fromBeBytes = fromBeBytes;
+exports.toU8 = toU8;
+exports.toU64Le = toU64Le;
+exports.toU32Le = toU32Le;
+exports.toI64Le = toI64Le;
+exports.fromI64Le = fromI64Le;
+exports.keccak256 = keccak256;
+exports.deriveConditionId = deriveConditionId;
+exports.getAssociatedTokenAddress = getAssociatedTokenAddress;
+exports.getConditionalTokenAta = getConditionalTokenAta;
+exports.getDepositTokenAta = getDepositTokenAta;
+exports.serializeString = serializeString;
+exports.deserializeString = deserializeString;
+exports.validateOutcomes = validateOutcomes;
+exports.validateOutcomeIndex = validateOutcomeIndex;
+exports.validate32Bytes = validate32Bytes;
+const web3_js_1 = require("@solana/web3.js");
+const js_sha3_1 = require("js-sha3");
+const constants_1 = require("./constants");
+// ============================================================================
+// BUFFER UTILITIES - Little Endian
+// ============================================================================
+/**
+ * Convert a bigint to little-endian bytes
+ * @param value - The value to convert
+ * @param bytes - Number of bytes in the output
+ */
+function toLeBytes(value, bytes) {
+    const buffer = Buffer.alloc(bytes);
+    let remaining = value;
+    for (let i = 0; i < bytes; i++) {
+        buffer[i] = Number(remaining & 0xffn);
+        remaining = remaining >> 8n;
+    }
+    return buffer;
+}
+/**
+ * Convert little-endian bytes to bigint
+ * @param buffer - The buffer to convert
+ */
+function fromLeBytes(buffer) {
+    let result = 0n;
+    for (let i = buffer.length - 1; i >= 0; i--) {
+        result = (result << 8n) | BigInt(buffer[i]);
+    }
+    return result;
+}
+/**
+ * Convert a bigint to big-endian bytes
+ * @param value - The value to convert
+ * @param bytes - Number of bytes in the output
+ */
+function toBeBytes(value, bytes) {
+    const buffer = Buffer.alloc(bytes);
+    let remaining = value;
+    for (let i = bytes - 1; i >= 0; i--) {
+        buffer[i] = Number(remaining & 0xffn);
+        remaining = remaining >> 8n;
+    }
+    return buffer;
+}
+/**
+ * Convert big-endian bytes to bigint
+ * @param buffer - The buffer to convert
+ */
+function fromBeBytes(buffer) {
+    let result = 0n;
+    for (let i = 0; i < buffer.length; i++) {
+        result = (result << 8n) | BigInt(buffer[i]);
+    }
+    return result;
+}
+/**
+ * Convert a number to u8 buffer
+ */
+function toU8(value) {
+    const buffer = Buffer.alloc(1);
+    buffer[0] = value & 0xff;
+    return buffer;
+}
+/**
+ * Convert a bigint to u64 little-endian buffer
+ */
+function toU64Le(value) {
+    return toLeBytes(value, 8);
+}
+/**
+ * Convert a number to u32 little-endian buffer
+ */
+function toU32Le(value) {
+    const buffer = Buffer.alloc(4);
+    buffer.writeUInt32LE(value, 0);
+    return buffer;
+}
+/**
+ * Convert a bigint to i64 little-endian buffer (signed)
+ */
+function toI64Le(value) {
+    // For negative values, we need to handle two's complement
+    if (value < 0n) {
+        // Add 2^64 to get two's complement representation
+        value = value + (1n << 64n);
+    }
+    return toLeBytes(value, 8);
+}
+/**
+ * Convert a buffer to i64 (signed)
+ */
+function fromI64Le(buffer) {
+    const unsigned = fromLeBytes(buffer);
+    // Check if the high bit is set (negative number)
+    if (unsigned >= 1n << 63n) {
+        return unsigned - (1n << 64n);
+    }
+    return unsigned;
+}
+// ============================================================================
+// KECCAK256 HASHING
+// ============================================================================
+/**
+ * Compute keccak256 hash of data
+ * @param data - The data to hash
+ * @returns 32-byte hash buffer
+ */
+function keccak256(data) {
+    return Buffer.from(js_sha3_1.keccak_256.arrayBuffer(data));
+}
+/**
+ * Derive condition ID from oracle, question ID, and number of outcomes
+ * This matches the on-chain derivation: keccak256(oracle || questionId || numOutcomes)
+ */
+function deriveConditionId(oracle, questionId, numOutcomes) {
+    const data = Buffer.concat([
+        oracle.toBuffer(),
+        questionId,
+        toU8(numOutcomes),
+    ]);
+    return keccak256(data);
+}
+// ============================================================================
+// ASSOCIATED TOKEN ADDRESS HELPERS
+// ============================================================================
+/**
+ * Derive Associated Token Address
+ * @param mint - The token mint
+ * @param owner - The owner of the ATA
+ * @param token2022 - Whether to use Token-2022 program
+ */
+function getAssociatedTokenAddress(mint, owner, token2022 = false) {
+    const tokenProgramId = token2022 ? constants_1.TOKEN_2022_PROGRAM_ID : constants_1.TOKEN_PROGRAM_ID;
+    const [address] = web3_js_1.PublicKey.findProgramAddressSync([owner.toBuffer(), tokenProgramId.toBuffer(), mint.toBuffer()], constants_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+    return address;
+}
+/**
+ * Get ATA for a conditional token (always Token-2022)
+ */
+function getConditionalTokenAta(mint, owner) {
+    return getAssociatedTokenAddress(mint, owner, true);
+}
+/**
+ * Get ATA for a deposit token (SPL Token)
+ */
+function getDepositTokenAta(mint, owner) {
+    return getAssociatedTokenAddress(mint, owner, false);
+}
+// ============================================================================
+// STRING SERIALIZATION
+// ============================================================================
+/**
+ * Serialize a string with u16 length prefix (little-endian)
+ */
+function serializeString(str) {
+    const strBuffer = Buffer.from(str, "utf-8");
+    const lengthBuffer = Buffer.alloc(2);
+    lengthBuffer.writeUInt16LE(strBuffer.length, 0);
+    return Buffer.concat([lengthBuffer, strBuffer]);
+}
+/**
+ * Deserialize a string with u16 length prefix
+ * @returns [string, bytesConsumed]
+ */
+function deserializeString(buffer, offset) {
+    const length = buffer.readUInt16LE(offset);
+    const str = buffer.toString("utf-8", offset + 2, offset + 2 + length);
+    return [str, 2 + length];
+}
+// ============================================================================
+// VALIDATION HELPERS
+// ============================================================================
+/**
+ * Validate that a number is within the valid outcomes range
+ */
+function validateOutcomes(numOutcomes) {
+    if (numOutcomes < 2 || numOutcomes > 6) {
+        throw new Error(`Invalid number of outcomes: ${numOutcomes}. Must be between 2 and 6.`);
+    }
+}
+/**
+ * Validate that an outcome index is valid for a market
+ */
+function validateOutcomeIndex(outcomeIndex, numOutcomes) {
+    if (outcomeIndex < 0 || outcomeIndex >= numOutcomes) {
+        throw new Error(`Invalid outcome index: ${outcomeIndex}. Must be between 0 and ${numOutcomes - 1}.`);
+    }
+}
+/**
+ * Validate that a buffer is exactly 32 bytes
+ */
+function validate32Bytes(buffer, name) {
+    if (buffer.length !== 32) {
+        throw new Error(`${name} must be exactly 32 bytes, got ${buffer.length}`);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/program/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/program/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { PublicKey } from \"@solana/web3.js\";\nimport { keccak_256 } from \"js-sha3\";\nimport {\n  TOKEN_PROGRAM_ID,\n  TOKEN_2022_PROGRAM_ID,\n  ASSOCIATED_TOKEN_PROGRAM_ID,\n} from \"./constants\";\n\n// ============================================================================\n// BUFFER UTILITIES - Little Endian\n// ============================================================================\n\n/**\n * Convert a bigint to little-endian bytes\n * @param value - The value to convert\n * @param bytes - Number of bytes in the output\n */\nexport function toLeBytes(value: bigint, bytes: number): Buffer {\n  const buffer = Buffer.alloc(bytes);\n  let remaining = value;\n  for (let i = 0; i < bytes; i++) {\n    buffer[i] = Number(remaining & 0xffn);\n    remaining = remaining >> 8n;\n  }\n  return buffer;\n}\n\n/**\n * Convert little-endian bytes to bigint\n * @param buffer - The buffer to convert\n */\nexport function fromLeBytes(buffer: Buffer): bigint {\n  let result = 0n;\n  for (let i = buffer.length - 1; i >= 0; i--) {\n    result = (result << 8n) | BigInt(buffer[i]);\n  }\n  return result;\n}\n\n/**\n * Convert a bigint to big-endian bytes\n * @param value - The value to convert\n * @param bytes - Number of bytes in the output\n */\nexport function toBeBytes(value: bigint, bytes: number): Buffer {\n  const buffer = Buffer.alloc(bytes);\n  let remaining = value;\n  for (let i = bytes - 1; i >= 0; i--) {\n    buffer[i] = Number(remaining & 0xffn);\n    remaining = remaining >> 8n;\n  }\n  return buffer;\n}\n\n/**\n * Convert big-endian bytes to bigint\n * @param buffer - The buffer to convert\n */\nexport function fromBeBytes(buffer: Buffer): bigint {\n  let result = 0n;\n  for (let i = 0; i < buffer.length; i++) {\n    result = (result << 8n) | BigInt(buffer[i]);\n  }\n  return result;\n}\n\n/**\n * Convert a number to u8 buffer\n */\nexport function toU8(value: number): Buffer {\n  const buffer = Buffer.alloc(1);\n  buffer[0] = value & 0xff;\n  return buffer;\n}\n\n/**\n * Convert a bigint to u64 little-endian buffer\n */\nexport function toU64Le(value: bigint): Buffer {\n  return toLeBytes(value, 8);\n}\n\n/**\n * Convert a number to u32 little-endian buffer\n */\nexport function toU32Le(value: number): Buffer {\n  const buffer = Buffer.alloc(4);\n  buffer.writeUInt32LE(value, 0);\n  return buffer;\n}\n\n/**\n * Convert a bigint to i64 little-endian buffer (signed)\n */\nexport function toI64Le(value: bigint): Buffer {\n  // For negative values, we need to handle two's complement\n  if (value < 0n) {\n    // Add 2^64 to get two's complement representation\n    value = value + (1n << 64n);\n  }\n  return toLeBytes(value, 8);\n}\n\n/**\n * Convert a buffer to i64 (signed)\n */\nexport function fromI64Le(buffer: Buffer): bigint {\n  const unsigned = fromLeBytes(buffer);\n  // Check if the high bit is set (negative number)\n  if (unsigned >= 1n << 63n) {\n    return unsigned - (1n << 64n);\n  }\n  return unsigned;\n}\n\n// ============================================================================\n// KECCAK256 HASHING\n// ============================================================================\n\n/**\n * Compute keccak256 hash of data\n * @param data - The data to hash\n * @returns 32-byte hash buffer\n */\nexport function keccak256(data: Buffer): Buffer {\n  return Buffer.from(keccak_256.arrayBuffer(data));\n}\n\n/**\n * Derive condition ID from oracle, question ID, and number of outcomes\n * This matches the on-chain derivation: keccak256(oracle || questionId || numOutcomes)\n */\nexport function deriveConditionId(\n  oracle: PublicKey,\n  questionId: Buffer,\n  numOutcomes: number\n): Buffer {\n  const data = Buffer.concat([\n    oracle.toBuffer(),\n    questionId,\n    toU8(numOutcomes),\n  ]);\n  return keccak256(data);\n}\n\n// ============================================================================\n// ASSOCIATED TOKEN ADDRESS HELPERS\n// ============================================================================\n\n/**\n * Derive Associated Token Address\n * @param mint - The token mint\n * @param owner - The owner of the ATA\n * @param token2022 - Whether to use Token-2022 program\n */\nexport function getAssociatedTokenAddress(\n  mint: PublicKey,\n  owner: PublicKey,\n  token2022: boolean = false\n): PublicKey {\n  const tokenProgramId = token2022 ? TOKEN_2022_PROGRAM_ID : TOKEN_PROGRAM_ID;\n\n  const [address] = PublicKey.findProgramAddressSync(\n    [owner.toBuffer(), tokenProgramId.toBuffer(), mint.toBuffer()],\n    ASSOCIATED_TOKEN_PROGRAM_ID\n  );\n\n  return address;\n}\n\n/**\n * Get ATA for a conditional token (always Token-2022)\n */\nexport function getConditionalTokenAta(\n  mint: PublicKey,\n  owner: PublicKey\n): PublicKey {\n  return getAssociatedTokenAddress(mint, owner, true);\n}\n\n/**\n * Get ATA for a deposit token (SPL Token)\n */\nexport function getDepositTokenAta(\n  mint: PublicKey,\n  owner: PublicKey\n): PublicKey {\n  return getAssociatedTokenAddress(mint, owner, false);\n}\n\n// ============================================================================\n// STRING SERIALIZATION\n// ============================================================================\n\n/**\n * Serialize a string with u16 length prefix (little-endian)\n */\nexport function serializeString(str: string): Buffer {\n  const strBuffer = Buffer.from(str, \"utf-8\");\n  const lengthBuffer = Buffer.alloc(2);\n  lengthBuffer.writeUInt16LE(strBuffer.length, 0);\n  return Buffer.concat([lengthBuffer, strBuffer]);\n}\n\n/**\n * Deserialize a string with u16 length prefix\n * @returns [string, bytesConsumed]\n */\nexport function deserializeString(\n  buffer: Buffer,\n  offset: number\n): [string, number] {\n  const length = buffer.readUInt16LE(offset);\n  const str = buffer.toString(\"utf-8\", offset + 2, offset + 2 + length);\n  return [str, 2 + length];\n}\n\n// ============================================================================\n// VALIDATION HELPERS\n// ============================================================================\n\n/**\n * Validate that a number is within the valid outcomes range\n */\nexport function validateOutcomes(numOutcomes: number): void {\n  if (numOutcomes < 2 || numOutcomes > 6) {\n    throw new Error(\n      `Invalid number of outcomes: ${numOutcomes}. Must be between 2 and 6.`\n    );\n  }\n}\n\n/**\n * Validate that an outcome index is valid for a market\n */\nexport function validateOutcomeIndex(\n  outcomeIndex: number,\n  numOutcomes: number\n): void {\n  if (outcomeIndex < 0 || outcomeIndex >= numOutcomes) {\n    throw new Error(\n      `Invalid outcome index: ${outcomeIndex}. Must be between 0 and ${numOutcomes - 1}.`\n    );\n  }\n}\n\n/**\n * Validate that a buffer is exactly 32 bytes\n */\nexport function validate32Bytes(buffer: Buffer, name: string): void {\n  if (buffer.length !== 32) {\n    throw new Error(`${name} must be exactly 32 bytes, got ${buffer.length}`);\n  }\n}\n"]}

package/dist/shared/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared utilities used across API and WebSocket modules.
+ */
+export { Resolution } from "./types";
+export { parseDecimal, formatDecimal, isZero } from "./price";
+export { scalePriceSize, ScalingError, } from "./scaling";
+export type { OrderbookDecimals, ScaledAmounts } from "./scaling";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Shared utilities used across API and WebSocket modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScalingError = exports.scalePriceSize = exports.isZero = exports.formatDecimal = exports.parseDecimal = exports.Resolution = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "Resolution", { enumerable: true, get: function () { return types_1.Resolution; } });
+var price_1 = require("./price");
+Object.defineProperty(exports, "parseDecimal", { enumerable: true, get: function () { return price_1.parseDecimal; } });
+Object.defineProperty(exports, "formatDecimal", { enumerable: true, get: function () { return price_1.formatDecimal; } });
+Object.defineProperty(exports, "isZero", { enumerable: true, get: function () { return price_1.isZero; } });
+var scaling_1 = require("./scaling");
+Object.defineProperty(exports, "scalePriceSize", { enumerable: true, get: function () { return scaling_1.scalePriceSize; } });
+Object.defineProperty(exports, "ScalingError", { enumerable: true, get: function () { return scaling_1.ScalingError; } });
+// deriveOrderbookId is exported from the program module (orders.ts)
+// Re-exported here for convenience via the shared module path
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAAqC;AAA5B,mGAAA,UAAU,OAAA;AACnB,iCAA8D;AAArD,qGAAA,YAAY,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,+FAAA,MAAM,OAAA;AAC5C,qCAGmB;AAFjB,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AAId,oEAAoE;AACpE,8DAA8D","sourcesContent":["/**\n * Shared utilities used across API and WebSocket modules.\n */\n\nexport { Resolution } from \"./types\";\nexport { parseDecimal, formatDecimal, isZero } from \"./price\";\nexport {\n  scalePriceSize,\n  ScalingError,\n} from \"./scaling\";\nexport type { OrderbookDecimals, ScaledAmounts } from \"./scaling\";\n\n// deriveOrderbookId is exported from the program module (orders.ts)\n// Re-exported here for convenience via the shared module path\n"]}

package/dist/shared/price.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Price utilities for the Lightcone SDK.
+ *
+ * This module provides helper functions for working with decimal string prices.
+ * The SDK uses String types for price/size/balance fields to preserve
+ * the exact decimal representation from the server, as different tokens
+ * have different decimal places (USDC=6, SOL=9, BTC=8, etc.).
+ */
+/**
+ * Parse a decimal string to number for calculations.
+ *
+ * @example
+ * ```typescript
+ * parseDecimal("0.500000"); // returns 0.5
+ * parseDecimal("1.000000"); // returns 1.0
+ * ```
+ */
+export declare function parseDecimal(s: string): number;
+/**
+ * Format a number as a decimal string with specified precision.
+ *
+ * @example
+ * ```typescript
+ * formatDecimal(0.5, 6);  // returns "0.500000"
+ * formatDecimal(1.0, 6);  // returns "1.000000"
+ * ```
+ */
+export declare function formatDecimal(value: number, precision: number): string;
+/**
+ * Check if a decimal string represents zero.
+ *
+ * @example
+ * ```typescript
+ * isZero("0");        // true
+ * isZero("0.0");      // true
+ * isZero("0.000000"); // true
+ * isZero("0.001");    // false
+ * ```
+ */
+export declare function isZero(s: string): boolean;
+//# sourceMappingURL=price.d.ts.map

package/dist/shared/price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../../src/shared/price.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAGzC"}

package/dist/shared/price.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Price utilities for the Lightcone SDK.
+ *
+ * This module provides helper functions for working with decimal string prices.
+ * The SDK uses String types for price/size/balance fields to preserve
+ * the exact decimal representation from the server, as different tokens
+ * have different decimal places (USDC=6, SOL=9, BTC=8, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDecimal = parseDecimal;
+exports.formatDecimal = formatDecimal;
+exports.isZero = isZero;
+/**
+ * Parse a decimal string to number for calculations.
+ *
+ * @example
+ * ```typescript
+ * parseDecimal("0.500000"); // returns 0.5
+ * parseDecimal("1.000000"); // returns 1.0
+ * ```
+ */
+function parseDecimal(s) {
+    const result = parseFloat(s);
+    if (isNaN(result)) {
+        throw new Error(`Invalid decimal string: ${s}`);
+    }
+    return result;
+}
+/**
+ * Format a number as a decimal string with specified precision.
+ *
+ * @example
+ * ```typescript
+ * formatDecimal(0.5, 6);  // returns "0.500000"
+ * formatDecimal(1.0, 6);  // returns "1.000000"
+ * ```
+ */
+function formatDecimal(value, precision) {
+    return value.toFixed(precision);
+}
+/**
+ * Check if a decimal string represents zero.
+ *
+ * @example
+ * ```typescript
+ * isZero("0");        // true
+ * isZero("0.0");      // true
+ * isZero("0.000000"); // true
+ * isZero("0.001");    // false
+ * ```
+ */
+function isZero(s) {
+    const parsed = parseFloat(s);
+    return !isNaN(parsed) && parsed === 0;
+}
+//# sourceMappingURL=price.js.map

package/dist/shared/price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../src/shared/price.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAWH,oCAMC;AAWD,sCAEC;AAaD,wBAGC;AA5CD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,CAAS;IACpC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,KAAa,EAAE,SAAiB;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,MAAM,CAAC,CAAS;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC;AACxC,CAAC","sourcesContent":["/**\n * Price utilities for the Lightcone SDK.\n *\n * This module provides helper functions for working with decimal string prices.\n * The SDK uses String types for price/size/balance fields to preserve\n * the exact decimal representation from the server, as different tokens\n * have different decimal places (USDC=6, SOL=9, BTC=8, etc.).\n */\n\n/**\n * Parse a decimal string to number for calculations.\n *\n * @example\n * ```typescript\n * parseDecimal(\"0.500000\"); // returns 0.5\n * parseDecimal(\"1.000000\"); // returns 1.0\n * ```\n */\nexport function parseDecimal(s: string): number {\n  const result = parseFloat(s);\n  if (isNaN(result)) {\n    throw new Error(`Invalid decimal string: ${s}`);\n  }\n  return result;\n}\n\n/**\n * Format a number as a decimal string with specified precision.\n *\n * @example\n * ```typescript\n * formatDecimal(0.5, 6);  // returns \"0.500000\"\n * formatDecimal(1.0, 6);  // returns \"1.000000\"\n * ```\n */\nexport function formatDecimal(value: number, precision: number): string {\n  return value.toFixed(precision);\n}\n\n/**\n * Check if a decimal string represents zero.\n *\n * @example\n * ```typescript\n * isZero(\"0\");        // true\n * isZero(\"0.0\");      // true\n * isZero(\"0.000000\"); // true\n * isZero(\"0.001\");    // false\n * ```\n */\nexport function isZero(s: string): boolean {\n  const parsed = parseFloat(s);\n  return !isNaN(parsed) && parsed === 0;\n}\n\n"]}

package/dist/shared/scaling.d.ts

@@ -0,0 +1,45 @@
+import { OrderSide } from "../program/types";
+/**
+ * Orderbook decimal configuration
+ */
+export interface OrderbookDecimals {
+    orderbookId: string;
+    baseDecimals: number;
+    quoteDecimals: number;
+    priceDecimals: number;
+}
+/**
+ * Scaled amounts result
+ */
+export interface ScaledAmounts {
+    makerAmount: bigint;
+    takerAmount: bigint;
+}
+/**
+ * Error thrown during price/size scaling
+ */
+export declare class ScalingError extends Error {
+    constructor(message: string);
+    static zeroPriceOrSize(): ScalingError;
+    static negativeValue(field: string): ScalingError;
+    static overflow(field: string): ScalingError;
+}
+/**
+ * Scale price and size to maker_amount and taker_amount using exact decimal arithmetic.
+ *
+ * For BID orders (buying base with quote):
+ *   - maker_amount = price * size * 10^quoteDecimals (what maker gives in quote tokens)
+ *   - taker_amount = size * 10^baseDecimals (what maker receives in base tokens)
+ *
+ * For ASK orders (selling base for quote):
+ *   - maker_amount = size * 10^baseDecimals (what maker gives in base tokens)
+ *   - taker_amount = price * size * 10^quoteDecimals (what maker receives in quote tokens)
+ *
+ * @param priceStr - Price as a decimal string (e.g., "0.75")
+ * @param sizeStr - Size as a decimal string (e.g., "100")
+ * @param side - Order side (BID or ASK)
+ * @param decimals - Orderbook decimal configuration
+ * @returns Scaled maker_amount and taker_amount as bigints
+ */
+export declare function scalePriceSize(priceStr: string, sizeStr: string, side: OrderSide, decimals: OrderbookDecimals): ScaledAmounts;
+//# sourceMappingURL=scaling.d.ts.map

package/dist/shared/scaling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaling.d.ts","sourceRoot":"","sources":["../../src/shared/scaling.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,eAAe,IAAI,YAAY;IAItC,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAIjD,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;CAG7C;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,aAAa,CAyCf"}