tapimo 0.7.0 → 0.7.2

package/dist/internal/exchange/Provider.d.ts

@@ -0,0 +1,219 @@
+import type { Hex } from 'ox';
+import * as core_Provider from '../Provider.js';
+import type * as Log from '../Log.js';
+/** Exchange quote provider called after the native DEX cannot route a swap. */
+export type Provider<id extends string = string> = core_Provider.Provider<id, 'exchange'> & {
+    /** Converts a signed continuation into final executable calls. */
+    finalizeQuote?(this: void, input: FinalizeQuoteInput, signal: AbortSignal): Promise<FinalizeQuoteResult>;
+    /** Returns the approvals, signature, or executable calls needed to continue. */
+    quote(this: void, input: QuoteInput, signal: AbortSignal): Promise<QuoteResult>;
+};
+/** Provider-neutral unsigned transaction call. */
+export type Call = {
+    /** ABI-encoded call data. */
+    data: Hex.Hex;
+    /** Contract receiving the call. */
+    to: `0x${string}`;
+    /** Native token value as a JSON-RPC quantity. */
+    value: Hex.Hex;
+};
+/** Input used to finish a provider quote after signing. */
+export type FinalizeQuoteInput = {
+    /** Wallet signing and executing the swap. */
+    account: `0x${string}`;
+    /** Tempo chain id. */
+    chainId: number;
+    /** Opaque provider state returned by `quote`. */
+    continuation: string;
+    /** EIP-712 signature requested by the quote result. */
+    signature: Hex.Hex;
+};
+/** Final executable calls returned after a signature. */
+export type FinalizeQuoteResult = {
+    /** Calls to execute in order. */
+    calls: readonly Call[];
+    /** Quote constraints that the final calls must satisfy. */
+    execution: Execution;
+};
+/** Constraints used to validate executable provider calls. */
+export type Execution = QuoteAmounts & {
+    /** Token received by the swap. */
+    destinationToken: `0x${string}`;
+    /** Side whose requested amount remains exact. */
+    mode: 'exactDestination' | 'exactSource';
+    /** Token spent by the swap. */
+    sourceToken: `0x${string}`;
+};
+/** Token movement observed while simulating provider calls. */
+export type Transfer = {
+    /** Amount moved in base units. */
+    amount: bigint;
+    /** Account sending the tokens. */
+    from: `0x${string}`;
+    /** Account receiving the tokens. */
+    to: `0x${string}`;
+    /** Token contract that emitted the transfer. */
+    token: `0x${string}`;
+};
+/** Provider-neutral quote input. */
+export type QuoteInput = {
+    /** Wallet receiving and executing the swap. */
+    account: `0x${string}`;
+    /** Exact source or destination amount in base units. */
+    amount: string;
+    /** Tempo chain id. */
+    chainId: number;
+    /** Token received by the swap. */
+    destinationToken: `0x${string}`;
+    /** Side whose requested amount remains exact. */
+    mode: 'exactDestination' | 'exactSource';
+    /** Maximum execution slippage in basis points. */
+    slippageBps: number;
+    /** Token spent by the swap. */
+    sourceToken: `0x${string}`;
+};
+/** Quote with the approvals, signature, or transaction needed for its next step. */
+export type QuoteResult = (QuoteAmounts & {
+    /** Calls that must confirm before requesting a fresh quote. */
+    approval: {
+        calls: readonly Call[];
+    };
+    /** Onchain approval is required before this swap can be quoted for execution. */
+    status: 'approvalRequired';
+}) | (QuoteAmounts & {
+    /** Quote is ready for execution. */
+    status: 'ready';
+    /** Ordered calls required to execute the quote. */
+    transaction: {
+        calls: readonly Call[];
+    };
+}) | (QuoteAmounts & {
+    /** Opaque provider state passed to `finalizeQuote`. */
+    continuation: string;
+    /** Quote needs a wallet signature before final calldata can be built. */
+    status: 'signatureRequired';
+    /** EIP-712 payload the wallet must sign. */
+    typedData: TypedData;
+});
+/** Defines an exchange provider while preserving its concrete identity. */
+export declare function from<const id extends string>(options: from.Options<id>): Provider<id>;
+export declare namespace from {
+    /** Exchange provider definition. */
+    type Options<id extends string> = Omit<Provider<id>, 'type'>;
+}
+/** Returns whether a registered provider implements exchange quotes. */
+export declare function is(provider: core_Provider.Provider): provider is Provider;
+/** Returns bounded exchange-provider failure details for structured request logs. */
+export declare function failure(cause: unknown, options: failure.Options): Log.ProviderFailure | undefined;
+export declare namespace failure {
+    /** Exchange-provider context retained when a quote operation fails. */
+    type Options = {
+        /** Chain selected by the quote request. */
+        chainId: number;
+        /** Provider operation used when the error has no narrower operation. */
+        operation: string;
+        /** Exchange provider that handled the request. */
+        provider: Provider;
+    };
+}
+/** Validates simulated token movements against an executable quote. */
+export declare function validateExecution(options: validateExecution.Options): void;
+export declare namespace validateExecution {
+    /** Simulated transfers and quote constraints to validate. */
+    type Options = {
+        /** Wallet executing the provider calls. */
+        account: `0x${string}`;
+        /** Quote constraints bound to the executable calls. */
+        execution: Execution;
+        /** Token transfers emitted by the simulated calls. */
+        transfers: readonly Transfer[];
+    };
+}
+/** Amount bounds returned by an exchange provider. */
+export type QuoteAmounts = {
+    /** Expected destination amount in base units. */
+    destinationAmount: string;
+    /** Estimated execution gas units. */
+    gasUnits: string;
+    /** Maximum source amount for an exact-destination quote. */
+    maximumSourceAmount?: string | undefined;
+    /** Minimum destination amount for an exact-source quote. */
+    minimumDestinationAmount?: string | undefined;
+    /** Expected source amount in base units. */
+    sourceAmount: string;
+};
+/** Provider-neutral EIP-712 payload accepted by Privy and common wallet clients. */
+export type TypedData = {
+    /** EIP-712 signing domain. */
+    domain: Record<string, unknown>;
+    /** EIP-712 message values. */
+    message: Record<string, unknown>;
+    /** Root EIP-712 type. */
+    primaryType: string;
+    /** EIP-712 type definitions. */
+    types: Record<string, readonly {
+        name: string;
+        type: string;
+    }[]>;
+};
+/** Raised when a provider has no executable route for the requested swap. */
+export declare class RouteUnavailableError extends Error {
+    name: string;
+}
+/** Raised when a continuation cannot be decoded or validated. */
+export declare class ProviderContinuationError extends Error {
+    name: string;
+}
+/** Raised when required provider configuration is invalid. */
+export declare class ProviderConfigurationError extends Error {
+    name: string;
+}
+/** Raised when an upstream provider request fails before receiving a response. */
+export declare class ProviderNetworkError extends Error {
+    name: string;
+    /** Upstream operation that failed. */
+    operation: string;
+    constructor(options: ProviderNetworkError.Options);
+}
+export declare namespace ProviderNetworkError {
+    /** Safe request details retained for operational reporting. */
+    type Options = {
+        /** Original network error. */
+        cause: TypeError;
+        /** Stable upstream operation identifier. */
+        operation: string;
+    };
+}
+/** Raised when an upstream provider returns an invalid payload. */
+export declare class ProviderPayloadError extends Error {
+    name: string;
+    /** Stable validation code safe for operational reporting. */
+    code?: string | undefined;
+    constructor(options?: ProviderPayloadError.Options);
+}
+export declare namespace ProviderPayloadError {
+    /** Bounded invalid-payload details. */
+    type Options = {
+        /** Stable validation code safe for operational reporting. */
+        code?: string | undefined;
+    };
+}
+/** Raised when an upstream provider request fails. */
+export declare class ProviderResponseError extends Error {
+    name: string;
+    /** Upstream operation that returned the response. */
+    operation: string;
+    /** Upstream HTTP status. */
+    status: number;
+    constructor(options: ProviderResponseError.Options);
+}
+export declare namespace ProviderResponseError {
+    /** Safe upstream response details retained for operational reporting. */
+    type Options = {
+        /** Stable upstream operation identifier. */
+        operation: string;
+        /** Upstream HTTP status. */
+        status: number;
+    };
+}
+//# sourceMappingURL=Provider.d.ts.map

