tapimo 0.7.2 → 0.8.0

package/dist/apps/funding/routes/quotes.js

@@ -0,0 +1,188 @@
+import { Hono } from 'hono';
+import * as z from 'zod/mini';
+import * as Auth from '../../../internal/Auth.js';
+import * as FundingCatalog from '../../../internal/funding/Catalog.js';
+import * as FundingProvider from '../../../internal/funding/Provider.js';
+import * as OpenApi from '../../../internal/OpenApi.js';
+import * as Response from '../../../internal/Response.js';
+import * as Schema from '../../../internal/Schema.js';
+import * as Value from '../../../internal/Value.js';
+import * as ProviderAttempts from '../ProviderAttempts.js';
+/** Zod schemas owned by funding quote resources. */
+export var schema;
+(function (schema) {
+    /** Successful live funding quote. */
+    schema.FundingQuote = FundingProvider.schema.FundingQuote;
+    /** Schemas for the quoteFunding operation. */
+    let quoteFunding;
+    (function (quoteFunding) {
+        /** Query parameters for live funding quotes. */
+        quoteFunding.Query = FundingProvider.schema.QuoteRequest;
+        /** Non-paginated list of successful funding quotes. */
+        quoteFunding.Response = Schema.describe(z.object({
+            data: z.array(schema.FundingQuote).check(z.describe('Successful live funding quotes.')),
+        }), 'A non-paginated list of successful live funding quotes.');
+    })(quoteFunding = schema.quoteFunding || (schema.quoteFunding = {}));
+})(schema || (schema = {}));
+const baseChainExample = {
+    addressFormat: 'hex',
+    id: 'eip155:8453',
+    kind: 'evm',
+    name: 'Base',
+};
+const baseUsdcExample = {
+    address: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+    currency: 'USD',
+    decimals: 6,
+    name: 'USD Coin',
+    standard: 'ERC-20',
+    symbol: 'USDC',
+    tokenKey: 'eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913',
+    verified: true,
+};
+const fundingQuoteResponseExample = {
+    data: [
+        {
+            destinationAmount: Value.tokenAmount({
+                baseUnits: '979295',
+                currency: 'USD',
+                decimals: 6,
+            }),
+            destinationAmountMin: Value.tokenAmount({
+                baseUnits: '939242',
+                currency: 'USD',
+                decimals: 6,
+            }),
+            destinationChain: {
+                addressFormat: 'hex',
+                id: 'eip155:4217',
+                kind: 'evm',
+                name: 'Tempo',
+            },
+            destinationToken: {
+                address: '0x20c000000000000000000000b9537d11c60e8b50',
+                currency: 'USD',
+                decimals: 6,
+                name: 'Bridged USDC (Stargate)',
+                standard: 'TIP-20',
+                symbol: 'USDC.e',
+                tokenKey: 'eip155:4217/erc20:0x20c000000000000000000000b9537d11c60e8b50',
+                verified: true,
+            },
+            id: 'base-usdc-tempo-usdce-relay',
+            provider: { id: 'relay', name: 'Relay' },
+            quality: {
+                estimatedSeconds: 1,
+                liquiditySource: 'providerQuote',
+                sourceDetail: 'relay:quote-v2',
+                tier: 'liquid',
+            },
+            quote: {
+                sampledAt: '2026-01-01T00:00:00.000Z',
+            },
+            sourceAmount: Value.tokenAmount({
+                baseUnits: '1000000',
+                currency: 'USD',
+                decimals: 6,
+            }),
+            sourceChain: baseChainExample,
+            sourceToken: baseUsdcExample,
+        },
+    ],
+};
+/** Mounts live funding quote routes. */
+export function quotes() {
+    return new Hono().get('/v1/funding/quotes', Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }), OpenApi.validate('query', schema.quoteFunding.Query, {
+        code: 'query_invalid',
+        message: 'Invalid query parameters',
+    }), OpenApi.describeRoute({
+        description: 'Returns live quotes for transferring stablecoins to Tempo.',
+        operationId: 'quoteFunding',
+        responses: OpenApi.responses({
+            errors: {
+                400: { codes: ['query_invalid'] },
+                502: {
+                    codes: ['upstream_error'],
+                    description: 'No quote succeeded and at least one matching provider failed unexpectedly.',
+                },
+            },
+            success: {
+                description: 'Live funding quotes. An empty list means no provider returned a quote.',
+                example: fundingQuoteResponseExample,
+                schema: schema.quoteFunding.Response,
+            },
+        }),
+        summary: 'Get quotes',
+        tags: ['Quotes'],
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.paidAccessError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'query_invalid',
+                message: 'Invalid query parameters',
+            });
+        const query = c.req.valid('query');
+        const attempts = [];
+        const catalog = await FundingCatalog.snapshot(c);
+        const providers = c.get('providers').filter(FundingProvider.is);
+        try {
+            c.header('Cache-Control', 'no-store');
+            const data = await FundingProvider.getQuotes({
+                cache: { bypass: cacheBypass(c.req.raw) },
+                catalog,
+                destinationToken: query.destinationToken,
+                onAttempt: (attempt) => attempts.push(attempt),
+                provider: query.provider,
+                providers,
+                sourceAmount: query.sourceAmount,
+                sourceAmountUnits: query.sourceAmountUnits,
+                sourceChain: query.sourceChain,
+                sourceToken: query.sourceToken,
+            });
+            if (attempts.length > 0)
+                c.set('fundingProviderAttempts', attempts.map(ProviderAttempts.format));
+            return c.json(Response.validated(schema.quoteFunding.Response, {
+                data,
+            }), 200);
+        }
+        catch (cause) {
+            const message = requestErrorMessage(cause);
+            if (message)
+                return Response.error(c, { code: 'query_invalid', message, status: 400 });
+            if (cause instanceof FundingProvider.ProviderQuoteError) {
+                if (cause.fundingProviderAttempts.length > 0)
+                    c.set('fundingProviderAttempts', cause.fundingProviderAttempts);
+                if (cause.providerFailure)
+                    c.set('providerFailure', cause.providerFailure);
+                if (cause.providerFailures)
+                    c.set('providerFailures', cause.providerFailures);
+                return Response.error(c, {
+                    code: 'upstream_error',
+                    message: 'Quote providers could not complete the request.',
+                    status: 502,
+                });
+            }
+            throw cause;
+        }
+    });
+}
+// Maps caller-input errors to a specific 400 message; anything else rethrows.
+function requestErrorMessage(cause) {
+    if (cause instanceof FundingProvider.InvalidAmountError)
+        return 'Invalid `sourceAmount`.';
+    if (cause instanceof FundingProvider.UnsupportedDestinationTokenError)
+        return 'Unsupported `destinationToken`.';
+    if (cause instanceof FundingProvider.UnsupportedProviderError)
+        return 'Unsupported `provider`.';
+    if (cause instanceof FundingProvider.UnsupportedSourceChainError)
+        return 'Unsupported `sourceChain`.';
+    return undefined;
+}
+function cacheBypass(request) {
+    const directives = (request.headers.get('Cache-Control') ??
+        request.headers.get('Pragma') ??
+        '').toLowerCase();
+    return directives.includes('no-cache') || directives.includes('no-store');
+}
+//# sourceMappingURL=quotes.js.map

package/dist/apps/funding/routes/quotes.js.map

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