@lightconexyz/lightcone-sdk 0.6.1 → 0.7.1

package/dist/program/utils.js

@@ -7,6 +7,7 @@ exports.fromBeBytes = fromBeBytes;
 exports.toU8 = toU8;
 exports.toU64Le = toU64Le;
 exports.toU32Le = toU32Le;
+exports.toI16Le = toI16Le;
 exports.toI64Le = toI64Le;
 exports.fromI64Le = fromI64Le;
 exports.keccak256 = keccak256;
@@ -15,14 +16,20 @@ exports.getAssociatedTokenAddress = getAssociatedTokenAddress;
 exports.getConditionalTokenAta = getConditionalTokenAta;
 exports.getDepositTokenAta = getDepositTokenAta;
 exports.serializeString = serializeString;
+exports.serializeStringU32 = serializeStringU32;
+exports.serializeConditionalMetadata = serializeConditionalMetadata;
 exports.deserializeString = deserializeString;
 exports.validateOutcomes = validateOutcomes;
 exports.validateOutcomeIndex = validateOutcomeIndex;
+exports.validateFeePair = validateFeePair;
 exports.validate32Bytes = validate32Bytes;
+exports.winnerTakesAllPayoutNumerators = winnerTakesAllPayoutNumerators;
+exports.scalarToPayoutNumerators = scalarToPayoutNumerators;
 const web3_js_1 = require("@solana/web3.js");
 const js_sha3_1 = require("js-sha3");
 const error_1 = require("./error");
 const constants_1 = require("./constants");
+const U32_MAX = 0xffffffffn;
 // ============================================================================
 // BUFFER UTILITIES - Little Endian
 // ============================================================================
@@ -98,6 +105,17 @@ function toU32Le(value) {
     buffer.writeUInt32LE(value, 0);
     return buffer;
 }
+/**
+ * Convert a number to i16 little-endian buffer
+ */
+function toI16Le(value) {
+    if (!Number.isInteger(value) || value < -32768 || value > 32767) {
+        throw error_1.ProgramSdkError.serialization(`i16 value out of range: ${value}`);
+    }
+    const buffer = Buffer.alloc(2);
+    buffer.writeInt16LE(value, 0);
+    return buffer;
+}
 /**
  * Convert a bigint to i64 little-endian buffer (signed)
  */
@@ -150,18 +168,18 @@ function deriveConditionId(oracle, questionId, numOutcomes) {
  * Derive Associated Token Address
  * @param mint - The token mint
  * @param owner - The owner of the ATA
- * @param token2022 - Whether to use Token-2022 program
+ * @param token2022 - Deprecated. Conditional tokens now use SPL Token.
  */
 function getAssociatedTokenAddress(mint, owner, token2022 = false) {
-    const tokenProgramId = token2022 ? constants_1.TOKEN_2022_PROGRAM_ID : constants_1.TOKEN_PROGRAM_ID;
+    const tokenProgramId = 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)
+ * Get ATA for a conditional token (SPL Token)
  */
 function getConditionalTokenAta(mint, owner) {
-    return getAssociatedTokenAddress(mint, owner, true);
+    return getAssociatedTokenAddress(mint, owner, false);
 }
 /**
  * Get ATA for a deposit token (SPL Token)
@@ -181,6 +199,28 @@ function serializeString(str) {
     lengthBuffer.writeUInt16LE(strBuffer.length, 0);
     return Buffer.concat([lengthBuffer, strBuffer]);
 }
+/**
+ * Serialize a string with u32 length prefix (little-endian), enforcing max UTF-8 bytes.
+ */
+function serializeStringU32(str, maxBytes) {
+    const strBuffer = Buffer.from(str, "utf-8");
+    if (strBuffer.length > maxBytes) {
+        throw error_1.ProgramSdkError.invalidDataLength("string", maxBytes, strBuffer.length);
+    }
+    const lengthBuffer = Buffer.alloc(4);
+    lengthBuffer.writeUInt32LE(strBuffer.length, 0);
+    return Buffer.concat([lengthBuffer, strBuffer]);
+}
+/**
+ * Serialize conditional metadata instruction strings.
+ */
+function serializeConditionalMetadata(name, symbol, uri) {
+    return Buffer.concat([
+        serializeStringU32(name, 32),
+        serializeStringU32(symbol, 10),
+        serializeStringU32(uri, 200),
+    ]);
+}
 /**
  * Deserialize a string with u16 length prefix
  * @returns [string, bytesConsumed]
@@ -197,7 +237,7 @@ function deserializeString(buffer, offset) {
  * Validate that a number is within the valid outcomes range
  */
 function validateOutcomes(numOutcomes) {
-    if (numOutcomes < 2 || numOutcomes > 6) {
+    if (!Number.isInteger(numOutcomes) || numOutcomes < constants_1.MIN_OUTCOMES || numOutcomes > constants_1.MAX_OUTCOMES) {
         throw error_1.ProgramSdkError.invalidOutcomeCount(numOutcomes);
     }
 }
@@ -209,6 +249,22 @@ function validateOutcomeIndex(outcomeIndex, numOutcomes) {
         throw error_1.ProgramSdkError.invalidOutcomeIndex(outcomeIndex, numOutcomes - 1);
     }
 }
+/**
+ * Validate a maker/taker fee pair against program rules.
+ */
+function validateFeePair(makerFeeBps, takerFeeBps) {
+    if (!Number.isInteger(makerFeeBps) ||
+        !Number.isInteger(takerFeeBps) ||
+        makerFeeBps < -500 ||
+        makerFeeBps > 500 ||
+        takerFeeBps < -500 ||
+        takerFeeBps > 500) {
+        throw error_1.ProgramSdkError.invalidFeeRange();
+    }
+    if (makerFeeBps + takerFeeBps < 0) {
+        throw error_1.ProgramSdkError.invalidFeeSum();
+    }
+}
 /**
  * Validate that a buffer is exactly 32 bytes
  */
@@ -217,4 +273,75 @@ function validate32Bytes(buffer, name) {
         throw error_1.ProgramSdkError.invalidDataLength(name, 32, buffer.length);
     }
 }
