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

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

@@ -0,0 +1,47 @@
+import { WalletProviderPort, 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, TransactionReceipt } from '../../core/types/chain';
+import { PrepareAction, PrepareContext, PrepareResult } from '../../core/types/prepare';
+
+export interface RemoteWalletProviderConfig {
+    gatewayUrl: string;
+    projectId: string;
+    appId?: string;
+    appType?: 'ios' | 'android';
+}
+export declare class RemoteWalletProviderAdapter implements WalletProviderPort {
+    private readonly baseUrl;
+    private readonly projectId;
+    private readonly appId?;
+    private readonly appType?;
+    private readonly storage;
+    private readonly transport;
+    private readonly tokenStore;
+    constructor(config: RemoteWalletProviderConfig, storage: StoragePort, transport: TransportPort, tokenStore: TokenMemoryStore);
+    private getAuthToken;
+    private request;
+    getOrCreateWallet(userId: string): Promise<WalletData>;
+    getAddress(userId: string, index: number): Promise<AddressInfo>;
+    private isAddressNotFoundError;
+    private rpcCall;
+    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>;
+    private buildUnsignedTx;
+    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 static mapGatewayError;
+    private static getGatewayErrorMessage;
+}
+//# sourceMappingURL=RemoteWalletProviderAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,112 @@
+/**
+ * Embedded Wallet Gateway API Types
+ * Based on Swagger documentation
+ */
+export interface UnsignedTx {
+    chainId?: string;
+    from?: string;
+    to?: string;
+    value?: string;
+    data?: string;
+    nonce?: string;
+    gasLimit?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+}
+export interface SignTxReq {
+    unsignedTx: UnsignedTx;
+    uuid?: string;
+}
+export interface SendTxReq {
+    unsignedTx: UnsignedTx;
+    uuid?: string;
+}
+export interface SignMessageReq {
+    message: string;
+    from?: string;
+    uuid?: string;
+}
+export interface GatewaySignMessageResp {
+    signature: string;
+}
+export interface SignTypedDataReq {
+    typedData: unknown;
+    from?: string;
+    uuid?: string;
+}
+export interface GatewaySignTypedDataResp {
+    signature: string;
+}
+export interface CreateWalletReq {
+    ignoreBackup: boolean;
+}
+export interface RecoverWalletReq {
+    shareC: string;
+}
+export interface MigrateWalletReq {
+    pin: string;
+    sub: string;
+}
+export interface MigrateWalletResp {
+    address: string;
+    shareC: string;
+}
+export interface WithdrawWalletReq {
+    confirmation: string;
+}
+export interface WithdrawWalletResp {
+    success: boolean;
+}
+export interface JsonRpcRequest {
+    jsonrpc: string;
+    method: string;
+    params?: any[];
+    id?: any;
+}
+export interface CreateWalletResp {
+    address: string;
+    shareC: string;
+}
+export interface GetAddressResp {
+    address: string;
+    index: number;
+}
+export interface AddressInfo {
+    address: string;
+    index: number;
+}
+export interface GetAddressesResp {
+    addresses: AddressInfo[];
+}
+export interface GatewaySignTxResp {
+    signedTx: string;
+    txHash: string;
+}
+export interface GatewaySendTxResp {
+    txHash: string;
+}
+export interface RecoverWalletResp {
+    address: string;
+    newShareC: string;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+}
+export interface JsonRpcResponse {
+    jsonrpc: string;
+    id?: any;
+    result?: any;
+    error?: JsonRpcError;
+}
+export type PrepareActionApi = 'sign' | 'sign-typed-data' | 'sign-message' | 'send';
+export interface PrepareReq {
+    action: PrepareActionApi;
+    params: Record<string, unknown>;
+}
+export interface PrepareResp {
+    uuid: string;
+    expiresAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core Layer
+ * 순수 비즈니스 로직 (환경 독립적)
+ */
+export * from './types';
+export * from './types/errors';
+export * from './ports';
+export * from './usecases';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * ConfirmationPort
+ * 서명/전송 전 사용자 승인을 요청하는 포트
+ */
+/** 모든 컨펌 상세에 공통으로 포함되는 UI 메타 필드 */
+interface ConfirmationUIMeta {
+    /** 컨펌 모달에 표시될 요청 앱 이름 (예: 'My DApp') */
+    dappName?: string;
+    /** 컨펌 모달에 표시될 계정 이름 (예: 'Account 1') */
+    accountName?: string;
+}
+export interface TransactionConfirmationDetails extends ConfirmationUIMeta {
+    type: 'sign' | 'send';
+    chainId: string;
+    from?: string;
+    to?: string;
+    /** hex 형식 (예: "0x0") */
+    value?: string;
+    /** hex 형식의 calldata */
+    data?: string;
+    /** hex 형식 */
+    gasLimit?: string;
+    /** hex 형식 — Legacy 트랜잭션 가스 가격 (wei) */
+    gasPrice?: string;
+    /** hex 형식 — EIP-1559 최대 가스 가격 (wei) */
+    maxFeePerGas?: string;
+    /** hex 형식 — EIP-1559 최대 우선순위 가스 가격 (wei) */
+    maxPriorityFeePerGas?: string;
+    /** 네이티브 토큰 심볼 (예: 'ETH', 'POL') — wallet/rpc eth_chainId 기반 취득 */
+    nativeSymbol?: string;
+    /** 네이티브 토큰 소수점 자리수 (예: 18) — wallet/rpc eth_chainId 기반 취득 */
+    nativeDecimals?: number;
+}
+export interface MessageConfirmationDetails extends ConfirmationUIMeta {
+    type: 'sign-message';
+    chainId: string;
+    from?: string;
+    /** 서명 대상 메시지 (raw 문자열 또는 hex) */
+    message: string;
+}
+export interface TypedDataConfirmationDetails extends ConfirmationUIMeta {
+    type: 'sign-typed-data';
+    chainId: string;
+    from?: string;
+    /** EIP-712 typed data (파싱된 객체 또는 JSON 문자열) */
+    typedData: unknown;
+}
+export type ConfirmationDetails = TransactionConfirmationDetails | MessageConfirmationDetails | TypedDataConfirmationDetails;
+export interface TransactionCompleteDetails {
+    /** CAIP-2 체인 ID (예: 'eip155:612055') */
+    chainId: string;
+    /** 트랜잭션 해시 */
+    txHash: string;
+    /** 전송 금액 표시 문자열 (예: '0.5 ETH') — 없으면 미표시 */
+    amount?: string;
+    /** 받는 주소 */
+    to?: string;
+    /** 네이티브 토큰 심볼 (예: 'ETH') */
+    nativeSymbol?: string;
+}
+export interface ConfirmationPort {
+    /**
+     * 사용자에게 서명/전송 승인을 요청합니다.
+     * @returns 사용자가 확인하면 true, 거부하면 false
+     */
+    requestConfirmation(details: ConfirmationDetails): Promise<boolean>;
+    /**
+     * 트랜잭션 전송 완료 팝업을 표시합니다.
+     * 사용자가 닫기 버튼을 누르거나 외부를 클릭하면 resolve됩니다.
+     */
+    showTransactionComplete(details: TransactionCompleteDetails): Promise<void>;
+}
+export {};
+//# sourceMappingURL=ConfirmationPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmationPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/ConfirmationPort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AACnC,UAAU,kBAAkB;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,8BAA+B,SAAQ,kBAAkB;IACxE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA6B,SAAQ,kBAAkB;IACtE,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B,8BAA8B,GAC9B,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,MAAM,WAAW,0BAA0B;IACzC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpE;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E"}

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

@@ -0,0 +1,43 @@
+import { JWTPayload } from '../types';
+
+/**
+ * JWT 검증 옵션
+ */
+export interface JWTVerifyOptions {
+}
+/**
+ * JWT 검증 결과
+ */
+export interface JWTVerifyResult {
+    payload: JWTPayload;
+    valid: boolean;
+    /** JWT 서명이 JWKS 등으로 실제 검증되었는지 여부 (false = 디코딩만 수행) */
+    signatureVerified: boolean;
+}
+/**
+ * Crypto Port
+ */
+export interface CryptoPort {
+    /**
+     * JWT 검증
+     * @param token JWT 토큰
+     * @param options 검증 옵션 (현재 사용하지 않음)
+     * @returns 검증 결과
+     */
+    verifyJWT(token: string, options?: JWTVerifyOptions): Promise<JWTVerifyResult>;
+    /**
+     * JWT 디코딩 (검증 없이)
+     * @param token JWT 토큰
+     * @returns 페이로드
+     */
+    decodeJWT(token: string): JWTPayload;
+    /**
+     * EIP-191 personal_sign 서명에서 서명자 주소를 복원 (ecrecover)
+     *
+     * @param message  서명된 원본 메시지 (UTF-8 문자열)
+     * @param signature  65-byte ECDSA 서명 (hex, 0x 프리픽스 허용)
+     * @returns 체크섬 없는 소문자 Ethereum 주소 (0x...)
+     */
+    recoverPersonalSignSigner?(message: string, signature: string): string;
+}
+//# sourceMappingURL=CryptoPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CryptoPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/CryptoPort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,gBAAgB;CAGhC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE/E;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAErC;;;;;;OAMG;IACH,yBAAyB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACxE"}

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

@@ -0,0 +1,23 @@
+/**
+ * Logger Port
+ * 커스텀 로깅 핸들러 추상화 인터페이스
+ *
+ * SDK 내부 로그를 앱의 로깅 시스템으로 라우팅하려면
+ * 이 인터페이스를 구현한 객체를 SDKConfig.logger에 전달하세요.
+ *
+ * @example
+ * // SDKConfig.logger에 주입
+ * const sdk = createCROSSxSDK({
+ *   logger: {
+ *     log: (...args) => myAppLogger.debug(...args),
+ *     warn: (...args) => myAppLogger.warn(...args),
+ *     error: (...args) => myAppLogger.error(...args),
+ *   },
+ * });
+ */
+export interface LoggerPort {
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+//# sourceMappingURL=LoggerPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/LoggerPort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC"}

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

@@ -0,0 +1,18 @@
+/**
+ * OAuth Port
+ * OAuth 인증 프로세스 추상화 인터페이스
+ */
+export interface OAuthPort {
+    /**
+     * OAuth 로그인 창 열기
+     * postMessage로 Firebase 토큰을 수신하면 resolve합니다.
+     */
+    openAuth(config: OAuthConfig): Promise<string>;
+}
+export interface OAuthConfig {
+    authUrl: string;
+    expectedOrigin: string;
+    width?: number;
+    height?: number;
+}
+//# sourceMappingURL=OAuthPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OAuthPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/OAuthPort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,25 @@
+/**
+ * Storage Port
+ * 저장소 추상화 인터페이스
+ *
+ * 구현체는 localStorage, IndexedDB, AsyncStorage 등이 될 수 있음
+ */
+export interface StoragePort {
+    /**
+     * 데이터 저장
+     */
+    set<T>(key: string, value: T): Promise<void>;
+    /**
+     * 데이터 로드
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * 데이터 삭제
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * 모든 데이터 삭제
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=StoragePort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StoragePort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/StoragePort.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

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

@@ -0,0 +1,24 @@
+/**
+ * Transport Port
+ * HTTP 통신 추상화 인터페이스
+ */
+export interface TransportRequest {
+    url: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: any;
+    /** 요청 타임아웃 (ms). 기본값은 어댑터 구현에 따라 다름. */
+    timeoutMs?: number;
+}
+export interface TransportResponse<T = any> {
+    status: number;
+    data: T;
+    headers: Record<string, string>;
+}
+export interface TransportPort {
+    /**
+     * HTTP 요청 실행
+     */
+    request<T = any>(request: TransportRequest): Promise<TransportResponse<T>>;
+}
+//# sourceMappingURL=TransportPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransportPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/TransportPort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,GAAG;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5E"}

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

@@ -0,0 +1,106 @@
+import { AddressInfo, EvmTransactionRequest, TransactionReceipt } from '../types/chain';
+import { PrepareAction, PrepareContext, PrepareResult } from '../types/prepare';
+
+export interface WalletProviderPort {
+    /**
+     * 지갑 생성 또는 로드
+     */
+    getOrCreateWallet(userId: string): Promise<WalletData>;
+    /**
+     * 특정 인덱스의 주소 조회
+     */
+    getAddress(userId: string, index: number): Promise<AddressInfo>;
+    /**
+     * 서명/전송 전 사전 확인 단계 (Prepare)
+     * 트랜잭션 파라미터를 서버에 제출하여 UUID를 발급받습니다.
+     * 이후 sign/send 호출 시 해당 UUID를 함께 전달해야 합니다.
+     */
+    prepare?(action: PrepareAction, context: PrepareContext): Promise<PrepareResult>;
+    /**
+     * 메시지 서명 (EIP-191)
+     * @param chainId CAIP-2 체인 ID (예: 'eip155:612055')
+     * @param uuid prepare 단계에서 발급받은 UUID
+     */
+    signMessage(userId: string, chainId: string, message: string, index?: number, uuid?: string, from?: string): Promise<SignResponse>;
+    /**
+     * EIP-712 Typed Data 서명 — /mnemonic/sign-typed-data
+     * @param chainId CAIP-2 체인 ID (예: 'eip155:612055')
+     * @param uuid prepare 단계에서 발급받은 UUID
+     */
+    signTypedData?(userId: string, chainId: string, typedData: unknown, index?: number, uuid?: string, from?: string): Promise<SignResponse>;
+    /**
+     * 트랜잭션 서명 (전송 없음) — /mnemonic/sign
+     * @param chainId CAIP-2 체인 ID (예: 'eip155:612055')
+     * @param uuid prepare 단계에서 발급받은 UUID
+     */
+    signTransaction(userId: string, chainId: string, tx: EvmTransactionRequest, index?: number, uuid?: string): Promise<SignResponse>;
+    /**
+     * 트랜잭션 서명 및 전송 — /mnemonic/send
+     * @param chainId CAIP-2 체인 ID (예: 'eip155:612055')
+     * @param uuid prepare 단계에서 발급받은 UUID
+     */
+    sendTransaction?(userId: string, chainId: string, tx: EvmTransactionRequest, uuid?: string): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * 잔액 조회 — /wallet/rpc (eth_getBalance)
+     * @returns hex wei 문자열 (예: '0x38d7ea4c68000')
+     */
+    getBalance?(address: string, chainId: string): Promise<string>;
+    /**
+     * 현재 nonce 조회 — /wallet/rpc (eth_getTransactionCount)
+     * @returns pending 상태 기준 nonce (숫자)
+     */
+    getTransactionCount?(address: string, chainId: string): Promise<number>;
+    /**
+     * 트랜잭션 Receipt 조회 — /wallet/rpc (eth_getTransactionReceipt)
+     * @returns Receipt 또는 null (아직 채굴 안 됨)
+     */
+    getTransactionReceipt?(txHash: string, chainId: string): Promise<TransactionReceipt | null>;
+    /**
+     * 범용 JSON-RPC 요청 — /wallet/rpc 프록시
+     * eth_call, eth_getBalance 등 읽기 전용 메서드에 사용
+     */
+    rpcRequest?(method: string, params: any[], chainId: string): Promise<any>;
+    /**
+     * Share-C로 지갑 복구 (선택적)
+     */
+    recoverWallet?(userId: string, shareC: string): Promise<WalletData>;
+    /**
+     * CROSSx 지갑 → Embedded Wallet 마이그레이션
+     * 클라우드 백업에서 복구하여 새 Embedded Wallet로 전환
+     *
+     * @param pin 4자리 PIN (클라우드 백업 복호화용)
+     * @param sub 사용자 식별자 (OAuth sub)
+     */
+    migrateWallet?(pin: string, sub: string): Promise<WalletData>;
+    /**
+     * 계정 탈퇴 — /mnemonic/withdraw
+     * 게이트웨이의 Redis/DB 캐시 삭제 후 cross-auth withdraw API 호출
+     */
+    withdraw?(confirmation: string): Promise<void>;
+}
+/**
+ * 지갑 데이터
+ */
+export interface WalletData {
+    id: string;
+    address: string;
+    derivationPath: string;
+    createdAt: number;
+    newShareC?: string;
+}
+/**
+ * 서명 응답
+ */
+export interface SignResponse {
+    /** CAIP-2 체인 ID */
+    chainId: string;
+    /** 서명값 (메시지 서명: 서명 hex, 트랜잭션 서명: signedTx hex) */
+    signature: string;
+    format: 'hex' | 'base64' | 'der';
+    /** 트랜잭션 서명 시 서버가 반환하는 txHash (선택) */
+    txHash?: string;
+    publicKey?: string;
+}
+//# sourceMappingURL=WalletProviderPort.d.ts.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Ports (Interfaces)
+ * Core의 모든 외부 의존성 인터페이스
+ */
+export * from './StoragePort';
+export * from './TransportPort';
+export * from './CryptoPort';
+export * from './WalletProviderPort';
+export * from './OAuthPort';
+export * from './ConfirmationPort';
+export * from './LoggerPort';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ports/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/core/services/TokenMemoryStore.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TokenMemoryStore
+ *
+ * access_token을 메모리에만 보관하는 인메모리 저장소.
+ * localStorage에 기록하지 않으므로 XSS로 탈취될 수 없다.
+ *
+ * 페이지 새로고침 시 토큰은 소멸하며, refresh_token(localStorage)을
+ * 통해 silentRefresh로 재발급받는다.
+ */
+export declare class TokenMemoryStore {
+    private _accessToken;
+    set(token: string): void;
+    get(): string | null;
+    clear(): void;
+    has(): boolean;
+}
+//# sourceMappingURL=TokenMemoryStore.d.ts.map

package/dist/core/services/TokenMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenMemoryStore.d.ts","sourceRoot":"","sources":["../../../src/core/services/TokenMemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAuB;IAE3C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxB,GAAG,IAAI,MAAM,GAAG,IAAI;IAIpB,KAAK,IAAI,IAAI;IAIb,GAAG,IAAI,OAAO;CAGf"}