tapimo 0.10.2 → 0.12.0

package/src/internal/funding/providers/stargate.ts

@@ -0,0 +1,184 @@
+import { Address } from 'ox'
+import * as z from 'zod/mini'
+
+import * as FundingProvider from '../Provider.js'
+
+const defaultBaseUrl = 'https://transfer.layerzero-api.com/v1'
+const defaultFetch: FundingProvider.Fetch = (input, init) => globalThis.fetch(input, init)
+const sourceDetails = {
+  STARGATE_V2_BUS: 'stargate:value-transfer-v1:bus',
+  STARGATE_V2_TAXI: 'stargate:value-transfer-v1:taxi',
+} as const
+
+namespace schema {
+  const DecimalString = z.string().check(z.regex(/^\d+(\.\d+)?$/))
+  const IntegerString = z.string().check(z.regex(/^\d+$/))
+
+  const Quote = z.object({
+    dstAmount: IntegerString,
+    dstAmountMin: IntegerString,
+    duration: z.optional(
+      z.object({
+        estimated: z.nullable(DecimalString),
+      }),
+    ),
+    expiresAt: z.optional(z.iso.datetime()),
+    id: z.string().check(z.minLength(1)),
+    routeSteps: z
+      .array(
+        z.object({
+          srcChainKey: z.string(),
+          type: z.string(),
+        }),
+      )
+      .check(z.minLength(1)),
+    srcAmount: IntegerString,
+  })
+
+  const Error = z.object({
+    message: z.string(),
+    status: z.union([z.string(), z.number()]),
+  })
+
+  export const Quotes = z.object({
+    error: z.optional(z.nullable(Error)),
+    quotes: z.array(Quote),
+  })
+}
+
+/** Creates a Stargate funding provider backed by LayerZero's `/quotes` endpoint. */
+export function stargate(options: stargate.Options) {
+  if (options.apiKey.trim().length === 0) throw new FundingProvider.ProviderConfigurationError()
+  if (!Address.validate(options.userAddress, { strict: false }))
+    throw new FundingProvider.ProviderConfigurationError()
+
+  const endpoint = new URL(options.baseUrl ?? defaultBaseUrl)
+  endpoint.pathname = `${endpoint.pathname.replace(/\/+$/, '')}/quotes`
+  const fetch = options.fetch ?? defaultFetch
+  const now = options.now ?? (() => new Date())
+
+  return FundingProvider.from({
+    id: 'stargate',
+    name: 'Stargate',
+    async getQuote({ candidate, route }, signal) {
+      const response = await FundingProvider.requestJson(endpoint, {
+        body: {
+          amount: candidate.sourceAmount.amount,
+          dstChainKey: route.destination.chain.slug,
+          dstTokenAddress: candidate.destinationToken.address,
+          dstWalletAddress: options.userAddress,
+          options: { amountType: 'EXACT_SRC_AMOUNT' },
+          srcChainKey: route.source.chain.slug,
+          srcTokenAddress: candidate.sourceToken.address,
+          srcWalletAddress: options.userAddress,
+        },
+        fetch,
+        headers: { 'user-agent': 'tempo-api', 'x-api-key': options.apiKey },
+        method: 'POST',
+        signal,
+      })
+      const parsed = schema.Quotes.safeParse(response)
+      if (!parsed.success || parsed.data.error) throw new FundingProvider.ProviderPayloadError()
+
+      const sampledAt = now()
+      const selected = selectQuote(parsed.data.quotes, {
+        amount: candidate.sourceAmount.amount,
+        now: sampledAt,
+        sourceChainKey: route.source.chain.slug,
+      })
+      if (!selected)
+        return FundingProvider.unavailableResult({
+          detail: 'stargate:value-transfer-v1',
+          message: 'NO_STARGATE_ROUTE',
+          now: sampledAt,
+          source: 'providerQuote',
+        })
+
+      const estimated = estimatedSeconds(selected.quote.duration?.estimated)
+      return {
+        ...(selected.quote.expiresAt ? { expiresAt: selected.quote.expiresAt } : {}),
+        destinationAmountMin: selected.quote.dstAmountMin,
+        destinationAmount: selected.quote.dstAmount,
+        quality: {
+          ...(estimated === undefined ? {} : { estimatedSeconds: estimated }),
+          liquiditySource: 'providerQuote',
+          sourceDetail: sourceDetails[selected.type],
+          tier: 'liquid',
+        },
+        sampledAt: sampledAt.toISOString(),
+        status: 'available',
+      }
+    },
+  })
+}
+
+export declare namespace stargate {
+  /** Stargate provider options. */
+  type Options = {
+    /** LayerZero Value Transfer API key sent in the required request header. */
+    apiKey: string
+    /** Override for tests or LayerZero test environments. */
+    baseUrl?: string | undefined
+    /** Fetch implementation override for tests. */
+    fetch?: FundingProvider.Fetch | undefined
+    /** Clock override for deterministic tests. */
+    now?: (() => Date) | undefined
+    /** Quote wallet address used as the LayerZero sender and recipient. */
+    userAddress: string
+  }
+}
+
+function selectQuote(
+  quotes: z.output<typeof schema.Quotes>['quotes'],
+  options: selectQuote.Options,
+) {
+  return quotes
+    .flatMap((quote) => {
+      const type = quote.routeSteps
+        .filter((step) => step.srcChainKey === options.sourceChainKey)
+        .map((step) => step.type)
+        .find(isStargateType)
+      if (!type) return []
+      if (
+        quote.expiresAt !== undefined &&
+        new Date(quote.expiresAt).getTime() <= options.now.getTime()
+      )
+        return []
+      if (
+        quote.srcAmount !== options.amount ||
+        BigInt(quote.dstAmount) <= 0n ||
+        BigInt(quote.dstAmountMin) <= 0n ||
+        BigInt(quote.dstAmountMin) > BigInt(quote.dstAmount)
+      )
+        throw new FundingProvider.ProviderPayloadError()
+      return [{ quote, type }]
+    })
+    .sort((a, b) => {
+      const delta = BigInt(b.quote.dstAmountMin) - BigInt(a.quote.dstAmountMin)
+      if (delta > 0n) return 1
+      if (delta < 0n) return -1
+      return 0
+    })[0]
+}
+
+declare namespace selectQuote {
+  type Options = {
+    amount: string
+    now: Date
+    sourceChainKey: string
+  }
+}
+
+function isStargateType(type: string): type is keyof typeof sourceDetails {
+  return Object.hasOwn(sourceDetails, type)
+}
+
+function estimatedSeconds(milliseconds: string | null | undefined) {
+  if (milliseconds === undefined || milliseconds === null) return undefined
+  const [whole = '0', fraction] = milliseconds.split('.')
+  const roundedMilliseconds =
+    BigInt(whole) + (fraction !== undefined && /[1-9]/.test(fraction) ? 1n : 0n)
+  const seconds = (roundedMilliseconds + 999n) / 1_000n
+  if (seconds > BigInt(Number.MAX_SAFE_INTEGER)) throw new FundingProvider.ProviderPayloadError()
+  return Number(seconds)
+}

