@circle-fin/app-kit 1.4.1 → 1.5.0

package/index.d.ts

@@ -667,6 +667,8 @@ declare enum Blockchain {
     Hedera_Testnet = "Hedera_Testnet",
     HyperEVM = "HyperEVM",
     HyperEVM_Testnet = "HyperEVM_Testnet",
+    Injective = "Injective",
+    Injective_Testnet = "Injective_Testnet",
     Ink = "Ink",
     Ink_Testnet = "Ink_Testnet",
     Linea = "Linea",
@@ -681,6 +683,8 @@ declare enum Blockchain {
     Noble_Testnet = "Noble_Testnet",
     Optimism = "Optimism",
     Optimism_Sepolia = "Optimism_Sepolia",
+    Pharos = "Pharos",
+    Pharos_Testnet = "Pharos_Testnet",
     Polkadot_Asset_Hub = "Polkadot_Asset_Hub",
     Polkadot_Westmint = "Polkadot_Westmint",
     Plume = "Plume",
@@ -899,11 +903,13 @@ declare enum BridgeChain {
     Edge = "Edge",
     Ethereum = "Ethereum",
     HyperEVM = "HyperEVM",
+    Injective = "Injective",
     Ink = "Ink",
     Linea = "Linea",
     Monad = "Monad",
     Morph = "Morph",
     Optimism = "Optimism",
+    Pharos = "Pharos",
     Plume = "Plume",
     Polygon = "Polygon",
     Sei = "Sei",
@@ -920,11 +926,13 @@ declare enum BridgeChain {
     Edge_Testnet = "Edge_Testnet",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     HyperEVM_Testnet = "HyperEVM_Testnet",
+    Injective_Testnet = "Injective_Testnet",
     Ink_Testnet = "Ink_Testnet",
     Linea_Sepolia = "Linea_Sepolia",
     Monad_Testnet = "Monad_Testnet",
     Morph_Testnet = "Morph_Testnet",
     Optimism_Sepolia = "Optimism_Sepolia",
+    Pharos_Testnet = "Pharos_Testnet",
     Plume_Testnet = "Plume_Testnet",
     Polygon_Amoy_Testnet = "Polygon_Amoy_Testnet",
     Sei_Testnet = "Sei_Testnet",
@@ -2129,6 +2137,98 @@ declare const HyperEVMTestnet: {
     };
 };
 
+/**
+ * Injective Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Injective blockchain.
+ * Injective is a high-performance, interoperable Layer-1 blockchain built for
+ * finance, with an EVM execution layer on top of a Cosmos SDK base and
+ * sub-second block finality.
+ */
+declare const Injective: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Injective;
+    readonly name: "Injective";
+    readonly title: "Injective Mainnet";
+    readonly nativeCurrency: {
+        readonly name: "Injective";
+        readonly symbol: "INJ";
+        readonly decimals: 18;
+    };
+    readonly chainId: 1776;
+    readonly isTestnet: false;
+    readonly explorerUrl: "https://injscan.com/transaction/{hash}";
+    readonly rpcEndpoints: readonly ["https://sentry.evm-rpc.injective.network"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0xa00C59fF5a080D2b954d0c75e46E22a0c371235a";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 29;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
+                readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
+                readonly confirmations: 1;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0";
+    };
+};
+
+/**
+ * Injective Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Injective blockchain.
+ * Injective is a high-performance, interoperable Layer-1 blockchain built for
+ * finance, with an EVM execution layer on top of a Cosmos SDK base and
+ * sub-second block finality.
+ */
+declare const InjectiveTestnet: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Injective_Testnet;
+    readonly name: "Injective Testnet";
+    readonly title: "Injective Testnet";
+    readonly nativeCurrency: {
+        readonly name: "Injective";
+        readonly symbol: "INJ";
+        readonly decimals: 18;
+    };
+    readonly chainId: 1439;
+    readonly isTestnet: true;
+    readonly explorerUrl: "https://testnet.explorer.injective.network/transaction/{hash}";
+    readonly rpcEndpoints: readonly ["https://k8s.testnet.json-rpc.injective.network"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0x0C382e685bbeeFE5d3d9C29e29E341fEE8E84C5d";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 29;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+                readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
+                readonly confirmations: 1;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xC5567a5E3370d4DBfB0540025078e283e36A363d";
+    };
+};
+
 /**
  * Ink Mainnet chain definition
  * @remarks
@@ -2732,6 +2832,96 @@ declare const OptimismSepolia: {
     };
 };
 
+/**
+ * Pharos Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Pharos blockchain.
+ * Pharos is a modular, full-stack parallel Layer 1 blockchain with
+ * sub-second finality and EVM compatibility.
+ */
+declare const Pharos: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Pharos;
+    readonly name: "Pharos";
+    readonly title: "Pharos Mainnet";
+    readonly nativeCurrency: {
+        readonly name: "Pharos";
+        readonly symbol: "PHAROS";
+        readonly decimals: 18;
+    };
+    readonly chainId: 1672;
+    readonly isTestnet: false;
+    readonly explorerUrl: "https://pharos.socialscan.io/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://rpc.pharos.xyz"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0xC879C018dB60520F4355C26eD1a6D572cdAC1815";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 31;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
+                readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
+                readonly confirmations: 1;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0";
+    };
+};
+
+/**
+ * Pharos Atlantic Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Pharos blockchain.
+ * Pharos is a modular, full-stack parallel Layer 1 blockchain with
+ * sub-second finality and EVM compatibility.
+ */
+declare const PharosTestnet: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Pharos_Testnet;
+    readonly name: "Pharos Atlantic";
+    readonly title: "Pharos Atlantic Testnet";
+    readonly nativeCurrency: {
+        readonly name: "Pharos";
+        readonly symbol: "PHAROS";
+        readonly decimals: 18;
+    };
+    readonly chainId: 688689;
+    readonly isTestnet: true;
+    readonly explorerUrl: "https://atlantic.pharosscan.xyz/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://atlantic.dplabs-internal.com"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 31;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+                readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
+                readonly confirmations: 1;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xC5567a5E3370d4DBfB0540025078e283e36A363d";
+    };
+};
+
 /**
  * Plume Mainnet chain definition
  * @remarks
@@ -3014,7 +3204,7 @@ declare const Sei: {
     };
     readonly chainId: 1329;
     readonly isTestnet: false;
-    readonly explorerUrl: "https://seitrace.com/tx/{hash}?chain=pacific-1";
+    readonly explorerUrl: "https://seiscan.io/tx/{hash}";
     readonly rpcEndpoints: readonly ["https://evm-rpc.sei-apis.com"];
     readonly eurcAddress: null;
     readonly usdcAddress: "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392";
@@ -3072,7 +3262,7 @@ declare const SeiTestnet: {
     };
     readonly chainId: 1328;
     readonly isTestnet: true;
-    readonly explorerUrl: "https://seitrace.com/tx/{hash}?chain=atlantic-2";
+    readonly explorerUrl: "https://testnet.seiscan.io/tx/{hash}";
     readonly rpcEndpoints: readonly ["https://evm-rpc-testnet.sei-apis.com"];
     readonly eurcAddress: null;
     readonly usdcAddress: "0x4fCF1784B31630811181f670Aea7A7bEF803eaED";
@@ -3870,6 +4060,8 @@ declare const Chains_Hedera: typeof Hedera;
 declare const Chains_HederaTestnet: typeof HederaTestnet;
 declare const Chains_HyperEVM: typeof HyperEVM;
 declare const Chains_HyperEVMTestnet: typeof HyperEVMTestnet;
+declare const Chains_Injective: typeof Injective;
+declare const Chains_InjectiveTestnet: typeof InjectiveTestnet;
 declare const Chains_Ink: typeof Ink;
 declare const Chains_InkTestnet: typeof InkTestnet;
 declare const Chains_Linea: typeof Linea;
@@ -3884,6 +4076,8 @@ declare const Chains_Noble: typeof Noble;
 declare const Chains_NobleTestnet: typeof NobleTestnet;
 declare const Chains_Optimism: typeof Optimism;
 declare const Chains_OptimismSepolia: typeof OptimismSepolia;
+declare const Chains_Pharos: typeof Pharos;
+declare const Chains_PharosTestnet: typeof PharosTestnet;
 declare const Chains_Plume: typeof Plume;
 declare const Chains_PlumeTestnet: typeof PlumeTestnet;
 declare const Chains_PolkadotAssetHub: typeof PolkadotAssetHub;
@@ -3933,6 +4127,8 @@ declare namespace Chains {
     Chains_HederaTestnet as HederaTestnet,
     Chains_HyperEVM as HyperEVM,
     Chains_HyperEVMTestnet as HyperEVMTestnet,
+    Chains_Injective as Injective,
+    Chains_InjectiveTestnet as InjectiveTestnet,
     Chains_Ink as Ink,
     Chains_InkTestnet as InkTestnet,
     Chains_Linea as Linea,
@@ -3947,6 +4143,8 @@ declare namespace Chains {
     Chains_NobleTestnet as NobleTestnet,
     Chains_Optimism as Optimism,
     Chains_OptimismSepolia as OptimismSepolia,
+    Chains_Pharos as Pharos,
+    Chains_PharosTestnet as PharosTestnet,
     Chains_Plume as Plume,
     Chains_PlumeTestnet as PlumeTestnet,
     Chains_PolkadotAssetHub as PolkadotAssetHub,
@@ -7016,6 +7214,7 @@ declare module './types' {
         POL: true;
         PLUME: true;
         MON: true;
+        cirBTC: true;
     }
 }
 
@@ -9224,6 +9423,63 @@ TChainDefinition extends ChainDefinition = ChainDefinition> {
      */
     invocationMeta?: InvocationMeta;
 }
