@locuschain/lib 0.1.31 → 0.1.33

package/dist/constant/index.esm.js

@@ -0,0 +1,451 @@
+import { A as AddressClass$1 } from '../chunks/address-class-CHAZYhdZ.js';
+import { T as TxType$1 } from '../chunks/tx-type-BPkhMGad.js';
+
+// Automatically generated file. DO NOT EDIT.
+const CurrencyUnit = Object.freeze({
+    Exa: 6,
+    Peta: 5,
+    Tera: 4,
+    Giga: 3,
+    Mega: 2,
+    Kilo: 1,
+    Locus: 0,
+    Milli: -1,
+    Micro: -2,
+    Nano: -3,
+    Pico: -4,
+    Femto: -5,
+    Ato: -6,
+});
+
+// Automatically generated file. DO NOT EDIT.
+const TxTypes$1 = {
+    "TX_ACCEPT_SCRIPT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACCEPT_SCRIPT_AFTER_TIMELOCK": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_ALL_ASSETS": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_ASSETOBJECT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_CALL_CONTRACT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_COIN": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_CONTRACT_RESULT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_CONTRACT_REWARD": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_CONTRACT_TRANSFER": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_DATA_SA": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_FOUNDATION_RESERVE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_INCENTIVE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_LOCK_STAKE_FOR_VME": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_OPEN_CONTRACT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_OPEN_SA": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_OPEN_VME": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_ACTIVATE_TOKEN": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_BECOME_GUEST": {
+        "fee": "100000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_BECOME_HOST": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_BURN_ASSETOBJECT": {
+        "fee": "1000000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_BURN_TOKEN": {
+        "fee": "1000000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_CALL_CONTRACT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_CALL_CONTRACT_FEE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_CHANGE_FOUNDATION_ACCOUNT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_CHANGE_KEYPAIR": {
+        "fee": "100000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_CHANGE_VKEY": {
+        "fee": "100000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_CLOSE_ACCOUNT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_CONTRACT_BLANK_REWARD": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_CONTRACT_TRANSFER_REWARD": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_CREATE_ASSETOBJECT": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_CREATE_ASSETOBJECT_FEE": {
+        "fee": "1000000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_CREATE_CONTRACT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_CREATE_CONTRACT_FEE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_CREATE_SA": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_CREATE_SA_FEE": {
+        "fee": "1000000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_CREATE_TOKEN": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_CREATE_TOKEN_FEE": {
+        "fee": "1000000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_CREATE_VME": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_FINALIZE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_FREEZE_ACCOUNT": {
+        "fee": "100000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_GENESIS_ACCOUNT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_LEAD_VTX": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_LOCK_STAKE_FOR_VME": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_OPEN_ACCOUNT": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_POST_DATA": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_POST_DATA_FEE": {
+        "fee": "0",
+        "grant": 0,
+        "sizeBased": true,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_POST_DATA_SA": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_POST_DATA_SA_FEE": {
+        "fee": "0",
+        "grant": 0,
+        "sizeBased": true,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_PROVIDE_SCRIPT": {
+        "fee": "0",
+        "grant": 0,
+        "sizeBased": true,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_REVOKE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_TRANSFER_ASSETOBJECT": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_TRANSFER_ASSETOBJECT_FEE": {
+        "fee": "20000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_TRANSFER_COIN": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_TRANSFER_COIN_EXPRESS": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_TRANSFER_COIN_FEE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_TRANSFER_TOKEN": {
+        "fee": "10000000000000",
+        "grant": 1000,
+        "sizeBased": false,
+        "useGrant": true,
+        "useFee": false
+    },
+    "TX_TRANSFER_TOKEN_FEE": {
+        "fee": "0",
+        "grant": 0,
+        "sizeBased": true,
+        "useGrant": false,
+        "useFee": true
+    },
+    "TX_UNLOCK_STAKE": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    },
+    "TX_VME_BLOCK": {
+        "fee": "10000000000000",
+        "grant": 0,
+        "sizeBased": false,
+        "useGrant": false,
+        "useFee": false
+    }
+};
+
+// Automatically generated file. DO NOT EDIT.
+const MaxVMRewardsCount = 10;
+const GRANT_COST_PER_TX = 1000;
+
+const TxTypes = TxTypes$1;
+const TxType = TxType$1;
+const Currency = CurrencyUnit;
+const AddressClass = AddressClass$1;
+const FeeType = Object.freeze({
+    AUTO: 0,
+    GRANT_ONLY: 1
+});
+
+export { AddressClass, Currency, FeeType, GRANT_COST_PER_TX, MaxVMRewardsCount, TxType, TxTypes };

package/dist/contracts/abis/erc20.d.mts

@@ -0,0 +1,174 @@
+/**
+ * getContract({ abi: erc20Abi, ... }) 에서 쓰는 최소 ERC-20 ABI.
+ * 기존 on-chain 컨트랙트와 그대로 매칭되도록 legacy support/erc20-helper/
+ * erc20.mts 의 정의를 변경 없이 그대로 옮겨왔다.
+ */
+export declare const erc20Abi: readonly [{
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "name";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_spender";
+        readonly type: "address";
+    }, {
+        readonly name: "_value";
+        readonly type: "uint256";
+    }];
+    readonly name: "approve";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "totalSupply";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_from";
+        readonly type: "address";
+    }, {
+        readonly name: "_to";
+        readonly type: "address";
+    }, {
+        readonly name: "_value";
+        readonly type: "uint256";
+    }];
+    readonly name: "transferFrom";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "decimals";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "_owner";
+        readonly type: "address";
+    }];
+    readonly name: "balanceOf";
+    readonly outputs: readonly [{
+        readonly name: "balance";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "symbol";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_to";
+        readonly type: "address";
+    }, {
+        readonly name: "_value";
+        readonly type: "uint256";
+    }];
+    readonly name: "transfer";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "_owner";
+        readonly type: "address";
+    }, {
+        readonly name: "_spender";
+        readonly type: "address";
+    }];
+    readonly name: "allowance";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly payable: true;
+    readonly stateMutability: "payable";
+    readonly type: "fallback";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Approval";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Transfer";
+    readonly type: "event";
+}];
+export type Erc20Abi = typeof erc20Abi;

