@nexus-cross/crossx-sdk-core 1.1.1 → 1.2.0

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

@@ -0,0 +1,43 @@
+/**
+ * PinMemoryStore
+ * 서명/전송용 6자리 PIN을 메모리에 보관합니다.
+ * 페이지 새로고침 시 자동으로 초기화됩니다.
+ *
+ * ## 보안 설계
+ * PIN을 평문 string으로 보관하는 대신, 저장 시마다 새로운
+ * 랜덤 키를 생성하여 XOR(OTP) 방식으로 암호화합니다.
+ *
+ * - 키: `crypto.getRandomValues`로 생성한 암호학적 안전 난수
+ * - 암호화: XOR(One-Time Pad) — 키가 평문 길이와 동일하고 1회만 사용되므로
+ *   정보 이론적 완전 비밀(information-theoretic perfect secrecy)을 보장합니다.
+ * - get() 반환 직전: 복호화에 사용한 중간 바이트 배열을 즉시 0으로 소거합니다.
+ * - clear() 시: 암호문·키 배열을 모두 0으로 소거한 뒤 참조를 제거합니다.
+ *
+ * ### 한계
+ * 키와 암호문이 같은 메모리 공간에 존재하므로 공격자가 전체 힙 덤프를 획득하면
+ * 복원이 가능합니다. 그러나 평문 string을 그대로 보관할 때 발생하는
+ * 우발적 로깅·직렬화·패턴 매칭 위협은 차단합니다.
+ */
+export declare class PinMemoryStore {
+    /** XOR 암호화된 PIN 바이트 (ciphertext) */
+    private encryptedBytes;
+    /** PIN과 같은 길이의 랜덤 XOR 키 */
+    private xorKey;
+    /**
+     * PIN을 메모리에 암호화하여 저장합니다.
+     * 이전 값이 있으면 먼저 안전하게 소거합니다.
+     */
+    set(pin: string): void;
+    /**
+     * 저장된 PIN을 복호화하여 반환합니다. 없으면 null.
+     * 복호화에 사용된 중간 배열은 반환 전에 소거됩니다.
+     */
+    get(): string | null;
+    /**
+     * 저장된 PIN과 키를 안전하게 소거합니다.
+     */
+    clear(): void;
+    /** PIN이 저장되어 있는지 여부를 반환합니다. */
+    has(): boolean;
+}
+//# sourceMappingURL=PinMemoryStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PinMemoryStore.d.ts","sourceRoot":"","sources":["../../../src/core/services/PinMemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAc;IACzB,oCAAoC;IACpC,OAAO,CAAC,cAAc,CAA2B;IACjD,2BAA2B;IAC3B,OAAO,CAAC,MAAM,CAA2B;IAEzC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAkBtB;;;OAGG;IACH,GAAG,IAAI,MAAM,GAAG,IAAI;IAepB;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb,+BAA+B;IAC/B,GAAG,IAAI,OAAO;CAGf"}

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

@@ -45,14 +45,16 @@ export declare enum ErrorCode {
     GAS_ESTIMATION_FAILED = "GAS_ESTIMATION_FAILED",
     /** EIP-712 domain.chainId와 path chainId 불일치 (-10026) */
     TYPED_DATA_CHAIN_ID_MISMATCH = "TYPED_DATA_CHAIN_ID_MISMATCH",
-    /** 비밀번호가 설정되지 않음 — 최초 지갑 생성 시 비밀번호 설정 필요 */
-    PASSWORD_NOT_SET = "PASSWORD_NOT_SET",
-    /** 비밀번호가 틀림 (Gateway -10028: Invalid password) */
-    PASSWORD_WRONG = "PASSWORD_WRONG",
-    /** 비밀번호 복잡도 미달 (Gateway -10029: Password does not meet complexity requirements) */
-    PASSWORD_COMPLEXITY = "PASSWORD_COMPLEXITY",
-    /** 사용자가 비밀번호 입력을 취소함 */
-    PASSWORD_CANCELLED = "PASSWORD_CANCELLED",
+    /** PIN이 설정되지 않음 — 최초 지갑 생성 시 PIN 설정 필요 */
+    PIN_NOT_SET = "PIN_NOT_SET",
+    /** PIN이 틀림 (Gateway -10028: Invalid password) */
+    PIN_WRONG = "PIN_WRONG",
+    /** PIN 형식 오류 (Gateway -10029: Password must be a 6-digit PIN) */
+    PIN_INVALID = "PIN_INVALID",
+    /** 사용자가 PIN 입력을 취소함 */
+    PIN_CANCELLED = "PIN_CANCELLED",
+    /** 너무 많은 PIN 시도 실패 — 잠금 상태 (Gateway -10031) */
+    PIN_LOCKED = "PIN_LOCKED",
     INVALID_CONFIG = "INVALID_CONFIG",
     UNKNOWN_ERROR = "UNKNOWN_ERROR"
 }

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

