@0xsequence/catapult 1.1.0

package/src/lib/std/templates/erc-2470.yaml

@@ -0,0 +1,67 @@
+# Similar to "raw-erc-2470" but it
+# uses some extra logic, delivered as a create-contract action, that ensures that the top level call fails if the contract
+# fails to deploy. This ensures that the gas estimation is accurate and the transaction won't silently fail with out of gas.
+name: "erc-2470"
+type: "template"
+
+arguments:
+  creationCode:
+    type: "bytes"
+  salt:
+    type: "bytes32"
+
+returns:
+  address:
+    type: "address"
+
+setup:
+  skip_condition:
+    - type: "contract-exists"
+      arguments:
+        address: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+  actions:
+    - type: "test-nicks-method"
+    - type: "min-balance"
+      arguments:
+        address: "0xBb6e024b9cFFACB947A71991E386681B1Cd1477D"
+        balance: "24700000000000000"
+    - type: "send-signed-transaction"
+      arguments:
+        transaction: |
+          0xf9016c8085174876e8008303c4d88080b90154608060405234801561001057600080fd5b50610134806100206000396000f3fe6080604052348015600f57600080fd5b506004361060285760003560e01c80634af63f0214602d575b600080fd5b60cf60048036036040811015604157600080fd5b810190602081018135640100000000811115605b57600080fd5b820183602082011115606c57600080fd5b80359060200191846001830284011164010000000083111715608d57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250929550509135925060eb915050565b604080516001600160a01b039092168252519081900360200190f35b6000818351602085016000f5939250505056fea26469706673582212206b44f8a82cb6b156bfcc3dc6aadd6df4eefd204bc928a4397fd15dacf6d5320564736f6c634300060200331b83247000822470
+
+actions:
+  - type: "assured-deployment"
+    arguments:
+      targetAddress:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+          salt: "{{salt}}"
+          initCode: "{{creationCode}}"
+      factoryAddress: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+      callData:
+        type: "abi-encode"
+        arguments:
+          signature: "deploy(bytes,bytes32)"
+          values:
+            - "{{creationCode}}"
+            - "{{salt}}"
+
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+          salt: "{{salt}}"
+          initCode: "{{creationCode}}"
+
+outputs:
+  address:
+    type: "compute-create2"
+    arguments:
+      deployerAddress: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+      salt: "{{salt}}"
+      initCode: "{{creationCode}}"

package/src/lib/std/templates/min-balance.yaml

@@ -0,0 +1,32 @@
+name: "min-balance"
+type: "template"
+
+arguments:
+  address:
+    type: "address"
+  balance:
+    type: "uint256"
+
+actions:
+  - type: "send-transaction"
+    arguments:
+      to: "{{address}}"
+      value:
+        type: "basic-arithmetic"
+        arguments:
+          operation: "sub"
+          values:
+            - "{{balance}}"
+            - type: "read-balance"
+              arguments:
+                address: "{{address}}"
+
+skip_condition:
+  - type: "basic-arithmetic"
+    arguments:
+      operation: "gte"
+      values:
+        - type: "read-balance"
+          arguments:
+            address: "{{address}}"
+        - "{{balance}}"

package/src/lib/std/templates/nano-universal-deployer.yaml

@@ -0,0 +1,59 @@
+# Similar to "raw-nano-universal-deployer" but it
+# uses some extra logic, delivered as a create-contract action, that ensures that the top level call fails if the contract
+# fails to deploy. This ensures that the gas estimation is accurate and the transaction won't silently fail with out of gas.
+name: "nano-universal-deployer"
+type: "template"
+
+arguments:
+  creationCode:
+    type: "bytes"
+
+returns:
+  address:
+    type: "address"
+
+setup:
+  skip_condition:
+    - type: "contract-exists"
+      arguments:
+        address: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+  actions:
+    - type: "test-nicks-method"
+    - type: "min-balance"
+      arguments:
+        address: "0x9c5a87452d4FAC0cbd53BDCA580b20A45526B3AB"
+        balance: "21700000000140000"
+    - type: "send-signed-transaction"
+      arguments:
+        transaction: |
+          0xf9010880852416b84e01830222e08080b8b66080604052348015600f57600080fd5b50609980601d6000396000f3fe60a06020601f369081018290049091028201604052608081815260009260609284918190838280828437600092018290525084519495509392505060208401905034f5604080516001600160a01b0383168152905191935081900360200190a0505000fea26469706673582212205a310755225e3c740b2f013fb6343f4c205e7141fcdf15947f5f0e0e818727fb64736f6c634300060a00331ca01820182018201820182018201820182018201820182018201820182018201820a01820182018201820182018201820182018201820182018201820182018201820
+
+actions:
+  - type: "assured-deployment"
+    arguments:
+      targetAddress:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+          salt: "0x0000000000000000000000000000000000000000000000000000000000000000"
+          initCode: "{{creationCode}}"
+      factoryAddress: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+      callData: "{{creationCode}}"
+
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+          salt: "0x0000000000000000000000000000000000000000000000000000000000000000"
+          initCode: "{{creationCode}}"
+
+outputs:
+  address:
+    type: "compute-create2"
+    arguments:
+      deployerAddress: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+      salt: "0x0000000000000000000000000000000000000000000000000000000000000000"
+      initCode: "{{creationCode}}"

