@bananapus/nana-sdk-core 2.5.1 → 2.6.0

package/dist/cjs/safe.d.ts

@@ -0,0 +1,208 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+export declare const SAFE_FACTORY: `0x${string}`;
+export declare const SAFE_SINGLETON: `0x${string}`;
+export declare const SAFE_FALLBACK: `0x${string}`;
+export declare const MULTICALL3: `0x${string}`;
+export declare const MAX_SAFE_OWNERS = 50;
+export declare const SAFE_CREATE_ABI: readonly [{
+    readonly name: "proxyCreationCode";
+    readonly type: "function";
+    readonly stateMutability: "pure";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes";
+    }];
+}, {
+    readonly name: "createProxyWithNonce";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "singleton";
+    }, {
+        readonly type: "bytes";
+        readonly name: "initializer";
+    }, {
+        readonly type: "uint256";
+        readonly name: "saltNonce";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+        readonly name: "proxy";
+    }];
+}, {
+    readonly name: "setup";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address[]";
+        readonly name: "owners";
+    }, {
+        readonly type: "uint256";
+        readonly name: "threshold";
+    }, {
+        readonly type: "address";
+        readonly name: "to";
+    }, {
+        readonly type: "bytes";
+        readonly name: "data";
+    }, {
+        readonly type: "address";
+        readonly name: "fallbackHandler";
+    }, {
+        readonly type: "address";
+        readonly name: "paymentToken";
+    }, {
+        readonly type: "uint256";
+        readonly name: "payment";
+    }, {
+        readonly type: "address";
+        readonly name: "paymentReceiver";
+    }];
+    readonly outputs: readonly [];
+}];
+export declare const CREATE_BATCH_ABI: readonly [{
+    readonly name: "aggregate3Value";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly type: "address";
+            readonly name: "target";
+        }, {
+            readonly type: "bool";
+            readonly name: "allowFailure";
+        }, {
+            readonly type: "uint256";
+            readonly name: "value";
+        }, {
+            readonly type: "bytes";
+            readonly name: "callData";
+        }];
+        readonly name: "calls";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly type: "bool";
+            readonly name: "success";
+        }, {
+            readonly type: "bytes";
+            readonly name: "returnData";
+        }];
+        readonly name: "returnData";
+    }];
+}];
+export type SafeDeploymentPlan = {
+    owners: Address[];
+    threshold: number;
+    saltNonce: Hex;
+    proxyCreationCode: Hex;
+    address: Address;
+};
+export type SafeCall = {
+    to: Address;
+    data: Hex;
+    value: bigint;
+};
+export type SafeAddressInput = {
+    kind: "existing";
+    address: Address;
+} | {
+    kind: "create";
+    owners: Address[];
+    threshold: number;
+    saltNonce: Hex;
+};
+export type SafeVerificationOptions = {
+    /** Missing code is allowed only for a preflight check, never receipt acceptance. */
+    allowMissing?: boolean;
+    /** Use the receipt block to recover a launch even after subsequent owner changes. */
+    blockNumber?: bigint;
+};
+/** Plain Safe only: no delegatecall hook, modules, guard, or setup payments. */
+export declare function buildSafeInitializer(policy: {
+    owners: readonly Address[];
+    threshold: number;
+}): Hex;
+/** Owner order and the original 32-byte salt are part of the deterministic address. */
+export declare function predictSafeAddress(plan: Omit<SafeDeploymentPlan, "address">): Address;
+export declare function validateSafeDeploymentPlan(plan: SafeDeploymentPlan): void;
+/** Check canonical dependencies before trusting factory-returned creation code. */
+export declare function readSafeCreationCode(client: PublicClient): Promise<Hex>;
+/** Existing inputs are address-only: this does not certify an arbitrary address as a Safe. */
+export declare function resolveSafeAddress(input: SafeAddressInput, clients: readonly PublicClient[]): Promise<{
+    address: Address;
+    plan?: SafeDeploymentPlan;
+}>;
+/**
+ * Certify this module's plain Safe profile, failing closed on malformed state or RPC errors.
+ * Receipt recovery pins every code, storage, and raw policy read to blockNumber.
+ * Contract signers are supported; this verifies their membership, not their own policy.
+ */
+export declare function verifySafeDeployments(client: PublicClient, plans: readonly SafeDeploymentPlan[], options?: SafeVerificationOptions): Promise<boolean>;
+export declare function checkSafeDeployments(client: PublicClient, plans?: readonly SafeDeploymentPlan[]): Promise<void>;
+/** Optional factory calls are idempotent only with preflight, simulation, and receipt verification. */
+export declare function buildSafeDeploymentCalls(plans: readonly SafeDeploymentPlan[]): {
+    target: `0x${string}`;
+    allowFailure: true;
+    value: bigint;
+    callData: `0x${string}`;
+}[];
+export declare function buildSafeDeploymentTx(chainId: number, plans: readonly SafeDeploymentPlan[]): {
+    chainId: number;
+    address: `0x${string}`;
+    abi: readonly [{
+        readonly name: "aggregate3Value";
+        readonly type: "function";
+        readonly stateMutability: "payable";
+        readonly inputs: readonly [{
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly type: "address";
+                readonly name: "target";
+            }, {
+                readonly type: "bool";
+                readonly name: "allowFailure";
+            }, {
+                readonly type: "uint256";
+                readonly name: "value";
+            }, {
+                readonly type: "bytes";
+                readonly name: "callData";
+            }];
+            readonly name: "calls";
+        }];
+        readonly outputs: readonly [{
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly type: "bool";
+                readonly name: "success";
+            }, {
+                readonly type: "bytes";
+                readonly name: "returnData";
+            }];
+            readonly name: "returnData";
+        }];
+    }];
+    functionName: "aggregate3Value";
+    args: readonly [{
+        target: `0x${string}`;
+        allowFailure: true;
+        value: bigint;
+        callData: `0x${string}`;
+    }[]];
+    value: bigint;
+};
+/**
+ * Multicall3 changes msg.sender. Use only a sender-independent or already authenticated
+ * forwarded launch. This helper cannot decide the launch contract's authorization semantics.
+ * Simulate the returned call, verifySafeLaunchSimulation, then verify receipt-block state.
+ */
+export declare function bundleSafeLaunch(call: SafeCall, plans?: readonly SafeDeploymentPlan[]): SafeCall;
+/** Require the exact reviewed factory calls, their order, one mandatory launch, and its value. */
+export declare function unbundleSafeLaunch(call: SafeCall, plans?: readonly SafeDeploymentPlan[]): SafeCall;
+/** Outer simulation success is insufficient: an optional deployment may have failed. */
+export declare function verifySafeLaunchSimulation(client: PublicClient, plans?: readonly SafeDeploymentPlan[], data?: Hex): Promise<void>;
+//# sourceMappingURL=safe.d.ts.map

