@nexus-cross/crossx-sdk-core 0.0.0-beta.2

package/README.md

@@ -0,0 +1,302 @@
+# @nexus-cross/crossx-sdk-core
+
+CROSSx Embedded Wallet SDK — Clean Architecture + Hexagonal Architecture 기반
+
+## 특징
+
+- **EIP-1193 Provider**: ethers.js / viem / wagmi 와 바로 연동
+- **Clean Architecture**: 순수 비즈니스 로직과 구현 분리
+- **환경 독립적**: Web / Node / React Native 모두 지원 가능
+- **Port & Adapters**: 구현체를 교체해도 core 코드 변경 없음
+- **CAIP-2**: 표준 체인 ID 형식 (`eip155:612044`)
+- **트랜잭션 컨펌 모달**: 서명/전송 전 사용자 승인 필수 (우회 불가)
+
+## 설치
+
+```bash
+npm install @nexus-cross/crossx-sdk-core
+```
+
+## 빠른 시작
+
+```ts
+import { createCROSSxSDK, ChainId } from '@nexus-cross/crossx-sdk-core';
+
+const sdk = createCROSSxSDK({
+  receiptPolling: { intervalMs: 2000, timeoutMs: 60000 }, // 선택
+});
+
+await sdk.init();
+const result = await sdk.signIn();
+console.log('지갑 주소:', sdk.getAddress());
+```
+
+> 백엔드 URL은 `.env`의 `VITE_*` 환경 변수로만 설정합니다.
+> `SDKConfig`에 URL 필드를 추가하거나 직접 전달하지 마세요.
+
+---
+
+## API 레퍼런스
+
+### 초기화 & 인증
+
+```ts
+// SDK 초기화 (자동 로그인 복구 포함)
+await sdk.init();
+
+// 로그인 (OAuth popup)
+const result = await sdk.signIn();
+const result = await sdk.signIn({ provider: 'google' });
+
+// 인증 상태 확인
+sdk.isAuthenticated(); // boolean
+sdk.getAddress();      // string | null
+
+// 로그아웃
+await sdk.signOut();
+
+// 계정 탈퇴
+await sdk.withdraw();
+```
+
+---
+
+### 지갑
+
+```ts
+// 지갑 생성 (로그인 후 지갑이 없을 때)
+const { address } = await sdk.createWallet();
+
+// 네이티브 잔액 조회
+const { wei, formatted } = await sdk.getBalance('eip155:612044');
+console.log(formatted); // "1.234567 CROSS"
+
+// 현재 nonce 조회
+const nonce = await sdk.getNonce('eip155:612044');
+```
+
+---
+
+### 트랜잭션 컨펌 모달
+
+`signTransaction()` / `sendTransaction()` / `sendTransactionAndWait()` 호출 시 SDK가 자동으로 사용자 승인 모달을 표시합니다. DApp 개발자가 우회할 수 있는 공개 API는 없습니다.
+
+```ts
+import { CROSSxError, ErrorCode } from '@nexus-cross/crossx-sdk-core';
+
+try {
+  const result = await sdk.signTransaction(ChainId.CROSS_TESTNET, tx);
+} catch (error) {
+  if (error instanceof CROSSxError && error.code === ErrorCode.USER_REJECTED) {
+    console.log('사용자가 취소했습니다');
+  }
+}
+```
+
+> 자세한 내용 → [트랜잭션 컨펌 모달 가이드](../../doc/transaction-confirmation.md)
+
+---
+
+### 트랜잭션 서명 & 전송
+
+```ts
+const tx = {
+  from:                 sdk.getAddress()!,
+  to:                   '0x...',
+  value:                '0x2386f26fc10000',
+  data:                 '0x',
+  chainId:              612044,
+  gasLimit:             '0x5208',
+  maxFeePerGas:         '0x77359400',
+  maxPriorityFeePerGas: '0x3b9aca00',
+  nonce:                await sdk.getNonce('eip155:612044'),
+};
+
+// 서명만
+const { signedTx, txHash } = await sdk.signTransaction('eip155:612044', tx);
+
+// 전송 (status: 'pending' 즉시 반환)
+const { txHash } = await sdk.sendTransaction('eip155:612044', tx);
+
+// 전송 + Receipt 폴링 (블록 포함까지 대기)
+const { txHash, receipt } = await sdk.sendTransactionAndWait('eip155:612044', tx);
+console.log(receipt.status); // '0x1' = success, '0x0' = reverted
+```
+
+---
+
+### Receipt 조회 & 폴링
+
+```ts
+// 단일 조회 (채굴 전이면 null)
+const receipt = await sdk.getTransactionReceipt(txHash, 'eip155:612044');
+
+// 채굴될 때까지 폴링
+const receipt = await sdk.waitForTransaction(txHash, 'eip155:612044');
+
+// 폴링 옵션 오버라이드
+const receipt = await sdk.waitForTransaction(txHash, 'eip155:612044', {
+  intervalMs: 3000,
+  timeoutMs:  120000,
+});
+```
+
+---
+
+### EIP-1193 Provider
+
+ethers.js, viem, wagmi 등과 연동하기 위한 표준 Provider입니다.
+
+```ts
+const provider = sdk.getProvider('eip155:612044');
+
+// ethers.js
+import { ethers } from 'ethers';
+const ethersProvider = new ethers.BrowserProvider(provider);
+const signer = await ethersProvider.getSigner();
+await signer.sendTransaction({ to: '0x...', value: ethers.parseEther('0.01') });
+
+// viem
+import { createWalletClient, custom } from 'viem';
+const client = createWalletClient({ transport: custom(provider) });
+```
+
+---
+
+### 범용 RPC 호출
+
+`/wallet/rpc` 엔드포인트를 통해 노드에 직접 JSON-RPC 요청을 보냅니다.
+
+```ts
+// 네이티브 잔액
+const balance = await sdk.rpcRequest('eth_getBalance', [address, 'latest'], 'eip155:612044');
+
+// eth_call — ERC-20 balanceOf
+const selector = '70a08231';
+const padded   = address.slice(2).padStart(64, '0');
+const raw = await sdk.rpcRequest(
+  'eth_call',
+  [{ to: contractAddress, data: '0x' + selector + padded }, 'latest'],
+  'eip155:612044',
+);
+console.log(BigInt(raw).toString());
+
+// Provider를 통한 동일 호출
+const result = await provider.request({
+  method: 'eth_call',
+  params: [{ to: contractAddress, data: '0x' + selector + padded }, 'latest'],
+});
+```
+
+---
+
+## SDKConfig
+
+```ts
+const sdk = createCROSSxSDK({
+  /** OAuth 팝업 방식: 'popup' (기본) | 'modal' */
+  oauthDisplayMode: 'popup',
+
+  /** Mock 지갑 사용 여부 (개발/테스트용) */
+  useMockWallet: false,
+
+  /** 확인 모달 테마: 'light' (기본) | 'dark' */
+  theme: 'light',
+
+  /**
+   * 확인 모달 색상 커스터마이징 (light / dark 모드별 독립 오버라이드)
+   */
+  themeTokens: {
+    light: {
+      primary: '#FF6B35',  // 버튼·강조색 (기본: #019D92)
+      bg:      '#F5F0EB',  // 카드 배경색 (기본: #FFFFFF)
+    },
+    dark: {
+      primary: '#FF6B35',
+      bg:      '#1A0A00',  // 카드 배경색 (기본: #121212)
+    },
+  },
+
+  /** Receipt 폴링 기본값 */
+  receiptPolling: {
+    intervalMs: 2000,  // 폴링 간격 (ms)
+    timeoutMs: 60000,  // 최대 대기 시간 (ms)
+  },
+
+  /**
+   * 디버그 로그 출력 여부 (기본: true)
+   * ⚠️ 프로덕션 빌드에서는 이 값과 관계없이 항상 비활성화됩니다.
+   */
+  debug: true,
+});
+```
+
+### 확인 모달 테마
+
+| 방법 | 설명 |
+|---|---|
+| `config.theme` | 초기 테마 설정 (`'light'` 기본) |
+| `sdk.setTheme('dark')` | 런타임 테마 전환 (`themeTokens` 오버라이드 유지) |
+| `config.themeTokens.light.*` | 라이트 모드 Semantic 토큰 오버라이드 |
+| `config.themeTokens.dark.*` | 다크 모드 Semantic 토큰 오버라이드 |
+
+오버라이드 가능한 토큰: `primary` · `secondary` · `onPrimary` · `borderDefault` · `borderSubtle` · `textPrimary` · `textSecondary` · `textTertiary` · `surfaceDefault` · `bg`
+
+자세한 내용은 [컨펌 모달 & Prepare 플로우](../../doc/transaction-confirmation.md#색상-커스터마이징-themetokens)를 참고하세요.
+
+---
+
+## 체인 ID 상수
+
+오타 방지를 위해 `ChainId` 상수를 사용하세요.
+
+```ts
+import { ChainId } from '@nexus-cross/crossx-sdk-core';
+
+await sdk.getBalance(ChainId.CROSS_TESTNET);  // 'eip155:612044'
+await sdk.getBalance(ChainId.CROSS_MAINNET);  // 'eip155:612055'
+```
+
+---
+
+## 환경 변수
+
+| 변수명 | 용도 | 필수 |
+|---|---|---|
+| `VITE_WALLET_GATEWAY_URL` | Wallet Gateway API URL | ✅ |
+| `VITE_OAUTH_SERVICE_URL` | OAuth 서비스 URL | ✅ |
+| `VITE_AUTH_API_URL` | 인증 API URL | ✅ |
+
+---
+
+## 공개 타입
+
+```ts
+import type {
+  SDKConfig,
+  ConfirmationTokenOverride,   // themeTokens 타입 (light/dark 모드별 오버라이드)
+  ConfirmationThemeTokens,     // 단일 모드 Semantic 토큰 타입
+  AuthResult,
+  EvmTransactionRequest,
+  TransactionResult,
+  TransactionWithReceipt,      // sendTransactionAndWait() 반환 타입
+  TransactionReceipt,          // waitForTransaction() 반환 타입
+  SignTransactionResult,
+  ChainIdValue,
+} from '@nexus-cross/crossx-sdk-core';
+```
+
+---
+
+## 관련 문서
+
+- [트랜잭션 컨펌 모달](../../doc/transaction-confirmation.md)
+- [Ethereum Provider 가이드](../../doc/ethereum-provider.md)
+- [환경 변수 설정](../../doc/environment-variables.md)
+- [CAIP-2 체인 ID 가이드](../../doc/caip-integration.md)
+- [wagmi 통합 가이드](../../doc/wagmi-integration.md)
+- [아키텍처 설명](../../doc/architecture.md)
+
+## 라이센스
+
+MIT

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

@@ -0,0 +1,15 @@
+import { CryptoPort, JWTVerifyResult } from '../../core/ports';
+import { JWTPayload } from '../../core/types';
+
+declare const DEFAULT_PAYLOAD: JWTPayload;
+/**
+ * CryptoPort mock.
+ * 기본적으로 유효한 JWT 검증 결과를 반환합니다.
+ * 만료 시나리오 테스트 시 verifyJWT.mockResolvedValueOnce({ valid: false, payload: ... }) 로 오버라이드하세요.
+ */
+export declare class MockCryptoPort implements CryptoPort {
+    verifyJWT: import('vitest').Mock<(_token: string) => Promise<JWTVerifyResult>>;
+    decodeJWT: import('vitest').Mock<(_token: string) => JWTPayload>;
+}
+export { DEFAULT_PAYLOAD };
+//# sourceMappingURL=MockCryptoPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MockCryptoPort.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/MockCryptoPort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,QAAA,MAAM,eAAe,EAAE,UAKtB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,SAAS,iCAAwB,MAAM,KAAG,OAAO,CAAC,eAAe,CAAC,EAI9D;IAEJ,SAAS,iCAAkB,MAAM,KAAG,UAAU,EAAqB;CACpE;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

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

@@ -0,0 +1,11 @@
+import { OAuthPort, OAuthConfig } from '../../core/ports';
+
+/**
+ * OAuthPort mock.
+ * 기본적으로 'mock-firebase-token' 을 반환합니다.
+ * 실패 시나리오는 openAuth.mockRejectedValueOnce(new Error('popup closed')) 로 테스트하세요.
+ */
+export declare class MockOAuthPort implements OAuthPort {
+    openAuth: import('vitest').Mock<(_config: OAuthConfig) => Promise<string>>;
+}
+//# sourceMappingURL=MockOAuthPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MockOAuthPort.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/MockOAuthPort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,kCAAyB,WAAW,KAAG,OAAO,CAAC,MAAM,CAAC,EAA2B;CAC1F"}

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

@@ -0,0 +1,18 @@
+import { StoragePort } from '../../core/ports';
+
+/**
+ * In-memory StoragePort mock.
+ * 각 테스트에서 new MockStoragePort() 로 독립적인 인스턴스를 생성하세요.
+ */
+export declare class MockStoragePort implements StoragePort {
+    private store;
+    set<T>(key: string, value: T): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    /** 테스트 헬퍼: 현재 저장된 값을 동기적으로 조회 */
+    peek<T>(key: string): T | undefined;
+    /** 테스트 헬퍼: 저장된 키 목록 */
+    keys(): string[];
+}
+//# sourceMappingURL=MockStoragePort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MockStoragePort.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/MockStoragePort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,KAAK,CAA8B;IAErC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAItC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,iCAAiC;IACjC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAInC,uBAAuB;IACvB,IAAI,IAAI,MAAM,EAAE;CAGjB"}

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

@@ -0,0 +1,14 @@
+import { TransportPort, TransportRequest, TransportResponse } from '../../core/ports';
+
+/**
+ * vi.fn() 기반 TransportPort mock.
+ * request 메서드의 반환값을 테스트마다 mockResolvedValueOnce 로 제어하세요.
+ *
+ * @example
+ * const transport = new MockTransportPort();
+ * transport.request.mockResolvedValueOnce({ status: 200, data: { access_token: 'abc' }, headers: {} });
+ */
+export declare class MockTransportPort implements TransportPort {
+    request: import('vitest').Mock<(_req: TransportRequest) => Promise<TransportResponse>>;
+}
+//# sourceMappingURL=MockTransportPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MockTransportPort.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/MockTransportPort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE3F;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,+BAAsB,gBAAgB,KAAG,OAAO,CAAC,iBAAiB,CAAC,EAItE;CACL"}

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

@@ -0,0 +1,28 @@
+import { WalletProviderPort, WalletData, SignResponse } from '../../core/ports';
+import { AddressInfo, TransactionReceipt } from '../../core/types/chain';
+
+export declare const MOCK_ADDRESS = "0xaabbccdd00112233445566778899aabbccddeeff";
+export declare const MOCK_TX_HASH = "0xaa11bb22cc33dd44ee55ff6600112233445566778899aabbccddeeff00112233";
+declare const MOCK_WALLET_DATA: WalletData;
+declare const MOCK_SIGN_RESPONSE: SignResponse;
+declare const MOCK_RECEIPT: TransactionReceipt;
+/**
+ * WalletProviderPort mock.
+ * 모든 메서드가 vi.fn() 으로 spy 되어 있어 호출 여부/인수 검증이 가능합니다.
+ */
+export declare class MockWalletProviderPort implements WalletProviderPort {
+    getOrCreateWallet: import('vitest').Mock<(_userId: string) => Promise<WalletData>>;
+    getAddress: import('vitest').Mock<(_userId: string, _index: number) => Promise<AddressInfo>>;
+    signMessage: import('vitest').Mock<(_userId: string, _chainId: string, _message: string, _index?: number) => Promise<SignResponse>>;
+    signTransaction: import('vitest').Mock<(_userId: string, _chainId: string, _tx: any, _index?: number) => Promise<SignResponse>>;
+    sendTransaction: import('vitest').Mock<(_userId: string, _chainId: string, _tx: any) => Promise<{
+        txHash: string;
+    }>>;
+    getBalance: import('vitest').Mock<(_userId: string, _chainId: string) => Promise<string>>;
+    getTransactionCount: import('vitest').Mock<(_userId: string, _chainId: string) => Promise<number>>;
+    getTransactionReceipt: import('vitest').Mock<(_userId: string, _txHash: string) => Promise<TransactionReceipt | null>>;
+    rpcRequest: import('vitest').Mock<(_method: string, _params: any[], _chainId: string) => Promise<any>>;
+    withdraw: import('vitest').Mock<(_confirmation: string) => Promise<void>>;
+}
+export { MOCK_WALLET_DATA, MOCK_SIGN_RESPONSE, MOCK_RECEIPT };
+//# sourceMappingURL=MockWalletProviderPort.d.ts.map

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

@@ -0,0 +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,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,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,QAAA,MAAM,YAAY,EAAE,kBAYnB,CAAC;AAEF;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,iBAAiB,kCAAyB,MAAM,KAAG,OAAO,CAAC,UAAU,CAAC,EAAsB;IAE5F,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,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,UAAU,kCAAyB,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,EAAuB;IAEpG,mBAAmB,kCAAyB,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,EAAO;IAE7F,qBAAqB,kCACH,MAAM,WAAW,MAAM,KAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAE5E;IAEF,UAAU,kCAAyB,MAAM,WAAW,GAAG,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,GAAG,CAAC,EAAU;IAEpG,QAAQ,wCAA+B,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,EAAQ;CACtE;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC"}

package/dist/__tests__/sdk/CROSSxSDK.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CROSSxSDK.test.d.ts.map

package/dist/__tests__/sdk/CROSSxSDK.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CROSSxSDK.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/sdk/CROSSxSDK.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sdk/EthereumProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EthereumProvider.test.d.ts.map

package/dist/__tests__/sdk/EthereumProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EthereumProvider.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/sdk/EthereumProvider.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/usecases/SignInUseCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SignInUseCase.test.d.ts.map

package/dist/__tests__/usecases/SignInUseCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignInUseCase.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/usecases/SignInUseCase.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/usecases/SignOutUseCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SignOutUseCase.test.d.ts.map

package/dist/__tests__/usecases/SignOutUseCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignOutUseCase.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/usecases/SignOutUseCase.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/usecases/WithdrawUseCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WithdrawUseCase.test.d.ts.map

package/dist/__tests__/usecases/WithdrawUseCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WithdrawUseCase.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/usecases/WithdrawUseCase.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,36 @@
+import { ConfirmationPort, ConfirmationDetails, TransactionCompleteDetails } from '../../core/ports/ConfirmationPort';
+import { SDKThemeTokens } from '../../core/types';
+
+export type ConfirmationTheme = 'light' | 'dark';
+export declare class BrowserConfirmationAdapter implements ConfirmationPort {
+    private theme;
+    private overrides;
+    private tokens;
+    constructor(theme?: ConfirmationTheme, overrides?: SDKThemeTokens);
+    setTheme(theme: ConfirmationTheme, overrides?: SDKThemeTokens): void;
+    getTheme(): ConfirmationTheme;
+    /**
+     * 로그인 프로바이더 선택 팝업: "Welcome onboard"
+     * Apple / Google 버튼을 표시하고 선택된 프로바이더를 반환합니다.
+     * @returns 'google' | 'apple' | null(취소)
+     */
+    showLoginSelector(): Promise<'google' | 'apple' | null>;
+    /**
+     * 마이그레이션 발견 팝업: "Wallet Found on Social Account"
+     * @returns 'recover' 또는 'skip'
+     */
+    showMigrationFoundPrompt(): Promise<'recover' | 'skip'>;
+    /**
+     * PIN 입력 팝업: "Recover My Wallet"
+     * @param errorMessage 이전 시도 실패 시 에러 메시지
+     * @returns 4자리 PIN 문자열 또는 null(취소)
+     */
+    showPinInputPrompt(errorMessage?: string): Promise<string | null>;
+    /**
+     * 트랜잭션 전송 완료 팝업을 표시합니다.
+     * "Done" 버튼 클릭, 닫기 버튼 클릭, 배경 클릭, Escape 키로 닫힙니다.
+     */
+    showTransactionComplete(details: TransactionCompleteDetails): Promise<void>;
+    requestConfirmation(details: ConfirmationDetails): Promise<boolean>;
+}
+//# sourceMappingURL=BrowserConfirmationAdapter.d.ts.map

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

@@ -0,0 +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,EAG3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AAk/CjD,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,MAAM,CAAc;gBAEhB,KAAK,GAAE,iBAA2B,EAAE,SAAS,CAAC,EAAE,cAAc;IAM1E,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI;IAMpE,QAAQ,IAAI,iBAAiB;IAI7B;;;;OAIG;IACH,iBAAiB,IAAI,OAAO,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IA+BvD;;;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,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CA2CpE"}

package/dist/adapters/crypto/JoseCryptoAdapter.d.ts

@@ -0,0 +1,16 @@
+import { CryptoPort, JWTVerifyOptions, JWTVerifyResult } from '../../core/ports';
+import { JWTPayload } from '../../core/types';
+
+export declare class JoseCryptoAdapter implements CryptoPort {
+    verifyJWT(token: string, options?: JWTVerifyOptions): Promise<JWTVerifyResult>;
+    decodeJWT(token: string): JWTPayload;
+    /**
+     * EIP-191 personal_sign 서명에서 서명자 Ethereum 주소를 복원합니다.
+     *
+     * hash = keccak256("\x19Ethereum Signed Message:\n" + len(msgBytes) + msgBytes)
+     * publicKey = ecrecover(hash, v, r, s)
+     * address   = keccak256(publicKey)[12:]
+     */
+    recoverPersonalSignSigner(message: string, signature: string): string;
+}
+//# sourceMappingURL=JoseCryptoAdapter.d.ts.map

package/dist/adapters/crypto/JoseCryptoAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoseCryptoAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/crypto/JoseCryptoAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,qBAAa,iBAAkB,YAAW,UAAU;IAC5C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkCpF,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAIpC;;;;;;OAMG;IACH,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAkCtE"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Adapters
+ * 환경별 Port 구현체
+ */
+export * from './storage/LocalStorageAdapter';
+export * from './crypto/JoseCryptoAdapter';
+export * from './transport/FetchTransportAdapter';
+export * from './oauth/BrowserOAuthAdapter';
+export * from './wallet/MockWalletProviderAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC"}

package/dist/adapters/oauth/BrowserOAuthAdapter.d.ts

@@ -0,0 +1,7 @@
+import { OAuthPort, OAuthConfig } from '../../core/ports';
+
+export declare class BrowserOAuthAdapter implements OAuthPort {
+    private static generateState;
+    openAuth(config: OAuthConfig): Promise<string>;
+}
+//# sourceMappingURL=BrowserOAuthAdapter.d.ts.map

package/dist/adapters/oauth/BrowserOAuthAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOAuthAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/oauth/BrowserOAuthAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/D,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,MAAM,CAAC,aAAa;IAM5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAkF/C"}

package/dist/adapters/storage/LocalStorageAdapter.d.ts

@@ -0,0 +1,10 @@
+import { StoragePort } from '../../core/ports';
+
+export declare class LocalStorageAdapter implements StoragePort {
+    private prefix;
+    set<T>(key: string, value: T): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=LocalStorageAdapter.d.ts.map

package/dist/adapters/storage/LocalStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/LocalStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,MAAM,CAAa;IAErB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAatC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}

package/dist/adapters/transport/FetchTransportAdapter.d.ts

@@ -0,0 +1,6 @@
+import { TransportPort, TransportRequest, TransportResponse } from '../../core/ports';
+
+export declare class FetchTransportAdapter implements TransportPort {
+    request<T = any>(request: TransportRequest): Promise<TransportResponse<T>>;
+}
+//# sourceMappingURL=FetchTransportAdapter.d.ts.map

package/dist/adapters/transport/FetchTransportAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchTransportAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/transport/FetchTransportAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI3F,qBAAa,qBAAsB,YAAW,aAAa;IACnD,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CA0BjF"}

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

@@ -0,0 +1,28 @@
+import { WalletProviderPort, WalletData, SignResponse } from '../../core/ports/WalletProviderPort';
+import { TransactionReceipt, AddressInfo, EvmTransactionRequest } from '../../core/types/chain';
+import { StoragePort } from '../../core/ports';
+import { PrepareAction, PrepareContext, PrepareResult } from '../../core/types/prepare';
+
+export declare class MockWalletProviderAdapter implements WalletProviderPort {
+    private storage;
+    constructor(storage: StoragePort);
+    getOrCreateWallet(userId: string): Promise<WalletData>;
+    getAddress(userId: string, index: number): Promise<AddressInfo>;
+    getBalance(_address: string, _chainId: string): Promise<string>;
+    getTransactionCount(_address: string, _chainId: string): Promise<number>;
+    getTransactionReceipt(_txHash: string, _chainId: string): Promise<TransactionReceipt | null>;
+    rpcRequest(method: string, _params: any[], _chainId: string): Promise<any>;
+    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>;
+    signTransaction(userId: string, chainId: string, tx: EvmTransactionRequest, index?: number, uuid?: string): Promise<SignResponse>;
+    sendTransaction(userId: string, chainId: string, tx: EvmTransactionRequest, uuid?: string): Promise<{
+        txHash: string;
+    }>;
+    withdraw(confirmation: string): Promise<void>;
+    recoverWallet(userId: string, shareC: string): Promise<WalletData>;
+    migrateWallet(pin: string, sub: string): Promise<WalletData>;
+    private generateMockEvmAddress;
+    private generateMockSignature;
+}
+//# sourceMappingURL=MockWalletProviderAdapter.d.ts.map

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

@@ -0,0 +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,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,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,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO/D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxE,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAI5F,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAK1E,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,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,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"}