package/src/lib/std/templates/raw-erc-2470.yaml

@@ -0,0 +1,59 @@
+name: "raw-erc-2470"
+type: "template"
+
+arguments:
+  creationCode:
+    type: "bytes"
+  salt:
+    type: "bytes32"
+
+returns:
+  address:
+    type: "address"
+
+setup:
+  skip_condition:
+    - type: "contract-exists"
+      arguments:
+        address: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+  actions:
+    - type: "test-nicks-method"
+    - type: "min-balance"
+      arguments:
+        address: "0xBb6e024b9cFFACB947A71991E386681B1Cd1477D"
+        balance: "24700000000000000"
+    - type: "send-signed-transaction"
+      arguments:
+        transaction: |
+          0xf9016c8085174876e8008303c4d88080b90154608060405234801561001057600080fd5b50610134806100206000396000f3fe6080604052348015600f57600080fd5b506004361060285760003560e01c80634af63f0214602d575b600080fd5b60cf60048036036040811015604157600080fd5b810190602081018135640100000000811115605b57600080fd5b820183602082011115606c57600080fd5b80359060200191846001830284011164010000000083111715608d57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250929550509135925060eb915050565b604080516001600160a01b039092168252519081900360200190f35b6000818351602085016000f5939250505056fea26469706673582212206b44f8a82cb6b156bfcc3dc6aadd6df4eefd204bc928a4397fd15dacf6d5320564736f6c634300060200331b83247000822470
+
+actions:
+  - type: "send-transaction"
+    arguments:
+      to: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+      data:
+        type: "abi-encode"
+        arguments:
+          signature: "deploy(bytes,bytes32)"
+          values:
+            - "{{creationCode}}"
+            - "{{salt}}"
+      gasMultiplier: 1.6
+
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+          salt: "{{salt}}"
+          initCode: "{{creationCode}}"
+
+outputs:
+  address:
+    type: "compute-create2"
+    arguments:
+      deployerAddress: "0xce0042B868300000d44A59004Da54A005ffdcf9f"
+      salt: "{{salt}}"
+      initCode: "{{creationCode}}"

package/src/lib/std/templates/raw-nano-universal-deployer.yaml

@@ -0,0 +1,51 @@
+name: "raw-nano-universal-deployer"
+type: "template"
+
+arguments:
+  creationCode:
+    type: "bytes"
+
+returns:
+  address:
+    type: "address"
+
+setup:
+  skip_condition:
+    - type: "contract-exists"
+      arguments:
+        address: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+  actions:
+    - type: "test-nicks-method"
+    - type: "min-balance"
+      arguments:
+        address: "0x9c5a87452d4FAC0cbd53BDCA580b20A45526B3AB"
+        balance: "21700000000140000"
+    - type: "send-signed-transaction"
+      arguments:
+        transaction: |
+          0xf9010880852416b84e01830222e08080b8b66080604052348015600f57600080fd5b50609980601d6000396000f3fe60a06020601f369081018290049091028201604052608081815260009260609284918190838280828437600092018290525084519495509392505060208401905034f5604080516001600160a01b0383168152905191935081900360200190a0505000fea26469706673582212205a310755225e3c740b2f013fb6343f4c205e7141fcdf15947f5f0e0e818727fb64736f6c634300060a00331ca01820182018201820182018201820182018201820182018201820182018201820a01820182018201820182018201820182018201820182018201820182018201820
+
+actions:
+  - type: "send-transaction"
+    arguments:
+      to: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+      data: "{{creationCode}}"
+      gasMultiplier: 1.6
+
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+          salt: "0x0000000000000000000000000000000000000000000000000000000000000000"
+          initCode: "{{creationCode}}"
+
+outputs:
+  address:
+    type: "compute-create2"
+    arguments:
+      deployerAddress: "0x1B926fBB24A9F78DCDd3272f2d86F5D0660E59c0"
+      salt: "0x0000000000000000000000000000000000000000000000000000000000000000"
+      initCode: "{{creationCode}}"

package/src/lib/std/templates/raw-sequence-universal-deployer-2.yaml