package/dist/internal/exchange/Provider.d.ts.map

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

package/dist/internal/exchange/Provider.js

@@ -0,0 +1,117 @@
+import * as core_Provider from '../Provider.js';
+/** Defines an exchange provider while preserving its concrete identity. */
+export function from(options) {
+    if (options.id !== options.id.trim().toLowerCase() || options.id.length === 0)
+        throw new ProviderConfigurationError('Provider ids must be lowercase and trimmed.');
+    return core_Provider.from({ ...options, type: 'exchange' });
+}
+/** Returns whether a registered provider implements exchange quotes. */
+export function is(provider) {
+    return provider.type === 'exchange' && 'quote' in provider && typeof provider.quote === 'function';
+}
+/** Returns bounded exchange-provider failure details for structured request logs. */
+export function failure(cause, options) {
+    const { chainId, operation, provider } = options;
+    if (cause instanceof ProviderResponseError)
+        return {
+            chainId,
+            failure: cause.status === 429 ? 'rate_limit' : 'http',
+            id: provider.id,
+            operation: cause.operation,
+            status: cause.status,
+        };
+    if (cause instanceof ProviderNetworkError)
+        return { chainId, failure: 'network', id: provider.id, operation: cause.operation };
+    if (cause instanceof ProviderPayloadError)
+        return {
+            chainId,
+            ...(cause.code ? { code: cause.code } : {}),
+            failure: 'payload',
+            id: provider.id,
+            operation,
+        };
+    return undefined;
+}
+/** Validates simulated token movements against an executable quote. */
+export function validateExecution(options) {
+    const account = options.account.toLowerCase();
+    const destinationToken = options.execution.destinationToken.toLowerCase();
+    const sourceToken = options.execution.sourceToken.toLowerCase();
+    let destinationReceived = 0n;
+    let sourceIncoming = 0n;
+    let sourceOutgoing = 0n;
+    for (const transfer of options.transfers) {
+        const token = transfer.token.toLowerCase();
+        if (transfer.from.toLowerCase() === account) {
+            if (token !== sourceToken)
+                throw new ProviderPayloadError();
+            sourceOutgoing += transfer.amount;
+        }
+        if (transfer.to.toLowerCase() !== account)
+            continue;
+        if (token === sourceToken)
+            sourceIncoming += transfer.amount;
+        if (token === destinationToken)
+            destinationReceived += transfer.amount;
+    }
+    const sourceSpent = sourceOutgoing - sourceIncoming;
+    if (sourceSpent <= 0n)
+        throw new ProviderPayloadError();
+    if (options.execution.mode === 'exactSource') {
+        if (sourceSpent !== BigInt(options.execution.sourceAmount) ||
+            options.execution.minimumDestinationAmount === undefined ||
+            destinationReceived < BigInt(options.execution.minimumDestinationAmount))
+            throw new ProviderPayloadError();
+        return;
+    }
+    if (options.execution.maximumSourceAmount === undefined ||
+        sourceSpent > BigInt(options.execution.maximumSourceAmount) ||
+        destinationReceived < BigInt(options.execution.destinationAmount))
+        throw new ProviderPayloadError();
+}
+/** Raised when a provider has no executable route for the requested swap. */
+export class RouteUnavailableError extends Error {
+    name = 'ExchangeProvider.RouteUnavailableError';
+}
+/** Raised when a continuation cannot be decoded or validated. */
+export class ProviderContinuationError extends Error {
+    name = 'ExchangeProvider.ProviderContinuationError';
+}
+/** Raised when required provider configuration is invalid. */
+export class ProviderConfigurationError extends Error {
+    name = 'ExchangeProvider.ProviderConfigurationError';
+}
+/** Raised when an upstream provider request fails before receiving a response. */
+export class ProviderNetworkError extends Error {
+    name = 'ExchangeProvider.ProviderNetworkError';
+    /** Upstream operation that failed. */
+    operation;
+    constructor(options) {
+        super(`Provider ${options.operation} request failed`, { cause: options.cause });
+        this.operation = options.operation;
+    }
+}
+/** Raised when an upstream provider returns an invalid payload. */
+export class ProviderPayloadError extends Error {
+    name = 'ExchangeProvider.ProviderPayloadError';
+    /** Stable validation code safe for operational reporting. */
+    code;
+    constructor(options = {}) {
+        super(options.code ? `Provider payload failed ${options.code}` : undefined);
+        this.code = options.code;
+    }
+}
+/** Raised when an upstream provider request fails. */
+export class ProviderResponseError extends Error {
+    name = 'ExchangeProvider.ProviderResponseError';
+    /** Upstream operation that returned the response. */
+    operation;
+    /** Upstream HTTP status. */
+    status;
+    constructor(options) {
+        super(`Provider ${options.operation} request failed with status ${options.status}`);
+        this.operation = options.operation;
+        this.status = options.status;
+    }
+}
+//# sourceMappingURL=Provider.js.map

