@bananapus/nana-sdk-core 2.21.0 → 2.22.0

package/dist/cjs/review/relayr.d.ts

@@ -1,4 +1,5 @@
 import { type Address, type Hex, type PublicClient, type TransactionReceipt } from "viem";
+import { erc2771ForwarderAbi } from "../generated/juicebox.js";
 /** Relayr's HTTP API. */
 export declare const RELAYR_API = "https://api.relayr.ba5ed.com";
 /**
@@ -448,5 +449,204 @@ export declare function verifyRelayrDestinations(clientFor: (chainId: number) =>
     records: readonly RelayrTransactionRecord[];
     account?: Address;
 }): Promise<RelayrVerifiedDestination[]>;
+/**
+ * The reads that classify signed forward requests at a canonical finalized
+ * block. Typed by the fields they read, so a PublicClient for any chain, with
+ * that chain's formatters, satisfies it.
+ */
+export type RelayrFinalizedClient = {
+    getBlock(args: {
+        blockTag: "finalized";
+    }): Promise<{
+        number: bigint | null;
+        hash: Hex | null;
+        timestamp: bigint;
+    }>;
+    getBlock(args: {
+        blockNumber: bigint;
+    }): Promise<{
+        hash: Hex | null;
+    }>;
+    readContract(args: {
+        address: Address;
+        abi: typeof erc2771ForwarderAbi;
+        functionName: "nonces";
+        args: readonly [Address];
+        blockNumber: bigint;
+    }): Promise<bigint>;
+};
+/**
+ * A signed forward request as these rules read it: its chain, its signer (the
+ * request's `from`, whose forwarder nonce it uses), its deadline in seconds,
+ * and the forwarder nonce it was signed with, when that was saved.
+ */
+export type RelayrSignedRequest = {
+    chainId: number;
+    signer: Address;
+    deadline: number | bigint;
+    nonce?: string | bigint;
+};
+/**
+ * One signed request at a canonical finalized block on its chain (ruling
+ * R114). It is dead once the forwarder's nonce for its signer moved past the
+ * nonce it was signed with (it, or another request at that nonce, may have
+ * run), or once its deadline is strictly earlier than that block's timestamp.
+ * `unused`: the nonce still equals the saved one. Anything unknown is live: a
+ * failed read, a node without a finalized block, a block no longer canonical,
+ * and a request saved without its nonce until its deadline passes.
+ */
+export type RelayrRequestState = {
+    live: true;
+    deadline: number;
+} | {
+    live: false;
+    mayHaveRun: boolean;
+    unused: boolean;
+};
+/**
+ * What a set of requests allows together (ruling R114). While any one is live
+ * the set holds until `until`, the deadline of its last live request.
+ * `mayHaveRun` says whether a dead one's nonce moved or was never saved, and,
+ * once every one is dead, `unused` whether there is at least one and every
+ * nonce still equals the saved one.
+ */
+export type RelayrRequestsVerdict = {
+    live: true;
+    until: number;
+    mayHaveRun: boolean;
+} | {
+    live: false;
+    mayHaveRun: boolean;
+    unused: boolean;
+};
+/**
+ * Why a session whose requests are all dead can be discarded (ruling R114):
+ *
+ * - `ran`: a request's nonce moved past the one it was signed with, or the
+ *   session saved no nonces, so one may have run;
+ * - `changed`: none ran, and the action's recheck refuses its calls;
+ * - `expired`: none ran, and no recheck could run, as in an account view. The
+ *   action itself still signs them again at their saved nonces.
+ */
+export type RelayrDiscardReason = "ran" | "changed" | "expired";
+/**
+ * What a session whose bundle won't run as signed does next, from its
+ * requests' verdict (rulings R104 and R114). Discard ends only the session,
+ * never what the action saved.
+ *
+ * - `hold`: a request can still run and one may already have run. No new
+ *   signature, no new quote and no Discard until `until`.
+ * - `refresh`: a request can still run and none moved (R114 (a)). Until
+ *   `until`, the session may quote or pay its saved requests again while they
+ *   still verify and the action's recheck passes, or sign each again at its
+ *   saved nonce, in `nonces` (null when it saved none): the forwarder runs one
+ *   request per nonce, so an old request and its refresh never both run. A
+ *   signature at any other nonce waits until every request is dead.
+ * - `re-sign`: every request is dead and unused, and the recheck passed: sign
+ *   the calls again at `nonces` (R104).
+ * - `discard`: every request is dead; Discard for `reason`. With `changed`,
+ *   `error` is the recheck's refusal.
+ * - `reorg-hold`: every request is dead and none moved, but a finalized nonce
+ *   is below a saved one (a reorg dropped an earlier forwarded transaction),
+ *   or there are no saved nonces to sign at (`nonces` omitted or empty), or
+ *   there were no requests. It holds until the nonce catches up.
+ * - `unchecked`: the recheck failed because the node could not answer (ruling
+ *   R118): its cause chain holds a transport or JSON-RPC failure, or a revert
+ *   without revert data, and no revert data. That decides nothing. Try again.
+ *
+ * `error` is never enumerable, so no JSON or log of an outcome shows it: an
+ * RPC error's URL can carry a key.
+ */
+export type RelayrSessionOutcome = {
+    kind: "hold";
+    until: number;
+} | {
+    kind: "refresh";
+    until: number;
+    nonces: string[] | null;
+} | {
+    kind: "re-sign";
+    nonces: string[];
+} | {
+    kind: "discard";
+    reason: RelayrDiscardReason;
+    error?: unknown;
+} | {
+    kind: "reorg-hold";
+} | {
+    kind: "unchecked";
+    error: unknown;
+};
+/**
+ * `read` at the chain's finalized block, with that block's timestamp, once
+ * the block at its number still has the same hash after the read. Null while
+ * any of it cannot be read: a node without the finalized tag, an RPC error, a
+ * malformed block, or a block that is no longer canonical.
+ */
+export declare function atCanonicalFinalizedBlock<T>(client: Pick<RelayrFinalizedClient, "getBlock">, read: (blockNumber: bigint) => Promise<T>): Promise<{
+    value: T;
+    timestamp: bigint;
+} | null>;
+/**
+ * The requests a session published, each read from its entry (an `execute`
+ * on its chain's canonical forwarder, as {@link relayrForwardRequest} reads
+ * it), with the nonce it was signed with when `nonces` has one for every
+ * entry. Null when there are none, or one is not such a request: requests
+ * that can't be read can't be classified, so they never count as dead.
+ */
+export declare function relayrSignedRequests(entries: readonly Pick<RelayrEntry, "chain" | "target" | "data">[] | undefined, nonces?: readonly (string | bigint)[]): RelayrSignedRequest[] | null;
+/**
+ * The one classification of signed forward requests (ruling R114): each at a
+ * canonical finalized block on its chain, read once per chain and signer with
+ * `clientFor(chainId)`. Never throws for a chain it cannot read: its requests
+ * are live.
+ */
+export declare function relayrRequestStates(clientFor: (chainId: number) => RelayrFinalizedClient | undefined, requests: readonly RelayrSignedRequest[]): Promise<RelayrRequestState[]>;
+/**
+ * What `states` allow together. No states are neither run nor unused, so a
+ * session with none holds.
+ */
+export declare function relayrRequestsVerdict(states: readonly RelayrRequestState[]): RelayrRequestsVerdict;
+/**
+ * Ruling R117: whether every request is dead at a canonical finalized block
+ * on its chain, anything unknown counting as live. A saved session reserves
+ * its signers' forwarder nonces on its chains exactly while one of its
+ * requests is live, never by a device clock or a quote's expiry. Requests that
+ * can't be classified (null) or none at all are never dead.
+ */
+export declare function relayrRequestsDead(clientFor: (chainId: number) => RelayrFinalizedClient | undefined, requests: readonly RelayrSignedRequest[] | null | undefined): Promise<boolean>;
+/**
+ * Whether the chain's finalized block, still canonical, is past `deadline`
+ * (seconds, as a safe integer, decimal or 0x-hex digits, or a bigint): its
+ * timestamp is later. False while that is unknown, or the deadline can't be
+ * read.
+ */
+export declare function relayrDeadlinePassed(client: Pick<RelayrFinalizedClient, "getBlock">, deadline: number | string | bigint): Promise<boolean>;
+/** Whether `value` is a {@link RelayrDiscardReason}, for a reason read back from storage. */
+export declare function isRelayrDiscardReason(value: unknown): value is RelayrDiscardReason;
+/**
+ * What a session does next from its requests' `verdict` (see
+ * {@link RelayrSessionOutcome}), which was classified before the action's own
+ * recheck, since a request that ran would make the recheck refuse.
+ *
+ * `nonces` must be the saved nonces of exactly the requests that were
+ * classified into `verdict`, in the same order: `refresh` and `re-sign` hand
+ * them back to sign at, and nothing here can check them against the verdict.
+ * Without them (omitted, empty or not a list), a session whose requests are
+ * all dead and unused holds as `reorg-hold`, and is neither discarded nor
+ * signed again.
+ *
+ * `recheck`, the action's proof that its calls still apply, resolves when
+ * they do and throws when they don't; a value it resolves with is never read.
+ * It runs only once every request is dead and unused. Without one, as in an
+ * account view, such a session can be discarded as `expired`. A recheck that
+ * fails because the node could not answer decides nothing. Known limit: a
+ * reorg that drops an earlier forwarded transaction can leave a finalized
+ * nonce below a saved one, and the session holds until the nonce catches up.
+ */
+export declare function relayrSessionOutcome(verdict: RelayrRequestsVerdict, { nonces, recheck, }?: {
+    nonces?: readonly string[] | null;
+    recheck?: () => Promise<void>;
+}): Promise<RelayrSessionOutcome>;
 export {};
 //# sourceMappingURL=relayr.d.ts.map

