@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/utils/fork.js

@@ -0,0 +1,119 @@
+import { providers } from 'ethers';
+import { isValidAddressEvm, rootLogger } from '@recoillink/utils';
+const ENDPOINT_PREFIX = 'http';
+const DEFAULT_ANVIL_ENDPOINT = 'http://127.0.0.1:8545';
+export var ANVIL_RPC_METHODS;
+(function (ANVIL_RPC_METHODS) {
+    ANVIL_RPC_METHODS["RESET"] = "anvil_reset";
+    ANVIL_RPC_METHODS["IMPERSONATE_ACCOUNT"] = "anvil_impersonateAccount";
+    ANVIL_RPC_METHODS["STOP_IMPERSONATING_ACCOUNT"] = "anvil_stopImpersonatingAccount";
+    ANVIL_RPC_METHODS["NODE_INFO"] = "anvil_nodeInfo";
+    ANVIL_RPC_METHODS["SET_BALANCE"] = "anvil_setBalance";
+    ANVIL_RPC_METHODS["SET_STORAGE_AT"] = "anvil_setStorageAt";
+    ANVIL_RPC_METHODS["MINE"] = "anvil_mine";
+    ANVIL_RPC_METHODS["SNAPSHOT"] = "evm_snapshot";
+    ANVIL_RPC_METHODS["REVERT"] = "evm_revert";
+    ANVIL_RPC_METHODS["INCREASE_TIME"] = "evm_increaseTime";
+})(ANVIL_RPC_METHODS || (ANVIL_RPC_METHODS = {}));
+/**
+ * Resets the local node to it's original state (anvil [31337] at block zero).
+ */
+export const resetFork = async (anvilIPAddr, anvilPort) => {
+    rootLogger.info(`Resetting forked network...`);
+    const provider = getLocalProvider({ anvilIPAddr, anvilPort });
+    await provider.send(ANVIL_RPC_METHODS.RESET, [
+        {
+            forking: {
+                jsonRpcUrl: DEFAULT_ANVIL_ENDPOINT,
+            },
+        },
+    ]);
+    rootLogger.info(`✅ Successfully reset forked network`);
+};
+/**
+ * Forks a chain onto the local node at the latest block of the forked network.
+ * @param multiProvider the multiProvider with which to fork the network
+ * @param chain the network to fork
+ */
+export const setFork = async (multiProvider, chain, anvilIPAddr, anvilPort) => {
+    rootLogger.info(`Forking ${chain} for dry-run...`);
+    const provider = getLocalProvider({ anvilIPAddr, anvilPort });
+    const currentChainMetadata = multiProvider.metadata[chain];
+    await provider.send(ANVIL_RPC_METHODS.RESET, [
+        {
+            forking: {
+                jsonRpcUrl: currentChainMetadata.rpcUrls[0].http,
+            },
+        },
+    ]);
+    multiProvider.setProvider(chain, provider);
+    rootLogger.info(`✅ Successfully forked ${chain} for dry-run`);
+};
+/**
+ * Impersonates an EOA for a provided address.
+ * @param address the address to impersonate
+ * @returns the impersonated signer
+ */
+export const impersonateAccount = async (address, anvilEndPoint) => {
+    rootLogger.info(`Impersonating account (${address})...`);
+    const provider = getLocalProvider({ urlOverride: anvilEndPoint });
+    await provider.send(ANVIL_RPC_METHODS.IMPERSONATE_ACCOUNT, [address]);
+    rootLogger.info(`✅ Successfully impersonated account (${address})`);
+    return provider.getSigner(address);
+};
+/**
+ * Stops account impersonation.
+ * @param address the address to stop impersonating
+ */
+export const stopImpersonatingAccount = async (address, anvilEndPoint) => {
+    rootLogger.info(`Stopping account impersonation for address (${address})...`);
+    if (!isValidAddressEvm(address))
+        throw new Error(`Cannot stop account impersonation: invalid address format: ${address}`);
+    const provider = getLocalProvider({ urlOverride: anvilEndPoint });
+    await provider.send(ANVIL_RPC_METHODS.STOP_IMPERSONATING_ACCOUNT, [
+        address.substring(2),
+    ]);
+    rootLogger.info(`✅ Successfully stopped account impersonation for address (${address})`);
+};
+/**
+ * Retrieves a local provider. Defaults to DEFAULT_ANVIL_ENDPOINT.
+ * @param urlOverride custom URL to overried the default endpoint
+ * @returns a local JSON-RPC provider
+ */
+export const getLocalProvider = ({ anvilIPAddr, anvilPort, urlOverride, } = {}) => {
+    let envUrl;
+    if (anvilIPAddr && anvilPort)
+        envUrl = `${ENDPOINT_PREFIX}${anvilIPAddr}:${anvilPort}`;
+    if (urlOverride && !urlOverride.startsWith(ENDPOINT_PREFIX)) {
+        rootLogger.warn(`⚠️ Provided URL override (${urlOverride}) does not begin with ${ENDPOINT_PREFIX}. Defaulting to ${envUrl ?? DEFAULT_ANVIL_ENDPOINT}`);
+        urlOverride = undefined;
+    }
+    const url = urlOverride ?? envUrl ?? DEFAULT_ANVIL_ENDPOINT;
+    return new providers.JsonRpcProvider(url);
+};
+export async function setBalance(provider, address, balanceWei) {
+    await provider.send(ANVIL_RPC_METHODS.SET_BALANCE, [address, balanceWei]);
+}
+export async function setStorageAt(provider, contractAddress, slot, value) {
+    await provider.send(ANVIL_RPC_METHODS.SET_STORAGE_AT, [
+        contractAddress,
+        slot,
+        value,
+    ]);
+}
+export async function mine(provider, blocks = 1) {
+    await provider.send(ANVIL_RPC_METHODS.MINE, [blocks]);
+}
+export async function increaseTime(provider, seconds) {
+    await provider.send(ANVIL_RPC_METHODS.INCREASE_TIME, [seconds]);
+}
+export async function snapshot(provider) {
+    return provider.send(ANVIL_RPC_METHODS.SNAPSHOT, []);
+}
+export async function revertToSnapshot(provider, snapshotId) {
+    return provider.send(ANVIL_RPC_METHODS.REVERT, [snapshotId]);
+}
+export async function impersonateAccounts(provider, accounts) {
+    await Promise.all(accounts.map((address) => provider.send(ANVIL_RPC_METHODS.IMPERSONATE_ACCOUNT, [address])));
+}
+//# sourceMappingURL=fork.js.map