@@ -0,0 +1,48 @@
+name: "raw-sequence-universal-deployer-2"
+type: "template"
+
+arguments:
+  creationCode:
+    type: "bytes"
+  salt:
+    type: "bytes32"
+
+returns:
+  address:
+    type: "address"
+
+setup:
+  - type: "nano-universal-deployer"
+    arguments:
+      creationCode: "0x608060405234801561001057600080fd5b5061013d806100206000396000f3fe60806040526004361061001e5760003560e01c80639c4ae2d014610023575b600080fd5b6100cb6004803603604081101561003957600080fd5b81019060208101813564010000000081111561005457600080fd5b82018360208201111561006657600080fd5b8035906020019184600183028401116401000000008311171561008857600080fd5b91908080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525092955050913592506100cd915050565b005b60008183516020850134f56040805173ffffffffffffffffffffffffffffffffffffffff83168152905191925081900360200190a050505056fea264697066735822122033609f614f03931b92d88c309d698449bb77efcd517328d341fa4f923c5d8c7964736f6c63430007060033"
+
+actions:
+  - type: "send-transaction"
+    arguments:
+      to: "0x8A5Bc19e22D6aD55a2c763B93A75d09F321fe764"
+      data:
+        type: "abi-encode"
+        arguments:
+          signature: "deploy(bytes,uint256)"
+          values:
+            - "{{creationCode}}"
+            - "{{salt}}"
+      gasMultiplier: 1.6
+
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0x8A5Bc19e22D6aD55a2c763B93A75d09F321fe764"
+          salt: "{{salt}}"
+          initCode: "{{creationCode}}"
+
+outputs:
+  address:
+    type: "compute-create2"
+    arguments:
+      deployerAddress: "0x8A5Bc19e22D6aD55a2c763B93A75d09F321fe764"
+      salt: "{{salt}}"
+      initCode: "{{creationCode}}"

package/src/lib/std/templates/sequence-universal-deployer-2.yaml

@@ -0,0 +1,57 @@
+# Similar to "raw-sequence-universal-deployer-2" but it
+# uses some extra logic, delivered as a create-contract action, that ensures that the top level call fails if the contract
+# fails to deploy. This ensures that the gas estimation is accurate and the transaction won't silently fail with out of gas.
+name: "sequence-universal-deployer-2"
+type: "template"
+
+arguments:
+  creationCode:
+    type: "bytes"
+  salt:
+    type: "bytes32"
+
+returns:
+  address:
+    type: "address"
+
+setup:
+  - type: "nano-universal-deployer"
+    arguments:
+      creationCode: "0x608060405234801561001057600080fd5b5061013d806100206000396000f3fe60806040526004361061001e5760003560e01c80639c4ae2d014610023575b600080fd5b6100cb6004803603604081101561003957600080fd5b81019060208101813564010000000081111561005457600080fd5b82018360208201111561006657600080fd5b8035906020019184600183028401116401000000008311171561008857600080fd5b91908080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525092955050913592506100cd915050565b005b60008183516020850134f56040805173ffffffffffffffffffffffffffffffffffffffff83168152905191925081900360200190a050505056fea264697066735822122033609f614f03931b92d88c309d698449bb77efcd517328d341fa4f923c5d8c7964736f6c63430007060033"
+
+actions:
+  - type: "assured-deployment"
+    arguments:
+      targetAddress:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0x8A5Bc19e22D6aD55a2c763B93A75d09F321fe764"
+          salt: "{{salt}}"
+          initCode: "{{creationCode}}"
+      factoryAddress: "0x8A5Bc19e22D6aD55a2c763B93A75d09F321fe764"
+      callData:
+        type: "abi-encode"
+        arguments:
+          signature: "deploy(bytes,uint256)"
+          values:
+            - "{{creationCode}}"
+            - "{{salt}}"
+
+
+skip_condition:
+  - type: "contract-exists"
+    arguments:
+      address:
+        type: "compute-create2"
+        arguments:
+          deployerAddress: "0x8A5Bc19e22D6aD55a2c763B93A75d09F321fe764"
+          salt: "{{salt}}"
+          initCode: "{{creationCode}}"
+
+outputs:
+  address:
+    type: "compute-create2"
+    arguments:
+      deployerAddress: "0x8A5Bc19e22D6aD55a2c763B93A75d09F321fe764"
+      salt: "{{salt}}"
+      initCode: "{{creationCode}}"

package/src/lib/types/__tests__/json-request-action.spec.ts

