@0xsequence/catapult 1.3.9 → 1.3.11

package/dist/lib/utils/create4.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeCreate4Plan = computeCreate4Plan;
+const ethers_1 = require("ethers");
+const create4_1 = require("@0xsequence/create4");
+function computeCreate4Plan(args) {
+    const factoryAddress = normalizeAddress(args.deployerAddress);
+    const targetChainId = normalizeChainIdInput(args.chainId, 'chain id');
+    const planSalt = normalizePlanSalt(args.salt);
+    const planSpec = buildPlanSpec(args.bytecodes, planSalt);
+    const plan = (0, create4_1.buildPlanFromSpec)(planSpec);
+    const deploymentSalt = (0, create4_1.deriveDeploymentSalt)(plan.root, planSalt);
+    const address = (0, create4_1.computeCreate3Address)(factoryAddress, deploymentSalt);
+    const targetLeaf = plan.leaves.find(leaf => BigInt(leaf.chainId) === targetChainId);
+    const target = targetLeaf
+        ? buildChainTarget(targetLeaf)
+        : buildFallbackTarget(plan.leaves, plan.fallback, targetChainId);
+    return {
+        factoryAddress,
+        chainId: targetChainId.toString(),
+        planRoot: plan.root,
+        salt: plan.salt,
+        deploymentSalt,
+        address,
+        target,
+        plan: {
+            root: plan.root,
+            leaves: plan.leaves,
+            fallback: plan.fallback,
+        },
+    };
+}
+function buildPlanSpec(bytecodes, salt) {
+    if (!bytecodes || typeof bytecodes !== 'object') {
+        throw new Error('create4-plan: bytecodes must be an object with chain entries and a fallback');
+    }
+    const sharedConstructor = normalizeConstructor(bytecodes.sharedConstructor, 'bytecodes.sharedConstructor');
+    const fallbackEntry = bytecodes.fallback ?? bytecodes['fallbackInitCode'];
+    if (!fallbackEntry) {
+        throw new Error('create4-plan: bytecodes.fallback is required');
+    }
+    const chains = [];
+    const chainSource = (bytecodes.chains && typeof bytecodes.chains === 'object') ? bytecodes.chains : bytecodes;
+    for (const [key, value] of Object.entries(chainSource)) {
+        if (key === 'fallback' || key === 'fallbackInitCode' || key === 'sharedConstructor' || key === 'chains') {
+            continue;
+        }
+        if (value === undefined || value === null) {
+            throw new Error(`create4-plan: bytecodes entry "${key}" is missing a value`);
+        }
+        chains.push(normalizeChainEntry(key, value, sharedConstructor));
+    }
+    if (chains.length === 0) {
+        throw new Error('create4-plan: at least one chain entry is required');
+    }
+    return {
+        salt,
+        fallbackInitCode: normalizeBytecodeEntry(fallbackEntry, undefined, 'bytecodes.fallback'),
+        chains: chains.map(entry => ({
+            chainId: entry.chainId.toString(),
+            initCode: entry.initCode,
+            label: entry.label,
+        })),
+    };
+}
+function buildChainTarget(leaf) {
+    return {
+        mode: 'chain',
+        modeFlag: '1',
+        chainId: leaf.chainId,
+        nextChainId: leaf.nextChainId,
+        initCode: leaf.initCode,
+        initCodeHash: leaf.initCodeHash,
+        proof: leaf.proof,
+    };
+}
+function buildFallbackTarget(leaves, fallback, targetChainId) {
+    const gapLeaf = findGapLeaf(leaves, targetChainId);
+    return {
+        mode: 'fallback',
+        modeFlag: '0',
+        gapChainId: gapLeaf.chainId,
+        gapNextChainId: gapLeaf.nextChainId,
+        gapLeafPrefix: gapLeaf.prefix,
+        gapLeafHash: gapLeaf.initCodeHash,
+        gapProof: gapLeaf.proof,
+        initCode: fallback.initCode,
+        initCodeHash: fallback.initCodeHash,
+        proof: fallback.proof,
+    };
+}
+function findGapLeaf(leaves, targetChainId) {
+    for (const leaf of leaves) {
+        if ((0, create4_1.isChainIdInGap)(leaf.chainId, leaf.nextChainId, targetChainId)) {
+            return leaf;
+        }
+    }
+    throw new Error(`create4-plan: no fallback gap covers chain id ${targetChainId.toString()}`);
+}
+function normalizePlanSalt(value) {
+    if (value === undefined || value === null || value === '') {
+        return create4_1.ZERO_SALT;
+    }
+    return (0, create4_1.normalizeSaltHex)(value);
+}
+function normalizeChainEntry(key, entry, sharedConstructor) {
+    const trimmedKey = key.trim();
+    if (!trimmedKey) {
+        throw new Error('create4-plan: chain entry keys cannot be empty');
+    }
+    let entryObj;
+    if (typeof entry === 'string') {
+        entryObj = { initCode: entry };
+    }
+    else if (entry && typeof entry === 'object') {
+        entryObj = entry;
+    }
+    else {
+        throw new Error(`create4-plan: chain entry "${key}" must be a hex string or an object`);
+    }
+    const keyChainId = normalizeChainIdInput(trimmedKey, `chain id key "${key}"`);
+    if (entryObj.chainId !== undefined) {
+        const providedChainId = normalizeChainIdInput(entryObj.chainId, `chain id for "${key}"`);
+        if (providedChainId !== keyChainId) {
+            throw new Error(`create4-plan: chain id mismatch for entry "${key}"`);
+        }
+    }
+    return {
+        key,
+        chainId: keyChainId,
+        label: typeof entryObj.label === 'string' ? entryObj.label : undefined,
+        initCode: normalizeBytecodeEntry(entryObj, sharedConstructor, `bytecodes[${key}]`),
+    };
+}
+function normalizeBytecodeEntry(entry, sharedConstructor, context) {
+    if (typeof entry === 'string') {
+        return normalizeHex(entry, `${context}.initCode`);
+    }
+    if (!entry || typeof entry !== 'object') {
+        throw new Error(`create4-plan: ${context} must be a hex string or an object`);
+    }
+    if (entry.initCode !== undefined) {
+        return normalizeHex(entry.initCode, `${context}.initCode`);
+    }
+    if (!entry.creationCode) {
+        throw new Error(`create4-plan: ${context} must include initCode or creationCode`);
+    }
+    const creationCode = normalizeHex(entry.creationCode, `${context}.creationCode`);
+    const hasOwnConstructor = Object.prototype.hasOwnProperty.call(entry, 'constructor');
+    const constructorOverride = hasOwnConstructor ? entry.constructor : undefined;
+    const constructorSpec = normalizeConstructor(constructorOverride ?? sharedConstructor, `${context}.constructor`);
+    if (!constructorSpec) {
+        return creationCode;
+    }
+    const encodedArgs = encodeConstructorArgs(constructorSpec, context);
+    return ethers_1.ethers.hexlify(ethers_1.ethers.concat([ethers_1.ethers.getBytes(creationCode), ethers_1.ethers.getBytes(encodedArgs)]));
+}
+function normalizeConstructor(value, context) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== 'object') {
+        throw new Error(`create4-plan: ${context} must be an object with types and values arrays`);
+    }
+    const types = Array.isArray(value.types) ? value.types.map(t => String(t)) : undefined;
+    const values = Array.isArray(value.values) ? [...value.values] : undefined;
+    if (!types || !values) {
+        throw new Error(`create4-plan: ${context} must include types[] and values[]`);
+    }
+    if (types.length !== values.length) {
+        throw new Error(`create4-plan: ${context} types length (${types.length}) must match values length (${values.length})`);
+    }
+    return { types, values };
+}
+function encodeConstructorArgs(constructorSpec, context) {
+    try {
+        return ethers_1.ethers.AbiCoder.defaultAbiCoder().encode(constructorSpec.types, constructorSpec.values);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`create4-plan: failed to encode constructor for ${context}: ${reason}`);
+    }
+}
+function normalizeHex(value, label) {
+    if (typeof value !== 'string') {
+        throw new Error(`create4-plan: ${label} must be provided as a hex string`);
+    }
+    let hex = value.trim();
+    if (!hex.startsWith('0x')) {
+        hex = '0x' + hex;
+    }
+    try {
+        return ethers_1.ethers.hexlify(ethers_1.ethers.getBytes(hex));
+    }
+    catch {
+        throw new Error(`create4-plan: ${label} must be a valid hex string`);
+    }
+}
+function normalizeChainIdInput(value, label) {
+    if (typeof value === 'bigint') {
+        return assertChainIdRange(value, label);
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || !Number.isInteger(value)) {
+            throw new Error(`create4-plan: ${label} must be a finite integer`);
+        }
+        return assertChainIdRange(BigInt(value), label);
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed) {
+            throw new Error(`create4-plan: ${label} cannot be empty`);
+        }
+        try {
+            return assertChainIdRange(BigInt(trimmed), label);
+        }
+        catch {
+            throw new Error(`create4-plan: invalid ${label}: ${value}`);
+        }
+    }
+    throw new Error(`create4-plan: ${label} must be a string, number, or bigint`);
+}
+function assertChainIdRange(value, label) {
+    if (value < 0n || value > ((1n << 64n) - 1n)) {
+        throw new Error(`create4-plan: ${label} must fit within uint64 range`);
+    }
+    return value;
+}
+function normalizeAddress(value) {
+    try {
+        return ethers_1.ethers.getAddress(value);
+    }
+    catch {
+        throw new Error(`create4-plan: invalid deployer address: ${value}`);
+    }
+}
+//# sourceMappingURL=create4.js.map

