@circle-fin/app-kit 1.4.1 → 1.4.2

package/index.d.ts

@@ -681,6 +681,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",
@@ -904,6 +906,7 @@ declare enum BridgeChain {
     Monad = "Monad",
     Morph = "Morph",
     Optimism = "Optimism",
+    Pharos = "Pharos",
     Plume = "Plume",
     Polygon = "Polygon",
     Sei = "Sei",
@@ -925,6 +928,7 @@ declare enum BridgeChain {
     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",
@@ -2732,6 +2736,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 +3108,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 +3166,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";
@@ -3884,6 +3978,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;
@@ -3947,6 +4043,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 +7114,7 @@ declare module './types' {
         POL: true;
         PLUME: true;
         MON: true;
+        cirBTC: true;
     }
 }
 
@@ -9224,6 +9323,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 +9436,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.