+/**
+ * Build a winner-takes-all payout vector for a binary or multi-outcome market.
+ */
+function winnerTakesAllPayoutNumerators(winningOutcome, numOutcomes) {
+    validateOutcomes(numOutcomes);
+    validateOutcomeIndex(winningOutcome, numOutcomes);
+    const payoutNumerators = Array(numOutcomes).fill(0);
+    payoutNumerators[winningOutcome] = 1;
+    return payoutNumerators;
+}
+/**
+ * Convert a two-sided scalar resolution into program payout numerators.
+ *
+ * All values are integer fixed-point BigInts. The resolved value is clamped to
+ * [minValue, maxValue], reduced by GCD, and checked against the program's u32
+ * payout representation.
+ */
+function scalarToPayoutNumerators(params) {
+    validateOutcomes(params.numOutcomes);
+    validateOutcomeIndex(params.lowerOutcomeIndex, params.numOutcomes);
+    validateOutcomeIndex(params.upperOutcomeIndex, params.numOutcomes);
+    if (params.lowerOutcomeIndex === params.upperOutcomeIndex) {
+        throw error_1.ProgramSdkError.duplicateScalarOutcomes();
+    }
+    const range = params.maxValue - params.minValue;
+    if (range <= 0n) {
+        throw error_1.ProgramSdkError.invalidScalarRange();
+    }
+    const clamped = params.resolvedValue < params.minValue
+        ? params.minValue
+        : params.resolvedValue > params.maxValue
+            ? params.maxValue
+            : params.resolvedValue;
+    const numerators = Array(params.numOutcomes).fill(0n);
+    numerators[params.lowerOutcomeIndex] = params.maxValue - clamped;
+    numerators[params.upperOutcomeIndex] = clamped - params.minValue;
+    return reduceAndFitPayoutNumerators(numerators);
+}
+function reduceAndFitPayoutNumerators(numerators) {
+    const nonZero = numerators.filter((n) => n > 0n);
+    if (nonZero.length === 0) {
+        throw error_1.ProgramSdkError.invalidPayoutNumerators();
+    }
+    const gcd = nonZero.reduce((acc, value) => gcdBigInt(acc, value));
+    let sum = 0n;
+    const reduced = numerators.map((numerator) => {
+        const value = numerator === 0n ? 0n : numerator / gcd;
+        if (value > U32_MAX) {
+            throw error_1.ProgramSdkError.payoutVectorExceedsU32();
+        }
+        sum += value;
+        return Number(value);
+    });
+    if (sum === 0n) {
+        throw error_1.ProgramSdkError.invalidPayoutNumerators();
+    }
+    if (sum > U32_MAX) {
+        throw error_1.ProgramSdkError.payoutVectorExceedsU32();
+    }
+    return reduced;
+}
+function gcdBigInt(a, b) {
+    let left = a;
+    let right = b;
+    while (right !== 0n) {
+        const remainder = left % right;
+        left = right;
+        right = remainder;
+    }
+    return left;
+}
 //# sourceMappingURL=utils.js.map

package/dist/program/utils.js.map

