@nexus-cross/crossx-sdk-core 2.1.3 → 2.2.0-beta.10

package/dist/core/types/rn-bridge.d.ts

@@ -0,0 +1,267 @@
+/**
+ * RN Native Bridge Types (Internal)
+ * Native WebView bridge API contract
+ */
+/**
+ * Native bridge RPC envelope
+ */
+export interface RpcRequest {
+    kind: 'crossx.rpc.req';
+    rpcId: string;
+    method: string;
+    params: unknown;
+    timeoutMs: number;
+}
+export interface RpcResponse<T = unknown> {
+    kind: 'crossx.rpc.res';
+    rpcId: string;
+    ok: boolean;
+    result?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Handshake RPC
+ */
+export interface HandshakePayload {
+    version: 1;
+    appId: string;
+    appVersion: string;
+    sdkVersion: string;
+    keyId: string;
+    userIdHash: string;
+    nonce: string;
+    timestamp: number;
+    hmac: string;
+}
+export interface HandshakeResult {
+    activated: true;
+    sdkVersion: string;
+    protocolVersion: number;
+    absoluteTtlMs: number;
+    idleTtlMs: number;
+    /** Native wallet의 active address (예: 0x1234...abcd) */
+    walletAddress?: string;
+}
+/**
+ * Firebase ID Token RPC
+ */
+export interface NativeFirebaseIdTokenResult {
+    idToken: string;
+    provider?: 'google' | 'apple' | string;
+    providerSub?: string;
+    expiresAt: number;
+}
+/**
+ * User Confirmation RPC
+ */
+export interface RequestUserConfirmationParams {
+    operation: 'signMessage' | 'signTypedData' | 'signTransaction' | 'sendTransaction';
+    payload: unknown;
+    dappOrigin: string;
+    chainId?: string | number;
+}
+export interface UserConfirmationResult {
+    approved: true;
+}
+export type UserConfirmationRejected = {
+    approved: false;
+    reason?: string;
+};
+/**
+ * Wallet Selection RPC
+ */
+export interface WalletSelectionOptions {
+    reason?: 'user_action' | 'network_mismatch' | 'dapp_request';
+    chainId?: string | number;
+    requiredAddress?: string;
+}
+export interface WalletSelectionResult {
+    approved: true;
+    walletId: string;
+    address: string;
+    chainId?: string | number;
+}
+/**
+ * §12 native sign delegation RPCs
+ *
+ * Native CROSSx SDK 의 자체 PIN UI + 서명 로직을 사용하여 wallet 작업을 수행한다.
+ * JS SDK 측에서는 PIN orchestrator / RemoteWalletProvider 를 거치지 않고 native bridge
+ * RPC 로 직접 라우팅한다 (RNBridgeWalletProviderAdapter).
+ */
+export interface BridgeSignMessageParams {
+    chainId: string;
+    message: string;
+    from?: string;
+    dappName?: string;
+    accountName?: string;
+    index?: number;
+}
+export interface BridgeSignMessageResult {
+    signature: string;
+}
+export interface BridgeSignTypedDataParams {
+    chainId: string;
+    /** EIP-712 typed data (parsed object 또는 JSON 문자열) */
+    typedData: unknown;
+    from?: string;
+    dappName?: string;
+    accountName?: string;
+    index?: number;
+}
+export interface BridgeSignTypedDataResult {
+    signature: string;
+}
+export interface BridgeTransactionPayload {
+    to?: string;
+    value?: string;
+    data?: string;
+    gasLimit?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    nonce?: string | number;
+}
+export interface BridgeSignTransactionParams {
+    chainId: string;
+    tx: BridgeTransactionPayload;
+    from?: string;
+    dappName?: string;
+    accountName?: string;
+    index?: number;
+}
+export interface BridgeSignTransactionResult {
+    /** RLP-encoded signed transaction (hex) */
+    signedTx: string;
+}
+export interface BridgeSendTransactionParams {
+    chainId: string;
+    tx: BridgeTransactionPayload;
+    from?: string;
+    dappName?: string;
+    accountName?: string;
+    index?: number;
+}
+export interface BridgeSendTransactionResult {
+    txHash: string;
+}
+/**
+ * §12 native sign delegation — full sendTransaction + receipt polling on native side.
+ * Native CROSSx SDK 가 sign UI / PIN UI / broadcast / receipt 폴링 + (자체 결과 UI 가 있다면 그것)
+ * 까지 통합 처리. JS SDK 는 receipt 결과만 받아 dapp 에 전달.
+ */
+export interface BridgeSendTransactionWithReceiptParams {
+    chainId: string;
+    tx: BridgeTransactionPayload;
+    from?: string;
+    dappName?: string;
+    accountName?: string;
+    index?: number;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+export interface BridgeSendTransactionWithReceiptResult {
+    txHash: string;
+    blockHash?: string;
+    blockNumber?: string;
+    from?: string;
+    to?: string;
+    gasUsed?: string;
+    effectiveGasPrice?: string;
+    /** "0x1" = success, "0x0" = reverted */
+    status?: string;
+}
+/**
+ * Wallet Selector RPC — Native UI 로 활성 지갑 변경
+ * (design 17 §13.6 의 requestWalletSelection 의 §12 native UI 구현)
+ */
+export interface BridgeShowWalletSelectorParams {
+    reason?: 'user_action' | 'network_mismatch' | 'dapp_request';
+    chainId?: string | number;
+    requiredAddress?: string;
+}
+export interface BridgeShowWalletSelectorResult {
+    approved: true;
+    address: string;
+    index: number;
+    name?: string;
+    chainId?: string | number;
+}
+/**
+ * Bridge interface exposed to WebView
+ */
+export interface RNBridge {
+    isInstalled: boolean;
+    /**
+     * Handshake to activate bridge
+     */
+    handshake(payload: HandshakePayload): Promise<HandshakeResult>;
+    /**
+     * Request fresh Firebase ID token (initial login)
+     */
+    requestFirebaseIdToken(): Promise<NativeFirebaseIdTokenResult>;
+    /**
+     * Request fresh Firebase ID token (refresh after expiry)
+     */
+    requestFreshFirebaseIdToken(): Promise<NativeFirebaseIdTokenResult>;
+    /**
+     * Request user confirmation for signing/transaction
+     */
+    requestUserConfirmation(params: RequestUserConfirmationParams): Promise<UserConfirmationResult | UserConfirmationRejected>;
+    /**
+     * Request wallet selection
+     */
+    requestWalletSelection(options: WalletSelectionOptions): Promise<WalletSelectionResult>;
+    /**
+     * §12 — Native sign delegation. Native CROSSx SDK 가 자체 PIN UI + 서명 처리.
+     */
+    signMessage(params: BridgeSignMessageParams): Promise<BridgeSignMessageResult>;
+    signTypedData(params: BridgeSignTypedDataParams): Promise<BridgeSignTypedDataResult>;
+    signTransaction(params: BridgeSignTransactionParams): Promise<BridgeSignTransactionResult>;
+    sendTransaction(params: BridgeSendTransactionParams): Promise<BridgeSendTransactionResult>;
+    sendTransactionWithWaitForReceipt(params: BridgeSendTransactionWithReceiptParams): Promise<BridgeSendTransactionWithReceiptResult>;
+    /**
+     * §13.6 — Native wallet selector UI. Native 가 활성 지갑 선택 UI 표시 + 결과 반환.
+     */
+    showWalletSelector(params?: BridgeShowWalletSelectorParams): Promise<BridgeShowWalletSelectorResult>;
+    /**
+     * Sign out from native
+     */
+    signOut(): Promise<void>;
+    /**
+     * §13.6.4 [v0.5.7] — Native push event channel.
+     * 네이티브 측이 임의의 시점에 dispatch 하는 이벤트를 SDK 가 listen 한다.
+     * 같은 event 에 대해 한 SDK 인스턴스당 하나의 listener 만 등록한다 (재등록 시 덮어쓰기).
+     */
+    onEvent?(event: 'walletChanged', handler: (payload: BridgeWalletChangedEvent) => void): void;
+}
+/**
+ * §13.6.4 [v0.5.7] — Native-initiated wallet change push event payload.
+ */
+export interface BridgeWalletChangedEvent {
+    walletId: string;
+    /** checksummed EVM address */
+    address: string;
+    /** CAIP-2 (예: 'eip155:612055'), 누락 가능 */
+    chainId?: string;
+    source: 'rn-native-bridge';
+    /** 진입점 정보 (audit / 디버그용) */
+    reason?: 'native-selector' | 'native-add-account' | 'native-remove-account' | 'rn-bridge-rpc';
+    /** Native 가 표시하는 wallet label (예: 'Account 1'). UI 노출용. */
+    walletName?: string;
+}
+/**
+ * Bridge bootstrap context
+ */
+export interface RNBridgeBootstrapContext {
+    isActivated: boolean;
+    absoluteTtlMs: number;
+    idleTtlMs: number;
+    protocolVersion: number;
+    activatedAt: number;
+    /** Native wallet의 active address (handshake 응답에서 전달) */
+    walletAddress?: string;
+}
+//# sourceMappingURL=rn-bridge.d.ts.map

package/dist/core/types/rn-bridge.d.ts.map

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

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

@@ -0,0 +1,74 @@
+/**
+ * Token History Types
+ * v2 token-historical API 관련 타입 정의
+ */
+/**
+ * Token History 항목 (GET /v2/token-historical 응답)
+ *
+ * v1 /v1/public/token/historical과 유사하지만:
+ * - log_index, removed 필드 제거
+ * - 코인 표현: 모든 체인에서 0x0...0 (통일)
+ */
+export interface TokenHistoryItem {
+    /** 트랜잭션 해시 */
+    tx: string;
+    /** 체인 ID (숫자) */
+    chain_id: number;
+    /** 블록 번호 */
+    block_number: number;
+    /** 트랜잭션 인덱스 */
+    tx_index: number;
+    /** 발신자 주소 */
+    from: string;
+    /** 발신자 별칭 (있는 경우) */
+    from_alias?: string;
+    /** 수신자 주소 */
+    to: string;
+    /** 수신자 별칭 (있는 경우) */
+    to_alias?: string;
+    /** 토큰 주소 (코인은 모든 체인에서 0x0...0) */
+    token: string;
+    /** 전송량 (wei/smallest unit) */
+    amount: string;
+    /** 타임스탬프 (unix timestamp, 초 단위) */
+    timestamp: number;
+    /** 트랜잭션 상태 ("success" | "fail") */
+    status: string;
+    /** Gas price (wei) */
+    gas_price?: number;
+    /** Gas used */
+    gas_used?: number;
+    /** Max fee per gas (EIP-1559) */
+    max_fee_per_gas?: number;
+    /** Transaction nonce */
+    nonce?: number;
+    /** Method ID (as byte array, nullable) */
+    method?: number[] | null;
+    /** Method 별칭 (있는 경우) */
+    method_alias?: string;
+}
+/**
+ * GET /v2/token-historical 응답의 커서 정보
+ */
+export interface TokenHistoryCursor {
+    /** 다음 조회 시작 타임스탬프 */
+    last_timestamp?: number;
+    /** 다음 조회 시작 tx_index */
+    last_tx_index?: number;
+}
+/**
+ * GET /v2/token-historical 응답
+ */
+export interface GetTokenHistoryResponse {
+    rows: TokenHistoryItem[];
+    /** 페이지네이션 커서 */
+    last_data?: TokenHistoryCursor;
+}
+/**
+ * POST /v2/token-historical 요청 body
+ */
+export interface RegisterTokenHistoryRequest {
+    /** 클라이언트 버전 (필수, 최대 64자) */
+    clientVersion: string;
+}
+//# sourceMappingURL=tokenHistory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenHistory.d.ts","sourceRoot":"","sources":["../../../src/core/types/tokenHistory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,gBAAgB;IAChB,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/core/usecases/SignInUseCase.d.ts

@@ -2,6 +2,7 @@ import { StoragePort, CryptoPort, OAuthPort, TransportPort, WalletProviderPort }
 import { AuthResult, SignInOptions } from '../types';
 import { InternalSDKConfig } from '../types/internal';
 import { TokenMemoryStore } from '../services/TokenMemoryStore';
+import { SDKLocale } from '../i18n';
 
 export declare class SignInUseCase {
     private config;
@@ -11,6 +12,9 @@ export declare class SignInUseCase {
     private transport;
     private walletProvider;
     private tokenStore;
+    /** RN Bridge fresh token request callback — optional */
+    private requestFreshTokenFromBridge?;
+    private getLocale;
     private _refreshPromise;
     private _migrated;
     /** /social/refresh/simple 에러 코드 중 재로그인 필요 (토큰 무효) */
@@ -18,8 +22,39 @@ export declare class SignInUseCase {
     private readonly STORAGE_KEY_ACCESS_TOKEN;
     private readonly STORAGE_KEY_REFRESH_TOKEN;
     private readonly STORAGE_KEY_USER;
-    constructor(config: InternalSDKConfig, storage: StoragePort, crypto: CryptoPort, oauth: OAuthPort, transport: TransportPort, walletProvider: WalletProviderPort, tokenStore: TokenMemoryStore);
+    constructor(config: InternalSDKConfig, storage: StoragePort, crypto: CryptoPort, oauth: OAuthPort, transport: TransportPort, walletProvider: WalletProviderPort, tokenStore: TokenMemoryStore, 
+    /** RN Bridge fresh token request callback — optional */
+    requestFreshTokenFromBridge?: (() => Promise<{
+        idToken: string;
+        expiresAt: number;
+    }>) | undefined, getLocale?: () => SDKLocale | undefined);
     private get useCookieAuth();
+    /**
+     * RN Bridge fresh token request callback 설정
+     * factory에서 SDK 생성 후 호출됨
+     */
+    setFreshTokenCallback(callback: () => Promise<{
+        idToken: string;
+        expiresAt: number;
+    }>): void;
+    /**
+     * 저장된 access_token의 유효성을 빠르게 확인합니다.
+     * (만료 여부만 체크 — 서명 검증은 restoreSession에서 수행)
+     *
+     * RN Bridge 자동 로그인 시도 전에 호출하여,
+     * 이미 발급된 토큰이 있으면 confirm 다이얼로그를 다시 띄우지 않게 합니다.
+     */
+    hasValidStoredAccessToken(): Promise<boolean>;
+    /**
+     * 저장된 세션이 RN Bridge 자동 로그인으로 만들어진 것인지 판별합니다.
+     *
+     * RN Bridge 모드는 design 상 access_token 만 저장하고 refresh_token 은 저장하지 않습니다.
+     * 따라서 (valid access_token 존재) + (refresh_token 부재) 조합이면 RN Bridge 세션입니다.
+     * OAuth 모드는 access_token + refresh_token 둘 다 저장하므로 false 가 됩니다.
+     *
+     * 이 정보는 native sign delegation 활성화 여부 결정에 사용됩니다 (CROSSxSDK._isAuthenticatedViaRNBridge).
+     */
+    hasStoredRNBridgeSession(): Promise<boolean>;
     /**
      * 서버 응답에서 에러 코드를 추출합니다.
      * 이중 래핑 구조: { code: 200, data: { code: 1001, message: "..." } }
@@ -43,6 +78,32 @@ export declare class SignInUseCase {
      * @param firebaseToken OAuth 서비스에서 발급받은 Firebase JWT
      */
     executeWithOAuthToken(firebaseToken: string): Promise<AuthResult>;
+    /**
+     * RN Native Bridge에서 수신한 Firebase ID token으로 로그인
+     *
+     * Native에서 Firebase SDK force refresh로 발급받은 fresh token을
+     * auth API에서 CROSSx access_token으로 교환합니다.
+     *
+     * RN Bridge 모드:
+     * - access_token은 TokenMemoryStore에만 저장 (localStorage 금지)
+     * - refresh_token은 저장하지 않음
+     * - X-Project-Id 헤더 추가 (Origin + Project 검증용)
+     *
+     * @param nativeToken Native에서 받은 Firebase ID token 정보
+     */
+    executeWithNativeFirebaseIdToken(nativeToken: {
+        idToken: string;
+        expiresAt: number;
+        provider?: string;
+        providerSub?: string;
+    }): Promise<AuthResult>;
+    /**
+     * RN Native Firebase token 처리 (bridge 모드 전용)
+     *
+     * Access token은 memory store에만 저장하고,
+     * refresh token은 저장하지 않습니다.
+     */
+    private processNativeFirebaseToken;
     /**
      * Firebase 토큰 → CROSSx 인증 교환 → 사용자 정보 추출 → 토큰 저장 → 지갑 로드.
      * execute()와 executeWithOAuthToken()에서 공유합니다.
@@ -50,6 +111,12 @@ export declare class SignInUseCase {
      * @param oauthEmail OAuth 콜백에서 직접 수신한 email (JWT에 없을 때 fallback)
      */
     private processFirebaseToken;
+    /**
+     * RN Native Firebase token 교환
+     * X-Project-Id 헤더를 포함하여 origin + project 검증
+     * refresh_token은 응답에 포함되어도 저장하지 않음
+     */
+    private exchangeNativeFirebaseToken;
     /**
      * Firebase 토큰 → CROSSx 인증 교환
      * cookie 모드: POST /social/login/cookie → JWT는 HttpOnly Set-Cookie, body는 성공 메시지

package/dist/core/usecases/SignInUseCase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SignInUseCase.d.ts","sourceRoot":"","sources":["../../../src/core/usecases/SignInUseCase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACtG,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG1D,OAAO,KAAK,EACV,iBAAiB,EAIlB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMrE,qBAAa,aAAa;IAYtB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAjBpB,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,SAAS,CAAS;IAE1B,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAyB;IAEtE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAGhC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,kBAAkB,EAClC,UAAU,EAAE,gBAAgB;IAQtC,OAAO,KAAK,aAAa,GAExB;IAED;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAUpB,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA+C3D;;;;;;;;OAQG;IACG,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKvE;;;;;OAKG;YACW,oBAAoB;IAgGlC;;;;OAIG;YACW,qBAAqB;IAkDnC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,WAAW;IAInB;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAyElD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAAqB;IAE9C,OAAO,CAAC,aAAa;YAUP,gBAAgB;IA8D9B;;;;;;;OAOG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IA6B5C;;;;;;;;OAQG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAmErF;;;OAGG;YACW,kBAAkB;YAwBlB,UAAU;CA4DzB"}
+{"version":3,"file":"SignInUseCase.d.ts","sourceRoot":"","sources":["../../../src/core/usecases/SignInUseCase.ts"],"names":[],"mappings":"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"}