@circle-fin/app-kit 1.8.0 → 1.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/app-kit",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "A one-stop Circle SDK solution for building stablecoin (e.g. USDC) applications, with bridging, swapping, and more on-chain operations",
   "keywords": [
     "circle",
@@ -36,11 +36,11 @@
   "module": "./index.mjs",
   "types": "./index.d.cts",
   "dependencies": {
-    "@circle-fin/unified-balance-kit": "1.2.0",
-    "@circle-fin/provider-gateway-v1": "1.1.0",
-    "@circle-fin/earn-kit": "1.2.0",
-    "@circle-fin/bridge-kit": "1.11.0",
-    "@circle-fin/swap-kit": "1.3.0",
+    "@circle-fin/unified-balance-kit": "1.2.1",
+    "@circle-fin/provider-gateway-v1": "1.1.1",
+    "@circle-fin/earn-kit": "1.2.1",
+    "@circle-fin/bridge-kit": "1.11.1",
+    "@circle-fin/swap-kit": "1.3.1",
     "zod": "3.25.67",
     "@ethersproject/address": "^5.8.0",
     "@ethersproject/bytes": "^5.8.0",

package/swap.cjs

@@ -8563,13 +8563,20 @@ const swapTokenEnumSchema = zod.z.enum([
     symbol: 'EURC',
     decimals: 6,
     locators: {
+        // =========================================================================
+        // Mainnets
+        // =========================================================================
         [Blockchain.Avalanche]: '0xc891EB4cbdEFf6e073e859e987815Ed1505c2ACD',
         [Blockchain.Base]: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42',
         [Blockchain.Ethereum]: '0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c',
         [Blockchain.Solana]: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
         [Blockchain.World_Chain]: '0x1C60ba0A0eD1019e8Eb035E6daF4155A5cE2380B',
+        // =========================================================================
         // Testnets
-        [Blockchain.Arc_Testnet]: '0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a'
+        // =========================================================================
+        [Blockchain.Arc_Testnet]: '0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a',
+        [Blockchain.Base_Sepolia]: '0x808456652fdb597867f38412077A9182bf77359F',
+        [Blockchain.Ethereum_Sepolia]: '0x08210F9170F89Ab7658F0B5E3fF39b0E03C594D4'
     }
 };
 
@@ -8779,8 +8786,7 @@ const swapTokenEnumSchema = zod.z.enum([
  * cirBTC (Circle Bitcoin) token definition with addresses and metadata.
  *
  * @remarks
- * Built-in cirBTC definition for the TokenRegistry. Currently deployed
- * on Arc Testnet.
+ * Built-in cirBTC definition for the TokenRegistry.
  *
  * @example
  * ```typescript
@@ -8796,7 +8802,15 @@ const swapTokenEnumSchema = zod.z.enum([
     symbol: 'cirBTC',
     decimals: 8,
     locators: {
-        [Blockchain.Arc_Testnet]: '0xf0C4a4CE82A5746AbAAd9425360Ab04fbBA432BF'
+        // =========================================================================
+        // Mainnets
+        // =========================================================================
+        [Blockchain.Ethereum]: '0x72DFB2E44f59C5AD2bAFE84314E5b99a7cd5075E',
+        // =========================================================================
+        // Testnets
+        // =========================================================================
+        [Blockchain.Arc_Testnet]: '0xf0C4a4CE82A5746AbAAd9425360Ab04fbBA432BF',
+        [Blockchain.Ethereum_Sepolia]: '0x3a3fe695F684Bf9b9e43CF43C2b895Ea5e392bB3'
     }
 };
 
@@ -9748,7 +9762,7 @@ const swapTokenEnumSchema = zod.z.enum([
 }
 
 var name$2 = "@circle-fin/bridge-kit";
-var version$2 = "1.11.0";
+var version$2 = "1.11.1";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -10638,7 +10652,7 @@ var TransferSpeed;
 registerKit(`${pkg$2.name}/${pkg$2.version}`);
 
 var name$1 = "@circle-fin/swap-kit";
-var version$1 = "1.3.0";
+var version$1 = "1.3.1";
 var pkg$1 = {
 	name: name$1,
 	version: version$1};
@@ -15044,6 +15058,19 @@ const TOKEN_REGISTRY = createTokenRegistry();
  *
  * @internal
  */ const SUPPORTED_CHAINS = getSwapSupportedChains(Chains);
+/**
+ * Inter-poll delays (ms) for the same-chain `amountOut` enrichment loop.
+ *
+ * A same-chain swap is already terminal `DONE` once its source transaction
+ * confirms; this short, escalating budget (~5s total across up to four polls)
+ * gives the service a brief window to resolve the output amount before
+ * `swap()` returns. The loop exits the instant `amountOut` is available.
+ */ const SAME_CHAIN_AMOUNT_OUT_POLL_DELAYS_MS = [
+    1_000,
+    2_000,
+    2_000
+];
+const sleep$2 = async (ms)=>new Promise((resolve)=>setTimeout(resolve, ms));
 function buildSwapProgress(statusResult) {
     return {
         status: statusResult.status,
@@ -15063,29 +15090,46 @@ async function fetchSameChainStatusSnapshot({ isCrossChainSwap, txHash, chain, a
             }
         };
     }
-    try {
-        const statusResult = await getSwapStatus$1({
-            txHash,
-            chain: chain.chain,
-            apiKey
-        });
-        const progress = buildSwapProgress(statusResult);
-        if (statusResult.status === 'DONE' && statusResult.amountOut !== undefined) {
+    // A same-chain swap completes atomically in the source transaction, which
+    // has already been confirmed (and receipt-checked for revert) by the time we
+    // get here. Its terminal status is therefore `DONE`. We briefly poll the
+    // status endpoint to enrich `amountOut`, which the service usually resolves
+    // within a few seconds. A non-DONE/erroneous peek never downgrades the
+    // status — once the short budget is exhausted we return `DONE` without
+    // `amountOut`, and the caller can fetch it later via `getSwapStatus`.
+    for(let attempt = 0;; attempt += 1){
+        try {
+            const statusResult = await getSwapStatus$1({
+                txHash,
+                chain: chain.chain,
+                apiKey
+            });
+            if (statusResult.status === 'DONE' && statusResult.amountOut !== undefined) {
+                return {
+                    progress: buildSwapProgress(statusResult),
+                    amountOut: statusResult.amountOut
+                };
+            }
+        } catch  {
+            // Reachability/parse failure during enrichment — non-fatal; the swap
+            // already succeeded on-chain. `getSwapStatus` already retried transient
+            // network errors internally, so further polling is unlikely to help.
             return {
-                progress,
-                amountOut: statusResult.amountOut
+                progress: {
+                    status: 'DONE'
+                }
             };
         }
-        return {
-            progress
-        };
-    } catch  {
-        // Non-fatal — the swap already succeeded on-chain. status stays PENDING.
-        return {
-            progress: {
-                status: 'PENDING'
-            }
-        };
+        const delayMs = SAME_CHAIN_AMOUNT_OUT_POLL_DELAYS_MS[attempt];
+        if (delayMs === undefined) {
+            // Budget exhausted — terminal `DONE`, `amountOut` not yet available.
+            return {
+                progress: {
+                    status: 'DONE'
+                }
+            };
+        }
+        await sleep$2(delayMs);
     }
 }
 /**
@@ -15963,14 +16007,14 @@ async function fetchSameChainStatusSnapshot({ isCrossChainSwap, txHash, chain, a
         }
         // Build swap fees with adapter-backed formatting for unregistered tokens
         const swapResultFees = serviceResponse.fees ? await this.buildFormattedFees(serviceResponse.fees, chain, destinationChain, adapter, config?.customFee?.recipientAddress) : undefined;
-        // Best-effort enrichment: fetch amountOut and provider-reported status.
-        // Only performed for same-chain swaps — they typically reach DONE within
-        // a few seconds of source-tx confirmation, so the peek is useful UX and
-        // adds minimal latency. Cross-chain swaps are skipped because the
-        // destination mint takes minutes (CCTPv2 attestation), meaning the peek
-        // would always return PENDING/WAIT_DESTINATION_TRANSACTION while still
-        // burning up to 30s of the load balancer's server-side wait. Callers
-        // should use `kit.getSwapStatus()` to poll cross-chain swaps to DONE.
+        // Best-effort enrichment: briefly poll for amountOut on same-chain swaps.
+        // They complete atomically in the (already-confirmed) source tx, so the
+        // result is terminal `DONE` regardless; the short poll only adds amountOut
+        // once the service has resolved it. Cross-chain swaps are skipped because
+        // the destination mint takes minutes (CCTPv2 attestation), so polling would
+        // always return PENDING/WAIT_DESTINATION_TRANSACTION while burning the
+        // budget. Callers should use `kit.getSwapStatus()` to poll cross-chain
+        // swaps to DONE.
         const statusSnapshot = await fetchSameChainStatusSnapshot({
             isCrossChainSwap,
             txHash,
@@ -20272,7 +20316,7 @@ registerKit(`${pkg$1.name}/${pkg$1.version}`);
 };
 
 var name = "@circle-fin/earn-kit";
-var version = "1.2.0";
+var version = "1.2.1";
 var pkg = {
 	name: name,
 	version: version};
@@ -20311,20 +20355,7 @@ var pkg = {
  */ ({
     [Blockchain.Arc_Testnet]: CHAIN_TO_API[Blockchain.Arc_Testnet]
 });
-/**
- * Expected EIP-712 domain of the ERC-3009 authorization token per source
- * chain.
- *
- * Cross-chain Earn deposits are USDC-only, but USDC deployments differ on the
- * EIP-712 domain name: newer deployments use `USDC` while older ones (for
- * example Arbitrum Sepolia) kept `USD Coin` from the FiatToken V2 upgrade.
- * These values mirror the bridge service's per-chain domain table and the
- * on-chain `DOMAIN_SEPARATOR` inputs. Asserted before signing so a tampered
- * prepare response cannot point the signature at another token. The
- * `satisfies` check forces a domain entry whenever a source chain is added.
- *
- * @internal
- */ ({
+({
     [Blockchain.Arbitrum_Sepolia]: {
         },
     [Blockchain.Base_Sepolia]: {
@@ -20360,6 +20391,7 @@ const hexSignatureSchema = evmSignatureSchema;
 const hexAddressSchema = evmAddressSchema;
 // '0x' prefix + 32 bytes * 2 hex chars.
 const BYTES32_HEX_LENGTH = 66;
+const bridgeFeeTokenSchema = hexAddressSchema;
 /**
  * Zod schema for a non-negative uint256-like value.
  *
@@ -20646,14 +20678,12 @@ const eip712DomainSchema = eip712DomainSchema$1.extend({
  *
  * The bridge prepare path returns one item per collected source fee (e.g.
  * `PRE_FINALITY` for the fast-burn fee and `FORWARD` for the destination
- * forward fee), all denominated in the shared `feeToken`. The signed
- * authorization `value` is `principal + sum(items[].amount)`, so the pre-sign
- * guard parses these to recompute the expected value. Each item's `amount` is
- * a base-unit decimal string in `feeToken` units.
+ * forward fee), all denominated in the shared `feeToken`. Each item's `amount`
+ * is a base-unit decimal string in `feeToken` units.
  *
  * @internal
  */ const bridgeFeeQuoteSchema = zod.z.object({
-    feeToken: hexAddressSchema,
+    feeToken: bridgeFeeTokenSchema,
     items: zod.z.array(zod.z.object({
         type: zod.z.string(),
         amount: uint256LikeSchema
@@ -20669,6 +20699,12 @@ const eip712DomainSchema = eip712DomainSchema$1.extend({
     erc3009TypedData: erc3009TypedDataSchema,
     feeQuote: bridgeFeeQuoteSchema
 }).passthrough();
+const bridgeDepositPrepareReviewSchema = zod.z.object({
+    sourceChain: zod.z.string(),
+    destinationChain: zod.z.string(),
+    amount: amountJsonSchema,
+    vaultAddress: hexAddressSchema
+}).passthrough();
 /**
  * Zod schema for the bridge deposit prepare payload.
  *
@@ -20680,7 +20716,7 @@ const eip712DomainSchema = eip712DomainSchema$1.extend({
     execId: bridgeDepositExecIdSchema,
     erc3009TypedData: bridgeDepositPreparedBundleSchema,
     expiresAt: zod.z.string().datetime(),
-    review: zod.z.unknown().optional()
+    review: bridgeDepositPrepareReviewSchema
 });
 /**
  * Zod schema for the `POST /v1/earnKit/bridge/deposit/prepare` API response.
@@ -20959,6 +20995,10 @@ const eip712DomainSchema = eip712DomainSchema$1.extend({
     data: exploreVaultsPayloadSchema
 });
 
+// Intentionally built-ins-only: Earn bridge support is limited to SDK-known
+// token contracts plus the explicit ERC-3009 domain allowlist below.
+createTokenRegistry();
+
 /**
  * Shared UTF-8 encoder for building the keccak input in
  * {@link isValidEip55Checksum}, hoisted to module scope to avoid allocating a
@@ -21081,10 +21121,9 @@ const sourceAdapterContextSchema = zod.z.object({
  * Schema for validating human-readable decimal amount strings.
  *
  * Accept positive decimal strings like '100', '100.50', '0.001'. Reject
- * zero, negative, non-numeric, and non-canonical strings. EarnKit
- * same-chain amounts are USDC/EURC (6 decimals), so precision is capped at
- * 6 to match the Earn Service and fail fast locally instead of leaking
- * 7+ decimal-place inputs to the server.
+ * zero, negative, non-numeric, and non-canonical strings. Same-chain
+ * EarnKit vaults can use different asset precisions, so the service enforces
+ * the vault-specific decimal cap after resolving the vault asset.
  *
  * @internal
  */ const amountSchema = zod.z.string({
@@ -21093,32 +21132,15 @@ const sourceAdapterContextSchema = zod.z.object({
     allowZero: false,
     regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
     attributeName: 'amount',
-    maxDecimals: 6
-})(zod.z.string())).refine((value)=>CANONICAL_AMOUNT_REGEX.test(value), AMOUNT_FORMAT_ERROR_MESSAGE);
-/**
- * Schema for cross-chain deposit amount strings.
- *
- * Cross-chain Earn deposits are USDC-only, and the signed ERC-3009 value is
- * denominated in USDC's 6 decimals. Reject more precise inputs up front so
- * the signed value always equals the requested amount instead of a silent
- * truncation. Non-canonical forms (leading dot, leading zeros) are rejected
- * too, matching the Earn Service.
- *
- * @internal
- */ const crossChainAmountSchema = zod.z.string({
-    required_error: 'amount is required'
-}).min(1, 'amount is required').pipe(createDecimalStringValidator({
-    allowZero: false,
-    regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
-    attributeName: 'amount',
-    maxDecimals: 6
+    maxDecimals: 18
 })(zod.z.string())).refine((value)=>CANONICAL_AMOUNT_REGEX.test(value), AMOUNT_FORMAT_ERROR_MESSAGE);
 /**
  * Schema for cross-chain source fee caps.
  *
- * Cross-chain source fees are denominated in USDC base units. Zero is valid
- * when the quote contains no source-collected fees; otherwise the cap should be
- * the caller-accepted total from a recent quote.
+ * Cross-chain source fees are denominated in the quote's fee token. Zero is
+ * valid when the quote contains no source-collected fees; otherwise the cap
+ * should be the caller-accepted total from a recent quote. The provider
+ * enforces the prepared bundle's fee-token precision before signing.
  *
  * @internal
  */ const crossChainMaxFeeSchema = zod.z.string({
@@ -21127,7 +21149,7 @@ const sourceAdapterContextSchema = zod.z.object({
     allowZero: true,
     regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
     attributeName: 'maxFee',
-    maxDecimals: 6
+    maxDecimals: 18
 })(zod.z.string())).refine((value)=>CANONICAL_AMOUNT_REGEX.test(value), AMOUNT_FORMAT_ERROR_MESSAGE);
 /**
  * Build a schema for an optional non-negative decimal filter string.
@@ -21288,7 +21310,7 @@ const crossChainDepositDestinationSchema = zod.z.object({
     from: sourceAdapterContextSchema,
     to: crossChainDepositDestinationSchema,
     vaultAddress: vaultAddressSchema,
-    amount: crossChainAmountSchema,
+    amount: amountSchema,
     maxFee: crossChainMaxFeeSchema,
     transferSpeed: zod.z.enum([
         'FAST',

package/swap.d.cts

@@ -6283,8 +6283,8 @@ interface CrossChainDepositParams<TFromAdapterCapabilities extends AdapterCapabi
      */
     readonly amount: string;
     /**
-     * Maximum source-collected bridge fee the caller is willing to sign for, in
-     * human-readable source token units.
+     * Maximum source-collected bridge fee the caller is willing to accept, in
+     * human-readable fee token units from the quote.
      *
      * Derive this from a recent cross-chain deposit quote by summing
      * `quote.fees[].amount`. The prepared bridge bundle must not exceed this cap

package/swap.d.mts

@@ -6283,8 +6283,8 @@ interface CrossChainDepositParams<TFromAdapterCapabilities extends AdapterCapabi
      */
     readonly amount: string;
     /**
-     * Maximum source-collected bridge fee the caller is willing to sign for, in
-     * human-readable source token units.
+     * Maximum source-collected bridge fee the caller is willing to accept, in
+     * human-readable fee token units from the quote.
      *
      * Derive this from a recent cross-chain deposit quote by summing
      * `quote.fees[].amount`. The prepared bridge bundle must not exceed this cap

package/swap.d.ts

@@ -6283,8 +6283,8 @@ interface CrossChainDepositParams<TFromAdapterCapabilities extends AdapterCapabi
      */
     readonly amount: string;
     /**
-     * Maximum source-collected bridge fee the caller is willing to sign for, in
-     * human-readable source token units.
+     * Maximum source-collected bridge fee the caller is willing to accept, in
+     * human-readable fee token units from the quote.
      *
      * Derive this from a recent cross-chain deposit quote by summing
      * `quote.fees[].amount`. The prepared bridge bundle must not exceed this cap