@bananapus/nana-sdk-core 2.12.2 → 2.13.0

package/dist/cjs/v6/feeBuyback.js

@@ -0,0 +1,306 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeFeeSimulation = analyzeFeeSimulation;
+exports.checkFeeBuyback = checkFeeBuyback;
+exports.feeMessage = feeMessage;
+exports.feeReceipt = feeReceipt;
+exports.createFeeWatch = createFeeWatch;
+const viem_1 = require("viem");
+// Shared by every Juicebox client. Simulation results are
+// advisory estimates only; the existing transaction simulation/authorization remains mandatory.
+const abi = (0, viem_1.parseAbi)([
+    "event Mint(uint256 indexed projectId,uint256 leftoverAmount,uint256 tokenCount,address caller)",
+    "event Swap(uint256 indexed projectId,uint256 amountToSwapWith,bytes32 indexed poolId,uint256 amountReceived,address caller)",
+    "event Pay(uint256 indexed rulesetId,uint256 indexed rulesetCycleNumber,uint256 indexed projectId,address payer,address beneficiary,uint256 amount,uint256 newlyIssuedTokenCount,string memo,bytes metadata,address caller)",
+    "event MintTokens(address indexed beneficiary,uint256 indexed projectId,uint256 tokenCount,uint256 beneficiaryTokenCount,string memo,uint256 reservedPercent,address caller)",
+    "event ProcessFee(uint256 indexed projectId,address indexed token,uint256 indexed amount,bool wasHeld,address beneficiary,address caller)",
+]);
+const unknownResult = () => ({ status: "unknown", fees: [] });
+const same = (a, b) => !!a && !!b && a.toLowerCase() === b.toLowerCase();
+/** Successful simulation logs include internal same-terminal fees that call traces cannot isolate. */
+function analyzeFeeSimulation(value, options) {
+    if (!Array.isArray(value) || value.length !== 1)
+        return unknownResult();
+    const calls = value[0]?.calls;
+    if (!Array.isArray(calls) ||
+        calls.length !== 1 ||
+        calls[0]?.status !== "0x1" ||
+        !Array.isArray(calls[0]?.logs) ||
+        calls[0].logs.length > 20000)
+        return unknownResult();
+    const records = [];
+    const active = new Map();
+    const includes = (addresses, address) => addresses?.some((a) => same(a, address));
+    try {
+        for (const log of calls[0].logs) {
+            let event;
+            try {
+                event = (0, viem_1.decodeEventLog)({
+                    abi,
+                    data: log.data,
+                    topics: log.topics,
+                });
+            }
+            catch {
+                continue;
+            }
+            const args = event.args;
+            if (event.eventName === "Pay") {
+                const a = event.args;
+                if (!includes(options.terminals, log.address))
+                    continue;
+                const key = `${log.address.toLowerCase()}:${a.projectId}`;
+                // Every pay closes the prior scope for this project, even if unrelated.
+                active.delete(key);
+                if (!includes(options.feePayers, a.payer) || a.amount === 0n)
+                    continue;
+                const terminalPayer = includes(options.terminals, a.payer);
+                if (terminalPayer && a.projectId !== 1n)
+                    continue;
+                // Fee recipients can differ from the submitting account. Keep repeated
+                // payments distinct without depending on unrelated fees earlier in the log.
+                const identity = `${key}:${a.beneficiary.toLowerCase()}`;
+                const fee = {
+                    key: identity,
+                    projectId: a.projectId,
+                    beneficiary: a.beneficiary,
+                    received: a.newlyIssuedTokenCount,
+                    route: a.newlyIssuedTokenCount > 0n ? "issuance" : "unknown",
+                };
+                records.push({
+                    fee,
+                    payer: a.payer,
+                    metadata: a.metadata,
+                    confirmed: !terminalPayer,
+                });
+                active.set(key, { fee, mint: false, swap: false, sawSwap: false });
+            }
+            else if (event.eventName === "Mint" || event.eventName === "Swap") {
+                if (!includes(options.trustedHooks, log.address))
+                    continue;
+                const state = active.get(`${args.caller.toLowerCase()}:${args.projectId}`);
+                if (!state || (state.hook && !same(state.hook, log.address)))
+                    continue;
+                state.hook = log.address;
+                // Earlier direct issuance does not verify this hook's beneficiary receipt.
+                state.fee.route = "unknown";
+                if (event.eventName === "Mint" && event.args.tokenCount > 0n)
+                    state.mint = true;
+                if (event.eventName === "Swap")
+                    state.sawSwap = true;
+                if (event.eventName === "Swap" && event.args.amountReceived > 0n)
+                    state.swap = true;
+            }
+            else if (event.eventName === "MintTokens") {
+                if (!includes(options.controllers, log.address))
+                    continue;
+                const matches = [...active.entries()].filter(([, s]) => s.fee.projectId === event.args.projectId &&
+                    same(s.fee.beneficiary, event.args.beneficiary) &&
+                    same(s.hook, event.args.caller));
+                if (matches.length !== 1)
+                    continue;
+                const [key, state] = matches[0];
+                state.fee.received += event.args.beneficiaryTokenCount;
+                state.fee.route =
+                    state.fee.received === 0n
+                        ? "issuance"
+                        : state.swap
+                            ? "swap"
+                            : state.mint && state.sawSwap
+                                ? "issuance"
+                                : state.mint
+                                    ? "fallback"
+                                    : "unknown";
+                active.delete(key);
+            }
+            else if (event.eventName === "ProcessFee") {
+                if (!includes(options.terminals, log.address))
+                    continue;
+                // Ordinary project payouts also emit terminal-paid Pay logs, even to
+                // project #1. Only ProcessFee after settlement proves a platform fee.
+                const record = [...records]
+                    .reverse()
+                    .find((r) => !r.confirmed &&
+                    r.fee.projectId === 1n &&
+                    same(r.payer, log.address) &&
+                    same(r.fee.beneficiary, event.args.beneficiary) &&
+                    same(r.metadata, (0, viem_1.numberToHex)(event.args.projectId, { size: 32 })));
+                if (record)
+                    record.confirmed = true;
+            }
+        }
+    }
+    catch {
+        return unknownResult();
+    }
+    // Excluded payout candidates must not change a recognized fee's identity.
+    const occurrences = new Map();
+    const fees = records
+        .filter((r) => r.confirmed)
+        .map(({ fee }) => {
+        const occurrence = occurrences.get(fee.key) ?? 0;
+        occurrences.set(fee.key, occurrence + 1);
+        fee.key = `${fee.key}:${occurrence}`;
+        return fee;
+    });
+    // Ordinary issuance has no buyback Mint/Swap event and must not be called a fallback.
+    return {
+        status: fees.some((f) => f.route === "fallback")
+            ? "fallback"
+            : fees.some((f) => f.route === "unknown")
+                ? "unknown"
+                : fees.some((f) => f.route === "swap")
+                    ? "ready"
+                    : "none",
+        fees,
+    };
+}
+async function checkFeeBuyback(client, call, options) {
+    if (!call.from || !options.trustedHooks.length)
+        return unknownResult();
+    // Bound provider stalls; a stalled quote must not trap the confirmation dialog.
+    const request = async (args) => {
+        let timer;
+        try {
+            return await Promise.race([
+                client.request(args),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new Error("Fee estimate timed out")), 8000);
+                }),
+            ]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    };
+    try {
+        const block = await request({ method: "eth_blockNumber" });
+        if (typeof block !== "string" || !/^0x[0-9a-f]+$/i.test(block))
+            return unknownResult();
+        const simulation = await request({
+            method: "eth_simulateV1",
+            params: [
+                {
+                    blockStateCalls: [
+                        {
+                            calls: [
+                                {
+                                    from: call.from,
+                                    to: call.to,
+                                    data: call.data,
+                                    value: (0, viem_1.numberToHex)(call.value ?? 0n),
+                                    gas: (0, viem_1.numberToHex)(call.gas ?? 10000000n),
+                                },
+                            ],
+                        },
+                    ],
+                    validation: false,
+                },
+                block,
+            ],
+        });
+        return {
+            ...analyzeFeeSimulation(simulation, options),
+            block,
+            checkedAt: Date.now(),
+        };
+    }
+    catch {
+        return { ...unknownResult(), checkedAt: Date.now() };
+    }
+}
+function feeMessage(result) {
+    if (result.status === "fallback")
+        return "Your fee would create tokens at the issuance rate. Wait for “Buyback ready” to use the pool rate.";
+    if (result.status === "ready")
+        return "Buyback ready — review and submit now. The rate may change before execution.";
+    if (result.status === "unknown")
+        return "Fee return unavailable. Retry now, or submit without an estimate.";
+    return "";
+}
+function feeReceipt(fee) {
+    const amount = (0, viem_1.formatUnits)(fee.received, 18);
+    const [whole, fraction] = amount.split(".");
+    const recipient = fee.beneficiary
+        ? ` to ${fee.beneficiary.slice(0, 6)}…${fee.beneficiary.slice(-4)}`
+        : "";
+    return `~${whole.replace(/\B(?=(\d{3})+(?!\d))/g, ",")}${fraction ? "." + fraction.slice(0, 4) : ""} project #${fee.projectId} tokens${recipient}`;
+}
+/** One review owns one watcher. It never sends, and stale/closed reviews cannot approve. */
+function createFeeWatch(check, changed) {
+    let stopped = false;
+    let latest = unknownResult();
+    let pending;
+    const affected = new Set();
+    const affectedCounts = new Map();
+    const identity = (fee) => fee.key.slice(0, fee.key.lastIndexOf(":"));
+    async function refresh() {
+        if (stopped)
+            return unknownResult();
+        if (pending)
+            return pending;
+        pending = (async () => {
+            let next;
+            try {
+                next = await check();
+            }
+            catch {
+                next = unknownResult();
+            }
+            if (stopped)
+                return unknownResult();
+            const counts = new Map();
+            for (const fee of next.fees)
+                counts.set(identity(fee), (counts.get(identity(fee)) ?? 0) + 1);
+            for (const fee of next.fees) {
+                if (fee.route !== "fallback")
+                    continue;
+                affected.add(fee.key);
+                const group = identity(fee);
+                affectedCounts.set(group, Math.max(affectedCounts.get(group) ?? 0, counts.get(group) ?? 0));
+            }
+            for (const [group, count] of affectedCounts)
+                affectedCounts.set(group, Math.max(count, counts.get(group) ?? 0));
+            if (next.status !== "fallback" &&
+                ([...affectedCounts].some(([group, count]) => (counts.get(group) ?? 0) < count) ||
+                    [...affected].some((key) => !next.fees.some((fee) => fee.key === key && fee.route === "swap"))))
+                next = { ...next, status: "unknown" };
+            latest = next;
+            changed(next);
+            return next;
+        })();
+        try {
+            return await pending;
+        }
+        finally {
+            pending = undefined;
+        }
+    }
+    return {
+        refresh,
+        async confirm() {
+            if (stopped)
+                return false;
+            const before = latest;
+            if (pending)
+                await pending;
+            const fresh = await refresh();
+            if (stopped)
+                return false;
+            // A fresh degradation must be displayed before the user can elect to submit anyway.
+            if (fresh.status === "fallback" &&
+                (before.status !== "fallback" ||
+                    fresh.fees.some((fee) => fee.route === "fallback" &&
+                        !before.fees.some((old) => old.key === fee.key && old.route === "fallback"))))
+                return false;
+            if (fresh.status === "unknown" && before.status !== "unknown")
+                return false;
+            return true;
+        },
+        stop() {
+            stopped = true;
+        },
+    };
+}
+//# sourceMappingURL=feeBuyback.js.map