package/dist/internal/exchange/Provider.js.map

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

package/dist/internal/exchange/index.d.ts

@@ -0,0 +1,2 @@
+export * as Provider from './Provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/exchange/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/exchange/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/dist/internal/exchange/index.js

@@ -0,0 +1,2 @@
+export * as Provider from './Provider.js';
+//# sourceMappingURL=index.js.map

package/dist/internal/exchange/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/exchange/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/dist/internal/exchange/providers/uniswap.d.ts

@@ -0,0 +1,57 @@
+import { Hex } from 'ox';
+import * as Provider from '../Provider.js';
+/** Creates a Uniswap Trading API provider restricted to executable AMM routes. */
+export declare function uniswap(options: uniswap.Options): Provider.Provider<"uniswap">;
+export declare namespace uniswap {
+    /** Uniswap Trading API provider options. */
+    type Options = {
+        /** Uniswap Trading API key. */
+        apiKey: string;
+    };
+}
+/** Validates a Uniswap approval response before its calls are returned to a wallet. */
+export declare function validateApprovalResponse(response: unknown): {
+    approval: {
+        chainId: number;
+        data: `0x${string}`;
+        from: `0x${string}`;
+        gasLimit?: string | undefined;
+        to: `0x${string}`;
+        value: string;
+    } | null;
+    cancel: {
+        chainId: number;
+        data: `0x${string}`;
+        from: `0x${string}`;
+        gasLimit?: string | undefined;
+        to: `0x${string}`;
+        value: string;
+    } | null;
+};
+/** Accepts exact-source minimums that preserve the requested slippage after integer rounding. */
+export declare function validateExactSourceMinimum(options: validateExactSourceMinimum.Options): void;
+export declare namespace validateExactSourceMinimum {
+    /** Upstream destination amounts and requested slippage to compare. */
+    type Options = {
+        /** Quoted destination amount in base units. */
+        amount: string;
+        /** Minimum destination amount in base units. */
+        minimumAmount?: string | undefined;
+        /** Requested slippage in basis points. */
+        slippageBps: number;
+    };
+}
+/** Rejects exact-source quotes that expand the wallet authorization amount. */
+export declare function validateExactSourceMaximum(options: validateExactSourceMaximum.Options): void;
+export declare namespace validateExactSourceMaximum {
+    /** Requested and upstream source bounds to compare. */
+    type Options = {
+        /** Exact source amount requested by the caller. */
+        amount: string;
+        /** Optional maximum source amount returned upstream. */
+        maximumAmount?: string | undefined;
+    };
+}
+/** Rejects Universal Router calldata with capabilities outside token swaps and payments. */
+export declare function validateRouterCalldata(data: Hex.Hex): void;
+//# sourceMappingURL=uniswap.d.ts.map

