@suzaku-network/suzaku-cli 1.0.2

package/dist/lib/viemUtils.js

@@ -0,0 +1,317 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.curriedContract = exports.isCastMode = exports.setCastMode = void 0;
+exports.withSafeWrite = withSafeWrite;
+exports.withMulticall = withMulticall;
+exports.contractAbiValidation = contractAbiValidation;
+const viem_1 = require("viem");
+const abis_1 = require("../abis");
+const logger_1 = require("./logger");
+const utils_1 = require("./utils");
+const console_log_colors_1 = require("console-log-colors");
+const safeUtils_1 = require("./safeUtils");
+const abi_selectors_json_1 = __importDefault(require("../abis/abi-selectors.json"));
+const modern_ahocorasick_1 = __importDefault(require("modern-ahocorasick"));
+const castUtils_1 = require("./castUtils");
+var castUtils_2 = require("./castUtils");
+Object.defineProperty(exports, "setCastMode", { enumerable: true, get: function () { return castUtils_2.setCastMode; } });
+Object.defineProperty(exports, "isCastMode", { enumerable: true, get: function () { return castUtils_2.isCastMode; } });
+function handleContractError(error, abi) {
+    if (error instanceof viem_1.ContractFunctionExecutionError) {
+        throw Error(`${abi} ${error.cause}`);
+    }
+    else if (error instanceof Error) {
+        const eraseToIndex = error.message.indexOf("Docs:");
+        if (eraseToIndex === -1)
+            throw error;
+        throw Error(`${abi} ${error.message.slice(0, eraseToIndex - 1)}`);
+    }
+    else if (error instanceof Object) {
+        const eraseToIndex = error.message.indexOf("Docs:");
+        if (eraseToIndex === -1)
+            throw error;
+        throw Error(`${abi} ${error.message.slice(0, eraseToIndex - 1)}`);
+    }
+    else {
+        throw error;
+    }
+}
+// Map a proxy handler on safeWrite methods of the contract to simulate the write operation before executing it
+function withSafeWrite(contract, abi, client, confirmations = 1) {
+    // Introspection
+    contract.name = abi;
+    if ('write' in contract) {
+        // Proxy handler for write methods to add Safe transaction handling and wait for confirmations
+        const writeHandler = {
+            get(target, prop) {
+                const fn = target[prop];
+                if (typeof fn !== 'function')
+                    return fn;
+                return async (args, options) => {
+                    try {
+                        // ── Cast mode: log the equivalent cast send command and skip execution
+                        if ((0, castUtils_1.isCastMode)()) {
+                            const rpcUrl = client.chain?.rpcUrls?.default?.http?.[0];
+                            (0, castUtils_1.logCastSend)(contract.name, contract.address, abis_1.SuzakuABI[abi], prop, Array.isArray(args) ? args : args != null ? [args] : [], rpcUrl, options);
+                            return undefined;
+                        }
+                        let hash;
+                        // If a safe smart account is connected, use it to send the transaction
+                        if ("safe" in client && client.safe != undefined) {
+                            const transaction = {
+                                to: contract.address,
+                                data: (0, viem_1.encodeFunctionData)({
+                                    abi: abis_1.SuzakuABI[abi],
+                                    functionName: prop,
+                                    args
+                                }),
+                                chain: null,
+                                account: client.account,
+                                ...options,
+                                value: options?.value ? options.value : '0',
+                            };
+                            const selection = await (0, safeUtils_1.handleTransactionStrategy)(transaction, client.safe, abis_1.SuzakuABI[abi], client.account.address);
+                            switch (selection.action) {
+                                case 'new':
+                                    logger_1.logger.debug(`Sending a new Safe transaction as owner`);
+                                    hash = (await client.safe.send({ transactions: [transaction] })).transactions?.ethereumTxHash;
+                                    break;
+                                case 'confirm':
+                                    logger_1.logger.debug(`Confirming a Safe transaction as owner`);
+                                    hash = (await client.safe.confirm({ safeTxHash: selection.hash })).transactions?.ethereumTxHash;
+                                    break;
+                                case 'propose':
+                                    logger_1.logger.debug(`Proposing a Safe transaction as delegate`);
+                                    const safeTransaction = await client.safe.protocolKit.createTransaction({
+                                        transactions: [transaction]
+                                    });
+                                    const safeTxHash = await client.safe.protocolKit.getTransactionHash(safeTransaction);
+                                    const signature = await client.safe.protocolKit.signHash(safeTxHash);
+                                    await client.safe.apiKit.proposeTransaction({
+                                        safeAddress: await client.safe.getAddress(),
+                                        safeTransactionData: safeTransaction.data,
+                                        safeTxHash,
+                                        senderAddress: (0, viem_1.getAddress)(client.account.address),
+                                        senderSignature: signature.data
+                                    });
+                                    hash = selection.hash;
+                                    break;
+                                default: // same as skip
+                                    logger_1.logger.debug(`Skipping a Safe transaction`);
+                                    hash = selection.hash;
+                            }
+                        }
+                        else {
+                            hash = await fn(args, { chain: null, account: client.account, ...options });
+                        }
+                        const sig = `${contract.name}.${prop}(${args.join ? args.join(', ') : args})`;
+                        logger_1.logger.addData('txs', { to: contract.address, invocation: sig, hash, options });
+                        if (!hash)
+                            return undefined; // when skipping
+                        const receipt = await client.waitForTransactionReceipt({ hash, confirmations });
+                        if (receipt.status === 'reverted')
+                            throw new Error(`Transaction ${console_log_colors_1.color.red(sig)} (hash: ${hash}) reverted, pls resend the transaction:\n` + JSON.stringify(receipt.logs, utils_1.bigintReplacer));
+                        const logs = (0, viem_1.parseEventLogs)({
+                            abi: abis_1.SuzakuABI[abi],
+                            logs: receipt.logs,
+                        });
+                        if (logs.length > 0) {
+                            logger_1.logger.log("\nLogs emitted during the transaction:");
+                            logger_1.logger.log(logs.map((log) => {
+                                return `  ${console_log_colors_1.color.magenta(log.eventName)}${JSON.stringify(log.args, utils_1.bigintReplacer)}`;
+                            }).join('\n'));
+                            logger_1.logger.log("");
+                            logger_1.logger.addData('receipt', receipt);
+                        }
+                        return hash;
+                    }
+                    catch (error) {
+                        handleContractError(error, abi);
+                    }
+                };
+            },
+        };
+        contract.write = new Proxy(contract.write, writeHandler);
+        // Proxy handler for safeWrite methods to simulate the write operation before executing it
+        const safeWriteHandler = {
+            get(target, prop) {
+                const fn = target[prop];
+                if (typeof fn !== 'function')
+                    return fn;
+                return async (args, options) => {
+                    try {
+                        // Skip simulation in cast mode — the write handler will log the command
+                        if (!(0, castUtils_1.isCastMode)()) {
+                            const simulateFn = contract.simulate?.[prop];
+                            if (typeof simulateFn === 'function') {
+                                // If any safe is connected, use its address to simulate the transaction
+                                await simulateFn(args, "safe" in client && client.safe != undefined ? { ...options, account: await client.safe.getAddress() } : options);
+                            }
+                        }
+                        return await fn(args, options);
+                    }
+                    catch (error) {
+                        handleContractError(error, abi);
+                    }
+                };
+            },
+        };
+        contract.safeWrite = new Proxy(contract.write, safeWriteHandler);
+    }
+    return contract;
+}
+// Map a proxy handler on safeWrite methods of the contract to simulate the write operation before executing it
+function withMulticall(contract, abi, client) {
+    // Introspection
+    contract.name = abi;
+    if ('read' in contract) {
+        // Proxy handler for read methods to catch and format errors
+        const readHandler = {
+            get(target, prop) {
+                const fn = target[prop];
+                if (typeof fn !== 'function')
+                    return fn;
+                return async (...args) => {
+                    try {
+                        if ((0, castUtils_1.isCastMode)()) {
+                            const rpcUrl = client.chain?.rpcUrls?.default?.http?.[0];
+                            (0, castUtils_1.logCastCall)(contract.name, contract.address, abis_1.SuzakuABI[abi], prop, args, rpcUrl);
+                        }
+                        const result = await fn(...args);
+                        const functionSignature = `${contract.name}.${prop}(${args.join ? args.join(', ') : args})`;
+                        logger_1.logger.addData('receipt', { functionSignature, result });
+                        return result;
+                    }
+                    catch (error) {
+                        handleContractError(error, abi);
+                    }
+                };
+            },
+        };
+        contract.read = new Proxy(contract.read, readHandler);
+        // Multicall implementation for batching read operations
+        contract.multicall = async (items, options) => {
+            const contracts = items.map((item) => {
+                const functionName = typeof item === 'string' ? item : item.name;
+                const args = typeof item === 'object' && 'args' in item ? item.args : [];
+                return {
+                    address: contract.address,
+                    abi: abis_1.SuzakuABI[abi],
+                    functionName,
+                    args,
+                };
+            });
+            if ((0, castUtils_1.isCastMode)()) {
+                const rpcUrl = client.chain?.rpcUrls?.default?.http?.[0];
+                for (const c of contracts) {
+                    (0, castUtils_1.logCastCall)(contract.name, c.address, c.abi, c.functionName, c.args ?? [], rpcUrl);
+                }
+            }
+            const results = await client.multicall({ contracts: contracts });
+            return results.map((result, index) => {
+                const item = items[index];
+                const name = typeof item === 'string' ? item : item.name;
+                if (result.status === 'failure') {
+                    if (options?.strict) {
+                        throw new Error(`Multicall failed for ${name}: ${result.error}`);
+                    }
+                    logger_1.logger.warn(`Multicall failed for ${name}: ${result.error}`);
+                }
+                return options?.details ? {
+                    name,
+                    result: result.status === 'success' ? result.result : undefined,
+                    args: typeof item === 'object' && 'args' in item ? item.args : [],
+                } : result.result;
+            });
+        };
+    }
+    return contract;
+}
+const curriedContract = (abi, client, wait = 0, skipAbiValidation = false) => async (address) => {
+    // format camelCase ABI name to SCREAMING_SNAKE_CASE for env var lookup
+    const envVar = abi.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
+    if (!address) {
+        if (process.env[envVar])
+            address = process.env[envVar];
+        else
+            throw new Error(`Address is required to create a contract instance for ${abi}. Please provide associated option or set as environment variable ${envVar}`);
+    }
+    if (!skipAbiValidation) {
+        // (StakingVault uses delegatecall to forward to operations implementation)
+        // Skip ABI validation since functions are forwarded via fallback
+        if (abi.includes("StakingVault")) {
+            await contractAbiValidation(client, ["StakingVault"], address);
+        }
+        else {
+            await contractAbiValidation(client, [abi], address);
+        }
+    }
+    const contract = withMulticall((0, viem_1.getContract)({
+        abi: abis_1.SuzakuABI[abi],
+        address,
+        client,
+    }), abi, client);
+    return withSafeWrite(contract, abi, client, wait);
+};
+exports.curriedContract = curriedContract;
+async function contractAbiValidation(client, abis, address) {
+    // Tolerance for missing selectors 6%
+    const TOLERANCE = 0.06;
+    // Check for proxy
+    const proxyImplementation = await client.getStorageAt({
+        address,
+        slot: '0x360894A13BA1A3210667C828492DB98DCA3E2076CC3735A920A3CA505D382BBC' // EIP-1967 implementation slot
+    });
+    if (proxyImplementation !== '0x0000000000000000000000000000000000000000000000000000000000000000') {
+        address = (0, utils_1.bytes32ToAddress)(proxyImplementation);
+        logger_1.logger.debug(`Detected proxy contract. Using implementation at address ${address} for ABI validation.`);
+    }
+    let contractByteCode = await client.getCode({ address });
+    if (!contractByteCode || contractByteCode === '0x') {
+        logger_1.logger.exitError([`No contract found at address ${address} for ABIs ${abis.join(', ')}`], 3);
+        return [];
+    }
+    // Check for EIP-1167 minimal proxy
+    if (contractByteCode.startsWith('0x363d3d373d3d3d363d73') && contractByteCode.endsWith('5af43d82803e903d91602b57fd5bf3')) {
+        const implementationAddress = '0x' + contractByteCode.slice(22, 62);
+        logger_1.logger.debug(`Detected EIP-1167 minimal proxy. Using implementation at address ${implementationAddress} for ABI validation.`);
+        contractByteCode = await client.getCode({ address: implementationAddress });
+        if (!contractByteCode || contractByteCode === '0x') {
+            logger_1.logger.exitError([`No contract found at address ${address} for ABIs ${abis.join(', ')}`], 3);
+            return [];
+        }
+    }
+    // Validate ABI by checking that all function selectors are present in the bytecode
+    const ACs = abis.map((abi) => {
+        const selectors = abi_selectors_json_1.default[abi];
+        if (!selectors) {
+            logger_1.logger.warn(`No selectors found for ABI ${abi}, skipping validation`);
+            return [new modern_ahocorasick_1.default([]), 0];
+        }
+        return [new modern_ahocorasick_1.default(selectors), Object.keys(selectors).length];
+    }); // Use Aho-Corasick algorithm for multi-pattern search (perf)
+    const missingRatio = ACs.map(([ac, selectorCount]) => {
+        const matches = new Set(ac.search(contractByteCode).map(m => m[1][0])); // get only the matched selectors
+        // Validation
+        const missingCount = selectorCount - matches.size;
+        return [missingCount, missingCount / selectorCount, matches];
+    });
+    const result = missingRatio.reduce((acc, [missingCount, ratio, matches], i) => {
+        if (ratio > 0) {
+            const selectors = abi_selectors_json_1.default[abis[i]];
+            logger_1.logger.debug(`ABI validation for contract ${abis[i]} at address ${address}: ${matches.size} selectors matched, ${missingCount} missing (${(ratio * 100).toFixed(2)}% missing)`);
+            if (selectors) {
+                logger_1.logger.debug(`Missing selectors: ${selectors.filter((s) => !matches.has(s)).join(', ')}`);
+            }
+        }
+        return [...acc, { name: abis[i], ratio, valid: ratio < TOLERANCE }];
+    }, []);
+    if (result.every(r => !r.valid)) {
+        logger_1.logger.exitError([`The contract at address ${address} does not match the expected ABI for ${abis.join(', ')} contract.`], 3);
+    }
+    return result;
+}
+//# sourceMappingURL=viemUtils.js.map