package/src/internal/webhookDestinations/slack.ts

@@ -41,6 +41,7 @@ type Block =
 /** Per-event emoji + friendly header name; also the notification fallback lead. */
 const friendlyName: Record<Webhooks.Envelope['type'], string> = {
   'block:created': ':link: Block created',
+  'funding:deposit.updated': ':inbox_tray: Funding deposit updated',
   'log:emitted': ':label: Log emitted',
   ping: ':bell: Webhook test ping',
   'token:transfer': ':money_with_wings: Token transfer',
@@ -150,9 +151,23 @@ function renderEvent(
   if (type === 'transaction:included') return transactionLayout(data, base)
   if (type === 'log:emitted') return logLayout(data, base)
   if (type === 'block:created') return blockLayout(data, base)
+  if (type === 'funding:deposit.updated') return fundingDepositLayout(data)
   return pingLayout()
 }
 
+function fundingDepositLayout(data: Record<string, unknown>): Layout {
+  const fields: Field[] = []
+  field(fields, 'Deposit', escape(str(data['id']) ?? 'unknown'))
+  field(fields, 'Status', escape(str(data['status']) ?? 'unknown'))
+  const recipient = str(data['recipient'])
+  if (recipient !== undefined) field(fields, 'Recipient', escape(recipient))
+  return {
+    fields,
+    header: friendlyName['funding:deposit.updated'],
+    text: `Funding deposit updated · ${str(data['status']) ?? 'unknown'}`,
+  }
+}
+
 function transferLayout(data: Record<string, unknown>, base: string | undefined): Layout {
   const amount = str(data['amount'])
   const token =

package/src/providers/index.test.ts

@@ -7,6 +7,7 @@ test('exports provider factories', () => {
       "relay",
       "rhino",
       "squid",
+      "stargate",
       "symbiosis",
       "uniswap",
     ]

package/src/providers/index.ts

@@ -3,6 +3,7 @@ import * as Across from '../internal/funding/providers/across.js'
 import * as Relay from '../internal/funding/providers/relay.js'
 import * as Rhino from '../internal/funding/providers/rhino.js'
 import * as Squid from '../internal/funding/providers/squid.js'
+import * as Stargate from '../internal/funding/providers/stargate.js'
 import * as Symbiosis from '../internal/funding/providers/symbiosis.js'
 
 /** Creates an Across funding provider. */
@@ -37,6 +38,14 @@ export declare namespace squid {
   type Options = Squid.squid.Options
 }
 
+/** Creates a Stargate funding provider. */
+export const stargate = Stargate.stargate
+
+export declare namespace stargate {
+  /** Stargate provider configuration. */
+  type Options = Stargate.stargate.Options
+}
+
 /** Creates a Symbiosis funding provider. */
 export const symbiosis = Symbiosis.symbiosis