package/dist/internal/exchange/providers/uniswap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap.d.ts","sourceRoot":"","sources":["../../../../src/internal/exchange/providers/uniswap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,GAAG,EAAE,MAAM,IAAI,CAAA;AAItC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAwH1C,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,gCA4L/C;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,4CAA4C;IAC5C,KAAK,OAAO,GAAG;QACb,+BAA+B;QAC/B,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO;;;;;;;;;;;;;;;;;EAUzD;AAwFD,iGAAiG;AACjG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,CAAC,OAAO,GAAG,IAAI,CAQ5F;AAED,MAAM,CAAC,OAAO,WAAW,0BAA0B,CAAC;IAClD,sEAAsE;IACtE,KAAK,OAAO,GAAG;QACb,+CAA+C;QAC/C,MAAM,EAAE,MAAM,CAAA;QACd,gDAAgD;QAChD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAClC,0CAA0C;QAC1C,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,CAAC,OAAO,GAAG,IAAI,CAG5F;AAED,MAAM,CAAC,OAAO,WAAW,0BAA0B,CAAC;IAClD,uDAAuD;IACvD,KAAK,OAAO,GAAG;QACb,mDAAmD;QACnD,MAAM,EAAE,MAAM,CAAA;QACd,wDAAwD;QACxD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACnC,CAAA;CACF;AA6BD,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAS1D"}