@ponder/react 0.14.12 → 0.15.0

package/dist/esm/checkpoint.js

@@ -0,0 +1,37 @@
+// 10 digits for unix timestamp gets us to the year 2277.
+const BLOCK_TIMESTAMP_DIGITS = 10;
+// Chain IDs are uint256. As of writing the largest Chain ID on https://chainlist.org
+// is 13 digits. 16 digits should be enough (JavaScript's max safe integer).
+const CHAIN_ID_DIGITS = 16;
+// Same logic as chain ID.
+const BLOCK_NUMBER_DIGITS = 16;
+// Same logic as chain ID.
+const TRANSACTION_INDEX_DIGITS = 16;
+// At time of writing, we only have 2 event types planned, so one digit (10 types) is enough.
+const EVENT_TYPE_DIGITS = 1;
+// This could contain log index, trace index, etc. 16 digits should be enough.
+const EVENT_INDEX_DIGITS = 16;
+export const decodeCheckpoint = (checkpoint) => {
+    let offset = 0;
+    const blockTimestamp = BigInt(checkpoint.slice(offset, offset + BLOCK_TIMESTAMP_DIGITS));
+    offset += BLOCK_TIMESTAMP_DIGITS;
+    const chainId = BigInt(checkpoint.slice(offset, offset + CHAIN_ID_DIGITS));
+    offset += CHAIN_ID_DIGITS;
+    const blockNumber = BigInt(checkpoint.slice(offset, offset + BLOCK_NUMBER_DIGITS));
+    offset += BLOCK_NUMBER_DIGITS;
+    const transactionIndex = BigInt(checkpoint.slice(offset, offset + TRANSACTION_INDEX_DIGITS));
+    offset += TRANSACTION_INDEX_DIGITS;
+    const eventType = +checkpoint.slice(offset, offset + EVENT_TYPE_DIGITS);
+    offset += EVENT_TYPE_DIGITS;
+    const eventIndex = BigInt(checkpoint.slice(offset, offset + EVENT_INDEX_DIGITS));
+    offset += EVENT_INDEX_DIGITS;
+    return {
+        blockTimestamp,
+        chainId,
+        blockNumber,
+        transactionIndex,
+        eventType,
+        eventIndex,
+    };
+};
+//# sourceMappingURL=checkpoint.js.map

package/dist/esm/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/checkpoint.ts"],"names":[],"mappings":"AASA,yDAAyD;AACzD,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,qFAAqF;AACrF,4EAA4E;AAC5E,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,0BAA0B;AAC1B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,0BAA0B;AAC1B,MAAM,wBAAwB,GAAG,EAAE,CAAC;AACpC,6FAA6F;AAC7F,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAkB,EAAc,EAAE;IACjE,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,MAAM,cAAc,GAAG,MAAM,CAC3B,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAAC,CAC1D,CAAC;IACF,MAAM,IAAI,sBAAsB,CAAC;IAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,eAAe,CAAC;IAE1B,MAAM,WAAW,GAAG,MAAM,CACxB,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAAC,CACvD,CAAC;IACF,MAAM,IAAI,mBAAmB,CAAC;IAE9B,MAAM,gBAAgB,GAAG,MAAM,CAC7B,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,CAAC,CAC5D,CAAC;IACF,MAAM,IAAI,wBAAwB,CAAC;IAEnC,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC;IACxE,MAAM,IAAI,iBAAiB,CAAC;IAE5B,MAAM,UAAU,GAAG,MAAM,CACvB,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAAC,CACtD,CAAC;IACF,MAAM,IAAI,kBAAkB,CAAC;IAE7B,OAAO;QACL,cAAc;QACd,OAAO;QACP,WAAW;QACX,gBAAgB;QAChB,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/hook.js

@@ -1,22 +1,31 @@
 "use client";
 import { useQuery, useQueryClient, } from "@tanstack/react-query";
 import { useContext, useEffect, useMemo } from "react";
