@nexus-cross/crossx-sdk-core 1.0.9 → 1.1.0

package/dist/__tests__/mocks/MockWalletProviderPort.d.ts

@@ -1,5 +1,6 @@
 import { WalletProviderPort, WalletData, SignResponse } from '../../core/ports';
 import { AddressInfo } from '../../core/types/chain';
+import { MigrationLockDetails } from '../../core/types/errors';
 
 export declare const MOCK_ADDRESS = "0xaabbccdd00112233445566778899aabbccddeeff";
 export declare const MOCK_TX_HASH = "0xaa11bb22cc33dd44ee55ff6600112233445566778899aabbccddeeff00112233";
@@ -22,6 +23,20 @@ export declare class MockWalletProviderPort implements WalletProviderPort {
     sendTransaction: import('vitest').Mock<(_userId: string, _chainId: string, _tx: any) => Promise<{
         txHash: string;
     }>>;
+    migrateWallet: import('vitest').Mock<(_pin: string, _sub: string) => Promise<WalletData>>;
+    verifyPin: import('vitest').Mock<(_pin: string, _sub: string) => Promise<{
+        valid: boolean;
+        pinStatus?: {
+            maxAttempts: number;
+            remainingAttempts: number;
+            lockExpiresAt?: number;
+        };
+    }>>;
+    /** verifyPin이 MIGRATION_FAILED(PIN 불일치)를 반환하도록 설정 */
+    private _simulateWrongPinCount;
+    simulateWrongPin(): void;
+    /** verifyPin이 MIGRATION_PIN_LOCKED(잠금) 응답을 반환하도록 설정 */
+    simulatePinLocked(overrides?: Partial<MigrationLockDetails>): void;
 }
 export { MOCK_WALLET_DATA, MOCK_SIGN_RESPONSE };
 //# sourceMappingURL=MockWalletProviderPort.d.ts.map

package/dist/__tests__/mocks/MockWalletProviderPort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockWalletProviderPort.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/MockWalletProviderPort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,eAAO,MAAM,YAAY,+CAA+C,CAAC;AACzE,eAAO,MAAM,YAAY,uEAAuE,CAAC;AAEjG,QAAA,MAAM,gBAAgB,EAAE,UAKvB,CAAC;AAIF,QAAA,MAAM,kBAAkB,EAAE,YAKzB,CAAC;AAEF;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,iBAAiB,kCAAyB,MAAM,KAAG,OAAO,CAAC,UAAU,CAAC,EAAsB;IAE5F,YAAY,kCAAyB,MAAM,KAAG,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,EAE7F;IAEH,UAAU,kCAAyB,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC,EAG5E;IAEJ,WAAW,kCACO,MAAM,YAAY,MAAM,YAAY,MAAM,WAAW,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,EAEnG;IAEF,aAAa,kCACK,MAAM,YAAY,MAAM,cAAc,OAAO,WAAW,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,EAEtG;IAEF,eAAe,kCACG,MAAM,YAAY,MAAM,OAAO,GAAG,WAAW,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,EAE3F;IAEF,eAAe,kCACG,MAAM,YAAY,MAAM,OAAO,GAAG,KAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAEhF;CACH;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"MockWalletProviderPort.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/MockWalletProviderPort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE5F,eAAO,MAAM,YAAY,+CAA+C,CAAC;AACzE,eAAO,MAAM,YAAY,uEAAuE,CAAC;AAEjG,QAAA,MAAM,gBAAgB,EAAE,UAKvB,CAAC;AAIF,QAAA,MAAM,kBAAkB,EAAE,YAKzB,CAAC;AAEF;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,iBAAiB,kCAAyB,MAAM,KAAG,OAAO,CAAC,UAAU,CAAC,EAAsB;IAE5F,YAAY,kCAAyB,MAAM,KAAG,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,EAE7F;IAEH,UAAU,kCAAyB,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC,EAG5E;IAEJ,WAAW,kCACO,MAAM,YAAY,MAAM,YAAY,MAAM,WAAW,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,EAEnG;IAEF,aAAa,kCACK,MAAM,YAAY,MAAM,cAAc,OAAO,WAAW,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,EAEtG;IAEF,eAAe,kCACG,MAAM,YAAY,MAAM,OAAO,GAAG,WAAW,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,EAE3F;IAEF,eAAe,kCACG,MAAM,YAAY,MAAM,OAAO,GAAG,KAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAEhF;IAEF,aAAa,+BACE,MAAM,QAAQ,MAAM,KAAG,OAAO,CAAC,UAAU,CAAC,EACvD;IAEF,SAAS,+BACM,MAAM,QAAQ,MAAM,KAAG,OAAO,CAAC;QAC1C,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,CAAC,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,iBAAiB,EAAE,MAAM,CAAC;YAAC,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxF,CAAC,EACF;IAEF,qDAAqD;IACrD,OAAO,CAAC,sBAAsB,CAAK;IAEnC,gBAAgB;IAShB,uDAAuD;IACvD,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;CAoB5D;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/adapters/confirmation/BrowserConfirmationAdapter.d.ts

