@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/deploy/verify/utils.d.ts

@@ -0,0 +1,81 @@
+import { ethers, utils } from 'ethers';
+import { ZKSyncArtifact } from '@recoillink/core';
+import { Address } from '@recoillink/utils';
+import { MultiProvider } from '../../providers/MultiProvider.js';
+import { ChainMap, ChainName } from '../../types.js';
+import { ContractVerificationInput } from './types.js';
+export declare function formatFunctionArguments(fragment: utils.Fragment, args: any[]): any;
+export declare function getConstructorArguments(contract: ethers.Contract, bytecode: string): any;
+export declare function buildVerificationInput(name: string, address: string, constructorArguments: string, isProxy?: boolean, expectedimplementation?: string): ContractVerificationInput;
+export declare function getContractVerificationInput({ name, contract, bytecode, isProxy, expectedimplementation, }: {
+    name: string;
+    contract: ethers.Contract;
+    bytecode: string;
+    isProxy?: boolean;
+    expectedimplementation?: Address;
+}): ContractVerificationInput;
+export declare function getContractVerificationInputForZKSync({ name, contract, constructorArgs, artifact, isProxy, expectedimplementation, }: {
+    name: string;
+    contract: ethers.Contract;
+    constructorArgs: any[];
+    artifact: ZKSyncArtifact;
+    isProxy?: boolean;
+    expectedimplementation?: Address;
+}): Promise<ContractVerificationInput>;
+export declare function encodeArguments(abi: any, constructorArgs: any[]): string;
+/**
+ * Check if the artifact should be added to the verification inputs.
+ * @param verificationInputs - The verification inputs for the chain.
+ * @param chain - The chain to check.
+ * @param artifact - The artifact to check.
+ * @returns
+ */
+export declare function shouldAddVerificationInput(verificationInputs: ChainMap<ContractVerificationInput[]>, chain: ChainName, artifact: ContractVerificationInput): boolean;
+/**
+ * @notice Defines verification delay times for different blockchain explorer families.
+ * @dev This constant object associates explorer families with specific delay times (in milliseconds)
+ */
+export declare const FamilyVerificationDelay: {
+    readonly etherscan: 40000;
+};
+/** Retrieves the constructor args using their respective Explorer and/or RPC (eth_getTransactionByHash)
+ */
+export declare function getConstructorArgumentsApi({ chainName, contractAddress, bytecode, multiProvider, }: {
+    bytecode: string;
+    chainName: string;
+    contractAddress: string;
+    multiProvider: MultiProvider;
+}): Promise<string>;
+export declare function getEtherscanConstructorArgs({ bytecode, chainName, contractAddress, multiProvider, }: {
+    bytecode: string;
+    chainName: string;
+    contractAddress: Address;
+    multiProvider: MultiProvider;
+}): Promise<string>;
+export declare function getZKSyncConstructorArgs({ chainName, contractAddress, multiProvider, }: {
+    chainName: string;
+    contractAddress: Address;
+    multiProvider: MultiProvider;
+}): Promise<string>;
+export declare function getBlockScoutConstructorArgs({ chainName, contractAddress, multiProvider, }: {
+    chainName: string;
+    contractAddress: Address;
+    multiProvider: MultiProvider;
+}): Promise<string>;
+export declare function getProxyAndAdminInput({ chainName, multiProvider, proxyAddress, }: {
+    chainName: string;
+    multiProvider: MultiProvider;
+    proxyAddress: Address;
+}): Promise<{
+    proxyAdminInput: ContractVerificationInput;
+    transparentUpgradeableProxyInput: ContractVerificationInput;
+    transparentUpgradeableImplementationInput: ContractVerificationInput;
+}>;
+export declare function getImplementationInput({ bytecode, chainName, contractName, implementationAddress, multiProvider, }: {
+    bytecode: string;
+    chainName: string;
+    contractName: string;
+    implementationAddress: Address;
+    multiProvider: MultiProvider;
+}): Promise<ContractVerificationInput>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/deploy/verify/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/deploy/verify/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,EAGL,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAqB,MAAM,mBAAmB,CAAC;AAI/D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,IAAI,EAAE,GAAG,EAAE,GACV,GAAG,CAKL;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,QAAQ,EAAE,MAAM,GACf,GAAG,CAIL;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,MAAM,EAC5B,OAAO,GAAE,OAAgC,EACzC,sBAAsB,CAAC,EAAE,MAAM,GAC9B,yBAAyB,CAQ3B;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,sBAAsB,GACvB,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,GAAG,yBAAyB,CAS5B;AAED,wBAAsB,qCAAqC,CAAC,EAC1D,IAAI,EACJ,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,OAAO,EACP,sBAAsB,GACvB,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CASrC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,MAAM,CAGxE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,kBAAkB,EAAE,QAAQ,CAAC,yBAAyB,EAAE,CAAC,EACzD,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAQT;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB;wBACN,KAAK;CACzB,CAAC;AAEX;GACG;AACH,wBAAsB,0BAA0B,CAAC,EAC/C,SAAS,EACT,eAAe,EACf,QAAQ,EACR,aAAa,GACd,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB;AA+CD,wBAAsB,2BAA2B,CAAC,EAChD,QAAQ,EACR,SAAS,EACT,eAAe,EACf,aAAa,GACd,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB;AAED,wBAAsB,wBAAwB,CAAC,EAC7C,SAAS,EACT,eAAe,EACf,aAAa,GACd,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBlB;AAED,wBAAsB,4BAA4B,CAAC,EACjD,SAAS,EACT,eAAe,EACf,aAAa,GACd,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAelB;AAED,wBAAsB,qBAAqB,CAAC,EAC1C,SAAS,EACT,aAAa,EACb,YAAY,GACb,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC;IACV,eAAe,EAAE,yBAAyB,CAAC;IAC3C,gCAAgC,EAAE,yBAAyB,CAAC;IAC5D,yCAAyC,EAAE,yBAAyB,CAAC;CACtE,CAAC,CA8CD;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAYrC"}

