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

package/README.md

@@ -1,85 +1,82 @@
 # @nexus-cross/crossx-sdk-core
 
-CROSSx Embedded Wallet SDK — Clean Architecture + Hexagonal Architecture 기반
+CROSSx Embedded Wallet SDK — Built on Clean Architecture + Hexagonal Architecture
 
-## 특징
+## Features
 
-- **EIP-1193 Provider**: ethers.js / viem / wagmi 와 바로 연동
-- **Clean Architecture**: 순수 비즈니스 로직과 구현 분리
-- **환경 독립적**: Web / Node / React Native 모두 지원 가능
-- **Port & Adapters**: 구현체를 교체해도 core 코드 변경 없음
-- **CAIP-2**: 표준 체인 ID 형식 (`eip155:612044`)
-- **트랜잭션 컨펌 모달**: 서명/전송 전 사용자 승인 필수 (우회 불가)
+- **EIP-1193 Provider**: Direct integration with ethers.js / viem / wagmi
+- **Clean Architecture**: Separation of pure business logic and implementation
+- **Environment Independent**: Supports Web / Node / React Native
+- **Port & Adapters**: Swap implementations without modifying core code
+- **CAIP-2**: Standard chain ID format (`eip155:612044`)
+- **Transaction Confirmation Modal**: User approval required before signing/sending (cannot be bypassed)
 
-## 설치
+## Installation
 
 ```bash
 npm install @nexus-cross/crossx-sdk-core
 ```
 
-## 빠른 시작
+## Quick Start
 
 ```ts
 import { createCROSSxSDK, ChainId } from '@nexus-cross/crossx-sdk-core';
 
 const sdk = createCROSSxSDK({
-  receiptPolling: { intervalMs: 2000, timeoutMs: 60000 }, // 선택
+  receiptPolling: { intervalMs: 2000, timeoutMs: 60000 }, // optional
 });
 
 await sdk.init();
 const result = await sdk.signIn();
-console.log('지갑 주소:', sdk.getAddress());
+console.log('Wallet address:', sdk.getAddress());
 ```
 
-> 백엔드 URL은 `.env`의 `VITE_*` 환경 변수로만 설정합니다.
-> `SDKConfig`에 URL 필드를 추가하거나 직접 전달하지 마세요.
+> Backend URLs are configured via `VITE_*` environment variables in `.env`.
+> Do not add URL fields to `SDKConfig` or pass them directly.
 
 ---
 
-## API 레퍼런스
+## API Reference
 
-### 초기화 & 인증
+### Initialization & Authentication
 
 ```ts
-// SDK 초기화 (자동 로그인 복구 포함)
+// Initialize SDK (includes automatic session restoration)
 await sdk.init();
 
-// 로그인 (OAuth popup)
+// Sign in (OAuth popup)
 const result = await sdk.signIn();
 const result = await sdk.signIn({ provider: 'google' });
 
-// 인증 상태 확인
+// Check authentication status
 sdk.isAuthenticated(); // boolean
 sdk.getAddress();      // string | null
 
-// 로그아웃
+// Sign out
 await sdk.signOut();
-
-// 계정 탈퇴
-await sdk.withdraw();
 ```
 
 ---
 
-### 지갑
+### Wallet
 
 ```ts
-// 지갑 생성 (로그인 후 지갑이 없을 때)
+// Create wallet (when no wallet exists after sign-in)
 const { address } = await sdk.createWallet();
 
-// 네이티브 잔액 조회
+// Get native balance
 const { wei, formatted } = await sdk.getBalance('eip155:612044');
 console.log(formatted); // "1.234567 CROSS"
 
-// 현재 nonce 조회
+// Get current nonce
 const nonce = await sdk.getNonce('eip155:612044');
 ```
 
 ---
 
-### 트랜잭션 컨펌 모달
+### Transaction Confirmation Modal
 