package/dist/lib/viemUtils.js.map

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

package/dist/lib/warpUtils.d.ts

@@ -0,0 +1,76 @@
+import { Hex, Log } from 'viem';
+import { PChainOwner } from './justification';
+import { ExtendedClient, Network } from '../client';
+interface CollectSignaturesProps {
+    network: Network;
+    message: string;
+    justification?: string;
+    signingSubnetId?: string;
+}
+export interface PackL1ConversionMessageArgs {
+    subnetId: string;
+    managerChainID: string;
+    managerAddress: string;
+    validators: SubnetToL1ConversionValidatorData[];
+}
+export interface SubnetToL1ConversionValidatorData {
+    nodeID: string;
+    nodePOP: {
+        publicKey: string;
+        proofOfPossession: string;
+    };
+    weight: number;
+}
+export declare function packL1ConversionMessage(args: PackL1ConversionMessageArgs, networkID: number, sourceChainID: string): [Uint8Array, Uint8Array];
+export declare function subnetToL1ConversionID(args: PackL1ConversionMessageArgs): Uint8Array;
+export declare function marshalSubnetToL1ConversionData(args: PackL1ConversionMessageArgs): Uint8Array;
+export declare const compareNodeIDs: (a: string, b: string) => number;
+export declare function packWarpIntoAccessList(warpMessageBytes: Uint8Array): [
+    {
+        address: Hex;
+        storageKeys: Hex[];
+    }
+];
+export declare function collectSignaturesInitializeValidatorSet(params: {
+    network: Network;
+    subnetId: string;
+    validatorManagerBlockchainID: string;
+    validatorManagerSubnetID: string;
+    managerAddress: Hex;
+    validators: {
+        nodeID: string;
+        blsPublicKey: string;
+        blsProofOfPossession: string;
+        weight: number;
+        balance: number;
+    }[];
+}): Promise<string>;
+export declare function getSigningSubnetIdFromWarpMessage(client: ExtendedClient, message: string): Promise<string>;
+export declare function collectSignatures({ network, message, justification, signingSubnetId }: CollectSignaturesProps): Promise<Hex>;
+export declare function packL1ValidatorRegistration(validationID: Uint8Array, registered: boolean, networkID: number, sourceChainID: string): Uint8Array;
+export declare function packL1ValidatorWeightMessage(validationID: Uint8Array, nonce: bigint, weight: bigint, networkID: number, sourceChainID: string): Uint8Array;
+export interface SolidityValidationPeriod {
+    subnetID: Uint8Array;
+    nodeID: Uint8Array;
+    blsPublicKey: Uint8Array;
+    registrationExpiry: bigint;
+    remainingBalanceOwner: PChainOwner;
+    disableOwner: PChainOwner;
+    weight: bigint;
+}
+export declare function packRegisterL1ValidatorPayload(validationPeriod: SolidityValidationPeriod): Uint8Array;
+/**
+ * Parses the payload of a RegisterL1ValidatorMessage into the SolidityValidationPeriod structure.
+ * Mirrors Solidity's unpackRegisterL1ValidatorMessage.
+ */
+export declare function unpackRegisterL1ValidatorPayload(input: Uint8Array): SolidityValidationPeriod;
+export declare function packValidationUptimeMessage(validationId: string, uptimeSeconds: number, networkID: number, sourceChainID: string): Uint8Array;
+export declare function decodeWarpMessage(log: Log): {
+    eventName: "SendWarpMessage";
+    args: {
+        sender: string;
+        messageID: `0x${string}`;
+        message: `0x${string}`;
+    };
+};
+export {};