+/**
+ * Machine-readable classification of a {@link BridgeStep} error.
+ *
+ * Consumers may use this field for UX decisions (e.g. distinguish a user
+ * rejection from a wallet capability error) without string-matching on
+ * {@link BridgeStep.errorMessage}. The original human-readable error
+ * message is always preserved for display/logging.
+ *
+ * @remarks
+ * The categories map to the most common failure shapes observed across
+ * the EIP-5792 batched bridge path and the sequential bridge path:
+ *
+ * - `user_rejected` — user declined a wallet request (JSON-RPC `4001`).
+ * - `atomic_unsupported` — wallet reported it cannot perform EIP-5792
+ *   atomic batching on this chain. Covers JSON-RPC `5700` (unsupported
+ *   capabilities), `5710` (chain not supported for the requested
+ *   capability), and `5750` (atomicity requires a wallet upgrade which
+ *   the user declined), or equivalent viem-wrapped messages.
+ * - `batch_too_large` — wallet rejected the batch for exceeding its
+ *   size limit (JSON-RPC `5740`).
+ * - `duplicate_batch_id` — wallet reported a duplicate batchId
+ *   (JSON-RPC `5720`).
+ * - `unknown_bundle` — wallet reported an unknown bundle id during
+ *   status polling (JSON-RPC `5730`).
+ * - `polling_timeout` — SDK polled `wallet_getCallsStatus` until the
+ *   configured timeout without receiving a terminal status.
+ * - `failed_offchain` — wallet reported EIP-5792 `statusCode: 400`
+ *   (batch not included onchain, wallet will not retry).
+ * - `reverted_onchain` — wallet reported EIP-5792 `statusCode: 500`
+ *   (batch reverted completely onchain).
+ * - `partial_reverted` — wallet reported EIP-5792 `statusCode: 600`
+ *   (batch reverted partially onchain).
+ * - `chain_revert` — transaction was mined but reverted on-chain
+ *   (sequential path).
+ * - `unknown` — error did not match any of the above categories.
+ *
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * import type { BridgeStep } from '@core/provider'
+ *
+ * const step: BridgeStep = {
+ *   name: 'approve',
+ *   state: 'error',
+ *   errorMessage: 'User rejected the request',
+ *   errorCategory: 'user_rejected',
+ * }
+ *
+ * if (step.errorCategory === 'user_rejected') {
+ *   // silent abort: user intentionally cancelled
+ * } else if (step.errorCategory === 'atomic_unsupported') {
+ *   // hint the user about switching to step-by-step signing
+ * }
+ * ```
+ */
+type BridgeStepErrorCategory = 'user_rejected' | 'atomic_unsupported' | 'batch_too_large' | 'duplicate_batch_id' | 'unknown_bundle' | 'polling_timeout' | 'failed_offchain' | 'reverted_onchain' | 'partial_reverted' | 'chain_revert' | 'unknown';
 /**
  * A step in the bridge process.
  *
@@ -9280,6 +9536,21 @@ interface BridgeStep {
     errorMessage?: string;
     /** Optional raw error object (can be Viem/Ethers/Chain error) */
     error?: unknown;