@@ -0,0 +1,243 @@
+import { JsonRequestAction } from '../actions'
+
+describe('JsonRequestAction', () => {
+  describe('type definition', () => {
+    it('should have correct type structure for basic GET request', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/data'
+        }
+      }
+      
+      expect(action.type).toBe('json-request')
+      expect(action.arguments.url).toBe('https://api.example.com/data')
+    })
+
+    it('should support optional method parameter', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/data',
+          method: 'POST'
+        }
+      }
+      
+      expect(action.arguments.method).toBe('POST')
+    })
+
+    it('should support optional headers parameter', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/data',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': 'Bearer token123'
+          }
+        }
+      }
+      
+      expect(action.arguments.headers).toEqual({
+        'Content-Type': 'application/json',
+        'Authorization': 'Bearer token123'
+      })
+    })
+
+    it('should support optional body parameter', () => {
+      const requestBody = {
+        name: 'John Doe',
+        email: 'john@example.com'
+      }
+      
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/users',
+          method: 'POST',
+          body: requestBody
+        }
+      }
+      
+      expect(action.arguments.body).toEqual(requestBody)
+    })
+
+    it('should support template variables in url', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: '{{apiBaseUrl}}/users/{{userId}}'
+        }
+      }
+      
+      expect(action.arguments.url).toBe('{{apiBaseUrl}}/users/{{userId}}')
+    })
+
+    it('should support template variables in method', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/data',
+          method: '{{httpMethod}}'
+        }
+      }
+      
+      expect(action.arguments.method).toBe('{{httpMethod}}')
+    })
+
+    it('should support template variables in headers', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/data',
+          headers: {
+            'Authorization': '{{authToken}}',
+            'X-API-Key': '{{apiKey}}'
+          }
+        }
+      }
+      
+      expect(action.arguments.headers).toEqual({
+        'Authorization': '{{authToken}}',
+        'X-API-Key': '{{apiKey}}'
+      })
+    })
+
+    it('should support template variables in body', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/users',
+          method: 'POST',
+          body: {
+            name: '{{userName}}',
+            email: '{{userEmail}}',
+            data: '{{userData}}'
+          }
+        }
+      }
+      
+      expect(action.arguments.body).toEqual({
+        name: '{{userName}}',
+        email: '{{userEmail}}',
+        data: '{{userData}}'
+      })
+    })
+
+    it('should support complex nested body structures', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/transactions',
+          method: 'POST',
+          body: {
+            transaction: {
+              to: '{{recipientAddress}}',
+              value: '{{amount}}',
+              data: '{{calldata}}'
+            },
+            metadata: {
+              timestamp: '{{currentTime}}',
+              source: 'live-contracts'
+            }
+          }
+        }
+      }
+      
+      expect(action.arguments.body).toEqual({
+        transaction: {
+          to: '{{recipientAddress}}',
+          value: '{{amount}}',
+          data: '{{calldata}}'
+        },
+        metadata: {
+          timestamp: '{{currentTime}}',
+          source: 'live-contracts'
+        }
+      })
+    })
+
+    it('should support all HTTP methods', () => {
+      const methods = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']
+      
+      methods.forEach(method => {
+        const action: JsonRequestAction = {
+          type: 'json-request',
+          arguments: {
+            url: 'https://api.example.com/data',
+            method: method
+          }
+        }
+        
+        expect(action.arguments.method).toBe(method)
+      })
+    })
+
+    it('should work with minimal configuration (only url)', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/status'
+        }
+      }
+      
+      expect(action.type).toBe('json-request')
+      expect(action.arguments.url).toBe('https://api.example.com/status')
+      expect(action.arguments.method).toBeUndefined()
+      expect(action.arguments.headers).toBeUndefined()
+      expect(action.arguments.body).toBeUndefined()
+    })
+
+    it('should work with full configuration', () => {
+      const action: JsonRequestAction = {
+        type: 'json-request',
+        arguments: {
+          url: 'https://api.example.com/users',
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': 'Bearer token123',
+            'X-Custom-Header': 'custom-value'
+          },
+          body: {
+            user: {
+              name: 'Alice',
+              email: 'alice@example.com',
+              preferences: {
+                theme: 'dark',
+                notifications: true
+              }
+            },
+            metadata: {
+              source: 'api',
+              version: '1.0'
+            }
+          }
+        }
+      }
+      
+      expect(action.type).toBe('json-request')
+      expect(action.arguments.url).toBe('https://api.example.com/users')
+      expect(action.arguments.method).toBe('POST')
+      expect(action.arguments.headers).toEqual({
+        'Content-Type': 'application/json',
+        'Authorization': 'Bearer token123',
+        'X-Custom-Header': 'custom-value'
+      })
+      expect(action.arguments.body).toEqual({
+        user: {
+          name: 'Alice',
+          email: 'alice@example.com',
+          preferences: {
+            theme: 'dark',
+            notifications: true
+          }
+        },
+        metadata: {
+          source: 'api',
+          version: '1.0'
+        }
+      })
+    })
+  })
+})