@bigmi/core 0.6.3-alpha.0 → 0.6.3-alpha.2

package/src/transports/blockcypher/__mocks__/getUTXOs/rateLimited.json

@@ -1,3 +0,0 @@
-{
-  "error": "Rate limit exceeded"
-}

package/src/transports/blockcypher/__mocks__/getUTXOs/valid.json

@@ -1,27 +0,0 @@
-{
-  "address": "bc1qpvk0kjdg0kantu9z78qz7gqk53q643auz33yaw",
-  "total_received": 190653,
-  "total_sent": 157447,
-  "balance": 33206,
-  "unconfirmed_balance": 0,
-  "final_balance": 33206,
-  "n_tx": 19,
-  "unconfirmed_n_tx": 0,
-  "final_n_tx": 19,
-  "txrefs": [
-    {
-      "tx_hash": "4b6ee974f1dd179071d027562e1fd1c83965efa4a171ec84f00b6c638e36fa4e",
-      "block_height": 897002,
-      "tx_input_n": -1,
-      "tx_output_n": 2,
-      "value": 33206,
-      "ref_balance": 80786,
-      "spent": false,
-      "confirmations": 526,
-      "confirmed": "2025-05-16T19:17:40Z",
-      "double_spend": false,
-      "script": "00140b2cfb49a87dbb35f0a2f1c02f2016a441aac7bc"
-    }
-  ],
-  "tx_url": "https://api.blockcypher.com/v1/btc/main/txs/"
-}

package/src/transports/blockcypher/blockcyper.spec.ts

