@nexus-cross/connect-kit-core 1.3.3 → 1.3.4-beta.1

package/dist/index.d.ts

@@ -214,6 +214,14 @@ interface CrossConnectKitConfig {
      * URL/provider 이름/secret은 노출하지 않는다.
      */
     onRampEnabled?: boolean;
+    /**
+     * cross-auth KYC 표면(`useKyc` 훅) 활성화 토글. default false. true이면
+     * connect-kit이 `<KycProvider>`를 자동 마운트하고, 연결된 crossx 2.0 SDK
+     * 세션에서 access token을 실시간으로 읽어 `Authorization: Bearer`로 주입한다.
+     * DApp은 별도 토큰 배선 없이 `useKyc()`만 호출하면 된다. `X-Project-Id`는
+     * `embeddedProjectId`(미설정 시 `crossProjectId` fallback)를 사용한다.
+     */
+    kycEnabled?: boolean;
     /**
      * When `true`, the kit switches the wallet to {@link defaultNetwork}
      * exactly once right after a connection is established. External
@@ -234,6 +242,35 @@ interface CrossConnectKitConfig {
      * Requires `defaultNetwork` to be set. Default: `false`.
      */
     enforceDefaultNetworkOnConnect?: boolean;
+    /**
+     * When `true` (default), any wallet chain switch the kit performs *for
+     * an operation* is undone once that operation completes — the wallet is
+     * restored to the chain it was on before. This covers the bridge/swap
+     * flow (which switches to the source chain to submit the tx) and the
+     * Send screen (which switches to the token's chain to send).
+     *
+     * Rationale: the temporary switch is an implementation detail of the
+     * operation. Leaving the DApp's wallet stranded on, say, BSC after a
+     * BSC→CROSS bridge makes the rest of the app (and the developer's own
+     * flows) behave unexpectedly. app-launcher is a DApp-integration tool,
+     * so the friendly default is to hand the chain back.
+     *
+     * Semantics:
+     *   - Best-effort: restore is fire-and-forget. A rejected switch-back
+     *     (or an unconfigured chain) never turns a successful bridge/send
+     *     into a failure.
+     *   - Only after success. A failed/cancelled operation leaves the
+     *     wallet on the operation chain so the user can retry without an
+     *     extra switch round-trip.
+     *   - No-op when no switch happened (e.g. already on the target chain,
+     *     or the gasless permit bridge path that never switches).
+     *
+     * Unlike {@link enforceDefaultNetworkOnConnect} — which pins to a fixed
+     * canonical chain once at connect — this restores to whatever chain the
+     * user actually had before the operation. Set `false` to leave the
+     * wallet on the operation chain. Default: `true`.
+     */
+    restoreChainAfterSwitch?: boolean;
 }
 interface AppMetadata {
     name: string;

package/dist/index.js

@@ -1 +1 @@
-var f={CONNECTED:"connected",DISCONNECTED:"disconnected",CONNECTING:"connecting",RECONNECTING:"reconnecting"};function u(e,t){if(t&&typeof window<"u"&&window.matchMedia)try{return window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light"}catch{}return typeof e=="string"?e:e&&typeof e=="object"&&"mode"in e?e.mode??"dark":"dark"}function m(e,t,r=4){if(t<0||!Number.isInteger(t))throw new RangeError(`formatBalance: decimals must be a non-negative integer, got ${t}`);if(r<0||!Number.isInteger(r))throw new RangeError(`formatBalance: displayDecimals must be a non-negative integer, got ${r}`);let n=e<0n,i=n?-e:e;if(t===0){let o=i.toString();return n?`-${o}`:o}let d=10n**BigInt(t),s=i/d,g=i%d;if(r===0){let o=s.toString();return n?`-${o}`:o}let c=g.toString().padStart(t,"0").slice(0,r),a=c.length;for(;a>0&&c.charCodeAt(a-1)===48;)a--;let l=c.slice(0,a),p=l?`${s}.${l}`:s.toString();return n?`-${p}`:p}function y(e,t=4){return m(e,18,t)}import{OnRampError as k,normalizeDisallowReason as S}from"@nexus-cross/onramp";export{f as ConnectionStatus,k as OnRampError,m as formatBalance,y as formatWei,S as normalizeDisallowReason,u as resolveThemeMode};
+var f={CONNECTED:"connected",DISCONNECTED:"disconnected",CONNECTING:"connecting",RECONNECTING:"reconnecting"};function u(e,t){if(t&&typeof window<"u"&&window.matchMedia)try{return window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light"}catch{}return typeof e=="string"?e:e&&typeof e=="object"&&"mode"in e?e.mode??"dark":"dark"}function m(e,t,r=4){if(t<0||!Number.isInteger(t))throw new RangeError(`formatBalance: decimals must be a non-negative integer, got ${t}`);if(r<0||!Number.isInteger(r))throw new RangeError(`formatBalance: displayDecimals must be a non-negative integer, got ${r}`);let n=e<0n,i=n?-e:e;if(t===0){let o=i.toString();return n?`-${o}`:o}let l=10n**BigInt(t),s=i/l,g=i%l;if(r===0){let o=s.toString();return n?`-${o}`:o}let c=g.toString().padStart(t,"0").slice(0,r),a=c.length;for(;a>0&&c.charCodeAt(a-1)===48;)a--;let d=c.slice(0,a),p=d?`${s}.${d}`:s.toString();return n?`-${p}`:p}function y(e,t=4){return m(e,18,t)}import{OnRampError as M,normalizeDisallowReason as S}from"@nexus-cross/onramp";export{f as ConnectionStatus,M as OnRampError,m as formatBalance,y as formatWei,S as normalizeDisallowReason,u as resolveThemeMode};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cross/connect-kit-core",
-  "version": "1.3.3",
+  "version": "1.3.4-beta.1",
   "description": "Core domain logic for @nexus-cross/connect-kit — types, ports, utilities",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@nexus-cross/onramp": "1.3.3"
+    "@nexus-cross/onramp": "1.3.4-beta.1"
   },
   "devDependencies": {
     "tsup": "^8.4.0",