@locuschain/lib 0.2.2 → 0.2.3

package/dist/errors/transport.d.cts

@@ -0,0 +1,21 @@
+import { BaseError, type BaseErrorOptions } from './base.cjs';
+export type TransportErrorOptions = BaseErrorOptions & {
+    url?: string;
+    status?: number;
+};
+export declare class HttpRequestError extends BaseError {
+    name: string;
+    url?: string;
+    status?: number;
+    constructor(shortMessage: string, options?: TransportErrorOptions);
+}
+export declare class TimeoutError extends BaseError {
+    name: string;
+    url?: string;
+    constructor(shortMessage: string, options?: TransportErrorOptions);
+}
+export declare class AbortedError extends BaseError {
+    name: string;
+    url?: string;
+    constructor(shortMessage: string, options?: TransportErrorOptions);
+}

package/dist/index.d.cts

@@ -0,0 +1,8 @@
+export * from './clients/index.cjs';
+export * from './transports/index.cjs';
+export * from './accounts/index.cjs';
+export * from './errors/index.cjs';
+export * from './contracts/index.cjs';
+export * from './constant/index.cjs';
+export * from './types/index.cjs';
+export * from './utils/keystore.cjs';

package/dist/transports/http.d.cts

@@ -0,0 +1,9 @@
+import type { Transport, TransportConfig } from './types.cjs';
+/**
+ * HTTP JSON-RPC 트랜스포트를 만든다.
+ *
+ * 반환된 함수는 createClient() 가 호출하면서 id 제너레이터를 전달하고,
+ * 그렇게 만들어진 TransportInstance 는 각 JSON-RPC envelope 의 `id` 필드를
+ * 증가시키며 채워 넣는다.
+ */
+export declare function http(url: string, config?: TransportConfig): Transport;

package/dist/transports/index.d.cts

@@ -1,2 +1,2 @@
-export * from './types.mjs';
-export * from './http.mjs';
+export * from './types.cjs';
+export * from './http.cjs';

package/dist/transports/types.d.cts

@@ -0,0 +1,38 @@
+type HeadersInit = Record<string, string>;
+export type TransportRequestArgs = {
+    method: string;
+    params: readonly unknown[];
+};
+export type TransportRequestOptions = {
+    signal?: AbortSignal;
+    headers?: HeadersInit;
+};
+export type TransportRequestFn = <T = unknown>(args: TransportRequestArgs, opts?: TransportRequestOptions) => Promise<T>;
+export type TransportInstance = {
+    type: string;
+    url?: string;
+    request: TransportRequestFn;
+};
+export type TransportConfig = {
+    /** 요청당 기본 timeout (ms). 기본값 30_000. */
+    timeout?: number;
+    /** 모든 요청에 병합되는 기본 헤더. */
+    headers?: HeadersInit;
+    /** 모든 요청에 병합되는 추가 fetch 옵션. */
+    fetchOptions?: Omit<RequestInit, 'method' | 'body' | 'headers' | 'signal'>;
+    /**
+     * 클라이언트-레벨 AbortSignal. 이 transport 로 만들어진 모든 fetch 에 자동
+     * 첨부되며, per-request `opts.signal` 및 내부 timeout signal 과 함께
+     * `AbortSignal.any` 로 병합된다. abort 한 번이면 이 transport 의 모든
+     * in-flight 요청이 즉시 cancel.
+     */
+    signal?: AbortSignal;
+};
+/**
+ * Transport 는 팩토리다 — (보통 createClient 가) 호출하면 request-id 카운터
+ * 와 상태에 바인드된 실제 TransportInstance 를 반환한다.
+ */
+export type Transport = (config?: {
+    id?: () => number;
+}) => TransportInstance;
+export {};

package/dist/transports/types.d.mts

