@locuschain/lib 0.2.1 → 0.2.3

package/dist/errors/account.d.cts

@@ -0,0 +1,45 @@
+import { BaseError, type BaseErrorOptions } from './base.cjs';
+export declare class AccountRequiredError extends BaseError {
+    name: string;
+    constructor(method: string);
+}
+export declare class InvalidTxResultError extends BaseError {
+    name: string;
+    method?: string;
+    constructor(shortMessage: string, options?: BaseErrorOptions & {
+        method?: string;
+    });
+}
+export declare class SignFailedError extends BaseError {
+    name: string;
+    constructor(shortMessage: string, options?: BaseErrorOptions);
+}
+/**
+ * WASM 의 키 derivation 경로가 동일한 master / normal public key 를 반환한
+ * 경우에 던진다. 과거에는 JS 브릿지가 deterministic seed 를 WASM 으로
+ * 전달하지 못하던 버그 (bug-002, 커밋 e00a35e 에서 해결) 가 원인이었고,
+ * 그 결과 AIMER / HAETAE 조합에서 두 슬롯의 키가 같은 값으로 derive 되곤
+ * 했다. 브릿지 fix 이후 이 가드는 회귀 안전망 역할만 한다 — 생성 시점에
+ * 조용히 실패하면 호출자는 master==normal account 를 들고 있다가 노드의
+ * `openAccount` 단계에서 거부 당하므로, JS 경계에서 미리 surface 한다.
+ */
+export declare class DegenerateKeyError extends BaseError {
+    name: string;
+    algoMaster?: string;
+    algoNormal?: string;
+    constructor(options: {
+        source: string;
+        algoMaster?: string;
+        algoNormal?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * TX 가 `master.signKeyBind` 를 필요로 하는데 (OPEN_ACCOUNT, CHANGE_KEYPAIR)
+ * master KeySource 가 이를 제공하지 않은 경우에 던진다.
+ */
+export declare class SignKeyBindUnsupportedError extends BaseError {
+    name: string;
+    keySourceType: string;
+    constructor(keySourceType: string);
+}

package/dist/errors/base.d.cts

@@ -0,0 +1,13 @@
+export type BaseErrorOptions = {
+    cause?: unknown;
+    details?: string;
+    metaMessages?: string[];
+};
+export declare class BaseError extends Error {
+    name: string;
+    shortMessage: string;
+    metaMessages: string[];
+    details?: string;
+    cause?: unknown;
+    constructor(shortMessage: string, options?: BaseErrorOptions);
+}

package/dist/errors/index.d.cts

@@ -1,4 +1,4 @@
-export * from './base.mjs';
-export * from './rpc.mjs';
-export * from './transport.mjs';
-export * from './account.mjs';
+export * from './base.cjs';
+export * from './rpc.cjs';
+export * from './transport.cjs';
+export * from './account.cjs';

package/dist/errors/rpc.d.cts

@@ -0,0 +1,21 @@
+import { BaseError, type BaseErrorOptions } from './base.cjs';
+export type RpcErrorOptions = BaseErrorOptions & {
+    method?: string;
+    params?: readonly unknown[];
+};
+/** 요청을 전송하기 전에 로컬에서 검증을 통과하지 못한 경우. */
+export declare class RpcRequestError extends BaseError {
+    name: string;
+    method?: string;
+    params?: readonly unknown[];
+    constructor(shortMessage: string, options?: RpcErrorOptions);
+}
+/** 노드가 JSON-RPC error envelope 를 반환한 경우. */
+export declare class RpcResponseError extends BaseError {
+    name: string;
+    code: number | string;
+    method?: string;
+    constructor(shortMessage: string, options: RpcErrorOptions & {
+        code: number | string;
+    });
+}

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.amd.js

@@ -1,4 +1,4 @@
-define(['exports', './clients/index.amd', './transports/index.amd', './accounts/index.amd', './chunks/base-B_kRRfsf', './chunks/rpc-C4n7t9y0', './chunks/transport-BBAz1kmP', './chunks/account-BSrvZ7S8', './contracts/index.amd', './constant/index.amd', './chunks/keystore-y1JlFTKh', './chunks/lclib-Bv86gksL', './chunks/tslib.es6-D29rxPkW', './chunks/debugWalletActions-BDz-h2tl', './chunks/tx-type-CS4wIUJ8', './chunks/wasm-CkFW222S', './chunks/address-class-Dp7aNQb2'], (function (exports, clients, transports, accounts, base, rpc, transport, account, contracts, constant, keystore, lclib, tslib_es6, debugWalletActions, txType, wasm, addressClass) { 'use strict';
+define(['exports', './clients/index.amd', './transports/index.amd', './accounts/index.amd', './chunks/base-B_kRRfsf', './chunks/rpc-C4n7t9y0', './chunks/transport-BBAz1kmP', './chunks/account-BSrvZ7S8', './contracts/index.amd', './constant/index.amd', './chunks/keystore-y1JlFTKh', './chunks/lclib-Bv86gksL', './chunks/tslib.es6-D29rxPkW', './chunks/debugWalletActions-BfX1doiz', './chunks/tx-type-CS4wIUJ8', './chunks/wasm-CkFW222S', './chunks/ethers.esm.min-wXex1HuX', './chunks/address-class-Dp7aNQb2'], (function (exports, clients, transports, accounts, base, rpc, transport, account, contracts, constant, keystore, lclib, tslib_es6, debugWalletActions, txType, wasm, ethers_esm_min, addressClass) { 'use strict';
 
 
 

package/dist/index.cjs.cjs

@@ -12,9 +12,10 @@ var constant = require('./constant/index.cjs.cjs');
 var keystore = require('./chunks/keystore-BUskzeOs.cjs');
 require('./chunks/lclib-rGyKpClJ.cjs');
 require('./chunks/tslib.es6-Cfi3-HmA.cjs');
-require('./chunks/debugWalletActions-6qjkZVq9.cjs');
+require('./chunks/debugWalletActions-iCZ1H6xc.cjs');
 require('./chunks/tx-type-DI_nKG8B.cjs');
 require('./chunks/wasm-BYOKRR31.cjs');
+require('./chunks/ethers.esm.min-BBQs5Urm.cjs');
 require('./chunks/address-class-Cjy48Uqk.cjs');
 
 

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/index.esm.js

@@ -10,7 +10,8 @@ export { AddressClass, Currency, FeeType, GRANT_COST_PER_TX, MaxVMRewardsCount,
 export { c as createKeystoreBundle, s as splitKeystoreBundle, u as unlockKeystoreBundle, a as unlockMasterKeystore, b as unlockNormalKeystore } from './chunks/keystore-B86UzV8A.js';
 import './chunks/lclib-j2x9RvDY.js';
 import './chunks/tslib.es6-WQS2tr1v.js';
-import './chunks/debugWalletActions-D5-Ds7Hl.js';
+import './chunks/debugWalletActions-B96f4kZc.js';
 import './chunks/tx-type-BPkhMGad.js';
 import './chunks/wasm-CLXJDrJA.js';
+import './chunks/ethers.esm.min-CiOJmj8w.js';
 import './chunks/address-class-CHAZYhdZ.js';

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/abi.d.mts

@@ -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.amd.js

@@ -1,4 +1,140 @@
-define(['exports', '../chunks/address-class-Dp7aNQb2', '../chunks/wasm-CkFW222S', '../chunks/keystore-y1JlFTKh', '../chunks/lclib-Bv86gksL', '../chunks/base-B_kRRfsf', '../chunks/account-BSrvZ7S8', '../chunks/tslib.es6-D29rxPkW'], (function (exports, addressClass, wasm, keystore, lclib, base, account, tslib_es6) { 'use strict';
+define(['exports', '../chunks/address-class-Dp7aNQb2', '../chunks/wasm-CkFW222S', '../chunks/keystore-y1JlFTKh', '../chunks/ethers.esm.min-wXex1HuX', '../chunks/lclib-Bv86gksL', '../chunks/base-B_kRRfsf', '../chunks/account-BSrvZ7S8', '../chunks/tslib.es6-D29rxPkW'], (function (exports, addressClass, wasm, keystore, ethers_esm_min, lclib, base, account, tslib_es6) { 'use strict';
+
+    /**
+     * 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 만 사용.
+     */
+    // @ts-ignore — vendored JS, no .d.ts. tsconfig.json 에서 src/libs 가 exclude 되어
+    // allowJs 가 적용되지 않는다. 외부 노출 namespace 이므로 `any` 로 받아 사용.
+    /**
+     * 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.
+     */
+    const LocusEthers = ethers_esm_min.ethers;
+    const removeHexPrefix = (s) => {
+        if (!s)
+            return s;
+        return s.toLowerCase().startsWith('0x') ? s.substring(2) : s;
+    };
+    const convertJsonToFuncString = (item) => {
+        const inputString = item.inputs.map(x => `${x.type}`).join(',');
+        return item.name ? `${item.name}(${inputString})` : `constructor(${inputString})`;
+    };
+    /** ABI 배열에서 이름으로 function 항목 찾기. 못 찾으면 undefined. */
+    const findAbiFunction = (abi, name) => {
+        return abi.find(item => item.type === 'function' && item.name === name);
+    };
+    /**
+     * 함수 selector. '0x' prefix 포함 10자 (4-byte hex + '0x').
+     * ethers v5 `Interface.getSighash(name)` 의 직접 동등.
+     */
+    const getFuncSelector = (abiItem) => {
+        try {
+            const iface = new ethers_esm_min.ethers.utils.Interface([abiItem]);
+            return iface.getSighash(abiItem.name);
+        }
+        catch (_a) {
+            return '';
+        }
+    };
+    /**
+     * Locus chain `func` 필드용 base64-encoded data.
+     * selector(0x 제외) + 선택적 args hex(0x 제외) 를 이어 붙여 `convertHexToData`.
+     */
+    const getFunc = (abiItem, args) => {
+        const sel = getFuncSelector(abiItem);
+        if (!sel)
+            return '';
+        let hex = removeHexPrefix(sel);
+        if (args)
+            hex += removeHexPrefix(args);
+        try {
+            return wasm.convertHexToData(hex);
+        }
+        catch (_a) {
+            return '';
+        }
+    };
+    /**
+     * ABI 인자 인코드. '0x' prefix 포함. address 타입 입력이 locus 주소 형식
+     * (base32) 이면 `convertAddressToHex` 로 변환 후 전달. 이미 '0x' 로 시작하는
+     * hex 면 그대로 사용.
+     *
+     * `args` 가 생략되면 각 input 의 `value` 필드에서 값을 가져온다 — UI 측이
+     * `{ ...inputAbi, value: <user-input> }` 형태로 augmented 한 inputs 를
+     * 그대로 넘기는 호출 패턴 (explorer-suite abi-item 등) 호환.
+     */
+    const encodeArgHex = (inputs, args) => {
+        const paramTypes = [];
+        const paramValues = [];
+        inputs.forEach((input, idx) => {
+            let value = args ? args[idx] : input.value;
+            if (input.type === 'address' && typeof value === 'string' && !value.startsWith('0x')) {
+                const hex = wasm.convertAddressToHex(value);
+                if (hex != null)
+                    value = '0x' + hex;
+            }
+            paramTypes.push(input.type);
+            paramValues.push(value);
+        });
+        if (paramTypes.length === 0)
+            return '';
+        return ethers_esm_min.ethers.utils.defaultAbiCoder.encode(paramTypes, paramValues);
+    };
+    /**
+     * Locus chain `func` 응답 디코드. 결과는 `{ value, name?, type }[]`.
+     * - address: locus 주소 문자열로 변환
+     * - BigNumber: 10진 string 으로 변환
+     *
+     * `result` 는 base64-encoded chain data. 빈 결과 (`''`, `'0x'`) 는 `[]` 반환.
+     */
+    const decodeResult = (func, result) => {
+        var _a;
+        if (!result || result === '0x')
+            return [];
+        const hexString = wasm.convertDataToHex(result);
+        const iface = new ethers_esm_min.ethers.utils.Interface([func]);
+        const decoded = iface.decodeFunctionResult(func.name, hexString.startsWith('0x') ? hexString : `0x${hexString}`);
+        const resultObj = JSON.parse(JSON.stringify(decoded));
+        const outputs = (_a = func === null || func === void 0 ? void 0 : func.outputs) !== null && _a !== void 0 ? _a : [];
+        return outputs.map((output, i) => {
+            let value = resultObj[i];
+            if (output.type === 'address' && typeof value === 'string') {
+                value = wasm.convertHexToAddress(value.toLowerCase());
+            }
+            else if (value && typeof value === 'object' && value.type === 'BigNumber') {
+                value = ethers_esm_min.ethers.BigNumber.from(value).toString();
+            }
+            return { value, name: output.name, type: output.type };
+        });
+    };
+    /**
+     * ERC20 `transfer(address,uint256)` call data 에서 to/amount 추출.
+     * `funcData` 는 base64-encoded chain data. 4바이트 selector + 32바이트 to slot
+     * + 32바이트 amount slot. to 는 슬롯의 마지막 20바이트 (이더리움 표준 주소).
+     */
+    const getTransferFuncArgs = (funcData) => {
+        let hex = wasm.convertDataToHex(funcData);
+        hex = hex.startsWith('0x') ? hex : `0x${hex}`;
+        const to = wasm.convertHexToAddress(hex.slice(10, 74).slice(-40));
+        const amount = BigInt(hex.slice(74, 138)).toString();
+        return { to, amount };
+    };
 
     class TxValidator {
         constructor() {
@@ -341,12 +477,21 @@ define(['exports', '../chunks/address-class-Dp7aNQb2', '../chunks/wasm-CkFW222S'
     exports.unlockKeystoreBundle = keystore.unlockKeystoreBundle;
     exports.unlockMasterKeystore = keystore.unlockMasterKeystore;
     exports.unlockNormalKeystore = keystore.unlockNormalKeystore;
+    exports.LocusEthers = LocusEthers;
     exports.checkAddressType = checkAddressType;
+    exports.convertJsonToFuncString = convertJsonToFuncString;
+    exports.decodeResult = decodeResult;
+    exports.encodeArgHex = encodeArgHex;
+    exports.findAbiFunction = findAbiFunction;
+    exports.getFunc = getFunc;
+    exports.getFuncSelector = getFuncSelector;
+    exports.getTransferFuncArgs = getTransferFuncArgs;
     exports.isAccount = isAccount;
     exports.isContract = isContract;
     exports.isSystemToken = isSystemToken;
     exports.isToken = isToken;
     exports.loadLocusWasm = loadLocusWasm;
+    exports.removeHexPrefix = removeHexPrefix;
     exports.txValidator = txValidator;
     exports.verifyTxParams = verifyTxParams;