@0xsequence/catapult 1.3.17 → 1.5.0

package/src/lib/__tests__/network-loader.spec.ts

@@ -1,150 +0,0 @@
-import * as fs from 'fs/promises'
-import * as path from 'path'
-import { loadNetworks } from '../network-loader'
-
-const tmpDir = path.join(process.cwd(), '.tmp-network-loader-tests')
-
-async function writeNetworksYaml(projectRoot: string, yamlContent: string): Promise<void> {
-  await fs.mkdir(projectRoot, { recursive: true })
-  await fs.writeFile(path.join(projectRoot, 'networks.yaml'), yamlContent, 'utf-8')
-}
-
-describe('network-loader rpcUrl token replacement', () => {
-  const originalEnv = { ...process.env }
-
-  beforeAll(async () => {
-    await fs.mkdir(tmpDir, { recursive: true })
-  })
-
-  afterEach(() => {
-    process.env = { ...originalEnv }
-  })
-
-  afterAll(async () => {
-    try {
-      await fs.rm(tmpDir, { recursive: true, force: true })
-    } catch {}
-  })
-
-  test('replaces {{RPC_*}} tokens with env values', async () => {
-    const projectRoot = path.join(tmpDir, 'case1')
-    process.env.RPC_URL_TOKEN = 'abc123'
-    const yaml = `
-- name: "TestNet"
-  chainId: 123
-  rpcUrl: "https://node.example.com/{{RPC_URL_TOKEN}}"
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    const networks = await loadNetworks(projectRoot)
-    expect(networks).toHaveLength(1)
-    expect(networks[0].rpcUrl).toBe('https://node.example.com/abc123')
-  })
-
-  test('leaves non-RPC tokens intact', async () => {
-    const projectRoot = path.join(tmpDir, 'case2')
-    process.env.SOME_TOKEN = 'should_not_be_used'
-    const yaml = `
-- name: "TestNet"
-  chainId: 123
-  rpcUrl: "https://node.example.com/{{SOME_TOKEN}}"
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    const networks = await loadNetworks(projectRoot)
-    expect(networks[0].rpcUrl).toBe('https://node.example.com/{{SOME_TOKEN}}')
-  })
-
-  test('supports multiple RPC tokens in a single url', async () => {
-    const projectRoot = path.join(tmpDir, 'case3')
-    process.env.RPC_A = 'A'
-    process.env.RPC_B = 'B'
-    const yaml = `
-- name: "TestNet"
-  chainId: 123
-  rpcUrl: "https://node.example.com/{{RPC_A}}/path/{{RPC_B}}"
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    const networks = await loadNetworks(projectRoot)
-    expect(networks[0].rpcUrl).toBe('https://node.example.com/A/path/B')
-  })
-
-  test('trims whitespace within tokens', async () => {
-    const projectRoot = path.join(tmpDir, 'case4')
-    process.env.RPC_TOKEN = 'XYZ'
-    const yaml = `
-- name: "TestNet"
-  chainId: 123
-  rpcUrl: "https://node.example.com/{{  RPC_TOKEN   }}"
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    const networks = await loadNetworks(projectRoot)
-    expect(networks[0].rpcUrl).toBe('https://node.example.com/XYZ')
-  })
-
-  test('defaults to empty string when RPC token has no matching env var', async () => {
-    const projectRoot = path.join(tmpDir, 'case5')
-    delete process.env.RPC_MISSING
-    const yaml = `
-- name: "TestNet"
-  chainId: 123
-  rpcUrl: "https://node.example.com/{{RPC_MISSING}}"
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    const networks = await loadNetworks(projectRoot)
-    expect(networks[0].rpcUrl).toBe('https://node.example.com/')
-  })
-})
-
-describe('network-loader params', () => {
-  afterAll(async () => {
-    try {
-      await fs.rm(tmpDir, { recursive: true, force: true })
-    } catch {}
-  })
-
-  test('passes through valid params object', async () => {
-    const projectRoot = path.join(tmpDir, 'params-valid')
-    const yaml = `
-- name: "MyNet"
-  chainId: 4217
-  rpcUrl: "http://127.0.0.1:8545"
-  params:
-    myParam: true
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    const networks = await loadNetworks(projectRoot)
-    expect(networks).toHaveLength(1)
-    expect(networks[0].params).toEqual({ myParam: true })
-  })
-
-  test('rejects params when not a plain object', async () => {
-    const projectRoot = path.join(tmpDir, 'params-invalid-array')
-    const yaml = `
-- name: "BadNet"
-  chainId: 1
-  rpcUrl: "http://127.0.0.1:8545"
-  params: [1, 2, 3]
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    await expect(loadNetworks(projectRoot)).rejects.toThrow(/Failed to load or parse networks.yaml/)
-  })
-
-  test('rejects params when null', async () => {
-    const projectRoot = path.join(tmpDir, 'params-invalid-null')
-    const yaml = `
-- name: "BadNet"
-  chainId: 1
-  rpcUrl: "http://127.0.0.1:8545"
-  params: null
-`
-    await writeNetworksYaml(projectRoot, yaml)
-
-    await expect(loadNetworks(projectRoot)).rejects.toThrow(/Failed to load or parse networks.yaml/)
-  })
-})

package/src/lib/__tests__/network-selection.spec.ts

@@ -1,41 +0,0 @@
-import { resolveSelectedChainIds, resolveSingleChainId } from '../../lib/network-selection'
-import { Network } from '../../lib/types'
-
-describe('network-selection', () => {
-  const networks: Network[] = [
-    { name: 'Mainnet', chainId: 1, rpcUrl: 'https://mainnet' },
-    { name: 'Arbitrum One', chainId: 42161, rpcUrl: 'https://arb' },
-    { name: 'Polygon', chainId: 137, rpcUrl: 'https://polygon' },
-    { name: 'Mainnet', chainId: 10_000, rpcUrl: 'https://fork' },
-  ]
-
-  it('returns undefined for empty/undefined input', () => {
-    expect(resolveSelectedChainIds(undefined, networks)).toBeUndefined()
-    expect(resolveSelectedChainIds('', networks)).toBeUndefined()
-    expect(resolveSelectedChainIds('   ', networks)).toBeUndefined()
-  })
-
-  it('parses numeric IDs and removes duplicates', () => {
-    expect(resolveSelectedChainIds('1,1,42161', networks)).toEqual([1, 42161])
-  })
-
-  it('matches names case-insensitively and includes all with same name', () => {
-    expect(resolveSelectedChainIds('mainnet', networks)).toEqual([1, 10000])
-    expect(resolveSelectedChainIds('MAINNET,polygon', networks)).toEqual([1, 10000, 137])
-  })
-
-  it('preserves token order and then network order for name matches', () => {
-    expect(resolveSelectedChainIds('polygon,mainnet', networks)).toEqual([137, 1, 10000])
-  })
-
-  it('throws on unknown name', () => {
-    expect(() => resolveSelectedChainIds('unknown', networks)).toThrow(/Unknown network selector/)
-  })
-
-  it('resolveSingleChainId returns first match for name and first token for multi', () => {
-    expect(resolveSingleChainId('mainnet', networks)).toBe(1)
-    expect(resolveSingleChainId('137,1', networks)).toBe(137)
-  })
-})
-
-

package/src/lib/__tests__/network-utils.spec.ts

@@ -1,230 +0,0 @@
-import { detectNetworkFromRpc, isValidRpcUrl } from '../network-utils'
-import { Network } from '../types'
-
-// Mock ethers.JsonRpcProvider
-jest.mock('ethers', () => ({
-  ...jest.requireActual('ethers'),
-  ethers: {
-    ...jest.requireActual('ethers').ethers,
-    JsonRpcProvider: jest.fn().mockImplementation(() => ({
-      getNetwork: jest.fn()
-    }))
-  }
-}))
-
-describe('Network Utils', () => {
-  describe('isValidRpcUrl', () => {
-    it('should validate valid HTTP RPC URLs', () => {
-      expect(isValidRpcUrl('http://localhost:8545')).toBe(true)
-      expect(isValidRpcUrl('https://mainnet.infura.io/v3/abc123')).toBe(true)
-    })
-
-    it('should validate valid WebSocket RPC URLs', () => {
-      expect(isValidRpcUrl('ws://localhost:8545')).toBe(true)
-      expect(isValidRpcUrl('wss://mainnet.infura.io/v3/abc123')).toBe(true)
-    })
-
-    it('should reject invalid URLs', () => {
-      expect(isValidRpcUrl('invalid-url')).toBe(false)
-      expect(isValidRpcUrl('ftp://example.com')).toBe(false)
-      expect(isValidRpcUrl('')).toBe(false)
-    })
-
-    it('should reject URLs without hostname', () => {
-      expect(isValidRpcUrl('http://')).toBe(false)
-    })
-  })
-
-  describe('detectNetworkFromRpc', () => {
-    let mockGetNetwork: jest.Mock
-
-    beforeEach(() => {
-      // Reset mocks
-      jest.clearAllMocks()
-      
-      // Mock the JsonRpcProvider constructor and getNetwork method
-      const { ethers } = require('ethers')
-      mockGetNetwork = jest.fn()
-      
-      // Mock the provider's getNetwork method
-      ethers.JsonRpcProvider.mockImplementation(() => ({
-        getNetwork: mockGetNetwork
-      }))
-    })
-
-    it('should detect network successfully', async () => {
-      const mockNetwork = {
-        name: 'mainnet',
-        chainId: 1
-      }
-      
-      mockGetNetwork.mockResolvedValue(mockNetwork)
-
-      const result = await detectNetworkFromRpc('https://mainnet.infura.io/v3/abc123')
-
-      expect(result).toEqual({
-        name: 'mainnet',
-        chainId: 1,
-        rpcUrl: 'https://mainnet.infura.io/v3/abc123'
-      })
-
-      // Verify provider was created with correct URL
-      const { ethers } = require('ethers')
-      expect(ethers.JsonRpcProvider).toHaveBeenCalledWith('https://mainnet.infura.io/v3/abc123')
-    })
-
-    it('should handle network with unknown name', async () => {
-      const mockNetwork = {
-        name: 'unknown',
-        chainId: 31337
-      }
-      
-      mockGetNetwork.mockResolvedValue(mockNetwork)
-
-      const result = await detectNetworkFromRpc('http://localhost:8545')
-
-      expect(result).toEqual({
-        name: 'unknown',
-        chainId: 31337,
-        rpcUrl: 'http://localhost:8545'
-      })
-    })
-
-    it('should handle connection errors', async () => {
-      mockGetNetwork.mockRejectedValue(new Error('Connection failed'))
-
-      await expect(detectNetworkFromRpc('http://localhost:8545'))
-        .rejects.toThrow('Failed to detect network from RPC URL "http://localhost:8545": Connection failed')
-    })
-
-    it('should handle network detection errors', async () => {
-      mockGetNetwork.mockRejectedValue(new Error('Network not supported'))
-
-      await expect(detectNetworkFromRpc('http://invalid-rpc.com'))
-        .rejects.toThrow('Failed to detect network from RPC URL "http://invalid-rpc.com": Network not supported')
-    })
-  })
-
-  describe('Integration with Run Command', () => {
-    it('should create a complete Network object from detected information', async () => {
-      const { ethers } = require('ethers')
-
-      const mockNetwork = {
-        name: 'sepolia',
-        chainId: 11155111,
-      }
-
-      const getNetworkMock = jest.fn().mockResolvedValue(mockNetwork)
-      ethers.JsonRpcProvider.mockImplementation(() => ({
-        getNetwork: getNetworkMock,
-      }))
-
-      const detectedInfo = await detectNetworkFromRpc('https://sepolia.infura.io/v3/abc123')
-
-      // Simulate what the run command does
-      const customNetwork: Network = {
-        name: detectedInfo.name || `custom-${detectedInfo.chainId}`,
-        chainId: detectedInfo.chainId!,
-        rpcUrl: 'https://sepolia.infura.io/v3/abc123',
-        supports: detectedInfo.supports || [],
-        gasLimit: detectedInfo.gasLimit,
-        testnet: detectedInfo.testnet,
-        evmVersion: detectedInfo.evmVersion,
-        params: detectedInfo.params,
-      }
-
-      expect(customNetwork).toEqual({
-        name: 'sepolia',
-        chainId: 11155111,
-        rpcUrl: 'https://sepolia.infura.io/v3/abc123',
-        supports: [],
-        gasLimit: undefined,
-        testnet: undefined,
-        evmVersion: undefined,
-        params: undefined,
-      })
-    })
-
-    it('should merge params and other yaml fields when chainId matches networks.yaml', async () => {
-      const { ethers } = require('ethers')
-
-      const getNetworkMock = jest.fn().mockResolvedValue({ name: 'unknown', chainId: 137 })
-      ethers.JsonRpcProvider.mockImplementation(() => ({
-        getNetwork: getNetworkMock,
-      }))
-
-      const detectedInfo = await detectNetworkFromRpc('http://127.0.0.1:8545')
-      const knownNetwork: Network = {
-        name: 'Polygon',
-        chainId: 137,
-        rpcUrl: 'https://nodes.sequence.app/polygon/token',
-        supports: ['etherscan_v2', 'sourcify'],
-        testnet: false,
-        evmVersion: 'paris',
-        params: { trailsOnly: false },
-      }
-
-      // Simulate what the run command does
-      const customNetwork: Network = {
-        name: detectedInfo.name || knownNetwork.name || `custom-${detectedInfo.chainId}`,
-        chainId: detectedInfo.chainId!,
-        rpcUrl: 'http://127.0.0.1:8545',
-        supports: detectedInfo.supports || knownNetwork.supports || [],
-        gasLimit: detectedInfo.gasLimit || knownNetwork.gasLimit,
-        testnet: detectedInfo.testnet !== undefined ? detectedInfo.testnet : knownNetwork.testnet,
-        evmVersion: detectedInfo.evmVersion || knownNetwork.evmVersion,
-        params: detectedInfo.params || knownNetwork.params,
-      }
-
-      expect(customNetwork).toEqual({
-        name: 'unknown',
-        chainId: 137,
-        rpcUrl: 'http://127.0.0.1:8545',
-        supports: ['etherscan_v2', 'sourcify'],
-        gasLimit: undefined,
-        testnet: false,
-        evmVersion: 'paris',
-        params: { trailsOnly: false },
-      })
-    })
-
-    it('should handle partial network information gracefully', async () => {
-      const { ethers } = require('ethers')
-
-      const mockNetwork = {
-        name: 'unknown',
-        chainId: 42,
-      }
-
-      const getNetworkMock = jest.fn().mockResolvedValue(mockNetwork)
-      ethers.JsonRpcProvider.mockImplementation(() => ({
-        getNetwork: getNetworkMock,
-      }))
-
-      const detectedInfo = await detectNetworkFromRpc('http://custom-network:8545')
-
-      // Simulate what the run command does
-      const customNetwork: Network = {
-        name: detectedInfo.name || `custom-${detectedInfo.chainId}`,
-        chainId: detectedInfo.chainId!,
-        rpcUrl: 'http://custom-network:8545',
-        supports: detectedInfo.supports || [],
-        gasLimit: detectedInfo.gasLimit,
-        testnet: detectedInfo.testnet,
-        evmVersion: detectedInfo.evmVersion,
-        params: detectedInfo.params,
-      }
-
-      expect(customNetwork).toEqual({
-        name: 'unknown',
-        chainId: 42,
-        rpcUrl: 'http://custom-network:8545',
-        supports: [],
-        gasLimit: undefined,
-        testnet: undefined,
-        evmVersion: undefined,
-        params: undefined,
-      })
-    })
-  })
-})

package/src/lib/artifacts/__tests__/fixtures/contract1.json

@@ -1,19 +0,0 @@
-{
-  "contractName": "TestContract1",
-  "sourceName": "contracts/TestContract1.sol",
-  "abi": [
-    {
-      "type": "function",
-      "name": "getValue",
-      "inputs": [],
-      "outputs": [
-        {
-          "name": "",
-          "type": "uint256"
-        }
-      ]
-    }
-  ],
-  "bytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c806320965255146100365780636d4ce63c14610040575b600080fd5b610040610058565b005b610048610062565b6040516100579190610078565b60405180910390f35b0000005b6000806000fefe",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c806320965255146100365780636d4ce63c14610040575b600080fd5b610040610058565b005b610048610062565b6040516100579190610078565b60405180910390f35b6000fefe"
-} 

package/src/lib/artifacts/__tests__/fixtures/contract2.json

@@ -1,19 +0,0 @@
-{
-  "contractName": "TestContract2",
-  "sourceName": "contracts/TestContract2.sol",
-  "abi": [
-    {
-      "type": "function",
-      "name": "setValue",
-      "inputs": [
-        {
-          "name": "value",
-          "type": "uint256"
-        }
-      ],
-      "outputs": []
-    }
-  ],
-  "bytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c806355241077146100365780636d4ce63c14610040575b600080fd5b610040610058565b005b610048610062565b6040516100579190610078565b60405180910390f35b6000fefe",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c806355241077146100365780636d4ce63c14610040575b600080fd5b610040610058565b005b610048610062565b6040516100579190610078565b60405180910390f35b6000fefe"
-} 

package/src/lib/artifacts/__tests__/fixtures/duplicate-name.json

@@ -1,19 +0,0 @@
-{
-  "contractName": "TestContract1",
-  "sourceName": "contracts/DuplicateTestContract1.sol",
-  "abi": [
-    {
-      "type": "function",
-      "name": "differentFunction",
-      "inputs": [],
-      "outputs": [
-        {
-          "name": "",
-          "type": "string"
-        }
-      ]
-    }
-  ],
-  "bytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c806320965255146100365780636d4ce63c14610040575b600080fd5b610040610058565b005b610048610062565b6040516100579190610078565b60405180910390f35b0000005b6000806000fefe",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c806320965255146100365780636d4ce63c14610040575b600080fd5b610040610058565b005b610048610062565b6040516100579190610078565b60405180910390f35b6000fefe"
-} 

package/src/lib/artifacts/__tests__/fixtures/nested/nested-contract.json

@@ -1,18 +0,0 @@
-{
-  "contractName": "NestedContract",
-  "sourceName": "contracts/nested/NestedContract.sol",
-  "abi": [
-    {
-      "type": "function",
-      "name": "nestedFunction",
-      "inputs": [],
-      "outputs": [
-        {
-          "name": "",
-          "type": "bool"
-        }
-      ]
-    }
-  ],
-  "bytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c806320965255146100365780636d4ce63c14610040575b600080fd5b610040610058565b005b610048610062565b6040516100579190610078565b60405180910390f35b0000005b6000806000fefe"
-} 

package/src/lib/artifacts/__tests__/fixtures/not-an-artifact.json

@@ -1,8 +0,0 @@
-{
-  "name": "NotAnArtifact",
-  "data": {
-    "some": "random",
-    "json": "data"
-  },
-  "version": "1.0.0"
-} 

package/src/lib/artifacts/__tests__/fixtures/readme.txt

@@ -1,2 +0,0 @@
-This is just a text file that should be ignored during artifact scanning.
-It has no JSON content and should not interfere with the test.