tapimo 0.0.2 → 0.1.0

package/src/db/tables/webhookSubscriptions.ts

@@ -0,0 +1,358 @@
+import type { ExpressionBuilder, Selectable } from 'kysely'
+import { sql } from 'kysely'
+
+import type * as Webhooks from '../../internal/Webhooks.js'
+import type * as Db from '../Db.js'
+import type * as db_Schema from '../Schema.js'
+
+/** Columns of the `webhook_subscriptions` table, derived from `Schema.WebhookSubscription`. */
+export type Table = db_Schema.WebhookSubscription
+
+/** A stored webhook-subscription row. */
+export type Record = Selectable<Table>
+
+/** Maps an owner union to its stored `ownerId` column value. */
+export function ownerId(owner: Webhooks.Owner): string {
+  return owner.type === 'api_key' ? owner.orgId : owner.payer
+}
+
+/** Maps a stored row to the domain subscription (null columns → absent fields). */
+export function toSubscription(row: Record): Webhooks.Subscription {
+  return {
+    chainId: row.chainId,
+    ...(row.context === null ? {} : { context: row.context }),
+    createdAt: row.createdAt,
+    destination: row.destination,
+    eventType: row.eventType,
+    ...(row.expiresAt === null ? {} : { expiresAt: row.expiresAt }),
+    failureCount: row.failureCount,
+    filters: row.filters,
+    id: row.id,
+    ...(row.lastDeliveryAt === null ? {} : { lastDeliveryAt: row.lastDeliveryAt }),
+    owner:
+      row.ownerType === 'api_key'
+        ? { orgId: row.ownerId, type: 'api_key' }
+        : { payer: row.ownerId, type: 'mpp' },
+    secret: row.secret,
+    status: row.status,
+    updatedAt: row.updatedAt,
+  }
+}
+
+/**
+ * Inserts a subscription row from its domain value.
+ *
+ * @param db - The database.
+ * @param subscription - The subscription to insert.
+ */
+export async function insert(db: Db.Db, subscription: Webhooks.Subscription): Promise<void> {
+  await db.kysely
+    .insertInto('webhook_subscriptions')
+    .values({
+      chainId: subscription.chainId,
+      context: subscription.context ?? null,
+      createdAt: subscription.createdAt,
+      destination: subscription.destination,
+      eventType: subscription.eventType,
+      expiresAt: subscription.expiresAt ?? null,
+      failureCount: subscription.failureCount,
+      filters: subscription.filters,
+      id: subscription.id,
+      lastDeliveryAt: subscription.lastDeliveryAt ?? null,
+      ownerId: ownerId(subscription.owner),
+      ownerType: subscription.owner.type,
+      pollerCursor: null,
+      secret: subscription.secret,
+      status: subscription.status,
+      updatedAt: subscription.updatedAt,
+    })
+    .execute()
+}
+
+/**
+ * Reads an owner's subscription by id; expired rows never match (query-time
+ * expiry, same read semantics as the old store TTL).
+ *
+ * @param db - The database.
+ * @param owner - The authenticated owner.
+ * @param id - The subscription id (`wh_…`).
+ * @param now - ISO timestamp expiry is evaluated against.
+ * @returns The subscription, or `null` when absent (or not the owner's).
+ */
+export async function get(
+  db: Db.Db,
+  owner: Webhooks.Owner,
+  id: string,
+  now: string,
+): Promise<Webhooks.Subscription | null> {
+  const row = await db.kysely
+    .selectFrom('webhook_subscriptions')
+    .selectAll()
+    .where('id', '=', id)
+    .where('ownerType', '=', owner.type)
+    .where('ownerId', '=', ownerId(owner))
+    .where(live(now))
+    .executeTakeFirst()
+  return row ? toSubscription(row) : null
+}
+
+/**
+ * Lists an owner's live subscriptions, newest first, with keyset paging
+ * (`id < cursor` — ids embed a zero-padded timestamp, so lexical order is
+ * chronological).
+ *
+ * @param db - The database.
+ * @param owner - The authenticated owner.
+ * @param options - Paging options plus the expiry timestamp.
+ * @returns The subscriptions.
+ */
+export async function list(
+  db: Db.Db,
+  owner: Webhooks.Owner,
+  options: list.Options,
+): Promise<Webhooks.Subscription[]> {
+  let query = db.kysely
+    .selectFrom('webhook_subscriptions')
+    .selectAll()
+    .where('ownerType', '=', owner.type)
+    .where('ownerId', '=', ownerId(owner))
+    .where(live(options.now))
+    .orderBy('id', 'desc')
+  if (options.cursor) query = query.where('id', '<', options.cursor)
+  if (options.offset) query = query.offset(options.offset)
+  if (options.limit !== undefined) query = query.limit(options.limit)
+  return (await query.execute()).map(toSubscription)
+}
+
+export declare namespace list {
+  /** Options for {@link list}. */
+  type Options = {
+    /** Return subscriptions older than this id (keyset paging, newest first). */
+    cursor?: string | undefined
+    /** Maximum subscriptions to return. */
+    limit?: number | undefined
+    /** ISO timestamp expiry is evaluated against. */
+    now: string
+    /** Rows to skip from the head (positional pagination; exclusive with `cursor`). */
+    offset?: number | undefined
+  }
+}
+
+/**
+ * Counts an owner's live subscriptions.
+ *
+ * @param db - The database.
+ * @param owner - The authenticated owner.
+ * @param now - ISO timestamp expiry is evaluated against.
+ * @returns The count.
+ */
+export async function count(db: Db.Db, owner: Webhooks.Owner, now: string): Promise<number> {
+  const row = await db.kysely
+    .selectFrom('webhook_subscriptions')
+    .select((eb) => eb.fn.countAll().as('count'))
+    .where('ownerType', '=', owner.type)
+    .where('ownerId', '=', ownerId(owner))
+    .where(live(now))
+    .executeTakeFirstOrThrow()
+  return Number(row.count)
+}
+
+/**
+ * Applies a column patch to a subscription. Only the provided columns are
+ * written; `context: null` clears the stored context.
+ *
+ * @param db - The database.
+ * @param id - The subscription id (`wh_…`).
+ * @param set - The columns to write.
+ * @returns The updated row's subscription, or `undefined` when absent.
+ */
+export async function update(
+  db: Db.Db,
+  id: string,
+  set: update.Set,
+): Promise<Webhooks.Subscription | undefined> {
+  const row = await db.kysely
+    .updateTable('webhook_subscriptions')
+    .set(set)
+    .where('id', '=', id)
+    .returningAll()
+    .executeTakeFirst()
+  return row ? toSubscription(row) : undefined
+}
+
+export declare namespace update {
+  /** Columns writable by a subscription patch. */
+  type Set = {
+    /** New human context; null clears it. */
+    context?: Webhooks.Context | null | undefined
+    /** New delivery destination. */
+    destination?: Webhooks.Destination | undefined
+    /** New filter predicates. */
+    filters?: Webhooks.Subscription['filters'] | undefined
+    /** New lifecycle status. */
+    status?: Webhooks.Status | undefined
+    /** Mutation timestamp (ISO). */
+    updatedAt: string
+  }
+}
+
+/**
+ * Deletes an owner's live subscription; delivery rows cascade via the FK.
+ *
+ * @param db - The database.
+ * @param owner - The authenticated owner.
+ * @param id - The subscription id (`wh_…`).
+ * @param now - ISO timestamp expiry is evaluated against.
+ * @returns Whether a row was deleted.
+ */
+export async function remove(
+  db: Db.Db,
+  owner: Webhooks.Owner,
+  id: string,
+  now: string,
+): Promise<boolean> {
+  const result = await db.kysely
+    .deleteFrom('webhook_subscriptions')
+    .where('id', '=', id)
+    .where('ownerType', '=', owner.type)
+    .where('ownerId', '=', ownerId(owner))
+    .where(live(now))
+    .executeTakeFirst()
+  return result.numDeletedRows > 0n
+}
+
+/**
+ * Lists live `active` subscriptions for a `(chainId, eventType)` stream — the
+ * poller's per-stream lookup, served by the partial status index.
+ *
+ * @param db - The database.
+ * @param chainId - Chain the stream belongs to.
+ * @param eventType - Event type of the stream.
+ * @param now - ISO timestamp expiry is evaluated against.
+ * @returns The subscriptions, in id (chronological) order.
+ */
+export async function listActive(
+  db: Db.Db,
+  chainId: number,
+  eventType: Webhooks.EventType,
+  now: string,
+): Promise<Webhooks.Subscription[]> {
+  const rows = await db.kysely
+    .selectFrom('webhook_subscriptions')
+    .selectAll()
+    .where('chainId', '=', chainId)
+    .where('eventType', '=', eventType)
+    .where('status', '=', 'active')
+    .where(live(now))
+    .orderBy('id')
+    .execute()
+  return rows.map(toSubscription)
+}
+
+/**
+ * Reads a subscription's poller cursor.
+ *
+ * @param db - The database.
+ * @param id - The subscription id (`wh_…`).
+ * @returns The cursor, or `null` when unset (or the row is absent).
+ */
+export async function getCursor(db: Db.Db, id: string): Promise<string | null> {
+  const row = await db.kysely
+    .selectFrom('webhook_subscriptions')
+    .select('pollerCursor')
+    .where('id', '=', id)
+    .executeTakeFirst()
+  return row?.pollerCursor ?? null
+}
+
+/**
+ * Writes a subscription's poller cursor. Deliberately does not touch
+ * `updatedAt` — the cursor advances every tick and is not a user mutation.
+ *
+ * @param db - The database.
+ * @param id - The subscription id (`wh_…`).
+ * @param cursor - The keyset cursor to store.
+ */
+export async function setCursor(db: Db.Db, id: string, cursor: string): Promise<void> {
+  await db.kysely
+    .updateTable('webhook_subscriptions')
+    .set({ pollerCursor: cursor })
+    .where('id', '=', id)
+    .execute()
+}
+
+/**
+ * Records a successful delivery: resets the consecutive-failure counter and
+ * stamps `lastDeliveryAt`.
+ *
+ * @param db - The database.
+ * @param id - The subscription id (`wh_…`).
+ * @param now - Delivery timestamp (ISO).
+ * @returns The updated subscription, or `undefined` when the row is absent.
+ */
+export async function recordSuccess(
+  db: Db.Db,
+  id: string,
+  now: string,
+): Promise<Webhooks.Subscription | undefined> {
+  const row = await db.kysely
+    .updateTable('webhook_subscriptions')
+    .set({ failureCount: 0, lastDeliveryAt: now, updatedAt: now })
+    .where('id', '=', id)
+    .returningAll()
+    .executeTakeFirst()
+  return row ? toSubscription(row) : undefined
+}
+
+/**
+ * Records a failed delivery: atomically increments the consecutive-failure
+ * counter and disables the subscription once it reaches `maxFailures` (raw
+ * fragments use storage column names — they bypass the camelCase mapping).
+ *
+ * @param db - The database.
+ * @param id - The subscription id (`wh_…`).
+ * @param maxFailures - Consecutive failures before auto-disabling.
+ * @param now - Failure timestamp (ISO).
+ * @returns The updated subscription, or `undefined` when the row is absent.
+ */
+export async function recordFailure(
+  db: Db.Db,
+  id: string,
+  maxFailures: number,
+  now: string,
+): Promise<Webhooks.Subscription | undefined> {
+  const row = await db.kysely
+    .updateTable('webhook_subscriptions')
+    .set({
+      failureCount: sql`failure_count + 1`,
+      status: sql`CASE WHEN failure_count + 1 >= ${maxFailures} THEN 'disabled' ELSE status END`,
+      updatedAt: now,
+    })
+    .where('id', '=', id)
+    .returningAll()
+    .executeTakeFirst()
+  return row ? toSubscription(row) : undefined
+}
+
+/**
+ * Deletes expired subscriptions (their delivery rows cascade). Called
+ * best-effort from the poller tick.
+ *
+ * @param db - The database.
+ * @param now - ISO timestamp expiry is evaluated against.
+ * @returns The number of rows deleted.
+ */
+export async function pruneExpired(db: Db.Db, now: string): Promise<number> {
+  const result = await db.kysely
+    .deleteFrom('webhook_subscriptions')
+    .where('expiresAt', 'is not', null)
+    .where('expiresAt', '<=', now)
+    .executeTakeFirst()
+  return Number(result.numDeletedRows)
+}
+
+/** Live-row predicate: no expiry, or expiry strictly in the future. */
+function live(now: string) {
+  return (eb: ExpressionBuilder<Db.Database, 'webhook_subscriptions'>) =>
+    eb.or([eb('expiresAt', 'is', null), eb('expiresAt', '>', now)])
+}