package/dist/utils/fork.js.map

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

package/dist/utils/gas.d.ts

@@ -0,0 +1,30 @@
+import { BigNumber, providers } from 'ethers';
+import { IMessageRecipient } from '@recoillink/core';
+import { Address } from '@recoillink/utils';
+export declare const DEFAULT_CALL_GAS_FALLBACK: BigNumber;
+export interface EstimateHandleGasParams {
+    origin: number;
+    sender: string;
+    body: string;
+    mailbox: Address;
+    recipient: IMessageRecipient;
+}
+export interface EstimateCallGasParams {
+    provider: providers.Provider;
+    from?: Address;
+    to: Address;
+    data: string;
+    value?: BigNumber;
+    fallback?: BigNumber;
+}
+/**
+ * Estimates gas for calling handle() on a recipient contract.
+ * Returns null if estimation fails (e.g., call would revert).
+ */
+export declare function estimateHandleGasForRecipient(params: EstimateHandleGasParams): Promise<BigNumber | null>;
+/**
+ * Estimates gas for a single contract call.
+ * Returns fallback value (default 50k) if estimation fails.
+ */
+export declare function estimateCallGas(params: EstimateCallGasParams): Promise<BigNumber>;
+//# sourceMappingURL=gas.d.ts.map

package/dist/utils/gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../../src/utils/gas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,eAAO,MAAM,yBAAyB,WAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAY3B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,SAAS,CAAC,CAapB"}

package/dist/utils/gas.js

