@varla/sdk 1.1.0 → 1.2.0

package/dist/events/decode.d.ts

@@ -0,0 +1,14 @@
+import type { AbiEvent, Log } from "viem";
+export type DecodedEvent<TArgs = Record<string, unknown>> = {
+    args: TArgs;
+    eventName: string;
+    log: Log;
+};
+/**
+ * Decode logs for a single event definition. Returns only successfully decoded entries.
+ */
+export declare function decodeEventLogs(params: {
+    event: AbiEvent;
+    logs: Log[];
+}): DecodedEvent[];
+//# sourceMappingURL=decode.d.ts.map

package/dist/events/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/events/decode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC1D,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,GAAG,CAAC;CACV,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAA;CAAE,GAAG,YAAY,EAAE,CAsBxF"}

package/dist/events/decode.js

@@ -0,0 +1,26 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+import { decodeEventLog } from "viem";
+/**
+ * Decode logs for a single event definition. Returns only successfully decoded entries.
+ */
+export function decodeEventLogs(params) {
+    const out = [];
+    for (const log of params.logs) {
+        try {
+            const decoded = decodeEventLog({
+                abi: [params.event],
+                data: log.data,
+                topics: log.topics,
+            });
+            out.push({
+                args: decoded.args,
+                eventName: decoded.eventName,
+                log,
+            });
+        }
+        catch {
+            // ignore logs that don't decode cleanly (RPCs can return unrelated logs when address is omitted)
+        }
+    }
+    return out;
+}

package/dist/events/defs.d.ts

@@ -0,0 +1,24 @@
+import type { AbiEvent } from "viem";
+export declare const ORACLE_EVENTS: {
+    readonly PositionConfigured: AbiEvent;
+    readonly OppositePositionsConfigured: AbiEvent;
+    readonly NegRiskPositionConfigured: AbiEvent;
+    readonly NegRiskPositionsBatchConfigured: AbiEvent;
+    readonly PriceUpdated: AbiEvent;
+    readonly PositionInvalidated: AbiEvent;
+    readonly PositionValidated: AbiEvent;
+};
+export declare const CORE_EVENTS: {
+    readonly Deposit: AbiEvent;
+    readonly Withdraw: AbiEvent;
+    readonly Borrow: AbiEvent;
+    readonly Repay: AbiEvent;
+    readonly Liquidate: AbiEvent;
+    readonly LiquidationDebtRepaid: AbiEvent;
+};
+export declare const POOL_EVENTS: {
+    readonly Draw: AbiEvent;
+    readonly Repay: AbiEvent;
+    readonly AccrueInterest: AbiEvent;
+};
+//# sourceMappingURL=defs.d.ts.map

package/dist/events/defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.d.ts","sourceRoot":"","sources":["../../src/events/defs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AASrC,eAAO,MAAM,aAAa;iCAIlB,QAAQ;0CAIR,QAAQ;wCAIR,QAAQ;8CAIR,QAAQ;2BAIR,QAAQ;kCAIR,QAAQ;gCAIR,QAAQ;CACN,CAAC;AAMX,eAAO,MAAM,WAAW;sBAC+C,QAAQ;uBACN,QAAQ;qBACZ,QAAQ;oBACV,QAAQ;wBACA,QAAQ;oCAI3E,QAAQ;CACN,CAAC;AAMX,eAAO,MAAM,WAAW;mBACyC,QAAQ;oBACN,QAAQ;6BAInE,QAAQ;CACN,CAAC"}

package/dist/events/defs.js

