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

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

@@ -0,0 +1,119 @@
+/**
+ * CAIP (Chain Agnostic Improvement Proposals) Types
+ * 블록체인 업계 표준 형식 지원
+ *
+ * @see https://github.com/ChainAgnostic/CAIPs
+ */
+/**
+ * CAIP-2: Chain ID Specification
+ * 형식: {namespace}:{reference}
+ *
+ * @example
+ * - eip155:1 (Ethereum Mainnet)
+ * - eip155:137 (Polygon)
+ * - solana:mainnet (Solana Mainnet)
+ * - bip122:000000000019 (Bitcoin Mainnet)
+ * - cosmos:cosmoshub-4 (Cosmos Hub)
+ */
+export interface ChainId {
+    namespace: string;
+    reference: string;
+}
+/**
+ * CAIP-10: Account ID Specification
+ * 형식: {chain_id}:{account_address}
+ *
+ * @example
+ * - eip155:1:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
+ * - solana:mainnet:7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
+ */
+export interface AccountId {
+    chainId: ChainId;
+    address: string;
+}
+/**
+ * CAIP-19: Asset Type Specification
+ * 형식: {chain_id}/{asset_namespace}:{asset_reference}
+ *
+ * @example
+ * - eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f (DAI)
+ * - eip155:1/erc721:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D (BAYC)
+ * - solana:mainnet/spl:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC)
+ */
+export interface AssetType {
+    chainId: ChainId;
+    assetNamespace: string;
+    assetReference: string;
+}
+/**
+ * 네임스페이스 레지스트리
+ */
+export declare const CHAIN_NAMESPACES: {
+    readonly EIP155: "eip155";
+    readonly SOLANA: "solana";
+    readonly BIP122: "bip122";
+    readonly COSMOS: "cosmos";
+};
+/**
+ * Asset 네임스페이스
+ */
+export declare const ASSET_NAMESPACES: {
+    readonly SLIP44: "slip44";
+    readonly ERC20: "erc20";
+    readonly ERC721: "erc721";
+    readonly ERC1155: "erc1155";
+    readonly SPL: "spl";
+    readonly BRC20: "brc20";
+};
+/**
+ * CAIP-2 형식으로 ChainId를 문자열로 변환
+ */
+export declare function formatChainId(chainId: ChainId): string;
+/**
+ * CAIP-2 문자열을 ChainId 객체로 파싱
+ */
+export declare function parseChainId(caipChainId: string): ChainId;
+/**
+ * CAIP-10 형식으로 AccountId를 문자열로 변환
+ */
+export declare function formatAccountId(accountId: AccountId): string;
+/**
+ * CAIP-10 문자열을 AccountId 객체로 파싱
+ */
+export declare function parseAccountId(caipAccountId: string): AccountId;
+/**
+ * CAIP-19 형식으로 AssetType을 문자열로 변환
+ */
+export declare function formatAssetType(assetType: AssetType): string;
+/**
+ * CAIP-19 문자열을 AssetType 객체로 파싱
+ */
+export declare function parseAssetType(caipAssetType: string): AssetType;
+/**
+ * CAIP-10 Account ID 유효성 검증
+ */
+export declare function validateAccountId(accountId: string): boolean;
+/**
+ * CAIP-2 Chain ID 유효성 검증
+ */
+export declare function validateChainId(chainId: string): boolean;
+/**
+ * Legacy ChainType에서 CAIP ChainId 생성
+ */
+export declare function legacyToChainId(chainType: 'ethereum' | 'solana' | 'bitcoin' | 'cosmos', networkConfig: any): ChainId;
+/**
+ * CAIP ChainId에서 Legacy ChainType 추출 (string도 지원)
+ */
+export declare function chainIdToLegacy(chainId: ChainId | string): 'ethereum' | 'solana' | 'bitcoin' | 'cosmos' | null;
+/**
+ * CAIP-2 또는 Legacy 형식을 정규화된 CAIP-2 문자열로 변환
+ * @example
+ * normalizeChainId('ethereum') // 'eip155:1'
+ * normalizeChainId('eip155:137') // 'eip155:137'
+ */
+export declare function normalizeChainId(chainId: string): string;
+/**
+ * ChainId 문자열이 Legacy 형식인지 확인
+ */
+export declare function isLegacyChainId(chainId: string): boolean;
+//# sourceMappingURL=caip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.ts","sourceRoot":"","sources":["../../../src/core/types/caip.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAMX;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAQzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAW/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAkB/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAgC5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAYxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,EACvD,aAAa,EAAE,GAAG,GACjB,OAAO,CA0BT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAe9G;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD"}

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