package/src/handlers/internal/executionError.ts

@@ -0,0 +1,205 @@
+import { type DecodeErrorResultReturnType, type Hex, decodeErrorResult } from 'viem'
+import { Abis } from 'viem/tempo'
+
+import type { OneOf, UnionOmit } from './types.js'
+
+type AllAbis = typeof Abis.abis
+type AbiErrorName = Extract<AllAbis[number], { type: 'error' }>['name']
+
+/** Decoded execution error from a Tempo precompile revert. */
+export type ExecutionError = OneOf<
+  | (DecodeErrorResultReturnType<AllAbis> & {
+      data: Hex
+      message: string
+    })
+  | { errorName: 'unknown'; message: string }
+>
+
+/** RPC-serialized execution error (bigints and numbers as hex). */
+export type Rpc = UnionOmit<ExecutionError, 'args'>
+
+/** Human-readable messages keyed by ABI error name. */
+export const messages: Record<AbiErrorName, string> = {
+  AddressAlreadyHasValidator: 'This address already has a validator.',
+  AddressNotReserved: 'Address is not reserved.',
+  AddressReserved: 'Address is reserved.',
+  AlreadyInitialized: 'Already initialized.',
+  AmountExceedsDeposit: 'Amount exceeds deposit.',
+  AmountNotIncreasing: 'Amount is not increasing.',
+  BelowMinimumOrderSize: 'Order size is below the minimum allowed ({0}).',
+  CallNotAllowed: 'This call is not allowed.',
+  CannotChangeWithinBlock: 'Cannot change within the same block.',
+  CaptureAmountInvalid: 'Capture amount is invalid.',
+  ChannelAlreadyExists: 'Channel already exists.',
+  ChannelNotFound: 'Channel not found.',
+  CloseNotReady: 'Channel is not ready to close.',
+  ContractPaused: 'Contract is paused.',
+  DepositOverflow: 'Deposit overflow.',
+  DivisionByZero: 'Division by zero.',
+  EmptyV1ValidatorSet: 'Validator set is empty.',
+  ExpiringNonceHashNotSet: 'Expiring nonce hash is not set.',
+  ExpiringNonceReplay: 'Expiring nonce has already been used.',
+  ExpiringNonceSetFull: 'Expiring nonce set is full.',
+  ExpiryInPast: 'Expiry is in the past.',
+  IdenticalAddresses: 'Addresses must be different.',
+  IdenticalTokens: 'Cannot swap a token for itself — input and output tokens must be different.',
+  IncompatiblePolicyType: 'Incompatible policy type.',
+  IngressAlreadyExists: 'Ingress "{0}" already exists.',
+  InsufficientAllowance: 'Insufficient allowance.',
+  InsufficientBalance: 'Insufficient balance. Required: {1}, available: {0}.',
+  InsufficientFeeTokenBalance: 'Insufficient fee token balance.',
+  InsufficientLiquidity: 'Not enough liquidity in the order book to fill this trade.',
+  InsufficientOutput:
+    'The output amount is below the slippage minimum — try increasing slippage tolerance.',
+  InsufficientReserves: 'Insufficient reserves.',
+  InvalidAmount: 'Invalid amount.',
+  InvalidBaseToken: 'This token is not a valid base token for the requested pair.',
+  InvalidCallScope: 'Invalid call scope.',
+  InvalidClaimAddress: 'Invalid claim address.',
+  InvalidCurrency: 'Invalid currency.',
+  InvalidExpiringNonceExpiry: 'Invalid expiring nonce expiry.',
+  InvalidFlipTick: 'The flip-order price tick is invalid.',
+  InvalidFormat: 'Invalid format.',
+  InvalidKeyAuthorizationWitness: 'Invalid key authorization witness.',
+  InvalidKeyId: 'Invalid key ID.',
+  InvalidLogoURI: 'Invalid logo URI.',
+  InvalidMasterAddress: 'Invalid master address.',
+  InvalidMigrationIndex: 'Invalid migration index.',
+  InvalidNonceKey: 'Invalid nonce key.',
+  InvalidOwner: 'Invalid owner.',
+  InvalidPayee: 'Invalid payee.',
+  InvalidPayload: 'Invalid payload.',
+  InvalidPolicyType: 'Invalid policy type.',
+  InvalidPublicKey: 'Invalid public key.',
+  InvalidQuoteToken: 'Invalid quote token.',
+  InvalidReceipt: 'Invalid receipt.',
+  InvalidReceivePolicyType: 'Invalid receive policy type.',
+  InvalidRecipient: 'Invalid recipient.',
+  InvalidRecoveryAuthority: 'Invalid recovery authority.',
+  InvalidSignature: 'Invalid signature.',
+  InvalidSignatureFormat: 'Invalid signature format.',
+  InvalidSignatureType: 'Invalid signature type.',
+  InvalidSpendingLimit: 'Invalid spending limit.',
+  InvalidSupplyCap: 'Invalid supply cap.',
+  InvalidSwapCalculation: 'Invalid swap calculation.',
+  InvalidTick: 'The price tick is invalid.',
+  InvalidToken: 'This token is not supported on the exchange.',
+  InvalidTransferPolicyId: 'Invalid transfer policy.',
+  InvalidValidatorAddress: 'Invalid validator address.',
+  KeyAlreadyExists: 'Key already exists.',
+  KeyAlreadyRevoked: 'Key has already been revoked.',
+  KeyAuthorizationWitnessAlreadyBurned: 'Key authorization witness has already been burned.',
+  KeyExpired: 'Key has expired.',
+  KeyNotFound: 'Key not found.',
+  LegacyAuthorizeKeySelectorChanged: 'Legacy authorize key selector changed to {0}.',
+  LogoURITooLong: 'Logo URI is too long.',
+  MasterIdCollision: 'Master ID collision with {0}.',
+  MaxInputExceeded:
+    'The required input exceeds the slippage maximum — try increasing slippage tolerance.',
+  MigrationNotComplete: 'Migration is not complete.',
+  NoOptedInSupply: 'No opted-in supply.',
+  NonceOverflow: 'Nonce overflow.',
+  NotHostPort: '"{1}" is not a valid host:port for {0}.',
+  NotInitialized: 'Not initialized.',
+  NotIp: '"{0}" is not a valid IP address.',
+  NotIpPort: '"{1}" is not a valid IP:port for {0}.',
+  NotPayeeOrOperator: 'Not payee or operator.',
+  NotPayer: 'Not payer.',
+  OrderDoesNotExist: 'No order exists with the given ID.',
+  OrderNotStale: 'This order is not yet eligible for stale-cleanup.',
+  PairAlreadyExists: 'A trading pair for these tokens has already been created.',
+  PairDoesNotExist: 'No trading pair exists for these tokens.',
+  PermitExpired: 'Permit has expired.',
+  PolicyForbids: 'Forbidden by policy.',
+  PolicyNotFound: 'Policy not found.',
+  PolicyNotSimple: 'Policy is not a simple policy.',
+  ProofOfWorkFailed: 'Proof of work failed.',
+  ProtectedAddress: 'Address is protected.',
+  ProtocolNonceNotSupported: 'Protocol nonce is not supported.',
+  PublicKeyAlreadyExists: 'Public key already exists.',
+  SignatureTypeMismatch: 'Signature type mismatch. Expected {0}, got {1}.',
+  SpendingLimitExceeded: 'Spending limit exceeded.',
+  SupplyCapExceeded: 'Supply cap exceeded.',
+  TickOutOfBounds: 'Price tick {0} is outside the allowed range.',
+  TokenAlreadyExists: 'Token {0} already exists.',
+  Unauthorized: 'Unauthorized.',
+  UnauthorizedCaller: 'Unauthorized caller.',
+  UnauthorizedClaimer: 'Unauthorized claimer.',
+  Uninitialized: 'Uninitialized.',
+  ValidatorAlreadyDeactivated: 'Validator is already deactivated.',
+  ValidatorAlreadyExists: 'Validator already exists.',
+  ValidatorNotFound: 'Validator not found.',
+  VirtualAddressNotAllowed: 'Virtual address is not allowed.',
+  VirtualAddressUnregistered: 'Virtual address is not registered.',
+  ZeroDeposit: 'Deposit cannot be zero.',
+  ZeroPublicKey: 'Public key cannot be zero.',
+}
+
+/** Interpolate `{0}`, `{1}`, … placeholders with args. */
+function interpolate(template: string, args?: readonly unknown[]): string {
+  if (!args) return template
+  return template.replace(/\{(\d+)\}/g, (_, i) => {
+    const v = args[Number(i)]
+    return v === undefined ? `{${i}}` : String(v)
+  })
+}
+
+/** Parse a viem error into a structured execution error. */
+export function parse(error: Error): ExecutionError {
+  const raw =
+    (error as { details?: string }).details ??
+    (error as { shortMessage?: string }).shortMessage ??
+    error.message
+
+  const data = extractRevertData(error)
+  if (data) {
+    try {
+      const decoded = decodeErrorResult({ abi: Abis.abis, data })
+      const template = messages[decoded.errorName as AbiErrorName]
+      return {
+        ...decoded,
+        data,
+        message: template
+          ? interpolate(template, decoded.args as readonly unknown[])
+          : raw.replace(/^execution reverted:\s*/i, ''),
+      } as never
+    } catch {}
+  }
+
+  // Fallback: extract error name from human-readable revert message.
+  const nameMatch = /:\s*(\w+)\(\w+/.exec(raw)
+  const errorName = nameMatch?.[1]
+  if (errorName && errorName in messages)
+    return { errorName: 'unknown', message: messages[errorName as AbiErrorName]! }
+
+  return {
+    errorName: 'unknown',
+    message: raw.replace(/^execution reverted:\s*/i, ''),
+  }
+}
+
+/** Serializes an ExecutionError for RPC transport (bigints/numbers → hex). */
+export function serialize(preimage: ExecutionError): Rpc {
+  if (preimage.errorName === 'unknown') return { errorName: 'unknown', message: preimage.message }
+  return {
+    errorName: preimage.errorName,
+    abiItem: preimage.abiItem,
+    message: preimage.message,
+    data: preimage.data,
+  } as never
+}
+
+function extractRevertData(error: unknown): Hex | null {
+  if (!error || typeof error !== 'object') return null
+  const e = error as Record<string, unknown>
+  if (typeof e['data'] === 'string' && e['data'].startsWith('0x')) return e['data'] as Hex
+  if (e['cause']) return extractRevertData(e['cause'])
+  if (e['error']) return extractRevertData(e['error'])
+  if (typeof e['walk'] === 'function') {
+    const inner = (e as { walk: (fn: (e: unknown) => boolean) => unknown }).walk(
+      (e) => typeof (e as Record<string, unknown>)['data'] === 'string',
+    )
+    if (inner) return extractRevertData(inner)
+  }
+  return null
+}