@@ -0,0 +1,61 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+import { getAbiItem } from "viem";
+import { abis } from "../generated.js";
+// ---------------------------------------------------------------------------
+// Oracle
+// ---------------------------------------------------------------------------
+export const ORACLE_EVENTS = {
+    PositionConfigured: getAbiItem({
+        abi: abis.VARLAORACLE_ABI,
+        name: "PositionConfigured",
+    }),
+    OppositePositionsConfigured: getAbiItem({
+        abi: abis.VARLAORACLE_ABI,
+        name: "OppositePositionsConfigured",
+    }),
+    NegRiskPositionConfigured: getAbiItem({
+        abi: abis.VARLAORACLE_ABI,
+        name: "NegRiskPositionConfigured",
+    }),
+    NegRiskPositionsBatchConfigured: getAbiItem({
+        abi: abis.VARLAORACLE_ABI,
+        name: "NegRiskPositionsBatchConfigured",
+    }),
+    PriceUpdated: getAbiItem({
+        abi: abis.VARLAORACLE_ABI,
+        name: "PriceUpdated",
+    }),
+    PositionInvalidated: getAbiItem({
+        abi: abis.VARLAORACLE_ABI,
+        name: "PositionInvalidated",
+    }),
+    PositionValidated: getAbiItem({
+        abi: abis.VARLAORACLE_ABI,
+        name: "PositionValidated",
+    }),
+};
+// ---------------------------------------------------------------------------
+// Core
+// ---------------------------------------------------------------------------
+export const CORE_EVENTS = {
+    Deposit: getAbiItem({ abi: abis.VARLACORE_ABI, name: "Deposit" }),
+    Withdraw: getAbiItem({ abi: abis.VARLACORE_ABI, name: "Withdraw" }),
+    Borrow: getAbiItem({ abi: abis.VARLACORE_ABI, name: "Borrow" }),
+    Repay: getAbiItem({ abi: abis.VARLACORE_ABI, name: "Repay" }),
+    Liquidate: getAbiItem({ abi: abis.VARLACORE_ABI, name: "Liquidate" }),
+    LiquidationDebtRepaid: getAbiItem({
+        abi: abis.VARLACORE_ABI,
+        name: "LiquidationDebtRepaid",
+    }),
+};
+// ---------------------------------------------------------------------------
+// Pool
+// ---------------------------------------------------------------------------
+export const POOL_EVENTS = {
+    Draw: getAbiItem({ abi: abis.VARLAPOOL_ABI, name: "Draw" }),
+    Repay: getAbiItem({ abi: abis.VARLAPOOL_ABI, name: "Repay" }),
+    AccrueInterest: getAbiItem({
+        abi: abis.VARLAPOOL_ABI,
+        name: "AccrueInterest",
+    }),
+};

package/dist/events/index.d.ts

@@ -1,3 +1,6 @@
 export * from "./logs.js";
+export * from "./defs.js";
+export * from "./decode.js";
+export * from "./recent.js";
 export * from "./oracleRegistrySync.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}

package/dist/events/index.js

@@ -1,3 +1,6 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 export * from "./logs.js";
+export * from "./defs.js";
+export * from "./decode.js";
+export * from "./recent.js";
 export * from "./oracleRegistrySync.js";

package/dist/events/oracleRegistrySync.d.ts

