@0xsequence/catapult 1.1.0

package/dist/lib/verification/sourcify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcify.d.ts","sourceRoot":"","sources":["../../../src/lib/verification/sourcify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE3F,qBAAa,4BAA6B,YAAW,oBAAoB;IACvE,QAAQ,CAAC,IAAI,cAAa;IAE1B,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAK1C,YAAY,IAAI,OAAO;IAKvB,4BAA4B,IAAI,MAAM;IAIhC,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA6B9E,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAgIjE,sBAAsB;CAsErC"}

package/dist/lib/verification/sourcify.js

@@ -0,0 +1,227 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SourcifyVerificationPlatform = void 0;
+class SourcifyVerificationPlatform {
+    constructor() {
+        this.name = 'sourcify';
+    }
+    supportsNetwork(network) {
+        return !network.supports || network.supports.includes(this.name);
+    }
+    isConfigured() {
+        return true;
+    }
+    getConfigurationRequirements() {
+        return 'Sourcify requires no configuration';
+    }
+    async isContractAlreadyVerified(address, network) {
+        try {
+            const response = await fetch(`https://sourcify.dev/server/check-by-addresses?addresses=${address}&chainIds=${network.chainId}`, {
+                method: 'GET',
+                signal: AbortSignal.timeout(15000),
+            });
+            if (!response.ok) {
+                return false;
+            }
+            const data = await response.json();
+            return Array.isArray(data) && data.some(item => item.address?.toLowerCase() === address.toLowerCase() &&
+                item.chainId === network.chainId.toString() &&
+                (item.status === 'perfect' || item.status === 'partial'));
+        }
+        catch (error) {
+            console.warn(`Failed to check Sourcify verification status for ${address}: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    async verifyContract(request) {
+        const { contract, buildInfo, address, network } = request;
+        const alreadyVerified = await this.isContractAlreadyVerified(address, network);
+        if (alreadyVerified) {
+            return {
+                success: true,
+                message: 'Contract was already verified on Sourcify (checked before attempting verification)',
+                isAlreadyVerified: true
+            };
+        }
+        try {
+            const { metadata, sourceFiles } = await this.createVerificationData(contract, buildInfo);
+            const formData = new FormData();
+            formData.append('address', address);
+            formData.append('chain', network.chainId.toString());
+            const metadataJson = JSON.stringify(metadata, null, 2);
+            const metadataBlob = new Blob([metadataJson], { type: 'application/json' });
+            formData.append('files', metadataBlob, 'metadata.json');
+            for (const [sourcePath, sourceContent] of sourceFiles) {
+                const sourceBlob = new Blob([sourceContent], { type: 'text/plain' });
+                formData.append('files', sourceBlob, sourcePath);
+            }
+            const response = await fetch('https://sourcify.dev/server/verify', {
+                method: 'POST',
+                body: formData,
+                signal: AbortSignal.timeout(60000),
+            });
+            if (!response.ok) {
+                let responseText = '';
+                try {
+                    responseText = await response.text();
+                }
+                catch {
+                }
+                if (response.status === 409) {
+                    const lower = `${response.statusText} ${responseText}`.toLowerCase();
+                    if (lower.includes('already partially verified') ||
+                        lower.includes('partial match') ||
+                        lower.includes('partial')) {
+                        return {
+                            success: true,
+                            message: 'Contract already partially verified on Sourcify (no further action needed)',
+                            isAlreadyVerified: true
+                        };
+                    }
+                }
+                let errorDetails = `HTTP ${response.status}: ${response.statusText}`;
+                if (responseText) {
+                    errorDetails += ` - ${responseText}`;
+                }
+                return {
+                    success: false,
+                    message: `Sourcify API request failed: ${errorDetails}`
+                };
+            }
+            const result = await response.json();
+            if (result.result && Array.isArray(result.result)) {
+                const perfectMatch = result.result.find((item) => item.status === 'perfect');
+                const partialMatch = result.result.find((item) => item.status === 'partial');
+                if (perfectMatch || partialMatch) {
+                    const matchType = perfectMatch ? 'perfect' : 'partial';
+                    return {
+                        success: true,
+                        message: `Contract verified successfully on Sourcify (${matchType} match)`
+                    };
+                }
+                return {
+                    success: false,
+                    message: 'Sourcify verification failed - no perfect or partial match found'
+                };
+            }
+            else if (result.status) {
+                if (result.status === 'perfect' || result.status === 'partial') {
+                    return {
+                        success: true,
+                        message: `Contract verified successfully on Sourcify (status: ${result.status})`
+                    };
+                }
+                else if (result.status === 'error') {
+                    return {
+                        success: false,
+                        message: result.message || 'Sourcify verification failed with unknown error'
+                    };
+                }
+                else {
+                    return {
+                        success: false,
+                        message: `Sourcify verification failed with status: ${result.status}`
+                    };
+                }
+            }
+            else {
+                return {
+                    success: false,
+                    message: `Sourcify verification failed - unexpected response format: ${JSON.stringify(result)}`
+                };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Sourcify verification failed: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    async createVerificationData(contract, buildInfo) {
+        const sourceFiles = [];
+        for (const [sourcePath, sourceInfo] of Object.entries(buildInfo.input.sources)) {
+            if (sourceInfo.content) {
+                sourceFiles.push([sourcePath, sourceInfo.content]);
+            }
+        }
+        let metadata = null;
+        try {
+            const sources = Array.from(contract._sources);
+            const artifactPath = sources.find((source) => source.includes('/artifacts/') && source.endsWith('.json') && !source.includes('/build-info/'));
+            if (artifactPath) {
+                const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+                const artifactContent = await fs.readFile(artifactPath, 'utf-8');
+                const artifact = JSON.parse(artifactContent);
+                if (artifact.rawMetadata) {
+                    metadata = JSON.parse(artifact.rawMetadata);
+                }
+                else if (artifact.metadata) {
+                    metadata = artifact.metadata;
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`Failed to load artifact metadata: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!metadata && buildInfo.output?.contracts?.[contract.sourceName]?.[contract.contractName]?.metadata) {
+            const metadataField = buildInfo.output.contracts[contract.sourceName][contract.contractName].metadata;
+            metadata = typeof metadataField === 'string' ? JSON.parse(metadataField) : metadataField;
+        }
+        if (!metadata) {
+            metadata = {
+                compiler: {
+                    version: buildInfo.solcLongVersion || buildInfo.solcVersion
+                },
+                language: buildInfo.input.language,
+                output: {
+                    abi: buildInfo.output?.contracts?.[contract.sourceName]?.[contract.contractName]?.abi || [],
+                    devdoc: { kind: 'dev', methods: {}, version: 1 },
+                    userdoc: { kind: 'user', methods: {}, version: 1 }
+                },
+                settings: buildInfo.input.settings,
+                sources: buildInfo.input.sources,
+                version: 1
+            };
+        }
+        if (!metadata?.settings?.compilationTarget) {
+            console.warn('Warning: Metadata missing compilation target');
+        }
+        return { metadata, sourceFiles };
+    }
+}
+exports.SourcifyVerificationPlatform = SourcifyVerificationPlatform;
+//# sourceMappingURL=sourcify.js.map

package/dist/lib/verification/sourcify.js.map

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

package/eslint.config.js

@@ -0,0 +1,48 @@
+const typescriptEslint = require('@typescript-eslint/eslint-plugin')
+const tsParser = require('@typescript-eslint/parser')
+
+module.exports = [
+  {
+    files: ['src/**/*.ts'],
+    languageOptions: {
+      parser: tsParser,
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+    },
+    plugins: {
+      '@typescript-eslint': typescriptEslint,
+    },
+    rules: {
+      // Base ESLint rules
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'semi': ['error', 'never'],
+      
+      // Unused variables and imports detection
+      'no-unused-vars': 'off', // Turn off base rule in favor of TypeScript version
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          vars: 'all',
+          args: 'after-used',
+          ignoreRestSiblings: true,
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+          destructuredArrayIgnorePattern: '^_'
+        }
+      ],
+      
+      // Additional import/export rules for unused detection
+      '@typescript-eslint/no-unused-expressions': 'warn',
+      
+      // TypeScript ESLint rules
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-var-requires': 'off',
+    },
+  },
+  {
+    ignores: ['dist/', 'node_modules/'],
+  },
+] 