package/dist/lib/utils/create4.js.map

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

package/package.json

@@ -1,11 +1,23 @@
 {
   "name": "@0xsequence/catapult",
-  "version": "1.3.9",
+  "version": "1.3.11",
   "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",
@@ -52,16 +64,5 @@
   },
   "engines": {
     "node": ">=16.0.0"
-  },
-  "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",
-    "test": "jest --runInBand --detectOpenHandles",
-    "lint": "eslint src/**/*.ts",
-    "lint:fix": "eslint src/**/*.ts --fix"
   }
 }

package/src/lib/core/__tests__/json-integration.spec.ts

@@ -2,7 +2,7 @@ import { ExecutionEngine } from '../engine'
 import { ExecutionContext } from '../context'
 import { ValueResolver } from '../resolver'
 import { ContractRepository } from '../../contracts/repository'
-import { Action, Network, ReadJsonValue } from '../../types'
+import { Action, Network, ReadJsonValue, SliceBytesValue } from '../../types'
 import { VerificationPlatformRegistry } from '../../verification/etherscan'
 
 describe('JSON Integration Tests', () => {
@@ -292,6 +292,31 @@ describe('JSON Integration Tests', () => {
       expect(extractedTo).toBe('0x596aF90CecdBF9A768886E771178fd5561dD27Ab')
     })
 
+    it('should allow piping read-json output into slice-bytes', async () => {
+      const response = {
+        txs: {
+          data: '0xaabbccddff'
+        }
+      }
+
+      const value: SliceBytesValue = {
+        type: 'slice-bytes',
+        arguments: {
+          value: {
+            type: 'read-json',
+            arguments: {
+              json: response,
+              path: 'txs.data'
+            }
+          },
+          range: ':-1'
+        }
+      }
+
+      const trimmed = await resolver.resolve(value, context)
+      expect(trimmed).toBe('0xaabbccdd')
+    })
+
     it('should handle complex nested API responses', async () => {
       const complexApiResponse = {
         status: 'success',
@@ -357,4 +382,4 @@ describe('JSON Integration Tests', () => {
       expect(await resolver.resolve(timestamp, context)).toBe(1234567890)
     })
   })
-})
+})