@@ -0,0 +1,90 @@
+/**
+ * Chain Types
+ * CAIP-2 기반 체인 타입 정의
+ *
+ * SDK는 체인을 직접 관리하지 않습니다.
+ * 서명·전송 시 호출자가 CAIP-2 chainId를 직접 전달합니다.
+ *
+ * 권장 사용법:
+ *   import { ChainId } from '@nexus-cross/crossx-sdk-core';
+ *   sdk.signMessage(ChainId.CROSS_MAINNET, message);
+ */
+/**
+ * 지원 체인 CAIP-2 상수
+ *
+ * string 리터럴 유니온 타입으로 추론되므로
+ * 메서드 파라미터 타입(string)과 완전히 호환됩니다.
+ */
+export declare const ChainId: {
+    readonly CROSS_MAINNET: "eip155:612055";
+    readonly CROSS_TESTNET: "eip155:612044";
+    readonly ETHEREUM_MAINNET: "eip155:1";
+    readonly ETHEREUM_SEPOLIA: "eip155:11155111";
+    readonly ETHEREUM_HOLESKY: "eip155:17000";
+    readonly POLYGON_MAINNET: "eip155:137";
+    readonly POLYGON_AMOY: "eip155:80002";
+    readonly BSC_MAINNET: "eip155:56";
+    readonly BSC_TESTNET: "eip155:97";
+    readonly ARBITRUM_ONE: "eip155:42161";
+    readonly ARBITRUM_SEPOLIA: "eip155:421614";
+    readonly OPTIMISM_MAINNET: "eip155:10";
+    readonly OPTIMISM_SEPOLIA: "eip155:11155420";
+    readonly BASE_MAINNET: "eip155:8453";
+    readonly BASE_SEPOLIA: "eip155:84532";
+};
+/**
+ * ChainId 값 타입 (string 서브타입)
+ * 메서드 파라미터에서 string으로 받으므로 별도 타입 캐스팅 불필요
+ */
+export type ChainIdValue = (typeof ChainId)[keyof typeof ChainId];
+/**
+ * 주소 정보
+ */
+export interface AddressInfo {
+    address: string;
+    derivationPath: string;
+    publicKey?: string;
+}
+/**
+ * EVM 트랜잭션 요청
+ * chainId 필드는 CAIP-2의 reference 부분 (숫자)
+ * 예: eip155:612055 → chainId: 612055
+ */
+export interface EvmTransactionRequest {
+    from: string;
+    to: string;
+    value?: string;
+    data?: string;
+    gasLimit?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    nonce?: number;
+    chainId?: number;
+}
+/**
+ * 트랜잭션 전송 결과 (SDK Public API)
+ */
+export interface SendTxResp {
+    /** CAIP-2 체인 ID (예: 'eip155:612055') */
+    chainId: string;
+    txHash: string;
+    status: 'pending' | 'success' | 'failed';
+}
+/**
+ * 트랜잭션 Receipt (eth_getTransactionReceipt 응답)
+ */
+export interface TransactionReceipt {
+    transactionHash: string;
+    blockHash: string;
+    blockNumber: string;
+    from: string;
+    to: string | null;
+    gasUsed: string;
+    effectiveGasPrice: string;
+    status: '0x1' | '0x0';
+    logs: any[];
+    transactionIndex: string;
+    type: string;
+}
+//# sourceMappingURL=chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../../src/core/types/chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;CA6BV,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd"}

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

