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

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;
@@ -345,6 +346,21 @@ type BuildClaimTransactionRequestParam = {
 };
 type BuildClaimTransactionResponse = UnsignedTransaction;
 
+/**
+ * Arc API Token Mapping Types
+ *
+ * Defines the request and response types for the token mapping endpoint.
+ */
+type TokenMappingQueryParams = {
+    tokenAddress: string;
+};
+type TokenMappingResponse = Array<{
+    originTokenNetwork: number;
+    originTokenAddress: string;
+    wrappedTokenNetwork: number;
+    wrappedTokenAddress: string;
+}>;
+
 /**
  * Chain Types
  *
@@ -495,9 +511,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 +794,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
@@ -834,6 +850,43 @@ declare class CoreClient {
      * Get all transactions via web sockets
      */
     getTransactions(transactionsRequestQueryParams: TransactionsRequestQueryParams): Promise<TransactionsResponse>;
+    /**
+     * Get token mappings by token address
+     * @developer Note: Do not misinterpret network ID as chain ID.
+     *
+     * @param tokenAddress
+     */
+    getTokenMappings(tokenMappingQueryParams: TokenMappingQueryParams): Promise<TokenMappingResponse>;
+}
+
+/**
+ * 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;
+    };
 }
 
 /**
@@ -846,7 +899,7 @@ declare class AggLayerSDK {
     private config;
     private core?;
     private native?;
-    constructor(config: SDKConfig);
+    constructor(config?: SDKConfig);
     /**
      * Get core submodule
      */
@@ -857,4 +910,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 TokenMappingQueryParams, type TokenMappingResponse, 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;
@@ -345,6 +346,21 @@ type BuildClaimTransactionRequestParam = {
 };
 type BuildClaimTransactionResponse = UnsignedTransaction;
 
+/**
+ * Arc API Token Mapping Types
+ *
+ * Defines the request and response types for the token mapping endpoint.
+ */
+type TokenMappingQueryParams = {
+    tokenAddress: string;
+};
+type TokenMappingResponse = Array<{
+    originTokenNetwork: number;
+    originTokenAddress: string;
+    wrappedTokenNetwork: number;
+    wrappedTokenAddress: string;
+}>;
+
 /**
  * Chain Types
  *
@@ -495,9 +511,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 +794,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
@@ -834,6 +850,43 @@ declare class CoreClient {
      * Get all transactions via web sockets
      */
     getTransactions(transactionsRequestQueryParams: TransactionsRequestQueryParams): Promise<TransactionsResponse>;
+    /**
+     * Get token mappings by token address
+     * @developer Note: Do not misinterpret network ID as chain ID.
+     *
+     * @param tokenAddress
+     */
+    getTokenMappings(tokenMappingQueryParams: TokenMappingQueryParams): Promise<TokenMappingResponse>;
+}
+
+/**
+ * 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;
+    };
 }
 
 /**
@@ -846,7 +899,7 @@ declare class AggLayerSDK {
     private config;
     private core?;
     private native?;
-    constructor(config: SDKConfig);
+    constructor(config?: SDKConfig);
     /**
      * Get core submodule
      */
@@ -857,4 +910,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 TokenMappingQueryParams, type TokenMappingResponse, type TokenReference, type ToolDetails, type Transaction, type TransactionParams, type TransactionsRequestQueryParams, type TransactionsResponse, type WrappedTokenParams };