package/src/lib/core/__tests__/resolver.spec.ts

@@ -1,7 +1,7 @@
 import { ethers } from 'ethers'
 import { ValueResolver } from '../resolver'
 import { ExecutionContext } from '../context'
-import { BasicArithmeticValue, Network, ReadBalanceValue, ComputeCreate2Value, ConstructorEncodeValue, AbiEncodeValue, AbiPackValue, CallValue, ContractExistsValue, ComputeCreateValue } from '../../types'
+import { BasicArithmeticValue, Network, ReadBalanceValue, ComputeCreate2Value, ConstructorEncodeValue, AbiEncodeValue, AbiPackValue, CallValue, ContractExistsValue, ComputeCreateValue, SliceBytesValue } from '../../types'
 import { ContractRepository } from '../../contracts/repository'
 
 describe('ValueResolver', () => {
@@ -1918,4 +1918,72 @@ describe('ValueResolver', () => {
       await expect(resolver.resolve(value, context)).rejects.toThrow('contract-exists: invalid address: invalid-address')
     })
   })
-})
+
+  describe('slice-bytes', () => {
+    it('should slice bytes with explicit start and end positions', async () => {
+      const value: SliceBytesValue = {
+        type: 'slice-bytes',
+        arguments: {
+          value: '0x112233445566',
+          start: 1,
+          end: 4,
+        },
+      }
+
+      const result = await resolver.resolve(value, context)
+      expect(result).toBe('0x223344')
+    })
+
+    it('should support negative indexes to drop trailing bytes', async () => {
+      const value: SliceBytesValue = {
+        type: 'slice-bytes',
+        arguments: {
+          value: '0xdeadbeefcafebabe',
+          end: -1,
+        },
+      }
+
+      const result = await resolver.resolve(value, context)
+      expect(result).toBe('0xdeadbeefcafeba')
+    })
+
+    it('should accept range syntax', async () => {
+      const value: SliceBytesValue = {
+        type: 'slice-bytes',
+        arguments: {
+          value: '0xaabbccddeeff',
+          range: '0:2',
+        },
+      }
+
+      const result = await resolver.resolve(value, context)
+      expect(result).toBe('0xaabb')
+    })
+
+    it('should handle open range syntax with missing start', async () => {
+      const value: SliceBytesValue = {
+        type: 'slice-bytes',
+        arguments: {
+          value: '0xaabbccddeeff',
+          range: ':-1',
+        },
+      }
+
+      const result = await resolver.resolve(value, context)
+      expect(result).toBe('0xaabbccddee')
+    })
+
+    it('should accept bracketed range syntax', async () => {
+      const value: SliceBytesValue = {
+        type: 'slice-bytes',
+        arguments: {
+          value: '0x0102030405',
+          range: '[:3]',
+        },
+      }
+
+      const result = await resolver.resolve(value, context)
+      expect(result).toBe('0x010203')
+    })
+  })
+})

