@ledgerhq/coin-tezos 7.12.0 → 9.0.0

package/src/logic/getBlock.ts

@@ -1,6 +1,7 @@
 // SPDX-FileCopyrightText: © 2026 LEDGER SAS
 // SPDX-License-Identifier: Apache-2.0
 
+import type { TezosContext } from '../config'
 import type {
   APIBlock,
   APIDelegationType,
@@ -19,13 +20,13 @@ import type {
 } from '@ledgerhq/coin-module-framework/api/index'
 import { STAKING_ACTION_TO_OP_TYPE } from '../constants'
 import {
+  createTzktApi,
   fetchBlockDelegations,
   fetchBlockOriginations,
   fetchBlockReveals,
   fetchBlockStaking,
   fetchBlockTokenTransfers,
   fetchBlockTransactions,
-  tzkt,
 } from '../network'
 
 const NATIVE_ASSET: AssetInfo = { type: 'native', name: 'XTZ' }
@@ -514,11 +515,13 @@ function groupAndMapTransactions(
  * - Appends FA token transfer operations to the owning BlockTransaction when a
  *   matching `transactionId` can be resolved; otherwise creates a standalone entry.
  */
-export async function getBlock(height: number): Promise<Block> {
+export async function getBlock(context: TezosContext, height: number): Promise<Block> {
   if (!Number.isSafeInteger(height) || height <= 0) {
     throw new Error(`getBlock: height must be a positive integer, got ${height}`)
   }
 
+  const config = await context.config()
+  const tzkt = createTzktApi(config)
   const [
     block,
     parentBlock,
@@ -531,12 +534,12 @@ export async function getBlock(height: number): Promise<Block> {
   ] = await Promise.all([
     tzkt.getBlockByLevel(height),
     tzkt.getBlockByLevel(height - 1),
-    fetchBlockTransactions(height),
-    fetchBlockTokenTransfers(height),
-    fetchBlockDelegations(height),
-    fetchBlockStaking(height),
-    fetchBlockOriginations(height),
-    fetchBlockReveals(height),
+    fetchBlockTransactions(config, height),
+    fetchBlockTokenTransfers(config, height),
+    fetchBlockDelegations(config, height),
+    fetchBlockStaking(config, height),
+    fetchBlockOriginations(config, height),
+    fetchBlockReveals(config, height),
   ])
 
   // Token transfers triggered by originations from other blocks carry an

package/src/logic/getBlockInfo.integ.test.ts

@@ -1,8 +1,7 @@
 // SPDX-FileCopyrightText: © 2026 LEDGER SAS
 // SPDX-License-Identifier: Apache-2.0
 
-import type { TezosCoinConfig } from '../config'
-import coinConfig from '../config'
+import type { TezosCoinConfig, TezosContext } from '../config'
 import { getBlock } from './getBlock'
 import { getBlockInfo } from './getBlockInfo'
 
@@ -15,8 +14,6 @@ import { getBlockInfo } from './getBlockInfo'
  * consistent, independently verifiable data.
  */
 
-let originalGetCoinConfig: () => TezosCoinConfig
-
 const shadownetConfig = (): TezosCoinConfig =>
   ({
     status: { type: 'active' },
@@ -32,20 +29,14 @@ const shadownetConfig = (): TezosCoinConfig =>
     },
   }) as TezosCoinConfig
 
-describe('getBlockInfo', () => {
-  beforeAll(() => {
-    originalGetCoinConfig = coinConfig.getCoinConfig
-    coinConfig.setCoinConfig(shadownetConfig)
-  })
-
-  afterAll(() => {
-    if (originalGetCoinConfig) {
-      coinConfig.setCoinConfig(originalGetCoinConfig)
-    }
-  })
+const context: TezosContext = {
+  config: async () => shadownetConfig(),
+  logger: () => undefined,
+}
 
+describe('getBlockInfo', () => {
   it('should fetch and parse block info for block 3113219 correctly', async () => {
-    const blockInfo = await getBlockInfo(3113219)
+    const blockInfo = await getBlockInfo(context, 3113219)
 
     expect(blockInfo).toMatchObject({
       height: 3113219,
@@ -59,8 +50,8 @@ describe('getBlockInfo', () => {
   })
 
   it('should return consistent data with getBlock for the same block', async () => {
-    const blockInfo = await getBlockInfo(3113219)
-    const block = await getBlock(3113219)
+    const blockInfo = await getBlockInfo(context, 3113219)
+    const block = await getBlock(context, 3113219)
 
     expect(blockInfo).toMatchObject({
       height: block.info.height,

package/src/logic/getBlockInfo.test.ts

@@ -1,10 +1,20 @@
 // SPDX-FileCopyrightText: © 2026 LEDGER SAS
 // SPDX-License-Identifier: Apache-2.0
 
-import tzktApi from '../network/tzkt'
+import type { TezosCoinConfig, TezosContext } from '../config'
 import { getBlockInfo } from './getBlockInfo'
 
-const mockGetBlockByLevel = jest.spyOn(tzktApi, 'getBlockByLevel')
+const mockGetBlockByLevel = jest.fn()
+jest.mock('../network', () => ({
+  createTzktApi: () => ({
+    getBlockByLevel: (...args: unknown[]) => mockGetBlockByLevel(...args),
+  }),
+}))
+
+const context: TezosContext = {
+  config: async () => ({}) as unknown as TezosCoinConfig,
+  logger: () => undefined,
+}
 
 describe('getBlockInfo', () => {
   beforeEach(() => {
@@ -26,7 +36,7 @@ describe('getBlockInfo', () => {
     } as any)
 
     // When
-    const result = await getBlockInfo(level)
+    const result = await getBlockInfo(context, level)
 
     // Then
     expect(mockGetBlockByLevel).toHaveBeenCalledTimes(2)
@@ -50,7 +60,7 @@ describe('getBlockInfo', () => {
     } as any)
 
     // When
-    const result = await getBlockInfo(8_000_000)
+    const result = await getBlockInfo(context, 8_000_000)
 
     // Then
     expect(result.time).toBeInstanceOf(Date)
@@ -59,7 +69,7 @@ describe('getBlockInfo', () => {
 
   it('throws for height = 0 without calling the API', async () => {
     // When / Then
-    await expect(getBlockInfo(0)).rejects.toThrow(
+    await expect(getBlockInfo(context, 0)).rejects.toThrow(
       'getBlockInfo: height must be a positive integer, got 0'
     )
     expect(mockGetBlockByLevel).not.toHaveBeenCalled()
@@ -67,7 +77,7 @@ describe('getBlockInfo', () => {
 
   it('throws for negative height without calling the API', async () => {
     // When / Then
-    await expect(getBlockInfo(-5)).rejects.toThrow(
+    await expect(getBlockInfo(context, -5)).rejects.toThrow(
       'getBlockInfo: height must be a positive integer, got -5'
     )
     expect(mockGetBlockByLevel).not.toHaveBeenCalled()
@@ -76,7 +86,7 @@ describe('getBlockInfo', () => {
   it.each([NaN, 1.5, Infinity, -Infinity])(
     'throws for non-safe-integer height (%s) without calling the API',
     async (height) => {
-      await expect(getBlockInfo(height)).rejects.toThrow(
+      await expect(getBlockInfo(context, height)).rejects.toThrow(
         'getBlockInfo: height must be a positive integer'
       )
       expect(mockGetBlockByLevel).not.toHaveBeenCalled()
@@ -97,7 +107,7 @@ describe('getBlockInfo', () => {
     } as any)
 
     // When
-    const result = await getBlockInfo(1)
+    const result = await getBlockInfo(context, 1)
 
     // Then
     expect(result.parent).toEqual({ height: 0, hash: 'BLGenesis' })
@@ -108,6 +118,6 @@ describe('getBlockInfo', () => {
     mockGetBlockByLevel.mockRejectedValue(new Error('TzKT unreachable'))
 
     // When / Then
-    await expect(getBlockInfo(999_999)).rejects.toThrow('TzKT unreachable')
+    await expect(getBlockInfo(context, 999_999)).rejects.toThrow('TzKT unreachable')
   })
 })

package/src/logic/getBlockInfo.ts

@@ -1,8 +1,9 @@
 // SPDX-FileCopyrightText: © 2026 LEDGER SAS
 // SPDX-License-Identifier: Apache-2.0
 
+import type { TezosContext } from '../config'
 import type { BlockInfo } from '@ledgerhq/coin-module-framework/api/index'
-import { tzkt } from '../network'
+import { createTzktApi } from '../network'
 
 /**
  * Returns lightweight metadata for a Tezos block at the given level.
@@ -10,11 +11,13 @@ import { tzkt } from '../network'
  * Fetches the block and its predecessor in parallel so that `BlockInfo.parent`
  * is always populated without adding serial latency.
  */
-export async function getBlockInfo(height: number): Promise<BlockInfo> {
+export async function getBlockInfo(context: TezosContext, height: number): Promise<BlockInfo> {
   if (!Number.isSafeInteger(height) || height <= 0) {
     throw new Error(`getBlockInfo: height must be a positive integer, got ${height}`)
   }
 
+  const config = await context.config()
+  const tzkt = createTzktApi(config)
   const [block, parentBlock] = await Promise.all([
     tzkt.getBlockByLevel(height),
     tzkt.getBlockByLevel(height - 1),

package/src/logic/getStakes.test.ts

@@ -1,26 +1,37 @@
 // SPDX-FileCopyrightText: © 2026 LEDGER SAS
 // SPDX-License-Identifier: Apache-2.0
 
-import { createApi } from '../api/index'
-import coinConfig from '../config'
-import tzktApi from '../network/tzkt'
+import type { TezosCoinConfig, TezosContext } from '../config'
+import { getStakes } from './getStakes'
+
+const mockGetAccountByAddress = jest.fn()
+const mockGetUnstakeRequests = jest.fn()
+jest.mock('../network/tzkt', () => ({
+  __esModule: true,
+  createTzktApi: () => ({
+    getAccountByAddress: (...args: unknown[]) => mockGetAccountByAddress(...args),
+    getUnstakeRequests: (...args: unknown[]) => mockGetUnstakeRequests(...args),
+  }),
+}))
 
 describe('getStakes', () => {
-  const api = createApi({
-    baker: { url: 'http://baker.example.com' },
-    explorer: { url: 'http://tezos.explorer.com', maxTxQuery: 100 },
-    node: { url: 'http://tezos.node.com' },
-    fees: {
-      minGasLimit: 600,
-      minRevealGasLimit: 300,
-      minStorageLimit: 0,
-      minFees: 500,
-      minEstimatedFees: 500,
-    },
-  })
-
-  const mockGetAccountByAddress = jest.spyOn(tzktApi, 'getAccountByAddress')
-  const mockGetUnstakeRequests = jest.spyOn(tzktApi, 'getUnstakeRequests')
+  const context: TezosContext = {
+    config: async () =>
+      ({
+        status: { type: 'active' },
+        baker: { url: 'http://baker.example.com' },
+        explorer: { url: 'http://tezos.explorer.com', maxTxQuery: 100 },
+        node: { url: 'http://tezos.node.com' },
+        fees: {
+          minGasLimit: 600,
+          minRevealGasLimit: 300,
+          minStorageLimit: 0,
+          minFees: 500,
+          minEstimatedFees: 500,
+        },
+      }) as unknown as TezosCoinConfig,
+    logger: () => undefined,
+  }
 
   const makeRequest = (
     overrides: Partial<{
@@ -45,20 +56,6 @@ describe('getStakes', () => {
   beforeEach(() => {
     jest.clearAllMocks()
     mockGetUnstakeRequests.mockResolvedValue([])
-
-    coinConfig.setCoinConfig(() => ({
-      status: { type: 'active' },
-      baker: { url: 'http://baker.example.com' },
-      explorer: { url: 'http://tezos.explorer.com', maxTxQuery: 100 },
-      node: { url: 'http://tezos.node.com' },
-      fees: {
-        minGasLimit: 600,
-        minRevealGasLimit: 300,
-        minStorageLimit: 0,
-        minFees: 500,
-        minEstimatedFees: 500,
-      },
-    }))
   })
 
   describe('account types', () => {
@@ -76,7 +73,7 @@ describe('getStakes', () => {
         firstActivityTime: '2021-01-01T00:00:00Z',
       })
 
-      const result = await api.getStakes('tz1WvvbEGpBXGeTVbLiR6DYBe1izmgiYuZbq')
+      const result = await getStakes(context, 'tz1WvvbEGpBXGeTVbLiR6DYBe1izmgiYuZbq')
 
       expect(result.items).toEqual([])
     })
@@ -88,7 +85,7 @@ describe('getStakes', () => {
         counter: 0,
       })
 
-      const result = await api.getStakes('tz1EmptyAccount')
+      const result = await getStakes(context, 'tz1EmptyAccount')
 
       expect(result.items).toEqual([])
     })
@@ -109,7 +106,7 @@ describe('getStakes', () => {
         firstActivityTime: '2021-01-01T00:00:00Z',
       })
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -143,7 +140,7 @@ describe('getStakes', () => {
         makeRequest({ id: 42, bakerAddress, actualAmount: 10, firstTime: '2026-05-01T00:00:00Z' }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -184,7 +181,7 @@ describe('getStakes', () => {
     it('should return delegation stake for delegated account with no staking', async () => {
       mockGetAccountByAddress.mockResolvedValue(makeAccount())
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -202,7 +199,7 @@ describe('getStakes', () => {
     it('should handle account with zero balance but delegation', async () => {
       mockGetAccountByAddress.mockResolvedValue(makeAccount({ balance: 0 }))
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -220,7 +217,7 @@ describe('getStakes', () => {
     it('should return delegation + stake when stakedBalance > 0', async () => {
       mockGetAccountByAddress.mockResolvedValue(makeAccount({ balance: 100, stakedBalance: 30 }))
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -255,7 +252,7 @@ describe('getStakes', () => {
         }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -293,7 +290,7 @@ describe('getStakes', () => {
         }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -376,7 +373,7 @@ describe('getStakes', () => {
         }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([
         {
@@ -423,7 +420,7 @@ describe('getStakes', () => {
         }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       const unstaking = result.items.find((i) => i.uid === 'unstaking-99')
       expect(unstaking?.delegate).toBe(previousBaker)
@@ -436,7 +433,7 @@ describe('getStakes', () => {
         makeRequest({ id: 4, actualAmount: 10, firstTime: '2026-05-04T00:00:00Z' }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items.filter((i) => i.uid.startsWith('unstaking-'))).toHaveLength(1)
       expect(result.items.find((i) => i.uid === 'unstaking-4')?.amount).toBe(10n)
@@ -445,7 +442,7 @@ describe('getStakes', () => {
     it('skips the unstake-requests endpoint entirely when unstakedBalance is 0', async () => {
       mockGetAccountByAddress.mockResolvedValue(makeAccount({ balance: 1000, unstakedBalance: 0 }))
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items).toEqual([])
       expect(mockGetUnstakeRequests).not.toHaveBeenCalled()
@@ -458,7 +455,7 @@ describe('getStakes', () => {
         makeRequest({ id: 2, actualAmount: 20, firstTime: '2026-05-04T00:00:00Z' }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items.map((i) => i.uid)).toEqual(['unstaking-2'])
     })
@@ -470,7 +467,7 @@ describe('getStakes', () => {
         makeRequest({ id: 2, actualAmount: 30, firstTime: '2026-05-04T00:00:00Z' }),
       ])
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       expect(result.items.map((i) => i.uid)).toEqual(['unstaking-2'])
       expect(result.items.find((i) => i.uid === 'unstaking-2')?.amount).toBe(30n)
@@ -480,7 +477,7 @@ describe('getStakes', () => {
       mockGetAccountByAddress.mockResolvedValue(makeAccount({ balance: 100, unstakedBalance: 10 }))
       mockGetUnstakeRequests.mockRejectedValueOnce(new Error('tzkt 500'))
 
-      await expect(api.getStakes(address)).rejects.toThrow('tzkt 500')
+      await expect(getStakes(context, address)).rejects.toThrow('tzkt 500')
     })
   })
 
@@ -504,7 +501,7 @@ describe('getStakes', () => {
         firstActivityTime: '2026-01-01T00:00:00Z',
       })
 
-      const result = await api.getStakes(address)
+      const result = await getStakes(context, address)
 
       const delegation = result.items.find((i) => i.uid === `delegation-${address}`)
       expect(delegation?.amount).toBe(0n)

package/src/logic/getStakes.ts

@@ -1,11 +1,12 @@
 // SPDX-FileCopyrightText: © 2026 LEDGER SAS
 // SPDX-License-Identifier: Apache-2.0
 
+import type { TezosCoinConfig, TezosContext } from '../config'
 import type { APIAccount, APIManagerAccount, APIUnstakeRequest } from '../network/types'
 import type { Cursor, Page, Stake } from '@ledgerhq/coin-module-framework/api/types'
 import { log } from '@ledgerhq/logs'
 import { hasManagerKey } from '../network/types'
-import api from '../network/tzkt'
+import { createTzktApi } from '../network/tzkt'
 import { partitionNativeBalance } from '../utils'
 import { STAKING_UID_PREFIX } from './positionUid'
 
@@ -17,11 +18,14 @@ export {
 } from './positionUid'
 
 export function fetchUnstakeRequests(
+  config: TezosCoinConfig,
   address: string,
   account: APIAccount
 ): Promise<APIUnstakeRequest[]> {
   if (!hasManagerKey(account)) return Promise.resolve([])
-  return (account.unstakedBalance ?? 0) > 0 ? api.getUnstakeRequests(address) : Promise.resolve([])
+  return (account.unstakedBalance ?? 0) > 0
+    ? createTzktApi(config).getUnstakeRequests(address)
+    : Promise.resolve([])
 }
 
 function unstakeRequestToStake(address: string, req: APIUnstakeRequest): Stake | null {
@@ -124,9 +128,14 @@ export function buildStakesForAccount(
   return stakes
 }
 
-export async function getStakes(address: string, _cursor?: Cursor): Promise<Page<Stake>> {
-  const accountInfo = await api.getAccountByAddress(address)
+export async function getStakes(
+  context: TezosContext,
+  address: string,
+  _cursor?: Cursor
+): Promise<Page<Stake>> {
+  const config = await context.config()
+  const accountInfo = await createTzktApi(config).getAccountByAddress(address)
   if (!hasManagerKey(accountInfo)) return { items: [] }
-  const unstakeRequests = await fetchUnstakeRequests(address, accountInfo)
+  const unstakeRequests = await fetchUnstakeRequests(config, address, accountInfo)
   return { items: buildStakesForAccount(address, accountInfo, unstakeRequests) }
 }

package/src/logic/lastBlock.ts

@@ -1,11 +1,13 @@
 // SPDX-FileCopyrightText: © 2026 LEDGER SAS
 // SPDX-License-Identifier: Apache-2.0
 
+import type { TezosContext } from '../config'
 import type { BlockInfo } from '@ledgerhq/coin-module-framework/api/index'
-import api from '../network/tzkt'
+import { createTzktApi } from '../network/tzkt'
 
-export async function lastBlock(): Promise<BlockInfo> {
-  const result = await api.getLastBlock()
+export async function lastBlock(context: TezosContext): Promise<BlockInfo> {
+  const config = await context.config()
+  const result = await createTzktApi(config).getLastBlock()
 
   return {
     height: result.level,