package/examples/jobs/guards-v1.yaml

@@ -0,0 +1,17 @@
+name: "guards-v1"
+version: "1"
+description: "Deploy both prod and dev guards for Sequence v1"
+depends_on: ["sequence-v1"]
+
+actions:
+  - name: "guard-v1-prod"
+    template: "sequence-factory-v1"
+    arguments:
+      salt: "0xc99c1ab359199e4dcbd4603e9b2956d5681241ceb286359cf6a647ca56e6e128"
+      implementation: "{{sequence-v1.main-module.address}}"
+
+  - name: "guard-v1-dev"
+    template: "sequence-factory-v1"
+    arguments:
+      salt: "6af209e2a5cca04bfdb4839aba939f715b1840930508af89e7692b21ddecd9b6"
+      implementation: "{{sequence-v1.main-module.address}}"

package/examples/jobs/sequence-seq-0001-patch.yaml

@@ -0,0 +1,59 @@
+name: "sequence-v1-seq-0001-patch"
+version: "0001"
+description: "Sequence v1/v2 patch (SEQ-0001) for addressing guard signer takeover"
+depends_on: ["sequence-v1", "guards-v1"]
+
+actions:
+  - name: "main-module-upgradeable-duo-v1"
+    template: "sequence-universal-deployer-2"
+    arguments:
+      salt: "0"
+      creationCode: "{{creationCode(f5b239d7b2e88a5adae55dea68f83bad)}}"
+
+  - name: "main-module-upgradeable-duo-v2"
+    template: "sequence-universal-deployer-2"
+    arguments:
+      salt: "0"
+      creationCode: "{{creationCode(10326ce5047a2d596161984f678926c8)}}"
+
+  # Ommited as sending the transaction deploys the migrator contracts
+  # - name: "migrator-v1"
+  #   template: "sequence-universal-deployer-2"
+  #   arguments:
+  #     salt: "0"
+  #     creationCode:
+  #       type: "constructor-encode"
+  #       arguments:
+  #         - "{{221a4273dd7bb761ca6f3275c28e1d35}}"
+  #         - "0x596aF90CecdBF9A768886E771178fd5561dD27Ab"
+  #         - "0x5ca5d4cb6696df530c26b130a8fd86276a111f6696b3a8f2e76ff5edf94a2d84"
+  #         - "0xc99c1ab359199e4dcbd4603e9b2956d5681241ceb286359cf6a647ca56e6e128"
+
+  # - name: "migrator-v2"
+  #   template: "sequence-universal-deployer-2"
+  #   arguments:
+  #     salt: "0"
+  #     creationCode:
+  #       type: "constructor-encode"
+  #       arguments:
+  #         - "{{7abcec3e347c6024794220b96a854a4e}}"
+  #         - "0x761f5e29944D79d76656323F106CF2efBF5F09e9"
+  #         - "0xacb659ac7f85fbbce197005235ced2d040c7b02942a9dfae647582393d5a4e83"
+  #         - "0x6e2f52838722eda7d569b52db277d0d87d36991a6aa9b9657ef9d8f09b0c33f4"
+
+  - name: "patch-guard-v1-prod"
+    template: "send-transaction"
+    skip_condition:
+      - type: "basic-arithmetic"
+        arguments:
+          operation: "eq"
+          values:
+            - type: "call"
+              arguments:
+                signature: "readNonce(uint256)"
+                values:
+                  - "100"
+            - "1"
+    arguments:
+      to: "{{guards-v1.guard-v1-prod.address}}"
+      data: "{{patches/seq-0001/guard-v1-prod}}"