-`signTransaction()` / `sendTransaction()` / `sendTransactionAndWait()` 호출 시 SDK가 자동으로 사용자 승인 모달을 표시합니다. DApp 개발자가 우회할 수 있는 공개 API는 없습니다.
+When calling `signTransaction()` / `sendTransaction()` / `sendTransactionAndWait()`, the SDK automatically displays a user approval modal. There is no public API for DApp developers to bypass this.
 
 ```ts
 import { CROSSxError, ErrorCode } from '@nexus-cross/crossx-sdk-core';
@@ -88,16 +85,16 @@ try {
   const result = await sdk.signTransaction(ChainId.CROSS_TESTNET, tx);
 } catch (error) {
   if (error instanceof CROSSxError && error.code === ErrorCode.USER_REJECTED) {
-    console.log('사용자가 취소했습니다');
+    console.log('User cancelled the transaction');
   }
 }
 ```
 
-> 자세한 내용 → [트랜잭션 컨펌 모달 가이드](../../doc/transaction-confirmation.md)
+> For more details → [Transaction Confirmation Modal Guide](../../doc/transaction-confirmation.md)
 
 ---
 
-### 트랜잭션 서명 & 전송
+### Sign & Send Transactions
 
 ```ts
 const tx = {
@@ -112,29 +109,29 @@ const tx = {
   nonce:                await sdk.getNonce('eip155:612044'),
 };
 
-// 서명만
+// Sign only
 const { signedTx, txHash } = await sdk.signTransaction('eip155:612044', tx);
 
-// 전송 (status: 'pending' 즉시 반환)
+// Send (returns immediately with status: 'pending')
 const { txHash } = await sdk.sendTransaction('eip155:612044', tx);
 
-// 전송 + Receipt 폴링 (블록 포함까지 대기)
+// Send + Poll receipt (waits until included in block)
 const { txHash, receipt } = await sdk.sendTransactionAndWait('eip155:612044', tx);
 console.log(receipt.status); // '0x1' = success, '0x0' = reverted
 ```
 
 ---
 
-### Receipt 조회 & 폴링
+### Receipt Query & Polling
 
 ```ts
-// 단일 조회 (채굴 전이면 null)
+// Single query (returns null if not yet mined)
 const receipt = await sdk.getTransactionReceipt(txHash, 'eip155:612044');
 
-// 채굴될 때까지 폴링
+// Poll until mined
 const receipt = await sdk.waitForTransaction(txHash, 'eip155:612044');
 
-// 폴링 옵션 오버라이드
+// Override polling options
 const receipt = await sdk.waitForTransaction(txHash, 'eip155:612044', {
   intervalMs: 3000,
   timeoutMs:  120000,
@@ -145,7 +142,7 @@ const receipt = await sdk.waitForTransaction(txHash, 'eip155:612044', {
 
 ### EIP-1193 Provider
 
-ethers.js, viem, wagmi 등과 연동하기 위한 표준 Provider입니다.
+Standard Provider for integration with ethers.js, viem, wagmi, and more.
 
 ```ts
 const provider = sdk.getProvider('eip155:612044');
@@ -163,12 +160,12 @@ const client = createWalletClient({ transport: custom(provider) });
 
 ---
 
-### 범용 RPC 호출
+### Generic RPC Calls
 
