@dextopus/api-sdk 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,391 @@
+type PartnerFee = {
+    recipient: string;
+    feeBPS: number;
+};
+type QuoteRequest = {
+    chainIdFrom: number;
+    chainIdTo?: number;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    includeBridges?: string[];
+    partnerFees?: PartnerFee[];
+};
+type FeeBreakdown = {
+    type: 'protocol' | 'integrator' | 'gas' | 'bridge' | 'swap' | string;
+    amount: string;
+    token: string;
+    recipient?: string;
+};
+type FeeDetails = {
+    total: string;
+    breakdown: FeeBreakdown[];
+};
+type QuoteEdge = {
+    from: {
+        chainId: number;
+        tokenAddress: string;
+    };
+    to: {
+        chainId: number;
+        tokenAddress: string;
+    };
+    adaptor: string;
+    type: 'swap' | 'bridge';
+    amountIn: string;
+    estimatedAmountOut: string;
+    priceImpact: string;
+    fees: {
+        total: string;
+        breakdown: Array<{
+            type: string;
+            amount: string;
+            token?: string;
+        }>;
+    };
+    gasEstimate: string;
+    metadata: Record<string, unknown>;
+    timestamp: number;
+};
+type QuoteRoute = {
+    quoteId: string;
+    path: QuoteEdge[];
+    sourceToken: {
+        chainId: number;
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    destToken: {
+        chainId: number;
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    amountIn: string;
+    amountOut: string;
+    fees: FeeDetails;
+    priceImpact: string;
+    estimatedGas: string;
+    expiresAt: number;
+};
+type QuoteAlternativeRoute = {
+    path: QuoteEdge[];
+    amountOut: string;
+    fees: FeeDetails;
+};
+type QuoteResponse = {
+    quoteId: string;
+    bestRoute: QuoteRoute;
+    alternativeRoutes: QuoteAlternativeRoute[];
+};
+type BuildTransactionRequest = {
+    quoteId: string;
+    userAddress: string;
+    recipient?: string;
+    partnerFees?: PartnerFee[];
+    simulate?: boolean;
+};
+type EvmTransactionPayload = {
+    from: string;
+    to: string;
+    data: string;
+    value: string;
+    chainId: number;
+    gasLimit?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    nonce?: number;
+};
+type TronTransactionPayload = {
+    from: string;
+    to: string;
+    input: string;
+    callValue: string;
+    chainId: number;
+};
+type TransactionPayload = EvmTransactionPayload | TronTransactionPayload;
+type TransactionStep = {
+    step: number;
+    adaptor: string;
+    type: 'approval' | 'diamond';
+    chainId: number;
+    transaction: TransactionPayload;
+    description: string;
+};
+type TransactionSimulationStep = {
+    step: number;
+    type: string;
+    adaptor: string;
+    chainId: number;
+    estimated: boolean;
+    gas?: string;
+    error?: string;
+};
+type TransactionSimulation = {
+    allEstimated: boolean;
+    steps: TransactionSimulationStep[];
+};
+type BuildTransactionResponse = {
+    quoteId: string;
+    transactions: TransactionStep[];
+    totalSteps: number;
+    expiresAt: number;
+    simulation?: TransactionSimulation;
+};
+type DepositFee = {
+    recipient: string;
+    fee: number;
+};
+type DepositQuoteRequest = {
+    originChainId: number;
+    destinationChainId: number;
+    originAsset: string;
+    destinationAsset: string;
+    amount: string;
+    recipient: string;
+    refundTo?: string;
+    user?: string;
+    slippageBps?: number;
+    dry?: boolean;
+    partnerFees?: DepositFee[];
+    /**
+     * If provided, amount is treated as human-readable (e.g., "10" for 10 USDC)
+     * and will be converted to smallest unit using this decimals value.
+     * If not provided, amount is treated as smallest unit (backward compatible).
+     */
+    decimals?: number;
+    /**
+     * Request a static/reusable deposit address.
+     * When true, requests a deposit address that:
+     * - Can be reused for multiple deposits
+     * - Remains valid after quote rate expires (rate recalculated at deposit time)
+     * - Accepts different tokens (e.g., send USDC when quote was for SOL)
+     * Note: Only available for supported routes. Check supportsStaticAddress field.
+     */
+    static?: boolean;
+};
+type DepositStatusParams = {
+    depositRequestId?: string;
+    depositAddress?: string;
+    requestId?: string;
+};
+type DepositSubmitRequest = {
+    depositRequestId?: string;
+    depositAddress?: string;
+    txHash: string;
+};
+type DepositQuoteResponse = {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress: string;
+    isStaticAddress?: boolean;
+    upstreamRequestId?: string;
+    upstreamQuoteId?: string;
+    amountOut?: string;
+    minAmountOut?: string;
+    status?: string;
+    sentAppFees?: DepositFee[];
+    effectiveUpstreamAppFees?: DepositFee[];
+    expiresInSeconds?: number;
+};
+type DepositStatusResponse = {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress?: string;
+    isStaticAddress?: boolean;
+    upstreamRequestId?: string;
+    status?: string;
+    executionStatus?: string;
+    sentAppFees?: DepositFee[];
+    effectiveUpstreamAppFees?: DepositFee[];
+    originTransactionHashes?: string[];
+    destinationTransactionHashes?: string[];
+    raw?: Record<string, unknown>;
+};
+type DepositSubmitResponse = {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress: string;
+    result: Record<string, unknown>;
+};
+type Currency = {
+    address?: string;
+    id?: string;
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+};
+type Chain = {
+    chainId?: number;
+    name?: string;
+    solverCurrencies: Currency[];
+    supportsStaticAddress?: boolean;
+};
+type DepositToken = {
+    address: string;
+    symbol: string;
+    blockchain: string;
+    chainId?: number;
+    decimals?: number;
+    supportsStaticAddress: boolean;
+};
+type DepositTokensResponse = {
+    success: boolean;
+    chains: Chain[];
+    tokens: DepositToken[];
+    countChains: number;
+    countTokens: number;
+};
+/** @deprecated Use Currency instead */
+type RelayCurrency = Currency;
+/** @deprecated Use Chain instead */
+type RelayChain = Chain;
+/** @deprecated Use DepositToken instead */
+type NearToken = {
+    assetId: string;
+    decimals: number;
+    blockchain: string;
+    symbol: string;
+    price?: number;
+    priceUpdatedAt?: string;
+    contractAddress?: string | null;
+};
+/** @deprecated Use DepositToken instead */
+type UnifiedToken = DepositToken;
+type AddressKind = 'evm' | 'near' | 'solana' | 'tron' | 'bitcoin' | 'litecoin' | 'stellar' | 'sui' | 'ton' | 'xrp';
+type DepositDestination = {
+    currency: string;
+    symbol?: string;
+    blockchain?: string;
+    destinationChainId?: number;
+    decimals?: number;
+    addressKind: AddressKind | null;
+    supportsStaticAddress: boolean;
+};
+type DepositDestinationChain = {
+    blockchain: string;
+    chainId?: number;
+    addressKind: AddressKind | null;
+    count: number;
+    supportsStaticAddress: boolean;
+};
+type DepositDestinationsResponse = {
+    success: boolean;
+    originAssetId?: string;
+    originAddress?: string;
+    originAddressKind: AddressKind | null;
+    destinations: DepositDestination[];
+    destinationChains: DepositDestinationChain[];
+    count: number;
+};
+type DepositSource = {
+    currency: string;
+    symbol?: string;
+    blockchain?: string;
+    sourceChainId?: number;
+    decimals?: number;
+    addressKind: AddressKind | null;
+    supportsStaticAddress: boolean;
+};
+type DepositSourceChain = {
+    blockchain: string;
+    chainId?: number;
+    addressKind: AddressKind | null;
+    count: number;
+    supportsStaticAddress: boolean;
+};
+type DepositSourcesResponse = {
+    success: boolean;
+    destinationAssetId?: string;
+    destinationAddress?: string;
+    destinationAddressKind: AddressKind | null;
+    sources: DepositSource[];
+    sourceChains: DepositSourceChain[];
+    count: number;
+};
+type DepositDestinationsParams = {
+    originAssetId?: string;
+    originAddress?: string;
+    originChainId?: number;
+};
+type DepositSourcesParams = {
+    destinationAssetId?: string;
+    destinationAddress?: string;
+    destinationChainId?: number;
+};
+type ValidateAddressRequest = {
+    chainType: AddressKind;
+    address: string;
+};
+type ValidateAddressResponse = {
+    success: boolean;
+    valid: boolean;
+    reason?: string;
+};
+type HealthResponse = {
+    status: 'healthy' | 'degraded';
+    service: string;
+    version: string;
+    timestamp: number;
+    dependencies: Record<string, 'up' | 'down'>;
+};
+type ApiErrorDetail = {
+    field: string;
+    message: string;
+};
+type ApiErrorShape = {
+    error?: string;
+    message?: string;
+    errorCode?: string;
+    quoteId?: string;
+    expiresAt?: number;
+    expiredAt?: string;
+    details?: ApiErrorDetail[];
+};
+
+type ApiClientOptions = {
+    baseUrl?: string;
+    apiKey?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+};
+declare class ApiError extends Error {
+    status: number;
+    body?: ApiErrorShape | string;
+    constructor(status: number, message: string, body?: ApiErrorShape | string);
+}
+/**
+ * Convert human-readable amount to smallest unit
+ * @param amount Human-readable amount (e.g., "10" for 10 USDC)
+ * @param decimals Token decimals (e.g., 6 for USDC, 9 for SOL)
+ * @returns Amount in smallest unit as string
+ * @example toSmallestUnit("10", 6) // Returns "10000000" for 10 USDC
+ * @example toSmallestUnit("1.5", 9) // Returns "1500000000" for 1.5 SOL
+ */
+declare function toSmallestUnit(amount: string, decimals: number): string;
+/**
+ * Convert smallest unit amount to human-readable format
+ * @param amount Amount in smallest unit (e.g., "10000000" for USDC)
+ * @param decimals Token decimals (e.g., 6 for USDC, 9 for SOL)
+ * @returns Human-readable amount as string
+ * @example fromSmallestUnit("10000000", 6) // Returns "10" for 10 USDC
+ * @example fromSmallestUnit("1500000000", 9) // Returns "1.5" for 1.5 SOL
+ */
+declare function fromSmallestUnit(amount: string, decimals: number): string;
+declare function createApiClient(options?: ApiClientOptions): {
+    quote: (payload: QuoteRequest) => Promise<QuoteResponse>;
+    buildTransaction: (payload: BuildTransactionRequest) => Promise<BuildTransactionResponse>;
+    getQuoteById: (quoteId: string) => Promise<QuoteResponse>;
+    health: () => Promise<HealthResponse>;
+    depositQuote: (payload: DepositQuoteRequest) => Promise<DepositQuoteResponse>;
+    depositStatus: (params: DepositStatusParams) => Promise<DepositStatusResponse>;
+    depositSubmit: (payload: DepositSubmitRequest) => Promise<DepositSubmitResponse>;
+    depositTokens: () => Promise<DepositTokensResponse>;
+    depositDestinations: (params: DepositDestinationsParams) => Promise<DepositDestinationsResponse>;
+    depositSources: (params: DepositSourcesParams) => Promise<DepositSourcesResponse>;
+    depositValidateAddress: (payload: ValidateAddressRequest) => Promise<ValidateAddressResponse>;
+};
+
+export { type AddressKind, ApiError, type ApiErrorDetail, type ApiErrorShape, type BuildTransactionRequest, type BuildTransactionResponse, type Chain, type Currency, type DepositDestination, type DepositDestinationChain, type DepositDestinationsParams, type DepositDestinationsResponse, type DepositFee, type DepositQuoteRequest, type DepositQuoteResponse, type DepositSource, type DepositSourceChain, type DepositSourcesParams, type DepositSourcesResponse, type DepositStatusParams, type DepositStatusResponse, type DepositSubmitRequest, type DepositSubmitResponse, type DepositToken, type DepositTokensResponse, type EvmTransactionPayload, type FeeBreakdown, type FeeDetails, type HealthResponse, type NearToken, type PartnerFee, type QuoteAlternativeRoute, type QuoteEdge, type QuoteRequest, type QuoteResponse, type QuoteRoute, type RelayChain, type RelayCurrency, type TransactionPayload, type TransactionSimulation, type TransactionSimulationStep, type TransactionStep, type TronTransactionPayload, type UnifiedToken, type ValidateAddressRequest, type ValidateAddressResponse, createApiClient, fromSmallestUnit, toSmallestUnit };

package/dist/index.d.ts

@@ -0,0 +1,391 @@
+type PartnerFee = {
+    recipient: string;
+    feeBPS: number;
+};
+type QuoteRequest = {
+    chainIdFrom: number;
+    chainIdTo?: number;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    includeBridges?: string[];
+    partnerFees?: PartnerFee[];
+};
+type FeeBreakdown = {
+    type: 'protocol' | 'integrator' | 'gas' | 'bridge' | 'swap' | string;
+    amount: string;
+    token: string;
+    recipient?: string;
+};
+type FeeDetails = {
+    total: string;
+    breakdown: FeeBreakdown[];
+};
+type QuoteEdge = {
+    from: {
+        chainId: number;
+        tokenAddress: string;
+    };
+    to: {
+        chainId: number;
+        tokenAddress: string;
+    };
+    adaptor: string;
+    type: 'swap' | 'bridge';
+    amountIn: string;
+    estimatedAmountOut: string;
+    priceImpact: string;
+    fees: {
+        total: string;
+        breakdown: Array<{
+            type: string;
+            amount: string;
+            token?: string;
+        }>;
+    };
+    gasEstimate: string;
+    metadata: Record<string, unknown>;
+    timestamp: number;
+};
+type QuoteRoute = {
+    quoteId: string;
+    path: QuoteEdge[];
+    sourceToken: {
+        chainId: number;
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    destToken: {
+        chainId: number;
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    amountIn: string;
+    amountOut: string;
+    fees: FeeDetails;
+    priceImpact: string;
+    estimatedGas: string;
+    expiresAt: number;
+};
+type QuoteAlternativeRoute = {
+    path: QuoteEdge[];
+    amountOut: string;
+    fees: FeeDetails;
+};
+type QuoteResponse = {
+    quoteId: string;
+    bestRoute: QuoteRoute;
+    alternativeRoutes: QuoteAlternativeRoute[];
+};
+type BuildTransactionRequest = {
+    quoteId: string;
+    userAddress: string;
+    recipient?: string;
+    partnerFees?: PartnerFee[];
+    simulate?: boolean;
+};
+type EvmTransactionPayload = {
+    from: string;
+    to: string;
+    data: string;
+    value: string;
+    chainId: number;
+    gasLimit?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    nonce?: number;
+};
+type TronTransactionPayload = {
+    from: string;
+    to: string;
+    input: string;
+    callValue: string;
+    chainId: number;
+};
+type TransactionPayload = EvmTransactionPayload | TronTransactionPayload;
+type TransactionStep = {
+    step: number;
+    adaptor: string;
+    type: 'approval' | 'diamond';
+    chainId: number;
+    transaction: TransactionPayload;
+    description: string;
+};
+type TransactionSimulationStep = {
+    step: number;
+    type: string;
+    adaptor: string;
+    chainId: number;
+    estimated: boolean;
+    gas?: string;
+    error?: string;
+};
+type TransactionSimulation = {
+    allEstimated: boolean;
+    steps: TransactionSimulationStep[];
+};
+type BuildTransactionResponse = {
+    quoteId: string;
+    transactions: TransactionStep[];
+    totalSteps: number;
+    expiresAt: number;
+    simulation?: TransactionSimulation;
+};
+type DepositFee = {
+    recipient: string;
+    fee: number;
+};
+type DepositQuoteRequest = {
+    originChainId: number;
+    destinationChainId: number;
+    originAsset: string;
+    destinationAsset: string;
+    amount: string;
+    recipient: string;
+    refundTo?: string;
+    user?: string;
+    slippageBps?: number;
+    dry?: boolean;
+    partnerFees?: DepositFee[];
+    /**
+     * If provided, amount is treated as human-readable (e.g., "10" for 10 USDC)
+     * and will be converted to smallest unit using this decimals value.
+     * If not provided, amount is treated as smallest unit (backward compatible).
+     */
+    decimals?: number;
+    /**
+     * Request a static/reusable deposit address.
+     * When true, requests a deposit address that:
+     * - Can be reused for multiple deposits
+     * - Remains valid after quote rate expires (rate recalculated at deposit time)
+     * - Accepts different tokens (e.g., send USDC when quote was for SOL)
+     * Note: Only available for supported routes. Check supportsStaticAddress field.
+     */
+    static?: boolean;
+};
+type DepositStatusParams = {
+    depositRequestId?: string;
+    depositAddress?: string;
+    requestId?: string;
+};
+type DepositSubmitRequest = {
+    depositRequestId?: string;
+    depositAddress?: string;
+    txHash: string;
+};
+type DepositQuoteResponse = {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress: string;
+    isStaticAddress?: boolean;
+    upstreamRequestId?: string;
+    upstreamQuoteId?: string;
+    amountOut?: string;
+    minAmountOut?: string;
+    status?: string;
+    sentAppFees?: DepositFee[];
+    effectiveUpstreamAppFees?: DepositFee[];
+    expiresInSeconds?: number;
+};
+type DepositStatusResponse = {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress?: string;
+    isStaticAddress?: boolean;
+    upstreamRequestId?: string;
+    status?: string;
+    executionStatus?: string;
+    sentAppFees?: DepositFee[];
+    effectiveUpstreamAppFees?: DepositFee[];
+    originTransactionHashes?: string[];
+    destinationTransactionHashes?: string[];
+    raw?: Record<string, unknown>;
+};
+type DepositSubmitResponse = {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress: string;
+    result: Record<string, unknown>;
+};
+type Currency = {
+    address?: string;
+    id?: string;
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+};
+type Chain = {
+    chainId?: number;
+    name?: string;
+    solverCurrencies: Currency[];
+    supportsStaticAddress?: boolean;
+};
+type DepositToken = {
+    address: string;
+    symbol: string;
+    blockchain: string;
+    chainId?: number;
+    decimals?: number;
+    supportsStaticAddress: boolean;
+};
+type DepositTokensResponse = {
+    success: boolean;
+    chains: Chain[];
+    tokens: DepositToken[];
+    countChains: number;
+    countTokens: number;
+};
+/** @deprecated Use Currency instead */
+type RelayCurrency = Currency;
+/** @deprecated Use Chain instead */
+type RelayChain = Chain;
+/** @deprecated Use DepositToken instead */
+type NearToken = {
+    assetId: string;
+    decimals: number;
+    blockchain: string;
+    symbol: string;
+    price?: number;
+    priceUpdatedAt?: string;
+    contractAddress?: string | null;
+};
+/** @deprecated Use DepositToken instead */
+type UnifiedToken = DepositToken;
+type AddressKind = 'evm' | 'near' | 'solana' | 'tron' | 'bitcoin' | 'litecoin' | 'stellar' | 'sui' | 'ton' | 'xrp';
+type DepositDestination = {
+    currency: string;
+    symbol?: string;
+    blockchain?: string;
+    destinationChainId?: number;
+    decimals?: number;
+    addressKind: AddressKind | null;
+    supportsStaticAddress: boolean;
+};
+type DepositDestinationChain = {
+    blockchain: string;
+    chainId?: number;
+    addressKind: AddressKind | null;
+    count: number;
+    supportsStaticAddress: boolean;
+};
+type DepositDestinationsResponse = {
+    success: boolean;
+    originAssetId?: string;
+    originAddress?: string;
+    originAddressKind: AddressKind | null;
+    destinations: DepositDestination[];
+    destinationChains: DepositDestinationChain[];
+    count: number;
+};
+type DepositSource = {
+    currency: string;
+    symbol?: string;
+    blockchain?: string;
+    sourceChainId?: number;
+    decimals?: number;
+    addressKind: AddressKind | null;
+    supportsStaticAddress: boolean;
+};
+type DepositSourceChain = {
+    blockchain: string;
+    chainId?: number;
+    addressKind: AddressKind | null;
+    count: number;
+    supportsStaticAddress: boolean;
+};
+type DepositSourcesResponse = {
+    success: boolean;
+    destinationAssetId?: string;
+    destinationAddress?: string;
+    destinationAddressKind: AddressKind | null;
+    sources: DepositSource[];
+    sourceChains: DepositSourceChain[];
+    count: number;
+};
+type DepositDestinationsParams = {
+    originAssetId?: string;
+    originAddress?: string;
+    originChainId?: number;
+};
+type DepositSourcesParams = {
+    destinationAssetId?: string;
+    destinationAddress?: string;
+    destinationChainId?: number;
+};
+type ValidateAddressRequest = {
+    chainType: AddressKind;
+    address: string;
+};
+type ValidateAddressResponse = {
+    success: boolean;
+    valid: boolean;
+    reason?: string;
+};
+type HealthResponse = {
+    status: 'healthy' | 'degraded';
+    service: string;
+    version: string;
+    timestamp: number;
+    dependencies: Record<string, 'up' | 'down'>;
+};
+type ApiErrorDetail = {
+    field: string;
+    message: string;
+};
+type ApiErrorShape = {
+    error?: string;
+    message?: string;
+    errorCode?: string;
+    quoteId?: string;
+    expiresAt?: number;
+    expiredAt?: string;
+    details?: ApiErrorDetail[];
+};
+
+type ApiClientOptions = {
+    baseUrl?: string;
+    apiKey?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+};
+declare class ApiError extends Error {
+    status: number;
+    body?: ApiErrorShape | string;
+    constructor(status: number, message: string, body?: ApiErrorShape | string);
+}
+/**
+ * Convert human-readable amount to smallest unit
+ * @param amount Human-readable amount (e.g., "10" for 10 USDC)
+ * @param decimals Token decimals (e.g., 6 for USDC, 9 for SOL)
+ * @returns Amount in smallest unit as string
+ * @example toSmallestUnit("10", 6) // Returns "10000000" for 10 USDC
+ * @example toSmallestUnit("1.5", 9) // Returns "1500000000" for 1.5 SOL
+ */
+declare function toSmallestUnit(amount: string, decimals: number): string;
+/**
+ * Convert smallest unit amount to human-readable format
+ * @param amount Amount in smallest unit (e.g., "10000000" for USDC)
+ * @param decimals Token decimals (e.g., 6 for USDC, 9 for SOL)
+ * @returns Human-readable amount as string
+ * @example fromSmallestUnit("10000000", 6) // Returns "10" for 10 USDC
+ * @example fromSmallestUnit("1500000000", 9) // Returns "1.5" for 1.5 SOL
+ */
+declare function fromSmallestUnit(amount: string, decimals: number): string;
+declare function createApiClient(options?: ApiClientOptions): {
+    quote: (payload: QuoteRequest) => Promise<QuoteResponse>;
+    buildTransaction: (payload: BuildTransactionRequest) => Promise<BuildTransactionResponse>;
+    getQuoteById: (quoteId: string) => Promise<QuoteResponse>;
+    health: () => Promise<HealthResponse>;
+    depositQuote: (payload: DepositQuoteRequest) => Promise<DepositQuoteResponse>;
+    depositStatus: (params: DepositStatusParams) => Promise<DepositStatusResponse>;
+    depositSubmit: (payload: DepositSubmitRequest) => Promise<DepositSubmitResponse>;
+    depositTokens: () => Promise<DepositTokensResponse>;
+    depositDestinations: (params: DepositDestinationsParams) => Promise<DepositDestinationsResponse>;
+    depositSources: (params: DepositSourcesParams) => Promise<DepositSourcesResponse>;
+    depositValidateAddress: (payload: ValidateAddressRequest) => Promise<ValidateAddressResponse>;
+};
+
+export { type AddressKind, ApiError, type ApiErrorDetail, type ApiErrorShape, type BuildTransactionRequest, type BuildTransactionResponse, type Chain, type Currency, type DepositDestination, type DepositDestinationChain, type DepositDestinationsParams, type DepositDestinationsResponse, type DepositFee, type DepositQuoteRequest, type DepositQuoteResponse, type DepositSource, type DepositSourceChain, type DepositSourcesParams, type DepositSourcesResponse, type DepositStatusParams, type DepositStatusResponse, type DepositSubmitRequest, type DepositSubmitResponse, type DepositToken, type DepositTokensResponse, type EvmTransactionPayload, type FeeBreakdown, type FeeDetails, type HealthResponse, type NearToken, type PartnerFee, type QuoteAlternativeRoute, type QuoteEdge, type QuoteRequest, type QuoteResponse, type QuoteRoute, type RelayChain, type RelayCurrency, type TransactionPayload, type TransactionSimulation, type TransactionSimulationStep, type TransactionStep, type TronTransactionPayload, type UnifiedToken, type ValidateAddressRequest, type ValidateAddressResponse, createApiClient, fromSmallestUnit, toSmallestUnit };

package/dist/index.js

@@ -0,0 +1,183 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ApiError: () => ApiError,
+  createApiClient: () => createApiClient,
+  fromSmallestUnit: () => fromSmallestUnit,
+  toSmallestUnit: () => toSmallestUnit
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var ApiError = class extends Error {
+  status;
+  body;
+  constructor(status, message, body) {
+    super(message);
+    this.name = "ApiError";
+    this.status = status;
+    this.body = body;
+  }
+};
+function buildHeaders(apiKey) {
+  const headers = { "content-type": "application/json" };
+  if (apiKey) headers["x-api-key"] = apiKey;
+  return headers;
+}
+function toSmallestUnit(amount, decimals) {
+  const num = parseFloat(amount);
+  if (isNaN(num)) {
+    throw new Error(`Invalid amount: ${amount}`);
+  }
+  const multiplier = Math.pow(10, decimals);
+  const smallestUnit = Math.floor(num * multiplier);
+  return smallestUnit.toString();
+}
+function fromSmallestUnit(amount, decimals) {
+  const num = parseFloat(amount);
+  if (isNaN(num)) {
+    throw new Error(`Invalid amount: ${amount}`);
+  }
+  const divisor = Math.pow(10, decimals);
+  return (num / divisor).toString();
+}
+async function requestJson(fetcher, url, options, timeoutMs) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetcher(url, { ...options, signal: controller.signal });
+    const text = await res.text();
+    const body = text ? JSON.parse(text) : void 0;
+    if (!res.ok) {
+      throw new ApiError(res.status, body?.message || res.statusText, body || text);
+    }
+    return body;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function createApiClient(options = {}) {
+  const rawBaseUrl = options.baseUrl || "https://swap-api.dextopus.com";
+  const trimmedBaseUrl = rawBaseUrl.replace(/\/+$/, "");
+  const baseUrl = trimmedBaseUrl.endsWith("/api") ? trimmedBaseUrl.slice(0, -4) : trimmedBaseUrl;
+  const apiKey = options.apiKey;
+  const fetcher = options.fetch || fetch;
+  const timeoutMs = options.timeoutMs ?? 1e4;
+  const headers = buildHeaders(apiKey);
+  return {
+    quote: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/quote`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    ),
+    buildTransaction: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/build-transaction`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    ),
+    getQuoteById: (quoteId) => requestJson(
+      fetcher,
+      `${baseUrl}/api/quote/${quoteId}`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    health: () => requestJson(
+      fetcher,
+      `${baseUrl}/health`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    depositQuote: (payload) => {
+      const apiPayload = { ...payload };
+      if (payload.decimals !== void 0) {
+        apiPayload.amount = toSmallestUnit(payload.amount, payload.decimals);
+        delete apiPayload.decimals;
+      }
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/quote`,
+        { method: "POST", headers, body: JSON.stringify(apiPayload) },
+        timeoutMs
+      );
+    },
+    depositStatus: (params) => {
+      const query = new URLSearchParams(
+        Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+      ).toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/status?${query}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    },
+    depositSubmit: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/submit`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    ),
+    depositTokens: () => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/tokens`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    depositDestinations: (params) => {
+      const query = new URLSearchParams(
+        Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+      ).toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/destinations?${query}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    },
+    depositSources: (params) => {
+      const query = new URLSearchParams(
+        Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+      ).toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/sources?${query}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    },
+    depositValidateAddress: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/validate-address`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    )
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiError,
+  createApiClient,
+  fromSmallestUnit,
+  toSmallestUnit
+});

package/dist/index.mjs

@@ -0,0 +1,153 @@
+// src/client.ts
+var ApiError = class extends Error {
+  status;
+  body;
+  constructor(status, message, body) {
+    super(message);
+    this.name = "ApiError";
+    this.status = status;
+    this.body = body;
+  }
+};
+function buildHeaders(apiKey) {
+  const headers = { "content-type": "application/json" };
+  if (apiKey) headers["x-api-key"] = apiKey;
+  return headers;
+}
+function toSmallestUnit(amount, decimals) {
+  const num = parseFloat(amount);
+  if (isNaN(num)) {
+    throw new Error(`Invalid amount: ${amount}`);
+  }
+  const multiplier = Math.pow(10, decimals);
+  const smallestUnit = Math.floor(num * multiplier);
+  return smallestUnit.toString();
+}
+function fromSmallestUnit(amount, decimals) {
+  const num = parseFloat(amount);
+  if (isNaN(num)) {
+    throw new Error(`Invalid amount: ${amount}`);
+  }
+  const divisor = Math.pow(10, decimals);
+  return (num / divisor).toString();
+}
+async function requestJson(fetcher, url, options, timeoutMs) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetcher(url, { ...options, signal: controller.signal });
+    const text = await res.text();
+    const body = text ? JSON.parse(text) : void 0;
+    if (!res.ok) {
+      throw new ApiError(res.status, body?.message || res.statusText, body || text);
+    }
+    return body;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function createApiClient(options = {}) {
+  const rawBaseUrl = options.baseUrl || "https://swap-api.dextopus.com";
+  const trimmedBaseUrl = rawBaseUrl.replace(/\/+$/, "");
+  const baseUrl = trimmedBaseUrl.endsWith("/api") ? trimmedBaseUrl.slice(0, -4) : trimmedBaseUrl;
+  const apiKey = options.apiKey;
+  const fetcher = options.fetch || fetch;
+  const timeoutMs = options.timeoutMs ?? 1e4;
+  const headers = buildHeaders(apiKey);
+  return {
+    quote: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/quote`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    ),
+    buildTransaction: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/build-transaction`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    ),
+    getQuoteById: (quoteId) => requestJson(
+      fetcher,
+      `${baseUrl}/api/quote/${quoteId}`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    health: () => requestJson(
+      fetcher,
+      `${baseUrl}/health`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    depositQuote: (payload) => {
+      const apiPayload = { ...payload };
+      if (payload.decimals !== void 0) {
+        apiPayload.amount = toSmallestUnit(payload.amount, payload.decimals);
+        delete apiPayload.decimals;
+      }
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/quote`,
+        { method: "POST", headers, body: JSON.stringify(apiPayload) },
+        timeoutMs
+      );
+    },
+    depositStatus: (params) => {
+      const query = new URLSearchParams(
+        Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+      ).toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/status?${query}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    },
+    depositSubmit: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/submit`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    ),
+    depositTokens: () => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/tokens`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    depositDestinations: (params) => {
+      const query = new URLSearchParams(
+        Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+      ).toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/destinations?${query}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    },
+    depositSources: (params) => {
+      const query = new URLSearchParams(
+        Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+      ).toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/sources?${query}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    },
+    depositValidateAddress: (payload) => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/validate-address`,
+      { method: "POST", headers, body: JSON.stringify(payload) },
+      timeoutMs
+    )
+  };
+}
+export {
+  ApiError,
+  createApiClient,
+  fromSmallestUnit,
+  toSmallestUnit
+};

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@dextopus/api-sdk",
+  "version": "0.1.0",
+  "description": "Dextopus API SDK",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "development": "./src/index.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "test": "vitest run",
+    "lint": "echo 'lint skipped'"
+  }
+}