package/examples/jobs/sequence-v1.yaml

@@ -0,0 +1,59 @@
+
+name: "sequence-v1"
+version: "1.0.0"
+description: "The Sequence v1 contracts"
+
+actions:
+  - name: "factory"
+    template: "sequence-universal-deployer-2"
+    arguments:
+      creationCode: "{{Contract(sequence/v1/factory).creationCode}}"
+      salt: "0"
+
+  - name: "main-module"
+    template: "sequence-universal-deployer-2"
+    depends_on: ["factory"]
+    arguments:
+      salt: "0"
+      creationCode:
+        type: "constructor-encode"
+        arguments:
+          creationCode: "{{Contract(sequence/v1/main-module).creationCode}}"
+          types: ["address"]
+          values: ["{{factory.address}}"]
+
+  - name: "main-module-upgradeable"
+    template: "sequence-universal-deployer-2"
+    arguments:
+      salt: "0"
+      creationCode: "{{Contract(sequence/v1/main-module-upgradeable).creationCode}}"
+
+  - name: "guest-module"
+    template: "sequence-universal-deployer-2"
+    arguments:
+      salt: "0"
+      creationCode: "{{Contract(sequence/v1/guest-module).creationCode}}"
+
+  - name: "sequence-utils"
+    template: "sequence-universal-deployer-2"
+    depends_on: ["factory", "main-module"]
+    arguments:
+      salt: "0"
+      creationCode:
+        type: "constructor-encode"
+        arguments:
+          creationCode: "{{Contract(sequence/v1/sequence-utils).creationCode}}"
+          types: ["address", "address"]
+          values: ["{{factory.address}}", "{{main-module.address}}"]
+
+  - name: "require-fresh-signer-lib"
+    template: "sequence-universal-deployer-2"
+    depends_on: ["sequence-utils"]
+    arguments:
+      salt: "0"
+      creationCode:
+        type: "constructor-encode"
+        arguments:
+          creationCode: "{{Contract(sequence/v1/require-fresh-signer-lib).creationCode}}"
+          types: ["address"]
+          values: ["{{sequence-utils.address}}"]