-`/wallet/rpc` 엔드포인트를 통해 노드에 직접 JSON-RPC 요청을 보냅니다.
+Sends JSON-RPC requests directly to the node via the `/wallet/rpc` endpoint.
 
 ```ts
-// 네이티브 잔액
+// Native balance
 const balance = await sdk.rpcRequest('eth_getBalance', [address, 'latest'], 'eip155:612044');
 
 // eth_call — ERC-20 balanceOf
@@ -181,7 +178,7 @@ const raw = await sdk.rpcRequest(
 );
 console.log(BigInt(raw).toString());
 
-// Provider를 통한 동일 호출
+// Same call via Provider
 const result = await provider.request({
   method: 'eth_call',
   params: [{ to: contractAddress, data: '0x' + selector + padded }, 'latest'],
@@ -190,65 +187,114 @@ const result = await provider.request({
 
 ---
 
+## Gateway API Access Control (Project Whitelist)
+
+The Gateway API enforces whitelist verification so that only authorized projects can access it.
+Only combinations of **project + origin (web) or app ID (native)** registered in the management console are allowed. Unregistered requests are blocked.
+
+### Required Headers
+
+In addition to the existing `Authorization` header, the following headers must be included:
+
+| Header | Description | Required |
+|--------|------------|----------|
+| `X-Project-Id` | Project ID issued from the management console | **Always required** |
+| `Origin` | Request origin domain (automatically set by browser) | Required for web |
+| `X-App-Id` | bundle ID or package name | Required for native apps |
+| `X-App-Type` | `ios` / `android` / `windows` | Required when using `X-App-Id` |
+
+### Request Examples
+
+**Web request** (browser automatically includes `Origin`):
+
+```
+X-Project-Id: {project-id}
+Authorization: Bearer {token}
+```
+
+**Native app request**:
+
+```
+X-Project-Id: {project-id}
+X-App-Id: com.example.app
+X-App-Type: android
+Authorization: Bearer {token}
+```
+
+### Error Responses
+
+| Code | Description |
+|------|------------|
+| `-10022` | Unregistered project or origin/app |
+| `-10023` | Missing `X-Project-Id` header |
+| `-10024` | Missing `Origin` or `X-App-Id` header |
+| `-10025` | `X-App-Type` is not `android` / `ios` / `windows` |
+
+> The SDK automatically includes `SDKConfig.projectId` in the `X-Project-Id` header.
+> For web, the browser automatically sets the `Origin` header — no additional configuration needed.
+> For native apps, set `SDKConfig.appId` and `SDKConfig.appType` and the SDK will include the appropriate headers automatically.
+
+---
+
 ## SDKConfig
 
 ```ts
 const sdk = createCROSSxSDK({
-  /** OAuth 팝업 방식: 'popup' (기본) | 'modal' */
+  /** OAuth popup mode: 'popup' (default) | 'modal' */
   oauthDisplayMode: 'popup',
 
-  /** Mock 지갑 사용 여부 (개발/테스트용) */
+  /** Enable mock wallet (for development/testing) */
   useMockWallet: false,
 
-  /** 확인 모달 테마: 'light' (기본) | 'dark' */
+  /** Confirmation modal theme: 'light' (default) | 'dark' */
   theme: 'light',
 
   /**
-   * 확인 모달 색상 커스터마이징 (light / dark 모드별 독립 오버라이드)
+   * Confirmation modal color customization (independent overrides per light/dark mode)
    */
   themeTokens: {
     light: {
-      primary: '#FF6B35',  // 버튼·강조색 (기본: #019D92)
-      bg:      '#F5F0EB',  // 카드 배경색 (기본: #FFFFFF)
+      primary: '#FF6B35',  // Button & accent color (default: #019D92)
+      bg:      '#F5F0EB',  // Card background color (default: #FFFFFF)
     },
     dark: {
       primary: '#FF6B35',
-      bg:      '#1A0A00',  // 카드 배경색 (기본: #121212)
+      bg:      '#1A0A00',  // Card background color (default: #121212)
     },
   },
 
-  /** Receipt 폴링 기본값 */
+  /** Receipt polling defaults */
   receiptPolling: {
-    intervalMs: 2000,  // 폴링 간격 (ms)
-    timeoutMs: 60000,  // 최대 대기 시간 (ms)
+    intervalMs: 2000,  // Polling interval (ms)
+    timeoutMs: 60000,  // Maximum wait time (ms)
   },
 
   /**
-   * 디버그 로그 출력 여부 (기본: true)
-   * ⚠️ 프로덕션 빌드에서는 이 값과 관계없이 항상 비활성화됩니다.
+   * Enable debug log output (default: true)
+   * ⚠️ Always disabled in production builds regardless of this value.
    */
   debug: true,
 });
 ```
 
-### 확인 모달 테마
+### Confirmation Modal Theme
 
-| 방법 | 설명 |
+| Method | Description |
 |---|---|
-| `config.theme` | 초기 테마 설정 (`'light'` 기본) |
-| `sdk.setTheme('dark')` | 런타임 테마 전환 (`themeTokens` 오버라이드 유지) |
-| `config.themeTokens.light.*` | 라이트 모드 Semantic 토큰 오버라이드 |
-| `config.themeTokens.dark.*` | 다크 모드 Semantic 토큰 오버라이드 |
+| `config.theme` | Initial theme setting (`'light'` by default) |
+| `sdk.setTheme('dark')` | Runtime theme switching (preserves `themeTokens` overrides) |
+| `config.themeTokens.light.*` | Light mode semantic token overrides |
+| `config.themeTokens.dark.*` | Dark mode semantic token overrides |
 
-오버라이드 가능한 토큰: `primary` · `secondary` · `onPrimary` · `borderDefault` · `borderSubtle` · `textPrimary` · `textSecondary` · `textTertiary` · `surfaceDefault` · `bg`
+Available override tokens: `primary` · `secondary` · `onPrimary` · `borderDefault` · `borderSubtle` · `textPrimary` · `textSecondary` · `textTertiary` · `surfaceDefault` · `bg`
 
-자세한 내용은 [컨펌 모달 & Prepare 플로우](../../doc/transaction-confirmation.md#색상-커스터마이징-themetokens)를 참고하세요.
+For details, see [Confirmation Modal & Prepare Flow](../../doc/transaction-confirmation.md#색상-커스터마이징-themetokens).
 
 ---
 
-## 체인 ID 상수
+## Chain ID Constants
 
-오타 방지를 위해 `ChainId` 상수를 사용하세요.
+Use `ChainId` constants to prevent typos.
 
 ```ts
 import { ChainId } from '@nexus-cross/crossx-sdk-core';
