tapimo 0.13.0 → 0.15.0

package/src/internal/routes/Economics.ts

@@ -0,0 +1,47 @@
+/** Token amount needed for route economics calculations. */
+export type Amount = {
+  /** Quantity in the token's smallest unit. */
+  baseUnits: string
+  /** Monetary denomination represented by the token. */
+  currency: string
+  /** Number of decimal places used by the token. */
+  decimals: number
+}
+
+/** Returns the signed basis-point difference from a reference amount. */
+export function differenceBps(options: differenceBps.Options): number | undefined {
+  if (options.reference.currency !== options.value.currency) return undefined
+  const decimals = Math.max(options.reference.decimals, options.value.decimals)
+  const reference = scale(options.reference, decimals)
+  const value = scale(options.value, decimals)
+  if (reference <= 0n) return undefined
+  const precision = 1_000n
+  const measured = Number(((reference - value) * 10_000n * precision) / reference) / 1_000
+  return Number.isFinite(measured) ? measured : undefined
+}
+
+export declare namespace differenceBps {
+  /** Reference and observed values in the same monetary denomination. */
+  type Options = {
+    /** Amount treated as the zero-cost reference. */
+    reference: Amount
+    /** Amount compared with the reference. */
+    value: Amount
+  }
+}
+
+/** Returns a finite USD amount, or undefined for non-USD denominations. */
+export function usd(amount: Amount): number | undefined {
+  if (amount.currency !== 'USD') return undefined
+  return units(amount)
+}
+
+/** Returns a finite amount expressed in whole token units. */
+export function units(amount: Amount): number | undefined {
+  const value = Number(amount.baseUnits) / 10 ** amount.decimals
+  return Number.isFinite(value) ? value : undefined
+}
+
+function scale(amount: Amount, decimals: number) {
+  return BigInt(amount.baseUnits) * 10n ** BigInt(decimals - amount.decimals)
+}

package/src/internal/{funding → routes}/Evidence.test.ts

@@ -1,8 +1,8 @@
 import { AbiEvent, Base58, Hex } from 'ox'
 
-import * as FundingCatalog from '../../db/tables/fundingCatalog.js'
+import * as RoutesCatalog from '../../db/tables/routesCatalog.js'
 import * as TestApp from '../../../test/App.js'
-import * as TestFunding from '../../../test/Funding.js'
+import * as TestRoutes from '../../../test/Routes.js'
 import * as TestRelay from '../../../test/Relay.js'
 import * as Chain from './Chain.js'
 import * as Evidence from './Evidence.js'