+    /**
+     * Optional machine-readable classification of the error.
+     *
+     * Present when the step is in `state: 'error'` and the SDK was able to
+     * categorize the failure. See {@link BridgeStepErrorCategory} for the
+     * list of categories and how they map to underlying error shapes.
+     *
+     * @remarks
+     * The human-readable {@link errorMessage} is always preserved for
+     * logging and display; this field is additive and should be preferred
+     * over string-matching `errorMessage` for machine decisions.
+     *
+     * @since 2.0.0
+     */
+    errorCategory?: BridgeStepErrorCategory;
 }
 /**
  * Result object returned after a successful cross-chain bridge operation.
@@ -11289,6 +11560,15 @@ interface BridgeKitConfig<TExtraProviders extends FlexibleBridgingProvider[] = [
      * the appropriate provider based on order and the transfer parameters.
      */
     providers?: TExtraProviders;
+    /**
+     * Disable error telemetry.
+     *
+     * When `true`, the SDK will not POST error details to the telemetry
+     * endpoint when public methods throw. Defaults to `false` (enabled).
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 }
 /**
  * Merges action types from multiple bridging providers into a unified action map.
@@ -11443,6 +11723,10 @@ declare class BridgeKit<TExtraProviders extends FlexibleBridgingProvider[] = []>
      * A custom fee policy for the kit.
      */
     customFeePolicy: CustomFeePolicy$2 | undefined;
