@dextopus/api-sdk 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -217,7 +217,7 @@ type Currency = {
     name?: string;
     decimals?: number;
 };
-type Chain = {
+type Chain$1 = {
     chainId?: number;
     name?: string;
     solverCurrencies: Currency[];
@@ -233,7 +233,7 @@ type DepositToken = {
 };
 type DepositTokensResponse = {
     success: boolean;
-    chains: Chain[];
+    chains: Chain$1[];
     tokens: DepositToken[];
     countChains: number;
     countTokens: number;
@@ -241,7 +241,7 @@ type DepositTokensResponse = {
 /** @deprecated Use Currency instead */
 type RelayCurrency = Currency;
 /** @deprecated Use Chain instead */
-type RelayChain = Chain;
+type RelayChain = Chain$1;
 /** @deprecated Use DepositToken instead */
 type NearToken = {
     assetId: string;
@@ -356,6 +356,13 @@ declare class ApiError extends Error {
     body?: ApiErrorShape | string;
     constructor(status: number, message: string, body?: ApiErrorShape | string);
 }
+/**
+ * Normalize native token address for API compatibility
+ * Convert 0xEeeee... to 0x0000... which is what Relay expects
+ * @param address Token address to normalize
+ * @returns Normalized address
+ */
+declare function normalizeAddress(address: string): string;
 /**
  * Convert human-readable amount to smallest unit
  * @param amount Human-readable amount (e.g., "10" for 10 USDC)
@@ -374,6 +381,128 @@ declare function toSmallestUnit(amount: string, decimals: number): string;
  * @example fromSmallestUnit("1500000000", 9) // Returns "1.5" for 1.5 SOL
  */
 declare function fromSmallestUnit(amount: string, decimals: number): string;
+/**
+ * Chain type for /api/chains endpoint
+ */
+interface Chain {
+    chainId: number;
+    name: string;
+    symbol: string;
+    rpcUrl: string;
+    explorerUrl?: string;
+    logoUrl?: string;
+    icon?: string;
+}
+/**
+ * Token type for deposit chains
+ */
+interface Token {
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    chainId: number;
+    logoUrl?: string;
+}
+/**
+ * Deposit quote request matching widget's interface
+ */
+interface DepositQuoteRequestWidget {
+    originChainId: number;
+    originAsset: string;
+    destinationChainId: number;
+    destinationAsset: string;
+    recipient: string;
+    amount: string;
+    slippageBps?: number;
+    refundTo?: string;
+}
+/**
+ * Deposit quote response matching widget's interface
+ */
+interface DepositQuoteResponseWidget {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress: string;
+    isStaticAddress: boolean;
+    upstreamRequestId: string;
+    upstreamQuoteId: string;
+    amountOut: string;
+    processingTimeSeconds?: number;
+    expiresAt?: string;
+}
+/**
+ * Class-based API client for Dextopus Backend
+ * Provides the same interface as the widget's api.ts
+ */
+declare class DextopusAPI {
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey: string, baseUrl?: string);
+    private fetch;
+    /**
+     * Get all supported chains
+     */
+    getChains(): Promise<Chain[]>;
+    /**
+     * Get all tokens for a specific chain (only Relay solver currencies)
+     */
+    getTokens(chainId: number): Promise<Token[]>;
+    /**
+     * Get destination chains and tokens reachable from source
+     */
+    getDestinations(chainId: number, tokenAddress: string): Promise<{
+        chainId: number;
+        tokens: Array<{
+            tokenAddress: string;
+        }>;
+    }[]>;
+    /**
+     * Get source chains and tokens that can bridge to destination
+     */
+    getSources(destinationChainId: number, destinationTokenAddress: string): Promise<{
+        sourceChainId: number;
+        currency: string;
+        symbol?: string;
+        blockchain?: string;
+        decimals?: number;
+        addressKind: string | null;
+        supportsStaticAddress: boolean;
+    }[]>;
+    /**
+     * Get a deposit quote (generates deposit address and quote)
+     */
+    getDepositQuote(request: DepositQuoteRequestWidget): Promise<DepositQuoteResponseWidget>;
+    /**
+     * Get deposit status by deposit request ID
+     */
+    getDepositStatus(depositRequestId: string): Promise<{
+        success: boolean;
+        depositRequestId: string;
+        depositAddress: string;
+        isStaticAddress: boolean;
+        upstreamRequestId: string;
+        status: string;
+        executionStatus?: string;
+        originTransactionHashes?: string[];
+        destinationTransactionHashes?: string[];
+        raw?: any;
+    }>;
+    /**
+     * List deposit requests for the API key
+     */
+    listDepositRequests(params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }): Promise<any[]>;
+}
+/**
+ * Create a new DextopusAPI client instance
+ * @param apiKey Your API key
+ * @param baseUrl Optional base URL (defaults to http://localhost:3000)
+ */
+declare function createAPIClient(apiKey: string, baseUrl?: string): DextopusAPI;
 declare function createApiClient(options?: ApiClientOptions): {
     quote: (payload: QuoteRequest) => Promise<QuoteResponse>;
     buildTransaction: (payload: BuildTransactionRequest) => Promise<BuildTransactionResponse>;
@@ -386,6 +515,51 @@ declare function createApiClient(options?: ApiClientOptions): {
     depositDestinations: (params: DepositDestinationsParams) => Promise<DepositDestinationsResponse>;
     depositSources: (params: DepositSourcesParams) => Promise<DepositSourcesResponse>;
     depositValidateAddress: (payload: ValidateAddressRequest) => Promise<ValidateAddressResponse>;
+    /**
+     * Get all supported chains with their metadata
+     */
+    getChains: () => Promise<{
+        success: boolean;
+        chains: Array<{
+            chainId: number;
+            name: string;
+            symbol: string;
+            rpcUrl: string;
+            explorerUrl?: string;
+        }>;
+        count: number;
+    }>;
+    /**
+     * Get deposit chains with their Relay solver currencies/tokens
+     */
+    depositChains: () => Promise<{
+        success: boolean;
+        chains: Array<{
+            chainId: number;
+            name?: string;
+            tokens: Array<{
+                address: string;
+                symbol: string;
+                name: string;
+                decimals: number;
+                chainId: number;
+                logoUrl?: string;
+            }>;
+        }>;
+        count: number;
+    }>;
+    /**
+     * List deposit requests for the API key
+     */
+    listDepositRequests: (params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }) => Promise<{
+        success: boolean;
+        requests: Array<Record<string, unknown>>;
+        total: number;
+    }>;
 };
 
-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 };
+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 DepositQuoteRequestWidget, type DepositQuoteResponse, type DepositQuoteResponseWidget, type DepositSource, type DepositSourceChain, type DepositSourcesParams, type DepositSourcesResponse, type DepositStatusParams, type DepositStatusResponse, type DepositSubmitRequest, type DepositSubmitResponse, type DepositToken, type DepositTokensResponse, DextopusAPI, 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 Token, type TransactionPayload, type TransactionSimulation, type TransactionSimulationStep, type TransactionStep, type TronTransactionPayload, type UnifiedToken, type ValidateAddressRequest, type ValidateAddressResponse, createAPIClient, createApiClient, fromSmallestUnit, normalizeAddress, toSmallestUnit };

package/dist/index.d.ts

@@ -217,7 +217,7 @@ type Currency = {
     name?: string;
     decimals?: number;
 };
-type Chain = {
+type Chain$1 = {
     chainId?: number;
     name?: string;
     solverCurrencies: Currency[];
@@ -233,7 +233,7 @@ type DepositToken = {
 };
 type DepositTokensResponse = {
     success: boolean;
-    chains: Chain[];
+    chains: Chain$1[];
     tokens: DepositToken[];
     countChains: number;
     countTokens: number;
@@ -241,7 +241,7 @@ type DepositTokensResponse = {
 /** @deprecated Use Currency instead */
 type RelayCurrency = Currency;
 /** @deprecated Use Chain instead */
-type RelayChain = Chain;
+type RelayChain = Chain$1;
 /** @deprecated Use DepositToken instead */
 type NearToken = {
     assetId: string;
@@ -356,6 +356,13 @@ declare class ApiError extends Error {
     body?: ApiErrorShape | string;
     constructor(status: number, message: string, body?: ApiErrorShape | string);
 }
+/**
+ * Normalize native token address for API compatibility
+ * Convert 0xEeeee... to 0x0000... which is what Relay expects
+ * @param address Token address to normalize
+ * @returns Normalized address
+ */
+declare function normalizeAddress(address: string): string;
 /**
  * Convert human-readable amount to smallest unit
  * @param amount Human-readable amount (e.g., "10" for 10 USDC)
@@ -374,6 +381,128 @@ declare function toSmallestUnit(amount: string, decimals: number): string;
  * @example fromSmallestUnit("1500000000", 9) // Returns "1.5" for 1.5 SOL
  */
 declare function fromSmallestUnit(amount: string, decimals: number): string;
+/**
+ * Chain type for /api/chains endpoint
+ */
+interface Chain {
+    chainId: number;
+    name: string;
+    symbol: string;
+    rpcUrl: string;
+    explorerUrl?: string;
+    logoUrl?: string;
+    icon?: string;
+}
+/**
+ * Token type for deposit chains
+ */
+interface Token {
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    chainId: number;
+    logoUrl?: string;
+}
+/**
+ * Deposit quote request matching widget's interface
+ */
+interface DepositQuoteRequestWidget {
+    originChainId: number;
+    originAsset: string;
+    destinationChainId: number;
+    destinationAsset: string;
+    recipient: string;
+    amount: string;
+    slippageBps?: number;
+    refundTo?: string;
+}
+/**
+ * Deposit quote response matching widget's interface
+ */
+interface DepositQuoteResponseWidget {
+    success: boolean;
+    depositRequestId: string;
+    depositAddress: string;
+    isStaticAddress: boolean;
+    upstreamRequestId: string;
+    upstreamQuoteId: string;
+    amountOut: string;
+    processingTimeSeconds?: number;
+    expiresAt?: string;
+}
+/**
+ * Class-based API client for Dextopus Backend
+ * Provides the same interface as the widget's api.ts
+ */
+declare class DextopusAPI {
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey: string, baseUrl?: string);
+    private fetch;
+    /**
+     * Get all supported chains
+     */
+    getChains(): Promise<Chain[]>;
+    /**
+     * Get all tokens for a specific chain (only Relay solver currencies)
+     */
+    getTokens(chainId: number): Promise<Token[]>;
+    /**
+     * Get destination chains and tokens reachable from source
+     */
+    getDestinations(chainId: number, tokenAddress: string): Promise<{
+        chainId: number;
+        tokens: Array<{
+            tokenAddress: string;
+        }>;
+    }[]>;
+    /**
+     * Get source chains and tokens that can bridge to destination
+     */
+    getSources(destinationChainId: number, destinationTokenAddress: string): Promise<{
+        sourceChainId: number;
+        currency: string;
+        symbol?: string;
+        blockchain?: string;
+        decimals?: number;
+        addressKind: string | null;
+        supportsStaticAddress: boolean;
+    }[]>;
+    /**
+     * Get a deposit quote (generates deposit address and quote)
+     */
+    getDepositQuote(request: DepositQuoteRequestWidget): Promise<DepositQuoteResponseWidget>;
+    /**
+     * Get deposit status by deposit request ID
+     */
+    getDepositStatus(depositRequestId: string): Promise<{
+        success: boolean;
+        depositRequestId: string;
+        depositAddress: string;
+        isStaticAddress: boolean;
+        upstreamRequestId: string;
+        status: string;
+        executionStatus?: string;
+        originTransactionHashes?: string[];
+        destinationTransactionHashes?: string[];
+        raw?: any;
+    }>;
+    /**
+     * List deposit requests for the API key
+     */
+    listDepositRequests(params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }): Promise<any[]>;
+}
+/**
+ * Create a new DextopusAPI client instance
+ * @param apiKey Your API key
+ * @param baseUrl Optional base URL (defaults to http://localhost:3000)
+ */
+declare function createAPIClient(apiKey: string, baseUrl?: string): DextopusAPI;
 declare function createApiClient(options?: ApiClientOptions): {
     quote: (payload: QuoteRequest) => Promise<QuoteResponse>;
     buildTransaction: (payload: BuildTransactionRequest) => Promise<BuildTransactionResponse>;
@@ -386,6 +515,51 @@ declare function createApiClient(options?: ApiClientOptions): {
     depositDestinations: (params: DepositDestinationsParams) => Promise<DepositDestinationsResponse>;
     depositSources: (params: DepositSourcesParams) => Promise<DepositSourcesResponse>;
     depositValidateAddress: (payload: ValidateAddressRequest) => Promise<ValidateAddressResponse>;
+    /**
+     * Get all supported chains with their metadata
+     */
+    getChains: () => Promise<{
+        success: boolean;
+        chains: Array<{
+            chainId: number;
+            name: string;
+            symbol: string;
+            rpcUrl: string;
+            explorerUrl?: string;
+        }>;
+        count: number;
+    }>;
+    /**
+     * Get deposit chains with their Relay solver currencies/tokens
+     */
+    depositChains: () => Promise<{
+        success: boolean;
+        chains: Array<{
+            chainId: number;
+            name?: string;
+            tokens: Array<{
+                address: string;
+                symbol: string;
+                name: string;
+                decimals: number;
+                chainId: number;
+                logoUrl?: string;
+            }>;
+        }>;
+        count: number;
+    }>;
+    /**
+     * List deposit requests for the API key
+     */
+    listDepositRequests: (params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }) => Promise<{
+        success: boolean;
+        requests: Array<Record<string, unknown>>;
+        total: number;
+    }>;
 };
 
-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 };
+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 DepositQuoteRequestWidget, type DepositQuoteResponse, type DepositQuoteResponseWidget, type DepositSource, type DepositSourceChain, type DepositSourcesParams, type DepositSourcesResponse, type DepositStatusParams, type DepositStatusResponse, type DepositSubmitRequest, type DepositSubmitResponse, type DepositToken, type DepositTokensResponse, DextopusAPI, 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 Token, type TransactionPayload, type TransactionSimulation, type TransactionSimulationStep, type TransactionStep, type TronTransactionPayload, type UnifiedToken, type ValidateAddressRequest, type ValidateAddressResponse, createAPIClient, createApiClient, fromSmallestUnit, normalizeAddress, toSmallestUnit };

package/dist/index.js

@@ -21,8 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ApiError: () => ApiError,
+  DextopusAPI: () => DextopusAPI,
+  createAPIClient: () => createAPIClient,
   createApiClient: () => createApiClient,
   fromSmallestUnit: () => fromSmallestUnit,
+  normalizeAddress: () => normalizeAddress,
   toSmallestUnit: () => toSmallestUnit
 });
 module.exports = __toCommonJS(index_exports);
