@circle-fin/app-kit 1.17.0 → 1.18.0

package/index.d.cts

@@ -1566,7 +1566,7 @@ declare const ArcTestnet: {
     readonly chainId: 5042002;
     readonly isTestnet: true;
     readonly explorerUrl: "https://testnet.arcscan.app/tx/{hash}";
-    readonly rpcEndpoints: readonly ["https://rpc.testnet.arc.network/"];
+    readonly rpcEndpoints: readonly ["https://rpc.testnet.arc.io"];
     readonly eurcAddress: "0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a";
     readonly usdcAddress: "0x3600000000000000000000000000000000000000";
     readonly usdtAddress: null;
@@ -15904,6 +15904,20 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
      * ```
      */
     bridge<TFromAdapterCapabilities extends AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities>(params: CCTPV2BridgeParams<TFromAdapterCapabilities, TToAdapterCapabilities>): Promise<BridgeResult>;
+    /**
+     * Reject a forwarded transfer to Solana whose amount does not exceed the fee.
+     *
+     * CCTP v2 reverts a burn whose `maxFee` is not less than its amount, and the Solana
+     * forwarding fee includes the recipient token account rent. Checking before the
+     * approval avoids sending a transaction that can never be followed by a burn.
+     * Skipped when the caller provides `config.maxFee`.
+     *
+     * @param params - The validated CCTP v2 bridge parameters.
+     * @returns A promise that resolves when the amount covers the fee.
+     * @throws {KitError} INPUT_INVALID_AMOUNT (FATAL) when the fee is greater than or equal
+     *   to the amount.
+     */
+    private assertAmountCoversRecipientSetupFee;
     /**
      * Retry a failed or incomplete CCTP v2 bridge operation.
      *
@@ -16311,6 +16325,9 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
      * | FAST           | true         | No              | maxFee = calculatedBurnFee + forwardingFee |
      * | FAST           | true         | Yes             | maxFee = config.maxFee |
      *
+     * For forwarded burns to Solana, the forwarding fee includes the rent for creating the
+     * recipient's token account. A caller-provided `maxFee` must cover it too.
+     *
      * @param params - The bridge parameters object containing:
      *   - `source`: The source wallet context with chain definition and adapter
      *   - `destination`: The destination wallet context with chain definition and adapter
@@ -16603,6 +16620,18 @@ interface BridgeKitConfig<TExtraProviders extends FlexibleBridgingProvider[] = [
      * @defaultValue false
      */
     disableErrorReporting?: boolean;
+    /**
+     * Disable success analytics.
+     *
+     * When `true`, the SDK will not POST an event when `bridge()` or `retry()`
+     * completes a transfer. The event carries the source and destination
+     * chains, token, amount, and source transaction hash. It never includes
+     * wallet addresses or keys. This does not disable error reporting; use
+     * {@link BridgeKitConfig.disableErrorReporting} for that.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Custom HTTP headers forwarded with the default providers' attestation
      * (Iris) API requests — both `CCTPV2BridgingProvider` (USDC routes) and
@@ -16790,6 +16819,11 @@ declare class BridgeKit<TExtraProviders extends FlexibleBridgingProvider[] = []>
     private readonly disableErrorReporting;
     /** Per-kit telemetry identity for shared helpers. */
     private readonly telemetryConfig;
+    /**
+     * Per-kit telemetry identity for success events. Gated by `disableAnalytics`
+     * independently of `disableErrorReporting`.
+     */
+    private readonly analyticsTelemetryConfig;
     /**
      * Create a new BridgeKit instance.
      *
@@ -51537,11 +51571,11 @@ interface AppKitContext {
      */
     actions: Record<'bridge' | 'earn' | 'borrow', Record<string, ((payload: unknown) => void)[]>>;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit,
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
      * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, borrow, and unified balance operations
-     * will not POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false
@@ -52986,11 +53020,11 @@ type AppKitConfig = CreateContextParams & {
     /** Optional config forwarded to the underlying {@link UnifiedBalanceKit}. */
     unifiedBalance?: UnifiedBalanceKitConfig;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit, and
-     * UnifiedBalanceKit.
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
+     * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, and unified balance operations will not
-     * POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitConfig.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false

package/index.d.mts

@@ -1566,7 +1566,7 @@ declare const ArcTestnet: {
     readonly chainId: 5042002;
     readonly isTestnet: true;
     readonly explorerUrl: "https://testnet.arcscan.app/tx/{hash}";
-    readonly rpcEndpoints: readonly ["https://rpc.testnet.arc.network/"];
+    readonly rpcEndpoints: readonly ["https://rpc.testnet.arc.io"];
     readonly eurcAddress: "0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a";
     readonly usdcAddress: "0x3600000000000000000000000000000000000000";
     readonly usdtAddress: null;
@@ -15904,6 +15904,20 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
      * ```
      */
     bridge<TFromAdapterCapabilities extends AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities>(params: CCTPV2BridgeParams<TFromAdapterCapabilities, TToAdapterCapabilities>): Promise<BridgeResult>;
+    /**
+     * Reject a forwarded transfer to Solana whose amount does not exceed the fee.
+     *
+     * CCTP v2 reverts a burn whose `maxFee` is not less than its amount, and the Solana
+     * forwarding fee includes the recipient token account rent. Checking before the
+     * approval avoids sending a transaction that can never be followed by a burn.
+     * Skipped when the caller provides `config.maxFee`.
+     *
+     * @param params - The validated CCTP v2 bridge parameters.
+     * @returns A promise that resolves when the amount covers the fee.
+     * @throws {KitError} INPUT_INVALID_AMOUNT (FATAL) when the fee is greater than or equal
+     *   to the amount.
+     */
+    private assertAmountCoversRecipientSetupFee;
     /**
      * Retry a failed or incomplete CCTP v2 bridge operation.
      *
@@ -16311,6 +16325,9 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
      * | FAST           | true         | No              | maxFee = calculatedBurnFee + forwardingFee |
      * | FAST           | true         | Yes             | maxFee = config.maxFee |
      *
+     * For forwarded burns to Solana, the forwarding fee includes the rent for creating the
+     * recipient's token account. A caller-provided `maxFee` must cover it too.
+     *
      * @param params - The bridge parameters object containing:
      *   - `source`: The source wallet context with chain definition and adapter
      *   - `destination`: The destination wallet context with chain definition and adapter
@@ -16603,6 +16620,18 @@ interface BridgeKitConfig<TExtraProviders extends FlexibleBridgingProvider[] = [
      * @defaultValue false
      */
     disableErrorReporting?: boolean;
+    /**
+     * Disable success analytics.
+     *
+     * When `true`, the SDK will not POST an event when `bridge()` or `retry()`
+     * completes a transfer. The event carries the source and destination
+     * chains, token, amount, and source transaction hash. It never includes
+     * wallet addresses or keys. This does not disable error reporting; use
+     * {@link BridgeKitConfig.disableErrorReporting} for that.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Custom HTTP headers forwarded with the default providers' attestation
      * (Iris) API requests — both `CCTPV2BridgingProvider` (USDC routes) and
@@ -16790,6 +16819,11 @@ declare class BridgeKit<TExtraProviders extends FlexibleBridgingProvider[] = []>
     private readonly disableErrorReporting;
     /** Per-kit telemetry identity for shared helpers. */
     private readonly telemetryConfig;
+    /**
+     * Per-kit telemetry identity for success events. Gated by `disableAnalytics`
+     * independently of `disableErrorReporting`.
+     */
+    private readonly analyticsTelemetryConfig;
     /**
      * Create a new BridgeKit instance.
      *
@@ -51537,11 +51571,11 @@ interface AppKitContext {
      */
     actions: Record<'bridge' | 'earn' | 'borrow', Record<string, ((payload: unknown) => void)[]>>;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit,
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
      * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, borrow, and unified balance operations
-     * will not POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false
@@ -52986,11 +53020,11 @@ type AppKitConfig = CreateContextParams & {
     /** Optional config forwarded to the underlying {@link UnifiedBalanceKit}. */
     unifiedBalance?: UnifiedBalanceKitConfig;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit, and
-     * UnifiedBalanceKit.
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
+     * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, and unified balance operations will not
-     * POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitConfig.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false

package/index.d.ts

@@ -1566,7 +1566,7 @@ declare const ArcTestnet: {
     readonly chainId: 5042002;
     readonly isTestnet: true;
     readonly explorerUrl: "https://testnet.arcscan.app/tx/{hash}";
-    readonly rpcEndpoints: readonly ["https://rpc.testnet.arc.network/"];
+    readonly rpcEndpoints: readonly ["https://rpc.testnet.arc.io"];
     readonly eurcAddress: "0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a";
     readonly usdcAddress: "0x3600000000000000000000000000000000000000";
     readonly usdtAddress: null;
@@ -15904,6 +15904,20 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
      * ```
      */
     bridge<TFromAdapterCapabilities extends AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities>(params: CCTPV2BridgeParams<TFromAdapterCapabilities, TToAdapterCapabilities>): Promise<BridgeResult>;
+    /**
+     * Reject a forwarded transfer to Solana whose amount does not exceed the fee.
+     *
+     * CCTP v2 reverts a burn whose `maxFee` is not less than its amount, and the Solana
+     * forwarding fee includes the recipient token account rent. Checking before the
+     * approval avoids sending a transaction that can never be followed by a burn.
+     * Skipped when the caller provides `config.maxFee`.
+     *
+     * @param params - The validated CCTP v2 bridge parameters.
+     * @returns A promise that resolves when the amount covers the fee.
+     * @throws {KitError} INPUT_INVALID_AMOUNT (FATAL) when the fee is greater than or equal
+     *   to the amount.
+     */
+    private assertAmountCoversRecipientSetupFee;
     /**
      * Retry a failed or incomplete CCTP v2 bridge operation.
      *
@@ -16311,6 +16325,9 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
      * | FAST           | true         | No              | maxFee = calculatedBurnFee + forwardingFee |
      * | FAST           | true         | Yes             | maxFee = config.maxFee |
      *
+     * For forwarded burns to Solana, the forwarding fee includes the rent for creating the
+     * recipient's token account. A caller-provided `maxFee` must cover it too.
+     *
      * @param params - The bridge parameters object containing:
      *   - `source`: The source wallet context with chain definition and adapter
      *   - `destination`: The destination wallet context with chain definition and adapter
@@ -16603,6 +16620,18 @@ interface BridgeKitConfig<TExtraProviders extends FlexibleBridgingProvider[] = [
      * @defaultValue false
      */
     disableErrorReporting?: boolean;
+    /**
+     * Disable success analytics.
+     *
+     * When `true`, the SDK will not POST an event when `bridge()` or `retry()`
+     * completes a transfer. The event carries the source and destination
+     * chains, token, amount, and source transaction hash. It never includes
+     * wallet addresses or keys. This does not disable error reporting; use
+     * {@link BridgeKitConfig.disableErrorReporting} for that.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Custom HTTP headers forwarded with the default providers' attestation
      * (Iris) API requests — both `CCTPV2BridgingProvider` (USDC routes) and
@@ -16790,6 +16819,11 @@ declare class BridgeKit<TExtraProviders extends FlexibleBridgingProvider[] = []>
     private readonly disableErrorReporting;
     /** Per-kit telemetry identity for shared helpers. */
     private readonly telemetryConfig;
+    /**
+     * Per-kit telemetry identity for success events. Gated by `disableAnalytics`
+     * independently of `disableErrorReporting`.
+     */
+    private readonly analyticsTelemetryConfig;
     /**
      * Create a new BridgeKit instance.
      *
@@ -51537,11 +51571,11 @@ interface AppKitContext {
      */
     actions: Record<'bridge' | 'earn' | 'borrow', Record<string, ((payload: unknown) => void)[]>>;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit,
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
      * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, borrow, and unified balance operations
-     * will not POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false
@@ -52986,11 +53020,11 @@ type AppKitConfig = CreateContextParams & {
     /** Optional config forwarded to the underlying {@link UnifiedBalanceKit}. */
     unifiedBalance?: UnifiedBalanceKitConfig;
     /**
-     * Disable success analytics for the underlying EarnKit, SwapKit, and
-     * UnifiedBalanceKit.
+     * Disable success analytics for the underlying BridgeKit, EarnKit, SwapKit,
+     * BorrowKit, and UnifiedBalanceKit.
      *
-     * When `true`, completed earn, swap, and unified balance operations will not
-     * POST analytics events. This does not disable error reporting; use
+     * When `true`, completed bridge, earn, swap, borrow, and unified balance
+     * operations will not POST analytics events. This does not disable error reporting; use
      * {@link AppKitConfig.disableErrorReporting} for that. Defaults to `false`.
      *
      * @defaultValue false