+    /** Whether error telemetry is disabled. */
+    private readonly disableErrorReporting;
+    /** Per-kit telemetry identity for shared helpers. */
+    private readonly telemetryConfig;
     /**
      * Create a new BridgeKit instance.
      *
@@ -13292,6 +13576,15 @@ interface SwapKitConfig<TExtraProviders extends FlexibleSwappingProvider[] = []>
      * for all swaps executed through the created context.
      */
     customFeePolicy?: CustomFeePolicy$1;
+    /**
+     * Disable error telemetry.
+     *
+     * When `true`, the SDK will not POST error details to the telemetry
+     * endpoint when public methods throw. Defaults to `false` (enabled).
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 }
 
 /**
@@ -15024,6 +15317,16 @@ interface AppKitContext {
      * ```
      */
     actions: Record<'bridge', Record<string, ((payload: unknown) => void)[]>>;
+    /**
+     * Disable error telemetry for all sub-kits.
+     *
+     * When `true`, none of the underlying kits (BridgeKit, SwapKit,
+     * UnifiedBalanceKit) will POST error details to the telemetry
+     * endpoint when operations throw. Defaults to `false` (enabled).
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 }
 /**
  * Type for event handler functions that can be registered with the AppKit.
@@ -15818,6 +16121,18 @@ interface UnifiedBalanceKitConfig<TExtraProviders extends FlexibleGatewayProvide
      * @defaultValue false
      */
     disableAnalytics?: boolean;
+    /**
+     * Disable error telemetry.
+     *
+     * When `true`, the SDK will not POST error details to the telemetry
+     * endpoint when public methods throw. Defaults to `false` (enabled).
+     *
+     * @remarks
+     * Only applies to the class-based API (`new UnifiedBalanceKit()`).
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 }
 
 /**
@@ -16896,6 +17211,15 @@ type AppKitConfig = CreateContextParams & {
     developerFee?: Partial<DeveloperFeeHooks>;
     /** Optional config forwarded to the underlying {@link UnifiedBalanceKit}. */
     unifiedBalance?: UnifiedBalanceKitConfig;
+    /**
+     * Disable error telemetry for all underlying kits.
+     *
+     * When `true`, BridgeKit, SwapKit, and UnifiedBalanceKit will not
+     * POST error details to the telemetry endpoint. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 };
 /**
  * A high-level SDK for stablecoin operations, including bridging and swapping.