@@ -1,161 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { getBalance } from '../../actions/getBalance.js'
-import { getTransactionFee } from '../../actions/getTransactionFee.js'
-import { getUTXOs } from '../../actions/getUTXOs.js'
-import { bitcoin } from '../../chains/bitcoin.js'
-import { InsufficientUTXOBalanceError } from '../../errors/utxo.js'
-import { createClient, rpcSchema } from '../../factories/createClient.js'
-import { createMockResponse } from '../../test/utils.js'
-import {
-  INVALID_TX_ID,
-  TX_FEE,
-  VALID_TX_ID,
-} from '../__mocks__/getTransactionFee.js'
-import type { UTXOSchema } from '../types.js'
-import getBalanceInValidResponse from './__mocks__/getBalance/invalid.json'
-import getBalanceValidResponse from './__mocks__/getBalance/valid.json'
-import getTransactionFeeInvalidResponse from './__mocks__/getTransactionFee/invalid.json'
-import getTransactionFeeValidResponse from './__mocks__/getTransactionFee/valid.json'
-import getUTXOsEmptyReponse from './__mocks__/getUTXOs/empty.json'
-import getUTXOsPaginatedReponse from './__mocks__/getUTXOs/paginated.json'
-import getUTXOsValidReponse from './__mocks__/getUTXOs/valid.json'
-import { blockcypher } from './blockcypher.js'
-import type {
-  BlockcypherBalanceResponse,
-  BlockcypherErrorResponse,
-  BlockcypherUTXOsResponse,
-} from './blockcypher.types.js'
-
-const apiKey = import.meta.env.VITE_TEST_BLOCKCYPHER_API_KEY
-
-const USE_MOCK = true
-
-const publicClient = createClient({
-  chain: bitcoin,
-  rpcSchema: rpcSchema<UTXOSchema>(),
-  transport: blockcypher({
-    apiKey,
-  }),
-})
-
-const address = import.meta.env.VITE_TEST_ADDRESS
-
-describe('Blockcypher Transport', () => {
-  beforeEach(() => {
-    vi.restoreAllMocks()
-  })
-
-  describe('getBalance action', () => {
-    it('should fetch correct balance', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(
-          getBalanceValidResponse as BlockcypherBalanceResponse
-        )
-      )
-      const balance = await getBalance(publicClient, { address })
-      expect(balance).toBeTypeOf('bigint')
-    })
-
-    it('should throw an error for invalid address response', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(
-          getBalanceInValidResponse as BlockcypherErrorResponse
-        )
-      )
-
-      const nonExistentAddress =
-        '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNaNUIBNSUENopnoidsacn'
-      await expect(
-        getBalance(publicClient, { address: nonExistentAddress })
-      ).rejects.toThrow()
-    })
-  })
-
-  describe('getUTXOs action', async () => {
-    it('should return utxos with correct structure', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(getUTXOsValidReponse as BlockcypherUTXOsResponse)
-      )
-      const utxos = await getUTXOs(publicClient, { address })
-      expect(utxos.length).toBeGreaterThan(0)
-      expect(utxos[0]).toMatchObject({
-        blockHeight: expect.any(Number),
-        scriptHex: expect.any(String),
-        txId: expect.any(String),
-        value: expect.any(Number),
-        vout: expect.any(Number),
-      })
-    })
-
-    it('should throw error when minValue exceeds balance', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(getUTXOsValidReponse as BlockcypherUTXOsResponse)
-      )
-      const hugeValue = 999999999999999999n
-      await expect(
-        getUTXOs(publicClient, {
-          address,
-          minValue: Number(hugeValue),
-        })
-      ).rejects.toThrow(InsufficientUTXOBalanceError)
-    })
-
-    it('should handle empty UTXO', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(getUTXOsEmptyReponse as BlockcypherBalanceResponse)
-      )
-      const emptyAddress = '12LRT14SgNFFQ3hMRThAyXNao24BBy5cyU'
-      const utxos = await getUTXOs(publicClient, { address: emptyAddress })
-      expect(utxos.length).toBe(0)
-    })
-
-    it('should handle pagination correcly', async () => {
-      const addressWithManyUTXOs = '1GrwDkr33gT6LuumniYjKEGjTLhsL5kmqC'
-      const minValue = 5_610_592_350
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(getUTXOsPaginatedReponse as BlockcypherUTXOsResponse)
-      )
-
-      const utxos = await getUTXOs(publicClient, {
-        address: addressWithManyUTXOs,
-        minValue,
-      })
-
-      expect(utxos.length).toBeGreaterThan(0)
-      expect(new Set(utxos.map((utxo) => utxo.txId)).size).toBe(utxos.length)
-      expect(global.fetch).toHaveBeenCalled()
-      const totalValue = utxos.reduce((sum, utxo) => sum + utxo.value, 0)
-      expect(totalValue).toBeGreaterThanOrEqual(minValue)
-    })
-  })
-
-  describe('getTransactionFee', () => {
-    it('should fetch correct transaction fee for valid transaction', async () => {
-      if (USE_MOCK) {
-        getTransactionFeeValidResponse.hash = VALID_TX_ID
-        getTransactionFeeValidResponse.fees = TX_FEE
-        vi.spyOn(global, 'fetch').mockResolvedValue(
-          createMockResponse(getTransactionFeeValidResponse)
-        )
-      }
-
-      const result = await getTransactionFee(publicClient, {
-        txId: VALID_TX_ID,
-      })
-      expect(result).toBeDefined()
-      expect(result).toBe(BigInt(TX_FEE))
-    })
-
-    it('should throw error for non-existent transaction', async () => {
-      if (USE_MOCK) {
-        vi.spyOn(global, 'fetch').mockResolvedValue(
-          createMockResponse(getTransactionFeeInvalidResponse)
-        )
-      }
-
-      await expect(
-        getTransactionFee(publicClient, { txId: INVALID_TX_ID })
-      ).rejects.toThrow()
-    })
-  })
-})

package/src/transports/fallback.spec.ts