@@ -1 +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;IACjD,qBAAqB,0BAA0B;IAG/C,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;IACnD,oBAAoB,yBAAyB,CAAI,oBAAoB;IAGrE,sBAAsB,2BAA2B,CAAQ,2BAA2B;IACpF,qBAAqB,0BAA0B,CAAU,8BAA8B;IACvF,yEAAyE;IACzE,yBAAyB,8BAA8B,CAAE,uCAAuC;IAGhG,kBAAkB,uBAAuB,CAAY,6BAA6B;IAClF,kBAAkB,uBAAuB,CAAY,4BAA4B;IACjF,sBAAsB,2BAA2B,CAAI,oCAAoC;IACzF,gBAAgB,qBAAqB,CAAgB,2BAA2B;IAChF,sBAAsB,2BAA2B,CAAI,6BAA6B;IAElF,mDAAmD;IACnD,yBAAyB,8BAA8B;IAEvD,oDAAoD;IACpD,qBAAqB,0BAA0B;IAE/C,wDAAwD;IACxD,4BAA4B,iCAAiC;IAG7D,4CAA4C;IAC5C,gBAAgB,qBAAqB;IACrC,kDAAkD;IAClD,cAAc,mBAAmB;IACjC,mFAAmF;IACnF,mBAAmB,wBAAwB;IAC3C,wBAAwB;IACxB,kBAAkB,uBAAuB;IAGzC,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAE3B,IAAI,EAAE,SAAS;IAEf,OAAO,CAAC,EAAE,OAAO;gBAFjB,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;IAO1B,MAAM;;;;;;CAQP"}
+{"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;IACjD,qBAAqB,0BAA0B;IAG/C,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;IACnD,oBAAoB,yBAAyB,CAAI,oBAAoB;IAGrE,sBAAsB,2BAA2B,CAAQ,2BAA2B;IACpF,qBAAqB,0BAA0B,CAAU,8BAA8B;IACvF,yEAAyE;IACzE,yBAAyB,8BAA8B,CAAE,uCAAuC;IAGhG,kBAAkB,uBAAuB,CAAY,6BAA6B;IAClF,kBAAkB,uBAAuB,CAAY,4BAA4B;IACjF,sBAAsB,2BAA2B,CAAI,oCAAoC;IACzF,gBAAgB,qBAAqB,CAAgB,2BAA2B;IAChF,sBAAsB,2BAA2B,CAAI,6BAA6B;IAElF,mDAAmD;IACnD,yBAAyB,8BAA8B;IAEvD,oDAAoD;IACpD,qBAAqB,0BAA0B;IAE/C,wDAAwD;IACxD,4BAA4B,iCAAiC;IAG7D,0CAA0C;IAC1C,WAAW,gBAAgB;IAC3B,iDAAiD;IACjD,SAAS,cAAc;IACvB,iEAAiE;IACjE,WAAW,gBAAgB;IAC3B,uBAAuB;IACvB,aAAa,kBAAkB;IAC/B,+CAA+C;IAC/C,UAAU,eAAe;IAGzB,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAE3B,IAAI,EAAE,SAAS;IAEf,OAAO,CAAC,EAAE,OAAO;gBAFjB,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;IAO1B,MAAM;;;;;;CAQP"}

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

@@ -58,6 +58,16 @@ export declare class SignInUseCase {
      */
     private silentRefresh;
     private _doSilentRefresh;
+    /**
+     * 외부에서 발급된 CROSSx JWT를 직접 주입하여 로그인합니다.
+     *
+     * OAuth 팝업 없이 이미 보유한 access_token으로 인증합니다.
+     * iOS SDK의 signInWithJWT(accessToken:refreshToken:)에 대응합니다.
+     *
+     * @param accessToken CROSSx 서버 발급 JWT access token
+     * @param refreshToken 선택적 refresh token
+     */
+    executeWithJWT(accessToken: string, refreshToken?: string): Promise<AuthResult>;
     private loadWallet;
 }
 //# sourceMappingURL=SignInUseCase.d.ts.map

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;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,CAA4C;gBAGzD,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;IAGtC,OAAO,KAAK,aAAa,GAExB;IAED;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAmBpB,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA+G3D;;;;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;IAmElD;;;;OAIG;IACH,OAAO,CAAC,aAAa;YAOP,gBAAgB;YAuDhB,UAAU;CA2DzB"}
+{"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;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,CAA4C;gBAGzD,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;IAGtC,OAAO,KAAK,aAAa,GAExB;IAED;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAmBpB,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA+G3D;;;;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;IAmElD;;;;OAIG;IACH,OAAO,CAAC,aAAa;YAOP,gBAAgB;IAuD9B;;;;;;;;OAQG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAmEvE,UAAU;CA2DzB"}