@@ -0,0 +1,35 @@
+import { BigNumber } from 'ethers';
+export const DEFAULT_CALL_GAS_FALLBACK = BigNumber.from(50_000);
+/**
+ * Estimates gas for calling handle() on a recipient contract.
+ * Returns null if estimation fails (e.g., call would revert).
+ */
+export async function estimateHandleGasForRecipient(params) {
+    try {
+        // await required for catch to handle promise rejection
+        return await params.recipient.estimateGas.handle(params.origin, params.sender, params.body, { from: params.mailbox });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Estimates gas for a single contract call.
+ * Returns fallback value (default 50k) if estimation fails.
+ */
+export async function estimateCallGas(params) {
+    const fallback = params.fallback ?? DEFAULT_CALL_GAS_FALLBACK;
+    try {
+        // await required for catch to handle promise rejection
+        return await params.provider.estimateGas({
+            from: params.from,
+            to: params.to,
+            data: params.data,
+            value: params.value,
+        });
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=gas.js.map

package/dist/utils/gas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.js","sourceRoot":"","sources":["../../src/utils/gas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,QAAQ,CAAC;AAK9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAmBhE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,MAA+B;IAE/B,IAAI,CAAC;QACH,uDAAuD;QACvD,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAC9C,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,IAAI,EACX,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CACzB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA6B;IAE7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,yBAAyB,CAAC;IAC9D,IAAI,CAAC;QACH,uDAAuD;QACvD,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;YACvC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/utils/gnosisSafe.d.ts

@@ -0,0 +1,21 @@
+import SafeApiKit, { type SafeApiKitConfig } from '@safe-global/api-kit';
+import Safe, { SafeProviderConfig } from '@safe-global/protocol-kit';
+import { Address } from '@recoillink/utils';
+import { MultiProvider } from '../providers/MultiProvider.js';
+import { ChainName, ChainNameOrId } from '../types.js';
+export declare const SAFE_API_RETRIES = 10;
+export declare const SAFE_API_BASE_RETRY_MS = 1000;
+type SafeApiKitInstance = SafeApiKit.default;
+type GetSafeOptions = {
+    allowUnresolvedSafeVersion?: boolean;
+};
+export declare function safeApiKeyRequired(txServiceUrl: string): boolean;
+export declare function normalizeSafeTxServiceUrl(txServiceUrl: string): string;
+export declare function isSafeGlobalTxServiceUrl(txServiceUrl: string): boolean;
+export declare function getSafeApiKitConfig(chainId: number, txServiceUrl: string, gnosisSafeApiKey?: string): SafeApiKitConfig;
+export declare function getSafeService(chain: ChainNameOrId, multiProvider: MultiProvider): SafeApiKitInstance;
+export declare function getSafe(chain: ChainName, multiProvider: MultiProvider, safeAddress: Address, signer?: SafeProviderConfig['signer'], options?: GetSafeOptions): Promise<Safe.default>;
+export declare function getSafeDelegates(service: SafeApiKitInstance, safeAddress: Address): Promise<string[]>;
+export declare function canProposeSafeTransactions(proposer: Address, chain: ChainName, multiProvider: MultiProvider, safeAddress: Address): Promise<boolean>;
+export {};
+//# sourceMappingURL=gnosisSafe.d.ts.map

package/dist/utils/gnosisSafe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gnosisSafe.d.ts","sourceRoot":"","sources":["../../src/utils/gnosisSafe.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,IAAI,EAAE,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMrE,OAAO,EAAE,OAAO,EAAkC,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,CAAC;AAE7C,KAAK,cAAc,GAAG;IACpB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAQF,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAUtE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,gBAAgB,CAqBlB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,aAAa,EAAE,aAAa,GAC3B,kBAAkB,CAwCpB;AAiDD,wBAAsB,OAAO,CAC3B,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,OAAO,EACpB,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACrC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAmEvB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,OAAO,CAAC,CAiBlB"}

package/dist/utils/gnosisSafe.js

@@ -0,0 +1,193 @@
+import SafeApiKit from '@safe-global/api-kit';
+import Safe from '@safe-global/protocol-kit';
+import { getMultiSendCallOnlyDeployment, getMultiSendDeployment, } from '@safe-global/safe-deployments';
+import { assert, retryAsync, rootLogger } from '@recoillink/utils';
+export const SAFE_API_RETRIES = 10;
+export const SAFE_API_BASE_RETRY_MS = 1000;
+function isSafeApiKitConstructor(value) {
+    return typeof value === 'function';
+}
+export function safeApiKeyRequired(txServiceUrl) {
+    return /safe\.global|5afe\.dev/.test(txServiceUrl);
+}
+export function normalizeSafeTxServiceUrl(txServiceUrl) {
+    const trimmedUrl = txServiceUrl.replace(/\/+$/, '');
+    if (trimmedUrl.endsWith('/api'))
+        return trimmedUrl;
+    return `${trimmedUrl}/api`;
+}
+export function isSafeGlobalTxServiceUrl(txServiceUrl) {
+    try {
+        const url = new URL(normalizeSafeTxServiceUrl(txServiceUrl));
+        return (['api.safe.global', 'api.5afe.dev'].includes(url.hostname) &&
+            /^\/tx-service\/[^/]+\/api$/.test(url.pathname));
+    }
+    catch {
+        return false;
+    }
+}
+export function getSafeApiKitConfig(chainId, txServiceUrl, gnosisSafeApiKey) {
+    const normalizedTxServiceUrl = normalizeSafeTxServiceUrl(txServiceUrl);
+    const apiKey = safeApiKeyRequired(normalizedTxServiceUrl)
+        ? gnosisSafeApiKey
+        : undefined;
+    const baseConfig = {
+        chainId: BigInt(chainId),
+        apiKey,
+    };
+    // Safe's hosted gateway authenticates API-key traffic correctly when API Kit
+    // derives the service URL from chainId. Supplying txServiceUrl can hit lower
+    // unauthenticated rate limits on some endpoints.
+    if (apiKey && isSafeGlobalTxServiceUrl(normalizedTxServiceUrl)) {
+        return baseConfig;
+    }
+    return {
+        ...baseConfig,
+        txServiceUrl: normalizedTxServiceUrl,
+    };
+}
+export function getSafeService(chain, multiProvider) {
+    const { gnosisSafeTransactionServiceUrl, gnosisSafeApiKey } = multiProvider.getChainMetadata(chain);
+    assert(gnosisSafeTransactionServiceUrl, `must provide tx service url for ${chain}`);
+    const chainId = multiProvider.getEvmChainId(chain);
+    assert(chainId, `Chain is not an EVM chain: ${chain}`);
+    const config = getSafeApiKitConfig(chainId, gnosisSafeTransactionServiceUrl, gnosisSafeApiKey);
+    assert(isSafeApiKitConstructor(SafeApiKit), '@safe-global/api-kit default export is not a constructor');
+    try {
+        return new SafeApiKit(config);
+    }
+    catch (error) {
+        if (error instanceof TypeError &&
+            error.message.includes('There is no transaction service available for chainId') &&
+            !config.txServiceUrl &&
+            isSafeGlobalTxServiceUrl(gnosisSafeTransactionServiceUrl)) {
+            return new SafeApiKit({
+                ...config,
+                txServiceUrl: normalizeSafeTxServiceUrl(gnosisSafeTransactionServiceUrl),
+            });
+        }
+        throw error;
+    }
+}
+// This is the version of the Safe contracts that the SDK is compatible with.
+// Copied the MVP fields from https://github.com/safe-global/safe-core-sdk/blob/4d1c0e14630f951c2498e1d4dd521403af91d6e1/packages/protocol-kit/src/contracts/config.ts#L19
+// because the SDK doesn't expose this value.
+const safeDeploymentsVersions = {
+    '1.4.1': {
+        multiSendVersion: '1.4.1',
+        multiSendCallOnlyVersion: '1.4.1',
+    },
+    '1.3.0': {
+        multiSendVersion: '1.3.0',
+        multiSendCallOnlyVersion: '1.3.0',
+    },
+    '1.2.0': {
+        multiSendVersion: '1.1.1',
+        multiSendCallOnlyVersion: '1.3.0',
+    },
+    '1.1.1': {
+        multiSendVersion: '1.1.1',
+        multiSendCallOnlyVersion: '1.3.0',
+    },
+    '1.0.0': {
+        multiSendVersion: '1.1.1',
+        multiSendCallOnlyVersion: '1.3.0',
+    },
+};
+// Override for chains that haven't yet been published in the safe-deployments package.
+// Temporary until PR to safe-deployments package is merged and SDK dependency is updated.
+const chainOverrides = {
+    // berachain
+    80094: {
+        multiSend: '0xA238CBeb142c10Ef7Ad8442C6D1f9E89e07e7761',
+        multiSendCallOnly: '0x40A2aCCbd92BCA938b02010E17A5b8929b49130D',
+    },
+    // igra
+    38833: {
+        multiSend: '0x218543288004CD07832472D464648173c77D7eB7',
+        multiSendCallOnly: '0xA83c336B20401Af773B6219BA5027174338D1836',
+    },
+};
+export async function getSafe(chain, multiProvider, safeAddress, signer, options = {}) {
+    // Get the chain id for the given chain
+    const chainId = `${multiProvider.getEvmChainId(chain)}`;
+    // Get the safe version from the transaction service if one is available.
+    // Fall back gracefully when the service is missing/unreachable so the Safe
+    // instance can still be built for read-only/offline use (e.g. generating a
+    // Safe Transaction Builder batch for chains without a usable tx service).
+    let safeVersion;
+    try {
+        const safeService = getSafeService(chain, multiProvider);
+        const { version: rawSafeVersion } = await retryAsync(() => safeService.getSafeInfo(safeAddress), SAFE_API_RETRIES, SAFE_API_BASE_RETRY_MS);
+        // Remove any build metadata from the version e.g. 1.3.0+L2 --> 1.3.0
+        safeVersion = rawSafeVersion.split(' ')[0].split('+')[0].split('-')[0];
+    }
+    catch (error) {
+        if (!options.allowUnresolvedSafeVersion) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        rootLogger.warn(`Could not fetch Safe version for ${chain} (transaction service unavailable); falling back to default multiSend resolution: ${errorMessage}`);
+    }
+    // Get the multiSend and multiSendCallOnly deployments for the given chain
+    let multiSend, multiSendCallOnly;
+    if (chainOverrides[chainId]) {
+        multiSend = {
+            networkAddresses: { [chainId]: chainOverrides[chainId].multiSend },
+        };
+        multiSendCallOnly = {
+            networkAddresses: {
+                [chainId]: chainOverrides[chainId].multiSendCallOnly,
+            },
+        };
+    }
+    else if (safeVersion && safeDeploymentsVersions[safeVersion]) {
+        const { multiSendVersion, multiSendCallOnlyVersion } = safeDeploymentsVersions[safeVersion];
+        multiSend = getMultiSendDeployment({
+            version: multiSendVersion,
+            network: chainId,
+        });
+        multiSendCallOnly = getMultiSendCallOnlyDeployment({
+            version: multiSendCallOnlyVersion,
+            network: chainId,
+        });
+    }
+    // @ts-ignore
+    return Safe.init({
+        provider: multiProvider.getChainMetadata(chain).rpcUrls[0].http,
+        signer,
+        safeAddress,
+        contractNetworks: {
+            [chainId]: {
+                // Use the safe address for multiSendAddress and multiSendCallOnlyAddress
+                // if the contract is not deployed or if the version is not found.
+                multiSendAddress: multiSend?.networkAddresses[chainId] || safeAddress,
+                multiSendCallOnlyAddress: multiSendCallOnly?.networkAddresses[chainId] || safeAddress,
+            },
+        },
+    });
+}
+export async function getSafeDelegates(service, safeAddress) {
+    const delegateResponse = await retryAsync(() => service.getSafeDelegates({ safeAddress }), SAFE_API_RETRIES, SAFE_API_BASE_RETRY_MS);
+    return delegateResponse.results.map((r) => r.delegate);
+}
+export async function canProposeSafeTransactions(proposer, chain, multiProvider, safeAddress) {
+    let safeService;
+    try {
+        safeService = getSafeService(chain, multiProvider);
+    }
+    catch (e) {
+        rootLogger.error('Failed to get Safe service for chain', {
+            chain,
+            chainName: multiProvider.tryGetChainName(chain),
+            knownChains: multiProvider.getKnownChainNames(),
+            error: e,
+        });
+        return false;
+    }
+    const safe = await getSafe(chain, multiProvider, safeAddress);
+    const delegates = await getSafeDelegates(safeService, safeAddress);
+    const owners = await safe.getOwners();
+    return delegates.includes(proposer) || owners.includes(proposer);
+}
+//# sourceMappingURL=gnosisSafe.js.map

package/dist/utils/gnosisSafe.js.map

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

package/dist/utils/gnosisSafe.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gnosisSafe.test.d.ts.map

package/dist/utils/gnosisSafe.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gnosisSafe.test.d.ts","sourceRoot":"","sources":["../../src/utils/gnosisSafe.test.ts"],"names":[],"mappings":""}

package/dist/utils/gnosisSafe.test.js

@@ -0,0 +1,78 @@
+import { expect } from 'chai';
+import sinon from 'sinon';
+import Safe from '@safe-global/protocol-kit';
+import { getSafe, getSafeApiKitConfig, isSafeGlobalTxServiceUrl, normalizeSafeTxServiceUrl, } from './gnosisSafe.js';
+const safeAddress = '0x1234567890123456789012345678901234567890';
+const safeProtocolKit = Safe;
+function createMultiProviderWithoutSafeService() {
+    return {
+        getEvmChainId: () => 12345,
+        getChainMetadata: () => ({
+            rpcUrls: [{ http: 'http://localhost:8545' }],
+        }),
+    };
+}
+async function expectRejection(promise, message) {
+    try {
+        await promise;
+        throw new Error('Expected promise to reject');
+    }
+    catch (error) {
+        expect(error.message).to.include(message);
+    }
+}
+describe('gnosisSafe utils', () => {
+    describe('normalizeSafeTxServiceUrl', () => {
+        it('appends api to transaction service URLs', () => {
+            expect(normalizeSafeTxServiceUrl('https://api.safe.global/tx-service/base')).to.equal('https://api.safe.global/tx-service/base/api');
+        });
+        it('preserves URLs that already end in api', () => {
+            expect(normalizeSafeTxServiceUrl('https://api.safe.global/tx-service/base/api/')).to.equal('https://api.safe.global/tx-service/base/api');
+        });
+    });
+    describe('isSafeGlobalTxServiceUrl', () => {
+        it('matches the hosted Safe transaction service gateway', () => {
+            expect(isSafeGlobalTxServiceUrl('https://api.safe.global/tx-service/base')).to.equal(true);
+        });
+        it('does not match custom Safe transaction service hosts', () => {
+            expect(isSafeGlobalTxServiceUrl('https://safe-transaction-blast.safe.global')).to.equal(false);
+        });
+    });
+    describe('getSafeApiKitConfig', () => {
+        it('omits txServiceUrl for authenticated Safe global gateway requests', () => {
+            const config = getSafeApiKitConfig(8453, 'https://api.safe.global/tx-service/base', 'safe-api-key');
+            expect(config.chainId).to.equal(8453n);
+            expect(config.apiKey).to.equal('safe-api-key');
+            expect(config.txServiceUrl).to.equal(undefined);
+        });
+        it('keeps txServiceUrl for custom services', () => {
+            const config = getSafeApiKitConfig(81457, 'https://safe-transaction-blast.safe.global', 'safe-api-key');
+            expect(config.chainId).to.equal(81457n);
+            expect(config.apiKey).to.equal('safe-api-key');
+            expect(config.txServiceUrl).to.equal('https://safe-transaction-blast.safe.global/api');
+        });
+    });
+    describe('getSafe', () => {
+        let safeInitStub;
+        beforeEach(() => {
+            safeInitStub = sinon
+                .stub(safeProtocolKit, 'init')
+                .resolves({});
+        });
+        afterEach(() => {
+            safeInitStub.restore();
+        });
+        it('throws by default when the Safe transaction service is unavailable', async () => {
+            await expectRejection(getSafe('testchain', createMultiProviderWithoutSafeService(), safeAddress), 'must provide tx service url for testchain');
+            expect(safeInitStub.called).to.equal(false);
+        });
+        it('falls back only when unresolved Safe versions are explicitly allowed', async () => {
+            await getSafe('testchain', createMultiProviderWithoutSafeService(), safeAddress, undefined, { allowUnresolvedSafeVersion: true });
+            expect(safeInitStub.calledOnce).to.equal(true);
+            const initConfig = safeInitStub.firstCall.args[0];
+            expect(initConfig.contractNetworks['12345'].multiSendAddress).to.equal(safeAddress);
+            expect(initConfig.contractNetworks['12345'].multiSendCallOnlyAddress).to.equal(safeAddress);
+        });
+    });
+});
+//# sourceMappingURL=gnosisSafe.test.js.map

package/dist/utils/gnosisSafe.test.js.map

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