@bananapus/nana-sdk-core 2.6.0 → 2.8.0

package/dist/esm/jbcenter/decode.js

@@ -0,0 +1,196 @@
+import { decodeFunctionData, isAddressEqual, parseAbi, slice, } from "viem";
+import { jb721TiersHookProjectDeployerAbi, jbControllerAbi, jbOmnichainDeployerAbi, revDeployerAbi, } from "../generated/juicebox.js";
+import { v6Address } from "../v6/types.js";
+/** The address of `contract` on `chainId`, or null when it isn't deployed there. */
+function addressFor(contract, chainId) {
+    try {
+        return v6Address(contract, chainId);
+    }
+    catch {
+        return null;
+    }
+}
+function decodeProjectLaunch(call) {
+    try {
+        const address = addressFor("JBController", call.chainId);
+        if (!address || !isAddressEqual(address, call.to))
+            return null;
+        const decoded = decodeFunctionData({
+            abi: jbControllerAbi,
+            data: call.data,
+        });
+        if (decoded.functionName !== "launchProjectFor")
+            return null;
+        const [owner, projectUri, rulesetConfigurations, terminalConfigurations, memo,] = decoded.args;
+        return {
+            flavor: "project",
+            owner,
+            projectUri,
+            rulesetConfigurations,
+            terminalConfigurations,
+            memo,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function decodeProject721Launch(call) {
+    try {
+        const address = addressFor("JB721TiersHookProjectDeployer", call.chainId);
+        if (!address || !isAddressEqual(address, call.to))
+            return null;
+        const decoded = decodeFunctionData({
+            abi: jb721TiersHookProjectDeployerAbi,
+            data: call.data,
+        });
+        if (decoded.functionName !== "launchProjectFor")
+            return null;
+        const [owner, , launchProjectConfig, , salt] = decoded.args;
+        return {
+            flavor: "project-721",
+            owner,
+            projectUri: launchProjectConfig.projectUri,
+            // This deployer's ruleset metadata always turns the pay data hook on and
+            // points it at the hook it deploys, so `dataHook`/`useDataHookForPay`
+            // aren't inputs here — they read as `undefined` on this flavor's shell.
+            rulesetConfigurations: launchProjectConfig.rulesetConfigurations,
+            terminalConfigurations: launchProjectConfig.terminalConfigurations,
+            memo: launchProjectConfig.memo,
+            salt,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function decodeOmnichainLaunch(call) {
+    try {
+        const address = addressFor("JBOmnichainDeployer", call.chainId);
+        if (!address || !isAddressEqual(address, call.to))
+            return null;
+        const decoded = decodeFunctionData({
+            abi: jbOmnichainDeployerAbi,
+            data: call.data,
+        });
+        if (decoded.functionName !== "launchProjectFor")
+            return null;
+        const args = decoded.args;
+        if (args.length === 7) {
+            const [owner, projectUri, , rulesetConfigurations, terminalConfigurations, memo,] = args;
+            return {
+                flavor: "omnichain",
+                owner,
+                projectUri,
+                rulesetConfigurations,
+                terminalConfigurations,
+                memo,
+                has721: true,
+            };
+        }
+        const [owner, projectUri, rulesetConfigurations, terminalConfigurations, memo,] = args;
+        return {
+            flavor: "omnichain",
+            owner,
+            projectUri,
+            rulesetConfigurations,
+            terminalConfigurations,
+            memo,
+            has721: false,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function decodeRevnetDeploy(call) {
+    try {
+        const address = addressFor("REVDeployer", call.chainId);
+        if (!address || !isAddressEqual(address, call.to))
+            return null;
+        const decoded = decodeFunctionData({
+            abi: revDeployerAbi,
+            data: call.data,
+        });
+        if (decoded.functionName !== "deployFor")
+            return null;
+        const [, config, accountingContexts] = decoded.args;
+        return {
+            flavor: "revnet",
+            operator: config.operator,
+            projectUri: config.description.uri,
+            stages: config.stageConfigurations,
+            description: config.description,
+            accountingContexts,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Source: HomerunDeployer.sol. Carried here because Homerun deploys its own
+ * per-chain deployer, which the V6 address registry does not name. */
+const homerunLaunchFundAbi = parseAbi([
+    "function launchFundFor(address owner, string projectUri, string name, string ticker, uint48 mustStartAtOrAfter, bytes32 salt, address[] peerSuckerDeployers) payable returns (uint256 projectId, address token)",
+]);
+/** HomerunDeployer's address on each chain it is deployed to: one salt across
+ * the mainnets, another across the testnets. Source: Homerun's
+ * `deployments/<chain>/HomerunDeployer.json`. */
+const HOMERUN_DEPLOYER_ADDRESSES = {
+    1: "0xac9250654ea223513ffee25fdb647dc016873905",
+    10: "0xac9250654ea223513ffee25fdb647dc016873905",
+    8453: "0xac9250654ea223513ffee25fdb647dc016873905",
+    42161: "0xac9250654ea223513ffee25fdb647dc016873905",
+    11155111: "0xe944fe96765450877f95cc36aa36ec72b4388721",
+    11155420: "0xe944fe96765450877f95cc36aa36ec72b4388721",
+    84532: "0xe944fe96765450877f95cc36aa36ec72b4388721",
+    421614: "0xe944fe96765450877f95cc36aa36ec72b4388721",
+};
+function decodeHomerunFundLaunch(call) {
+    try {
+        const address = HOMERUN_DEPLOYER_ADDRESSES[call.chainId];
+        if (!address || !isAddressEqual(address, call.to))
+            return null;
+        const decoded = decodeFunctionData({
+            abi: homerunLaunchFundAbi,
+            data: call.data,
+        });
+        const [owner, projectUri, tokenName, ticker, mustStartAtOrAfter, salt, peerSuckerDeployers,] = decoded.args;
+        return {
+            flavor: "homerun-fund",
+            owner,
+            projectUri,
+            tokenName,
+            ticker,
+            to: call.to,
+            mustStartAtOrAfter,
+            salt,
+            peerSuckerDeployers,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+const DECODERS = [
+    decodeProjectLaunch,
+    decodeProject721Launch,
+    decodeOmnichainLaunch,
+    decodeRevnetDeploy,
+    decodeHomerunFundLaunch,
+];
+/**
+ * Recognize a frozen `{ chainId, to, data }` deployment call (as produced by
+ * {@link createJBCenterDeploymentCall}) as one of the known v6 launch
+ * flavors, or `"unknown"` when the target address or selector isn't
+ * recognized.
+ */
+export function decodeDeploymentCall(call) {
+    for (const decode of DECODERS) {
+        const decoded = decode(call);
+        if (decoded)
+            return decoded;
+    }
+    return { flavor: "unknown", to: call.to, selector: slice(call.data, 0, 4) };
+}
+//# sourceMappingURL=decode.js.map

package/dist/esm/jbcenter/decode.js.map

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

package/dist/esm/jbcenter/ensureDeployed.d.ts

@@ -0,0 +1,29 @@
+import type { Hex } from "viem";
+import { type JBCenterClient, type JBCenterDeploymentCall, type JBCenterDeploymentInput, type JBCenterIntent, type JBCenterJsonObject } from "../jbcenter.js";
+export type EnsureDeployedStep = {
+    chainId: number;
+    status: "queued" | "sent" | "confirmed" | "failed" | "self-paid";
+    transactionHash?: Hex;
+};
+export type EnsureDeployedOptions = {
+    client: JBCenterClient;
+    intent: JBCenterIntent<JBCenterJsonObject>;
+    /** Runs the client's own launch pipeline for every remaining chain. */
+    selfPaid?: (calls: JBCenterDeploymentCall[]) => Promise<JBCenterDeploymentInput[]>;
+    onStep?: (step: EnsureDeployedStep) => void;
+    pollMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+export declare class EnsureDeployedError extends Error {
+    readonly chainId?: number | undefined;
+    constructor(message: string, chainId?: number | undefined);
+}
+/**
+ * The pre-step every webclient runs before the first on-chain write against
+ * an undeployed intent: sponsor the deploy through JB Center when eligible
+ * and poll until every chain lands, or fall back to the caller's own launch
+ * pipeline when JB Center can't or won't sponsor it.
+ */
+export declare function ensureDeployed(options: EnsureDeployedOptions): Promise<Record<number, string>>;
+//# sourceMappingURL=ensureDeployed.d.ts.map

package/dist/esm/jbcenter/ensureDeployed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureDeployed.d.ts","sourceRoot":"","sources":["../../../src/jbcenter/ensureDeployed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAKhC,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EAEnB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAOxB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACjE,eAAe,CAAC,EAAE,GAAG,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAC3C,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,sBAAsB,EAAE,KAC5B,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM;gBADzB,OAAO,EAAE,MAAM,EACN,OAAO,CAAC,EAAE,MAAM,YAAA;CAK5B;AA4KD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyCjC"}

package/dist/esm/jbcenter/ensureDeployed.js

@@ -0,0 +1,161 @@
+// `jbcenter.ts` re-exports this module, so the two form an import cycle. Keep
+// every value either side takes from the other inside a function body: a
+// top-level read of `JBCenterRequestError` or `isSponsorable` would resolve
+// before `jbcenter.ts` finishes evaluating under CJS.
+import { JBCenterRequestError, isSponsorable, } from "../jbcenter.js";
+import { deployedChains, isFullyDeployed } from "./merge.js";
+const DEFAULT_POLL_MS = 4_000;
+const DEFAULT_TIMEOUT_MS = 600_000;
+const SELF_PAID_FALLBACK_STATUSES = new Set([400, 429, 503]);
+export class EnsureDeployedError extends Error {
+    constructor(message, chainId) {
+        super(message);
+        this.chainId = chainId;
+        this.name = "EnsureDeployedError";
+    }
+}
+function checkAborted(signal) {
+    if (signal?.aborted) {
+        throw signal.reason;
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function reportSteps(deploys, seen, onStep) {
+    let failedChainId;
+    for (const deploy of deploys) {
+        if (seen.get(deploy.chainId) === deploy.status)
+            continue;
+        seen.set(deploy.chainId, deploy.status);
+        onStep?.({
+            chainId: deploy.chainId,
+            status: deploy.status,
+            transactionHash: deploy.transactionHash ?? undefined,
+        });
+        if (deploy.status === "failed" && failedChainId === undefined) {
+            failedChainId = deploy.chainId;
+        }
+    }
+    if (failedChainId !== undefined) {
+        throw new EnsureDeployedError(`JB Center could not deploy chain ${failedChainId}`, failedChainId);
+    }
+}
+async function pollUntilDeployed(client, seed, pollMs, timeoutMs, signal, onStep) {
+    const seen = new Map();
+    const startedAt = Date.now();
+    let current = seed;
+    while (true) {
+        checkAborted(signal);
+        reportSteps(current.deploys, seen, onStep);
+        if (isFullyDeployed(current)) {
+            return deployedChains(current);
+        }
+        if (Date.now() - startedAt >= timeoutMs) {
+            throw new EnsureDeployedError("JB Center deploy polling timed out");
+        }
+        await sleep(pollMs, signal);
+        current = await client.getIntent(current.id, { signal });
+    }
+}
+async function runSelfPaid(client, intent, selfPaid, onStep, signal) {
+    if (!selfPaid) {
+        throw new EnsureDeployedError("JB Center cannot sponsor this deploy and no self-paid fallback was provided");
+    }
+    checkAborted(signal);
+    const deployed = deployedChains(intent);
+    const remainingCalls = intent.envelope.deploymentCalls.filter((call) => !(call.chainId in deployed));
+    const deployments = await selfPaid(remainingCalls);
+    const remainingChainIds = new Set(remainingCalls.map((call) => call.chainId));
+    const returnedChainIds = new Set();
+    for (const deployment of deployments) {
+        if (!remainingChainIds.has(deployment.chainId)) {
+            throw new EnsureDeployedError(`Self-paid deploy returned an unexpected chain ${deployment.chainId}`, deployment.chainId);
+        }
+        if (returnedChainIds.has(deployment.chainId)) {
+            throw new EnsureDeployedError(`Self-paid deploy returned chain ${deployment.chainId} more than once`, deployment.chainId);
+        }
+        returnedChainIds.add(deployment.chainId);
+    }
+    for (const chainId of remainingChainIds) {
+        if (!returnedChainIds.has(chainId)) {
+            throw new EnsureDeployedError(`Self-paid deploy left chain ${chainId} undeployed`, chainId);
+        }
+    }
+    const result = { ...deployed };
+    for (const deployment of deployments) {
+        checkAborted(signal);
+        await client.recordDeployment(intent.id, deployment, { signal });
+        result[deployment.chainId] = deployment.projectId;
+        onStep?.({
+            chainId: deployment.chainId,
+            status: "self-paid",
+            transactionHash: deployment.transactionHash,
+        });
+    }
+    return result;
+}
+/**
+ * The sender an intent already has, or `undefined` when nothing has started
+ * it yet. Every chain in an intent belongs to one sender, so this decides the
+ * route before any new request goes out.
+ */
+function existingSender(options, intent, pollMs, timeoutMs) {
+    const { client, onStep, selfPaid, signal } = options;
+    if (isFullyDeployed(intent)) {
+        return Promise.resolve(deployedChains(intent));
+    }
+    if (intent.deploys.length > 0) {
+        return pollUntilDeployed(client, intent, pollMs, timeoutMs, signal, onStep);
+    }
+    if (intent.deployments.length > 0) {
+        return runSelfPaid(client, intent, selfPaid, onStep, signal);
+    }
+    return undefined;
+}
+/**
+ * The pre-step every webclient runs before the first on-chain write against
+ * an undeployed intent: sponsor the deploy through JB Center when eligible
+ * and poll until every chain lands, or fall back to the caller's own launch
+ * pipeline when JB Center can't or won't sponsor it.
+ */
+export async function ensureDeployed(options) {
+    const { client, intent, onStep, selfPaid, signal } = options;
+    const pollMs = options.pollMs ?? DEFAULT_POLL_MS;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const started = existingSender(options, intent, pollMs, timeoutMs);
+    if (started)
+        return started;
+    if (!isSponsorable(intent.envelope.chainIds)) {
+        return runSelfPaid(client, intent, selfPaid, onStep, signal);
+    }
+    let deploys;
+    try {
+        checkAborted(signal);
+        ({ deploys } = await client.requestDeploy(intent.id, { signal }));
+    }
+    catch (error) {
+        if (error instanceof JBCenterRequestError &&
+            SELF_PAID_FALLBACK_STATUSES.has(error.status)) {
+            // The refusal may mean the sponsor already took this intent, so read the
+            // intent back and follow whatever sender it now has instead of adding a
+            // second one.
+            const fresh = await client.getIntent(intent.id, { signal });
+            return (existingSender(options, fresh, pollMs, timeoutMs) ??
+                runSelfPaid(client, fresh, selfPaid, onStep, signal));
+        }
+        throw error;
+    }
+    return pollUntilDeployed(client, { ...intent, deploys }, pollMs, timeoutMs, signal, onStep);
+}
+//# sourceMappingURL=ensureDeployed.js.map

package/dist/esm/jbcenter/ensureDeployed.js.map

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

package/dist/esm/jbcenter/merge.d.ts

@@ -0,0 +1,21 @@
+import type { Address } from "viem";
+import type { JBCenterIntent, JBCenterSearchItem, JBCenterJsonObject } from "../jbcenter.js";
+export type JBCenterIntentRow = {
+    undeployed: true;
+    intentId: string;
+    name: string;
+    tagline: string | null;
+    logoUri: string | null;
+    owner: Address | null;
+    chainIds: number[];
+    createdAt: number;
+};
+export declare function intentRow(item: JBCenterSearchItem): JBCenterIntentRow;
+/** Deployed rows win ties so a list never reorders once an intent lands. */
+export declare function mergeSearch<T extends {
+    createdAt: number;
+}>(rows: readonly T[], items: readonly JBCenterSearchItem[]): (T | JBCenterIntentRow)[];
+export declare function intentPath(intentId: string): string;
+export declare function deployedChains(intent: JBCenterIntent<JBCenterJsonObject>): Record<number, string>;
+export declare function isFullyDeployed(intent: JBCenterIntent<JBCenterJsonObject>): boolean;
+//# sourceMappingURL=merge.d.ts.map

package/dist/esm/jbcenter/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/jbcenter/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAarE;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EACzD,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,CAAC,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAiB3B;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,GACzC,OAAO,CAIT"}

package/dist/esm/jbcenter/merge.js

@@ -0,0 +1,44 @@
+export function intentRow(item) {
+    const createdAt = Date.parse(item.createdAt);
+    return {
+        undeployed: true,
+        intentId: item.intentId,
+        name: item.name,
+        tagline: item.tagline,
+        logoUri: item.logoUri,
+        owner: item.owner,
+        chainIds: item.chainIds,
+        createdAt: Number.isNaN(createdAt) ? 0 : Math.floor(createdAt / 1000),
+    };
+}
+/** Deployed rows win ties so a list never reorders once an intent lands. */
+export function mergeSearch(rows, items) {
+    const entries = [
+        ...rows.map((value) => ({ value, isRow: true })),
+        ...items.map((item) => ({ value: intentRow(item), isRow: false })),
+    ];
+    entries.sort((a, b) => {
+        if (a.value.createdAt !== b.value.createdAt) {
+            return b.value.createdAt - a.value.createdAt;
+        }
+        if (a.isRow !== b.isRow)
+            return a.isRow ? -1 : 1;
+        return 0;
+    });
+    return entries.map((entry) => entry.value);
+}
+export function intentPath(intentId) {
+    return `/intent/${encodeURIComponent(intentId)}`;
+}
+export function deployedChains(intent) {
+    const result = {};
+    for (const deployment of intent.deployments) {
+        result[deployment.chainId] = deployment.projectId;
+    }
+    return result;
+}
+export function isFullyDeployed(intent) {
+    const deployed = deployedChains(intent);
+    return intent.envelope.chainIds.every((chainId) => chainId in deployed);
+}
+//# sourceMappingURL=merge.js.map

package/dist/esm/jbcenter/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/jbcenter/merge.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7C,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CACzB,IAAkB,EAClB,KAAoC;IAIpC,MAAM,OAAO,GAAY;QACvB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;KAC1E,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAC5C,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,WAAW,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAA0C;IAE1C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAA0C;IAE1C,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAExC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/esm/jbcenter/publish.d.ts

@@ -0,0 +1,26 @@
+import type { Address, Hex } from "viem";
+import type { JBCenterClient, JBCenterIntent, JBCenterIntentInput, JBCenterJsonObject, JBCenterRequestOptions } from "../jbcenter.js";
+/** JB Center prepared something other than the intent the caller built. */
+export declare class JBCenterIntentMismatchError extends Error {
+    readonly reason: "envelope" | "message";
+    constructor(reason: "envelope" | "message");
+}
+export type PublishSignedIntentOptions = {
+    /** The address whose signature `sign` returns. */
+    publisher: Address;
+    /**
+     * The whole message the publisher may be asked to sign for a content hash.
+     * Defaults to JB Center's own signing message.
+     */
+    expectMessage?: (contentHash: Hex) => string;
+    request?: JBCenterRequestOptions;
+};
+/**
+ * Publish an intent, signing only JB Center's prepared message and only once
+ * it has been checked: the prepared envelope must carry the same values as
+ * the intent built here, and the message must be the whole signing message
+ * for the content hash of what is being signed. `sign` is the caller's own
+ * signer; this package never reaches a wallet itself.
+ */
+export declare function publishSignedIntent<TJb extends JBCenterJsonObject>(client: JBCenterClient, intent: JBCenterIntentInput<TJb>, sign: (message: string) => Promise<Hex>, options: PublishSignedIntentOptions): Promise<JBCenterIntent<TJb>>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/esm/jbcenter/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/jbcenter/publish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AA+DxB,2EAA2E;AAC3E,qBAAa,2BAA4B,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS;gBAA9B,MAAM,EAAE,UAAU,GAAG,SAAS;CAQpD;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,MAAM,CAAC;IAC7C,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,SAAS,kBAAkB,EACtE,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAmB9B"}

package/dist/esm/jbcenter/publish.js

@@ -0,0 +1,81 @@
+/**
+ * Key order and the casing of addresses and calldata are JB Center's to
+ * choose; the values are not. Sorting keys and lowercasing hex long enough to
+ * be an address or calldata puts both sides in one form so the comparison
+ * reads values only. Shorter hex-looking text is a value like any other and is
+ * compared as written.
+ */
+function canonical(value) {
+    return JSON.stringify(value, (_key, item) => {
+        if (typeof item === "string") {
+            return /^0x[0-9a-fA-F]{40,}$/u.test(item) ? item.toLowerCase() : item;
+        }
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return item;
+        return Object.fromEntries(Object.entries(item).sort(([a], [b]) => a < b ? -1 : 1));
+    });
+}
+/**
+ * The shape JB Center normalizes an envelope into before it hashes: unique
+ * chain ids in ascending order, deployment calls in the same order, and
+ * `format` and `deploymentVersion` without surrounding space.
+ */
+function normalized(envelope) {
+    return {
+        ...envelope,
+        format: envelope.format.trim(),
+        deploymentVersion: envelope.deploymentVersion.trim(),
+        chainIds: [...new Set(envelope.chainIds)].sort((a, b) => a - b),
+        deploymentCalls: [...envelope.deploymentCalls].sort((a, b) => a.chainId - b.chainId),
+    };
+}
+/** A copy of its own, so what is checked is what is published even if the
+ * caller keeps writing to its object while the signer is open. */
+function snapshot(envelope) {
+    return JSON.parse(JSON.stringify(envelope));
+}
+/** JB Center's own signing message, word for word. */
+function centerSigningMessage(contentHash) {
+    return `Juice Central project intent\nVersion: 1\nContent hash: ${contentHash}`;
+}
+/** The casing of the hash JB Center echoes is its to choose; every other
+ * character of the message is not. */
+function withLowercaseHash(message, contentHash) {
+    const at = message.toLowerCase().indexOf(contentHash);
+    if (at === -1)
+        return message;
+    return `${message.slice(0, at)}${contentHash}${message.slice(at + contentHash.length)}`;
+}
+/** JB Center prepared something other than the intent the caller built. */
+export class JBCenterIntentMismatchError extends Error {
+    constructor(reason) {
+        super(reason === "envelope"
+            ? "JB Center prepared a different intent than the one built here"
+            : "JB Center's prepared message is not Center's signing message for that content hash");
+        this.reason = reason;
+        this.name = "JBCenterIntentMismatchError";
+    }
+}
+/**
+ * Publish an intent, signing only JB Center's prepared message and only once
+ * it has been checked: the prepared envelope must carry the same values as
+ * the intent built here, and the message must be the whole signing message
+ * for the content hash of what is being signed. `sign` is the caller's own
+ * signer; this package never reaches a wallet itself.
+ */
+export async function publishSignedIntent(client, intent, sign, options) {
+    const checked = snapshot(normalized(intent));
+    const prepared = await client.prepareIntent(checked, options.request);
+    if (canonical(normalized(prepared.envelope)) !== canonical(checked)) {
+        throw new JBCenterIntentMismatchError("envelope");
+    }
+    const contentHash = prepared.contentHash.toLowerCase();
+    const expected = (options.expectMessage ?? centerSigningMessage)(contentHash);
+    if (withLowercaseHash(prepared.message, contentHash) !==
+        withLowercaseHash(expected, contentHash)) {
+        throw new JBCenterIntentMismatchError("message");
+    }
+    const signature = await sign(prepared.message);
+    return client.publishIntent({ ...checked, publisher: options.publisher, signature }, options.request);
+}
+//# sourceMappingURL=publish.js.map

package/dist/esm/jbcenter/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/jbcenter/publish.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1E,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAChE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACf,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CACjB,QAAkC;IAElC,OAAO;QACL,GAAG,QAAQ;QACX,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;QAC9B,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE;QACpD,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,eAAe,EAAE,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAChC;KACF,CAAC;AACJ,CAAC;AAED;kEACkE;AAClE,SAAS,QAAQ,CACf,QAAkC;IAElC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAA6B,CAAC;AAC1E,CAAC;AAED,sDAAsD;AACtD,SAAS,oBAAoB,CAAC,WAAgB;IAC5C,OAAO,2DAA2D,WAAW,EAAE,CAAC;AAClF,CAAC;AAED;sCACsC;AACtC,SAAS,iBAAiB,CAAC,OAAe,EAAE,WAAgB;IAC1D,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED,2EAA2E;AAC3E,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpD,YAAqB,MAA8B;QACjD,KAAK,CACH,MAAM,KAAK,UAAU;YACnB,CAAC,CAAC,+DAA+D;YACjE,CAAC,CAAC,oFAAoF,CACzF,CAAC;QALiB,WAAM,GAAN,MAAM,CAAwB;QAMjD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAaD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAsB,EACtB,MAAgC,EAChC,IAAuC,EACvC,OAAmC;IAEnC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAS,CAAC;IAC9D,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,oBAAoB,CAAC,CAAC,WAAW,CAAC,CAAC;IAC9E,IACE,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;QAChD,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,EACxC,CAAC;QACD,MAAM,IAAI,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,aAAa,CACzB,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,EACvD,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC"}

package/dist/esm/jbcenter/refusal.d.ts

@@ -0,0 +1,12 @@
+export type JBCenterRefusalCode = "sponsor_quota" | "sponsor_budget" | "unavailable" | "rate_limited";
+export type JBCenterRefusal = {
+    code: JBCenterRefusalCode;
+    message: string;
+};
+/**
+ * The sentence to show when JB Center declines to sponsor a deploy, or `null`
+ * when the failure is something else and the caller should keep its own
+ * wording.
+ */
+export declare function describeCenterRefusal(error: unknown): JBCenterRefusal | null;
+//# sourceMappingURL=refusal.d.ts.map

package/dist/esm/jbcenter/refusal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../../../src/jbcenter/refusal.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAgBF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAY5E"}