@locuschain/lib 0.2.8 → 0.2.10

package/dist/contracts/getContract.d.cts

@@ -11,6 +11,12 @@ export type GetContractArgs = {
     address: Address;
     abi: InterfaceAbi;
     client: Client;
+    /**
+     * 컨트랙트(=subId)가 속한 VME id. 신규 VME 모델의 debug_viewVme 가 컨트랙트를
+     * 찾으려면 반드시 필요하다 (필수). 컨트랙트는 하나의 VME 에 속하므로 핸들의
+     * 불변 속성 — read 호출마다 받지 않고 생성 시 1회 지정한다.
+     */
+    vmeId: string;
 };
 export type ContractReadFn = (args?: readonly unknown[], opts?: ReadCallOptions) => Promise<unknown>;
 export type ContractInstance = {
@@ -19,15 +25,19 @@ export type ContractInstance = {
     read: Record<string, ContractReadFn>;
 };
 /**
- * Locus 의 debug_viewContract RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
+ * Locus 의 debug_viewVme RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
  * `read.<fn>` 은 ethers(v5) 의 Interface 로 호출을 인코딩하고, 결과 바이트를
- * convertHexToData 로 Locus `func` 필드에 담아 보낸 뒤, 응답 hex 를
+ * convertHexToData 로 Locus `callData` 필드에 담아 보낸 뒤, 응답 hex 를
  * Interface.decodeFunctionResult 로 다시 디코딩한다.
  *
+ * 신규 VME 모델: 컨트랙트는 (vmeId, subId) 로 식별된다. `address` 가 subId 이고
+ * `vmeId` 는 read 호출 시 ReadCallOptions 로 받는다 (필수). RPC ParamsCallVme 의
+ * vmeId/subId 와 1:1 대응.
+ *
  * write 메서드는 이번 단계에서는 의도적으로 빠져 있다. 상태를 바꾸는 호출
  * 은 생성된 wallet action 을 직접 사용한다:
  *
- *   import { callContract } from '@locuschain/lib/autogen';
- *   await wallet.extend(debugWalletActions).callContract({ ... });
+ *   import { callVme } from '@locuschain/lib/autogen';
+ *   await wallet.extend(debugWalletActions).callVme({ ... });
  */
 export declare function getContract(args: GetContractArgs): ContractInstance;

package/dist/contracts/getContract.d.mts

@@ -11,6 +11,12 @@ export type GetContractArgs = {
     address: Address;
     abi: InterfaceAbi;
     client: Client;
+    /**
+     * 컨트랙트(=subId)가 속한 VME id. 신규 VME 모델의 debug_viewVme 가 컨트랙트를
+     * 찾으려면 반드시 필요하다 (필수). 컨트랙트는 하나의 VME 에 속하므로 핸들의
+     * 불변 속성 — read 호출마다 받지 않고 생성 시 1회 지정한다.
+     */
+    vmeId: string;
 };
 export type ContractReadFn = (args?: readonly unknown[], opts?: ReadCallOptions) => Promise<unknown>;
 export type ContractInstance = {
@@ -19,15 +25,19 @@ export type ContractInstance = {
     read: Record<string, ContractReadFn>;
 };
 /**
- * Locus 의 debug_viewContract RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
+ * Locus 의 debug_viewVme RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
  * `read.<fn>` 은 ethers(v5) 의 Interface 로 호출을 인코딩하고, 결과 바이트를
- * convertHexToData 로 Locus `func` 필드에 담아 보낸 뒤, 응답 hex 를
+ * convertHexToData 로 Locus `callData` 필드에 담아 보낸 뒤, 응답 hex 를
  * Interface.decodeFunctionResult 로 다시 디코딩한다.
  *
+ * 신규 VME 모델: 컨트랙트는 (vmeId, subId) 로 식별된다. `address` 가 subId 이고
+ * `vmeId` 는 read 호출 시 ReadCallOptions 로 받는다 (필수). RPC ParamsCallVme 의
+ * vmeId/subId 와 1:1 대응.
+ *
  * write 메서드는 이번 단계에서는 의도적으로 빠져 있다. 상태를 바꾸는 호출
  * 은 생성된 wallet action 을 직접 사용한다:
  *
- *   import { callContract } from '@locuschain/lib/autogen';
- *   await wallet.extend(debugWalletActions).callContract({ ... });
+ *   import { callVme } from '@locuschain/lib/autogen';
+ *   await wallet.extend(debugWalletActions).callVme({ ... });
  */
 export declare function getContract(args: GetContractArgs): ContractInstance;

package/dist/contracts/index.amd.js

@@ -1,19 +1,26 @@
 define(['exports', '../chunks/tslib.es6-D29rxPkW', '../chunks/ethers.esm.min-wXex1HuX', '../chunks/wasm-gROtmFm6', '../chunks/lclib-Bv86gksL'], (function (exports, tslib_es6, ethers_esm_min, wasm, lclib) { 'use strict';
 
     /**
-     * Locus 의 debug_viewContract RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
+     * Locus 의 debug_viewVme RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
      * `read.<fn>` 은 ethers(v5) 의 Interface 로 호출을 인코딩하고, 결과 바이트를
-     * convertHexToData 로 Locus `func` 필드에 담아 보낸 뒤, 응답 hex 를
+     * convertHexToData 로 Locus `callData` 필드에 담아 보낸 뒤, 응답 hex 를
      * Interface.decodeFunctionResult 로 다시 디코딩한다.
      *
+     * 신규 VME 모델: 컨트랙트는 (vmeId, subId) 로 식별된다. `address` 가 subId 이고
+     * `vmeId` 는 read 호출 시 ReadCallOptions 로 받는다 (필수). RPC ParamsCallVme 의
+     * vmeId/subId 와 1:1 대응.
+     *
      * write 메서드는 이번 단계에서는 의도적으로 빠져 있다. 상태를 바꾸는 호출
      * 은 생성된 wallet action 을 직접 사용한다:
      *
-     *   import { callContract } from '@locuschain/lib/autogen';
-     *   await wallet.extend(debugWalletActions).callContract({ ... });
+     *   import { callVme } from '@locuschain/lib/autogen';
+     *   await wallet.extend(debugWalletActions).callVme({ ... });
      */
     function getContract(args) {
-        const { address, abi, client } = args;
+        const { address, abi, client, vmeId } = args;
+        if (!vmeId) {
+            throw new Error('getContract: vmeId is required');
+        }
         const iface = new ethers_esm_min.ethers.utils.Interface(abi);
         const read = {};
         for (const item of normalizeAbi(abi)) {
@@ -29,24 +36,34 @@ define(['exports', '../chunks/tslib.es6-D29rxPkW', '../chunks/ethers.esm.min-wXe
         function makeRead(name) {
             return (...args_1) => tslib_es6.__awaiter(this, [...args_1], void 0, function* (callArgs = [], opts = {}) {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-                const encoded = iface.encodeFunctionData(name, [...callArgs]);
+                // address 타입 인자는 Locus base32 주소를 hex 로 변환해야 ethers 가 인코딩한다.
+                const fragment = iface.getFunction(name);
+                const encodeArgs = callArgs.map((arg, i) => {
+                    const input = fragment.inputs[i];
+                    if ((input === null || input === void 0 ? void 0 : input.type) === 'address' && typeof arg === 'string' && !arg.startsWith('0x')) {
+                        const hex = wasm.convertAddressToHex(arg);
+                        return hex != null ? '0x' + hex : arg;
+                    }
+                    return arg;
+                });
+                const encoded = iface.encodeFunctionData(name, encodeArgs);
                 const noPrefix = encoded.startsWith('0x') ? encoded.slice(2) : encoded;
-                const funcField = wasm.convertHexToData(noPrefix);
+                const callData = wasm.convertHexToData(noPrefix);
                 const caller = (_c = (_a = opts.caller) !== null && _a !== void 0 ? _a : (_b = client.account) === null || _b === void 0 ? void 0 : _b.address) !== null && _c !== void 0 ? _c : address;
                 const rpcResult = yield client.request({
-                    method: 'debug_viewContract',
+                    method: 'debug_viewVme',
                     params: [
                         {
                             callerAccount: caller,
-                            contractAccount: address,
+                            vmeId,
+                            subId: address,
                             amount: (_d = opts.amount) !== null && _d !== void 0 ? _d : '0',
                             fuelLimit: (_e = opts.fuelLimit) !== null && _e !== void 0 ? _e : '0',
                             tokenAmounts: [],
-                            func: funcField,
-                            argData: '',
-                            feeType: 0,
+                            callData,
                             sign: '',
                             signedHeight: 0,
+                            feeType: 0,
                         },
                     ],
                 });

package/dist/contracts/index.cjs.cjs

@@ -6,19 +6,26 @@ var wasm = require('../chunks/wasm-dbtq7eri.cjs');
 require('../chunks/lclib-rGyKpClJ.cjs');
 
 /**
- * Locus 의 debug_viewContract RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
+ * Locus 의 debug_viewVme RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
  * `read.<fn>` 은 ethers(v5) 의 Interface 로 호출을 인코딩하고, 결과 바이트를
- * convertHexToData 로 Locus `func` 필드에 담아 보낸 뒤, 응답 hex 를
+ * convertHexToData 로 Locus `callData` 필드에 담아 보낸 뒤, 응답 hex 를
  * Interface.decodeFunctionResult 로 다시 디코딩한다.
  *
+ * 신규 VME 모델: 컨트랙트는 (vmeId, subId) 로 식별된다. `address` 가 subId 이고
+ * `vmeId` 는 read 호출 시 ReadCallOptions 로 받는다 (필수). RPC ParamsCallVme 의
+ * vmeId/subId 와 1:1 대응.
+ *
  * write 메서드는 이번 단계에서는 의도적으로 빠져 있다. 상태를 바꾸는 호출
  * 은 생성된 wallet action 을 직접 사용한다:
  *
- *   import { callContract } from '@locuschain/lib/autogen';
- *   await wallet.extend(debugWalletActions).callContract({ ... });
+ *   import { callVme } from '@locuschain/lib/autogen';
+ *   await wallet.extend(debugWalletActions).callVme({ ... });
  */
 function getContract(args) {
-    const { address, abi, client } = args;
+    const { address, abi, client, vmeId } = args;
+    if (!vmeId) {
+        throw new Error('getContract: vmeId is required');
+    }
     const iface = new ethers_esm_min.ethers.utils.Interface(abi);
     const read = {};
     for (const item of normalizeAbi(abi)) {
@@ -34,24 +41,34 @@ function getContract(args) {
     function makeRead(name) {
         return (...args_1) => tslib_es6.__awaiter(this, [...args_1], void 0, function* (callArgs = [], opts = {}) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const encoded = iface.encodeFunctionData(name, [...callArgs]);
+            // address 타입 인자는 Locus base32 주소를 hex 로 변환해야 ethers 가 인코딩한다.
+            const fragment = iface.getFunction(name);
+            const encodeArgs = callArgs.map((arg, i) => {
+                const input = fragment.inputs[i];
+                if ((input === null || input === void 0 ? void 0 : input.type) === 'address' && typeof arg === 'string' && !arg.startsWith('0x')) {
+                    const hex = wasm.convertAddressToHex(arg);
+                    return hex != null ? '0x' + hex : arg;
+                }
+                return arg;
+            });
+            const encoded = iface.encodeFunctionData(name, encodeArgs);
             const noPrefix = encoded.startsWith('0x') ? encoded.slice(2) : encoded;
-            const funcField = wasm.convertHexToData(noPrefix);
+            const callData = wasm.convertHexToData(noPrefix);
             const caller = (_c = (_a = opts.caller) !== null && _a !== void 0 ? _a : (_b = client.account) === null || _b === void 0 ? void 0 : _b.address) !== null && _c !== void 0 ? _c : address;
             const rpcResult = yield client.request({
-                method: 'debug_viewContract',
+                method: 'debug_viewVme',
                 params: [
                     {
                         callerAccount: caller,
-                        contractAccount: address,
+                        vmeId,
+                        subId: address,
                         amount: (_d = opts.amount) !== null && _d !== void 0 ? _d : '0',
                         fuelLimit: (_e = opts.fuelLimit) !== null && _e !== void 0 ? _e : '0',
                         tokenAmounts: [],
-                        func: funcField,
-                        argData: '',
-                        feeType: 0,
+                        callData,
                         sign: '',
                         signedHeight: 0,
+                        feeType: 0,
                     },
                 ],
             });

package/dist/contracts/index.esm.js

@@ -1,22 +1,29 @@
 import { _ as __awaiter } from '../chunks/tslib.es6-WQS2tr1v.js';
 import { e as ethers } from '../chunks/ethers.esm.min-CiOJmj8w.js';
-import { r as convertHexToData, n as convertDataToHex } from '../chunks/wasm-CU215LGW.js';
+import { f as convertAddressToHex, r as convertHexToData, n as convertDataToHex } from '../chunks/wasm-CU215LGW.js';
 import '../chunks/lclib-j2x9RvDY.js';
 
 /**
- * Locus 의 debug_viewContract RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
+ * Locus 의 debug_viewVme RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
  * `read.<fn>` 은 ethers(v5) 의 Interface 로 호출을 인코딩하고, 결과 바이트를
- * convertHexToData 로 Locus `func` 필드에 담아 보낸 뒤, 응답 hex 를
+ * convertHexToData 로 Locus `callData` 필드에 담아 보낸 뒤, 응답 hex 를
  * Interface.decodeFunctionResult 로 다시 디코딩한다.
  *
+ * 신규 VME 모델: 컨트랙트는 (vmeId, subId) 로 식별된다. `address` 가 subId 이고
+ * `vmeId` 는 read 호출 시 ReadCallOptions 로 받는다 (필수). RPC ParamsCallVme 의
+ * vmeId/subId 와 1:1 대응.
+ *
  * write 메서드는 이번 단계에서는 의도적으로 빠져 있다. 상태를 바꾸는 호출
  * 은 생성된 wallet action 을 직접 사용한다:
  *
- *   import { callContract } from '@locuschain/lib/autogen';
- *   await wallet.extend(debugWalletActions).callContract({ ... });
+ *   import { callVme } from '@locuschain/lib/autogen';
+ *   await wallet.extend(debugWalletActions).callVme({ ... });
  */
 function getContract(args) {
-    const { address, abi, client } = args;
+    const { address, abi, client, vmeId } = args;
+    if (!vmeId) {
+        throw new Error('getContract: vmeId is required');
+    }
     const iface = new ethers.utils.Interface(abi);
     const read = {};
     for (const item of normalizeAbi(abi)) {
@@ -32,24 +39,34 @@ function getContract(args) {
     function makeRead(name) {
         return (...args_1) => __awaiter(this, [...args_1], void 0, function* (callArgs = [], opts = {}) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const encoded = iface.encodeFunctionData(name, [...callArgs]);
+            // address 타입 인자는 Locus base32 주소를 hex 로 변환해야 ethers 가 인코딩한다.
+            const fragment = iface.getFunction(name);
+            const encodeArgs = callArgs.map((arg, i) => {
+                const input = fragment.inputs[i];
+                if ((input === null || input === void 0 ? void 0 : input.type) === 'address' && typeof arg === 'string' && !arg.startsWith('0x')) {
+                    const hex = convertAddressToHex(arg);
+                    return hex != null ? '0x' + hex : arg;
+                }
+                return arg;
+            });
+            const encoded = iface.encodeFunctionData(name, encodeArgs);
             const noPrefix = encoded.startsWith('0x') ? encoded.slice(2) : encoded;
-            const funcField = convertHexToData(noPrefix);
+            const callData = convertHexToData(noPrefix);
             const caller = (_c = (_a = opts.caller) !== null && _a !== void 0 ? _a : (_b = client.account) === null || _b === void 0 ? void 0 : _b.address) !== null && _c !== void 0 ? _c : address;
             const rpcResult = yield client.request({
-                method: 'debug_viewContract',
+                method: 'debug_viewVme',
                 params: [
                     {
                         callerAccount: caller,
-                        contractAccount: address,
+                        vmeId,
+                        subId: address,
                         amount: (_d = opts.amount) !== null && _d !== void 0 ? _d : '0',
                         fuelLimit: (_e = opts.fuelLimit) !== null && _e !== void 0 ? _e : '0',
                         tokenAmounts: [],
-                        func: funcField,
-                        argData: '',
-                        feeType: 0,
+                        callData,
                         sign: '',
                         signedHeight: 0,
+                        feeType: 0,
                     },
                 ],
             });

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@locuschain/lib",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "type": "module",
   "author": "bloomtechnology",
   "license": "MIT",
   "description": "",
   "engines": {
-    "node": "~22.19.0"
+    "node": ">=20.0.0"
   },
   "main": "./dist/index.cjs.cjs",
   "module": "./dist/index.amd.js",
@@ -107,6 +107,43 @@
       "require": "./dist/webpack-plugin/index.cjs.cjs"
     }
   },
+  "typesVersions": {
+    "*": {
+      "clients": [
+        "./dist/clients/index.d.cts"
+      ],
+      "transports": [
+        "./dist/transports/index.d.cts"
+      ],
+      "accounts": [
+        "./dist/accounts/index.d.cts"
+      ],
+      "errors": [
+        "./dist/errors/index.d.cts"
+      ],
+      "contracts": [
+        "./dist/contracts/index.d.cts"
+      ],
+      "autogen": [
+        "./dist/autogen/index.d.cts"
+      ],
+      "utils": [
+        "./dist/utils/index.d.cts"
+      ],
+      "types": [
+        "./dist/types/index.d.cts"
+      ],
+      "constant": [
+        "./dist/constant/index.d.cts"
+      ],
+      "vite-plugin": [
+        "./dist/vite-plugin/index.d.cts"
+      ],
+      "webpack-plugin": [
+        "./dist/webpack-plugin/index.d.cts"
+      ]
+    }
+  },
   "files": [
     "./dist"
   ],