package/dist/cjs/safe.d.ts.map

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

package/dist/cjs/safe.js

@@ -0,0 +1,396 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREATE_BATCH_ABI = exports.SAFE_CREATE_ABI = exports.MAX_SAFE_OWNERS = exports.MULTICALL3 = exports.SAFE_FALLBACK = exports.SAFE_SINGLETON = exports.SAFE_FACTORY = void 0;
+exports.buildSafeInitializer = buildSafeInitializer;
+exports.predictSafeAddress = predictSafeAddress;
+exports.validateSafeDeploymentPlan = validateSafeDeploymentPlan;
+exports.readSafeCreationCode = readSafeCreationCode;
+exports.resolveSafeAddress = resolveSafeAddress;
+exports.verifySafeDeployments = verifySafeDeployments;
+exports.checkSafeDeployments = checkSafeDeployments;
+exports.buildSafeDeploymentCalls = buildSafeDeploymentCalls;
+exports.buildSafeDeploymentTx = buildSafeDeploymentTx;
+exports.bundleSafeLaunch = bundleSafeLaunch;
+exports.unbundleSafeLaunch = unbundleSafeLaunch;
+exports.verifySafeLaunchSimulation = verifySafeLaunchSimulation;
+const viem_1 = require("viem");
+// Canonical Safe 1.4.1 deployments, from safe-global/safe-deployments.
+// A fixed singleton and initializer preserve CREATE2 addresses across chains.
+exports.SAFE_FACTORY = (0, viem_1.getAddress)("0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67");
+exports.SAFE_SINGLETON = (0, viem_1.getAddress)("0x41675C099F32341bf84BFc5382aF534df5C7461a");
+exports.SAFE_FALLBACK = (0, viem_1.getAddress)("0xfd0732Dc9E303f09fCEf3a7388Ad10A83459Ec99");
+exports.MULTICALL3 = (0, viem_1.getAddress)("0xcA11bde05977b3631167028862bE2a173976CA11");
+exports.MAX_SAFE_OWNERS = 50;
+const contracts = [
+    [
+        exports.SAFE_FACTORY,
+        "0x50c3cdc4074750a7a974204a716c999edd37482f907608d960b2b025ee0b3317",
+    ],
+    [
+        exports.SAFE_SINGLETON,
+        "0x1fe2df852ba3299d6534ef416eefa406e56ced995bca886ab7a553e6d0c5e1c4",
+    ],
+    [
+        exports.SAFE_FALLBACK,
+        "0x7c6007a5d711cea8dfd5d91f5940ec29c7f200fe511eb1fc1397b367af3c42f9",
+    ],
+];
+const PROXY_CODE_HASH = "0xd7d408ebcd99b2b70be43e20253d6d92a8ea8fab29bd3be7f55b10032331fb4c";
+const SENTINEL = "0x0000000000000000000000000000000000000001";
+const SINGLETON_SLOT = (0, viem_1.toHex)(0n, { size: 32 });
+const GUARD_SLOT = "0x4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c8";
+const FALLBACK_SLOT = "0x6c9a6c4a39284e37ed1cf53d337577d14212a4870fb976a4366c693b939918d5";
+exports.SAFE_CREATE_ABI = (0, viem_1.parseAbi)([
+    "function proxyCreationCode() pure returns (bytes)",
+    "function createProxyWithNonce(address singleton, bytes initializer, uint256 saltNonce) returns (address proxy)",
+    "function setup(address[] owners,uint256 threshold,address to,bytes data,address fallbackHandler,address paymentToken,uint256 payment,address paymentReceiver)",
+]);
+exports.CREATE_BATCH_ABI = (0, viem_1.parseAbi)([
+    "function aggregate3Value((address target,bool allowFailure,uint256 value,bytes callData)[] calls) payable returns ((bool success,bytes returnData)[] returnData)",
+]);
+const READ_ABI = (0, viem_1.parseAbi)([
+    "function masterCopy() view returns (address)",
+    "function VERSION() view returns (string)",
+    "function getThreshold() view returns (uint256)",
+    "function getOwners() view returns (address[])",
+    "function getModulesPaginated(address start,uint256 pageSize) view returns (address[],address)",
+]);
+function validAddress(address) {
+    return (0, viem_1.isAddress)(address) && BigInt(address) > 1n;
+}
+/** Plain Safe only: no delegatecall hook, modules, guard, or setup payments. */
+function buildSafeInitializer(policy) {
+    if (!Array.isArray(policy.owners) ||
+        policy.owners.length < 1 ||
+        policy.owners.length > exports.MAX_SAFE_OWNERS ||
+        policy.owners.some((owner) => !validAddress(owner)) ||
+        new Set(policy.owners.map((owner) => owner.toLowerCase())).size !==
+            policy.owners.length)
+        throw new Error("A Safe needs 1–50 unique nonzero, nonsentinel owner addresses.");
+    if (!Number.isInteger(policy.threshold) ||
+        policy.threshold < 1 ||
+        policy.threshold > policy.owners.length) {
+        throw new Error("Invalid Safe approval policy.");
+    }
+    return (0, viem_1.encodeFunctionData)({
+        abi: exports.SAFE_CREATE_ABI,
+        functionName: "setup",
+        args: [
+            policy.owners,
+            BigInt(policy.threshold),
+            viem_1.zeroAddress,
+            "0x",
+            exports.SAFE_FALLBACK,
+            viem_1.zeroAddress,
+            0n,
+            viem_1.zeroAddress,
+        ],
+    });
+}
+/** Owner order and the original 32-byte salt are part of the deterministic address. */
+function predictSafeAddress(plan) {
+    if (!/^0x[\da-f]{64}$/i.test(plan.saltNonce) ||
+        !/^0x(?:[\da-f]{2}){1,2048}$/i.test(plan.proxyCreationCode)) {
+        throw new Error("Invalid Safe deployment record.");
+    }
+    const salt = (0, viem_1.keccak256)((0, viem_1.encodePacked)(["bytes32", "uint256"], [(0, viem_1.keccak256)(buildSafeInitializer(plan)), BigInt(plan.saltNonce)]));
+    return (0, viem_1.getContractAddress)({
+        opcode: "CREATE2",
+        from: exports.SAFE_FACTORY,
+        salt,
+        bytecode: (0, viem_1.concatHex)([
+            plan.proxyCreationCode,
+            (0, viem_1.toHex)(BigInt(exports.SAFE_SINGLETON), { size: 32 }),
+        ]),
+    });
+}
+function validateSafeDeploymentPlan(plan) {
+    if (!validAddress(plan.address) ||
+        !(0, viem_1.isAddressEqual)(predictSafeAddress(plan), plan.address)) {
+        throw new Error("The Safe address differs from its saved owners and policy.");
+    }
+}
+function validatePlans(plans) {
+    if (!Array.isArray(plans))
+        throw new Error("Invalid Safe deployment plans.");
+    plans.forEach(validateSafeDeploymentPlan);
+    if (new Set(plans.map((plan) => plan.address.toLowerCase())).size !==
+        plans.length) {
+        throw new Error("Duplicate Safe deployment plans.");
+    }
+}
+function codeMatches(code, hash) {
+    return (typeof code === "string" &&
+        /^0x(?:[\da-f]{2}){1,24576}$/i.test(code) &&
+        (0, viem_1.keccak256)(code) === hash);
+}
+/** Check canonical dependencies before trusting factory-returned creation code. */
+async function readSafeCreationCode(client) {
+    await Promise.all(contracts.map(async ([address, hash]) => {
+        if (!codeMatches(await client.getCode({ address }), hash)) {
+            throw new Error(`The canonical Safe 1.4.1 contract is unavailable at ${address}.`);
+        }
+    }));
+    const proxyCreationCode = await client.readContract({
+        address: exports.SAFE_FACTORY,
+        abi: exports.SAFE_CREATE_ABI,
+        functionName: "proxyCreationCode",
+    });
+    if (!/^0x(?:[\da-f]{2}){1,2048}$/i.test(proxyCreationCode))
+        throw new Error("Invalid Safe proxy creation code.");
+    return proxyCreationCode;
+}
+/** Existing inputs are address-only: this does not certify an arbitrary address as a Safe. */
+async function resolveSafeAddress(input, clients) {
+    if (input.kind === "existing") {
+        if (!validAddress(input.address))
+            throw new Error("Enter a valid existing Safe address.");
+        return { address: (0, viem_1.getAddress)(input.address) };
+    }
+    if (input.kind !== "create")
+        throw new Error("Invalid Safe address input.");
+    // Validate local inputs before any network request.
+    buildSafeInitializer(input);
+    if (!/^0x[\da-f]{64}$/i.test(input.saltNonce))
+        throw new Error("Invalid Safe deployment salt.");
+    if (!clients.length)
+        throw new Error("Select at least one network to create a Safe.");
+    const codes = await Promise.all(clients.map(readSafeCreationCode));
+    if (codes.some((code) => code.toLowerCase() !== codes[0].toLowerCase()))
+        throw new Error("Safe creation code differs across the selected networks.");
+    const policy = {
+        owners: input.owners.map((owner) => (0, viem_1.getAddress)(owner)),
+        threshold: input.threshold,
+        saltNonce: input.saltNonce,
+        proxyCreationCode: codes[0],
+    };
+    const plan = { ...policy, address: predictSafeAddress(policy) };
+    return { address: plan.address, plan };
+}
+async function boundedCall(client, address, data, gas, maxBytes, blockNumber) {
+    // Raw RPC cannot follow a contract-selected CCIP/OffchainLookup URL.
+    const result = await client.request({
+        method: "eth_call",
+        params: [
+            { to: address, data, gas: (0, viem_1.toHex)(gas) },
+            blockNumber === undefined ? "latest" : (0, viem_1.toHex)(blockNumber),
+        ],
+    });
+    if (typeof result !== "string" ||
+        !/^0x(?:[\da-f]{2})*$/i.test(result) ||
+        result.length > 2 + maxBytes * 2) {
+        throw new Error("Invalid or oversized Safe policy response.");
+    }
+    return result;
+}
+/**
+ * Certify this module's plain Safe profile, failing closed on malformed state or RPC errors.
+ * Receipt recovery pins every code, storage, and raw policy read to blockNumber.
+ * Contract signers are supported; this verifies their membership, not their own policy.
+ */
+async function verifySafeDeployments(client, plans, options = {}) {
+    validatePlans(plans);
+    const { blockNumber, allowMissing = false } = options;
+    if (blockNumber !== undefined && blockNumber < 0n)
+        throw new Error("Invalid Safe verification block.");
+    let complete = true;
+    for (const plan of plans) {
+        const code = await client.getCode({ address: plan.address, blockNumber });
+        if (allowMissing && (code === undefined || code === "0x")) {
+            complete = false;
+            continue;
+        }
+        const mismatch = () => new Error(`The Safe at ${plan.address} does not match its reviewed owners and policy.`);
+        if (!codeMatches(code, PROXY_CODE_HASH))
+            throw mismatch();
+        const singleton = await client.getStorageAt({
+            address: plan.address,
+            slot: SINGLETON_SLOT,
+            blockNumber,
+        });
+        if (singleton?.toLowerCase() !==
+            (0, viem_1.toHex)(BigInt(exports.SAFE_SINGLETON), { size: 32 }).toLowerCase())
+            throw mismatch();
+        // Do not delegate through a claimed implementation before checking its exact runtime.
+        for (const [address, hash] of contracts.slice(1)) {
+            if (!codeMatches(await client.getCode({ address, blockNumber }), hash))
+                throw mismatch();
+        }
+        const call = (data, maxBytes, gas = 100000n) => boundedCall(client, plan.address, data, gas, maxBytes, blockNumber);
+        const [masterCopy, version, threshold, ownersData, modules, guard, fallback,] = await Promise.all([
+            call((0, viem_1.encodeFunctionData)({ abi: READ_ABI, functionName: "masterCopy" }), 32),
+            call((0, viem_1.encodeFunctionData)({ abi: READ_ABI, functionName: "VERSION" }), 96),
+            call((0, viem_1.encodeFunctionData)({ abi: READ_ABI, functionName: "getThreshold" }), 32),
+            call((0, viem_1.encodeFunctionData)({ abi: READ_ABI, functionName: "getOwners" }), 64 + exports.MAX_SAFE_OWNERS * 32, 400000n),
+            call((0, viem_1.encodeFunctionData)({
+                abi: READ_ABI,
+                functionName: "getModulesPaginated",
+                args: [SENTINEL, 1n],
+            }), 128, 500000n),
+            client.getStorageAt({
+                address: plan.address,
+                slot: GUARD_SLOT,
+                blockNumber,
+            }),
+            client.getStorageAt({
+                address: plan.address,
+                slot: FALLBACK_SLOT,
+                blockNumber,
+            }),
+        ]);
+        if (masterCopy.toLowerCase() !==
+            (0, viem_1.toHex)(BigInt(exports.SAFE_SINGLETON), { size: 32 }).toLowerCase() ||
+            version.toLowerCase() !==
+                (0, viem_1.encodeFunctionResult)({
+                    abi: READ_ABI,
+                    functionName: "VERSION",
+                    result: "1.4.1",
+                }).toLowerCase() ||
+            threshold.toLowerCase() !==
+                (0, viem_1.toHex)(BigInt(plan.threshold), { size: 32 }).toLowerCase() ||
+            modules.toLowerCase() !==
+                (0, viem_1.encodeFunctionResult)({
+                    abi: READ_ABI,
+                    functionName: "getModulesPaginated",
+                    result: [[], SENTINEL],
+                }).toLowerCase() ||
+            guard?.toLowerCase() !== (0, viem_1.toHex)(0n, { size: 32 }) ||
+            fallback?.toLowerCase() !==
+                (0, viem_1.toHex)(BigInt(exports.SAFE_FALLBACK), { size: 32 }).toLowerCase() ||
+            ownersData.length !== 2 + (64 + plan.owners.length * 32) * 2 ||
+            ownersData.slice(2, 66).toLowerCase() !==
+                (0, viem_1.toHex)(32n, { size: 32 }).slice(2) ||
+            ownersData.slice(66, 130).toLowerCase() !==
+                (0, viem_1.toHex)(BigInt(plan.owners.length), { size: 32 }).slice(2))
+            throw mismatch();
+        const owners = (0, viem_1.decodeFunctionResult)({
+            abi: READ_ABI,
+            functionName: "getOwners",
+            data: ownersData,
+        });
+        if (new Set(owners.map((owner) => owner.toLowerCase())).size !==
+            plan.owners.length ||
+            plan.owners.some((owner) => !owners.some((actual) => (0, viem_1.isAddressEqual)(actual, owner))))
+            throw mismatch();
+    }
+    return complete;
+}
+async function checkSafeDeployments(client, plans = []) {
+    if (!plans.length)
+        return;
+    validatePlans(plans);
+    const code = await readSafeCreationCode(client);
+    if (plans.some((plan) => plan.proxyCreationCode.toLowerCase() !== code.toLowerCase()))
+        throw new Error("The saved Safe creation code changed.");
+    await verifySafeDeployments(client, plans, { allowMissing: true });
+}
+/** Optional factory calls are idempotent only with preflight, simulation, and receipt verification. */
+function buildSafeDeploymentCalls(plans) {
+    validatePlans(plans);
+    return plans.map((plan) => ({
+        target: exports.SAFE_FACTORY,
+        allowFailure: true,
+        value: 0n,
+        callData: (0, viem_1.encodeFunctionData)({
+            abi: exports.SAFE_CREATE_ABI,
+            functionName: "createProxyWithNonce",
+            args: [
+                exports.SAFE_SINGLETON,
+                buildSafeInitializer(plan),
+                BigInt(plan.saltNonce),
+            ],
+        }),
+    }));
+}
+function buildSafeDeploymentTx(chainId, plans) {
+    if (!Number.isSafeInteger(chainId) || chainId <= 0)
+        throw new Error("Invalid Safe deployment chain.");
+    return {
+        chainId,
+        address: exports.MULTICALL3,
+        abi: exports.CREATE_BATCH_ABI,
+        functionName: "aggregate3Value",
+        args: [buildSafeDeploymentCalls(plans)],
+        value: 0n,
+    };
+}
+/**
+ * Multicall3 changes msg.sender. Use only a sender-independent or already authenticated
+ * forwarded launch. This helper cannot decide the launch contract's authorization semantics.
+ * Simulate the returned call, verifySafeLaunchSimulation, then verify receipt-block state.
+ */
+function bundleSafeLaunch(call, plans = []) {
+    if (!plans.length)
+        return call;
+    if (!validAddress(call.to) ||
+        !/^0x(?:[\da-f]{2})*$/i.test(call.data) ||
+        typeof call.value !== "bigint" ||
+        call.value < 0n)
+        throw new Error("Invalid Safe launch call.");
+    const calls = [
+        ...buildSafeDeploymentCalls(plans),
+        {
+            target: call.to,
+            allowFailure: false,
+            value: call.value,
+            callData: call.data,
+        },
+    ];
+    return {
+        to: exports.MULTICALL3,
+        value: call.value,
+        data: (0, viem_1.encodeFunctionData)({
+            abi: exports.CREATE_BATCH_ABI,
+            functionName: "aggregate3Value",
+            args: [calls],
+        }),
+    };
+}
+/** Require the exact reviewed factory calls, their order, one mandatory launch, and its value. */
+function unbundleSafeLaunch(call, plans = []) {
+    if (!plans.length)
+        return call;
+    if (!(0, viem_1.isAddressEqual)(call.to, exports.MULTICALL3))
+        throw new Error("The saved Safe launch is not a creation batch.");
+    const { args } = (0, viem_1.decodeFunctionData)({
+        abi: exports.CREATE_BATCH_ABI,
+        data: call.data,
+    });
+    const last = args[0][args[0].length - 1];
+    if (!last)
+        throw new Error("The saved creation batch is empty.");
+    const inner = { to: last.target, data: last.callData, value: call.value };
+    if (bundleSafeLaunch(inner, plans).data.toLowerCase() !==
+        call.data.toLowerCase())
+        throw new Error("The saved creation batch differs from its reviewed Safes and launch.");
+    return inner;
+}
+/** Outer simulation success is insufficient: an optional deployment may have failed. */
+async function verifySafeLaunchSimulation(client, plans = [], data) {
+    if (!plans.length)
+        return;
+    validatePlans(plans);
+    if (!data)
+        throw new Error("The Safe creation simulation returned no results.");
+    const results = (0, viem_1.decodeFunctionResult)({
+        abi: exports.CREATE_BATCH_ABI,
+        functionName: "aggregate3Value",
+        data,
+    });
+    if (results.length !== plans.length + 1 ||
+        !results[results.length - 1].success)
+        throw new Error("The creation batch did not simulate every required call.");
+    for (const [index, plan] of plans.entries()) {
+        const result = results[index];
+        if (result.success) {
+            if (result.returnData.toLowerCase() !==
+                (0, viem_1.toHex)(BigInt(plan.address), { size: 32 }).toLowerCase())
+                throw new Error("The simulated factory returned a different Safe address.");
+        }
+        else {
+            // Only an already-deployed Safe with the exact policy can explain an accepted failure.
+            await verifySafeDeployments(client, [plan]);
+        }
+    }
+}
+//# sourceMappingURL=safe.js.map