package/dist/cjs/review/relayr.d.ts.map

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

package/dist/cjs/review/relayr.js

@@ -23,6 +23,14 @@ exports.requireRelayrPaymentRetry = requireRelayrPaymentRetry;
 exports.requireRelayrBundleUnpaid = requireRelayrBundleUnpaid;
 exports.verifyRelayrDestination = verifyRelayrDestination;
 exports.verifyRelayrDestinations = verifyRelayrDestinations;
+exports.atCanonicalFinalizedBlock = atCanonicalFinalizedBlock;
+exports.relayrSignedRequests = relayrSignedRequests;
+exports.relayrRequestStates = relayrRequestStates;
+exports.relayrRequestsVerdict = relayrRequestsVerdict;
+exports.relayrRequestsDead = relayrRequestsDead;
+exports.relayrDeadlinePassed = relayrDeadlinePassed;
+exports.isRelayrDiscardReason = isRelayrDiscardReason;
+exports.relayrSessionOutcome = relayrSessionOutcome;
 const viem_1 = require("viem");
 const juicebox_js_1 = require("../generated/juicebox.js");
 const untrusted_js_1 = require("../untrusted.js");
@@ -150,15 +158,19 @@ class RelayrPaymentRetryError extends Error {
     }
 }
 exports.RelayrPaymentRetryError = RelayrPaymentRetryError;