package/src/lib/core/loader.ts

@@ -121,22 +121,6 @@ export class ProjectLoader {
         }
 
         const job = parseJob(content)
-        // Capture optional job-level constants by peeking the raw YAML for "constants"
-        try {
-          const raw = JSON.parse(JSON.stringify(require('yaml').parse(content)))
-          if (raw && typeof raw === 'object' && raw.constants !== undefined) {
-            if (typeof raw.constants !== 'object' || Array.isArray(raw.constants)) {
-              throw new Error(`Invalid job "${job.name}": "constants" field must be an object if provided.`)
-            }
-            (job as any).constants = raw.constants
-          }
-        } catch (peekErr) {
-          // parseJob already validated YAML; if this peek fails due to YAML parsing, surface it
-          if (peekErr instanceof Error && peekErr.message.includes('Failed to parse')) {
-            throw new Error(`Job constants peek failed for ${filePath}: ${peekErr.message}`)
-          }
-          // Otherwise ignore non-YAML related errors here
-        }
         job._path = filePath
         this.jobs.set(job.name, job)
       } catch (error) {

package/src/lib/core/resolver.ts

@@ -13,6 +13,7 @@ import {
   ContractExistsValue,
   JobCompletedValue,
   ReadJsonValue,
+  SliceBytesValue,
 } from '../types'
 import { ExecutionContext } from './context'
 import { isAddress, isBigNumberish, isBytesLike } from '../utils/assertion'
@@ -189,6 +190,8 @@ export class ValueResolver {
         return this.resolveReadJson(resolvedArgs as ReadJsonValue['arguments'])
       case 'resolve-json':
         return this.resolveJsonValue(resolvedArgs, context)
+      case 'slice-bytes':
+        return this.resolveSliceBytes(resolvedArgs as SliceBytesValue['arguments'])
       default:
         throw new Error(`Unknown value resolver type: ${(obj as any).type}`)
     }
@@ -530,6 +533,116 @@ export class ValueResolver {
     }
   }
 