@@ -259,28 +305,28 @@ await sdk.getBalance(ChainId.CROSS_MAINNET);  // 'eip155:612055'
 
 ---
 
-## 환경 변수
+## Environment Variables
 
-| 변수명 | 용도 | 필수 |
+| Variable | Purpose | Required |
 |---|---|---|
 | `VITE_WALLET_GATEWAY_URL` | Wallet Gateway API URL | ✅ |
-| `VITE_OAUTH_SERVICE_URL` | OAuth 서비스 URL | ✅ |
-| `VITE_AUTH_API_URL` | 인증 API URL | ✅ |
+| `VITE_OAUTH_SERVICE_URL` | OAuth Service URL | ✅ |
+| `VITE_AUTH_API_URL` | Auth API URL | ✅ |
 
 ---
 
-## 공개 타입
+## Public Types
 
 ```ts
 import type {
   SDKConfig,
-  ConfirmationTokenOverride,   // themeTokens 타입 (light/dark 모드별 오버라이드)
-  ConfirmationThemeTokens,     // 단일 모드 Semantic 토큰 타입
+  ConfirmationTokenOverride,   // themeTokens type (per light/dark mode overrides)
+  ConfirmationThemeTokens,     // Single mode semantic token type
   AuthResult,
   EvmTransactionRequest,
   TransactionResult,
-  TransactionWithReceipt,      // sendTransactionAndWait() 반환 타입
-  TransactionReceipt,          // waitForTransaction() 반환 타입
+  TransactionWithReceipt,      // sendTransactionAndWait() return type
+  TransactionReceipt,          // waitForTransaction() return type
   SignTransactionResult,
   ChainIdValue,
 } from '@nexus-cross/crossx-sdk-core';
@@ -288,15 +334,15 @@ import type {
 
 ---
 
-## 관련 문서
+## Related Documentation
 
-- [트랜잭션 컨펌 모달](../../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)
+- [Transaction Confirmation Modal](../../doc/transaction-confirmation.md)
+- [Ethereum Provider Guide](../../doc/ethereum-provider.md)
+- [Environment Variables](../../doc/environment-variables.md)
+- [CAIP-2 Chain ID Guide](../../doc/caip-integration.md)
+- [wagmi Integration Guide](../../doc/wagmi-integration.md)
+- [Architecture](../../doc/architecture.md)
 
-## 라이센스
+## License
 
 MIT

package/dist/__tests__/adapters/IndexedDBStorageAdapter.test.d.ts

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IndexedDBStorageAdapter.test.d.ts.map

package/dist/__tests__/adapters/IndexedDBStorageAdapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBStorageAdapter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/adapters/IndexedDBStorageAdapter.test.ts"],"names":[],"mappings":"AACA,OAAO,qBAAqB,CAAC"}

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

@@ -0,0 +1,9 @@
+import { ChainRegistryPort } from '../../core/ports/ChainRegistryPort';
+import { ChainInfo } from '../../core/types/chain';
+
+export declare const MOCK_CHAIN_INFO: ChainInfo;
+export declare class MockChainRegistryPort implements ChainRegistryPort {
+    getChains: import('vitest').Mock<() => Promise<ChainInfo[]>>;
+    getChain: import('vitest').Mock<(_chainId: string) => Promise<ChainInfo>>;
+}
+//# sourceMappingURL=MockChainRegistryPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MockChainRegistryPort.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/MockChainRegistryPort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,eAAO,MAAM,eAAe,EAAE,SAG7B,CAAC;AAEF,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,SAAS,8BAAmB,OAAO,CAAC,SAAS,EAAE,CAAC,EAAuB;IACvE,QAAQ,mCAA0B,MAAM,KAAG,OAAO,CAAC,SAAS,CAAC,EAAqB;CACnF"}

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

@@ -2,13 +2,18 @@ import { TransportPort, TransportRequest, TransportResponse } from '../../core/p
 
 /**
  * vi.fn() 기반 TransportPort mock.
- * request 메서드의 반환값을 테스트마다 mockResolvedValueOnce 로 제어하세요.
  *
- * @example
- * const transport = new MockTransportPort();
- * transport.request.mockResolvedValueOnce({ status: 200, data: { access_token: 'abc' }, headers: {} });
+ * RPC URL(testnet.crosstoken.io)로의 요청은 rpcResults 큐에서
+ * JSON-RPC 형식으로 응답합니다.
+ * 그 외 요청은 authResponse 또는 기본값을 반환합니다.
  */
 export declare class MockTransportPort implements TransportPort {
-    request: import('vitest').Mock<(_req: TransportRequest) => Promise<TransportResponse>>;
+    private rpcResults;
+    private authResponse;
+    request: import('vitest').Mock<(req: TransportRequest) => Promise<TransportResponse>>;
+    /** RPC 호출의 result 값을 큐에 추가 (FIFO) */
+    pushRpcResult(result: any): void;
+    /** 인증 API 등 비RPC 요청의 기본 응답 설정 */
+    setAuthResponse(response: TransportResponse): void;
 }
 //# sourceMappingURL=MockTransportPort.d.ts.map

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

@@ -1 +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"}
+{"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;AAI3F;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,YAAY,CAA6D;IAEjF,OAAO,8BAAqB,gBAAgB,KAAG,OAAO,CAAC,iBAAiB,CAAC,EAYtE;IAEH,qCAAqC;IACrC,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAIhC,iCAAiC;IACjC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;CAGnD"}

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

@@ -1,11 +1,10 @@
 import { WalletProviderPort, WalletData, SignResponse } from '../../core/ports';
-import { AddressInfo, TransactionReceipt } from '../../core/types/chain';
+import { AddressInfo } 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 되어 있어 호출 여부/인수 검증이 가능합니다.
@@ -14,15 +13,11 @@ 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>>;
+    signTypedData: import('vitest').Mock<(_userId: string, _chainId: string, _typedData: unknown, _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 };
+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,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"}
+{"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,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"}

package/dist/adapters/chain/RemoteChainRegistryAdapter.d.ts

@@ -0,0 +1,29 @@
+import { ChainRegistryPort } from '../../core/ports/ChainRegistryPort';
+import { TransportPort } from '../../core/ports/TransportPort';
+import { ChainInfo } from '../../core/types/chain';
+
+export interface ChainRegistryAdapterConfig {
+    gatewayUrl: string;
+    projectId: string;
+}
+export declare class RemoteChainRegistryAdapter implements ChainRegistryPort {
+    private readonly baseUrl;
+    private readonly projectId;
+    private readonly transport;
+    private cache;
+    private loadedAt;
+    private usingFallback;
+    constructor(config: ChainRegistryAdapterConfig, transport: TransportPort);
+    getChains(): Promise<ChainInfo[]>;
+    getChain(chainId: string): Promise<ChainInfo>;
+    /** 캐시를 무효화하여 다음 호출 시 Gateway에서 재조회합니다. */
+    invalidateCache(): void;
+    private isCacheValid;
+    private populateCache;
+    private request;
+    private handleEnvelopeError;
+    private fallbackOrThrow;
+    private static fallbackChains;
+    private static mapErrorCode;
+}
+//# sourceMappingURL=RemoteChainRegistryAdapter.d.ts.map

package/dist/adapters/chain/RemoteChainRegistryAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteChainRegistryAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/chain/RemoteChainRegistryAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKxD,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,qBAAa,0BAA2B,YAAW,iBAAiB;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAE1C,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,0BAA0B,EAAE,SAAS,EAAE,aAAa;IAMlE,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAuBjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQnD,0CAA0C;IAC1C,eAAe,IAAI,IAAI;IAMvB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;YASP,OAAO;IAWrB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,MAAM,CAAC,cAAc;IAO7B,OAAO,CAAC,MAAM,CAAC,YAAY;CAkB5B"}

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

@@ -1,4 +1,4 @@
-import { ConfirmationPort, ConfirmationDetails, TransactionCompleteDetails } from '../../core/ports/ConfirmationPort';
+import { ConfirmationPort, ConfirmationDetails, TransactionCompleteDetails, TransactionPendingDetails } from '../../core/ports/ConfirmationPort';
 import { SDKThemeTokens } from '../../core/types';
 
 export type ConfirmationTheme = 'light' | 'dark';
@@ -31,6 +31,11 @@ export declare class BrowserConfirmationAdapter implements ConfirmationPort {
      * "Done" 버튼 클릭, 닫기 버튼 클릭, 배경 클릭, Escape 키로 닫힙니다.
      */
     showTransactionComplete(details: TransactionCompleteDetails): Promise<void>;
+    /**
+     * 트랜잭션 전송 직후 "대기 중" 모달을 표시하고,
+     * receiptPromise가 resolve되면 결과(성공/실패/타임아웃)로 전환합니다.
+     */
+    showTransactionProgress(pending: TransactionPendingDetails, receiptPromise: Promise<TransactionCompleteDetails>): Promise<void>;
     requestConfirmation(details: ConfirmationDetails): Promise<boolean>;
 }
 //# sourceMappingURL=BrowserConfirmationAdapter.d.ts.map

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,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"}
+{"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;AAEvD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AA8sDjD,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;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"}

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

@@ -1 +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"}
+{"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;CA8G/C"}

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

@@ -0,0 +1,25 @@
+import { StoragePort } from '../../core/ports';
+
+export declare class IndexedDBStorageAdapter implements StoragePort {
+    private db;
+    private cryptoKey;
+    private initPromise;
+    private ensureReady;
+    private openDB;
+    private idbGet;
+    private idbPut;
+    private idbDelete;
+    private idbClear;
+    private init;
+    private encrypt;
+    private decrypt;
+    set<T>(key: string, value: T): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    /**
+     * IndexedDB + Web Crypto 사용 가능 여부 확인
+     */
+    static isAvailable(): boolean;
+}
+//# sourceMappingURL=IndexedDBStorageAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/IndexedDBStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAepD,qBAAa,uBAAwB,YAAW,WAAW;IACzD,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,WAAW,CAA8B;YAEnC,WAAW;IAQzB,OAAO,CAAC,MAAM;IAiBd,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,QAAQ;YASF,IAAI;YAiBJ,OAAO;YAYP,OAAO;IAUf,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5C,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;IAUlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;CAK9B"}

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

@@ -1 +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"}
+{"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;CAiCjF"}

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

@@ -1,6 +1,6 @@
 import { WalletProviderPort, WalletData, SignResponse } from '../../core/ports/WalletProviderPort';
-import { TransactionReceipt, AddressInfo, EvmTransactionRequest } from '../../core/types/chain';
 import { StoragePort } from '../../core/ports';
+import { AddressInfo, EvmTransactionRequest } from '../../core/types/chain';
 import { PrepareAction, PrepareContext, PrepareResult } from '../../core/types/prepare';
 
 export declare class MockWalletProviderAdapter implements WalletProviderPort {
@@ -8,10 +8,6 @@ export declare class MockWalletProviderAdapter implements WalletProviderPort {
     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>;
@@ -19,7 +15,6 @@ export declare class MockWalletProviderAdapter implements WalletProviderPort {
     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;