@0xsequence/catapult 1.3.11 → 1.3.13

package/dist/lib/types/conditions.d.ts

@@ -1,4 +1,4 @@
-import { AddressValue, BooleanValue } from './values';
+import { AddressValue, BooleanValue, ValueEmptyValue } from './values';
 export interface ContractExistsCondition {
     type: 'contract-exists';
     arguments: {
@@ -13,5 +13,5 @@ export interface JobCompletedCondition {
     };
 }
 export declare function isJobCompletedCondition(obj: any): obj is JobCompletedCondition;
-export type Condition = BooleanValue | ContractExistsCondition | JobCompletedCondition;
+export type Condition = BooleanValue | ContractExistsCondition | JobCompletedCondition | ValueEmptyValue;
 //# sourceMappingURL=conditions.d.ts.map

package/dist/lib/types/conditions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/lib/types/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAKrD,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE;QACP,OAAO,EAAE,YAAY,CAAC;KACzB,CAAC;CACL;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,uBAAuB,CASlF;AAKD,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;KACf,CAAC;CACL;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,qBAAqB,CAS9E;AAOD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,uBAAuB,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/lib/types/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAKtE,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE;QACP,OAAO,EAAE,YAAY,CAAC;KACzB,CAAC;CACL;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,uBAAuB,CASlF;AAKD,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;KACf,CAAC;CACL;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,qBAAqB,CAS9E;AAOD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,uBAAuB,GAAG,qBAAqB,GAAG,eAAe,CAAC"}

package/dist/lib/types/values.d.ts

@@ -73,13 +73,19 @@ export interface ReadJsonValue {
     type: 'read-json';
     arguments: {
         json: Value<any>;
-        path: Value<string>;
+        path: Value<string | number>;
     };
 }
 export interface ResolveJsonValue {
     type: 'resolve-json';
     arguments: Value<any>;
 }
+export interface ValueEmptyValue {
+    type: 'value-empty';
+    arguments: {
+        value: Value<any>;
+    };
+}
 export interface SliceBytesValue {
     type: 'slice-bytes';
     arguments: {
@@ -89,7 +95,7 @@ export interface SliceBytesValue {
         range?: Value<string>;
     };
 }
-export type ValueResolver = AbiEncodeValue | AbiPackValue | ConstructorEncodeValue | ComputeCreateValue | ComputeCreate2Value | ReadBalanceValue | BasicArithmeticValue | CallValue | ContractExistsValue | JobCompletedValue | ReadJsonValue | ResolveJsonValue | SliceBytesValue;
+export type ValueResolver = AbiEncodeValue | AbiPackValue | ConstructorEncodeValue | ComputeCreateValue | ComputeCreate2Value | ReadBalanceValue | BasicArithmeticValue | CallValue | ContractExistsValue | JobCompletedValue | ReadJsonValue | ResolveJsonValue | ValueEmptyValue | SliceBytesValue;
 export type Value<T = string | number | boolean> = T | Reference | ValueResolver;
 export type BytesValue = Value<string>;
 export type AddressValue = Value<string>;

package/dist/lib/types/values.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xsequence/catapult",
-  "version": "1.3.11",
+  "version": "1.3.13",
   "description": "Ethereum contract deployment CLI tool",
   "main": "dist/index.js",
   "bin": {
@@ -65,4 +65,4 @@
   "engines": {
     "node": ">=16.0.0"
   }
-}
+}

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

@@ -1207,6 +1207,29 @@ describe('ExecutionEngine', () => {
       const result = await (engine as any).evaluateSkipConditions(conditions, context, new Map())
       expect(result).toBe(false)
     })
+
+    it('should return true when a value-empty condition resolves to true', async () => {
+      context.setOutput('payloadMap', { 10: '0xdeadbeef' })
+      const scope = new Map<string, any>([['missingChainId', 999]])
+
+      const conditions = [
+        {
+          type: 'value-empty',
+          arguments: {
+            value: {
+              type: 'read-json',
+              arguments: {
+                json: '{{payloadMap}}',
+                path: '{{missingChainId}}'
+              }
+            }
+          }
+        }
+      ]
+
+      const result = await (engine as any).evaluateSkipConditions(conditions, context, scope)
+      expect(result).toBe(true)
+    })
   })
 
   describe('topologicalSortActions', () => {
@@ -1863,4 +1886,4 @@ describe('ExecutionEngine', () => {
       )
     })
   })