package/dist/deploy/verify/utils.js

@@ -0,0 +1,208 @@
+import { utils } from 'ethers';
+import { decodeFunctionData, parseAbi } from 'viem';
+import { ProxyAdmin__factory, TransparentUpgradeableProxy__factory, } from '@recoillink/core';
+import { assert, eqAddress } from '@recoillink/utils';
+import { tryGetContractDeploymentTransaction } from '../../block-explorer/etherscan.js';
+import { ExplorerFamily } from '../../metadata/chainMetadataTypes.js';
+import { proxyAdmin, proxyImplementation } from '../proxy.js';
+export function formatFunctionArguments(fragment, args) {
+    const params = Object.fromEntries(fragment.inputs.map((input, index) => [input.name, args[index]]));
+    return JSON.stringify(params, null, 2);
+}
+export function getConstructorArguments(contract, bytecode) {
+    const tx = contract.deployTransaction;
+    if (tx === undefined)
+        throw new Error('deploy transaction not found');
+    return tx.data.replace(bytecode, '');
+}
+export function buildVerificationInput(name, address, constructorArguments, isProxy = name.endsWith('Proxy'), expectedimplementation) {
+    return {
+        name: name.charAt(0).toUpperCase() + name.slice(1),
+        address,
+        constructorArguments,
+        isProxy,
+        expectedimplementation,
+    };
+}
+export function getContractVerificationInput({ name, contract, bytecode, isProxy, expectedimplementation, }) {
+    const args = getConstructorArguments(contract, bytecode);
+    return buildVerificationInput(name, contract.address, args, isProxy, expectedimplementation);
+}
+export async function getContractVerificationInputForZKSync({ name, contract, constructorArgs, artifact, isProxy, expectedimplementation, }) {
+    const args = encodeArguments(artifact.abi, constructorArgs);
+    return buildVerificationInput(name, contract.address, args, isProxy, expectedimplementation);
+}
+export function encodeArguments(abi, constructorArgs) {
+    const contractInterface = new utils.Interface(abi);
+    return contractInterface.encodeDeploy(constructorArgs).replace('0x', '');
+}
+/**
+ * Check if the artifact should be added to the verification inputs.
+ * @param verificationInputs - The verification inputs for the chain.
+ * @param chain - The chain to check.
+ * @param artifact - The artifact to check.
+ * @returns
+ */
+export function shouldAddVerificationInput(verificationInputs, chain, artifact) {
+    return !verificationInputs[chain].some((existingArtifact) => existingArtifact.name === artifact.name &&
+        eqAddress(existingArtifact.address, artifact.address) &&
+        existingArtifact.constructorArguments === artifact.constructorArguments &&
+        existingArtifact.isProxy === artifact.isProxy);
+}
+/**
+ * @notice Defines verification delay times for different blockchain explorer families.
+ * @dev This constant object associates explorer families with specific delay times (in milliseconds)
+ */
+export const FamilyVerificationDelay = {
+    [ExplorerFamily.Etherscan]: 40000,
+};
+/** Retrieves the constructor args using their respective Explorer and/or RPC (eth_getTransactionByHash)
+ */
+export async function getConstructorArgumentsApi({ chainName, contractAddress, bytecode, multiProvider, }) {
+    const { family } = multiProvider.getExplorerApi(chainName);
+    let constructorArgs;
+    switch (family) {
+        case ExplorerFamily.Routescan:
+        case ExplorerFamily.Etherscan:
+            constructorArgs = await getEtherscanConstructorArgs({
+                chainName,
+                contractAddress,
+                bytecode,
+                multiProvider,
+            });
+            break;
+        case ExplorerFamily.ZkSync:
+            constructorArgs = await getZKSyncConstructorArgs({
+                chainName,
+                contractAddress,
+                multiProvider,
+            });
+            break;
+        case ExplorerFamily.Blockscout:
+            constructorArgs = await getBlockScoutConstructorArgs({
+                chainName,
+                contractAddress,
+                multiProvider,
+            });
+            break;
+        default:
+            throw new Error(`Explorer Family ${family} unsupported`);
+    }
+    return constructorArgs;
+}
+async function getConstructorArgsFromExplorer({ chainName, blockExplorerApiKey, blockExplorerApiUrl, contractAddress, multiProvider, }) {
+    const url = new URL(blockExplorerApiUrl);
+    url.searchParams.append('module', 'contract');
+    url.searchParams.append('action', 'getcontractcreation');
+    url.searchParams.append('contractaddresses', contractAddress);
+    if (blockExplorerApiKey)
+        url.searchParams.append('apikey', blockExplorerApiKey);
+    const explorerResp = await fetch(url);
+    const creationTx = (await explorerResp.json()).result[0];
+    // Fetch deployment bytecode (includes constructor args)
+    assert(creationTx, 'Contract creation transaction not found!');
+    const metadata = multiProvider.getChainMetadata(chainName);
+    const rpcUrl = metadata.rpcUrls[0].http;
+    const creationTxResp = await fetch(rpcUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            method: 'eth_getTransactionByHash',
+            params: [creationTx.txHash],
+            id: 1,
+            jsonrpc: '2.0',
+        }),
+    });
+    return creationTxResp.json();
+}
+export async function getEtherscanConstructorArgs({ bytecode, chainName, contractAddress, multiProvider, }) {
+    const { apiUrl: blockExplorerApiUrl, apiKey: blockExplorerApiKey } = multiProvider.getExplorerApi(chainName);
+    const creationTx = await tryGetContractDeploymentTransaction({ apiUrl: blockExplorerApiUrl, apiKey: blockExplorerApiKey }, { contractAddress });
+    // Fetch deployment bytecode (includes constructor args)
+    assert(creationTx, 'Contract creation transaction not found!');
+    const metadata = multiProvider.getChainMetadata(chainName);
+    const rpcUrl = metadata.rpcUrls[0].http;
+    const creationTxResp = await fetch(rpcUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            method: 'eth_getTransactionByHash',
+            params: [creationTx.txHash],
+            id: 1,
+            jsonrpc: '2.0',
+        }),
+    });
+    // Truncate the deployment bytecode
+    const creationInput = (await creationTxResp.json()).result.input;
+    return creationInput.substring(bytecode.length);
+}
+export async function getZKSyncConstructorArgs({ chainName, contractAddress, multiProvider, }) {
+    const { apiUrl, apiKey: blockExplorerApiKey } = multiProvider.getExplorerApi(chainName);
+    // Create the API URL using Registry blockExplorers.apiUrl
+    // Assumes that ZkSync uses something like `https://zero-network.calderaexplorer.xyz/verification/contract_verification`.
+    const blockExplorerApiUrl = new URL('/api', new URL(apiUrl).origin).href;
+    // Truncate the deployment bytecode
+    const creationTxResp = await getConstructorArgsFromExplorer({
+        chainName,
+        blockExplorerApiKey,
+        blockExplorerApiUrl,
+        contractAddress,
+        multiProvider,
+    });
+    const creationInput = creationTxResp.result.input;
+    const res = decodeFunctionData({
+        abi: parseAbi(['function create(bytes32,bytes32,bytes)']),
+        data: creationInput,
+    });
+    return res.args[2].replace('0x', '');
+}
+export async function getBlockScoutConstructorArgs({ chainName, contractAddress, multiProvider, }) {
+    const { apiUrl: blockExplorerApiUrl } = multiProvider.getExplorerApi(chainName);
+    const url = new URL(`/api/v2/smart-contracts/${contractAddress}`, blockExplorerApiUrl);
+    const smartContractResp = await fetch(url, {
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+    return (await smartContractResp.json()).constructor_args;
+}
+export async function getProxyAndAdminInput({ chainName, multiProvider, proxyAddress, }) {
+    const provider = multiProvider.getProvider(chainName);
+    const proxyAdminAddress = await proxyAdmin(provider, proxyAddress);
+    const proxyAdminConstructorArgs = await getConstructorArgumentsApi({
+        chainName,
+        multiProvider,
+        bytecode: ProxyAdmin__factory.bytecode,
+        contractAddress: proxyAdminAddress,
+    });
+    const proxyAdminInput = buildVerificationInput('ProxyAdmin', proxyAdminAddress, proxyAdminConstructorArgs);
+    const proxyConstructorArgs = await getConstructorArgumentsApi({
+        chainName,
+        multiProvider,
+        contractAddress: proxyAddress,
+        bytecode: TransparentUpgradeableProxy__factory.bytecode,
+    });
+    const transparentUpgradeableProxyInput = buildVerificationInput('TransparentUpgradeableProxy', proxyAddress, proxyConstructorArgs, true, await proxyImplementation(provider, proxyAddress));
+    // Input for TUP as an implementation (isProxy = false).
+    // Strangely this is needed to verify the proxy on etherscan.
+    const transparentUpgradeableImplementationInput = buildVerificationInput('TransparentUpgradeableProxy', proxyAddress, proxyConstructorArgs, false, await proxyImplementation(provider, proxyAddress));
+    return {
+        proxyAdminInput,
+        transparentUpgradeableProxyInput,
+        transparentUpgradeableImplementationInput,
+    };
+}
+export async function getImplementationInput({ bytecode, chainName, contractName, implementationAddress, multiProvider, }) {
+    const implementationConstructorArgs = await getConstructorArgumentsApi({
+        bytecode,
+        chainName,
+        multiProvider,
+        contractAddress: implementationAddress,
+    });
+    return buildVerificationInput(contractName, implementationAddress, implementationConstructorArgs);
+}
+//# sourceMappingURL=utils.js.map

package/dist/deploy/verify/utils.js.map

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

package/dist/deploy/verify/utils.test.d.ts

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

package/dist/deploy/verify/utils.test.d.ts.map

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

package/dist/deploy/verify/utils.test.js

@@ -0,0 +1,49 @@
+import { expect } from 'chai';
+import { TestChainName } from '../../consts/testChains.js';
+import { randomAddress } from '../../test/testUtils.js';
+import { shouldAddVerificationInput } from './utils.js';
+describe('shouldAddVerificationInput', () => {
+    const addressA = randomAddress();
+    const addressB = randomAddress();
+    it('should return true if the artifact does not exist in the verification inputs', () => {
+        const verificationInputs = {
+            [TestChainName.test1]: [
+                {
+                    name: 'ContractA',
+                    address: addressA,
+                    constructorArguments: 'args',
+                    isProxy: false,
+                },
+            ],
+        };
+        const newArtifact = {
+            name: 'ContractB',
+            address: addressB,
+            constructorArguments: 'argsB',
+            isProxy: true,
+        };
+        const chain = TestChainName.test1;
+        expect(shouldAddVerificationInput(verificationInputs, chain, newArtifact)).to.equal(true);
+    });
+    it('should return false if the artifact already exists in the verification inputs', () => {
+        const verificationInputs = {
+            [TestChainName.test2]: [
+                {
+                    name: 'ContractA',
+                    address: addressA,
+                    constructorArguments: 'args',
+                    isProxy: false,
+                },
+            ],
+        };
+        const existingArtifact = {
+            name: 'ContractA',
+            address: addressA,
+            constructorArguments: 'args',
+            isProxy: false,
+        };
+        const chain = TestChainName.test2;
+        expect(shouldAddVerificationInput(verificationInputs, chain, existingArtifact)).to.equal(false);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/deploy/verify/utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../../src/deploy/verify/utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,kBAAkB,GAA0C;YAChE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;gBACrB;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,QAAQ;oBACjB,oBAAoB,EAAE,MAAM;oBAC5B,OAAO,EAAE,KAAK;iBACf;aACF;SACF,CAAC;QACF,MAAM,WAAW,GAA8B;YAC7C,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,QAAQ;YACjB,oBAAoB,EAAE,OAAO;YAC7B,OAAO,EAAE,IAAI;SACd,CAAC;QACF,MAAM,KAAK,GAAc,aAAa,CAAC,KAAK,CAAC;QAC7C,MAAM,CACJ,0BAA0B,CAAC,kBAAkB,EAAE,KAAK,EAAE,WAAW,CAAC,CACnE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,kBAAkB,GAA0C;YAChE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;gBACrB;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,QAAQ;oBACjB,oBAAoB,EAAE,MAAM;oBAC5B,OAAO,EAAE,KAAK;iBACf;aACF;SACF,CAAC;QACF,MAAM,gBAAgB,GAA8B;YAClD,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,QAAQ;YACjB,oBAAoB,EAAE,MAAM;YAC5B,OAAO,EAAE,KAAK;SACf,CAAC;QACF,MAAM,KAAK,GAAc,aAAa,CAAC,KAAK,CAAC;QAC7C,MAAM,CACJ,0BAA0B,CAAC,kBAAkB,EAAE,KAAK,EAAE,gBAAgB,CAAC,CACxE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/deploy/warp.d.ts

@@ -0,0 +1,150 @@
+import { AltVM, ProtocolType } from '@recoillink/provider-sdk';
+import { type ChainLookup } from '@recoillink/provider-sdk/chain';
+import { type FeeReadContext } from '@recoillink/provider-sdk/fee';
+import { AnnotatedTx, TxReceipt } from '@recoillink/provider-sdk/module';
+import { WarpConfig as ProviderWarpConfig } from '@recoillink/provider-sdk/warp';
+import { Address } from '@recoillink/utils';
+import { DelayedFlowRouterHookIsmConfig } from '../ism/types.js';
+import { MultiProvider } from '../providers/MultiProvider.js';
+import { AnnotatedEV5Transaction, TypedAnnotatedTransaction } from '../providers/ProviderType.js';
+import { WarpRouteDeployConfig, WarpRouteDeployConfigMailboxRequired } from '../token/types.js';
+import { ChainMap, ChainName } from '../types.js';
+type ChainAddresses = Record<string, string>;
+/**
+ * Builds a `FeeReadContext` directly from a warp deploy config, bypassing
+ * `validateWarpConfigForAltVM` + `warpConfigToArtifact` +
+ * `buildFeeReadContextFromWarpArtifactConfig`. The read flow only needs the
+ * per-domain router set, not the full `ProviderWarpConfig` conversion, so
+ * this works for any token type (including EVM-only `xerc20`,
+ * `fastCollateral`, etc.) that the AltVM validator would reject.
+ *
+ * Mirrors `buildFeeReadContextFromWarpArtifactConfig` (provider-sdk) — same
+ * `DEFAULT_CROSS_COLLATERAL_FEE_ROUTER_KEY` injection so CC default-router
+ * quotes remain visible to the reader.
+ */
+export declare function buildFeeReadContextFromWarpDeployConfig(config: WarpRouteDeployConfigMailboxRequired[string], chainLookup: ChainLookup): FeeReadContext;
+export declare function validateWarpConfigForAltVM(config: WarpRouteDeployConfigMailboxRequired[string], chain: string, protocol?: ProtocolType): ProviderWarpConfig;
+export type WarpDeployArgs = {
+    warpDeployConfig: WarpRouteDeployConfigMailboxRequired;
+    multiProvider: MultiProvider;
+    altVmSigners: ChainMap<AltVM.ISigner<AnnotatedTx, TxReceipt>>;
+    registryAddresses: ChainMap<ChainAddresses>;
+    apiKeys: ChainMap<string>;
+};
+/**
+ * Deploys a WHOLE warp route: its routers, plus the ISM and hook trees they
+ * install.
+ *
+ * Everything decidable from the config is decided before any gas is spent —
+ * the full `IsmConfigSchema`/`HookConfigSchema` refinement over both trees, the
+ * hybrid hook/ISM pairing (planWarpRouteHybrids), and the route-scoped
+ * delayed-flow invariants. The route-scoped ones read the config's chain set as
+ * "the route", so they belong to this entry point alone: shrinking the config
+ * does not narrow them, it enlarges what counts as outside the route. Use
+ * `executeWarpRouteExtensionDeploy` for the chains an extension adds.
+ */
+export declare function executeWarpDeploy(warpDeployConfig: WarpRouteDeployConfigMailboxRequired, multiProvider: MultiProvider, altVmSigners: ChainMap<AltVM.ISigner<AnnotatedTx, TxReceipt>>, registryAddresses: ChainMap<ChainAddresses>, apiKeys: ChainMap<string>): Promise<ChainMap<Address>>;
+/**
+ * Deploys the chains an extension adds to an EXISTING route.
+ *
+ * Same engine as `executeWarpDeploy`, minus the invariants that measure the
+ * route by the config's own chain set — the caller holds the full route config
+ * and has already checked those (runWarpRouteApply). Everything per chain still
+ * runs here, so an extension cannot deploy a chain whose composition can never
+ * work.
+ *
+ * A separate entry point rather than a flag: which validation applies is a
+ * property of what the caller is deploying, not something to infer from the
+ * shape of the config it happens to pass.
+ */
+export declare function executeWarpRouteExtensionDeploy(warpDeployConfig: WarpRouteDeployConfigMailboxRequired, multiProvider: MultiProvider, altVmSigners: ChainMap<AltVM.ISigner<AnnotatedTx, TxReceipt>>, registryAddresses: ChainMap<ChainAddresses>, apiKeys: ChainMap<string>): Promise<ChainMap<Address>>;
+export type DelayedFlowEnrollmentTarget = {
+    ismAddress: Address;
+    userNode: DelayedFlowRouterHookIsmConfig;
+};
+/**
+ * Whole-route coverage: every leg carries an instance
+ * (assertDelayedFlowLegCoverage), and a `remoteRouters` entry naming a chain
+ * outside the route has to enroll that counterpart explicitly
+ * (assertDelayedFlowRemoteRouterCoverage).
+ *
+ * Correct only against the FULL route config. Shrinking the config enlarges
+ * what counts as outside the route, so running this on a subset — the single
+ * chain `warp apply` deploys per extension, say — rejects `remoteRouters`
+ * entries naming the very legs that chain is joining.
+ */
+export declare function assertDelayedFlowRouteCoverage({ multiProvider, warpDeployConfig, }: {
+    multiProvider: MultiProvider;
+    warpDeployConfig: WarpRouteDeployConfigMailboxRequired;
+}): void;
+/**
+ * The full delayed-flow preconditions for a whole route, checked before any
+ * on-chain work: assertDelayedFlowRouteCoverage — which adds the route-scoped
+ * external `remoteRouters` check to the leg coverage above — and the
+ * mailbox nonce guard.
+ *
+ * Call this with every chain of the route. The CLI entry points do
+ * (runWarpRouteDeploy, runWarpRouteApply); executeWarpDeploy cannot, because
+ * an extension reaches it one chain at a time.
+ */
+export declare function assertDelayedFlowRoutePreconditions({ multiProvider, warpDeployConfig, }: {
+    multiProvider: MultiProvider;
+    warpDeployConfig: WarpRouteDeployConfigMailboxRequired;
+}): Promise<void>;
+/**
+ * Resolves the shared hybrid instance behind each chain's ISM tree.
+ *
+ * Callers pass whichever tree is authoritative for them: the address a run has
+ * just deployed but not yet installed, or the tree already on the router.
+ * Nothing here guesses between the two — a caller that knows both states knows
+ * which one it means.
+ */
+export declare function resolveHybridIsmAddresses(multiProvider: MultiProvider, ismTreeAddresses: ChainMap<Address>): Promise<ChainMap<Address>>;
+/**
+ * Resolves the hybrid instance installed on each router, by reading the ISM the
+ * router currently points at. Used by callers holding only routers, such as
+ * `warp apply` on chains it is not re-deploying.
+ */
+export declare function readInstalledHybridIsmAddresses(multiProvider: MultiProvider, routers: ChainMap<Address>): Promise<ChainMap<Address>>;
+/**
+ * Pairs the route's DelayedFlowRouterHookIsm instances so each one's enrollment
+ * transactions can name every other one.
+ *
+ * `hybridIsmAddresses` is supplied by the caller (resolveHybridIsmAddresses /
+ * readInstalledHybridIsmAddresses) rather than re-derived here: which tree is
+ * authoritative differs per caller, and a chain whose instance the caller could
+ * not resolve is skipped rather than silently paired against a stale one. The
+ * config node is carried through as `userNode` so configured external
+ * `remoteIsms` are merged with the route-derived pairing.
+ */
+export declare function deriveDelayedFlowEnrollmentTargets(multiProvider: MultiProvider, warpDeployConfig: WarpRouteDeployConfig, deployedContracts: ChainMap<Address>, hybridIsmAddresses?: ChainMap<Address>): Promise<ChainMap<DelayedFlowEnrollmentTarget>>;
+/**
+ * Builds the enrollment transactions for one chain's
+ * DelayedFlowRouterHookIsm: enrolls every other chain's instance as a remote
+ * counterpart, plus configured peers outside the route, and
+ * optionally transfers ownership to the configured owner LAST (the enrollment
+ * calls are owner-gated). Converges to zero transactions once the on-chain
+ * state already matches.
+ *
+ * Shared by the deploy flow (deployer-owned instances) and `warp apply`
+ * (instances that may be owned by a Safe/ICA — the returned transactions carry
+ * no signing assumptions and ride whichever submitter the caller uses).
+ */
+export declare function buildDelayedFlowEnrollmentTxs({ chain, multiProvider, registryAddresses, warpRouter, target, allTargets, reconcileOwnership, }: {
+    chain: ChainName;
+    multiProvider: MultiProvider;
+    registryAddresses: ChainMap<ChainAddresses>;
+    warpRouter: Address;
+    target: DelayedFlowEnrollmentTarget;
+    allTargets: ChainMap<DelayedFlowEnrollmentTarget>;
+    /** Preserve the current owner when ownership is handled by another phase. */
+    reconcileOwnership?: boolean;
+}): Promise<AnnotatedEV5Transaction[]>;
+export declare function enrollCrossChainRouters({ multiProvider, altVmSigners, registryAddresses, warpDeployConfig, }: {
+    multiProvider: MultiProvider;
+    altVmSigners: ChainMap<AltVM.ISigner<AnnotatedTx, TxReceipt>>;
+    registryAddresses: ChainMap<ChainAddresses>;
+    warpDeployConfig: WarpRouteDeployConfigMailboxRequired;
+}, deployedContracts: ChainMap<Address>): Promise<ChainMap<TypedAnnotatedTransaction[]>>;
+export {};
+//# sourceMappingURL=warp.d.ts.map

package/dist/deploy/warp.d.ts.map

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