package/dist/cjs/v6/feeBuyback.js.map

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

package/dist/esm/bendystrawOperations.d.ts

@@ -0,0 +1,38 @@
+import { type BendystrawNetwork } from "./utils/bendystraw.js";
+export type BendystrawOperationContract = {
+    operationName?: string;
+    validateData: (value: unknown) => value is Record<string, unknown>;
+    validateVariables: (value: unknown) => value is Record<string, unknown>;
+};
+/**
+ * Compile one static GraphQL document into the same runtime operation contract
+ * used by every Bendystraw transport: operation name, bounded variables, and
+ * recursive response-shape validation.
+ */
+export declare function compileBendystrawOperation(query: string): BendystrawOperationContract;
+/** The persisted-operation id a same-origin Bendystraw proxy accepts: the SHA-256 of the exact document. */
+export declare function bendystrawOperationId(query: string): Promise<string>;
+export type PersistedBendystrawRequest = {
+    query: string;
+    variables: Record<string, unknown>;
+};
+/**
+ * Resolve a proxy request body (`{ operation, variables }`) against the app's
+ * registry of persisted documents. Anything else, including an unknown id, is
+ * refused with null, so the proxy never forwards arbitrary GraphQL.
+ */
+export declare function resolvePersistedBendystrawRequest(value: unknown, registry: Readonly<Record<string, string>>): PersistedBendystrawRequest | null;
+/**
+ * Send one persisted operation through the app's same-origin proxy
+ * (`/api/bendystraw/{network}/query` unless `endpoint` says otherwise). Only
+ * the operation id and variables leave the browser; the response is validated
+ * against the document's contract.
+ */
+export declare function requestPersistedBendystraw<T>(args: {
+    contract: BendystrawOperationContract;
+    network: BendystrawNetwork;
+    query: string;
+    variables: Record<string, unknown>;
+    endpoint?: string;
+}): Promise<T>;
+//# sourceMappingURL=bendystrawOperations.d.ts.map