package/examples/templates/sequence-factory-v1.yaml

@@ -0,0 +1,56 @@
+name: "sequence-factory-v1"
+
+arguments:
+  implementation:
+    type: "address"
+  salt:
+    type: "bytes32"
+
+returns:
+  address:
+    type: "address"
+
+setup:
+  - type: "job-completed"
+    arguments:
+      job: "sequence-v1"
+
+actions:
+  - type: "send-transaction"
+    arguments:
+      to: "{{sequence-v1.factory.address}}"
+      data:
+        type: "abi-encode"
+        arguments:
+          signature: "deploy(address,address)"
+          values:
+            - "{{implementation}}"
+            - "{{salt}}"
+
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "{{sequence-v1.factory.address}}"
+          salt: "{{salt}}"
+          initCode:
+            type: "constructor-encode"
+            arguments:
+              creationCode: "0x603a600e3d39601a805130553df3363d3d373d3d3d363d30545af43d82803e903d91601857fd5bf3"
+              types: ["address"]
+              values: ["{{implementation}}"]
+
+outputs:
+  address:
+    type: "compute-create2"
+    arguments:
+      deployerAddress: "{{sequence-v1.factory.address}}"
+      salt: "{{salt}}"
+      initCode:
+        type: "constructor-encode"
+        arguments:
+          creationCode: "0x603a600e3d39601a805130553df3363d3d373d3d3d363d30545af43d82803e903d91601857fd5bf3"
+          types: ["address"]
+          values: ["{{implementation}}"]

package/jest.config.js