package/dist/cjs/safe.js.map

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

package/dist/esm/safe.d.ts

@@ -0,0 +1,208 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+export declare const SAFE_FACTORY: `0x${string}`;
+export declare const SAFE_SINGLETON: `0x${string}`;
+export declare const SAFE_FALLBACK: `0x${string}`;
+export declare const MULTICALL3: `0x${string}`;
+export declare const MAX_SAFE_OWNERS = 50;
+export declare const SAFE_CREATE_ABI: readonly [{
+    readonly name: "proxyCreationCode";
+    readonly type: "function";
+    readonly stateMutability: "pure";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes";
+    }];
+}, {
+    readonly name: "createProxyWithNonce";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "singleton";
+    }, {
+        readonly type: "bytes";
+        readonly name: "initializer";
+    }, {
+        readonly type: "uint256";
+        readonly name: "saltNonce";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+        readonly name: "proxy";
+    }];
+}, {
+    readonly name: "setup";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address[]";
+        readonly name: "owners";
+    }, {
+        readonly type: "uint256";
+        readonly name: "threshold";
+    }, {
+        readonly type: "address";
+        readonly name: "to";
+    }, {
+        readonly type: "bytes";
+        readonly name: "data";
+    }, {
+        readonly type: "address";
+        readonly name: "fallbackHandler";
+    }, {
+        readonly type: "address";
+        readonly name: "paymentToken";
+    }, {
+        readonly type: "uint256";
+        readonly name: "payment";
+    }, {
+        readonly type: "address";
+        readonly name: "paymentReceiver";
+    }];
+    readonly outputs: readonly [];
+}];
+export declare const CREATE_BATCH_ABI: readonly [{
+    readonly name: "aggregate3Value";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly type: "address";
+            readonly name: "target";
+        }, {
+            readonly type: "bool";
+            readonly name: "allowFailure";
+        }, {
+            readonly type: "uint256";
+            readonly name: "value";
+        }, {
+            readonly type: "bytes";
+            readonly name: "callData";
+        }];
+        readonly name: "calls";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly type: "bool";
+            readonly name: "success";
+        }, {
+            readonly type: "bytes";
+            readonly name: "returnData";
+        }];
+        readonly name: "returnData";
+    }];
+}];
+export type SafeDeploymentPlan = {
+    owners: Address[];
+    threshold: number;
+    saltNonce: Hex;
+    proxyCreationCode: Hex;
+    address: Address;
+};
+export type SafeCall = {
+    to: Address;
+    data: Hex;
+    value: bigint;
+};
+export type SafeAddressInput = {
+    kind: "existing";
+    address: Address;
+} | {
+    kind: "create";
+    owners: Address[];
+    threshold: number;
+    saltNonce: Hex;
+};
+export type SafeVerificationOptions = {
+    /** Missing code is allowed only for a preflight check, never receipt acceptance. */
+    allowMissing?: boolean;
+    /** Use the receipt block to recover a launch even after subsequent owner changes. */
+    blockNumber?: bigint;
+};
+/** Plain Safe only: no delegatecall hook, modules, guard, or setup payments. */
+export declare function buildSafeInitializer(policy: {
+    owners: readonly Address[];
+    threshold: number;
+}): Hex;
+/** Owner order and the original 32-byte salt are part of the deterministic address. */
+export declare function predictSafeAddress(plan: Omit<SafeDeploymentPlan, "address">): Address;
+export declare function validateSafeDeploymentPlan(plan: SafeDeploymentPlan): void;
+/** Check canonical dependencies before trusting factory-returned creation code. */
+export declare function readSafeCreationCode(client: PublicClient): Promise<Hex>;
+/** Existing inputs are address-only: this does not certify an arbitrary address as a Safe. */
+export declare function resolveSafeAddress(input: SafeAddressInput, clients: readonly PublicClient[]): Promise<{
+    address: Address;
+    plan?: SafeDeploymentPlan;
+}>;
+/**
+ * Certify this module's plain Safe profile, failing closed on malformed state or RPC errors.
+ * Receipt recovery pins every code, storage, and raw policy read to blockNumber.
+ * Contract signers are supported; this verifies their membership, not their own policy.
+ */
+export declare function verifySafeDeployments(client: PublicClient, plans: readonly SafeDeploymentPlan[], options?: SafeVerificationOptions): Promise<boolean>;
+export declare function checkSafeDeployments(client: PublicClient, plans?: readonly SafeDeploymentPlan[]): Promise<void>;
+/** Optional factory calls are idempotent only with preflight, simulation, and receipt verification. */
+export declare function buildSafeDeploymentCalls(plans: readonly SafeDeploymentPlan[]): {
+    target: `0x${string}`;
+    allowFailure: true;
+    value: bigint;
+    callData: `0x${string}`;
+}[];
+export declare function buildSafeDeploymentTx(chainId: number, plans: readonly SafeDeploymentPlan[]): {
+    chainId: number;
+    address: `0x${string}`;
+    abi: readonly [{
+        readonly name: "aggregate3Value";
+        readonly type: "function";
+        readonly stateMutability: "payable";
+        readonly inputs: readonly [{
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly type: "address";
+                readonly name: "target";
+            }, {
+                readonly type: "bool";
+                readonly name: "allowFailure";
+            }, {
+                readonly type: "uint256";
+                readonly name: "value";
+            }, {
+                readonly type: "bytes";
+                readonly name: "callData";
+            }];
+            readonly name: "calls";
+        }];
+        readonly outputs: readonly [{
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly type: "bool";
+                readonly name: "success";
+            }, {
+                readonly type: "bytes";
+                readonly name: "returnData";
+            }];
+            readonly name: "returnData";
+        }];
+    }];
+    functionName: "aggregate3Value";
+    args: readonly [{
+        target: `0x${string}`;
+        allowFailure: true;
+        value: bigint;
+        callData: `0x${string}`;
+    }[]];
+    value: bigint;
+};
+/**
+ * Multicall3 changes msg.sender. Use only a sender-independent or already authenticated
+ * forwarded launch. This helper cannot decide the launch contract's authorization semantics.
+ * Simulate the returned call, verifySafeLaunchSimulation, then verify receipt-block state.
+ */
+export declare function bundleSafeLaunch(call: SafeCall, plans?: readonly SafeDeploymentPlan[]): SafeCall;
+/** Require the exact reviewed factory calls, their order, one mandatory launch, and its value. */
+export declare function unbundleSafeLaunch(call: SafeCall, plans?: readonly SafeDeploymentPlan[]): SafeCall;
+/** Outer simulation success is insufficient: an optional deployment may have failed. */
+export declare function verifySafeLaunchSimulation(client: PublicClient, plans?: readonly SafeDeploymentPlan[], data?: Hex): Promise<void>;
+//# sourceMappingURL=safe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../../src/safe.ts"],"names":[],"mappings":"AAAA,OAAO,EAeL,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAId,eAAO,MAAM,YAAY,eAExB,CAAC;AACF,eAAO,MAAM,cAAc,eAE1B,CAAC;AACF,eAAO,MAAM,aAAa,eAEzB,CAAC;AACF,eAAO,MAAM,UAAU,eAEtB,CAAC;AACF,eAAO,MAAM,eAAe,KAAK,CAAC;AAyBlC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI1B,CAAC;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AASH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,GAAG,CAAC;IACf,iBAAiB,EAAE,GAAG,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACjE,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,GAAG,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,uBAAuB,GAAG;IACpC,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAMF,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,GAAG,CAiCN;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,GACxC,OAAO,CAsBT;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CASzE;AAqBD,mFAAmF;AACnF,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAkB7E;AAED,8FAA8F;AAC9F,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAwB1D;AA4BD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,SAAS,kBAAkB,EAAE,EACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAuHlB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,KAAK,GAAE,SAAS,kBAAkB,EAAO,GACxC,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,uGAAuG;AACvG,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE;;;;;IAgB5E;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYrC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,KAAK,GAAE,SAAS,kBAAkB,EAAO,GACxC,QAAQ,CA2BV;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EACd,KAAK,GAAE,SAAS,kBAAkB,EAAO,GACxC,QAAQ,CAmBV;AAED,wFAAwF;AACxF,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,YAAY,EACpB,KAAK,GAAE,SAAS,kBAAkB,EAAO,EACzC,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/esm/safe.js