@@ -1 +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 { ProgramSdkError } from \"./error\";\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 ProgramSdkError.invalidOutcomeCount(numOutcomes);\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 ProgramSdkError.invalidOutcomeIndex(outcomeIndex, numOutcomes - 1);\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 ProgramSdkError.invalidDataLength(name, 32, buffer.length);\n  }\n}\n"]}
+{"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 { ProgramSdkError } from \"./error\";\nimport {\n  MAX_OUTCOMES,\n  MIN_OUTCOMES,\n  TOKEN_PROGRAM_ID,\n  ASSOCIATED_TOKEN_PROGRAM_ID,\n} from \"./constants\";\nimport type { ScalarResolutionParams } from \"./types\";\n\nconst U32_MAX = 0xffffffffn;\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 number to i16 little-endian buffer\n */\nexport function toI16Le(value: number): Buffer {\n  if (!Number.isInteger(value) || value < -32768 || value > 32767) {\n    throw ProgramSdkError.serialization(`i16 value out of range: ${value}`);\n  }\n  const buffer = Buffer.alloc(2);\n  buffer.writeInt16LE(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 - Deprecated. Conditional tokens now use SPL Token.\n */\nexport function getAssociatedTokenAddress(\n  mint: PublicKey,\n  owner: PublicKey,\n  token2022: boolean = false\n): PublicKey {\n  const tokenProgramId = 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 (SPL Token)\n */\nexport function getConditionalTokenAta(\n  mint: PublicKey,\n  owner: PublicKey\n): PublicKey {\n  return getAssociatedTokenAddress(mint, owner, false);\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 * Serialize a string with u32 length prefix (little-endian), enforcing max UTF-8 bytes.\n */\nexport function serializeStringU32(str: string, maxBytes: number): Buffer {\n  const strBuffer = Buffer.from(str, \"utf-8\");\n  if (strBuffer.length > maxBytes) {\n    throw ProgramSdkError.invalidDataLength(\"string\", maxBytes, strBuffer.length);\n  }\n  const lengthBuffer = Buffer.alloc(4);\n  lengthBuffer.writeUInt32LE(strBuffer.length, 0);\n  return Buffer.concat([lengthBuffer, strBuffer]);\n}\n\n/**\n * Serialize conditional metadata instruction strings.\n */\nexport function serializeConditionalMetadata(\n  name: string,\n  symbol: string,\n  uri: string\n): Buffer {\n  return Buffer.concat([\n    serializeStringU32(name, 32),\n    serializeStringU32(symbol, 10),\n    serializeStringU32(uri, 200),\n  ]);\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 (!Number.isInteger(numOutcomes) || numOutcomes < MIN_OUTCOMES || numOutcomes > MAX_OUTCOMES) {\n    throw ProgramSdkError.invalidOutcomeCount(numOutcomes);\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 ProgramSdkError.invalidOutcomeIndex(outcomeIndex, numOutcomes - 1);\n  }\n}\n\n/**\n * Validate a maker/taker fee pair against program rules.\n */\nexport function validateFeePair(makerFeeBps: number, takerFeeBps: number): void {\n  if (\n    !Number.isInteger(makerFeeBps) ||\n    !Number.isInteger(takerFeeBps) ||\n    makerFeeBps < -500 ||\n    makerFeeBps > 500 ||\n    takerFeeBps < -500 ||\n    takerFeeBps > 500\n  ) {\n    throw ProgramSdkError.invalidFeeRange();\n  }\n  if (makerFeeBps + takerFeeBps < 0) {\n    throw ProgramSdkError.invalidFeeSum();\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 ProgramSdkError.invalidDataLength(name, 32, buffer.length);\n  }\n}\n\n/**\n * Build a winner-takes-all payout vector for a binary or multi-outcome market.\n */\nexport function winnerTakesAllPayoutNumerators(\n  winningOutcome: number,\n  numOutcomes: number\n): number[] {\n  validateOutcomes(numOutcomes);\n  validateOutcomeIndex(winningOutcome, numOutcomes);\n\n  const payoutNumerators = Array<number>(numOutcomes).fill(0);\n  payoutNumerators[winningOutcome] = 1;\n  return payoutNumerators;\n}\n\n/**\n * Convert a two-sided scalar resolution into program payout numerators.\n *\n * All values are integer fixed-point BigInts. The resolved value is clamped to\n * [minValue, maxValue], reduced by GCD, and checked against the program's u32\n * payout representation.\n */\nexport function scalarToPayoutNumerators(\n  params: ScalarResolutionParams\n): number[] {\n  validateOutcomes(params.numOutcomes);\n  validateOutcomeIndex(params.lowerOutcomeIndex, params.numOutcomes);\n  validateOutcomeIndex(params.upperOutcomeIndex, params.numOutcomes);\n\n  if (params.lowerOutcomeIndex === params.upperOutcomeIndex) {\n    throw ProgramSdkError.duplicateScalarOutcomes();\n  }\n\n  const range = params.maxValue - params.minValue;\n  if (range <= 0n) {\n    throw ProgramSdkError.invalidScalarRange();\n  }\n\n  const clamped =\n    params.resolvedValue < params.minValue\n      ? params.minValue\n      : params.resolvedValue > params.maxValue\n        ? params.maxValue\n        : params.resolvedValue;\n\n  const numerators = Array<bigint>(params.numOutcomes).fill(0n);\n  numerators[params.lowerOutcomeIndex] = params.maxValue - clamped;\n  numerators[params.upperOutcomeIndex] = clamped - params.minValue;\n\n  return reduceAndFitPayoutNumerators(numerators);\n}\n\nfunction reduceAndFitPayoutNumerators(numerators: bigint[]): number[] {\n  const nonZero = numerators.filter((n) => n > 0n);\n  if (nonZero.length === 0) {\n    throw ProgramSdkError.invalidPayoutNumerators();\n  }\n\n  const gcd = nonZero.reduce((acc, value) => gcdBigInt(acc, value));\n  let sum = 0n;\n  const reduced = numerators.map((numerator) => {\n    const value = numerator === 0n ? 0n : numerator / gcd;\n    if (value > U32_MAX) {\n      throw ProgramSdkError.payoutVectorExceedsU32();\n    }\n    sum += value;\n    return Number(value);\n  });\n\n  if (sum === 0n) {\n    throw ProgramSdkError.invalidPayoutNumerators();\n  }\n  if (sum > U32_MAX) {\n    throw ProgramSdkError.payoutVectorExceedsU32();\n  }\n\n  return reduced;\n}\n\nfunction gcdBigInt(a: bigint, b: bigint): bigint {\n  let left = a;\n  let right = b;\n  while (right !== 0n) {\n    const remainder = left % right;\n    left = right;\n    right = remainder;\n  }\n  return left;\n}\n"]}

package/dist/rpc.d.ts