-/** `error` with `cause` set like a native error cause, but on ES2021 and never enumerable: an RPC error's URL can carry a key. */
-function withCause(error, cause) {
-    Object.defineProperty(error, "cause", {
-        value: cause,
+/** `target` with `key` set to `value`, writable but never enumerable: an RPC error's URL can carry a key, and no JSON or log may show it. */
+function withHidden(target, key, value) {
+    Object.defineProperty(target, key, {
+        value,
         writable: true,
         enumerable: false,
         configurable: true,
     });
-    return error;
+    return target;
+}
+/** `error` with `cause` set like a native error cause, but on ES2021 and never enumerable: an RPC error's URL can carry a key. */
+function withCause(error, cause) {
+    return withHidden(error, "cause", cause);
 }
 function errorWithCause(message, cause) {
     return withCause(new Error(message), cause);
@@ -988,4 +1000,247 @@ async function verifyRelayrDestinations(clientFor, { bindings, records, account,
     }
     return verified;
 }
+/**
+ * `read` at the chain's finalized block, with that block's timestamp, once
+ * the block at its number still has the same hash after the read. Null while
+ * any of it cannot be read: a node without the finalized tag, an RPC error, a
+ * malformed block, or a block that is no longer canonical.
+ */
+async function atCanonicalFinalizedBlock(client, read) {
+    try {
+        const { number, hash, timestamp } = await client.getBlock({
+            blockTag: "finalized",
+        });
+        if (typeof number !== "bigint" ||
+            !(0, untrusted_js_1.isBytes32)(hash) ||
+            typeof timestamp !== "bigint") {
+            return null;
+        }
+        const value = await read(number);
+        const canonical = await client.getBlock({ blockNumber: number });
+        return canonical.hash === hash ? { value, timestamp } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The nonce the canonical forwarder on `chainId` expects next from `signer`
+ * at the chain's finalized block, still canonical, with that block's
+ * timestamp. Null while that cannot be read.
+ */
+async function finalizedForwarderNonce(clientFor, chainId, signer) {
+    const forwarder = forwarderOn(chainId);
+    if (!forwarder || !isAddressLike(signer))
+        return null;
+    let client;
+    try {
+        client = clientFor(chainId);
+    }
+    catch {
+        return null;
+    }
+    if (!client)
+        return null;
+    const reader = client;
+    const finalized = await atCanonicalFinalizedBlock(reader, (blockNumber) => reader.readContract({
+        address: forwarder,
+        abi: juicebox_js_1.erc2771ForwarderAbi,
+        functionName: "nonces",
+        args: [signer],
+        blockNumber,
+    }));
+    const nonce = finalized && (0, untrusted_js_1.uint256)(finalized.value);
+    return finalized && nonce !== null
+        ? { nonce, timestamp: finalized.timestamp }
+        : null;
+}
+/**
+ * The requests a session published, each read from its entry (an `execute`
+ * on its chain's canonical forwarder, as {@link relayrForwardRequest} reads
+ * it), with the nonce it was signed with when `nonces` has one for every
+ * entry. Null when there are none, or one is not such a request: requests
+ * that can't be read can't be classified, so they never count as dead.
+ */
+function relayrSignedRequests(entries, nonces) {
+    const published = Array.isArray(entries) ? entries : [];
+    const saved = Array.isArray(nonces) && nonces.length === published.length
+        ? nonces
+        : undefined;
+    const requests = published.flatMap((entry, index) => {
+        const request = relayrForwardRequest(entry);
+        return request
+            ? [
+                {
+                    chainId: entry.chain,
+                    signer: request.from,
+                    deadline: request.deadline,
+                    ...(saved ? { nonce: saved[index] } : {}),
+                },
+            ]
+            : [];
+    });
+    return published.length && requests.length === published.length
+        ? requests
+        : null;
+}
+/**
+ * The one classification of signed forward requests (ruling R114): each at a
+ * canonical finalized block on its chain, read once per chain and signer with
+ * `clientFor(chainId)`. Never throws for a chain it cannot read: its requests
+ * are live.
+ */
+async function relayrRequestStates(clientFor, requests) {
+    const finalized = new Map();
+    return Promise.all(requests.map(async ({ chainId, signer, deadline, nonce, }) => {
+        const key = `${chainId}:${String(signer).toLowerCase()}`;
+        if (!finalized.has(key)) {
+            finalized.set(key, finalizedForwarderNonce(clientFor, chainId, signer));
+        }
+        const block = await finalized.get(key);
+        // A saved nonce that can't be read leaves the request unknown, and a
+        // deadline that can't be read has not passed.
+        const saved = nonce === undefined ? null : (0, untrusted_js_1.uint256)(nonce);
+        const end = (0, untrusted_js_1.uint256)(deadline);
+        if (block && (nonce === undefined || saved !== null)) {
+            if (saved !== null && block.nonce > saved) {
+                return { live: false, mayHaveRun: true, unused: false };
+            }
+            if (end !== null && end < block.timestamp) {
+                return {
+                    live: false,
+                    mayHaveRun: saved === null,
+                    unused: block.nonce === saved,
+                };
+            }
+        }
+        return { live: true, deadline: Number(deadline) };
+    }));
+}
+/**
+ * What `states` allow together. No states are neither run nor unused, so a
+ * session with none holds.
+ */
+function relayrRequestsVerdict(states) {
+    const deadlines = states.flatMap((state) => state.live ? [state.deadline] : []);
+    const mayHaveRun = states.some((state) => !state.live && state.mayHaveRun);
+    if (deadlines.length) {
+        return { live: true, until: Math.max(...deadlines), mayHaveRun };
+    }
+    return {
+        live: false,
+        mayHaveRun,
+        unused: states.length > 0 && states.every((state) => !state.live && state.unused),
+    };
+}
+/**
+ * Ruling R117: whether every request is dead at a canonical finalized block
+ * on its chain, anything unknown counting as live. A saved session reserves
+ * its signers' forwarder nonces on its chains exactly while one of its
+ * requests is live, never by a device clock or a quote's expiry. Requests that
+ * can't be classified (null) or none at all are never dead.
+ */
+async function relayrRequestsDead(clientFor, requests) {
+    return (Array.isArray(requests) &&
+        requests.length > 0 &&
+        !relayrRequestsVerdict(await relayrRequestStates(clientFor, requests)).live);
+}
+/**
+ * Whether the chain's finalized block, still canonical, is past `deadline`
+ * (seconds, as a safe integer, decimal or 0x-hex digits, or a bigint): its
+ * timestamp is later. False while that is unknown, or the deadline can't be
+ * read.
+ */
+async function relayrDeadlinePassed(client, deadline) {
+    const finalized = await atCanonicalFinalizedBlock(client, async () => undefined);
+    const end = (0, untrusted_js_1.uint256)(deadline);
+    return !!finalized && end !== null && finalized.timestamp > end;
+}
+/** Whether `value` is a {@link RelayrDiscardReason}, for a reason read back from storage. */
+function isRelayrDiscardReason(value) {
+    return value === "ran" || value === "changed" || value === "expired";
+}
+/** The transport failures that mean a recheck could not reach the chain. */
+const UNREACHED = ["HttpRequestError", "TimeoutError", "WebSocketRequestError"];
+/**
+ * Revert data: whole bytes of hex, at least a 4-byte selector, bare or in
+ * Nethermind's "Reverted 0x…" form.
+ */
+const REVERT_DATA = /^(?:Reverted )?0x(?:[0-9a-fA-F]{2}){4,}$/u;
+/**
+ * Whether one error carries revert data, whatever its JSON-RPC code: in its
+ * `data`, in a `data.data` a node nests there, or in the `raw` data of viem's
+ * contract revert. Such an error is the chain answering.
+ */
+function revertedWithData(link) {
+    const { raw, data } = link;
+    const nested = data !== null && typeof data === "object"
+        ? data.data
+        : undefined;
+    return [raw, data, nested].some((value) => typeof value === "string" && REVERT_DATA.test(value));
+}
+/**
+ * Ruling R118: the node could not answer the recheck, so it says nothing
+ * about the project. Within the error's first eight links (its cause chain),
+ * one is a transport failure (HTTP, timeout or WebSocket), a JSON-RPC failure
+ * (viem's `RpcRequestError` or any `RpcError`, such as -32001, -32005 or
+ * -32603), or a contract revert without revert data, as viem reads a bare
+ * revert, transient or not; and no link carries revert data, which on any
+ * code is the chain answering. An app's error that wraps such a failure as
+ * its `cause` reads the same way.
+ */
+function recheckUnreached(error) {
+    const links = [];
+    for (let link = error; links.length < 8 && link instanceof Error; link = link.cause) {
+        links.push(link);
+    }
+    return (!links.some(revertedWithData) &&
+        links.some((link) => UNREACHED.includes(link.name) ||
+            link instanceof viem_1.RpcRequestError ||
+            link instanceof viem_1.RpcError ||
+            link instanceof viem_1.ContractFunctionRevertedError));
+}
+/**
+ * What a session does next from its requests' `verdict` (see
+ * {@link RelayrSessionOutcome}), which was classified before the action's own
+ * recheck, since a request that ran would make the recheck refuse.
+ *
+ * `nonces` must be the saved nonces of exactly the requests that were
+ * classified into `verdict`, in the same order: `refresh` and `re-sign` hand
+ * them back to sign at, and nothing here can check them against the verdict.
+ * Without them (omitted, empty or not a list), a session whose requests are
+ * all dead and unused holds as `reorg-hold`, and is neither discarded nor
+ * signed again.
+ *
+ * `recheck`, the action's proof that its calls still apply, resolves when
+ * they do and throws when they don't; a value it resolves with is never read.
+ * It runs only once every request is dead and unused. Without one, as in an
+ * account view, such a session can be discarded as `expired`. A recheck that
+ * fails because the node could not answer decides nothing. Known limit: a
+ * reorg that drops an earlier forwarded transaction can leave a finalized
+ * nonce below a saved one, and the session holds until the nonce catches up.
+ */
+async function relayrSessionOutcome(verdict, { nonces, recheck, } = {}) {
+    const saved = Array.isArray(nonces) && nonces.length ? [...nonces] : null;
+    if (verdict.live) {
+        return verdict.mayHaveRun
+            ? { kind: "hold", until: verdict.until }
+            : { kind: "refresh", until: verdict.until, nonces: saved };
+    }
+    if (verdict.mayHaveRun)
+        return { kind: "discard", reason: "ran" };
+    if (!verdict.unused || !saved)
+        return { kind: "reorg-hold" };
+    if (!recheck)
+        return { kind: "discard", reason: "expired" };
+    try {
+        await recheck();
+    }
+    catch (error) {
+        return recheckUnreached(error)
+            ? withHidden({ kind: "unchecked" }, "error", error)
+            : withHidden({ kind: "discard", reason: "changed" }, "error", error);
+    }
+    return { kind: "re-sign", nonces: saved };
+}
 //# sourceMappingURL=relayr.js.map