@@ -38,12 +38,47 @@ export declare class BrowserConfirmationAdapter implements ConfirmationPort {
      * @returns 'recover' 또는 'skip'
      */
     showMigrationFoundPrompt(): Promise<'recover' | 'skip'>;
+    /**
+     * 비밀번호 설정 팝업: "Create Password"
+     * Step 1: 동의 화면 (Password Setup Notice) — 3개 체크박스 모두 선택 후 "I Understand"
+     * Step 2: 비밀번호 설정 화면 — 비밀번호 정책 검증 및 확인 입력
+     * @returns 입력된 비밀번호 또는 null(취소)
+     */
+    showPasswordSetupPrompt(options?: {
+        errorMessage?: string;
+    }): Promise<string | null>;
+    /**
+     * 비밀번호 입력 팝업: "Enter Password"
+     * 이미 비밀번호가 설정된 경우 세션 복원 시 사용됩니다.
+     * @returns 입력된 비밀번호 또는 null(취소)
+     */
+    showPasswordInputPrompt(options?: {
+        errorMessage?: string;
+        verifyMode?: boolean;
+        onSubmit?: (password: string) => Promise<{
+            ok: boolean;
+            error?: string;
+        }>;
+    }): Promise<string | null>;
     /**
      * PIN 입력 팝업: "Recover My Wallet"
-     * @param errorMessage 이전 시도 실패 시 에러 메시지
+     * @param options.errorMessage 이전 시도 실패/잠금 해제 안내 메시지
+     * @param options.attemptCount 현재 시도 횟수 (1~maxAttempts)
+     * @param options.maxAttempts 최대 시도 허용 횟수 (기본 5)
      * @returns 4자리 PIN 문자열 또는 null(취소)
      */
-    showPinInputPrompt(errorMessage?: string): Promise<string | null>;
+    showPinInputPrompt(options?: {
+        errorMessage?: string;
+        attemptCount?: number;
+        maxAttempts?: number;
+    }): Promise<string | null>;
+    /**
+     * PIN 잠금 화면을 표시합니다.
+     * 카운트다운이 만료되거나 Close 버튼 클릭 시 resolve됩니다.
+     * @param lockExpiresInSeconds 잠금 만료까지 남은 시간(초, TTL)
+     * @param message 잠금 안내 메시지
+     */
+    showPinLockedPrompt(lockExpiresInSeconds: number, message: string): Promise<void>;
     /**
      * 트랜잭션 전송 완료 팝업을 표시합니다.
      * "Done" 버튼 클릭, 닫기 버튼 클릭, 배경 클릭, Escape 키로 닫힙니다.

package/dist/adapters/confirmation/BrowserConfirmationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserConfirmationAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/confirmation/BrowserConfirmationAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EAEnB,0BAA0B,EAC1B,yBAAyB,EAG1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AAy8DjD,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,KAAK,GAAE,iBAA2B,EAAE,SAAS,CAAC,EAAE,cAAc;IAM1E,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI;IAMpE,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAIxC,QAAQ,IAAI,iBAAiB;IAI7B;;;;OAIG;IACH,kBAAkB,CAChB,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,WAAW,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAC9D,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAyErD;;;;OAIG;IACH,iBAAiB,IAAI,OAAO,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IA8BvD;;;OAGG;IACH,wBAAwB,IAAI,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC;IA0BvD;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBjE;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC3E;;;OAGG;IACH,uBAAuB,CACrB,OAAO,EAAE,yBAAyB,EAClC,cAAc,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC;IAqChB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CA2CpE"}
+{"version":3,"file":"BrowserConfirmationAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/confirmation/BrowserConfirmationAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EAEnB,0BAA0B,EAC1B,yBAAyB,EAG1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AAg9FjD,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,KAAK,GAAE,iBAA2B,EAAE,SAAS,CAAC,EAAE,cAAc;IAM1E,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI;IAMpE,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAIxC,QAAQ,IAAI,iBAAiB;IAI7B;;;;OAIG;IACH,kBAAkB,CAChB,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,WAAW,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAC9D,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAyErD;;;;OAIG;IACH,iBAAiB,IAAI,OAAO,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IA8BvD;;;OAGG;IACH,wBAAwB,IAAI,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC;IA0BvD;;;;;OAKG;IACH,uBAAuB,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgEpF;;;;OAIG;IACH,uBAAuB,CAAC,OAAO,CAAC,EAAE;QAChC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3E,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA+C1B;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiB1B;;;;;OAKG;IACH,mBAAmB,CAAC,oBAAoB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjF;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC3E;;;OAGG;IACH,uBAAuB,CACrB,OAAO,EAAE,yBAAyB,EAClC,cAAc,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC;IAqChB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CA2CpE"}

package/dist/adapters/wallet/MockWalletProviderAdapter.d.ts

@@ -1,12 +1,38 @@
-import { WalletProviderPort, WalletData, SignResponse } from '../../core/ports/WalletProviderPort';
+import { WalletProviderPort, WalletCheckResult, WalletData, SignResponse } from '../../core/ports/WalletProviderPort';
 import { StoragePort } from '../../core/ports';
 import { AddressInfo, EvmTransactionRequest } from '../../core/types/chain';
 import { PrepareAction, PrepareContext, PrepareResult } from '../../core/types/prepare';
+import { MigrationLockDetails } from '../../core/types/errors';
+import { PasswordMemoryStore } from '../../core/services/PasswordMemoryStore';
 
 export declare class MockWalletProviderAdapter implements WalletProviderPort {
     private storage;
-    constructor(storage: StoragePort);
+    /**
+     * migrateWallet 호출 시 동작 제어
+     * - undefined: 정상 성공
+     * - 'wrong_pin': MIGRATION_FAILED 에러 throw
+     * - 'locked': MIGRATION_PIN_LOCKED 에러 throw (lockExpiresAt 초 단위)
+     */
+    migrateScenario?: 'wrong_pin' | {
+        locked: Partial<MigrationLockDetails>;
+    };
+    /**
+     * 비밀번호 시나리오 제어 (목 전용)
+     * - undefined: 항상 성공 (패스워드 무검증)
+     * - 'wrong': changePassword 호출 시 PASSWORD_WRONG 에러 throw
+     */
+    passwordScenario?: 'wrong';
+    private readonly passwordStore;
+    constructor(storage: StoragePort, passwordStore?: PasswordMemoryStore);
+    /**
+     * GET /mnemonic/check 모킹
+     * - migrateScenario 설정 시: migration_required 반환
+     * - 저장된 지갑 있으면: exists 반환
+     * - 없으면: not_found 반환
+     */
+    checkWallet(): Promise<WalletCheckResult>;
     getOrCreateWallet(userId: string): Promise<WalletData>;
+    /** GET /mnemonic/addresses 모킹 — 비밀번호 불필요, 캐시된 주소 반환 */
     getAddresses(_userId: string): Promise<Array<{
         address: string;
         index: number;
@@ -19,8 +45,35 @@ export declare class MockWalletProviderAdapter implements WalletProviderPort {
     sendTransaction(userId: string, chainId: string, tx: EvmTransactionRequest, uuid?: string): Promise<{
         txHash: string;
     }>;
-    recoverWallet(userId: string, shareC: string): Promise<WalletData>;
+    /**
+     * POST /mnemonic/verify-password 모킹
+     * 저장된 비밀번호 해시와 비교하여 일치하면 true 반환
+     */
+    verifyPassword(password: string): Promise<boolean>;
+    /**
+     * POST /mnemonic/change-password 모킹
+     * body: { password: 현재 비밀번호(passwordStore), newPassword }
+     */
+    changePassword(_oldPassword: string, newPassword: string): Promise<void>;
     migrateWallet(pin: string, sub: string): Promise<WalletData>;
+    /**
+     * POST /mnemonic/share-c 모킹
+     * 새로운 Share-C 문자열을 반환합니다.
+     */
+    getShareC(): Promise<string>;
+    /**
+     * POST /mnemonic/verify-pin 모킹
+     * PIN과 sub를 검증합니다.
+     */
+    verifyPin(_pin: string, _sub: string): Promise<{
+        valid: boolean;
+        pinStatus?: {
+            maxAttempts: number;
+            remainingAttempts: number;
+            lockExpiresAt?: number;
+            permanent?: boolean;
+        };
+    }>;
     private generateMockEvmAddress;
     private generateMockSignature;
 }

package/dist/adapters/wallet/MockWalletProviderAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockWalletProviderAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/wallet/MockWalletProviderAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,YAAY,EACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAM7F,qBAAa,yBAA0B,YAAW,kBAAkB;IACtD,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,WAAW;IAElC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBtD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAMjF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO/D,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAMhF,WAAW,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAU,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAKlB,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,KAAK,GAAE,MAAU,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAKlB,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,qBAAqB,EACzB,KAAK,GAAE,MAAU,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAMlB,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,qBAAqB,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAKxB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAYlE,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC;IAYtB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,qBAAqB;CAM9B"}
+{"version":3,"file":"MockWalletProviderAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/wallet/MockWalletProviderAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/wallet/RemoteWalletProviderAdapter.d.ts

@@ -1,9 +1,11 @@
-import { WalletProviderPort, WalletData, SignResponse } from '../../core/ports/WalletProviderPort';
+import { WalletProviderPort, WalletCheckResult, WalletData, SignResponse } from '../../core/ports/WalletProviderPort';
 import { StoragePort } from '../../core/ports/StoragePort';
 import { TransportPort } from '../../core/ports/TransportPort';
 import { TokenMemoryStore } from '../../core/services/TokenMemoryStore';
 import { AddressInfo, EvmTransactionRequest } from '../../core/types/chain';
 import { PrepareAction, PrepareContext, PrepareResult } from '../../core/types/prepare';
+import { VerifyPinResp } from './types';
+import { PasswordMemoryStore } from '../../core/services/PasswordMemoryStore';
 
 export interface RemoteWalletProviderConfig {
     gatewayUrl: string;
@@ -15,17 +17,40 @@ export declare class RemoteWalletProviderAdapter implements WalletProviderPort {
     private readonly storage;
     private readonly transport;
     private readonly tokenStore;
-    constructor(config: RemoteWalletProviderConfig, storage: StoragePort, transport: TransportPort, tokenStore: TokenMemoryStore);
+    private readonly passwordStore;
+    /** checkWallet 결과 1회용 캐시 — getOrCreateWallet에서 소비 후 null로 초기화 */
+    private _walletStatusCache;
+    constructor(config: RemoteWalletProviderConfig, storage: StoragePort, transport: TransportPort, tokenStore: TokenMemoryStore, passwordStore?: PasswordMemoryStore);
+    private getPassword;
     private get baseUrl();
     private getAuthToken;
     private request;
+    /**
+     * GET /mnemonic/check — 지갑 존재 여부 확인 (비밀번호 불필요)
+     * 결과를 내부 캐시에 저장하여 getOrCreateWallet에서 재사용합니다.
+     */
+    checkWallet(): Promise<WalletCheckResult>;
+    /**
+     * 지갑 생성 또는 로드
+     * - checkWallet() 캐시가 있으면 재사용 (이중 요청 방지)
+     * - exists: POST /mnemonic/address(index=0) 로 주소 조회 (비밀번호 필요)
+     * - not_found: POST /mnemonic/create (비밀번호 필요)
+     * - migration_required: MIGRATION_BACKUP_EXISTS 에러 throw
+     */
     getOrCreateWallet(userId: string): Promise<WalletData>;
+    /**
+     * GET /mnemonic/addresses — 캐시된 주소 목록 조회 (비밀번호 불필요)
+     * 서버 캐시가 비어 있으면 빈 배열 반환.
+     * 주소를 채우려면 POST /mnemonic/address 로 개별 조회 필요.
+     */
     getAddresses(_userId: string): Promise<Array<{
         address: string;
         index: number;
     }>>;
-    getAddress(userId: string, index: number): Promise<AddressInfo>;
-    private isAddressNotFoundError;
+    /**
+     * POST /mnemonic/address — 특정 인덱스 주소 조회 (비밀번호 필요)
+     */
+    getAddress(_userId: string, index: number): Promise<AddressInfo>;
     prepare(action: PrepareAction, context: PrepareContext): Promise<PrepareResult>;
     signMessage(_userId: string, chainId: string, message: string, _index?: number, uuid?: string, from?: string): Promise<SignResponse>;
     signTypedData(_userId: string, chainId: string, typedData: unknown, _index?: number, uuid?: string, from?: string): Promise<SignResponse>;
@@ -34,8 +59,34 @@ export declare class RemoteWalletProviderAdapter implements WalletProviderPort {
     sendTransaction(userId: string, chainId: string, tx: EvmTransactionRequest, uuid?: string): Promise<{
         txHash: string;
     }>;
-    recoverWallet(userId: string, shareC: string): Promise<WalletData>;
     migrateWallet(pin: string, sub: string): Promise<WalletData>;
+    /**
+     * POST /mnemonic/withdraw — 지갑 및 사용자 데이터 삭제
+     * body: { confirmation: string, password: string }
+     */
+    withdrawWallet(confirmation: string): Promise<void>;
+    /**
+     * POST /mnemonic/verify-password — 비밀번호 검증
+     * Share-A를 KMS로 복호화해 비밀번호 유효성을 확인합니다 (캐시 없이 항상 Signer 호출).
+     */
+    verifyPassword(password: string): Promise<boolean>;
+    /**
+     * POST /mnemonic/change-password — 비밀번호 변경
+     * body: { password: 현재 비밀번호, newPassword: 새 비밀번호 }
+     */
+    changePassword(_oldPassword: string, newPassword: string): Promise<void>;
+    /**
+     * POST /mnemonic/share-c — 새로운 Share-C 발급
+     * 기존 Share-C를 무효화하고 새로운 Share-C를 반환합니다.
+     */
+    getShareC(): Promise<string>;
+    /**
+     * POST /mnemonic/verify-pin — 레거시 CROSSx 백업 PIN 검증
+     * 마이그레이션 전 PIN 유효성 및 잠금 상태 확인에 사용합니다.
+     */
+    verifyPin(pin: string, sub: string): Promise<VerifyPinResp>;
+    /** passwordStore에서 비밀번호를 가져오거나 PASSWORD_NOT_SET 에러를 throw */
+    private requirePassword;
     private static mapGatewayError;
     private static getGatewayErrorMessage;
 }

package/dist/adapters/wallet/RemoteWalletProviderAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteWalletProviderAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/wallet/RemoteWalletProviderAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RemoteWalletProviderAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/wallet/RemoteWalletProviderAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/wallet/types.d.ts

@@ -14,43 +14,82 @@ export interface UnsignedTx {
     maxFeePerGas?: string;
     maxPriorityFeePerGas?: string;
 }
+/** POST /mnemonic/sign/:chainId */
 export interface SignTxReq {
     unsignedTx: UnsignedTx;
     uuid?: string;
+    password?: string;
 }
+/** POST /mnemonic/send/:chainId */
 export interface SendTxReq {
     unsignedTx: UnsignedTx;
     uuid?: string;
+    password?: string;
 }
+/** POST /mnemonic/sign-message */
 export interface SignMessageReq {
     message: string;
     from?: string;
     uuid?: string;
+    password?: string;
 }
 export interface GatewaySignMessageResp {
     signature: string;
 }
+/** POST /mnemonic/sign-typed-data/:chainId */
 export interface SignTypedDataReq {
     typedData: unknown;
     from?: string;
     uuid?: string;
+    password?: string;
 }
 export interface GatewaySignTypedDataResp {
     signature: string;
 }
+/** POST /mnemonic/create */
 export interface CreateWalletReq {
     ignoreBackup: boolean;
+    password: string;
 }
-export interface RecoverWalletReq {
-    shareC: string;
-}
+/** POST /mnemonic/migrate */
 export interface MigrateWalletReq {
     pin: string;
     sub: string;
+    password: string;
 }
-export interface MigrateWalletResp {
-    address: string;
-    shareC: string;
+/** POST /mnemonic/withdraw */
+export interface WithdrawWalletReq {
+    confirmation: string;
+    password: string;
+}
+/** POST /mnemonic/verify-password */
+export interface VerifyPasswordReq {
+    password: string;
+}
+/**
+ * POST /mnemonic/address
+ * 특정 파생 인덱스의 지갑 주소 조회 (비밀번호 필요)
+ */
+export interface GetAddressReq {
+    password: string;
+    index: number;
+}
+/**
+ * POST /mnemonic/change-password
+ * body 필드명: password (현재), newPassword (변경할 값)
+ */
+export interface ChangePasswordReq {
+    password: string;
+    newPassword: string;
+}
+/** POST /mnemonic/share-c — 새로운 Share-C 발급 (기존 무효화) */
+export interface GetShareCReq {
+    password: string;
+}
+/** POST /mnemonic/verify-pin — 레거시 CROSSx 백업 PIN 검증 */
+export interface VerifyPinReq {
+    pin: string;
+    sub: string;
 }
 export interface JsonRpcRequest {
     jsonrpc: string;
@@ -58,6 +97,10 @@ export interface JsonRpcRequest {
     params?: any[];
     id?: any;
 }
+/** GET /mnemonic/check */
+export interface CheckWalletResp {
+    result: 'exists' | 'migration_required' | 'not_found';
+}
 export interface CreateWalletResp {
     address: string;
     shareC: string;
@@ -80,9 +123,31 @@ export interface GatewaySignTxResp {
 export interface GatewaySendTxResp {
     txHash: string;
 }
-export interface RecoverWalletResp {
+export interface WithdrawWalletResp {
+    success: boolean;
+}
+export interface VerifyPasswordResp {
+    verified: boolean;
+}
+export interface MigrateWalletResp {
     address: string;
-    newShareC: string;
+    shareC: string;
+}
+export interface GetShareCResp {
+    shareC: string;
+}
+export interface PinLockStatus {
+    maxAttempts: number;
+    remainingAttempts: number;
+    /** 잠금이 발생했을 때만 존재 (Unix 초 단위 타임스탬프) */
+    lockExpiresAt?: number;
+    /** 영구 잠금 여부 — -10027 에러 본문에서만 사용 */
+    permanent?: boolean;
+}
+export interface VerifyPinResp {
+    valid: boolean;
+    /** PIN 틀림 / 잠금 발생 시에만 존재. valid: true이면 undefined */
+    pinStatus?: PinLockStatus;
 }
 export interface JsonRpcError {
     code: number;

package/dist/adapters/wallet/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/wallet/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/wallet/types.ts"],"names":[],"mappings":"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"}

package/dist/core/i18n/messages.en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.en.d.ts","sourceRoot":"","sources":["../../../src/core/i18n/messages.en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WA0CzB,CAAC"}
+{"version":3,"file":"messages.en.d.ts","sourceRoot":"","sources":["../../../src/core/i18n/messages.en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WA4EzB,CAAC"}

package/dist/core/i18n/messages.ko.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.ko.d.ts","sourceRoot":"","sources":["../../../src/core/i18n/messages.ko.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WA0CzB,CAAC"}
+{"version":3,"file":"messages.ko.d.ts","sourceRoot":"","sources":["../../../src/core/i18n/messages.ko.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WA4EzB,CAAC"}

package/dist/core/i18n/types.d.ts

@@ -27,5 +27,31 @@ export interface SDKMessages {
     walletSelector_title: string;
     walletSelector_addButton: string;
     walletSelector_selected: string;
+    passwordNotice_headerSubtitle: string;
+    passwordNotice_title: string;
+    passwordNotice_description: string;
+    passwordNotice_check1: string;
+    passwordNotice_check2: string;
+    passwordNotice_check3: string;
+    passwordNotice_nextButton: string;
+    passwordNotice_submitButton: string;
+    passwordSetup_title: string;
+    passwordSetup_subtitle: string;
+    passwordSetup_newPasswordLabel: string;
+    passwordSetup_confirmPasswordLabel: string;
+    passwordSetup_rule_minLength: string;
+    passwordSetup_rule_uppercase: string;
+    passwordSetup_rule_number: string;
+    passwordSetup_rule_special: string;
+    passwordSetup_confirmError: string;
+    passwordSetup_submitButton: string;
+    passwordInput_title: string;
+    passwordInput_subtitle: string;
+    passwordInput_passwordLabel: string;
+    passwordInput_submitButton: string;
+    passwordInput_error: string;
+    verifyPassword_title: string;
+    verifyPassword_subtitle: string;
+    verifyPassword_passwordLabel: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/core/i18n/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/i18n/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IAGd,iBAAiB,EAAE,MAAM,CAAC;IAG1B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAG9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAGnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE,MAAM,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAG7B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IAGvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/i18n/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IAGd,iBAAiB,EAAE,MAAM,CAAC;IAG1B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAG9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAGnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE,MAAM,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAG7B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IAGvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;IAGhC,6BAA6B,EAAE,MAAM,CAAC;IACtC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,2BAA2B,EAAE,MAAM,CAAC;IAGpC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,8BAA8B,EAAE,MAAM,CAAC;IACvC,kCAAkC,EAAE,MAAM,CAAC;IAC3C,4BAA4B,EAAE,MAAM,CAAC;IACrC,4BAA4B,EAAE,MAAM,CAAC;IACrC,yBAAyB,EAAE,MAAM,CAAC;IAClC,0BAA0B,EAAE,MAAM,CAAC;IACnC,0BAA0B,EAAE,MAAM,CAAC;IACnC,0BAA0B,EAAE,MAAM,CAAC;IAGnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2BAA2B,EAAE,MAAM,CAAC;IACpC,0BAA0B,EAAE,MAAM,CAAC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,4BAA4B,EAAE,MAAM,CAAC;CACtC"}

package/dist/core/ports/ConfirmationPort.d.ts

@@ -101,10 +101,23 @@ export interface ConfirmationPort {
     showMigrationFoundPrompt(): Promise<'recover' | 'skip'>;
     /**
      * 마이그레이션 PIN 입력 UI를 표시합니다.
-     * @param errorMessage 이전 시도 실패 시 표시할 에러 메시지
+     * @param options.errorMessage 이전 시도 실패/잠금 해제 시 표시할 메시지
+     * @param options.attemptCount 현재 시도 횟수 (1~maxAttempts). X/maxAttempts 형태로 표시
+     * @param options.maxAttempts 최대 시도 허용 횟수 (기본 5)
      * @returns 입력된 PIN 문자열 또는 null(취소)
      */
-    showPinInputPrompt(errorMessage?: string): Promise<string | null>;
+    showPinInputPrompt(options?: {
+        errorMessage?: string;
+        attemptCount?: number;
+        maxAttempts?: number;
+    }): Promise<string | null>;
+    /**
+     * PIN 잠금 화면을 표시합니다. 카운트다운이 만료되면 자동으로 resolve됩니다.
+     * Close 버튼 클릭 시에도 resolve됩니다 (SDK에서 별도 처리).
+     * @param lockExpiresInSeconds 잠금 만료까지 남은 시간(초, TTL)
+     * @param message 잠금 안내 메시지 (Lock1/Lock2 구분)
+     */
+    showPinLockedPrompt(lockExpiresInSeconds: number, message: string): Promise<void>;
     /**
      * 지갑 선택 UI를 표시합니다.
      * "add a wallet" 클릭 시 onAddWallet 콜백이 호출되고 목록에 추가됩니다.
@@ -125,6 +138,39 @@ export interface ConfirmationPort {
         address: string;
         index: number;
     } | null>;
+    /**
+     * 비밀번호 최초 설정 UI를 표시합니다. (Create Password)
+     * 비밀번호 정책 검증 및 확인 입력을 포함합니다.
+     * @param options.errorMessage 이전 시도 실패 시 표시할 메시지
+     * @returns 입력된 비밀번호 문자열 또는 null(취소)
+     */
+    showPasswordSetupPrompt(options?: {
+        errorMessage?: string;
+    }): Promise<string | null>;
+    /**
+     * 비밀번호 입력 UI를 표시합니다. (Enter Password)
+     * 이미 비밀번호가 설정된 경우 세션 복원 시 사용됩니다.
+     * @param options.errorMessage 이전 시도 실패 시 표시할 메시지
+     * @param options.title 모달 제목 오버라이드 (기본: i18n passwordInput_title)
+     * @param options.subtitle 모달 부제목 오버라이드 (기본: i18n passwordInput_subtitle)
+     * @param options.passwordLabel 입력 필드 레이블 오버라이드 (기본: i18n passwordInput_passwordLabel)
+     * @returns 입력된 비밀번호 문자열 또는 null(취소)
+     */
+    showPasswordInputPrompt(options?: {
+        errorMessage?: string;
+        /** true이면 "Verify Your Password" 제목 및 부제목을 사용합니다 (세션 복원 후 검증 플로우) */
+        verifyMode?: boolean;
+        /**
+         * 제출 시 호출되는 비동기 검증 콜백.
+         * 제공 시 모달은 검증이 완료될 때까지 닫히지 않습니다.
+         * - `{ ok: true }` 반환 → 모달 닫힘
+         * - `{ ok: false, error }` 반환 → 에러 메시지를 인라인으로 표시하고 재입력 대기
+         */
+        onSubmit?: (password: string) => Promise<{
+            ok: boolean;
+            error?: string;
+        }>;
+    }): Promise<string | null>;
     /**
      * 런타임에 UI 테마를 변경합니다.
      * 다음 UI가 열릴 때부터 적용됩니다.

package/dist/core/ports/ConfirmationPort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfirmationPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/ConfirmationPort.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConfirmationPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/ConfirmationPort.ts"],"names":[],"mappings":"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"}