@@ -4,7 +4,12 @@ import type { Exchange, GlobalDepositToken } from "./program/types";
 export declare class Rpc {
     private readonly client;
     constructor(client: ClientContext);
-    /** Get the underlying Connection, or throw if not configured. */
+    /**
+     * Get the currently-active Connection, or throw if not configured.
+     *
+     * Prefer the typed methods (getExchange, etc.) — they include automatic
+     * failover. Direct use of inner() bypasses the retry/failover wrapper.
+     */
     inner(): Connection;
     getExchangePda(): PublicKey;
     getGlobalDepositTokenPda(mint: PublicKey): PublicKey;

package/dist/rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAY/C,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,qBAAa,GAAG;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,iEAAiE;IACjE,KAAK,IAAI,UAAU;IAMnB,cAAc,IAAI,SAAS;IAI3B,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS;IAIpD,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS;IAM9D,kBAAkB,IAAI,OAAO,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IAKI,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAUhC,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAW1E"}
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAY/C,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,qBAAa,GAAG;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD;;;;;OAKG;IACH,KAAK,IAAI,UAAU;IAMnB,cAAc,IAAI,SAAS;IAI3B,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS;IAIpD,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS;IAM9D,kBAAkB,IAAI,OAAO,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IAMI,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAYhC,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAa1E"}

package/dist/rpc.js

@@ -10,7 +10,12 @@ class Rpc {
     constructor(client) {
         this.client = client;
     }
-    /** Get the underlying Connection, or throw if not configured. */
+    /**
+     * Get the currently-active Connection, or throw if not configured.
+     *
+     * Prefer the typed methods (getExchange, etc.) — they include automatic
+     * failover. Direct use of inner() bypasses the retry/failover wrapper.
+     */
     inner() {
         return (0, context_1.requireConnection)(this.client);
     }
@@ -26,22 +31,19 @@ class Rpc {
     }
     // ── Account fetchers (async, require Connection) ──────────────────────
     async getLatestBlockhash() {
-        const connection = (0, context_1.requireConnection)(this.client);
-        return connection.getLatestBlockhash();
+        return (0, context_1.connectionWithFailover)(this.client, (connection) => connection.getLatestBlockhash());
     }
     async getExchange() {
-        const connection = (0, context_1.requireConnection)(this.client);
         const pda = this.getExchangePda();
-        const accountInfo = await connection.getAccountInfo(pda);
+        const accountInfo = await (0, context_1.connectionWithFailover)(this.client, (connection) => connection.getAccountInfo(pda));
         if (!accountInfo) {
             throw error_1.ProgramSdkError.accountNotFound("Exchange");
         }
         return (0, accounts_1.deserializeExchange)(accountInfo.data);
     }
     async getGlobalDepositToken(mint) {
-        const connection = (0, context_1.requireConnection)(this.client);
         const pda = this.getGlobalDepositTokenPda(mint);
-        const accountInfo = await connection.getAccountInfo(pda);
+        const accountInfo = await (0, context_1.connectionWithFailover)(this.client, (connection) => connection.getAccountInfo(pda));
         if (!accountInfo) {
             throw error_1.ProgramSdkError.accountNotFound(`GlobalDepositToken for mint ${mint.toBase58()}`);
         }

package/dist/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":";;;AAEA,uCAA8C;AAC9C,2CAAkD;AAClD,uCAIuB;AACvB,iDAG4B;AAG5B,MAAa,GAAG;IACe;IAA7B,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAEtD,iEAAiE;IACjE,KAAK;QACH,OAAO,IAAA,2BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,yEAAyE;IAEzE,cAAc;QACZ,OAAO,IAAA,oBAAc,EAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,wBAAwB,CAAC,IAAe;QACtC,OAAO,IAAA,8BAAwB,EAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,uBAAuB,CAAC,IAAe,EAAE,IAAe;QACtD,OAAO,IAAA,6BAAuB,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,kBAAkB;QAItB,MAAM,UAAU,GAAG,IAAA,2BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,kBAAkB,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,UAAU,GAAG,IAAA,2BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,uBAAe,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAA,8BAAmB,EAAC,WAAW,CAAC,IAAc,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,IAAe;QACzC,MAAM,UAAU,GAAG,IAAA,2BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,uBAAe,CAAC,eAAe,CACnC,+BAA+B,IAAI,CAAC,QAAQ,EAAE,EAAE,CACjD,CAAC;QACJ,CAAC;QACD,OAAO,IAAA,wCAA6B,EAAC,WAAW,CAAC,IAAc,CAAC,CAAC;IACnE,CAAC;CACF;AArDD,kBAqDC","sourcesContent":["import type { Connection, PublicKey } from \"@solana/web3.js\";\nimport type { ClientContext } from \"./context\";\nimport { requireConnection } from \"./context\";\nimport { ProgramSdkError } from \"./program/error\";\nimport {\n  getExchangePda,\n  getGlobalDepositTokenPda,\n  getUserGlobalDepositPda,\n} from \"./program/pda\";\nimport {\n  deserializeExchange,\n  deserializeGlobalDepositToken,\n} from \"./program/accounts\";\nimport type { Exchange, GlobalDepositToken } from \"./program/types\";\n\nexport class Rpc {\n  constructor(private readonly client: ClientContext) {}\n\n  /** Get the underlying Connection, or throw if not configured. */\n  inner(): Connection {\n    return requireConnection(this.client);\n  }\n\n  // ── PDA helpers (sync, no Connection needed) ──────────────────────────\n\n  getExchangePda(): PublicKey {\n    return getExchangePda(this.client.programId)[0];\n  }\n\n  getGlobalDepositTokenPda(mint: PublicKey): PublicKey {\n    return getGlobalDepositTokenPda(mint, this.client.programId)[0];\n  }\n\n  getUserGlobalDepositPda(user: PublicKey, mint: PublicKey): PublicKey {\n    return getUserGlobalDepositPda(user, mint, this.client.programId)[0];\n  }\n\n  // ── Account fetchers (async, require Connection) ──────────────────────\n\n  async getLatestBlockhash(): Promise<{\n    blockhash: string;\n    lastValidBlockHeight: number;\n  }> {\n    const connection = requireConnection(this.client);\n    return connection.getLatestBlockhash();\n  }\n\n  async getExchange(): Promise<Exchange> {\n    const connection = requireConnection(this.client);\n    const pda = this.getExchangePda();\n    const accountInfo = await connection.getAccountInfo(pda);\n    if (!accountInfo) {\n      throw ProgramSdkError.accountNotFound(\"Exchange\");\n    }\n    return deserializeExchange(accountInfo.data as Buffer);\n  }\n\n  async getGlobalDepositToken(mint: PublicKey): Promise<GlobalDepositToken> {\n    const connection = requireConnection(this.client);\n    const pda = this.getGlobalDepositTokenPda(mint);\n    const accountInfo = await connection.getAccountInfo(pda);\n    if (!accountInfo) {\n      throw ProgramSdkError.accountNotFound(\n        `GlobalDepositToken for mint ${mint.toBase58()}`\n      );\n    }\n    return deserializeGlobalDepositToken(accountInfo.data as Buffer);\n  }\n}\n"]}
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":";;;AAEA,uCAAsE;AACtE,2CAAkD;AAClD,uCAIuB;AACvB,iDAG4B;AAG5B,MAAa,GAAG;IACe;IAA7B,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAEtD;;;;;OAKG;IACH,KAAK;QACH,OAAO,IAAA,2BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,yEAAyE;IAEzE,cAAc;QACZ,OAAO,IAAA,oBAAc,EAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,wBAAwB,CAAC,IAAe;QACtC,OAAO,IAAA,8BAAwB,EAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,uBAAuB,CAAC,IAAe,EAAE,IAAe;QACtD,OAAO,IAAA,6BAAuB,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,kBAAkB;QAItB,OAAO,IAAA,gCAAsB,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CACxD,UAAU,CAAC,kBAAkB,EAAE,CAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,MAAM,IAAA,gCAAsB,EAC9C,IAAI,CAAC,MAAM,EACX,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAC/C,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,uBAAe,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAA,8BAAmB,EAAC,WAAW,CAAC,IAAc,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,IAAe;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,IAAA,gCAAsB,EAC9C,IAAI,CAAC,MAAM,EACX,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAC/C,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,uBAAe,CAAC,eAAe,CACnC,+BAA+B,IAAI,CAAC,QAAQ,EAAE,EAAE,CACjD,CAAC;QACJ,CAAC;QACD,OAAO,IAAA,wCAA6B,EAAC,WAAW,CAAC,IAAc,CAAC,CAAC;IACnE,CAAC;CACF;AA/DD,kBA+DC","sourcesContent":["import type { Connection, PublicKey } from \"@solana/web3.js\";\nimport type { ClientContext } from \"./context\";\nimport { requireConnection, connectionWithFailover } from \"./context\";\nimport { ProgramSdkError } from \"./program/error\";\nimport {\n  getExchangePda,\n  getGlobalDepositTokenPda,\n  getUserGlobalDepositPda,\n} from \"./program/pda\";\nimport {\n  deserializeExchange,\n  deserializeGlobalDepositToken,\n} from \"./program/accounts\";\nimport type { Exchange, GlobalDepositToken } from \"./program/types\";\n\nexport class Rpc {\n  constructor(private readonly client: ClientContext) {}\n\n  /**\n   * Get the currently-active Connection, or throw if not configured.\n   *\n   * Prefer the typed methods (getExchange, etc.) — they include automatic\n   * failover. Direct use of inner() bypasses the retry/failover wrapper.\n   */\n  inner(): Connection {\n    return requireConnection(this.client);\n  }\n\n  // ── PDA helpers (sync, no Connection needed) ──────────────────────────\n\n  getExchangePda(): PublicKey {\n    return getExchangePda(this.client.programId)[0];\n  }\n\n  getGlobalDepositTokenPda(mint: PublicKey): PublicKey {\n    return getGlobalDepositTokenPda(mint, this.client.programId)[0];\n  }\n\n  getUserGlobalDepositPda(user: PublicKey, mint: PublicKey): PublicKey {\n    return getUserGlobalDepositPda(user, mint, this.client.programId)[0];\n  }\n\n  // ── Account fetchers (async, require Connection) ──────────────────────\n\n  async getLatestBlockhash(): Promise<{\n    blockhash: string;\n    lastValidBlockHeight: number;\n  }> {\n    return connectionWithFailover(this.client, (connection) =>\n      connection.getLatestBlockhash()\n    );\n  }\n\n  async getExchange(): Promise<Exchange> {\n    const pda = this.getExchangePda();\n    const accountInfo = await connectionWithFailover(\n      this.client,\n      (connection) => connection.getAccountInfo(pda)\n    );\n    if (!accountInfo) {\n      throw ProgramSdkError.accountNotFound(\"Exchange\");\n    }\n    return deserializeExchange(accountInfo.data as Buffer);\n  }\n\n  async getGlobalDepositToken(mint: PublicKey): Promise<GlobalDepositToken> {\n    const pda = this.getGlobalDepositTokenPda(mint);\n    const accountInfo = await connectionWithFailover(\n      this.client,\n      (connection) => connection.getAccountInfo(pda)\n    );\n    if (!accountInfo) {\n      throw ProgramSdkError.accountNotFound(\n        `GlobalDepositToken for mint ${mint.toBase58()}`\n      );\n    }\n    return deserializeGlobalDepositToken(accountInfo.data as Buffer);\n  }\n}\n"]}