@@ -0,0 +1,381 @@
+import { concatHex, decodeFunctionData, decodeFunctionResult, encodeFunctionData, encodeFunctionResult, encodePacked, getAddress, getContractAddress, isAddress, isAddressEqual, keccak256, parseAbi, toHex, zeroAddress, } from "viem";
+// Canonical Safe 1.4.1 deployments, from safe-global/safe-deployments.
+// A fixed singleton and initializer preserve CREATE2 addresses across chains.
+export const SAFE_FACTORY = getAddress("0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67");
+export const SAFE_SINGLETON = getAddress("0x41675C099F32341bf84BFc5382aF534df5C7461a");
+export const SAFE_FALLBACK = getAddress("0xfd0732Dc9E303f09fCEf3a7388Ad10A83459Ec99");
+export const MULTICALL3 = getAddress("0xcA11bde05977b3631167028862bE2a173976CA11");
+export const MAX_SAFE_OWNERS = 50;
+const contracts = [
+    [
+        SAFE_FACTORY,
+        "0x50c3cdc4074750a7a974204a716c999edd37482f907608d960b2b025ee0b3317",
+    ],
+    [
+        SAFE_SINGLETON,
+        "0x1fe2df852ba3299d6534ef416eefa406e56ced995bca886ab7a553e6d0c5e1c4",
+    ],
+    [
+        SAFE_FALLBACK,
+        "0x7c6007a5d711cea8dfd5d91f5940ec29c7f200fe511eb1fc1397b367af3c42f9",
+    ],
+];
+const PROXY_CODE_HASH = "0xd7d408ebcd99b2b70be43e20253d6d92a8ea8fab29bd3be7f55b10032331fb4c";
+const SENTINEL = "0x0000000000000000000000000000000000000001";
+const SINGLETON_SLOT = toHex(0n, { size: 32 });
+const GUARD_SLOT = "0x4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c8";
+const FALLBACK_SLOT = "0x6c9a6c4a39284e37ed1cf53d337577d14212a4870fb976a4366c693b939918d5";
+export const SAFE_CREATE_ABI = parseAbi([
+    "function proxyCreationCode() pure returns (bytes)",
+    "function createProxyWithNonce(address singleton, bytes initializer, uint256 saltNonce) returns (address proxy)",
+    "function setup(address[] owners,uint256 threshold,address to,bytes data,address fallbackHandler,address paymentToken,uint256 payment,address paymentReceiver)",
+]);
+export const CREATE_BATCH_ABI = parseAbi([
+    "function aggregate3Value((address target,bool allowFailure,uint256 value,bytes callData)[] calls) payable returns ((bool success,bytes returnData)[] returnData)",
+]);
+const READ_ABI = parseAbi([
+    "function masterCopy() view returns (address)",
+    "function VERSION() view returns (string)",
+    "function getThreshold() view returns (uint256)",
+    "function getOwners() view returns (address[])",
+    "function getModulesPaginated(address start,uint256 pageSize) view returns (address[],address)",
+]);
+function validAddress(address) {
+    return isAddress(address) && BigInt(address) > 1n;
+}
+/** Plain Safe only: no delegatecall hook, modules, guard, or setup payments. */
+export function buildSafeInitializer(policy) {
+    if (!Array.isArray(policy.owners) ||
+        policy.owners.length < 1 ||
+        policy.owners.length > MAX_SAFE_OWNERS ||
+        policy.owners.some((owner) => !validAddress(owner)) ||
+        new Set(policy.owners.map((owner) => owner.toLowerCase())).size !==
+            policy.owners.length)
+        throw new Error("A Safe needs 1–50 unique nonzero, nonsentinel owner addresses.");
+    if (!Number.isInteger(policy.threshold) ||
+        policy.threshold < 1 ||
+        policy.threshold > policy.owners.length) {
+        throw new Error("Invalid Safe approval policy.");
+    }
+    return encodeFunctionData({
+        abi: SAFE_CREATE_ABI,
+        functionName: "setup",
+        args: [
+            policy.owners,
+            BigInt(policy.threshold),
+            zeroAddress,
+            "0x",
+            SAFE_FALLBACK,
+            zeroAddress,
+            0n,
+            zeroAddress,
+        ],
+    });
+}
+/** Owner order and the original 32-byte salt are part of the deterministic address. */
+export function predictSafeAddress(plan) {
+    if (!/^0x[\da-f]{64}$/i.test(plan.saltNonce) ||
+        !/^0x(?:[\da-f]{2}){1,2048}$/i.test(plan.proxyCreationCode)) {
+        throw new Error("Invalid Safe deployment record.");
+    }
+    const salt = keccak256(encodePacked(["bytes32", "uint256"], [keccak256(buildSafeInitializer(plan)), BigInt(plan.saltNonce)]));
+    return getContractAddress({
+        opcode: "CREATE2",
+        from: SAFE_FACTORY,
+        salt,
+        bytecode: concatHex([
+            plan.proxyCreationCode,
+            toHex(BigInt(SAFE_SINGLETON), { size: 32 }),
+        ]),
+    });
+}
+export function validateSafeDeploymentPlan(plan) {
+    if (!validAddress(plan.address) ||
+        !isAddressEqual(predictSafeAddress(plan), plan.address)) {
+        throw new Error("The Safe address differs from its saved owners and policy.");
+    }
+}
+function validatePlans(plans) {
+    if (!Array.isArray(plans))
+        throw new Error("Invalid Safe deployment plans.");
+    plans.forEach(validateSafeDeploymentPlan);
+    if (new Set(plans.map((plan) => plan.address.toLowerCase())).size !==
+        plans.length) {
+        throw new Error("Duplicate Safe deployment plans.");
+    }
+}
+function codeMatches(code, hash) {
+    return (typeof code === "string" &&
+        /^0x(?:[\da-f]{2}){1,24576}$/i.test(code) &&
+        keccak256(code) === hash);
+}
+/** Check canonical dependencies before trusting factory-returned creation code. */
+export async function readSafeCreationCode(client) {
+    await Promise.all(contracts.map(async ([address, hash]) => {
+        if (!codeMatches(await client.getCode({ address }), hash)) {
+            throw new Error(`The canonical Safe 1.4.1 contract is unavailable at ${address}.`);
+        }
+    }));
+    const proxyCreationCode = await client.readContract({
+        address: SAFE_FACTORY,
+        abi: SAFE_CREATE_ABI,
+        functionName: "proxyCreationCode",
+    });
+    if (!/^0x(?:[\da-f]{2}){1,2048}$/i.test(proxyCreationCode))
+        throw new Error("Invalid Safe proxy creation code.");
+    return proxyCreationCode;
+}
+/** Existing inputs are address-only: this does not certify an arbitrary address as a Safe. */
+export async function resolveSafeAddress(input, clients) {
+    if (input.kind === "existing") {
+        if (!validAddress(input.address))
+            throw new Error("Enter a valid existing Safe address.");
+        return { address: getAddress(input.address) };
+    }
+    if (input.kind !== "create")
+        throw new Error("Invalid Safe address input.");
+    // Validate local inputs before any network request.
+    buildSafeInitializer(input);
+    if (!/^0x[\da-f]{64}$/i.test(input.saltNonce))
+        throw new Error("Invalid Safe deployment salt.");
+    if (!clients.length)
+        throw new Error("Select at least one network to create a Safe.");
+    const codes = await Promise.all(clients.map(readSafeCreationCode));
+    if (codes.some((code) => code.toLowerCase() !== codes[0].toLowerCase()))
+        throw new Error("Safe creation code differs across the selected networks.");
+    const policy = {
+        owners: input.owners.map((owner) => getAddress(owner)),
+        threshold: input.threshold,
+        saltNonce: input.saltNonce,
+        proxyCreationCode: codes[0],
+    };
+    const plan = { ...policy, address: predictSafeAddress(policy) };
+    return { address: plan.address, plan };
+}
+async function boundedCall(client, address, data, gas, maxBytes, blockNumber) {
+    // Raw RPC cannot follow a contract-selected CCIP/OffchainLookup URL.
+    const result = await client.request({
+        method: "eth_call",
+        params: [
+            { to: address, data, gas: toHex(gas) },
+            blockNumber === undefined ? "latest" : toHex(blockNumber),
+        ],
+    });
+    if (typeof result !== "string" ||
+        !/^0x(?:[\da-f]{2})*$/i.test(result) ||
+        result.length > 2 + maxBytes * 2) {
+        throw new Error("Invalid or oversized Safe policy response.");
+    }
+    return result;
+}
+/**
+ * Certify this module's plain Safe profile, failing closed on malformed state or RPC errors.
+ * Receipt recovery pins every code, storage, and raw policy read to blockNumber.
+ * Contract signers are supported; this verifies their membership, not their own policy.
+ */
+export async function verifySafeDeployments(client, plans, options = {}) {
+    validatePlans(plans);
+    const { blockNumber, allowMissing = false } = options;
+    if (blockNumber !== undefined && blockNumber < 0n)
+        throw new Error("Invalid Safe verification block.");
+    let complete = true;
+    for (const plan of plans) {
+        const code = await client.getCode({ address: plan.address, blockNumber });
+        if (allowMissing && (code === undefined || code === "0x")) {
+            complete = false;
+            continue;
+        }
+        const mismatch = () => new Error(`The Safe at ${plan.address} does not match its reviewed owners and policy.`);
+        if (!codeMatches(code, PROXY_CODE_HASH))
+            throw mismatch();
+        const singleton = await client.getStorageAt({
+            address: plan.address,
+            slot: SINGLETON_SLOT,
+            blockNumber,
+        });
+        if (singleton?.toLowerCase() !==
+            toHex(BigInt(SAFE_SINGLETON), { size: 32 }).toLowerCase())
+            throw mismatch();
+        // Do not delegate through a claimed implementation before checking its exact runtime.
+        for (const [address, hash] of contracts.slice(1)) {
+            if (!codeMatches(await client.getCode({ address, blockNumber }), hash))
+                throw mismatch();
+        }
+        const call = (data, maxBytes, gas = 100000n) => boundedCall(client, plan.address, data, gas, maxBytes, blockNumber);
+        const [masterCopy, version, threshold, ownersData, modules, guard, fallback,] = await Promise.all([
+            call(encodeFunctionData({ abi: READ_ABI, functionName: "masterCopy" }), 32),
+            call(encodeFunctionData({ abi: READ_ABI, functionName: "VERSION" }), 96),
+            call(encodeFunctionData({ abi: READ_ABI, functionName: "getThreshold" }), 32),
+            call(encodeFunctionData({ abi: READ_ABI, functionName: "getOwners" }), 64 + MAX_SAFE_OWNERS * 32, 400000n),
+            call(encodeFunctionData({
+                abi: READ_ABI,
+                functionName: "getModulesPaginated",
+                args: [SENTINEL, 1n],
+            }), 128, 500000n),
+            client.getStorageAt({
+                address: plan.address,
+                slot: GUARD_SLOT,
+                blockNumber,
+            }),
+            client.getStorageAt({
+                address: plan.address,
+                slot: FALLBACK_SLOT,
+                blockNumber,
+            }),
+        ]);
+        if (masterCopy.toLowerCase() !==
+            toHex(BigInt(SAFE_SINGLETON), { size: 32 }).toLowerCase() ||
+            version.toLowerCase() !==
+                encodeFunctionResult({
+                    abi: READ_ABI,
+                    functionName: "VERSION",
+                    result: "1.4.1",
+                }).toLowerCase() ||
+            threshold.toLowerCase() !==
+                toHex(BigInt(plan.threshold), { size: 32 }).toLowerCase() ||
+            modules.toLowerCase() !==
+                encodeFunctionResult({
+                    abi: READ_ABI,
+                    functionName: "getModulesPaginated",
+                    result: [[], SENTINEL],
+                }).toLowerCase() ||
+            guard?.toLowerCase() !== toHex(0n, { size: 32 }) ||
+            fallback?.toLowerCase() !==
+                toHex(BigInt(SAFE_FALLBACK), { size: 32 }).toLowerCase() ||
+            ownersData.length !== 2 + (64 + plan.owners.length * 32) * 2 ||
+            ownersData.slice(2, 66).toLowerCase() !==
+                toHex(32n, { size: 32 }).slice(2) ||
+            ownersData.slice(66, 130).toLowerCase() !==
+                toHex(BigInt(plan.owners.length), { size: 32 }).slice(2))
+            throw mismatch();
+        const owners = decodeFunctionResult({
+            abi: READ_ABI,
+            functionName: "getOwners",
+            data: ownersData,
+        });
+        if (new Set(owners.map((owner) => owner.toLowerCase())).size !==
+            plan.owners.length ||
+            plan.owners.some((owner) => !owners.some((actual) => isAddressEqual(actual, owner))))
+            throw mismatch();
+    }
+    return complete;
+}
+export async function checkSafeDeployments(client, plans = []) {
+    if (!plans.length)
+        return;
+    validatePlans(plans);
+    const code = await readSafeCreationCode(client);
+    if (plans.some((plan) => plan.proxyCreationCode.toLowerCase() !== code.toLowerCase()))
+        throw new Error("The saved Safe creation code changed.");
+    await verifySafeDeployments(client, plans, { allowMissing: true });
+}
+/** Optional factory calls are idempotent only with preflight, simulation, and receipt verification. */
+export function buildSafeDeploymentCalls(plans) {
+    validatePlans(plans);
+    return plans.map((plan) => ({
+        target: SAFE_FACTORY,
+        allowFailure: true,
+        value: 0n,
+        callData: encodeFunctionData({
+            abi: SAFE_CREATE_ABI,
+            functionName: "createProxyWithNonce",
+            args: [
+                SAFE_SINGLETON,
+                buildSafeInitializer(plan),
+                BigInt(plan.saltNonce),
+            ],
+        }),
+    }));
+}
+export function buildSafeDeploymentTx(chainId, plans) {
+    if (!Number.isSafeInteger(chainId) || chainId <= 0)
+        throw new Error("Invalid Safe deployment chain.");
+    return {
+        chainId,
+        address: MULTICALL3,
+        abi: CREATE_BATCH_ABI,
+        functionName: "aggregate3Value",
+        args: [buildSafeDeploymentCalls(plans)],
+        value: 0n,
+    };
+}
+/**
+ * Multicall3 changes msg.sender. Use only a sender-independent or already authenticated
+ * forwarded launch. This helper cannot decide the launch contract's authorization semantics.
+ * Simulate the returned call, verifySafeLaunchSimulation, then verify receipt-block state.
+ */
+export function bundleSafeLaunch(call, plans = []) {
+    if (!plans.length)
+        return call;
+    if (!validAddress(call.to) ||
+        !/^0x(?:[\da-f]{2})*$/i.test(call.data) ||
+        typeof call.value !== "bigint" ||
+        call.value < 0n)
+        throw new Error("Invalid Safe launch call.");
+    const calls = [
+        ...buildSafeDeploymentCalls(plans),
+        {
+            target: call.to,
+            allowFailure: false,
+            value: call.value,
+            callData: call.data,
+        },
+    ];
+    return {
+        to: MULTICALL3,
+        value: call.value,
+        data: encodeFunctionData({
+            abi: CREATE_BATCH_ABI,
+            functionName: "aggregate3Value",
+            args: [calls],
+        }),
+    };
+}
+/** Require the exact reviewed factory calls, their order, one mandatory launch, and its value. */
+export function unbundleSafeLaunch(call, plans = []) {
+    if (!plans.length)
+        return call;
+    if (!isAddressEqual(call.to, MULTICALL3))
+        throw new Error("The saved Safe launch is not a creation batch.");
+    const { args } = decodeFunctionData({
+        abi: CREATE_BATCH_ABI,
+        data: call.data,
+    });
+    const last = args[0][args[0].length - 1];
+    if (!last)
+        throw new Error("The saved creation batch is empty.");
+    const inner = { to: last.target, data: last.callData, value: call.value };
+    if (bundleSafeLaunch(inner, plans).data.toLowerCase() !==
+        call.data.toLowerCase())
+        throw new Error("The saved creation batch differs from its reviewed Safes and launch.");
+    return inner;
+}
+/** Outer simulation success is insufficient: an optional deployment may have failed. */
+export async function verifySafeLaunchSimulation(client, plans = [], data) {
+    if (!plans.length)
+        return;
+    validatePlans(plans);
+    if (!data)
+        throw new Error("The Safe creation simulation returned no results.");
+    const results = decodeFunctionResult({
+        abi: CREATE_BATCH_ABI,
+        functionName: "aggregate3Value",
+        data,
+    });
+    if (results.length !== plans.length + 1 ||
+        !results[results.length - 1].success)
+        throw new Error("The creation batch did not simulate every required call.");
+    for (const [index, plan] of plans.entries()) {
+        const result = results[index];
+        if (result.success) {
+            if (result.returnData.toLowerCase() !==
+                toHex(BigInt(plan.address), { size: 32 }).toLowerCase())
+                throw new Error("The simulated factory returned a different Safe address.");
+        }
+        else {
+            // Only an already-deployed Safe with the exact policy can explain an accepted failure.
+            await verifySafeDeployments(client, [plan]);
+        }
+    }
+}
+//# sourceMappingURL=safe.js.map

package/dist/esm/safe.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bananapus/nana-sdk-core",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "type": "module",
   "sideEffects": false,
   "repository": {
@@ -36,6 +36,11 @@
       "import": "./dist/esm/jbcenter.js",
       "require": "./dist/cjs/jbcenter.js"
     },
+    "./safe": {
+      "types": "./dist/esm/safe.d.ts",
+      "import": "./dist/esm/safe.js",
+      "require": "./dist/cjs/safe.js"
+    },
     "./v6": {
       "types": "./dist/esm/v6/index.d.ts",
       "import": "./dist/esm/v6/index.js",