@locuschain/lib 0.2.2 → 0.2.4

package/dist/utils/index.esm.js

@@ -1,4 +1,4 @@
-import { A as AddressClass } from '../chunks/address-class-CHAZYhdZ.js';
+import { A as AddressClass } from '../chunks/address-class-3IzotplG.js';
 import { n as convertDataToHex, p as convertHexToAddress, f as convertAddressToHex, r as convertHexToData, T as verifyTx, d as compileCoreScript } from '../chunks/wasm-CLXJDrJA.js';
 export { b as calculateTxLinkHash, e as convertAddressToData, g as convertBase32ToData, h as convertBase32ToHex, i as convertCurrency, j as convertDataTo, k as convertDataToAddress, m as convertDataToBase32, o as convertDataToString, q as convertHexToBase32, s as convertStringToData, t as convertToData, c as createAccountAndKeystore, u as createMasterKeystore, v as createNormalKey, w as createNormalKeystore, x as decodeTxs, y as deriveKeysFromMnemonic, z as deriveKeysFromMnemonicAndPath, A as disCompileCoreScript, B as encodeTxCurrency, C as encodeTxNumber, D as generateMnemonic, E as generateMnemonicBySeed, F as getDefFromCoreScript, G as getHomeShard, H as getLibraryVersions, I as gzipAndEncode, J as hash, K as isGrantConsumingTx, l as loadMasterKeystore, a as loadNormalKeystore, L as makeCurrency, M as sign, N as signByMasterKey, O as signKeyBind, P as testCoreScript, Q as verify, R as verifyByMasterKey, S as verifyMerkleProof } from '../chunks/wasm-CLXJDrJA.js';
 export { c as createKeystoreBundle, s as splitKeystoreBundle, u as unlockKeystoreBundle, a as unlockMasterKeystore, b as unlockNormalKeystore } from '../chunks/keystore-B86UzV8A.js';
@@ -427,11 +427,9 @@ const checkAddressType = (address) => {
     // return AddressType.UNKNOWN;
 };
 const isAccount = (addressType) => addressType === AddressClass.User || addressType === AddressClass.Synthetic || AddressClass.VmEngine;
-const isContract = (addressType) => addressType === AddressClass.Contract;
-const isToken = (addressType) => addressType === AddressClass.UserToken ||
-    addressType === AddressClass.ContractToken ||
+const isToken = (addressType) => addressType === AddressClass.Token ||
     addressType === AddressClass.AssetToken ||
     addressType === AddressClass.AssetNFT;
-const isSystemToken = (addressType) => addressType === AddressClass.UserToken || addressType === AddressClass.ContractToken;
+const isSystemToken = (addressType) => addressType === AddressClass.Token;
 
-export { LocusEthers, checkAddressType, compileCoreScript, convertAddressToHex, convertDataToHex, convertHexToAddress, convertHexToData, convertJsonToFuncString, decodeResult, encodeArgHex, findAbiFunction, getFunc, getFuncSelector, getTransferFuncArgs, isAccount, isContract, isSystemToken, isToken, loadLocusWasm, removeHexPrefix, txValidator, verifyTx, verifyTxParams };
+export { LocusEthers, checkAddressType, compileCoreScript, convertAddressToHex, convertDataToHex, convertHexToAddress, convertHexToData, convertJsonToFuncString, decodeResult, encodeArgHex, findAbiFunction, getFunc, getFuncSelector, getTransferFuncArgs, isAccount, isSystemToken, isToken, loadLocusWasm, removeHexPrefix, txValidator, verifyTx, verifyTxParams };

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.4",
   "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"
   }
 }

package/dist/autogen/actions/debug/public/getContractLog.d.mts

@@ -1,4 +0,0 @@
-import { ParamsContractLog } from '../../../types/rpc/params-contract-log.mjs';
-import { RpcGetContractLogResult } from '../../../types/rpc/rpc-get-contract-log-result.mjs';
-import type { Client } from '../../../../clients/types.mjs';
-export declare function getContractLog(client: Client, param: ParamsContractLog): Promise<RpcGetContractLogResult>;

package/dist/autogen/actions/debug/public/viewContract.d.mts

@@ -1,4 +0,0 @@
-import { ParamsCallContract } from '../../../types/rpc/params-call-contract.mjs';
-import { RpcViewContractResult } from '../../../types/rpc/rpc-view-contract-result.mjs';
-import type { Client } from '../../../../clients/types.mjs';
-export declare function viewContract(client: Client, param: ParamsCallContract): Promise<RpcViewContractResult>;