package/dist/rpcFailover.d.ts

@@ -0,0 +1,22 @@
+/**
+ * RPC failover: automatic switch to a backup Solana RPC endpoint on
+ * infrastructure errors, with 120 s cooldown recovery to primary.
+ *
+ * Mirrors rust/src/rpc_failover.rs.
+ */
+export declare const FAST_RETRY_DELAY_MS = 100;
+export declare const COOLDOWN_DURATION_MS = 120000;
+export declare enum ActiveRpc {
+    Primary = "primary",
+    Backup = "backup"
+}
+export declare class RpcFailoverState {
+    active: ActiveRpc;
+    private flippedToBackupAt?;
+    maybeRecoverToPrimary(): void;
+    flipToBackup(): void;
+    flipToPrimary(): void;
+}
+export declare function isInfrastructureError(err: unknown): boolean;
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=rpcFailover.d.ts.map

package/dist/rpcFailover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcFailover.d.ts","sourceRoot":"","sources":["../src/rpcFailover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,oBAAY,SAAS;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,qBAAa,gBAAgB;IAC3B,MAAM,EAAE,SAAS,CAAqB;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAS;IAEnC,qBAAqB,IAAI,IAAI;IAY7B,YAAY,IAAI,IAAI;IAKpB,aAAa,IAAI,IAAI;CAItB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAkC3D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/rpcFailover.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * RPC failover: automatic switch to a backup Solana RPC endpoint on
+ * infrastructure errors, with 120 s cooldown recovery to primary.
+ *
+ * Mirrors rust/src/rpc_failover.rs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcFailoverState = exports.ActiveRpc = exports.COOLDOWN_DURATION_MS = exports.FAST_RETRY_DELAY_MS = void 0;
+exports.isInfrastructureError = isInfrastructureError;
+exports.sleep = sleep;
+exports.FAST_RETRY_DELAY_MS = 100;
+exports.COOLDOWN_DURATION_MS = 120_000;
+var ActiveRpc;
+(function (ActiveRpc) {
+    ActiveRpc["Primary"] = "primary";
+    ActiveRpc["Backup"] = "backup";
+})(ActiveRpc || (exports.ActiveRpc = ActiveRpc = {}));
+class RpcFailoverState {
+    active = ActiveRpc.Primary;
+    flippedToBackupAt;
+    maybeRecoverToPrimary() {
+        if (this.active === ActiveRpc.Backup &&
+            this.flippedToBackupAt !== undefined) {
+            if (Date.now() - this.flippedToBackupAt >= exports.COOLDOWN_DURATION_MS) {
+                this.active = ActiveRpc.Primary;
+                this.flippedToBackupAt = undefined;
+            }
+        }
+    }
+    flipToBackup() {
+        this.active = ActiveRpc.Backup;
+        this.flippedToBackupAt = Date.now();
+    }
+    flipToPrimary() {
+        this.active = ActiveRpc.Primary;
+        this.flippedToBackupAt = undefined;
+    }
+}
+exports.RpcFailoverState = RpcFailoverState;
+function isInfrastructureError(err) {
+    if (err instanceof TypeError) {
+        const message = err.message.toLowerCase();
+        if (message.includes("fetch") ||
+            message.includes("network") ||
+            message.includes("failed")) {
+            return true;
+        }
+    }
+    if (err instanceof Error) {
+        const message = err.message.toLowerCase();
+        if (message.includes("timeout") || message.includes("timed out")) {
+            return true;
+        }
+        if (message.includes("502") ||
+            message.includes("503") ||
+            message.includes("504")) {
+            return true;
+        }
+        if (message.includes("econnrefused") ||
+            message.includes("econnreset") ||
+            message.includes("enotfound")) {
+            return true;
+        }
+    }
+    return false;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=rpcFailover.js.map

package/dist/rpcFailover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcFailover.js","sourceRoot":"","sources":["../src/rpcFailover.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAqCH,sDAkCC;AAED,sBAEC;AAzEY,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAC1B,QAAA,oBAAoB,GAAG,OAAO,CAAC;AAE5C,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,8BAAiB,CAAA;AACnB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAED,MAAa,gBAAgB;IAC3B,MAAM,GAAc,SAAS,CAAC,OAAO,CAAC;IAC9B,iBAAiB,CAAU;IAEnC,qBAAqB;QACnB,IACE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;YAChC,IAAI,CAAC,iBAAiB,KAAK,SAAS,EACpC,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,iBAAiB,IAAI,4BAAoB,EAAE,CAAC;gBAChE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;gBAChC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY;QACV,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAC/B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtC,CAAC;IAED,aAAa;QACX,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;IACrC,CAAC;CACF;AAzBD,4CAyBC;AAED,SAAgB,qBAAqB,CAAC,GAAY;IAChD,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1C,IACE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC1B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IACE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EACvB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IACE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC7B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["/**\n * RPC failover: automatic switch to a backup Solana RPC endpoint on\n * infrastructure errors, with 120 s cooldown recovery to primary.\n *\n * Mirrors rust/src/rpc_failover.rs.\n */\n\nexport const FAST_RETRY_DELAY_MS = 100;\nexport const COOLDOWN_DURATION_MS = 120_000;\n\nexport enum ActiveRpc {\n  Primary = \"primary\",\n  Backup = \"backup\",\n}\n\nexport class RpcFailoverState {\n  active: ActiveRpc = ActiveRpc.Primary;\n  private flippedToBackupAt?: number;\n\n  maybeRecoverToPrimary(): void {\n    if (\n      this.active === ActiveRpc.Backup &&\n      this.flippedToBackupAt !== undefined\n    ) {\n      if (Date.now() - this.flippedToBackupAt >= COOLDOWN_DURATION_MS) {\n        this.active = ActiveRpc.Primary;\n        this.flippedToBackupAt = undefined;\n      }\n    }\n  }\n\n  flipToBackup(): void {\n    this.active = ActiveRpc.Backup;\n    this.flippedToBackupAt = Date.now();\n  }\n\n  flipToPrimary(): void {\n    this.active = ActiveRpc.Primary;\n    this.flippedToBackupAt = undefined;\n  }\n}\n\nexport function isInfrastructureError(err: unknown): boolean {\n  if (err instanceof TypeError) {\n    const message = err.message.toLowerCase();\n    if (\n      message.includes(\"fetch\") ||\n      message.includes(\"network\") ||\n      message.includes(\"failed\")\n    ) {\n      return true;\n    }\n  }\n\n  if (err instanceof Error) {\n    const message = err.message.toLowerCase();\n    if (message.includes(\"timeout\") || message.includes(\"timed out\")) {\n      return true;\n    }\n    if (\n      message.includes(\"502\") ||\n      message.includes(\"503\") ||\n      message.includes(\"504\")\n    ) {\n      return true;\n    }\n    if (\n      message.includes(\"econnrefused\") ||\n      message.includes(\"econnreset\") ||\n      message.includes(\"enotfound\")\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/dist/shared/fmt/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const DISPLAY_DECIMAL_TIERS: readonly [readonly ["10000", 0], readonly ["1000", 1], readonly ["100", 2], readonly ["10", 3], readonly ["0.1", 4]];
+export declare const SMALL_VALUE_DECIMALS = 5;
+export declare function displayDecimalsBy(matchesTier: (threshold: string) => boolean): number;
+export declare function isFormattedZero(input: string): boolean;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/fmt/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/shared/fmt/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,sHAMxB,CAAC;AAEX,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAQrF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/shared/fmt/constants.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SMALL_VALUE_DECIMALS = exports.DISPLAY_DECIMAL_TIERS = void 0;
+exports.displayDecimalsBy = displayDecimalsBy;
+exports.isFormattedZero = isFormattedZero;
+exports.DISPLAY_DECIMAL_TIERS = [
+    ["10000", 0],
+    ["1000", 1],
+    ["100", 2],
+    ["10", 3],
+    ["0.1", 4],
+];
+exports.SMALL_VALUE_DECIMALS = 5;
+function displayDecimalsBy(matchesTier) {
+    for (const [threshold, decimals] of exports.DISPLAY_DECIMAL_TIERS) {
+        if (matchesTier(threshold)) {
+            return decimals;
+        }
+    }
+    return exports.SMALL_VALUE_DECIMALS;
+}
+function isFormattedZero(input) {
+    return /^-?0(?:\.0+)?$/.test(input);
+}
+//# sourceMappingURL=constants.js.map

package/dist/shared/fmt/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/shared/fmt/constants.ts"],"names":[],"mappings":";;;AAUA,8CAQC;AAED,0CAEC;AAtBY,QAAA,qBAAqB,GAAG;IACnC,CAAC,OAAO,EAAE,CAAC,CAAC;IACZ,CAAC,MAAM,EAAE,CAAC,CAAC;IACX,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,IAAI,EAAE,CAAC,CAAC;IACT,CAAC,KAAK,EAAE,CAAC,CAAC;CACF,CAAC;AAEE,QAAA,oBAAoB,GAAG,CAAC,CAAC;AAEtC,SAAgB,iBAAiB,CAAC,WAA2C;IAC3E,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,6BAAqB,EAAE,CAAC;QAC1D,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,4BAAoB,CAAC;AAC9B,CAAC;AAED,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC","sourcesContent":["export const DISPLAY_DECIMAL_TIERS = [\n  [\"10000\", 0],\n  [\"1000\", 1],\n  [\"100\", 2],\n  [\"10\", 3],\n  [\"0.1\", 4],\n] as const;\n\nexport const SMALL_VALUE_DECIMALS = 5;\n\nexport function displayDecimalsBy(matchesTier: (threshold: string) => boolean): number {\n  for (const [threshold, decimals] of DISPLAY_DECIMAL_TIERS) {\n    if (matchesTier(threshold)) {\n      return decimals;\n    }\n  }\n\n  return SMALL_VALUE_DECIMALS;\n}\n\nexport function isFormattedZero(input: string): boolean {\n  return /^-?0(?:\\.0+)?$/.test(input);\n}\n"]}

package/dist/shared/fmt/decimal.d.ts

@@ -1,5 +1,12 @@
 import Decimal from "decimal.js";
 export declare function display(value: Decimal): string;
 export declare function abbrNumber(value: Decimal, digits?: number, showSign?: boolean): string;
+/**
+ * Format a Decimal as a percentage with exactly 2 decimal places (truncated).
+ *
+ * When padding is true (default), always shows 2 decimal places (e.g. "12.30").
+ * When false, trailing zeros are trimmed (e.g. "12.3").
+ */
+export declare function displayPct(value: Decimal, padding?: boolean): string;
 export declare function toBaseUnits(value: Decimal, decimals: number): bigint | null;
 //# sourceMappingURL=decimal.d.ts.map

package/dist/shared/fmt/decimal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../../src/shared/fmt/decimal.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,YAAY,CAAC;AAGjC,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsB9C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,EAAE,QAAQ,UAAO,GAAG,MAAM,CAkB9E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3E"}
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../../src/shared/fmt/decimal.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,YAAY,CAAC;AAQjC,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI9C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,EAAE,QAAQ,UAAO,GAAG,MAAM,CAkB9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAWpE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3E"}

package/dist/shared/fmt/decimal.js

@@ -5,28 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.display = display;
 exports.abbrNumber = abbrNumber;
+exports.displayPct = displayPct;
 exports.toBaseUnits = toBaseUnits;
 const decimal_js_1 = __importDefault(require("decimal.js"));
+const constants_1 = require("./constants");
 const num_1 = require("./num");
+function displayDecimals(value) {
+    return (0, constants_1.displayDecimalsBy)((threshold) => value.greaterThanOrEqualTo(new decimal_js_1.default(threshold)));
+}
 function display(value) {
-    if (value.isZero()) {
-        return "0";
-    }
-    const abs = value.abs();
-    if (abs.greaterThanOrEqualTo(100)) {
-        return (0, num_1.displayFormattedString)(value.toDecimalPlaces(0).toString());
-    }
-    if (abs.greaterThanOrEqualTo(1)) {
-        return (0, num_1.displayFormattedString)(value.toDecimalPlaces(2).toString());
-    }
-    const asString = abs.toFixed(20).replace(/0+$/, "");
-    const match = /^0\.(0+)(\d+)/.exec(asString);
-    if (match && match[1].length > 5) {
-        const sign = value.isNegative() ? "-" : "";
-        const significant = match[2].slice(0, 4).replace(/0+$/, "");
-        return `${sign}0.0(${match[1].length})${significant || "0"}`;
-    }
-    return (0, num_1.displayFormattedString)(value.toSignificantDigits(8).toString());
+    const decimals = displayDecimals(value.abs());
+    const formatted = value.toFixed(decimals);
+    return (0, constants_1.isFormattedZero)(formatted) ? "0" : (0, num_1.displayFormattedString)(formatted);
 }
 function abbrNumber(value, digits = 2, showSign = true) {
     const sign = showSign && value.isNegative() ? "-" : "";
@@ -39,10 +29,28 @@ function abbrNumber(value, digits = 2, showSign = true) {
     ];
     for (const [threshold, suffix] of units) {
         if (abs.greaterThanOrEqualTo(threshold)) {
-            return `${sign}${abs.div(threshold).toDecimalPlaces(digits).toString()}${suffix}`;
+            return `${sign}${abs.div(threshold).toFixed(digits)}${suffix}`;
         }
     }
-    return `${sign}${abs.toDecimalPlaces(digits).toString()}`;
+    return `${sign}${abs.toFixed(digits)}`;
+}
+/**
+ * Format a Decimal as a percentage with exactly 2 decimal places (truncated).
+ *
+ * When padding is true (default), always shows 2 decimal places (e.g. "12.30").
+ * When false, trailing zeros are trimmed (e.g. "12.3").
+ */
+function displayPct(value, padding) {
+    const pad = padding ?? true;
+    const truncated = value.toDecimalPlaces(2, decimal_js_1.default.ROUND_DOWN);
+    if (pad) {
+        return (0, num_1.displayFormattedString)(truncated.toFixed(2));
+    }
+    else {
+        const formatted = truncated.toFixed(2);
+        const trimmed = formatted.replace(/\.?0+$/, "");
+        return (0, num_1.displayFormattedString)(trimmed);
+    }
 }
 function toBaseUnits(value, decimals) {
     const scaled = value.mul(new decimal_js_1.default(10).pow(decimals));

package/dist/shared/fmt/decimal.js.map

@@ -1 +1 @@
-{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../../../src/shared/fmt/decimal.ts"],"names":[],"mappings":"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","sourcesContent":["import Decimal from \"decimal.js\";\nimport { displayFormattedString } from \"./num\";\n\nexport function display(value: Decimal): string {\n  if (value.isZero()) {\n    return \"0\";\n  }\n\n  const abs = value.abs();\n  if (abs.greaterThanOrEqualTo(100)) {\n    return displayFormattedString(value.toDecimalPlaces(0).toString());\n  }\n  if (abs.greaterThanOrEqualTo(1)) {\n    return displayFormattedString(value.toDecimalPlaces(2).toString());\n  }\n\n  const asString = abs.toFixed(20).replace(/0+$/, \"\");\n  const match = /^0\\.(0+)(\\d+)/.exec(asString);\n  if (match && match[1].length > 5) {\n    const sign = value.isNegative() ? \"-\" : \"\";\n    const significant = match[2].slice(0, 4).replace(/0+$/, \"\");\n    return `${sign}0.0(${match[1].length})${significant || \"0\"}`;\n  }\n\n  return displayFormattedString(value.toSignificantDigits(8).toString());\n}\n\nexport function abbrNumber(value: Decimal, digits = 2, showSign = true): string {\n  const sign = showSign && value.isNegative() ? \"-\" : \"\";\n  const abs = value.abs();\n\n  const units: Array<[Decimal, string]> = [\n    [new Decimal(\"1000000000000\"), \"t\"],\n    [new Decimal(\"1000000000\"), \"b\"],\n    [new Decimal(\"1000000\"), \"m\"],\n    [new Decimal(\"1000\"), \"k\"],\n  ];\n\n  for (const [threshold, suffix] of units) {\n    if (abs.greaterThanOrEqualTo(threshold)) {\n      return `${sign}${abs.div(threshold).toDecimalPlaces(digits).toString()}${suffix}`;\n    }\n  }\n\n  return `${sign}${abs.toDecimalPlaces(digits).toString()}`;\n}\n\nexport function toBaseUnits(value: Decimal, decimals: number): bigint | null {\n  const scaled = value.mul(new Decimal(10).pow(decimals));\n  if (!scaled.isInteger() || scaled.isNegative()) {\n    return null;\n  }\n  return BigInt(scaled.toFixed(0));\n}\n"]}
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../../../src/shared/fmt/decimal.ts"],"names":[],"mappings":"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","sourcesContent":["import Decimal from \"decimal.js\";\nimport { displayDecimalsBy, isFormattedZero } from \"./constants\";\nimport { displayFormattedString } from \"./num\";\n\nfunction displayDecimals(value: Decimal): number {\n  return displayDecimalsBy((threshold) => value.greaterThanOrEqualTo(new Decimal(threshold)));\n}\n\nexport function display(value: Decimal): string {\n  const decimals = displayDecimals(value.abs());\n  const formatted = value.toFixed(decimals);\n  return isFormattedZero(formatted) ? \"0\" : displayFormattedString(formatted);\n}\n\nexport function abbrNumber(value: Decimal, digits = 2, showSign = true): string {\n  const sign = showSign && value.isNegative() ? \"-\" : \"\";\n  const abs = value.abs();\n\n  const units: Array<[Decimal, string]> = [\n    [new Decimal(\"1000000000000\"), \"t\"],\n    [new Decimal(\"1000000000\"), \"b\"],\n    [new Decimal(\"1000000\"), \"m\"],\n    [new Decimal(\"1000\"), \"k\"],\n  ];\n\n  for (const [threshold, suffix] of units) {\n    if (abs.greaterThanOrEqualTo(threshold)) {\n      return `${sign}${abs.div(threshold).toFixed(digits)}${suffix}`;\n    }\n  }\n\n  return `${sign}${abs.toFixed(digits)}`;\n}\n\n/**\n * Format a Decimal as a percentage with exactly 2 decimal places (truncated).\n *\n * When padding is true (default), always shows 2 decimal places (e.g. \"12.30\").\n * When false, trailing zeros are trimmed (e.g. \"12.3\").\n */\nexport function displayPct(value: Decimal, padding?: boolean): string {\n  const pad = padding ?? true;\n  const truncated = value.toDecimalPlaces(2, Decimal.ROUND_DOWN);\n\n  if (pad) {\n    return displayFormattedString(truncated.toFixed(2));\n  } else {\n    const formatted = truncated.toFixed(2);\n    const trimmed = formatted.replace(/\\.?0+$/, \"\");\n    return displayFormattedString(trimmed);\n  }\n}\n\nexport function toBaseUnits(value: Decimal, decimals: number): bigint | null {\n  const scaled = value.mul(new Decimal(10).pow(decimals));\n  if (!scaled.isInteger() || scaled.isNegative()) {\n    return null;\n  }\n  return BigInt(scaled.toFixed(0));\n}\n"]}