@@ -1,128 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { getUTXOs } from '../actions/getUTXOs.js'
-import { bitcoin } from '../chains/bitcoin.js'
-import { AllTransportsFailedError } from '../errors/transport.js'
-import { InsufficientUTXOBalanceError } from '../errors/utxo.js'
-import { createClient, rpcSchema } from '../factories/createClient.js'
-import { createMockResponse } from '../test/utils.js'
-import blockchairZeroBalanceResponse from './blockchair/__mocks__/getBalance/zeroBalance.json'
-import blockchairLimitedResponse from './blockchair/__mocks__/getUTXOs/rateLimited.json'
-import blockchairValidResponse from './blockchair/__mocks__/getUTXOs/valid.json'
-import { blockchair } from './blockchair/blockchair.js'
-import blockcypherLimitedResponse from './blockcypher/__mocks__/getUTXOs/rateLimited.json'
-import blockcypherValidResponse from './blockcypher/__mocks__/getUTXOs/valid.json'
-import { blockcypher } from './blockcypher/blockcypher.js'
-import { fallback } from './fallback.js'
-import type { UTXOSchema } from './types.js'
-
-const address = import.meta.env.VITE_TEST_ADDRESS
-const apiKey = import.meta.env.VITE_TEST_BLOCKCHAIR_KEY
-const blockCypherKey = import.meta.env.VITE_TEST_BLOCKCYPHER_API_KEY
-
-const publicClient = createClient({
-  chain: bitcoin,
-  rpcSchema: rpcSchema<UTXOSchema>(),
-  transport: fallback([
-    blockcypher({ apiKey: blockCypherKey }),
-    blockchair({ apiKey }),
-  ]),
-})
-
-const blockchairFirstClient = createClient({
-  chain: bitcoin,
-  rpcSchema: rpcSchema<UTXOSchema>(),
-  transport: fallback([
-    blockchair({ apiKey }),
-    blockcypher({ apiKey: blockCypherKey }),
-  ]),
-})
-
-describe('Fallback Transport', () => {
-  beforeEach(() => {
-    vi.restoreAllMocks()
-  })
-
-  describe('getUTXOs', () => {
-    it('should use blockcypher when it succeeds', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(blockcypherValidResponse)
-      )
-
-      const utxos = await getUTXOs(publicClient, { address })
-      expect(utxos.length).toBeGreaterThan(0)
-    })
-
-    it('should fallback to blockchair when blockcypher fails', async () => {
-      vi.spyOn(global, 'fetch').mockImplementation((request) => {
-        const url = new URL(request.toString())
-        if (url.hostname.includes('blockcypher')) {
-          return Promise.resolve(
-            createMockResponse(blockcypherLimitedResponse, { status: 429 })
-          )
-        }
-
-        return Promise.resolve(createMockResponse(blockchairValidResponse))
-      })
-
-      const utxos = await getUTXOs(publicClient, { address })
-      expect(utxos.length).toBeGreaterThan(0)
-    })
-
-    it('blockchair first client should fallback to blockcypher when fetching with a zero balance address', async () => {
-      vi.spyOn(global, 'fetch').mockImplementation((request) => {
-        const url = new URL(request.toString())
-        if (url.hostname.includes('blockcypher')) {
-          return Promise.resolve(createMockResponse(blockcypherValidResponse))
-        }
-
-        return Promise.resolve(
-          createMockResponse(blockchairZeroBalanceResponse)
-        )
-      })
-      const utxos = await getUTXOs(blockchairFirstClient, { address })
-      expect(utxos.length).toBeGreaterThan(0)
-    })
-
-    it('should throw error when both transports fail', async () => {
-      vi.spyOn(global, 'fetch').mockImplementation((request) => {
-        const url = new URL(request.toString())
-        if (url.hostname.includes('blockcypher')) {
-          return Promise.resolve(
-            createMockResponse(blockcypherLimitedResponse, { status: 429 })
-          )
-        }
-        return Promise.resolve(
-          createMockResponse(blockchairLimitedResponse, { status: 429 })
-        )
-      })
-
-      await expect(getUTXOs(publicClient, { address })).rejects.toThrow(
-        AllTransportsFailedError
-      )
-    })
-
-    it('should not call blockchair if user has insufficientUTXOs', async () => {
-      const blockchairSpy = vi
-        .spyOn(global, 'fetch')
-        .mockImplementation((request) => {
-          const url = new URL(request.toString())
-          if (url.hostname.includes('blockcypher')) {
-            return Promise.resolve(createMockResponse(blockcypherValidResponse))
-          }
-
-          return Promise.resolve(createMockResponse(blockchairValidResponse))
-        })
-
-      await expect(
-        getUTXOs(publicClient, {
-          address,
-          minValue: 1000000,
-        })
-      ).rejects.toThrow(InsufficientUTXOBalanceError)
-
-      expect(blockchairSpy).not.toHaveBeenCalledWith(
-        expect.stringContaining('blockchair')
-      )
-    })
-  })
-})