@@ -0,0 +1,25 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  testMatch: [
+    '**/__tests__/**/*.ts',
+    '**/?(*.)+(spec|test).ts'
+  ],
+  transform: {
+    '^.+\\.ts$': 'ts-jest',
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts'
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: [
+    'text',
+    'lcov',
+    'html'
+  ],
+  // Increase timeout for blockchain tests
+  testTimeout: 30000
+}; 

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@0xsequence/catapult",
+  "version": "1.1.0",
+  "description": "Ethereum contract deployment CLI tool",
+  "main": "dist/index.js",
+  "bin": {
+    "catapult": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && cp -r src/lib/std dist/lib/",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "start:dev": "npm run build && npm run start",
+    "watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepare": "npm run build",
+    "test": "jest --runInBand --detectOpenHandles",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix"
+  },
+  "keywords": [
+    "ethereum",
+    "deployment",
+    "cli",
+    "smart-contracts",
+    "blockchain",
+    "typescript"
+  ],
+  "author": "Sequence (Agusx1211)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xsequence/catapult.git"
+  },
+  "bugs": {
+    "url": "https://github.com/0xsequence/catapult/issues"
+  },
+  "homepage": "https://github.com/0xsequence/catapult#readme",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.2",
+    "@types/jest": "^29.5.14",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "chai": "^5.2.1",
+    "eslint": "^9.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.0",
+    "ethers": "^6.15.0",
+    "solc": "^0.8.30",
+    "ox": "^0.8.5",
+    "yaml": "^2.8.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,17 @@
+import { Command } from 'commander'
+import { makeRunCommand, makeDryRunCommand, makeListCommand, makeUtilsCommand } from './commands'
+import { makeEtherscanCommand } from './commands/etherscan'
+
+export function setupCommands(program: Command): void {
+  // Make run the default command when no subcommand is provided
+  program.addCommand(makeRunCommand(), {
+    isDefault: true,
+    hidden: false // Keep it visible in help
+  })
+  
+  // Add other commands as subcommands
+  program.addCommand(makeDryRunCommand())
+  program.addCommand(makeListCommand())
+  program.addCommand(makeUtilsCommand())
+  program.addCommand(makeEtherscanCommand())
+}

package/src/commands/common.ts

@@ -0,0 +1,61 @@
+import { Command } from 'commander'
+import * as dotenv from 'dotenv'
+import * as path from 'path'
+import { ProjectLoader, ProjectLoaderOptions } from '../lib/core/loader'
+import { deploymentEvents } from '../lib/events'
+
+/**
+ * Adds the --project option to a command.
+ */
+export const projectOption = (cmd: Command): Command =>
+  cmd.option('-p, --project <path>', 'Project root directory', process.cwd())
+
+/**
+ * Adds the --dotenv option to a command.
+ */
+export const dotenvOption = (cmd: Command): Command =>
+  cmd.option('--dotenv <path>', 'Path to a custom .env file')
+
+/**
+ * Adds the --no-std option to a command.
+ */
+export const noStdOption = (cmd: Command): Command =>
+  cmd.option('--no-std', 'Disable loading built-in standard templates')
+
+/**
+ * Adds verbosity options to a command.
+ */
+export const verbosityOption = (cmd: Command): Command =>
+  cmd.option('-v, --verbose', 'Enable verbose logging (use -vv or -vvv for more detail)', (_, previous) => (previous || 0) + 1, 0)
+
+/**
+ * Loads the project using the ProjectLoader and emits corresponding events.
+ */
+export async function loadProject(projectRoot: string, options?: ProjectLoaderOptions): Promise<ProjectLoader> {
+  deploymentEvents.emitEvent({
+    type: 'project_loading_started',
+    level: 'info',
+    data: { projectRoot }
+  })
+  
+  const loader = new ProjectLoader(projectRoot, options)
+  await loader.load()
+  
+  deploymentEvents.emitEvent({
+    type: 'project_loaded',
+    level: 'info',
+    data: {
+      jobCount: loader.jobs.size,
+      templateCount: loader.templates.size
+    }
+  })
+  return loader
+}
+
+/**
+ * Loads environment variables from the specified .env file path.
+ */
+export function loadDotenv(options: { dotenv?: string }): void {
+  const dotenvPath = options.dotenv ? path.resolve(options.dotenv) : path.resolve(process.cwd(), '.env')
+  dotenv.config({ path: dotenvPath })
+}