+import { decodeCheckpoint } from "./checkpoint.js";
 import { PonderContext } from "./context.js";
 import { getPonderQueryOptions } from "./utils.js";
 export function usePonderQuery(params) {
+    const live = params.live ?? true;
     const queryClient = useQueryClient();
     const client = usePonderClient();
     // biome-ignore lint/correctness/useExhaustiveDependencies: <explanation>
     const queryOptions = useMemo(() => getPonderQueryOptions(client, params.queryFn), [params.queryFn]);
     // biome-ignore lint/correctness/useExhaustiveDependencies: <explanation>
     useEffect(() => {
-        const { unsubscribe } = client.live(() => Promise.resolve(), () => queryClient.invalidateQueries({ queryKey: queryOptions.queryKey }));
+        if (live === false)
+            return;
+        const { unsubscribe } = client.live(queryOptions.queryFn, (data) => {
+            queryClient.setQueryData(queryOptions.queryKey, data);
+        });
         return unsubscribe;
-    }, queryOptions.queryKey);
+    }, [...queryOptions.queryKey, live]);
     return useQuery({
         ...params,
         queryKey: queryOptions.queryKey,
         queryFn: queryOptions.queryFn,
+        staleTime: live
+            ? (params.staleTime ?? Number.POSITIVE_INFINITY)
+            : params.staleTime,
     });
 }
 export function usePonderClient() {
@@ -30,22 +39,23 @@ export function usePonderQueryOptions(queryFn) {
     const client = usePonderClient();
     return getPonderQueryOptions(client, queryFn);
 }
-const statusQueryKey = ["status"];
 export function usePonderStatus(params) {
-    const queryClient = useQueryClient();
-    const client = useContext(PonderContext);
-    if (client === undefined) {
-        throw new Error("PonderProvider not found");
-    }
-    // biome-ignore lint/correctness/useExhaustiveDependencies: <explanation>
-    useEffect(() => {
-        const { unsubscribe } = client.live(() => Promise.resolve(), () => queryClient.invalidateQueries({ queryKey: statusQueryKey }));
-        return unsubscribe;
-    }, []);
-    return useQuery({
+    return usePonderQuery({
         ...params,
-        queryKey: statusQueryKey,
-        queryFn: () => client.getStatus(),
+        queryFn: (db) => db.execute("SELECT * FROM _ponder_checkpoint"),
+        select(checkpoints) {
+            const status = {};
+            for (const { chain_name, chain_id, latest_checkpoint, } of checkpoints.sort((a, b) => (a.chain_id > b.chain_id ? 1 : -1))) {
+                status[chain_name] = {
+                    id: chain_id,
+                    block: {
+                        number: Number(decodeCheckpoint(latest_checkpoint).blockNumber),
+                        timestamp: Number(decodeCheckpoint(latest_checkpoint).blockTimestamp),
+                    },
+                };
+            }
+            return status;
+        },
     });
 }
 //# sourceMappingURL=hook.js.map

package/dist/esm/hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/hook.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAKL,QAAQ,EACR,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,UAAU,cAAc,CAK5B,MAE2E;IAE3E,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IAEjC,yEAAyE;IACzE,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EACnD,CAAC,MAAM,CAAC,OAAO,CAAC,CACjB,CAAC;IAEF,yEAAyE;IACzE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,IAAI,CACjC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EACvB,GAAG,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,CACzE,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE1B,OAAO,QAAQ,CAAC;QACd,GAAG,MAAM;QACT,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,OAAO,EAAE,YAAY,CAAC,OAAO;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;KAC7C;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAgD;IAKhD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,OAAO,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,UAAU,eAAe,CAC7B,MAA6D;IAE7D,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;KAC7C;IAED,yEAAyE;IACzE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,IAAI,CACjC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EACvB,GAAG,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAClE,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,QAAQ,CAAC;QACd,GAAG,MAAM;QACT,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;KAClC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/hook.ts"],"names":[],"mappings":"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"}