@@ -43,6 +46,14 @@ function buildHeaders(apiKey) {
   if (apiKey) headers["x-api-key"] = apiKey;
   return headers;
 }
+function normalizeAddress(address) {
+  const NATIVE_PLACEHOLDER = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+  const RELAY_NATIVE = "0x0000000000000000000000000000000000000000";
+  if (address.toLowerCase() === NATIVE_PLACEHOLDER.toLowerCase()) {
+    return RELAY_NATIVE;
+  }
+  return address;
+}
 function toSmallestUnit(amount, decimals) {
   const num = parseFloat(amount);
   if (isNaN(num)) {
@@ -75,6 +86,114 @@ async function requestJson(fetcher, url, options, timeoutMs) {
     clearTimeout(timeout);
   }
 }
+var DextopusAPI = class {
+  baseUrl;
+  apiKey;
+  constructor(apiKey, baseUrl = "http://localhost:3000") {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+  }
+  async fetch(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "x-api-key": this.apiKey,
+      ...options.headers
+    };
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(
+          errorData.message || `API request failed: ${response.statusText}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      console.error(`API Error (${endpoint}):`, error);
+      throw error;
+    }
+  }
+  /**
+   * Get all supported chains
+   */
+  async getChains() {
+    const response = await this.fetch("/api/chains");
+    return response.chains;
+  }
+  /**
+   * Get all tokens for a specific chain (only Relay solver currencies)
+   */
+  async getTokens(chainId) {
+    const response = await this.fetch(`/api/deposit/chains`);
+    const chain = response.chains.find((c) => c.chainId === chainId);
+    return chain?.tokens || [];
+  }
+  /**
+   * Get destination chains and tokens reachable from source
+   */
+  async getDestinations(chainId, tokenAddress) {
+    const response = await this.fetch(
+      `/api/destinations?chainId=${chainId}&tokenAddress=${encodeURIComponent(
+        tokenAddress
+      )}`
+    );
+    return response.destinations;
+  }
+  /**
+   * Get source chains and tokens that can bridge to destination
+   */
+  async getSources(destinationChainId, destinationTokenAddress) {
+    const response = await this.fetch(
+      `/api/deposit/sources?destinationChainId=${destinationChainId}&destinationAddress=${encodeURIComponent(
+        destinationTokenAddress
+      )}`
+    );
+    return response.sources;
+  }
+  /**
+   * Get a deposit quote (generates deposit address and quote)
+   */
+  async getDepositQuote(request) {
+    const normalizedRequest = {
+      ...request,
+      originAsset: normalizeAddress(request.originAsset),
+      destinationAsset: normalizeAddress(request.destinationAsset)
+    };
+    const response = await this.fetch(
+      "/api/deposit/quote",
+      {
+        method: "POST",
+        body: JSON.stringify(normalizedRequest)
+      }
+    );
+    return response;
+  }
+  /**
+   * Get deposit status by deposit request ID
+   */
+  async getDepositStatus(depositRequestId) {
+    const response = await this.fetch(`/api/deposit/status?depositRequestId=${encodeURIComponent(depositRequestId)}`);
+    return response;
+  }
+  /**
+   * List deposit requests for the API key
+   */
+  async listDepositRequests(params) {
+    const queryParams = new URLSearchParams();
+    if (params?.limit) queryParams.append("limit", params.limit.toString());
+    if (params?.offset) queryParams.append("offset", params.offset.toString());
+    if (params?.status) queryParams.append("status", params.status);
+    const response = await this.fetch(`/api/deposit/requests?${queryParams}`);
+    return response.requests;
+  }
+};
+function createAPIClient(apiKey, baseUrl) {
+  return new DextopusAPI(apiKey, baseUrl);
+}
 function createApiClient(options = {}) {
   const rawBaseUrl = options.baseUrl || "https://swap-api.dextopus.com";
   const trimmedBaseUrl = rawBaseUrl.replace(/\/+$/, "");
@@ -171,13 +290,50 @@ function createApiClient(options = {}) {
       `${baseUrl}/api/deposit/validate-address`,
       { method: "POST", headers, body: JSON.stringify(payload) },
       timeoutMs
-    )
+    ),
+    /**
+     * Get all supported chains with their metadata
+     */
+    getChains: () => requestJson(
+      fetcher,
+      `${baseUrl}/api/chains`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    /**
+     * Get deposit chains with their Relay solver currencies/tokens
+     */
+    depositChains: () => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/chains`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    /**
+     * List deposit requests for the API key
+     */
+    listDepositRequests: (params) => {
+      const query = new URLSearchParams();
+      if (params?.limit) query.append("limit", String(params.limit));
+      if (params?.offset) query.append("offset", String(params.offset));
+      if (params?.status) query.append("status", params.status);
+      const queryString = query.toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/requests${queryString ? `?${queryString}` : ""}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    }
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiError,
+  DextopusAPI,
+  createAPIClient,
   createApiClient,
   fromSmallestUnit,
+  normalizeAddress,
   toSmallestUnit
 });

package/dist/index.mjs

@@ -14,6 +14,14 @@ function buildHeaders(apiKey) {
   if (apiKey) headers["x-api-key"] = apiKey;
   return headers;
 }
+function normalizeAddress(address) {
+  const NATIVE_PLACEHOLDER = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+  const RELAY_NATIVE = "0x0000000000000000000000000000000000000000";
+  if (address.toLowerCase() === NATIVE_PLACEHOLDER.toLowerCase()) {
+    return RELAY_NATIVE;
+  }
+  return address;
+}
 function toSmallestUnit(amount, decimals) {
   const num = parseFloat(amount);
   if (isNaN(num)) {
@@ -46,6 +54,114 @@ async function requestJson(fetcher, url, options, timeoutMs) {
     clearTimeout(timeout);
   }
 }
+var DextopusAPI = class {
+  baseUrl;
+  apiKey;
+  constructor(apiKey, baseUrl = "http://localhost:3000") {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+  }
+  async fetch(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "x-api-key": this.apiKey,
+      ...options.headers
+    };
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(
+          errorData.message || `API request failed: ${response.statusText}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      console.error(`API Error (${endpoint}):`, error);
+      throw error;
+    }
+  }
+  /**
+   * Get all supported chains
+   */
+  async getChains() {
+    const response = await this.fetch("/api/chains");
+    return response.chains;
+  }
+  /**
+   * Get all tokens for a specific chain (only Relay solver currencies)
+   */
+  async getTokens(chainId) {
+    const response = await this.fetch(`/api/deposit/chains`);
+    const chain = response.chains.find((c) => c.chainId === chainId);
+    return chain?.tokens || [];
+  }
+  /**
+   * Get destination chains and tokens reachable from source
+   */
+  async getDestinations(chainId, tokenAddress) {
+    const response = await this.fetch(
+      `/api/destinations?chainId=${chainId}&tokenAddress=${encodeURIComponent(
+        tokenAddress
+      )}`
+    );
+    return response.destinations;
+  }
+  /**
+   * Get source chains and tokens that can bridge to destination
+   */
+  async getSources(destinationChainId, destinationTokenAddress) {
+    const response = await this.fetch(
+      `/api/deposit/sources?destinationChainId=${destinationChainId}&destinationAddress=${encodeURIComponent(
+        destinationTokenAddress
+      )}`
+    );
+    return response.sources;
+  }
+  /**
+   * Get a deposit quote (generates deposit address and quote)
+   */
+  async getDepositQuote(request) {
+    const normalizedRequest = {
+      ...request,
+      originAsset: normalizeAddress(request.originAsset),
+      destinationAsset: normalizeAddress(request.destinationAsset)
+    };
+    const response = await this.fetch(
+      "/api/deposit/quote",
+      {
+        method: "POST",
+        body: JSON.stringify(normalizedRequest)
+      }
+    );
+    return response;
+  }
+  /**
+   * Get deposit status by deposit request ID
+   */
+  async getDepositStatus(depositRequestId) {
+    const response = await this.fetch(`/api/deposit/status?depositRequestId=${encodeURIComponent(depositRequestId)}`);
+    return response;
+  }
+  /**
+   * List deposit requests for the API key
+   */
+  async listDepositRequests(params) {
+    const queryParams = new URLSearchParams();
+    if (params?.limit) queryParams.append("limit", params.limit.toString());
+    if (params?.offset) queryParams.append("offset", params.offset.toString());
+    if (params?.status) queryParams.append("status", params.status);
+    const response = await this.fetch(`/api/deposit/requests?${queryParams}`);
+    return response.requests;
+  }
+};
+function createAPIClient(apiKey, baseUrl) {
+  return new DextopusAPI(apiKey, baseUrl);
+}
 function createApiClient(options = {}) {
   const rawBaseUrl = options.baseUrl || "https://swap-api.dextopus.com";
   const trimmedBaseUrl = rawBaseUrl.replace(/\/+$/, "");
@@ -142,12 +258,49 @@ function createApiClient(options = {}) {
       `${baseUrl}/api/deposit/validate-address`,
       { method: "POST", headers, body: JSON.stringify(payload) },
       timeoutMs
-    )
+    ),
+    /**
+     * Get all supported chains with their metadata
+     */
+    getChains: () => requestJson(
+      fetcher,
+      `${baseUrl}/api/chains`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    /**
+     * Get deposit chains with their Relay solver currencies/tokens
+     */
+    depositChains: () => requestJson(
+      fetcher,
+      `${baseUrl}/api/deposit/chains`,
+      { method: "GET", headers },
+      timeoutMs
+    ),
+    /**
+     * List deposit requests for the API key
+     */
+    listDepositRequests: (params) => {
+      const query = new URLSearchParams();
+      if (params?.limit) query.append("limit", String(params.limit));
+      if (params?.offset) query.append("offset", String(params.offset));
+      if (params?.status) query.append("status", params.status);
+      const queryString = query.toString();
+      return requestJson(
+        fetcher,
+        `${baseUrl}/api/deposit/requests${queryString ? `?${queryString}` : ""}`,
+        { method: "GET", headers },
+        timeoutMs
+      );
+    }
   };
 }
 export {
   ApiError,
+  DextopusAPI,
+  createAPIClient,
   createApiClient,
   fromSmallestUnit,
+  normalizeAddress,
   toSmallestUnit
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dextopus/api-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Dextopus API SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -8,12 +8,15 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "development": "./src/index.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "development": "./src/index.ts"
+      "require": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",
     "test": "vitest run",