@bigmi/core 0.4.0 → 0.4.3

package/src/transports/blockchair/blockchair.spec.ts

@@ -47,20 +47,24 @@ describe('Blockchair Transport', () => {
 
   describe('getBalance', () => {
     it('should fetch correct balance for valid address', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(getBalanceReponse as BlockchairAddressBalanceData)
-      )
+      if (USE_MOCK) {
+        vi.spyOn(global, 'fetch').mockResolvedValue(
+          createMockResponse(getBalanceReponse as BlockchairAddressBalanceData)
+        )
+      }
 
       const balance = await getBalance(publicClient, { address })
       expect(balance).toBeTypeOf('bigint')
     })
 
     it('should throw error for non-existent address', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(
-          getInvalidBalanceReponse as BlockchairAddressBalanceData
+      if (USE_MOCK) {
+        vi.spyOn(global, 'fetch').mockResolvedValue(
+          createMockResponse(
+            getInvalidBalanceReponse as BlockchairAddressBalanceData
+          )
         )
-      )
+      }
 
       const nonExistentAddress =
         '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNaNUIBNSUENopnoidsacn'
@@ -72,11 +76,13 @@ describe('Blockchair Transport', () => {
 
   describe('getUTXOs', () => {
     it('should return utxos with correct structure', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(
-          getUTXOsResponse as BlockchairResponse<BlockChairDashboardAddressResponse>
+      if (USE_MOCK) {
+        vi.spyOn(global, 'fetch').mockResolvedValue(
+          createMockResponse(
+            getUTXOsResponse as BlockchairResponse<BlockChairDashboardAddressResponse>
+          )
         )
-      )
+      }
 
       const utxos = await getUTXOs(publicClient, { address })
 
@@ -91,27 +97,29 @@ describe('Blockchair Transport', () => {
     })
 
     it('should throw error when minValue exceeds balance', async () => {
-      vi.spyOn(global, 'fetch').mockImplementation((request) => {
-        const url = new URL(request.toString())
+      if (USE_MOCK) {
+        vi.spyOn(global, 'fetch').mockImplementation((request) => {
+          const url = new URL(request.toString())
 
-        if (url.pathname.includes('/addresses/balances')) {
-          return Promise.resolve(
-            createMockResponse(
-              getBalanceReponse as BlockchairAddressBalanceData
+          if (url.pathname.includes('/addresses/balances')) {
+            return Promise.resolve(
+              createMockResponse(
+                getBalanceReponse as BlockchairAddressBalanceData
+              )
             )
-          )
-        }
+          }
 
-        if (url.pathname.includes('/dashboards/addresses')) {
-          return Promise.resolve(
-            createMockResponse(
-              getUTXOsResponse as BlockchairResponse<BlockChairDashboardAddressResponse>
+          if (url.pathname.includes('/dashboards/addresses')) {
+            return Promise.resolve(
+              createMockResponse(
+                getUTXOsResponse as BlockchairResponse<BlockChairDashboardAddressResponse>
+              )
             )
-          )
-        }
+          }
 
-        throw new BaseError(`Unexpected URL: ${url.pathname}`)
-      })
+          throw new BaseError(`Unexpected URL: ${url.pathname}`)
+        })
+      }
 
       const hugeValue = 999999999999999999n
       await expect(
@@ -123,14 +131,26 @@ describe('Blockchair Transport', () => {
     })
 
     it('should handle empty UTXO response', async () => {
-      vi.spyOn(global, 'fetch').mockResolvedValue(
-        createMockResponse(getUTXOsInvalidResponse as BlockchairResponse<null>)
-      )
+      if (USE_MOCK) {
+        vi.spyOn(global, 'fetch').mockResolvedValue(
+          createMockResponse(
+            getUTXOsInvalidResponse as BlockchairResponse<null>
+          )
+        )
+      }
 
       const emptyAddress = '12LRT14SgNFFQ3hMRThAyXNao24BBy5cyU'
-      const utxos = await getUTXOs(publicClient, { address: emptyAddress })
 
-      expect(utxos.length).toBe(0)
+      if (USE_MOCK) {
+        const utxos = await getUTXOs(publicClient, { address: emptyAddress })
+        expect(utxos.length).toBe(0)
+      } else {
+        await expect(
+          getUTXOs(publicClient, { address: emptyAddress })
+        ).rejects.toMatchObject({
+          status: 404,
+        })
+      }
     })
 
     describe('pagination', () => {
@@ -155,37 +175,39 @@ describe('Blockchair Transport', () => {
       })
 
       it('should handle pagination correctly', async () => {
-        vi.spyOn(global, 'fetch').mockImplementation((request) => {
-          const url = new URL(request.toString())
-
-          if (url.pathname.includes('/addresses/balances')) {
-            return Promise.resolve(
-              createMockResponse({
-                data: {
-                  [addressWithManyUTXOs]: 1000000000000,
-                },
-                context: { code: 200 },
-              } as BlockchairResponse<BlockchairAddressBalanceData>)
-            )
-          }
+        if (USE_MOCK) {
+          vi.spyOn(global, 'fetch').mockImplementation((request) => {
+            const url = new URL(request.toString())
+
+            if (url.pathname.includes('/addresses/balances')) {
+              return Promise.resolve(
+                createMockResponse({
+                  data: {
+                    [addressWithManyUTXOs]: 1000000000000,
+                  },
+                  context: { code: 200 },
+                } as BlockchairResponse<BlockchairAddressBalanceData>)
+              )
+            }
 
-          if (url.pathname.includes('/dashboards/addresses')) {
-            const offset = Number.parseInt(
-              url.searchParams.get('offset')?.split(',')[1] || '0'
-            )
-            const limit = 100
-            return Promise.resolve(
-              createMockResponse(
-                createPaginatedMockResponse(
-                  offset,
-                  limit
-                ) as BlockchairResponse<BlockChairDashboardAddressResponse>
+            if (url.pathname.includes('/dashboards/addresses')) {
+              const offset = Number.parseInt(
+                url.searchParams.get('offset')?.split(',')[1] || '0'
               )
-            )
-          }
+              const limit = 100
+              return Promise.resolve(
+                createMockResponse(
+                  createPaginatedMockResponse(
+                    offset,
+                    limit
+                  ) as BlockchairResponse<BlockChairDashboardAddressResponse>
+                )
+              )
+            }
 
-          throw new BaseError(`Unexpected URL: ${url.pathname}`)
-        })
+            throw new BaseError(`Unexpected URL: ${url.pathname}`)
+          })
+        }
 
         const utxos = await getUTXOs(publicClient, {
           address: addressWithManyUTXOs,
@@ -194,7 +216,9 @@ describe('Blockchair Transport', () => {
 
         expect(utxos.length).toBeGreaterThan(0)
         expect(new Set(utxos.map((utxo) => utxo.txId)).size).toBe(utxos.length)
-        expect(global.fetch).toHaveBeenCalled()
+        if (USE_MOCK) {
+          expect(global.fetch).toHaveBeenCalled()
+        }
 
         const totalValue = utxos.reduce((sum, utxo) => sum + utxo.value, 0)
         expect(totalValue).toBeGreaterThanOrEqual(minValue)

package/src/transports/blockchair/blockchair.ts

@@ -1,4 +1,3 @@
-import type { TransportConfig } from '../../types/transport.js'
 import type { HttpTransportConfig } from '../http.js'
 import type { UTXOMethod } from '../types.js'
 import { utxo } from '../utxo.js'
@@ -11,6 +10,7 @@ type BlockchairConfig = {
 
 export const blockchair = (config?: BlockchairConfig) =>
   utxo(config?.baseUrl || 'https://api.blockchair.com', {
+    name: 'Blockchair API',
     key: 'blockchair',
     includeChainToURL: true,
     methods: {

package/src/transports/blockchair/getBalance.ts

@@ -1,3 +1,4 @@
+import { RpcErrorCode } from '../../errors/rpc.js'
 import { urlWithParams } from '../../utils/url.js'
 import type { RpcMethodHandler } from '../types.js'
 import type {
@@ -18,10 +19,17 @@ export const getBalance: RpcMethodHandler<'getBalance'> = async (
     url: apiUrl,
     fetchOptions: { method: 'GET' },
   })) as unknown as BlockchairResponse<BlockchairAddressBalanceData>
-  if (response.context?.code !== 200) {
+  if (
+    response.data[address] === undefined ||
+    response.context.error ||
+    response.context?.code !== 200
+  ) {
     return {
       error: {
-        code: response.context?.code,
+        code:
+          response.context.code === 429
+            ? RpcErrorCode.ACCESS_DENIED
+            : RpcErrorCode.MISC_ERROR,
         message: response.context?.error,
       },
     }

package/src/transports/blockchair/getTransactionFee.ts

@@ -1,3 +1,4 @@
+import { RpcErrorCode } from '../../errors/rpc.js'
 import { urlWithParams } from '../../utils/url.js'
 import type { RpcMethodHandler } from '../types.js'
 import type { BlockchairTransactionResponse } from './blockchair.types.js'
@@ -17,10 +18,17 @@ export const getTransactionFee: RpcMethodHandler<'getTransactionFee'> = async (
     },
   })) as unknown as BlockchairTransactionResponse
 
-  if (response.context?.code !== 200) {
+  if (
+    !response.data[txId] ||
+    response.context.error ||
+    response.context?.code !== 200
+  ) {
     return {
       error: {
-        code: response.context?.code,
+        code:
+          response.context.code === 429
+            ? RpcErrorCode.ACCESS_DENIED
+            : RpcErrorCode.MISC_ERROR,
         message: response.context?.error,
       },
     }

package/src/transports/blockchair/getUTXOs.ts

@@ -1,4 +1,5 @@
 import { RpcRequestError } from '../../errors/request.js'
+import { RpcErrorCode } from '../../errors/rpc.js'
 import { InsufficientUTXOBalanceError } from '../../errors/utxo.js'
 import type { UTXO } from '../../types/transaction.js'
 
@@ -57,7 +58,10 @@ export const getUTXOs: RpcMethodHandler<'getUTXOs'> = async (
             },
           },
           error: {
-            code: response.context.code,
+            code:
+              response.context.code === 429
+                ? RpcErrorCode.ACCESS_DENIED
+                : RpcErrorCode.MISC_ERROR,
             message: response.context.error || 'Error fetching utxos',
           },
         })

package/src/transports/blockcypher/blockcypher.ts

@@ -10,6 +10,7 @@ type BlockcypherConfig = {
 
 export const blockcypher = (config?: BlockcypherConfig) =>
   utxo(config?.baseUrl || 'https://api.blockcypher.com/v1/btc/main', {
+    name: 'Blockcypher API',
     key: 'blockcypher',
     methods: {
       include: Object.keys(blockcypherMethods) as UTXOMethod[],

package/src/transports/blockcypher/getBalance.ts

@@ -1,6 +1,7 @@
 import { urlWithParams } from '../../utils/url.js'
 import type { RpcMethodHandler } from '../types.js'
 import type { BlockcypherBalanceResponse } from './blockcypher.types.js'
+import { getRpcErrorCode } from './utils.js'
 
 export const getBalance: RpcMethodHandler<'getBalance'> = async (
   client,
@@ -16,7 +17,10 @@ export const getBalance: RpcMethodHandler<'getBalance'> = async (
   })) as unknown as BlockcypherBalanceResponse
   if (response.error) {
     return {
-      error: { code: -1, message: response.error },
+      error: {
+        code: getRpcErrorCode(response.error),
+        message: response.error,
+      },
     }
   }
   return {

package/src/transports/blockcypher/getTransactionFee.ts

@@ -1,6 +1,7 @@
 import { urlWithParams } from '../../utils/url.js'
 import type { RpcMethodHandler } from '../types.js'
 import type { BlockcypherTransactionReponse } from './blockcypher.types.js'
+import { getRpcErrorCode } from './utils.js'
 
 export const getTransactionFee: RpcMethodHandler<'getTransactionFee'> = async (
   client,
@@ -18,7 +19,7 @@ export const getTransactionFee: RpcMethodHandler<'getTransactionFee'> = async (
 
   if (response.error) {
     return {
-      error: { code: -1, message: response.error },
+      error: { code: getRpcErrorCode(response.error), message: response.error },
     }
   }
 

package/src/transports/blockcypher/getUTXOs.ts

@@ -7,6 +7,7 @@ import type {
   BlockcypherUTXO,
   BlockcypherUTXOsResponse,
 } from './blockcypher.types.js'
+import { getRpcErrorCode } from './utils.js'
 
 const blockcypherUTXOTransformer = (utxo: BlockcypherUTXO): UTXO => ({
   blockHeight: utxo.block_height,
@@ -27,7 +28,7 @@ export const getUTXOs: RpcMethodHandler<'getUTXOs'> = async (
 ) => {
   async function* fetchUTXOs() {
     let hasMore = true
-    let beforeBlock = undefined
+    let beforeBlock: number | undefined
 
     while (hasMore) {
       const apiUrl = urlWithParams(`${baseUrl}/addrs/${address}`, {
@@ -53,7 +54,7 @@ export const getUTXOs: RpcMethodHandler<'getUTXOs'> = async (
             },
           },
           error: {
-            code: -1,
+            code: getRpcErrorCode(response.error),
             message: response.error,
           },
         })

package/src/transports/blockcypher/utils.ts

@@ -0,0 +1,8 @@
+import { RpcErrorCode } from '../../errors/rpc.js'
+
+export function getRpcErrorCode(error: string): RpcErrorCode {
+  if (error.toLowerCase().startsWith('rate limit exceeded')) {
+    return RpcErrorCode.ACCESS_DENIED
+  }
+  return RpcErrorCode.MISC_ERROR
+}

package/src/transports/custom.ts

@@ -23,7 +23,7 @@ export type CustomTransportConfig = {
 
 export type CustomTransport = Transport<
   'custom',
-  // biome-ignore lint/complexity/noBannedTypes: <explanation>
+  // biome-ignore lint/complexity/noBannedTypes: part of the types
   {},
   BitcoinProvider['request']
 >

package/src/transports/fallback.ts

@@ -43,9 +43,9 @@ type RankOptions = {
   /**
    * Ping method to determine latency.
    */
-  ping?: (parameters: { transport: ReturnType<Transport> }) =>
-    | Promise<unknown>
-    | undefined
+  ping?: (parameters: {
+    transport: ReturnType<Transport>
+  }) => Promise<unknown> | undefined
   /**
    * The number of previous samples to perform ranking on.
    * @default 10

package/src/transports/getHttpRpcClient.ts

@@ -98,7 +98,11 @@ export function getHttpRpcClient(
             return response
           },
           {
-            errorInstance: new TimeoutError({ body: body ?? {}, url }),
+            errorInstance: new TimeoutError({
+              body: body ?? {},
+              url: params.url ?? url,
+              timeout,
+            }),
             timeout,
             signal: true,
           }

package/src/transports/http.ts

@@ -13,9 +13,9 @@ import type {
 } from '../types/transport.js'
 import { createBatchScheduler } from '../utils/createBatchScheduler.js'
 import {
+  getHttpRpcClient,
   type HttpRpcClientOptions,
   type RpcRequest,
-  getHttpRpcClient,
 } from './getHttpRpcClient.js'
 import { UTXOAPISchemaMethods } from './types.js'
 

package/src/transports/mempool/mempool.spec.ts

@@ -1,18 +1,17 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 import { getBalance } from '../../actions/getBalance'
+import { getTransactionFee } from '../../actions/getTransactionFee'
 import { getTransactions } from '../../actions/getTransactions'
 import { bitcoin } from '../../chains/bitcoin'
+import { BaseError } from '../../errors/base'
 import { createClient, rpcSchema } from '../../factories/createClient'
 import { createMockResponse } from '../../test/utils'
-import type { UTXOSchema } from '../types'
-
-import { getTransactionFee } from '../../actions/getTransactionFee'
-import { BaseError } from '../../errors/base'
 import {
   INVALID_TX_ID,
   TX_FEE,
   VALID_TX_ID,
 } from '../__mocks__/getTransactionFee'
+import type { UTXOSchema } from '../types'
 import getBalanceInValidResponse from './__mocks__/getBalance/invalid.json'
 import getBalanceValidResponse from './__mocks__/getBalance/valid.json'
 import getTransactionFeeInvalidResponse from './__mocks__/getTransactionFee/invalid.json'

package/src/transports/mempool/mempool.ts

@@ -9,6 +9,7 @@ type MempoolConfig = {
 
 export const mempool = (config?: MempoolConfig) =>
   utxo(config?.baseUrl || 'https://mempool.space/api', {
+    name: 'Mempool.space API',
     key: 'mempool',
     methods: {
       include: Object.keys(mempoolMethods) as UTXOMethod[],

package/src/utils/cancelTransaction.ts

@@ -1,4 +1,4 @@
-import { Psbt, address } from 'bitcoinjs-lib'
+import { address, Psbt } from 'bitcoinjs-lib'
 
 interface InputData {
   hash: Uint8Array

package/src/utils/deepEqual.ts

@@ -40,7 +40,7 @@ export function deepEqual(a: any, b: any) {
     }
 
     for (i = length; i-- !== 0; ) {
-      if (!Object.prototype.hasOwnProperty.call(b, keys[i]!)) {
+      if (!Object.hasOwn(b, keys[i]!)) {
         return false
       }
     }
@@ -57,6 +57,6 @@ export function deepEqual(a: any, b: any) {
   }
 
   // true if both NaN, false otherwise
-  // biome-ignore lint/suspicious/noSelfCompare: <explanation>
+  // biome-ignore lint/suspicious/noSelfCompare: allowed in utils
   return a !== a && b !== b
 }

package/src/utils/getAction.ts

@@ -1,11 +1,10 @@
 import type { PublicActions } from '../clients/decorators/public.js'
 import type { WalletActions } from '../clients/decorators/wallet.js'
 import type { UTXOSchema } from '../transports/types.js'
-import type { Client } from '../types/client.js'
-import type { Transport } from '../types/transport.js'
-
 import type { Account } from '../types/account.js'
 import type { Chain } from '../types/chain.js'
+import type { Client } from '../types/client.js'
+import type { Transport } from '../types/transport.js'
 
 /**
  * Retrieves and returns an action from the client (if exists), and falls

package/src/utils/getAddressInfo.ts

@@ -1,5 +1,5 @@
 import { sha256 } from '@noble/hashes/sha256'
-import { type Decoded, bech32, bech32m } from 'bech32'
+import { bech32, bech32m, type Decoded } from 'bech32'
 import bs58 from 'bs58'
 
 import {

package/src/utils/modifyFee.ts

@@ -1,4 +1,4 @@
-import { Psbt, address } from 'bitcoinjs-lib'
+import { address, Psbt } from 'bitcoinjs-lib'
 
 interface InputData {
   hash: Uint8Array

package/src/utils/poll.ts

@@ -23,7 +23,7 @@ export function poll<T>(
   }
 
   const watch = async () => {
-    let data: T | undefined = undefined
+    let data: T | undefined
     if (emitOnBegin) {
       data = await fn({ unpoll: unwatch })
     }

package/src/utils/withTimeout.ts

@@ -5,7 +5,9 @@ export type WithTimeoutErrorType = ErrorType
 export function withTimeout<data>(
   fn: ({
     signal,
-  }: { signal: AbortController['signal'] | null }) => Promise<data>,
+  }: {
+    signal: AbortController['signal'] | null
+  }) => Promise<data>,
   {
     errorInstance = new Error('timed out'),
     timeout,

package/src/version.ts

@@ -1,2 +1,2 @@
 export const name = '@bigmi/core'
-export const version = '0.4.0'
+export const version = '0.4.3'