@agglayer/sdk 1.0.0-beta.17 → 1.0.0-beta.18

package/dist/index.d.mts

@@ -202,7 +202,8 @@ interface ProviderMetadata {
         readonly transactionRequest?: unknown;
     };
     readonly agglayer?: {
-        readonly bridgeAddress: string | null;
+        readonly bridgeAddress: string | undefined;
+        readonly claimTransactionRequired: boolean | undefined;
     };
     readonly [key: string]: unknown;
 }
@@ -235,7 +236,7 @@ interface Route {
     readonly feeCosts: FeeCost[];
     readonly gasCosts: GasCost[];
     readonly steps: Step[];
-    readonly transactionRequest?: UnsignedTransaction;
+    readonly transactionRequest?: UnsignedTransaction | undefined;
     readonly providerMetadata: ProviderMetadata;
     readonly riskFactors: RiskFactors | null;
     readonly createdAt: number;
@@ -258,7 +259,7 @@ interface RoutesRequestParams {
     readonly fromTokenAddress: string;
     readonly toTokenAddress: string;
     readonly amount: string;
-    readonly fromAddress: string;
+    readonly fromAddress?: string;
     readonly toAddress?: string;
     readonly slippage?: number;
     readonly preferences?: RoutePreferences;
@@ -495,9 +496,9 @@ declare const SDK_MODES: {
 type SDKMode = (typeof SDK_MODES)[keyof typeof SDK_MODES];
 
 interface SDKConfig {
-    mode: SDKMode[];
-    core: CoreConfig;
-    native: NativeConfig;
+    mode?: SDKMode[];
+    core?: CoreConfig;
+    native?: NativeConfig;
 }
 
 /**
@@ -778,7 +779,7 @@ declare class NativeClient {
 declare class CoreClient {
     private config;
     private arcApiService;
-    constructor(config: CoreConfig);
+    constructor(config?: CoreConfig);
     /**
      * Generic pagination helper for chains API calls (limit and offset based pagination)
      * Handles automatic pagination to fetch all available data
@@ -836,6 +837,36 @@ declare class CoreClient {
     getTransactions(transactionsRequestQueryParams: TransactionsRequestQueryParams): Promise<TransactionsResponse>;
 }
 
+/**
+ * API Error Class
+ *
+ * Custom error class to preserve API error details
+ */
+
+declare class ApiError extends Error {
+    readonly code: number;
+    readonly name: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(errorResponse: ErrorResponse);
+    /**
+     * Create API error from error response
+     */
+    static fromErrorResponse(errorResponse: ErrorResponse): ApiError;
+    /**
+     * Create fallback error when API completely fails
+     */
+    static createFallbackError(originalError: Error, operation: string): ApiError;
+    /**
+     * Convert to plain object for serialization
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: number;
+        details: Record<string, unknown> | undefined;
+    };
+}
+
 /**
  * AggLayer SDK - Main SDK
  *
@@ -846,7 +877,7 @@ declare class AggLayerSDK {
     private config;
     private core?;
     private native?;
-    constructor(config: SDKConfig);
+    constructor(config?: SDKConfig);
     /**
      * Get core submodule
      */
@@ -857,4 +888,4 @@ declare class AggLayerSDK {
     getNative(): NativeClient;
 }
 
-export { AggLayerSDK, type ApiResponse, type BaseContractConfig, type BridgeAssetParams, type BridgeConfig, type BridgeMessageParams, type BridgeOptions, type BuildClaimTransactionRequestParam, type BuildClaimTransactionResponse, type BuildTransactionRequestBody, type BuildTransactionResponse, type ChainConfig, type ChainsQueryParams, type ChainsResponse, type ClaimAssetParams, type ClaimMessageParams, type CoreConfig, type CursorPagination, type CustomChainConfig, type ERC20Config, type ErrorResponse, type FeeCost, type GasCost, type IChain, type IsClaimedParams, type NativeConfig, type OffsetPagination, type OriginTokenInfoParams, type Pagination, type PrecalculatedWrapperParams, type ProviderMetadata, type RiskFactors, type RiskLevel, type Route, type RoutePreferences, type RouteStep, type RoutesRequestParams, type RoutesResponse, type SDKConfig, type SDKMode, SDK_MODES, type Step, type StepAction, type StepEstimate, type StepType, type SuccessResponse, type TokenInfo, type TokenReference, type ToolDetails, type Transaction, type TransactionParams, type TransactionsRequestQueryParams, type TransactionsResponse, type WrappedTokenParams };
+export { AggLayerSDK, ApiError, type ApiResponse, type BaseContractConfig, type BridgeAssetParams, type BridgeConfig, type BridgeMessageParams, type BridgeOptions, type BuildClaimTransactionRequestParam, type BuildClaimTransactionResponse, type BuildTransactionRequestBody, type BuildTransactionResponse, type ChainConfig, type ChainsQueryParams, type ChainsResponse, type ClaimAssetParams, type ClaimMessageParams, type CoreConfig, type CursorPagination, type CustomChainConfig, type ERC20Config, type ErrorResponse, type FeeCost, type GasCost, type IChain, type IsClaimedParams, type NativeConfig, type OffsetPagination, type OriginTokenInfoParams, type Pagination, type PrecalculatedWrapperParams, type ProviderMetadata, type RiskFactors, type RiskLevel, type Route, type RoutePreferences, type RouteStep, type RoutesRequestParams, type RoutesResponse, type SDKConfig, type SDKMode, SDK_MODES, type Step, type StepAction, type StepEstimate, type StepType, type SuccessResponse, type TokenInfo, type TokenReference, type ToolDetails, type Transaction, type TransactionParams, type TransactionsRequestQueryParams, type TransactionsResponse, type WrappedTokenParams };

package/dist/index.d.ts

@@ -202,7 +202,8 @@ interface ProviderMetadata {
         readonly transactionRequest?: unknown;
     };
     readonly agglayer?: {
-        readonly bridgeAddress: string | null;
+        readonly bridgeAddress: string | undefined;
+        readonly claimTransactionRequired: boolean | undefined;
     };
     readonly [key: string]: unknown;
 }
@@ -235,7 +236,7 @@ interface Route {
     readonly feeCosts: FeeCost[];
     readonly gasCosts: GasCost[];
     readonly steps: Step[];
-    readonly transactionRequest?: UnsignedTransaction;
+    readonly transactionRequest?: UnsignedTransaction | undefined;
     readonly providerMetadata: ProviderMetadata;
     readonly riskFactors: RiskFactors | null;
     readonly createdAt: number;
@@ -258,7 +259,7 @@ interface RoutesRequestParams {
     readonly fromTokenAddress: string;
     readonly toTokenAddress: string;
     readonly amount: string;
-    readonly fromAddress: string;
+    readonly fromAddress?: string;
     readonly toAddress?: string;
     readonly slippage?: number;
     readonly preferences?: RoutePreferences;
@@ -495,9 +496,9 @@ declare const SDK_MODES: {
 type SDKMode = (typeof SDK_MODES)[keyof typeof SDK_MODES];
 
 interface SDKConfig {
-    mode: SDKMode[];
-    core: CoreConfig;
-    native: NativeConfig;
+    mode?: SDKMode[];
+    core?: CoreConfig;
+    native?: NativeConfig;
 }
 
 /**
@@ -778,7 +779,7 @@ declare class NativeClient {
 declare class CoreClient {
     private config;
     private arcApiService;
-    constructor(config: CoreConfig);
+    constructor(config?: CoreConfig);
     /**
      * Generic pagination helper for chains API calls (limit and offset based pagination)
      * Handles automatic pagination to fetch all available data
@@ -836,6 +837,36 @@ declare class CoreClient {
     getTransactions(transactionsRequestQueryParams: TransactionsRequestQueryParams): Promise<TransactionsResponse>;
 }
 
+/**
+ * API Error Class
+ *
+ * Custom error class to preserve API error details
+ */
+
+declare class ApiError extends Error {
+    readonly code: number;
+    readonly name: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(errorResponse: ErrorResponse);
+    /**
+     * Create API error from error response
+     */
+    static fromErrorResponse(errorResponse: ErrorResponse): ApiError;
+    /**
+     * Create fallback error when API completely fails
+     */
+    static createFallbackError(originalError: Error, operation: string): ApiError;
+    /**
+     * Convert to plain object for serialization
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: number;
+        details: Record<string, unknown> | undefined;
+    };
+}
+
 /**
  * AggLayer SDK - Main SDK
  *
@@ -846,7 +877,7 @@ declare class AggLayerSDK {
     private config;
     private core?;
     private native?;
-    constructor(config: SDKConfig);
+    constructor(config?: SDKConfig);
     /**
      * Get core submodule
      */
@@ -857,4 +888,4 @@ declare class AggLayerSDK {
     getNative(): NativeClient;
 }
 
-export { AggLayerSDK, type ApiResponse, type BaseContractConfig, type BridgeAssetParams, type BridgeConfig, type BridgeMessageParams, type BridgeOptions, type BuildClaimTransactionRequestParam, type BuildClaimTransactionResponse, type BuildTransactionRequestBody, type BuildTransactionResponse, type ChainConfig, type ChainsQueryParams, type ChainsResponse, type ClaimAssetParams, type ClaimMessageParams, type CoreConfig, type CursorPagination, type CustomChainConfig, type ERC20Config, type ErrorResponse, type FeeCost, type GasCost, type IChain, type IsClaimedParams, type NativeConfig, type OffsetPagination, type OriginTokenInfoParams, type Pagination, type PrecalculatedWrapperParams, type ProviderMetadata, type RiskFactors, type RiskLevel, type Route, type RoutePreferences, type RouteStep, type RoutesRequestParams, type RoutesResponse, type SDKConfig, type SDKMode, SDK_MODES, type Step, type StepAction, type StepEstimate, type StepType, type SuccessResponse, type TokenInfo, type TokenReference, type ToolDetails, type Transaction, type TransactionParams, type TransactionsRequestQueryParams, type TransactionsResponse, type WrappedTokenParams };
+export { AggLayerSDK, ApiError, type ApiResponse, type BaseContractConfig, type BridgeAssetParams, type BridgeConfig, type BridgeMessageParams, type BridgeOptions, type BuildClaimTransactionRequestParam, type BuildClaimTransactionResponse, type BuildTransactionRequestBody, type BuildTransactionResponse, type ChainConfig, type ChainsQueryParams, type ChainsResponse, type ClaimAssetParams, type ClaimMessageParams, type CoreConfig, type CursorPagination, type CustomChainConfig, type ERC20Config, type ErrorResponse, type FeeCost, type GasCost, type IChain, type IsClaimedParams, type NativeConfig, type OffsetPagination, type OriginTokenInfoParams, type Pagination, type PrecalculatedWrapperParams, type ProviderMetadata, type RiskFactors, type RiskLevel, type Route, type RoutePreferences, type RouteStep, type RoutesRequestParams, type RoutesResponse, type SDKConfig, type SDKMode, SDK_MODES, type Step, type StepAction, type StepEstimate, type StepType, type SuccessResponse, type TokenInfo, type TokenReference, type ToolDetails, type Transaction, type TransactionParams, type TransactionsRequestQueryParams, type TransactionsResponse, type WrappedTokenParams };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AggLayerSDK: () => AggLayerSDK,
+  ApiError: () => ApiError,
   SDK_MODES: () => SDK_MODES
 });
 module.exports = __toCommonJS(index_exports);
@@ -38,7 +39,33 @@ var ChainRegistry = class _ChainRegistry {
     }
     return _ChainRegistry.instance;
   }
+  // DEV: if adding new default chains, also update README.md
   initializeDefaultChains() {
+    this.registerChain({
+      chainId: 1,
+      networkId: 0,
+      name: "Ethereum",
+      rpcUrl: "https://eth.llamarpc.com",
+      nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+      blockExplorer: { name: "Etherscan", url: "https://etherscan.io" },
+      bridgeAddress: "",
+      proofApiUrl: "https://api-gateway.polygon.technology/api/v3/proof/mainnet/",
+      isTestnet: false
+    });
+    this.registerChain({
+      chainId: 747474,
+      networkId: 20,
+      name: "Katana",
+      rpcUrl: "https://rpc.katana.network",
+      nativeCurrency: { name: "Ethereum", symbol: "ETH", decimals: 18 },
+      blockExplorer: {
+        name: "Katana Explorer",
+        url: "https://katanascan.com"
+      },
+      bridgeAddress: "",
+      proofApiUrl: "https://api-gateway.polygon.technology/api/v3/proof/mainnet/",
+      isTestnet: false
+    });
     this.registerChain({
       chainId: 11155111,
       networkId: 0,
@@ -53,20 +80,6 @@ var ChainRegistry = class _ChainRegistry {
       proofApiUrl: "https://api-gateway.polygon.technology/api/v3/proof/testnet/",
       isTestnet: true
     });
-    this.registerChain({
-      chainId: 2442,
-      networkId: 1,
-      name: "Polygon Cardona",
-      rpcUrl: "https://rpc.cardona.zkevm-rpc.com",
-      nativeCurrency: { name: "Ethereum", symbol: "ETH", decimals: 18 },
-      blockExplorer: {
-        name: "Cardona PolygonScan",
-        url: "https://cardona-zkevm.polygonscan.com"
-      },
-      bridgeAddress: "0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582",
-      proofApiUrl: "https://api-gateway.polygon.technology/api/v3/proof/testnet/",
-      isTestnet: true
-    });
   }
   /**
    * Register a new chain
@@ -1410,14 +1423,16 @@ var ERC20 = class extends BaseContract {
 var import_viem6 = require("viem");
 
 // src/constants.ts
-var NETWORKS = {
-  SEPOLIA: 11155111,
-  CARDONA: 2442
-};
-var DEFAULT_NETWORK = NETWORKS.SEPOLIA;
+var ARC_API_BASE_URL = "https://arc-api.polygon.technology";
+var ARC_API_DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_CHAINS_PER_PAGE = 100;
 var DEFAULT_CHAINS_WITH_TOKENS_PER_PAGE = 1;
 var MAX_TRANSACTIONS_PER_PAGE = 100;
+var NETWORKS = {
+  ETHEREUM: 1,
+  KATANA: 747474
+};
+var DEFAULT_NETWORK = NETWORKS.ETHEREUM;
 
 // src/native/index.ts
 var NativeClient = class {
@@ -1607,9 +1622,6 @@ var HttpClient = class {
         signal: controller.signal
       });
       clearTimeout(timeoutId);
-      if (!response.ok) {
-        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-      }
       let data;
       const contentType = response.headers.get("content-type");
       if (contentType?.includes("application/json")) {
@@ -1617,6 +1629,12 @@ var HttpClient = class {
       } else {
         data = await response.text();
       }
+      if (!response.ok) {
+        if (contentType?.includes("application/json")) {
+        } else {
+          throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+      }
       return {
         data,
         status: response.status,
@@ -1705,7 +1723,7 @@ var ArcApiService = class {
     );
   }
   async buildClaimTransaction(sourceNetworkId, depositCount) {
-    return this.httpClient.get("/routes/build-transaction-for-claim", {
+    return this.httpClient.post("/routes/build-transaction-for-claim", {
       sourceNetworkId,
       depositCount
     });
@@ -1718,20 +1736,63 @@ var ArcApiService = class {
   }
 };
 
+// src/core/utils/apiError.ts
+var ApiError = class _ApiError extends Error {
+  constructor(errorResponse) {
+    super(errorResponse.message);
+    this.name = errorResponse.name;
+    this.code = errorResponse.code;
+    this.details = errorResponse.details;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _ApiError);
+    }
+  }
+  /**
+   * Create API error from error response
+   */
+  static fromErrorResponse(errorResponse) {
+    return new _ApiError(errorResponse);
+  }
+  /**
+   * Create fallback error when API completely fails
+   */
+  static createFallbackError(originalError, operation) {
+    return new _ApiError({
+      status: "error",
+      message: `${operation} failed: ${originalError.message}`,
+      name: "ApiConnectionError",
+      code: 500,
+      details: {
+        originalError: originalError.message,
+        operation
+      }
+    });
+  }
+  /**
+   * Convert to plain object for serialization
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      details: this.details
+    };
+  }
+};
+
 // src/core/index.ts
 var CoreClient = class {
   constructor(config) {
-    this.config = config;
-    if (!this.config) {
-      throw new Error("Config is required");
-    }
-    if (!this.config.apiBaseUrl) {
-      throw new Error("API base URL is required");
-    }
+    this.config = {
+      ...config,
+      apiBaseUrl: config?.apiBaseUrl || ARC_API_BASE_URL,
+      apiTimeout: config?.apiTimeout || ARC_API_DEFAULT_TIMEOUT
+    };
     const { apiBaseUrl, apiTimeout } = this.config;
     this.arcApiService = new ArcApiService({
-      baseUrl: apiBaseUrl,
-      timeout: apiTimeout ?? 3e4
+      baseUrl: apiBaseUrl || ARC_API_BASE_URL,
+      timeout: apiTimeout || ARC_API_DEFAULT_TIMEOUT
     });
   }
   /**
@@ -1741,57 +1802,64 @@ var CoreClient = class {
    * @param pageSize - Number of items per page (defaults to DEFAULT_CHAINS_PER_PAGE)
    */
   async getAllChainsPaginated(params, pageSize = DEFAULT_CHAINS_PER_PAGE) {
-    const firstResponse = await this.arcApiService.chains({
-      ...params,
-      limit: pageSize
-    });
-    if (firstResponse.data.status !== "success") {
-      throw new Error(firstResponse.data.message);
-    }
-    const firstPageData = firstResponse.data.data;
-    const pagination = firstResponse.data.pagination;
-    const firstPageChains = Array.isArray(firstPageData) ? firstPageData : [];
-    if (!pagination?.total || pagination.total <= pageSize) {
-      return {
-        chains: firstPageChains
-      };
-    }
-    const totalPages = Math.ceil(pagination.total / pageSize);
-    const remainingPages = totalPages - 1;
-    if (remainingPages === 0) {
+    try {
+      const firstResponse = await this.arcApiService.chains({
+        ...params,
+        limit: pageSize
+      });
+      if (firstResponse.data.status !== "success") {
+        throw ApiError.fromErrorResponse(firstResponse.data);
+      }
+      const firstPageData = firstResponse.data.data;
+      const pagination = firstResponse.data.pagination;
+      const firstPageChains = Array.isArray(firstPageData) ? firstPageData : [];
+      if (!pagination?.total || pagination.total <= pageSize) {
+        return {
+          chains: firstPageChains
+        };
+      }
+      const totalPages = Math.ceil(pagination.total / pageSize);
+      const remainingPages = totalPages - 1;
+      if (remainingPages === 0) {
+        return {
+          chains: firstPageChains
+        };
+      }
+      const remainingPagePromises = Array.from(
+        { length: remainingPages },
+        (_, index) => {
+          const offset = (index + 1) * pageSize;
+          return this.arcApiService.chains({
+            ...params,
+            limit: pageSize,
+            offset
+          });
+        }
+      );
+      const remainingResponses = await Promise.all(remainingPagePromises);
+      for (const response of remainingResponses) {
+        if (response.data.status !== "success") {
+          throw ApiError.fromErrorResponse(response.data);
+        }
+      }
+      const allChains = [
+        ...firstPageChains,
+        ...remainingResponses.flatMap((response) => {
+          if (response.data.status === "success") {
+            return Array.isArray(response.data.data) ? response.data.data : [];
+          }
+          return [];
+        })
+      ];
       return {
-        chains: firstPageChains
+        chains: allChains
       };
-    }
-    const remainingPagePromises = Array.from(
-      { length: remainingPages },
-      (_, index) => {
-        const offset = (index + 1) * pageSize;
-        return this.arcApiService.chains({
-          ...params,
-          limit: pageSize,
-          offset
-        });
-      }
-    );
-    const remainingResponses = await Promise.all(remainingPagePromises);
-    for (const response of remainingResponses) {
-      if (response.data.status !== "success") {
-        throw new Error(response.data.message);
+    } catch (error) {
+      if (error instanceof ApiError) {
+        throw error;
       }
+      throw ApiError.createFallbackError(error, "Get chains metadata");
     }
-    const allChains = [
-      ...firstPageChains,
-      ...remainingResponses.flatMap((response) => {
-        if (response.data.status === "success") {
-          return Array.isArray(response.data.data) ? response.data.data : [];
-        }
-        return [];
-      })
-    ];
-    return {
-      chains: allChains
-    };
   }
   /**
    * Get all chains metadata from AggLayer API
@@ -1835,11 +1903,18 @@ var CoreClient = class {
    * Get all routes from AggLayer API
    */
   async getRoutes(routesRequestParams) {
-    const response = await this.arcApiService.routes(routesRequestParams);
-    if (response.data.status === "success") {
-      return response.data.data;
+    try {
+      const response = await this.arcApiService.routes(routesRequestParams);
+      if (response.data.status === "success") {
+        return response.data.data;
+      }
+      throw ApiError.fromErrorResponse(response.data);
+    } catch (error) {
+      if (error instanceof ApiError) {
+        throw error;
+      }
+      throw ApiError.createFallbackError(error, "Get routes");
     }
-    throw new Error(response.data.message);
   }
   /**
    * Get calldata from a route
@@ -1851,13 +1926,28 @@ var CoreClient = class {
       return route.transactionRequest;
     }
     if (route.steps.length === 0 || !route.steps[0]) {
-      throw new Error("Route has no steps to build transaction from");
+      throw ApiError.createFallbackError(
+        new Error("Route has no steps to build transaction from"),
+        "Get unsigned transaction"
+      );
     }
-    const response = await this.arcApiService.buildTransaction(route.steps[0]);
-    if (response.data.status === "success") {
-      return response.data.data;
+    try {
+      const response = await this.arcApiService.buildTransaction(
+        route.steps[0]
+      );
+      if (response.data.status === "success") {
+        return response.data.data;
+      }
+      throw ApiError.fromErrorResponse(response.data);
+    } catch (error) {
+      if (error instanceof ApiError) {
+        throw error;
+      }
+      throw ApiError.createFallbackError(
+        error,
+        "Get unsigned transaction"
+      );
     }
-    throw new Error(response.data.message);
   }
   /**
    * Get calldata for claim step
@@ -1869,53 +1959,68 @@ var CoreClient = class {
    * @param depositCount - The deposit count associated with the transfer.
    */
   async getClaimUnsignedTransaction(buildClaimTxParams) {
-    const response = await this.arcApiService.buildClaimTransaction(
-      buildClaimTxParams.sourceNetworkId,
-      buildClaimTxParams.depositCount
-    );
-    if (response.data.status === "success") {
-      return response.data.data;
+    try {
+      const response = await this.arcApiService.buildClaimTransaction(
+        buildClaimTxParams.sourceNetworkId,
+        buildClaimTxParams.depositCount
+      );
+      if (response.data.status === "success") {
+        return response.data.data;
+      }
+      throw ApiError.fromErrorResponse(response.data);
+    } catch (error) {
+      if (error instanceof ApiError) {
+        throw error;
+      }
+      throw ApiError.createFallbackError(
+        error,
+        "Get claim unsigned transaction"
+      );
     }
-    throw new Error(response.data.message);
   }
   /**
    * Get all transactions via web sockets
    */
   async getTransactions(transactionsRequestQueryParams) {
     if (transactionsRequestQueryParams.limit && transactionsRequestQueryParams.limit > MAX_TRANSACTIONS_PER_PAGE) {
-      throw new Error(
-        `Limit cannot be greater than ${MAX_TRANSACTIONS_PER_PAGE}`
+      throw ApiError.createFallbackError(
+        new Error(`Limit cannot be greater than ${MAX_TRANSACTIONS_PER_PAGE}`),
+        "Get transactions"
       );
     }
-    const response = await this.arcApiService.transactions(
-      transactionsRequestQueryParams
-    );
-    if (response.data.status === "success") {
-      return response.data.data;
+    try {
+      const response = await this.arcApiService.transactions(
+        transactionsRequestQueryParams
+      );
+      if (response.data.status === "success") {
+        return response.data.data;
+      }
+      throw ApiError.fromErrorResponse(response.data);
+    } catch (error) {
+      if (error instanceof ApiError) {
+        throw error;
+      }
+      throw ApiError.createFallbackError(error, "Get transactions");
     }
-    throw new Error(response.data.message);
   }
 };
 
 // src/index.ts
+var defaultConfig = {
+  mode: [SDK_MODES.CORE]
+};
 var AggLayerSDK = class {
-  constructor(config) {
+  constructor(config = defaultConfig) {
     this.config = config;
     if (!config.mode || config.mode && config.mode.length === 0) {
       this.config.mode = ["CORE"];
     }
-    if (config.mode.includes(SDK_MODES.CORE)) {
-      if (!this.config.core) {
-        throw new Error("Core config is required");
-      }
-      this.core = new CoreClient(this.config.core);
+    if (this.config.mode?.includes(SDK_MODES.CORE)) {
+      this.core = new CoreClient(this.config?.core);
     }
     if (this.config.mode?.includes(SDK_MODES.NATIVE)) {
-      if (!this.config.native) {
-        throw new Error("NATIVE config is required");
-      }
       const nativeConfig = {
-        defaultNetwork: this.config.native?.defaultNetwork || DEFAULT_NETWORK,
+        defaultNetwork: this.config.native?.defaultNetwork ?? DEFAULT_NETWORK,
         ...this.config.native?.chains && {
           chains: this.config.native.chains
         },
@@ -1950,6 +2055,7 @@ var AggLayerSDK = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AggLayerSDK,
+  ApiError,
   SDK_MODES
 });
 //# sourceMappingURL=index.js.map