package/dist/autogen/actions/debug/wallet/callContract.d.mts

@@ -1,4 +0,0 @@
-import { ParamsCallContract } from '../../../types/rpc/params-call-contract.mjs';
-import { RpcCreateTxResult } from '../../../types/rpc/rpc-create-tx-result.mjs';
-import type { WalletClient } from '../../../../clients/types.mjs';
-export declare function callContract(client: WalletClient, param: ParamsCallContract): Promise<RpcCreateTxResult>;

package/dist/autogen/actions/debug/wallet/createContract.d.mts

@@ -1,4 +0,0 @@
-import { ParamsCreateContract } from '../../../types/rpc/params-create-contract.mjs';
-import { RpcCreateTxResult } from '../../../types/rpc/rpc-create-tx-result.mjs';
-import type { WalletClient } from '../../../../clients/types.mjs';
-export declare function createContract(client: WalletClient, param: ParamsCreateContract): Promise<RpcCreateTxResult>;

package/dist/autogen/actions/public/calculateSpentByExpress.d.mts

@@ -1,4 +0,0 @@
-import { ParamsCalculateSpentByExpress } from '../../types/rpc/params-calculate-spent-by-express.mjs';
-import { RpcCalculateSpentByExpressResult } from '../../types/rpc/rpc-calculate-spent-by-express-result.mjs';
-import type { Client } from '../../../clients/types.mjs';
-export declare function calculateSpentByExpress(client: Client, param: ParamsCalculateSpentByExpress): Promise<RpcCalculateSpentByExpressResult>;

package/dist/autogen/actions/wallet/transferCoinExpress.d.mts

@@ -1,4 +0,0 @@
-import { ParamsTransferCoinExpress } from '../../types/rpc/params-transfer-coin-express.mjs';
-import { RpcCreateTxResult } from '../../types/rpc/rpc-create-tx-result.mjs';
-import type { WalletClient } from '../../../clients/types.mjs';
-export declare function transferCoinExpress(client: WalletClient, param: ParamsTransferCoinExpress): Promise<RpcCreateTxResult>;

package/dist/autogen/types/common/asset-proof-objects.d.mts

@@ -1,5 +0,0 @@
-import { AssetObject } from './asset-object.mjs';
-export type AssetProofObjects = {
-    objects: AssetObject[];
-    assetProof: string;
-};

package/dist/autogen/types/rpc/rpc-calculate-spent-by-express-result.d.mts

@@ -1,3 +0,0 @@
-export type RpcCalculateSpentByExpressResult = {
-    amount: string;
-};

package/dist/autogen/types/rpc/rpc-get-contract-log-result.d.mts

@@ -1,3 +0,0 @@
-export type RpcGetContractLogResult = {
-    log: string;
-};

package/dist/autogen/types/rpc/rpc-view-contract-result.d.mts

@@ -1,3 +0,0 @@
-export type RpcViewContractResult = {
-    result: string;
-};

package/dist/autogen/types/tx/tx-activate-call-contract.d.mts

@@ -1,15 +0,0 @@
-import { TokenValuePair } from '../common/token-value-pair.mjs';
-import { TxBase } from '../common/tx-base.mjs';
-import { TxNoSignature } from '../common/tx-no-signature.mjs';
-import { VmTxState } from '../common/vm-tx-state.mjs';
-export type TxActivateCallContract = TxBase & TxNoSignature & {
-    vmResult: VmTxState;
-    fuelLimit: string;
-    amount: string;
-    tokenAmounts: TokenValuePair[];
-    func: string;
-    argData: string;
-    tokenProof: string;
-    tokenHash: string;
-    gathered: string;
-};

package/dist/autogen/types/tx/tx-activate-open-contract.d.mts

@@ -1,15 +0,0 @@
-import { TokenValuePair } from '../common/token-value-pair.mjs';
-import { TxBase } from '../common/tx-base.mjs';
-import { TxNoSignature } from '../common/tx-no-signature.mjs';
-import { VmTxState } from '../common/vm-tx-state.mjs';
-export type TxActivateOpenContract = TxBase & TxNoSignature & {
-    vmResult: VmTxState;
-    fuelLimit: string;
-    amount: string;
-    tokenAmounts: TokenValuePair[];
-    tokenHash: string;
-    gathered: string;
-    addr: string;
-    sysId: string;
-    code: string;
-};