+  private resolveSliceBytes(args: SliceBytesValue['arguments']): string {
+    const { value, start, end, range } = args
+
+    if (!isBytesLike(value)) {
+      throw new Error('slice-bytes: value must be bytes-like (hex string, Uint8Array, etc.)')
+    }
+
+    if (range !== undefined && (start !== undefined || end !== undefined)) {
+      throw new Error('slice-bytes: provide either range or start/end, not both')
+    }
+
+    if (range !== undefined && typeof range !== 'string') {
+      throw new Error('slice-bytes: range must be a string in "start:end" format')
+    }
+
+    const normalizedHex = ethers.hexlify(value as ethers.BytesLike)
+    const hexBody = normalizedHex.slice(2)
+
+    if (hexBody.length % 2 !== 0) {
+      throw new Error('slice-bytes: value must have an even-length hex string')
+    }
+
+    const totalBytes = hexBody.length / 2
+    const { startIndex, endIndex } = this.computeSliceBounds(totalBytes, { start, end, range })
+
+    if (startIndex >= endIndex) {
+      return '0x'
+    }
+
+    const sliced = hexBody.slice(startIndex * 2, endIndex * 2)
+    return sliced.length === 0 ? '0x' : `0x${sliced}`
+  }
+
+  private computeSliceBounds(
+    totalBytes: number,
+    params: { start?: any; end?: any; range?: any },
+  ): { startIndex: number; endIndex: number } {
+    let startValue: number | undefined
+    let endValue: number | undefined
+
+    if (params.range !== undefined) {
+      const trimmedRange = (params.range as string).trim()
+      const rangeMatch = trimmedRange.match(/^\[?\s*(-?\d+)?\s*:\s*(-?\d+)?\s*\]?$/)
+
+      if (!rangeMatch) {
+        throw new Error('slice-bytes: range must follow the "start:end" format (e.g., "0:4" or ":-1")')
+      }
+
+      const [, rawStart, rawEnd] = rangeMatch
+      if (rawStart !== undefined) {
+        startValue = this.parseSliceIndex(rawStart, 'range start')
+      }
+      if (rawEnd !== undefined) {
+        endValue = this.parseSliceIndex(rawEnd, 'range end')
+      }
+    } else {
+      if (params.start !== undefined) {
+        startValue = this.parseSliceIndex(params.start, 'start')
+      }
+      if (params.end !== undefined) {
+        endValue = this.parseSliceIndex(params.end, 'end')
+      }
+    }
+
+    const startIndex = this.normalizeSliceIndex(startValue ?? 0, totalBytes)
+    const endIndex = this.normalizeSliceIndex(endValue ?? totalBytes, totalBytes)
+
+    return { startIndex, endIndex }
+  }
+
+  private parseSliceIndex(value: any, label: string): number {
+    if (value === undefined || value === null) {
+      throw new Error(`slice-bytes: ${label} cannot be null or undefined`)
+    }
+
+    const normalizedValue = typeof value === 'string' ? value.trim() : value
+
+    try {
+      const bigIntValue = ethers.toBigInt(normalizedValue)
+      const maxSafe = BigInt(Number.MAX_SAFE_INTEGER)
+      if (bigIntValue > maxSafe || bigIntValue < -maxSafe) {
+        throw new Error(`${label} is outside the supported numeric range`)
+      }
+      return Number(bigIntValue)
+    } catch (_error) {
+      throw new Error(`slice-bytes: ${label} must be an integer or integer-like string`)
+    }
+  }
+
+  private normalizeSliceIndex(index: number, totalBytes: number): number {
+    if (!Number.isFinite(index) || !Number.isInteger(index)) {
+      throw new Error('slice-bytes: slice positions must be finite integers')
+    }
+
+    let normalized = index
+    if (normalized < 0) {
+      normalized = totalBytes + normalized
+    }
+
+    if (normalized < 0) {
+      normalized = 0
+    }
+
+    if (normalized > totalBytes) {
+      normalized = totalBytes
+    }
+
+    return normalized
+  }
+
   /**
    * Helper to recursively resolve the `arguments` field of any `ValueResolver` object.
    * @private
@@ -549,4 +662,4 @@ export class ValueResolver {
     }
     return this.resolve(args, context, scope)
   }
-}
+}

package/src/lib/parsers/__tests__/job.spec.ts

@@ -315,7 +315,7 @@ actions:
 
   // --- New: Job-level constants field parsing ---
 
-  it('should allow an optional job-level constants block as an object', () => {
+  it('should attach an optional job-level constants block as an object', () => {
     const yamlContent = `
 name: "job-with-constants"
 version: "1"
@@ -328,8 +328,31 @@ actions:
     arguments:
       x: "{{FEE}}"
 `
-    const job = parseJob(yamlContent) as any
-    // parseJob doesn't attach constants; loader attaches it. This test ensures YAML is acceptable and does not throw.
-    expect(job.name).toBe('job-with-constants')
+    const job = parseJob(yamlContent)
+    expect(job.constants).toEqual({
+      FEE: '1000',
+      ADMIN: '0x0000000000000000000000000000000000000001'
+    })
+  })
+
+  it('should parse job-level skip conditions', () => {
+    const yamlContent = `
+name: "job-with-skip"
+version: "1"
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address: "0xabc"
+actions:
+  - name: "a1"
+    template: "t1"
+    arguments: {}
+`
+    const job = parseJob(yamlContent)
+    expect(job.skip_condition).toHaveLength(1)
+    expect(job.skip_condition?.[0]).toEqual({
+      type: 'contract-exists',
+      arguments: { address: '0xabc' }
+    })
   })
 })