@@ -84,8 +84,8 @@ describe('resolveRpcUrls', () => {
 
 describe('createVerifier', () => {
   test('verifies finalized Solana and one-confirmation Tron token transfers', async () => {
-    const tron = TestFunding.depositAddressSnapshot()
-    const solana = TestFunding.transferSnapshot({
+    const tron = TestRoutes.depositAddressSnapshot()
+    const solana = TestRoutes.transferSnapshot({
       sourceChain: {
         addressFormat: 'base58',
         id: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
@@ -180,7 +180,7 @@ describe('createVerifier', () => {
 
     try {
       vi.useFakeTimers({ now: new Date('2027-01-01T00:00:00.000Z') })
-      await FundingCatalog.publish(db, {
+      await RoutesCatalog.publish(db, {
         chainTokens: [],
         chains: [
           {
@@ -218,7 +218,7 @@ describe('createVerifier', () => {
         token: tron.sourceToken,
         transactionHash: 'tron-transaction',
       })
-      await FundingCatalog.publish(db, {
+      await RoutesCatalog.publish(db, {
         chainTokens: [],
         chains: [
           {

package/src/internal/{funding → routes}/Evidence.ts

@@ -1,5 +1,5 @@
 import { AbiEvent, Address, Base58, Bytes, Hash, Hex, RpcSchema, RpcTransport } from 'ox'
-import { createClient, custom, fallback, TransactionReceiptNotFoundError } from 'viem'
+import { TransactionReceiptNotFoundError } from 'viem'
 import { getBlockNumber, getTransactionReceipt } from 'viem/actions'
 import * as z from 'zod/mini'
 
@@ -109,7 +109,7 @@ export function resolveRpcUrls(options: resolveRpcUrls.Options): readonly string
 export declare namespace resolveRpcUrls {
   /** Catalog chain and Worker override used to resolve evidence endpoints. */
   type Options = {
-    /** Funding chain with catalog-owned fallback endpoints. */
+    /** Route chain with catalog-owned fallback endpoints. */
     chain: Chain.Chain
     /** Tempo chain that receives a shared RPC URL override. */
     defaultChainId: Viem.ChainId
@@ -171,7 +171,7 @@ export function createVerifier(options: createVerifier.Options): Reconciliation.
 }
 
 export declare namespace createVerifier {
-  /** Chain clients and finality bounds used for funding evidence. */
+  /** Chain clients and finality bounds used for routes evidence. */
   type Options = {
     /** Per-chain confirmation overrides keyed by CAIP-2 id. */
     confirmations?: Readonly<Record<string, number>> | undefined
@@ -195,7 +195,7 @@ async function verifyEvm(
   parameters: Reconciliation.VerifyTransfers.Parameters,
   options: FetchOptions & { confirmations: number },
 ): Promise<readonly Reconciliation.TransferEvidence[]> {
-  const client = jsonRpcClient(options)
+  const client = Viem.createEvmClient(options)
   const [receipt, head] = await Promise.all([
     getTransactionReceipt(client, { hash: parameters.transactionHash as Hex.Hex }).catch(
       (cause) => {
@@ -334,17 +334,6 @@ async function verifyTron(
   })
 }
 
-function jsonRpcClient(options: FetchOptions) {
-  return createClient({
-    transport: fallback(
-      options.urls.map((url) => {
-        const transport = RpcTransport.fromHttp(url, { fetchFn: options.fetch })
-        return custom(transport, { retryCount: 0 })
-      }),
-    ),
-  })
-}
-
 async function requestSolana(
   options: FetchOptions,
   request: SolanaRpcSchema['Request'],
@@ -359,7 +348,7 @@ async function requestSolana(
       cause = error
     }
   }
-  throw cause ?? new ChainResponseError('No funding evidence endpoint is configured.')
+  throw cause ?? new ChainResponseError('No routes evidence endpoint is configured.')
 }
 
 async function post<const result extends z.ZodMiniType>(
@@ -384,7 +373,7 @@ async function post<const result extends z.ZodMiniType>(
       cause = error
     }
   }
-  throw cause ?? new ChainResponseError('No funding evidence endpoint is configured.')
+  throw cause ?? new ChainResponseError('No routes evidence endpoint is configured.')
 }
 
 function tronHex(address: string) {
@@ -405,21 +394,21 @@ function tronAddress(hex: string) {
   return Base58.fromBytes(bytes)
 }
 
-/** No authoritative chain endpoint is configured for a funding route. */
+/** No authoritative chain endpoint is configured for a provider route. */
 export class ChainConfigurationError extends Error {
-  override name = 'Funding.Evidence.ChainConfigurationError'
+  override name = 'Routes.Evidence.ChainConfigurationError'
 
   constructor(chainId: string) {
-    super(`No funding evidence endpoint is configured for ${chainId}.`)
+    super(`No routes evidence endpoint is configured for ${chainId}.`)
   }
 }
 
 /** An authoritative chain endpoint returned an invalid payload. */
 export class ChainPayloadError extends Error {
-  override name = 'Funding.Evidence.ChainPayloadError'
+  override name = 'Routes.Evidence.ChainPayloadError'
 }
 
 /** An authoritative chain endpoint returned an unsuccessful response. */
 export class ChainResponseError extends Error {
-  override name = 'Funding.Evidence.ChainResponseError'
+  override name = 'Routes.Evidence.ChainResponseError'
 }