package/dist/contracts/abis/index.d.mts

@@ -0,0 +1 @@
+export * from './erc20.mjs';

package/dist/contracts/getContract.d.mts

@@ -0,0 +1,33 @@
+import type { Client } from '../clients/types.mjs';
+import type { Address } from '../types/primitives.mjs';
+export type InterfaceAbi = ReadonlyArray<Record<string, unknown>> | string | readonly string[];
+export type ReadCallOptions = {
+    /** view 호출의 주체 account. 기본값은 client.account?.address (있으면) 또는 컨트랙트 주소. */
+    caller?: Address;
+    amount?: string;
+    fuelLimit?: string;
+};
+export type GetContractArgs = {
+    address: Address;
+    abi: InterfaceAbi;
+    client: Client;
+};
+export type ContractReadFn = (args?: readonly unknown[], opts?: ReadCallOptions) => Promise<unknown>;
+export type ContractInstance = {
+    address: Address;
+    abi: InterfaceAbi;
+    read: Record<string, ContractReadFn>;
+};
+/**
+ * Locus 의 debug_viewContract RPC 위에 viem 스타일 컨트랙트 핸들을 만든다.
+ * `read.<fn>` 은 ethers(v5) 의 Interface 로 호출을 인코딩하고, 결과 바이트를
+ * convertHexToData 로 Locus `func` 필드에 담아 보낸 뒤, 응답 hex 를
+ * Interface.decodeFunctionResult 로 다시 디코딩한다.
+ *
+ * write 메서드는 이번 단계에서는 의도적으로 빠져 있다. 상태를 바꾸는 호출
+ * 은 생성된 wallet action 을 직접 사용한다:
+ *
+ *   import { callContract } from '@locuschain/lib/autogen';
+ *   await wallet.extend(debugWalletActions).callContract({ ... });
+ */
+export declare function getContract(args: GetContractArgs): ContractInstance;