@@ -1,17 +1,16 @@
 import type { Address, PublicClient } from "viem";
 /**
- * Minimal, production-friendly registry sync for VarlaOracle.
+ * Production-friendly registry sync for VarlaOracle.
  *
- * Design goals:
- * - Event-driven discovery of configured positionIds.
- * - Follow-up hydration via multicall (reuses Phase 2 batching).
- *
- * Note: `configurePositionsBatch` emits `PositionConfigured` per position.
+ * - Discovers configured `positionIds` from `PositionConfigured` events.
+ * - Optionally enriches opposites / negRisk info from events (cheap), then hydrates
+ *   canonical state from contract views via multicall.
  */
 export type OracleRegistryEntry = {
     positionId: bigint;
     conditionId: `0x${string}`;
     resolutionTime: bigint;
+    riskTier: number;
     isNegRisk: boolean;
     negRiskMarketId: `0x${string}`;
     oppositePositionId: bigint;
@@ -21,6 +20,7 @@ export type SyncOracleRegistryViaEventsParams = {
     oracleAddress: Address;
     fromBlock: bigint;
     toBlock: bigint;
+    /** Max number of blocks per request. */
     blockRange?: bigint;
     multicallChunkSize?: number;
     /** Limit how many discovered ids to hydrate (useful for testing). */

package/dist/events/oracleRegistrySync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oracleRegistrySync.d.ts","sourceRoot":"","sources":["../../src/events/oracleRegistrySync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAOlD;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC,CA+FpE"}
+{"version":3,"file":"oracleRegistrySync.d.ts","sourceRoot":"","sources":["../../src/events/oracleRegistrySync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAQlD;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAcF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC,CAwJpE"}

package/dist/events/oracleRegistrySync.js

@@ -1,39 +1,84 @@
 // Note: explicit .js extension is required for Node ESM resolution.
-import { decodeEventLog, getAbiItem } from "viem";
 import { multicallChunks } from "../batch.js";
 import { abis } from "../generated.js";
+import { decodeEventLogs } from "./decode.js";
+import { ORACLE_EVENTS } from "./defs.js";
 import { getEventLogsChunked } from "./logs.js";
+function uniqBigints(values) {
+    const set = new Set();
+    const out = [];
+    for (const v of values) {
+        const k = v.toString();
+        if (set.has(k))
+            continue;
+        set.add(k);
+        out.push(v);
+    }
+    return out;
+}
 export async function syncOracleRegistryViaEvents(params) {
     const abi = abis.VARLAORACLE_ABI;
-    const item = getAbiItem({ abi, name: "PositionConfigured" });
-    const logs = await getEventLogsChunked({
+    // ---------------------------------------------------------------------------
+    // 1) Discover ids (PositionConfigured)
+    // ---------------------------------------------------------------------------
+    const configuredLogs = await getEventLogsChunked({
         client: params.client,
         address: params.oracleAddress,
-        event: item,
+        event: ORACLE_EVENTS.PositionConfigured,
         fromBlock: params.fromBlock,
         toBlock: params.toBlock,
         blockRange: params.blockRange,
     });
-    const set = new Set();
-    const ids = [];
-    for (const l of logs) {
-        const decoded = decodeEventLog({
-            abi: [item],
-            data: l.data,
-            topics: l.topics,
+    const configuredDecoded = decodeEventLogs({
+        event: ORACLE_EVENTS.PositionConfigured,
+        logs: configuredLogs,
+    });
+    let ids = uniqBigints(configuredDecoded.map((d) => d.args.positionId));
+    if (params.maxIds)
+        ids = ids.slice(0, params.maxIds);
+    if (ids.length === 0)
+        return { positionIds: [], entries: [] };
+    // ---------------------------------------------------------------------------
+    // 2) Optional enrichment from events (non-authoritative)
+    // ---------------------------------------------------------------------------
+    const oppositeById = new Map();
+    {
+        const logs = await getEventLogsChunked({
+            client: params.client,
+            address: params.oracleAddress,
+            event: ORACLE_EVENTS.OppositePositionsConfigured,
+            fromBlock: params.fromBlock,
+            toBlock: params.toBlock,
+            blockRange: params.blockRange,
         });
-        const pid = decoded.args.positionId;
-        const key = pid.toString();
-        if (!set.has(key)) {
-            set.add(key);
-            ids.push(pid);
-            if (params.maxIds && ids.length >= params.maxIds)
-                break;
+        const decoded = decodeEventLogs({ event: ORACLE_EVENTS.OppositePositionsConfigured, logs });
+        for (const d of decoded) {
+            const yes = d.args.yesPositionId;
+            const no = d.args.noPositionId;
+            oppositeById.set(yes.toString(), no);
+            oppositeById.set(no.toString(), yes);
         }
     }
-    if (ids.length === 0)
-        return { positionIds: [], entries: [] };
-    const chunkSize = params.multicallChunkSize ?? 128;
+    const negRiskMarketById = new Map();
+    {
+        const logs = await getEventLogsChunked({
+            client: params.client,
+            address: params.oracleAddress,
+            event: ORACLE_EVENTS.NegRiskPositionConfigured,
+            fromBlock: params.fromBlock,
+            toBlock: params.toBlock,
+            blockRange: params.blockRange,
+        });
+        const decoded = decodeEventLogs({ event: ORACLE_EVENTS.NegRiskPositionConfigured, logs });
+        for (const d of decoded) {
+            const pid = d.args.positionId;
+            const marketId = d.args.marketId;
+            negRiskMarketById.set(pid.toString(), marketId);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // 3) Hydrate canonical state from views (authoritative)
+    // ---------------------------------------------------------------------------
     const calls = ids.flatMap((pid) => [
         {
             address: params.oracleAddress,
@@ -47,6 +92,12 @@ export async function syncOracleRegistryViaEvents(params) {
             functionName: "getResolutionTime",
             args: [pid],
         },
+        {
+            address: params.oracleAddress,
+            abi,
+            functionName: "getRiskTier",
+            args: [pid],
+        },
         {
             address: params.oracleAddress,
             abi,
@@ -66,27 +117,40 @@ export async function syncOracleRegistryViaEvents(params) {
             args: [pid],
         },
     ]);
-    const res = await multicallChunks({ client: params.client, contracts: calls, chunkSize });
+    const chunkSize = params.multicallChunkSize ?? 128;
+    const res = await multicallChunks({
+        client: params.client,
+        contracts: calls,
+        chunkSize,
+    });
     const entries = [];
-    // 5 results per pid.
     for (let i = 0; i < ids.length; i++) {
-        const base = i * 5;
+        const base = i * 6;
         const r0 = res[base + 0];
         const r1 = res[base + 1];
         const r2 = res[base + 2];
         const r3 = res[base + 3];
         const r4 = res[base + 4];
-        for (const r of [r0, r1, r2, r3, r4]) {
-            if (r.status !== "success")
+        const r5 = res[base + 5];
+        for (const r of [r0, r1, r2, r3, r4, r5]) {
+            if (r.status !== "success") {
                 throw new Error(`Oracle registry multicall failed: ${String(r.error)}`);
+            }
         }
+        const pid = ids[i];
+        const pidKey = pid.toString();
+        // Prefer on-chain view results (authoritative), but fall back to event-enriched values
+        // if they look more complete.
+        const opposite = r3.result || (oppositeById.get(pidKey) ?? 0n);
+        const market = r5.result || (negRiskMarketById.get(pidKey) ?? "0x" + "0".repeat(64));
         entries.push({
-            positionId: ids[i],
+            positionId: pid,
             conditionId: r0.result,
             resolutionTime: r1.result,
-            oppositePositionId: r2.result,
-            isNegRisk: r3.result,
-            negRiskMarketId: r4.result,
+            riskTier: Number(r2.result),
+            oppositePositionId: opposite,
+            isNegRisk: r4.result,
+            negRiskMarketId: market,
         });
     }
     return { positionIds: ids, entries };

package/dist/events/recent.d.ts

@@ -0,0 +1,19 @@
+import type { Address, AbiEvent, PublicClient } from "viem";
+export type GetRecentEventsParams = {
+    client: PublicClient;
+    address: Address;
+    event: AbiEvent;
+    /** Look back N blocks from the current head. */
+    lookbackBlocks?: bigint;
+    /** Chunk size for log fetching. */
+    blockRange?: bigint;
+};
+/**
+ * Frontend-friendly helper: fetch and decode recent events by looking back from head.
+ */
+export declare function getRecentEvents(params: GetRecentEventsParams): Promise<{
+    fromBlock: bigint;
+    toBlock: bigint;
+    decoded: import("./decode.js").DecodedEvent<Record<string, unknown>>[];
+}>;
+//# sourceMappingURL=recent.d.ts.map

package/dist/events/recent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent.d.ts","sourceRoot":"","sources":["../../src/events/recent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAO,MAAM,MAAM,CAAC;AAKjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB;;;;GAmBlE"}

package/dist/events/recent.js

@@ -0,0 +1,24 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+import { getEventLogsChunked } from "./logs.js";
+import { decodeEventLogs } from "./decode.js";
+/**
+ * Frontend-friendly helper: fetch and decode recent events by looking back from head.
+ */
+export async function getRecentEvents(params) {
+    const head = await params.client.getBlockNumber();
+    const lookback = params.lookbackBlocks ?? 2000n;
+    const fromBlock = head > lookback ? head - lookback : 0n;
+    const logs = await getEventLogsChunked({
+        client: params.client,
+        address: params.address,
+        event: params.event,
+        fromBlock,
+        toBlock: head,
+        blockRange: params.blockRange,
+    });
+    return {
+        fromBlock,
+        toBlock: head,
+        decoded: decodeEventLogs({ event: params.event, logs }),
+    };
+}

package/dist/format.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Format a WAD (1e18) fixed-point value into a decimal string.
+ *
+ * - No scientific notation.
+ * - Trims trailing zeros.
+ * - If `fractionDigits` is provided, it rounds HALF UP to that many digits.
+ */
+export declare function formatWad(wad: bigint, params?: {
+    decimals?: number;
+    fractionDigits?: number;
+}): string;
+/**
+ * Format BPS (1e4 = 100%) as a percentage string.
+ *
+ * Example:
+ * - 1500 -> "15%"
+ * - 1234 -> "12.34%"
+ */
+export declare function formatBps(bps: bigint | number): string;
+/**
+ * Format a price with 8 decimals (1e8 = 1.00) into a decimal string.
+ *
+ * Returns numbers only (no "$" prefix).
+ */
+export declare function formatPriceE8(priceE8: bigint, params?: {
+    fractionDigits?: number;
+}): string;
+/**
+ * Parse a decimal string into a bigint with `decimals` fixed-point precision.
+ *
+ * - Accepts "123", "123.", "123.45"
+ * - Rejects commas and scientific notation.
+ */
+export declare function parseUnits(input: string, decimals: number): bigint;
+export declare function parseWad(input: string, decimals?: number): bigint;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAYtD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBlE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAE7D"}

package/dist/format.js

@@ -0,0 +1,109 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+/**
+ * Format a WAD (1e18) fixed-point value into a decimal string.
+ *
+ * - No scientific notation.
+ * - Trims trailing zeros.
+ * - If `fractionDigits` is provided, it rounds HALF UP to that many digits.
+ */
+export function formatWad(wad, params) {
+    const decimals = params?.decimals ?? 18;
+    const fractionDigits = params?.fractionDigits;
+    return formatUnits(wad, decimals, fractionDigits);
+}
+/**
+ * Format BPS (1e4 = 100%) as a percentage string.
+ *
+ * Example:
+ * - 1500 -> "15%"
+ * - 1234 -> "12.34%"
+ */
+export function formatBps(bps) {
+    const b = typeof bps === "bigint" ? bps : BigInt(bps);
+    // percent = bps / 100
+    const sign = b < 0n ? "-" : "";
+    const v = b < 0n ? -b : b;
+    const int = v / 100n;
+    const frac = v % 100n;
+    if (frac === 0n)
+        return `${sign}${int}%`;
+    const fracStr = frac.toString().padStart(2, "0");
+    // trim trailing zeros
+    const trimmed = fracStr.replace(/0+$/, "");
+    return `${sign}${int}.${trimmed}%`;
+}
+/**
+ * Format a price with 8 decimals (1e8 = 1.00) into a decimal string.
+ *
+ * Returns numbers only (no "$" prefix).
+ */
+export function formatPriceE8(priceE8, params) {
+    return formatUnits(priceE8, 8, params?.fractionDigits);
+}
+/**
+ * Parse a decimal string into a bigint with `decimals` fixed-point precision.
+ *
+ * - Accepts "123", "123.", "123.45"
+ * - Rejects commas and scientific notation.
+ */
+export function parseUnits(input, decimals) {
+    const s = input.trim();
+    if (s.length === 0)
+        throw new Error("Empty input");
+    if (!Number.isInteger(decimals) || decimals < 0)
+        throw new Error("Invalid decimals");
+    if (!/^[+-]?\d*(?:\.\d*)?$/.test(s)) {
+        throw new Error(`Invalid decimal string: ${input}`);
+    }
+    const sign = s.startsWith("-") ? -1n : 1n;
+    const unsigned = s.startsWith("-") || s.startsWith("+") ? s.slice(1) : s;
+    const [intPartRaw, fracPartRaw = ""] = unsigned.split(".");
+    const intPart = intPartRaw.length ? intPartRaw : "0";
+    const fracPart = fracPartRaw;
+    if (fracPart.length > decimals) {
+        // We intentionally do NOT round in parse. Callers can round before parsing.
+        throw new Error(`Too many decimals (max ${decimals})`);
+    }
+    const fracPadded = fracPart.padEnd(decimals, "0");
+    const combined = `${intPart}${fracPadded}`.replace(/^0+(?=\d)/, "");
+    const v = combined.length ? BigInt(combined) : 0n;
+    return sign * v;
+}
+export function parseWad(input, decimals = 18) {
+    return parseUnits(input, decimals);
+}
+// -----------------
+// Internal helpers
+// -----------------
+function formatUnits(value, decimals, fractionDigits) {
+    if (!Number.isInteger(decimals) || decimals < 0)
+        throw new Error("Invalid decimals");
+    const sign = value < 0n ? "-" : "";
+    let v = value < 0n ? -value : value;
+    // Optional rounding to fractionDigits
+    if (fractionDigits !== undefined) {
+        if (!Number.isInteger(fractionDigits) || fractionDigits < 0) {
+            throw new Error("Invalid fractionDigits");
+        }
+        if (fractionDigits < decimals) {
+            const drop = decimals - fractionDigits;
+            const base = 10n ** BigInt(drop);
+            const half = base / 2n;
+            // half-up rounding
+            v = (v + half) / base;
+            // Now v is in units of 10^fractionDigits
+            decimals = fractionDigits;
+        }
+    }
+    const base = 10n ** BigInt(decimals);
+    const int = v / base;
+    const frac = v % base;
+    if (decimals === 0)
+        return `${sign}${int}`;
+    let fracStr = frac.toString().padStart(decimals, "0");
+    // Trim trailing zeros
+    fracStr = fracStr.replace(/0+$/, "");
+    if (fracStr.length === 0)
+        return `${sign}${int}`;
+    return `${sign}${int}.${fracStr}`;
+}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./types.js";
 export * from "./contracts.js";
 export * from "./views/index.js";
+export * from "./format.js";
 export * from "./events/index.js";
 export * from "./batch.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAG3B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAG3B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,aAAa,CAAC;AAG5B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -4,6 +4,8 @@ export * from "./types.js";
 export * from "./contracts.js";
 // Higher-level read helpers (views/facades).
 export * from "./views/index.js";
+// Pure formatting helpers (no chain calls).
+export * from "./format.js";
 // Indexer/event helpers.
 export * from "./events/index.js";
 // Low-level batching utilities (multicall chunking).