package/src/transports/mempool/__mocks__/getBalance/invalid.json

@@ -1 +0,0 @@
-"Invalid Bitcoin address"

package/src/transports/mempool/__mocks__/getBalance/valid.json

@@ -1,17 +0,0 @@
-{
-  "address": "bc1qpvk0kjdg0kantu9z78qz7gqk53q643auz33yaw",
-  "chain_stats": {
-    "funded_txo_count": 18,
-    "funded_txo_sum": 424052,
-    "spent_txo_count": 17,
-    "spent_txo_sum": 390846,
-    "tx_count": 19
-  },
-  "mempool_stats": {
-    "funded_txo_count": 0,
-    "funded_txo_sum": 0,
-    "spent_txo_count": 0,
-    "spent_txo_sum": 0,
-    "tx_count": 0
-  }
-}

package/src/transports/mempool/__mocks__/getTransactionFee/invalid.json

@@ -1 +0,0 @@
-"Invalid hex string"

package/src/transports/mempool/__mocks__/getTransactionFee/valid.json

@@ -1,58 +0,0 @@
-{
-  "txid": "4b6ee974f1dd179071d027562e1fd1c83965efa4a171ec84f00b6c638e36fa4e",
-  "version": 2,
-  "locktime": 0,
-  "vin": [
-    {
-      "txid": "e77cbe6d061f43672968834bce324a1984797f5cfbb463697df238bd385917be",
-      "vout": 0,
-      "prevout": {
-        "scriptpubkey": "00140b2cfb49a87dbb35f0a2f1c02f2016a441aac7bc",
-        "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 0b2cfb49a87dbb35f0a2f1c02f2016a441aac7bc",
-        "scriptpubkey_type": "v0_p2wpkh",
-        "scriptpubkey_address": "bc1qpvk0kjdg0kantu9z78qz7gqk53q643auz33yaw",
-        "value": 47580
-      },
-      "scriptsig": "",
-      "scriptsig_asm": "",
-      "witness": [
-        "3045022100f7f01395cd1522fa63977f658bc72410a59e576b35cbf2a606dad1ed98e9c01402201d7994777edf3967ea2cf90e9f95eb9b9b5e6635aa934defb0094f7b313609e301",
-        "025873f7163097c81372cb414f25e79204a422fbcf43495a18d8043466fd4e7c99"
-      ],
-      "is_coinbase": false,
-      "sequence": 4294967293
-    }
-  ],
-  "vout": [
-    {
-      "scriptpubkey": "001496d086eea328c1648231a3bca6f395f44fa95dae",
-      "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 96d086eea328c1648231a3bca6f395f44fa95dae",
-      "scriptpubkey_type": "v0_p2wpkh",
-      "scriptpubkey_address": "bc1qjmggdm4r9rqkfq335w72duu47386jhdw6wye0m",
-      "value": 10000
-    },
-    {
-      "scriptpubkey": "6a473d3a613a3078424435354332463330364339374664316433453741303233663763343833346132463437323833343a3a6c6966692f2d5f3a302f32307c30783134323835626439",
-      "scriptpubkey_asm": "OP_RETURN OP_PUSHBYTES_71 3d3a613a3078424435354332463330364339374664316433453741303233663763343833346132463437323833343a3a6c6966692f2d5f3a302f32307c30783134323835626439",
-      "scriptpubkey_type": "op_return",
-      "value": 0
-    },
-    {
-      "scriptpubkey": "00140b2cfb49a87dbb35f0a2f1c02f2016a441aac7bc",
-      "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 0b2cfb49a87dbb35f0a2f1c02f2016a441aac7bc",
-      "scriptpubkey_type": "v0_p2wpkh",
-      "scriptpubkey_address": "bc1qpvk0kjdg0kantu9z78qz7gqk53q643auz33yaw",
-      "value": 33206
-    }
-  ],
-  "size": 305,
-  "weight": 890,
-  "sigops": 1,
-  "fee": 4374,
-  "status": {
-    "confirmed": true,
-    "block_height": 897002,
-    "block_hash": "00000000000000000000aa525233832b8fcf408b8de79677c994b3a014686134",
-    "block_time": 1747423060
-  }
-}