@@ -1,3 +1,4 @@
+type HeadersInit = Record<string, string>;
 export type TransportRequestArgs = {
     method: string;
     params: readonly unknown[];
@@ -34,3 +35,4 @@ export type TransportConfig = {
 export type Transport = (config?: {
     id?: () => number;
 }) => TransportInstance;
+export {};

package/dist/types/index.d.cts

@@ -1,8 +1,8 @@
-export * from '../autogen/locus-tx.mjs';
-export * from '../autogen/types/tx/index.mjs';
-export * from '../autogen/types/common/index.mjs';
-export * from '../autogen/types/rpc/index.mjs';
-export * from './primitives.mjs';
+export * from '../autogen/locus-tx.cjs';
+export * from '../autogen/types/tx/index.cjs';
+export * from '../autogen/types/common/index.cjs';
+export * from '../autogen/types/rpc/index.cjs';
+export * from './primitives.cjs';
 type KeysOfUnion<T> = T extends T ? keyof T : never;
 export type UnionToOptional<T> = {
     [K in keyof T]: T[K];

package/dist/types/primitives.d.cts

@@ -0,0 +1,5 @@
+export type Hex = `0x${string}`;
+/** 트랜잭션 해시. Locus 는 이 값을 일반 문자열로 emit 한다. */
+export type Hash = string;
+/** Locus account/contract/token 주소 (Base32 인코딩). */
+export type Address = string;

package/dist/utils/abi.d.cts

@@ -0,0 +1,88 @@
+/**
+ * ABI 코덱 + vendored ethers v5 namespace re-export.
+ *
+ * `support/erc20-helper/abi.mts` 가 lib 0.2.0 의 viem-style 리팩토링 때 사라졌으나,
+ * locus-wallet-extension / locuschain-explorer-suite 가 동일 API 셰입에 의존하고
+ * 있어 같은 셰입을 lib 안에 다시 둔다 (양쪽 사이트의 자체 locus-ethers.ts 중복
+ * 해소가 목적).
+ *
+ * 이 모듈은 vendored ethers v5 (`libs/ethers.js-5.5.4-20bytes-addr/ethers.esm.min.js`)
+ * 만 사용. `getContract.mts` 와 동일한 import 경로 — 외부 사용자는 자체 `ethers`
+ * 패키지를 dep 으로 가질 필요 없다.
+ *
+ * 주소 길이는 20바이트(이더리움 표준). ABI 32바이트 슬롯의 마지막 40 hex 만 사용.
+ */
+/**
+ * vendored ethers v5 namespace. 호출자가 `LocusEthers.BigNumber`, `LocusEthers.utils.id`
+ * 등 namespace 함수를 자유롭게 쓸 수 있게 re-export. `import { ethers } from 'ethers'`
+ * 를 외부 dep 으로 따로 갖지 않아도 lib 한 곳에서 가져갈 수 있다.
+ *
+ * vendored ethers 는 .d.ts 가 없어 type 위치 (`let x: LocusEthers.BigNumber`) 에
+ * 쓰이려면 namespace declaration 이 필요하다. declaration merging 으로 같은 이름의
+ * value (vendored ethers runtime) 와 namespace (type alias) 를 함께 export.
+ */
+export declare const LocusEthers: any;
+export declare namespace LocusEthers {
+    type BigNumber = any;
+    type BigNumberish = any;
+}
+export type AbiInput = {
+    name?: string;
+    type: string;
+    value?: any;
+};
+export type AbiFunctionItem = {
+    name: string;
+    inputs: AbiInput[];
+    outputs?: AbiInput[];
+    type?: string;
+    stateMutability?: string;
+};
+export declare const removeHexPrefix: (s: string) => string;
+export declare const convertJsonToFuncString: (item: {
+    inputs: AbiInput[];
+    name?: string;
+}) => string;
+/** ABI 배열에서 이름으로 function 항목 찾기. 못 찾으면 undefined. */
+export declare const findAbiFunction: (abi: readonly any[], name: string) => AbiFunctionItem | undefined;
+/**
+ * 함수 selector. '0x' prefix 포함 10자 (4-byte hex + '0x').
+ * ethers v5 `Interface.getSighash(name)` 의 직접 동등.
+ */
+export declare const getFuncSelector: (abiItem: AbiFunctionItem) => string;
+/**
+ * Locus chain `func` 필드용 base64-encoded data.
+ * selector(0x 제외) + 선택적 args hex(0x 제외) 를 이어 붙여 `convertHexToData`.
+ */
+export declare const getFunc: (abiItem: AbiFunctionItem, args?: string) => string;
+/**
+ * ABI 인자 인코드. '0x' prefix 포함. address 타입 입력이 locus 주소 형식
+ * (base32) 이면 `convertAddressToHex` 로 변환 후 전달. 이미 '0x' 로 시작하는
+ * hex 면 그대로 사용.
+ *
+ * `args` 가 생략되면 각 input 의 `value` 필드에서 값을 가져온다 — UI 측이
+ * `{ ...inputAbi, value: <user-input> }` 형태로 augmented 한 inputs 를
+ * 그대로 넘기는 호출 패턴 (explorer-suite abi-item 등) 호환.
+ */
+export declare const encodeArgHex: (inputs: AbiInput[], args?: any[]) => string;
+/**
+ * Locus chain `func` 응답 디코드. 결과는 `{ value, name?, type }[]`.
+ * - address: locus 주소 문자열로 변환
+ * - BigNumber: 10진 string 으로 변환
+ *
+ * `result` 는 base64-encoded chain data. 빈 결과 (`''`, `'0x'`) 는 `[]` 반환.
+ */
+export declare const decodeResult: (func: any, result: string) => {
+    value: any;
+    name?: string;
+    type: string;
+}[];
+/**
+ * ERC20 `transfer(address,uint256)` call data 에서 to/amount 추출.
+ * `funcData` 는 base64-encoded chain data. 4바이트 selector + 32바이트 to slot
+ * + 32바이트 amount slot. to 는 슬롯의 마지막 20바이트 (이더리움 표준 주소).
+ */
+export declare const getTransferFuncArgs: (funcData: string) => {
+    to: string;
+    amount: string;
+};

package/dist/utils/index.d.cts

@@ -1,7 +1,7 @@
-export * from '../autogen/wasm.mjs';
-export * from './keystore.mjs';
-export * from './abi.mjs';
-import { TxValidator } from './tx-validator.mjs';
+export * from '../autogen/wasm.cjs';
+export * from './keystore.cjs';
+export * from './abi.cjs';
+import { TxValidator } from './tx-validator.cjs';
 /**
  * `loadLocusWasm` 의 옵션.
  *
@@ -34,7 +34,7 @@ export declare const verifyTxParams: (rpcResult: {
     tx: any;
 }, params: any, options: {
     targetTxHash?: string | false;
-}) => import("./tx-validator.mjs").IntegrityCheckResult;
+}) => import("./tx-validator.cjs").IntegrityCheckResult;
 export declare const checkAddressType: (address: string) => number;
 export declare const isAccount: (addressType: number) => true | 3;
 export declare const isContract: (addressType: number) => addressType is 2;

package/dist/utils/keystore.d.cts

@@ -0,0 +1,87 @@
+import type { Address } from '../types/primitives.cjs';
+/** `loadMasterKeystore` 가 반환하는 파싱된 master keystore payload. */
+export type MasterKeyInfo = {
+    address: Address;
+    mkeyAlgorithm: string;
+    msecretKey: string;
+    mpublicKey: string;
+};
+/** `loadNormalKeystore` 가 반환하는 파싱된 normal keystore payload. */
+export type NormalKeyInfo = {
+    address: Address;
+    nkeyAlgorithm: string;
+    nsecretKey: string;
+    npublicKey: string;
+    keyBind: unknown;
+};
+/** 평탄화된 키 자료 — `keysToAccount` 가 받는 형태. */
+export type UnlockedKeyPair = {
+    address: Address;
+    msk: string;
+    mpk: string;
+    nsk: string;
+    npk: string;
+};
+export type CreateKeystoreBundleArgs = {
+    passwordMaster: string;
+    passwordNormal: string;
+    /** 비어 있으면 WASM 헬퍼가 내부적으로 'FALCON+ED25519' 를 기본값으로 쓴다. */
+    algoMaster?: string;
+    /** 비어 있으면 WASM 헬퍼가 내부적으로 'ED25519' 를 기본값으로 쓴다. */
+    algoNormal?: string;
+};
+export type AccountKeystoreBundle = {
+    /** 원본 JSON array 문자열 — 영속화에 적합. */
+    raw: string;
+    /** master / normal 두 반쪽의 개별 JSON 문자열. */
+    masterKsJson: string;
+    normalKsJson: string;
+};
+/**
+ * 새 dual-key keystore 를 만들고 결과 JSON array 를 master / normal 두
+ * 반쪽으로 분리한다. 각 반쪽은 독립적으로 영속화한 뒤 unlockMasterKeystore
+ * / unlockNormalKeystore 로 다시 unlock 할 수 있다.
+ *
+ * WASM 의 `createAccountAndKeystore` 에 대한 얇은 래퍼다. `utils/index.mts`
+ * 가 raw WASM export 도 함께 re-export 하므로 충돌을 피하려고 이름을
+ * 새로 붙였다.
+ */
+export declare function createKeystoreBundle(args: CreateKeystoreBundleArgs): AccountKeystoreBundle;
+/**
+ * WASM `createAccountAndKeystore` 헬퍼가 반환한 `[master, normal]` keystore
+ * 배열을 두 JSON 문자열로 분리한다.
+ */
+export declare function splitKeystoreBundle(bundleJson: string): {
+    masterKsJson: string;
+    normalKsJson: string;
+};
+/**
+ * master keystore JSON 을 password 로 복호화한다.
+ *
+ * WASM 헬퍼가 emit 하는 lowercase-camelCase 필드 (`address`, `mkeyAlgorithm`,
+ * `msecretKey`, `mpublicKey`) 를 그대로 반환한다.
+ */
+export declare function unlockMasterKeystore(args: {
+    ksJson: string;
+    password: string;
+}): MasterKeyInfo;
+/**
+ * normal keystore JSON 을 password 로 복호화한다.
+ *
+ * WASM 헬퍼가 emit 하는 lowercase-camelCase 필드 (`address`, `nkeyAlgorithm`,
+ * `nsecretKey`, `npublicKey`, `keyBind`) 를 그대로 반환한다.
+ */
+export declare function unlockNormalKeystore(args: {
+    ksJson: string;
+    password: string;
+}): NormalKeyInfo;
+/**
+ * one-shot 헬퍼: 전체 `[master, normal]` keystore JSON 과 두 password 를
+ * 받아 `keysToAccount` 가 소비하는 평탄한 (address, msk, mpk, nsk, npk)
+ * tuple 을 반환한다.
+ */
+export declare function unlockKeystoreBundle(args: {
+    ksJsonBundle: string | AccountKeystoreBundle;
+    passwordMaster: string;
+    passwordNormal: string;
+}): UnlockedKeyPair;

package/dist/utils/lclib.d.cts

@@ -0,0 +1,2 @@
+export function load(opts?: {}): Promise<void>;
+export const namespace: string;

package/dist/utils/locus-wasm-bridge.d.cts

@@ -0,0 +1 @@
+export function loadCryptoWasm(opts?: {}): Promise<void>;

package/dist/utils/tx-validator.d.cts

@@ -0,0 +1,28 @@
+export type IntegrityCheckResult = {
+    result: boolean | string;
+    reason: string;
+    field?: string;
+    txHash?: string;
+};
+export declare class TxValidator {
+    verifyTxParams: (rpcResult: {
+        hash: string;
+        tx: any;
+    }, params: any, options: {
+        targetTxHash?: string | false;
+    }) => IntegrityCheckResult;
+    private logAndFail;
+    private getByPathIgnoreCase;
+    private getByPath;
+    private isDeepEqual;
+    /**
+     * params 객체와 tx 객체의 필드를 주어진 매핑에 따라 비교합니다.
+     * @param params 파라미터 객체.
+     * @param tx 검증할 트랜잭션 객체.
+     * @param mapping 키는 `params`의 속성 경로, 값은 `tx`의 속성 경로인 객체.
+     * @param optional mapping과 동일한 구조이나, `params` 값이 있을경우만 체크합니다. string은 빈문자열이 아닌 문자열, number는 0을 없다고 판단합니다
+     * @returns 모든 필드가 일치하면 `true`, 실패 시 `IntegrityCheckResult` 객체를 반환합니다.
+     */
+    private checkFields;
+    private checkComplexField;
+}

package/dist/utils/types.d.cts

@@ -0,0 +1,15 @@
+export interface ParamTxData {
+    round: number;
+    height: number;
+    args: string[];
+}
+export interface MerkleProof {
+    Positions: number[];
+    Siblings: string;
+}
+export interface LibraryVersions {
+    LibraryVersion: number;
+    KeystoreVersion: number;
+    KeystoreVersionMin: number;
+    GoBuildVersion: string;
+}

package/dist/utils/wasm-fetch.d.cts

@@ -0,0 +1,6 @@
+/**
+ * .wasm 바이너리를 Uint8Array 로 가져온다.
+ * @param {URL | string} input
+ * @returns {Promise<Uint8Array>}
+ */
+export function fetchWasmBytes(input: URL | string): Promise<Uint8Array>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locuschain/lib",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "module",
   "author": "bloomtechnology",
   "license": "MIT",
@@ -142,7 +142,7 @@
   },
   "scripts": {
     "generate-code": "./generate-code.sh",
-    "build": "rm -rf dist && rollup -c rollup.config.mjs && node -e \"const fs=require('fs'); const paths=['clients','transports','accounts','errors','contracts','types','utils','constant','autogen','vite-plugin','webpack-plugin']; paths.forEach(p => { const base='./dist/'+p+'/index'; if(fs.existsSync(base+'.d.mts')){ fs.copyFileSync(base+'.d.mts', base+'.d.cts'); } })\"",
+    "build": "rm -rf dist && rollup -c rollup.config.mjs && node scripts/emit-d-cts.mjs",
     "gen-build-publish": "npm run generate-code && npm run build && npm publish --access public"
   }
 }