-}) 
+}) 

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

@@ -211,6 +211,46 @@ describe('JSON Integration Tests', () => {
       const result = await resolver.resolve(value, context)
       expect(result).toBe('0xabcdef')
     })
+
+    it('should allow numeric network chain IDs to index top-level maps', async () => {
+      const value: ReadJsonValue = {
+        type: 'read-json',
+        arguments: {
+          json: {
+            999: {
+              executeCalldata: '0xfeedface'
+            }
+          },
+          path: '{{Network().chainId}}'
+        }
+      }
+
+      const result = await resolver.resolve(value, context)
+      expect(result).toEqual({ executeCalldata: '0xfeedface' })
+    })
+
+    it('should let value-empty detect missing top-level map entries', async () => {
+      const value = {
+        type: 'value-empty',
+        arguments: {
+          value: {
+            type: 'read-json',
+            arguments: {
+              json: {
+                999: {
+                  executeCalldata: '0xfeedface'
+                }
+              },
+              path: '{{missingChainId}}'
+            }
+          }
+        }
+      } as const
+
+      const scope = new Map<string, any>([['missingChainId', 10]])
+      const result = await resolver.resolve(value, context, scope)
+      expect(result).toBe(true)
+    })
   })
 
   describe('JsonRequestAction integration', () => {

package/src/lib/core/resolver.ts

@@ -13,6 +13,7 @@ import {
   ContractExistsValue,
   JobCompletedValue,
   ReadJsonValue,
+  ValueEmptyValue,
   SliceBytesValue,
 } from '../types'
 import { ExecutionContext } from './context'
@@ -190,6 +191,8 @@ export class ValueResolver {
         return this.resolveReadJson(resolvedArgs as ReadJsonValue['arguments'])
       case 'resolve-json':
         return this.resolveJsonValue(resolvedArgs, context)
+      case 'value-empty':
+        return this.resolveValueEmpty(resolvedArgs as ValueEmptyValue['arguments'])
       case 'slice-bytes':
         return this.resolveSliceBytes(resolvedArgs as SliceBytesValue['arguments'])
       default:
@@ -482,18 +485,20 @@ export class ValueResolver {
       throw new Error('read-json: json argument is required')
     }
     
-    if (typeof path !== 'string') {
-      throw new Error('read-json: path must be a string')
+    if (typeof path !== 'string' && typeof path !== 'number') {
+      throw new Error('read-json: path must be a string or number')
     }
+
+    const normalizedPath = String(path)
     
     // If path is empty, return the entire JSON object
-    if (path === '') {
+    if (normalizedPath === '') {
       return json
     }
     
     try {
       // Split the path by dots to handle nested access
-      const pathParts = path.split('.')
+      const pathParts = normalizedPath.split('.')
       let current = json
       
       for (const part of pathParts) {
@@ -514,7 +519,7 @@ export class ValueResolver {
       
       return current
     } catch (error) {
-      throw new Error(`read-json: Failed to access path "${path}": ${error instanceof Error ? error.message : String(error)}`)
+      throw new Error(`read-json: Failed to access path "${normalizedPath}": ${error instanceof Error ? error.message : String(error)}`)
     }
   }
 
@@ -533,6 +538,28 @@ export class ValueResolver {
     }
   }
 
+  private resolveValueEmpty(args: ValueEmptyValue['arguments']): boolean {
+    const { value } = args
+
+    if (value === undefined || value === null) {
+      return true
+    }
+
+    if (typeof value === 'string') {
+      return value === '' || value === '0x'
+    }
+
+    if (Array.isArray(value)) {
+      return value.length === 0
+    }
+
+    if (typeof value === 'object') {
+      return Object.keys(value).length === 0
+    }
+
+    return false
+  }
+
   private resolveSliceBytes(args: SliceBytesValue['arguments']): string {
     const { value, start, end, range } = args
 

package/src/lib/parsers/template.ts

@@ -18,6 +18,10 @@ function isCondition(item: any): item is Condition {
     return true
   }
 
+  if (item.type === 'value-empty') {
+    return !!(item.arguments && typeof item.arguments === 'object' && 'value' in item.arguments)
+  }
+
   // The 'basic-arithmetic' ValueResolver can also act as a Condition
   // if it performs a boolean comparison operation.
   if (item.type === 'basic-arithmetic') {
@@ -128,4 +132,4 @@ export function parseTemplate(yamlContent: string): Template {
   }
 
   return template
-}
+}

package/src/lib/types/__tests__/read-json-value.spec.ts

@@ -94,6 +94,20 @@ describe('ReadJsonValue', () => {
       expect(value.arguments.path).toBe('{{fieldPath}}')
     })
 
+    it('should support numeric keys in path', () => {
+      const value: ReadJsonValue = {
+        type: 'read-json',
+        arguments: {
+          json: {
+            137: { calldata: '0xdeadbeef' }
+          },
+          path: 137
+        }
+      }
+
+      expect(value.arguments.path).toBe(137)
+    })
+
     it('should support both json and path as template variables', () => {
       const value: ReadJsonValue = {
         type: 'read-json',
@@ -261,4 +275,4 @@ describe('ReadJsonValue', () => {
       expect(value.arguments.path).toBe('data.transactions.0.hash')
     })
   })
-})
+})

package/src/lib/types/conditions.ts

@@ -1,4 +1,4 @@
-import { AddressValue, BooleanValue } from './values'
+import { AddressValue, BooleanValue, ValueEmptyValue } from './values'
 
 /**
  * A condition that checks if a contract has code at a given address.
@@ -47,4 +47,4 @@ export function isJobCompletedCondition(obj: any): obj is JobCompletedCondition
  * check type like 'contract-exists', or any ValueResolver that produces a
  * boolean result (e.g., `basic-arithmetic` with an 'eq' operation).
  */
-export type Condition = BooleanValue | ContractExistsCondition | JobCompletedCondition;
+export type Condition = BooleanValue | ContractExistsCondition | JobCompletedCondition | ValueEmptyValue;

package/src/lib/types/values.ts

@@ -91,7 +91,7 @@ export interface ReadJsonValue {
     type: 'read-json';
     arguments: {
         json: Value<any>; // The JSON object to read from
-        path: Value<string>; // The path to the value (e.g., "txs.data" or "user.profile.name")
+        path: Value<string | number>; // The path to the value (e.g., "txs.data", 1, or "user.profile.name")
     };
 }
 
@@ -100,6 +100,13 @@ export interface ResolveJsonValue {
   arguments: Value<any>;
 }
 
+export interface ValueEmptyValue {
+  type: 'value-empty';
+  arguments: {
+    value: Value<any>;
+  };
+}
+
 export interface SliceBytesValue {
   type: 'slice-bytes';
   arguments: {
@@ -126,6 +133,7 @@ export type ValueResolver =
   | JobCompletedValue
   | ReadJsonValue
   | ResolveJsonValue
+  | ValueEmptyValue
   | SliceBytesValue;
 
 /**

package/dist/lib/network-match.d.ts

@@ -1,3 +0,0 @@
-import { Network } from './types';
-export declare function resolveRequestedNetworks(requests: string[], networks: Network[]): number[];
-//# sourceMappingURL=network-match.d.ts.map

package/dist/lib/network-match.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-match.d.ts","sourceRoot":"","sources":["../../src/lib/network-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AA8BjC,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAyC1F"}

package/dist/lib/network-match.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveRequestedNetworks = resolveRequestedNetworks;
-function normalize(input) {
-    return input
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-function scoreNameMatch(candidateName, query) {
-    const c = normalize(candidateName);
-    const q = normalize(query);
-    if (!q || !c)
-        return 0;
-    if (c === q)
-        return 100;
-    if (c.startsWith(q))
-        return 90;
-    if (c.includes(q))
-        return 75;
-    const qTokens = q.split(' ');
-    const allTokensPresent = qTokens.every(t => c.includes(t));
-    if (allTokensPresent)
-        return 70;
-    return 0;
-}
-function resolveRequestedNetworks(requests, networks) {
-    const chainIds = [];
-    for (const req of requests) {
-        const asNumber = Number(req);
-        if (!Number.isNaN(asNumber)) {
-            const found = networks.find(n => n.chainId === asNumber);
-            if (found) {
-                chainIds.push(found.chainId);
-                continue;
-            }
-        }
-        let bestScore = -1;
-        let bestMatches = [];
-        for (const n of networks) {
-            const s = scoreNameMatch(n.name, req);
-            if (s > bestScore) {
-                bestScore = s;
-                bestMatches = [n];
-            }
-            else if (s === bestScore && s > 0) {
-                bestMatches.push(n);
-            }
-        }
-        if (bestScore < 60 || bestMatches.length === 0) {
-            throw new Error(`No network matched "${req}". Available: ${networks.map(n => `${n.name} (${n.chainId})`).join(', ')}`);
-        }
-        if (bestMatches.length > 1) {
-            const candidates = bestMatches.map(n => `${n.name} (${n.chainId})`).join(', ');
-            throw new Error(`Ambiguous network "${req}". Possible matches: ${candidates}`);
-        }
-        chainIds.push(bestMatches[0].chainId);
-    }
-    return chainIds;
-}
-//# sourceMappingURL=network-match.js.map

package/dist/lib/network-match.js.map

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

package/dist/lib/std/templates/create4.yaml

@@ -1,172 +0,0 @@
-name: "create4"
-type: "template"
-description: "Deploy chain-specific bytecodes through the CREATE4 universal deployer"
-
-arguments:
-  create4Address:
-    type: "address"
-    description: "Address of the deployed CREATE4 contract"
-  salt:
-    type: "bytes32"
-    description: "Plan salt mixed with the plan root (32-byte hex string)"
-  bytecodes:
-    type: "json"
-    description: "Dictionary with per-chain entries and a fallback. Keys should be chain ids plus `fallback`, and may include `sharedConstructor`. Each entry can provide `initCode` directly or `creationCode` + optional `constructor`."
-
-returns:
-  address:
-    type: "address"
-    description: "Deterministic address of the deployed contract"
-  planRoot:
-    type: "bytes32"
-    description: "Merkle root committed to for this plan"
-  deploymentSalt:
-    type: "bytes32"
-    description: "CREATE3 salt derived from the plan root and user salt"
-  mode:
-    type: "string"
-    description: "Either 'chain' or 'fallback' depending on what was deployed"
-
-setup:
-  actions:
-    - type: "static"
-      name: "validate-create4-factory"
-      arguments:
-        value:
-          type: "contract-exists"
-          arguments:
-            address: "{{create4Address}}"
-            selectors: ["0x9e0fae72", "0x8a056fe6"]
-    - type: "static"
-      name: "create4-plan"
-      arguments:
-        value:
-          type: "create4-plan"
-          arguments:
-            deployerAddress: "{{create4Address}}"
-            chainId: "{{Network().chainId}}"
-            salt: "{{salt}}"
-            bytecodes:
-              type: "resolve-json"
-              arguments: "{{bytecodes}}"
-
-skip_condition:
-  - type: "contract-exists"
-    arguments:
-      address:
-        type: "read-json"
-        arguments:
-          json: "{{create4-plan.value}}"
-          path: "address"
-
-actions:
-  - name: "create4-deploy"
-    template: "assured-deployment"
-    skip_condition:
-      - type: "basic-arithmetic"
-        arguments:
-          operation: "eq"
-          values:
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.modeFlag"
-            - "0"
-    arguments:
-      targetAddress:
-        type: "read-json"
-        arguments:
-          json: "{{create4-plan.value}}"
-          path: "address"
-      factoryAddress: "{{create4Address}}"
-      callData:
-        type: "abi-encode"
-        arguments:
-          signature: "deploy(bytes32[],bytes,uint64,bytes32)"
-          values:
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.proof"
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.initCode"
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.nextChainId"
-            - "{{salt}}"
-
-  - name: "create4-deploy-fallback"
-    template: "assured-deployment"
-    skip_condition:
-      - type: "basic-arithmetic"
-        arguments:
-          operation: "eq"
-          values:
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.modeFlag"
-            - "1"
-    arguments:
-      targetAddress:
-        type: "read-json"
-        arguments:
-          json: "{{create4-plan.value}}"
-          path: "address"
-      factoryAddress: "{{create4Address}}"
-      callData:
-        type: "abi-encode"
-        arguments:
-          signature: "deployFallback(bytes32,bytes32,bytes32[],bytes32[],bytes,bytes32)"
-          values:
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.gapLeafPrefix"
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.gapLeafHash"
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.gapProof"
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.proof"
-            - type: "read-json"
-              arguments:
-                json: "{{create4-plan.value}}"
-                path: "target.initCode"
-            - "{{salt}}"
-
-outputs:
-  address:
-    type: "read-json"
-    arguments:
-      json: "{{create4-plan.value}}"
-      path: "address"
-  planRoot:
-    type: "read-json"
-    arguments:
-      json: "{{create4-plan.value}}"
-      path: "planRoot"
-  deploymentSalt:
-    type: "read-json"
-    arguments:
-      json: "{{create4-plan.value}}"
-      path: "deploymentSalt"
-  plan:
-    type: "read-json"
-    arguments:
-      json: "{{create4-plan.value}}"
-      path: "plan"
-  mode:
-    type: "read-json"
-    arguments:
-      json: "{{create4-plan.value}}"
-      path: "target.mode"

package/dist/lib/utils/create4.d.ts

@@ -1,78 +0,0 @@
-export interface Create4ConstructorSpec {
-    types?: readonly string[];
-    values?: readonly any[];
-}
-export type Create4BytecodeEntry = string | {
-    initCode?: string;
-    creationCode?: string;
-    constructor?: Create4ConstructorSpec;
-    label?: string;
-    chainId?: string | number | bigint;
-};
-export type Create4BytecodeDictionary = {
-    fallback: Create4BytecodeEntry;
-    sharedConstructor?: Create4ConstructorSpec | null;
-    chains?: Record<string, Create4BytecodeEntry>;
-} & Record<string, any>;
-export interface ComputeCreate4PlanArgs {
-    deployerAddress: string;
-    chainId: string | number | bigint;
-    salt?: string | null;
-    bytecodes: Create4BytecodeDictionary;
-}
-export interface SerializedChainLeaf {
-    chainId: string;
-    nextChainId: string;
-    label?: string;
-    initCode: string;
-    initCodeHash: string;
-    prefix: string;
-    leafHash: string;
-    proof: string[];
-}
-export interface SerializedFallbackLeaf {
-    chainId: string;
-    nextChainId: string;
-    initCode: string;
-    initCodeHash: string;
-    prefix: string;
-    leafHash: string;
-    proof: string[];
-}
-export interface Create4ChainTarget {
-    mode: 'chain';
-    modeFlag: string;
-    chainId: string;
-    nextChainId: string;
-    initCode: string;
-    initCodeHash: string;
-    proof: string[];
-}
-export interface Create4FallbackTarget {
-    mode: 'fallback';
-    modeFlag: string;
-    gapChainId: string;
-    gapNextChainId: string;
-    gapLeafPrefix: string;
-    gapLeafHash: string;
-    gapProof: string[];
-    initCode: string;
-    initCodeHash: string;
-    proof: string[];
-}
-export interface Create4PlanComputationResult {
-    factoryAddress: string;
-    chainId: string;
-    planRoot: string;
-    salt: string;
-    deploymentSalt: string;
-    address: string;
-    target: Create4ChainTarget | Create4FallbackTarget;
-    plan: {
-        root: string;
-        leaves: SerializedChainLeaf[];
-        fallback: SerializedFallbackLeaf;
-    };
-}
-export declare function computeCreate4Plan(args: ComputeCreate4PlanArgs): Create4PlanComputationResult;
-//# sourceMappingURL=create4.d.ts.map

package/dist/lib/utils/create4.d.ts.map

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