filecoin-pin/src/test/unit/get-rpc-url.test.ts

Bridge IPFS content to Filecoin Onchain Cloud using familiar tools

import { RPC_URLS } from '@filoz/synapse-sdk'
import { describe, expect, it } from 'vitest'
import { getRpcUrl } from '../../common/get-rpc-url.js'
import type { CLIAuthOptions } from '../../utils/cli-auth.js'

/**
 * In production Commander already maps env vars (NETWORK/RPC_URL) into CLI options.
 * These tests cover the behavior of getRpcUrl given the options object Commander
 * would pass, without interacting with process.env directly.
 */

describe('getRpcUrl', () => {
  it('returns explicit rpcUrl even when network is provided', () => {
    const options: CLIAuthOptions = {
      rpcUrl: 'wss://custom.rpc.url/ws',
      network: 'mainnet',
    }

    expect(getRpcUrl(options)).toBe('wss://custom.rpc.url/ws')
  })

  it.each([
    ['mainnet', RPC_URLS.mainnet.websocket],
    ['calibration', RPC_URLS.calibration.websocket],
  ])('returns RPC URL for %s network', (network, expected) => {
    expect(getRpcUrl({ network } satisfies CLIAuthOptions)).toBe(expected)
  })

  it('normalizes network casing and whitespace', () => {
    expect(
      getRpcUrl({
        network: '  MAINNET  ',
      })
    ).toBe(RPC_URLS.mainnet.websocket)

    expect(
      getRpcUrl({
        network: '\tCaLiBrAtIoN\n',
      })
    ).toBe(RPC_URLS.calibration.websocket)
  })

  it('defaults to calibration when network is missing or blank', () => {
    expect(getRpcUrl({})).toBe(RPC_URLS.calibration.websocket)
    expect(getRpcUrl({ network: '' })).toBe(RPC_URLS.calibration.websocket)
    expect(getRpcUrl({ network: '   ' })).toBe(RPC_URLS.calibration.websocket)
  })

  it('treats empty rpcUrl as falsy and falls back to defaults', () => {
    expect(getRpcUrl({ rpcUrl: '' })).toBe(RPC_URLS.calibration.websocket)
  })

  it('throws for unsupported networks', () => {
    expect(() => getRpcUrl({ network: 'invalid' })).toThrow(
      'Invalid network: "invalid". Must be "mainnet" or "calibration"'
    )
  })
})