@@ -0,0 +1,56 @@
+/**
+ * Domain Error Codes
+ */
+export declare enum ErrorCode {
+    AUTH_NOT_INITIALIZED = "AUTH_NOT_INITIALIZED",
+    AUTH_FAILED = "AUTH_FAILED",
+    AUTH_TOKEN_INVALID = "AUTH_TOKEN_INVALID",
+    AUTH_TOKEN_EXPIRED = "AUTH_TOKEN_EXPIRED",
+    AUTH_NOT_AUTHENTICATED = "AUTH_NOT_AUTHENTICATED",
+    WALLET_NOT_FOUND = "WALLET_NOT_FOUND",
+    WALLET_CREATION_FAILED = "WALLET_CREATION_FAILED",
+    SIGN_FAILED = "SIGN_FAILED",
+    SIGN_REJECTED = "SIGN_REJECTED",
+    TX_FAILED = "TX_FAILED",
+    TX_REJECTED = "TX_REJECTED",
+    USER_REJECTED = "USER_REJECTED",
+    TX_INVALID_PARAMS = "TX_INVALID_PARAMS",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    NETWORK_NOT_CONFIGURED = "NETWORK_NOT_CONFIGURED",
+    INVALID_CHAIN = "INVALID_CHAIN",
+    CHAIN_NOT_SUPPORTED = "CHAIN_NOT_SUPPORTED",
+    CHAIN_ADAPTER_NOT_FOUND = "CHAIN_ADAPTER_NOT_FOUND",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    SIGNATURE_FAILED = "SIGNATURE_FAILED",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    PREPARE_FAILED = "PREPARE_FAILED",
+    PREPARE_EXPIRED = "PREPARE_EXPIRED",
+    PREPARE_MISMATCH = "PREPARE_MISMATCH",
+    MIGRATION_FAILED = "MIGRATION_FAILED",
+    MIGRATION_BACKUP_EXISTS = "MIGRATION_BACKUP_EXISTS",
+    GATEWAY_INTERNAL_ERROR = "GATEWAY_INTERNAL_ERROR",// -10006: 내부 통신 실패, 재시도 권장
+    GATEWAY_LOCK_CONFLICT = "GATEWAY_LOCK_CONFLICT",// -10008: 락 충돌(동시 요청), 재시도 권장
+    PROJECT_ID_MISSING = "PROJECT_ID_MISSING",// -10023: X-Project-Id 헤더 누락
+    ORIGIN_OR_APP_ID_MISSING = "ORIGIN_OR_APP_ID_MISSING",// -10024: Origin 또는 X-App-Id 누락
+    INVALID_APP_TYPE = "INVALID_APP_TYPE",// -10025: X-App-Type이 android/ios가 아님
+    PROJECT_NOT_REGISTERED = "PROJECT_NOT_REGISTERED",// -10022: 미등록 프로젝트 또는 origin/app
+    /** Gateway 서명 ecrecover 불일치 — 서명자 주소가 기대 주소와 다름 */
+    SIGNATURE_SIGNER_MISMATCH = "SIGNATURE_SIGNER_MISMATCH",
+    INVALID_CONFIG = "INVALID_CONFIG",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Domain Error
+ */
+export declare class CROSSxError extends Error {
+    code: ErrorCode;
+    details?: any | undefined;
+    constructor(code: ErrorCode, message: string, details?: any | undefined);
+    toJSON(): {
+        name: string;
+        code: ErrorCode;
+        message: string;
+        details: any;
+    };
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,SAAS;IAEnB,oBAAoB,yBAAyB;IAC7C,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;IAGjD,gBAAgB,qBAAqB;IACrC,sBAAsB,2BAA2B;IAGjD,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAG/B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAG3B,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IAGvC,aAAa,kBAAkB;IAC/B,sBAAsB,2BAA2B;IAGjD,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;IAC3C,uBAAuB,4BAA4B;IAGnD,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IAGzC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IAGrC,gBAAgB,qBAAqB;IACrC,uBAAuB,4BAA4B;IAGnD,sBAAsB,2BAA2B,CAAI,2BAA2B;IAChF,qBAAqB,0BAA0B,CAAM,8BAA8B;IAGnF,kBAAkB,uBAAuB,CAAY,6BAA6B;IAClF,wBAAwB,6BAA6B,CAAE,gCAAgC;IACvF,gBAAgB,qBAAqB,CAAgB,sCAAsC;IAC3F,sBAAsB,2BAA2B,CAAI,iCAAiC;IAEtF,mDAAmD;IACnD,yBAAyB,8BAA8B;IAGvD,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAE3B,IAAI,EAAE,SAAS;IAEf,OAAO,CAAC,EAAE,GAAG;gBAFb,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,GAAG,YAAA;IAOtB,MAAM;;;;;;CAQP"}

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

@@ -0,0 +1,309 @@
+/**
+ * Domain Types
+ * 순수 도메인 타입 정의 (환경 독립적)
+ */
+export * from './chain';
+export * from './prepare';
+/**
+ * 인증 결과
+ */
+export interface AuthResult {
+    success: boolean;
+    /** 로그인 후 로드된 EVM 주소 */
+    address?: string;
+    user?: UserInfo;
+    error?: string;
+    /** 기존 CROSSx 백업이 발견되어 마이그레이션이 필요한 상태 */
+    needsMigration?: boolean;
+    /**
+     * access_token JWT 서명이 실제 검증(JWKS 등)되었는지 여부.
+     * false인 경우, user 정보(id, email 등)는 디코딩만 수행된 미검증 데이터입니다.
+     * 백엔드 JWKS 엔드포인트 구현 전까지는 항상 false입니다.
+     */
+    tokenSignatureVerified?: boolean;
+}
+/**
+ * 로그인 옵션
+ */
+export interface SignInOptions {
+    provider?: 'google' | 'apple';
+}
+/**
+ * 서명/트랜잭션 공통 옵션
+ */
+export interface SignOptions {
+    /** 주소 인덱스 (기본값: 0) */
+    index?: number;
+    /**
+     * 컨펌 모달에 표시될 요청 앱 이름
+     * @example 'My DApp'
+     */
+    dappName?: string;
+    /**
+     * 컨펌 모달에 표시될 계정 이름
+     * @example 'Account 1'
+     */
+    accountName?: string;
+}
+/**
+ * 사용자 정보 (내부 도메인 타입)
+ */
+export interface UserInfo {
+    id: string;
+    email?: string;
+    [key: string]: any;
+}
+/**
+ * 공개 사용자 정보 (SDK Public API)
+ *
+ * getUserInfo() 의 반환 타입.
+ * Android SDK의 SDKUserInfo와 동일한 필드를 제공합니다.
+ */
+export interface SDKUserInfo {
+    /** 사용자 식별자 (JWT sub) */
+    id: string;
+    /** 이메일 (있는 경우) */
+    email?: string;
+    /** 로그인 프로바이더 ('google' | 'apple') */
+    loginType?: string;
+    /** 사용자의 지갑 주소 목록 */
+    addresses: string[];
+    /**
+     * JWT 서명이 실제 검증(JWKS 등)되었는지 여부.
+     * false인 경우, id·email 등은 디코딩만 수행된 미검증 데이터입니다.
+     */
+    tokenSignatureVerified: boolean;
+}
+/**
+ * 메시지 서명 결과 (SDK Public API)
+ */
+export interface SignMessageResp {
+    /** CAIP-2 체인 ID (예: 'eip155:612055') */
+    chainId: string;
+    signature: string;
+    message: string;
+    address: string;
+}
+/**
+ * 트랜잭션 서명 결과 (SDK Public API)
+ * /mnemonic/sign 엔드포인트 응답에 대응
+ */
+export interface SignTxResp {
+    /** CAIP-2 체인 ID (예: 'eip155:612055') */
+    chainId: string;
+    /** RLP 인코딩된 서명 트랜잭션 hex */
+    signedTx: string;
+    /** 서명된 트랜잭션의 hash */
+    txHash: string;
+}
+/**
+ * EIP-712 Typed Data 서명 결과 (SDK Public API)
+ */
+export interface SignTypedDataResp {
+    /** CAIP-2 체인 ID (예: 'eip155:612055') */
+    chainId: string;
+    signature: string;
+    address: string;
+}
+/**
+ * 마이그레이션 결과 (SDK Public API)
+ * CROSSx 지갑 → Embedded Wallet 전환 결과
+ */
+export interface MigrateResult {
+    address: string;
+}
+/**
+ * JWT 페이로드
+ */
+export interface JWTPayload {
+    sub: string;
+    exp: number;
+    iat?: number;
+    iss?: string;
+    aud?: string;
+    email?: string;
+    [key: string]: any;
+}
+/**
+ * SDK 공개 설정 (SDK 사용자에게 노출되는 옵션)
+ *
+ * ─── URL 필드 부재에 대하여 ────────────────────────────────────────────────
+ * 백엔드 엔드포인트(OAuth, Auth, Wallet Gateway, Storage)는
+ * 이 인터페이스에 의도적으로 포함되어 있지 않습니다.
+ *
+ * 이유: 일반 사용자가 엔드포인트를 바꾸는 것을 허용하지 않기 위해서입니다.
+ *       엔드포인트 변경은 내부 개발자가 환경 변수(VITE_*)를 통해서만 가능합니다.
+ *       (자세한 내용은 factory.ts 상단 주석 참고)
+ *
+ * ❌ URL 관련 필드를 이 인터페이스에 추가하지 마세요.
+ * ──────────────────────────────────────────────────────────────────────────
+ */
+/**
+ * 피그마 디자인 시스템 Semantic 컬러 토큰 (단일 모드용)
+ *
+ * 지정하지 않은 항목은 해당 theme의 기본값을 유지합니다.
+ * `SDKThemeTokens.light` / `.dark` 에 각각 전달합니다.
+ */
+export interface SDKColorOverrides {
+    /**
+     * Semantic: Primary — 버튼 배경·강조색
+     * @default '#019D92'
+     */
+    primary?: string;
+    /**
+     * Semantic: Secondary — 에러·경고색 (PIN 오류 등)
+     * @default '#E70077'
+     */
+    secondary?: string;
+    /**
+     * Semantic: OnPrimary — Primary 위 텍스트·아이콘
+     * @default '#FFFFFF'
+     */
+    onPrimary?: string;
+    /**
+     * Semantic: Border/Default — 카드 외곽 테두리
+     * @default light: 'rgba(18,18,18,0.05)' / dark: 'rgba(255,255,255,0.05)'
+     */
+    borderDefault?: string;
+    /**
+     * Semantic: Border/Subtle — 구분선·입력창 테두리
+     * @default light: 'rgba(18,18,18,0.1)' / dark: 'rgba(255,255,255,0.1)'
+     */
+    borderSubtle?: string;
+    /**
+     * Semantic: TextIcon/Primary — 제목·주요 텍스트
+     * @default light: '#121212' / dark: '#FFFFFF'
+     */
+    textIconPrimary?: string;
+    /**
+     * Semantic: TextIcon/Secondary — 부제목·보조 텍스트
+     * @default light: 'rgba(18,18,18,0.7)' / dark: 'rgba(255,255,255,0.7)'
+     */
+    textIconSecondary?: string;
+    /**
+     * Semantic: TextIcon/Tertiary — 힌트·비활성 텍스트·아이콘
+     * @default light: 'rgba(18,18,18,0.5)' / dark: 'rgba(255,255,255,0.5)'
+     */
+    textIconTertiary?: string;
+    /**
+     * Semantic: Surface/default — pill·hover 등 인라인 강조 배경
+     * @default light: 'rgba(18,18,18,0.05)' / dark: 'rgba(255,255,255,0.05)'
+     */
+    surfaceDefault?: string;
+    /**
+     * Semantic: Surface/BG — 모달 카드 배경
+     * @default light: '#FFFFFF' / dark: '#121212'
+     */
+    bg?: string;
+}
+/**
+ * 컨펌 모달 색상 토큰 오버라이드
+ *
+ * `light` / `dark` 각 모드를 독립적으로 커스터마이징할 수 있습니다.
+ * 지정하지 않은 항목은 해당 모드의 기본값을 유지합니다.
+ *
+ * @example
+ * // 라이트·다크 모두 동일한 브랜드 컬러 적용
+ * themeTokens: {
+ *   light: { primary: '#FF6B35', bg: '#F5F0EB' },
+ *   dark:  { primary: '#FF6B35', bg: '#1A0A00' },
+ * }
+ *
+ * @example
+ * // 라이트 모드만 커스터마이징
+ * themeTokens: { light: { primary: '#FF6B35' } }
+ */
+export interface SDKThemeTokens {
+    light?: SDKColorOverrides;
+    dark?: SDKColorOverrides;
+}
+export interface SDKConfig {
+    /**
+     * 프로젝트 ID (필수)
+     *
+     * 관리 콘솔에서 발급받은 프로젝트 식별자.
+     * Gateway API 화이트리스트 검증에 사용되며, 모든 요청에 `X-Project-Id` 헤더로 포함됩니다.
+     *
+     * @example '6ef9a259932d5e77cb1751e9dfcbe031'
+     */
+    projectId: string;
+    /**
+     * 네이티브 앱 식별자 (네이티브 환경 전용)
+     *
+     * iOS bundle ID 또는 Android package name.
+     * 웹 환경에서는 브라우저가 `Origin` 헤더를 자동으로 포함하므로 불필요합니다.
+     * 설정 시 `appType`도 함께 지정해야 합니다.
+     *
+     * @example 'com.example.myapp'
+     */
+    appId?: string;
+    /**
+     * 네이티브 앱 플랫폼 타입 (`appId` 사용 시 필수)
+     */
+    appType?: 'ios' | 'android';
+    /**
+     * Mock Wallet Provider 사용 여부 (개발/테스트용)
+     */
+    useMockWallet?: boolean;
+    /**
+     * 커스텀 로거
+     *
+     * SDK 내부 로그를 앱의 로깅 시스템으로 라우팅합니다.
+     * 주입된 로거는 빌드 모드(dev/prod)와 무관하게 항상 호출됩니다.
+     *
+     * @example
+     * logger: {
+     *   log: (...args) => console.log('[MyApp]', ...args),
+     *   warn: (...args) => console.warn('[MyApp]', ...args),
+     *   error: (...args) => console.error('[MyApp]', ...args),
+     * }
+     */
+    logger?: import('../ports/LoggerPort').LoggerPort;
+    /**
+     * 컨펌 모달 테마
+     * - 'light': 밝은 테마 (기본값)
+     * - 'dark': 어두운 테마
+     */
+    theme?: 'light' | 'dark';
+    /**
+     * 컨펌 모달 색상 커스터마이징
+     * light / dark 모드를 각각 오버라이드할 수 있습니다.
+     * 지정하지 않은 항목은 해당 모드의 기본값을 유지합니다.
+     *
+     * @example
+     * themeTokens: {
+     *   light: { primary: '#FF6B35', bg: '#F5F0EB' },
+     *   dark:  { primary: '#FF6B35', bg: '#1A0A00' },
+     * }
+     */
+    themeTokens?: SDKThemeTokens;
+    /**
+     * 디버그 로그 출력 여부
+     * - true: 로그 출력 (기본값 — 개발 빌드에서만 동작)
+     * - false: 로그 비활성화
+     *
+     * ⚠️ 프로덕션 빌드(import.meta.env.DEV === false)에서는
+     *    이 값과 관계없이 모든 로그가 완전히 비활성화됩니다.
+     */
+    debug?: boolean;
+    /**
+     * 트랜잭션 Receipt 폴링 설정
+     * sendTransactionAndWait() 에서 사용
+     */
+    receiptPolling?: {
+        /** 폴링 간격 (ms) — 기본값: 2000 */
+        intervalMs?: number;
+        /** 최대 대기 시간 (ms) — 기본값: 60000 */
+        timeoutMs?: number;
+    };
+}
+/**
+ * sendTransactionWithWaitForReceipt() 반환 타입
+ * 전송 결과(txHash)와 채굴 후 Receipt를 함께 포함
+ */
+export interface TransactionWithReceipt {
+    chainId: string;
+    txHash: string;
+    receipt: import('./chain').TransactionReceipt;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,21 @@
+import { EvmTransactionRequest } from './chain';
+
+export type PrepareAction = 'sign' | 'send' | 'sign-message' | 'sign-typed-data';
+/**
+ * Prepare에 전달할 컨텍스트.
+ * action에 따라 필요한 필드만 사용됩니다.
+ * - sign / send → tx
+ * - sign-message → message, from
+ * - sign-typed-data → typedData, from
+ */
+export interface PrepareContext {
+    tx?: EvmTransactionRequest;
+    message?: string;
+    typedData?: unknown;
+    from?: string;
+}
+export interface PrepareResult {
+    uuid: string;
+    expiresAt: string;
+}
+//# sourceMappingURL=prepare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/core/types/prepare.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB"}

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

@@ -0,0 +1,10 @@
+import { StoragePort, WalletProviderPort } from '../ports';
+import { MigrateResult } from '../types';
+
+export declare class MigrateWalletUseCase {
+    private storage;
+    private walletProvider;
+    constructor(storage: StoragePort, walletProvider: WalletProviderPort);
+    execute(pin: string, sub: string): Promise<MigrateResult>;
+}
+//# sourceMappingURL=MigrateWalletUseCase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MigrateWalletUseCase.d.ts","sourceRoot":"","sources":["../../../src/core/usecases/MigrateWalletUseCase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,cAAc;gBADd,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,kBAAkB;IAGtC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAkBhE"}

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

@@ -0,0 +1,38 @@
+import { StoragePort, CryptoPort, OAuthPort, TransportPort, WalletProviderPort } from '../ports';
+import { AuthResult, SDKConfig, SignInOptions } from '../types';
+import { TokenMemoryStore } from '../services/TokenMemoryStore';
+
+export declare class SignInUseCase {
+    private config;
+    private storage;
+    private crypto;
+    private oauth;
+    private transport;
+    private walletProvider;
+    private tokenStore;
+    private _refreshPromise;
+    constructor(config: SDKConfig, storage: StoragePort, crypto: CryptoPort, oauth: OAuthPort, transport: TransportPort, walletProvider: WalletProviderPort, tokenStore: TokenMemoryStore);
+    execute(options?: SignInOptions): Promise<AuthResult>;
+    /**
+     * Firebase 토큰 → CROSSx access_token 교환
+     * POST {authApiUrl}/social/login
+     */
+    private exchangeFirebaseToken;
+    /**
+     * 세션 복원
+     *
+     * 우선순위:
+     *   1. 메모리에 유효한 access_token이 있으면 그대로 사용 (같은 탭 내 SDK 재초기화)
+     *   2. 없으면 localStorage의 refresh_token으로 silentRefresh 시도
+     *   3. refresh_token도 없거나 만료 → null (로그인 화면으로)
+     */
+    restoreSession(): Promise<AuthResult | null>;
+    /**
+     * refresh_token으로 새 access_token 발급 (silent refresh)
+     * 동시 호출 시 단일 요청으로 deduplicate.
+     */
+    private silentRefresh;
+    private _doSilentRefresh;
+    private loadWallet;
+}
+//# sourceMappingURL=SignInUseCase.d.ts.map

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

@@ -0,0 +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,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMrE,qBAAa,aAAa;IAItB,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;IATpB,OAAO,CAAC,eAAe,CAAgC;gBAG7C,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,kBAAkB,EAClC,UAAU,EAAE,gBAAgB;IAGhC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA0G3D;;;OAGG;YACW,qBAAqB;IA2CnC;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA2ClD;;;OAGG;IACH,OAAO,CAAC,aAAa;YAOP,gBAAgB;YAqDhB,UAAU;CAwBzB"}