package/dist/esm/bendystrawOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bendystrawOperations.d.ts","sourceRoot":"","sources":["../../src/bendystrawOperations.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,2BAA2B,GAAG;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnE,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzE,CAAC;AAwJF;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GACZ,2BAA2B,CAiD7B;AAED,4GAA4G;AAC5G,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,0BAA0B,GAAG,IAAI,CAcnC;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,CAAC,EAAE,IAAI,EAAE;IACxD,QAAQ,EAAE,2BAA2B,CAAC;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBb"}

package/dist/esm/bendystrawOperations.js

@@ -0,0 +1,206 @@
+import { Kind, parse, } from "graphql";
+import { requestBendystraw, } from "./utils/bendystraw.js";
+const contracts = new Map();
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isSafeInput(value, depth = 0) {
+    if (depth > 12)
+        return false;
+    if (value === undefined ||
+        value === null ||
+        typeof value === "boolean" ||
+        (typeof value === "number" && Number.isFinite(value))) {
+        return true;
+    }
+    if (typeof value === "string")
+        return value.length <= 16_384;
+    if (Array.isArray(value)) {
+        return (value.length <= 1_000 &&
+            value.every((item) => isSafeInput(item, depth + 1)));
+    }
+    return (isRecord(value) &&
+        Object.keys(value).length <= 250 &&
+        Object.values(value).every((item) => isSafeInput(item, depth + 1)));
+}
+function validateNamedInput(name, value) {
+    if (!isSafeInput(value))
+        return false;
+    switch (name) {
+        case "Boolean":
+            return typeof value === "boolean";
+        case "Float":
+            return typeof value === "number" && Number.isFinite(value);
+        case "Int":
+            return typeof value === "number" && Number.isSafeInteger(value);
+        case "ID":
+            return typeof value === "string" || Number.isSafeInteger(value);
+        case "String":
+            return typeof value === "string";
+        default:
+            return true;
+    }
+}
+function validateInput(type, value) {
+    if (type.kind === Kind.NON_NULL_TYPE) {
+        return (value !== null && value !== undefined && validateInput(type.type, value));
+    }
+    if (value === null || value === undefined)
+        return true;
+    if (type.kind === Kind.LIST_TYPE) {
+        const values = Array.isArray(value) ? value : [value];
+        return values.every((item) => validateInput(type.type, item));
+    }
+    return validateNamedInput(type.name.value, value);
+}
+// Defaults are constant values: the parser rejects a variable inside one.
+function defaultValueOf(value) {
+    if (!value)
+        return undefined;
+    switch (value.kind) {
+        case Kind.BOOLEAN:
+            return value.value;
+        case Kind.ENUM:
+        case Kind.STRING:
+            return value.value;
+        case Kind.FLOAT:
+        case Kind.INT:
+            return Number(value.value);
+        case Kind.LIST:
+            return value.values.map(defaultValueOf);
+        case Kind.NULL:
+            return null;
+        case Kind.OBJECT:
+            return Object.fromEntries(value.fields.map((field) => [
+                field.name.value,
+                defaultValueOf(field.value),
+            ]));
+    }
+}
+function validateSelectedValue(value, selectionSet, fragments) {
+    if (value === null)
+        return true;
+    if (Array.isArray(value)) {
+        return value.every((item) => validateSelectedValue(item, selectionSet, fragments));
+    }
+    if (!isRecord(value))
+        return false;
+    return validateSelectionSet(value, selectionSet, fragments, true);
+}
+function validateSelectionSet(value, selectionSet, fragments, requireFields) {
+    for (const selection of selectionSet.selections) {
+        if (selection.kind === Kind.FIELD) {
+            const responseKey = selection.alias?.value ?? selection.name.value;
+            if (!Object.prototype.hasOwnProperty.call(value, responseKey)) {
+                if (requireFields)
+                    return false;
+                continue;
+            }
+            if (selection.selectionSet &&
+                !validateSelectedValue(value[responseKey], selection.selectionSet, fragments)) {
+                return false;
+            }
+        }
+        else if (selection.kind === Kind.INLINE_FRAGMENT) {
+            if (!validateSelectionSet(value, selection.selectionSet, fragments, requireFields && !selection.typeCondition)) {
+                return false;
+            }
+        }
+        else {
+            const fragment = fragments.get(selection.name.value);
+            if (!fragment)
+                return false;
+            if (!validateSelectionSet(value, fragment.selectionSet, fragments, false)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+/**
+ * Compile one static GraphQL document into the same runtime operation contract
+ * used by every Bendystraw transport: operation name, bounded variables, and
+ * recursive response-shape validation.
+ */
+export function compileBendystrawOperation(query) {
+    const cached = contracts.get(query);
+    if (cached)
+        return cached;
+    const document = parse(query);
+    const operations = document.definitions.filter((definition) => definition.kind === Kind.OPERATION_DEFINITION);
+    if (operations.length !== 1) {
+        throw new TypeError("A Bendystraw document must contain exactly one operation");
+    }
+    const operation = operations[0];
+    const fragments = new Map(document.definitions
+        .filter((definition) => definition.kind === Kind.FRAGMENT_DEFINITION)
+        .map((fragment) => [fragment.name.value, fragment]));
+    const variableNames = new Set(operation.variableDefinitions?.map((definition) => definition.variable.name.value) ?? []);
+    const contract = {
+        operationName: operation.name?.value,
+        validateData: (value) => isRecord(value) &&
+            validateSelectionSet(value, operation.selectionSet, fragments, true),
+        validateVariables: (value) => {
+            if (!isRecord(value) || !isSafeInput(value))
+                return false;
+            if (Object.keys(value).some((name) => !variableNames.has(name)))
+                return false;
+            return (operation.variableDefinitions ?? []).every((definition) => {
+                const name = definition.variable.name.value;
+                const input = value[name] === undefined
+                    ? defaultValueOf(definition.defaultValue)
+                    : value[name];
+                return validateInput(definition.type, input);
+            });
+        },
+    };
+    contracts.set(query, contract);
+    return contract;
+}
+/** The persisted-operation id a same-origin Bendystraw proxy accepts: the SHA-256 of the exact document. */
+export async function bendystrawOperationId(query) {
+    const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(query));
+    let id = "";
+    for (const byte of new Uint8Array(digest))
+        id += byte.toString(16).padStart(2, "0");
+    return id;
+}
+/**
+ * Resolve a proxy request body (`{ operation, variables }`) against the app's
+ * registry of persisted documents. Anything else, including an unknown id, is
+ * refused with null, so the proxy never forwards arbitrary GraphQL.
+ */
+export function resolvePersistedBendystrawRequest(value, registry) {
+    if (!isRecord(value))
+        return null;
+    const keys = Object.keys(value);
+    if (keys.some((key) => key !== "operation" && key !== "variables") ||
+        typeof value.operation !== "string" ||
+        !/^[a-f0-9]{64}$/u.test(value.operation) ||
+        !isRecord(value.variables)) {
+        return null;
+    }
+    // The 64-hex id check above rules out inherited keys such as `__proto__`.
+    const query = registry[value.operation];
+    return query ? { query, variables: value.variables } : null;
+}
+/**
+ * Send one persisted operation through the app's same-origin proxy
+ * (`/api/bendystraw/{network}/query` unless `endpoint` says otherwise). Only
+ * the operation id and variables leave the browser; the response is validated
+ * against the document's contract.
+ */
+export async function requestPersistedBendystraw(args) {
+    const operation = await bendystrawOperationId(args.query);
+    return requestBendystraw(args.endpoint ?? `/api/bendystraw/${args.network}/query`, args.query, args.variables, {
+        fetch: (input, init) => fetch(input, {
+            ...init,
+            body: JSON.stringify({ operation, variables: args.variables }),
+            cache: "no-store",
+        }),
+        operationName: args.contract.operationName,
+        validateData: (value) => args.contract.validateData(value),
+        validateVariables: args.contract.validateVariables,
+    });
+}
+//# sourceMappingURL=bendystrawOperations.js.map

package/dist/esm/bendystrawOperations.js.map

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

package/dist/esm/review/contractWrite.d.ts

@@ -0,0 +1,38 @@
+import { type Address } from "viem";
+export type ReviewedWritePhase = "review" | "simulating" | "signing";
+export type ReviewedContractWriteOptions<TRequest extends {
+    chainId: number;
+}, TSimulated, THash> = {
+    request: TRequest;
+    expectedAccount: Address | undefined;
+    review: (request: TRequest) => Promise<unknown>;
+    switchChain: (chainId: number) => Promise<unknown>;
+    currentAccount: () => Address | undefined;
+    simulate: (request: TRequest) => Promise<TSimulated>;
+    reverify?: (request: TRequest) => Promise<unknown>;
+    /** Persist recovery intent after simulation, before a wallet can broadcast. */
+    beforeWrite?: () => unknown | Promise<unknown>;
+    /** The persisted intent was rejected by a final gate before write was invoked. */
+    onBeforeWriteAborted?: () => unknown | Promise<unknown>;
+    /** Clear that intent only when the wallet explicitly rejects the write. */
+    onWriteRejected?: () => unknown | Promise<unknown>;
+    write: (simulated: TSimulated) => Promise<THash>;
+    onPhase?: (phase: ReviewedWritePhase) => void;
+    accountChangedError?: string;
+    /**
+     * An app-specific gate run before anything else, such as refusing writes while
+     * the app is impersonating another account. It throws to stop the write.
+     */
+    guard?: () => void;
+};
+/**
+ * Shared review-to-wallet boundary for direct contract writes.
+ *
+ * The exact request object accepted by review is also handed to simulation,
+ * and only the simulation result reaches the wallet writer. Account identity
+ * is checked after a chain switch and again immediately before signing.
+ */
+export declare function submitReviewedContractWrite<TRequest extends {
+    chainId: number;
+}, TSimulated, THash>({ request, expectedAccount, review, switchChain, currentAccount, simulate, reverify, beforeWrite, onBeforeWriteAborted, onWriteRejected, write, onPhase, accountChangedError, guard, }: ReviewedContractWriteOptions<TRequest, TSimulated, THash>): Promise<THash>;
+//# sourceMappingURL=contractWrite.d.ts.map

package/dist/esm/review/contractWrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractWrite.d.ts","sourceRoot":"","sources":["../../../src/review/contractWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,4BAA4B,CACtC,QAAQ,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACpC,UAAU,EACV,KAAK,IACH;IACF,OAAO,EAAE,QAAQ,CAAC;IAClB,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,KAAK,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACpC,UAAU,EACV,KAAK,EACL,EACA,OAAO,EACP,eAAe,EACf,MAAM,EACN,WAAW,EACX,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,KAAK,EACL,OAAO,EACP,mBAAgF,EAChF,KAAK,GACN,EAAE,4BAA4B,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CA+C5E"}