tapimo 0.0.2 → 0.1.0

package/dist/db/tables/webhookSubscriptions.d.ts

@@ -0,0 +1,158 @@
+import type { Selectable } 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 declare function ownerId(owner: Webhooks.Owner): string;
+/** Maps a stored row to the domain subscription (null columns → absent fields). */
+export declare function toSubscription(row: Record): Webhooks.Subscription;
+/**
+ * Inserts a subscription row from its domain value.
+ *
+ * @param db - The database.
+ * @param subscription - The subscription to insert.
+ */
+export declare function insert(db: Db.Db, subscription: Webhooks.Subscription): Promise<void>;
+/**
+ * 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 declare function get(db: Db.Db, owner: Webhooks.Owner, id: string, now: string): Promise<Webhooks.Subscription | 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 declare function list(db: Db.Db, owner: Webhooks.Owner, options: list.Options): Promise<Webhooks.Subscription[]>;
+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 declare function count(db: Db.Db, owner: Webhooks.Owner, now: string): Promise<number>;
+/**
+ * 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 declare function update(db: Db.Db, id: string, set: update.Set): Promise<Webhooks.Subscription | 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 declare function remove(db: Db.Db, owner: Webhooks.Owner, id: string, now: string): Promise<boolean>;
+/**
+ * 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 declare function listActive(db: Db.Db, chainId: number, eventType: Webhooks.EventType, now: string): Promise<Webhooks.Subscription[]>;
+/**
+ * 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 declare function getCursor(db: Db.Db, id: string): Promise<string | 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 declare function setCursor(db: Db.Db, id: string, cursor: string): Promise<void>;
+/**
+ * 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 declare function recordSuccess(db: Db.Db, id: string, now: string): Promise<Webhooks.Subscription | 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 declare function recordFailure(db: Db.Db, id: string, maxFailures: number, now: string): Promise<Webhooks.Subscription | 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 declare function pruneExpired(db: Db.Db, now: string): Promise<number>;
+//# sourceMappingURL=webhookSubscriptions.d.ts.map

package/dist/db/tables/webhookSubscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhookSubscriptions.d.ts","sourceRoot":"","sources":["../../../src/db/tables/webhookSubscriptions.ts"],"names":[],"mappings":"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"}

package/dist/db/tables/webhookSubscriptions.js

@@ -0,0 +1,272 @@
+import { sql } from 'kysely';
+/** Maps an owner union to its stored `ownerId` column value. */
+export function ownerId(owner) {
+    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) {
+    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, subscription) {
+    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, owner, id, now) {
+    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, owner, options) {
+    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);
+}
+/**
+ * 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, owner, now) {
+    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, id, set) {
+    const row = await db.kysely
+        .updateTable('webhook_subscriptions')
+        .set(set)
+        .where('id', '=', id)
+        .returningAll()
+        .executeTakeFirst();
+    return row ? toSubscription(row) : undefined;
+}
+/**
+ * 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, owner, id, now) {
+    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, chainId, eventType, now) {
+    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, id) {
+    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, id, cursor) {
+    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, id, now) {
+    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, id, maxFailures, now) {
+    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, now) {
+    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) {
+    return (eb) => eb.or([eb('expiresAt', 'is', null), eb('expiresAt', '>', now)]);
+}
+//# sourceMappingURL=webhookSubscriptions.js.map

package/dist/db/tables/webhookSubscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhookSubscriptions.js","sourceRoot":"","sources":["../../../src/db/tables/webhookSubscriptions.ts"],"names":[],"mappings":"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"}

package/dist/handlers/internal/executionError.d.ts

@@ -0,0 +1,25 @@
+import { type DecodeErrorResultReturnType, type Hex } 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 declare const messages: Record<AbiErrorName, string>;
+/** Parse a viem error into a structured execution error. */
+export declare function parse(error: Error): ExecutionError;
+/** Serializes an ExecutionError for RPC transport (bigints/numbers → hex). */
+export declare function serialize(preimage: ExecutionError): Rpc;
+export {};
+//# sourceMappingURL=executionError.d.ts.map

package/dist/handlers/internal/executionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionError.d.ts","sourceRoot":"","sources":["../../../src/handlers/internal/executionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,GAAG,EAAqB,MAAM,MAAM,CAAA;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEjC,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAElD,KAAK,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AAC/B,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,KAAK,CAC9B,CAAC,2BAA2B,CAAC,OAAO,CAAC,GAAG;IACtC,IAAI,EAAE,GAAG,CAAA;IACT,OAAO,EAAE,MAAM,CAAA;CAChB,CAAC,GACF;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAC5C,CAAA;AAED,mEAAmE;AACnE,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;AAEnD,uDAAuD;AACvD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAkHjD,CAAA;AAWD,4DAA4D;AAC5D,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,CA+BlD;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,GAAG,CAQvD"}

package/dist/handlers/internal/executionError.js

@@ -0,0 +1,184 @@
+import { decodeErrorResult } from 'viem';
+import { Abis } from 'viem/tempo';
+/** Human-readable messages keyed by ABI error name. */
+export const messages = {
+    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, args) {
+    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) {
+    const raw = error.details ??
+        error.shortMessage ??
+        error.message;
+    const data = extractRevertData(error);
+    if (data) {
+        try {
+            const decoded = decodeErrorResult({ abi: Abis.abis, data });
+            const template = messages[decoded.errorName];
+            return {
+                ...decoded,
+                data,
+                message: template
+                    ? interpolate(template, decoded.args)
+                    : raw.replace(/^execution reverted:\s*/i, ''),
+            };
+        }
+        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] };
+    return {
+        errorName: 'unknown',
+        message: raw.replace(/^execution reverted:\s*/i, ''),
+    };
+}
+/** Serializes an ExecutionError for RPC transport (bigints/numbers → hex). */
+export function serialize(preimage) {
+    if (preimage.errorName === 'unknown')
+        return { errorName: 'unknown', message: preimage.message };
+    return {
+        errorName: preimage.errorName,
+        abiItem: preimage.abiItem,
+        message: preimage.message,
+        data: preimage.data,
+    };
+}
+function extractRevertData(error) {
+    if (!error || typeof error !== 'object')
+        return null;
+    const e = error;
+    if (typeof e['data'] === 'string' && e['data'].startsWith('0x'))
+        return e['data'];
+    if (e['cause'])
+        return extractRevertData(e['cause']);
+    if (e['error'])
+        return extractRevertData(e['error']);
+    if (typeof e['walk'] === 'function') {
+        const inner = e.walk((e) => typeof e['data'] === 'string');
+        if (inner)
+            return extractRevertData(inner);
+    }
+    return null;
+}
+//# sourceMappingURL=executionError.js.map