npm 包 @velma/ethereumjs-vm 使用教程

介绍

@velma/ethereumjs-vm 是一个 Ethereum 虚拟机，可以在本地执行智能合约，并提供了一系列的 API，方便开发者在 dApp 中使用。该 npm 包基于 EthereumJS 实现，支持 EVM 和 eWASM。

安装

使用 npm 或 yarn 安装：

--- ------- --------------------

或者

---- --- --------------------

快速上手

可以使用以下代码在本地创建一个简单的智能合约：

----- - --- --- - - --------------------------------
----- ------ - ------------------

----- ---- - -----------------------------
----- ------------ - - -------- ------ ------ ----- --
----- -- - --- ---- ---------------- ---- ---

---------- ----- --------- ---------- -- ------------- ----- ---- -- -
  --------------------

  ----------------------------------------
  -- ------- ----------------------------------------------------------------
  ---------------------------------------
  -- ------- -
---

在上述代码中，我们首先引入了 VM 和 abi，它们都是 @velma/ethereumjs-vm 中的常用 API。然后我们定义了一个 code 和一个 initialState，并创建了一个 VM 实例。

接着我们使用 runTx 方法执行了一个交易，该交易的 code 是上面定义的 code，gasLimit 是指定的 gas 上限，initialState 是账户的状态。

如果执行成功，我们就可以通过 res.return 获取返回值，并通过 res.vm.gasUsed 获取使用的 gas 量。

API

VM

VM 是 @velma/ethereumjs-vm 的主要 API，可以用于在本地执行智能合约。VM 有以下重要方法：

runTx

用于执行交易。

------------ ------------- ---------

参数：

  • tx：Object，表示待执行的交易。交易包含以下属性：
    • to：String，表示接收地址，可选。
    • from：String，表示发送地址。
    • value：String，表示发送的 ETH 数量，可选。
    • gasPrice：String，表示 gas 价格。
    • gasLimit：String，表示 gas 上限。
    • nonce：String，表示 nonce，可选。
    • data：String，表示待执行的合约代码，可选。
  • initialState：Object，表示合约的初始状态。对象包含以下属性：
    • balance：String，表示 ETH 余额。
    • nonce：String，表示 nonce。
    • code：String，表示智能合约的代码，可选。
  • callback：Function，用于接收执行结果的回调函数。

runCall

用于执行一个合约，并返回输出值。

-------------- ------------ ---------

参数：

  • tx：Object，表示待执行的交易。交易包含以下属性：
    • to：String，表示接收地址。
    • from：String，表示发送地址。
    • value：String，表示发送的 ETH 数量，可选。
    • gasPrice：String，表示 gas 价格。
    • gasLimit：String，表示 gas 上限。
    • nonce：String，表示 nonce，可选。
    • data：String，表示待执行的合约代码，可选。
  • blockNumber：Number，表示区块号。
  • callback：Function，用于接收执行结果的回调函数。

abi

abi 用于处理智能合约的 ABI（Application Binary Interface）。ABI 是智能合约的接口，包含了合约地址、函数名和参数列表等信息。通过 ABI 我们可以与智能合约进行交互。在 @velma/ethereumjs-vm 中，我们可以使用 abi 的 encodeFunctionCall 方法编码函数调用，或使用 decodeCall 方法解码函数返回值。

encodeFunctionCall

用于编码函数调用，返回使用 ABI 编码后的数据。

------------------------------------- -----

参数：

  • jsonInterface：Object，表示函数的 ABI。
  • args：Array，表示函数的参数列表。

例如，对于以下合约：

-------- ------------- -
  ---- ------ -----

  -------- -------- -- ------ -
    ---- - --
  -

  -------- ----- ------ ---- ------- ------ -
    ------ -----
  -
-

我们可以使用以下代码编码调用 set 函数：

----- ----------- - -
  --------- ------
  ------- -- ----- ---- ----- --------- ---
  ----- ------
  -------- ---
  -------- ------
  ---------------- -------------
  ----- -----------
--

----- ---------- - ----

----- ------------ - ----------------------------------- --------------

--------------------------
-- ------- -------------------------------------------------------------------------

decodeCall

用于解码函数返回值，返回解码后的数据。

--------------------------------------- -------

参数：

  • jsonInterface：Object，表示函数的 ABI。
  • output：String，表示函数的返回值。

例如，对于以下合约：

-------- ------------- -
  ---- ------ -----

  -------- -------- -- ------ -
    ---- - --
  -

  -------- ----- ------ ---- ------- ------ -
    ------ -----
  -
-

我们可以使用以下代码解码调用 get 函数的返回值：

----- ----------- - -
  --------- -----
  ------- ---
  ----- ------
  -------- -- ----- --- ----- --------- ---
  -------- ------
  ---------------- -------
  ----- -----------
--

----- ----------- - ---------------------------------------------------------------------

----- ------------ - ------------------------------------- -------------

--------------------------
-- ------- - ----- -

示例代码

下面是一个完整的使用 @velma/ethereumjs-vm 的示例代码，该代码使用 JavaScript 定义了一个简单的 ERC20 智能合约。

----- - --- --- - - --------------------------------
----- ------ - ------------------

----- ------------- - -
  -
    ----- -----------
    ------- -
      - ----- ---------- ----- ----- --
      - ----- ---------- ----- -------- --
    --
    -------- -- ----- ------- ----- -- ---
  --
  -
    ----- ------------
    ------- -- ----- ---------- ----- -------- ---
    -------- -- ----- ---------- ----- --------- ---
  --
--

----- ------------ - -
------ -------- -------

-------- ----------- -
    ------- -------- -- ----- ---------

    -------- ---------------- ---- ------- ------- ------ ------- ----- -------- -
        ---------------------------- -- ------- ---- ------ ----------
        -------------------- -- -------
        ------------- -- -------
        ------ -----
    -

    -------- ----------------- ------- ------ ---- ------- -------- -------- -
        ------ -----------------
    -
-
--
----- -------------- - ---------------
----- -------------- - -
  -------- ---------------
  ------ ------
  ----- -------------
--

----------------------- -- -- -
  --- ---
  --- --------
  --- ---------

  ------------- -- -
    -- - --- ---- ---------------- ---- ---

    -------- - -------------------------------

    ------- - -----------------
  ---

  ---------- ------ ------- --------- ---- -- -
    -----------
      -
        --- --------
        ----- ---------------------------------------- -----------
      --
      ---------
      ----- ----- -- -
        --------------------

        ----- ------- - ------------------------------------------ -------------

        ------------------------------ ----------------

        -------
      --
    --
  ---

  ---------- -------- -------- ---- -- -
    ----- ---------------- - ---------

    ---------
      -
        --- --------
        ----- ---------------------------------------- -
          --------
          ---------------------------
        ---
        --------- -----------
        --------- -------
        ------ -------
      --
      ---------------
      ----- ----- -- -
        --------------------

        -----------
          -
            --- --------
            ----- ---------------------------------------- -----------
          --
          ---------
          ----- ----- -- -
            --------------------

            ----- ------- - ------------------------------------------ -------------

            ------------------------------ ------------------------- - ----------------------------------------

            -------
          --
        --
      --
    --
  ---
---

上面的代码中，我们首先引入了 VM 和 abi，然后定义了一个 ERC20 合约的 ABI 和合约代码。接着我们创建了一个 VM 实例，并使用 VM 的 compileScript 方法编译了合约代码，然后获取了合约地址。

我们通过两个测试用例展示了如何调用合约的函数。第一个测试用例调用了 balanceOf 函数，以获取账户余额。第二个测试用例调用了 transfer 函数，以转移账户余额。

总结

@velma/ethereumjs-vm 是一个非常有用的 npm 包，可以帮助前端开发者在本地运行智能合约，提高了合约的开发效率。本文通过一个简单的 ERC20 合约示例，较详细地介绍了 @velma/ethereumjs-vm 的使用方法和 API，希望对大家学习或开发智能合约有所帮助。

来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/60065f7a238a385564ab69e9

阅读全文

猜你喜欢

  • npm 包 @libshin/in-viewport 使用教程

    在前端开发中，我们经常需要对元素是否出现在视口中进行判断，例如需要实现滚动无限加载、懒加载等功能。为了方便开发，很多开发者会选择使用封装好的 npm 包来实现相关功能，@libshin/in-view...

    3 年前
  • npm 包 dizmo-function 使用教程

    简介 dizmo-function 是一种基于 npm 的 JavaScript 函数库，它提供了许多有用的函数，包括字符串处理、数学函数、类型检查、数组操作等等。

    3 年前
  • npm 包 sails-hook-forms 使用教程

    npm 包 sails-hook-forms 使用教程 前端开发中，表单的处理是至关重要的一环。要实现良好的表单交互效果，需要借助各种工具。其中一个优秀的工具是 sails-hook-forms 。

    3 年前
  • NPM包zinko-riot的使用教程

    在前端开发中，我们经常需要使用各种工具来简化我们的开发流程并提高我们的工作效率。NPM是一个非常常见的工具，它是一个JavaScript的包管理器，用于安装、更新和管理JavaScript库和工具包。

    3 年前
  • npm 包 asciidoc-blocks-check 使用教程

    简介 asciidoc-blocks-check 是一个功能强大的 npm 包，它可以帮助前端工程师进行 Asciidoc 文件中代码块的检查工作，帮助发现潜在的问题，提高代码的健壮性和可维护性。

    3 年前
  • npm 包 bearcat-es6-x 使用教程

    npm 包 bearcat-es6-x 是一个基于 Bearcat 框架的 ES6 版本，它提供了一系列的优化和改进，使得使用起来更加便捷和高效。在这篇文章中，我们将详细介绍如何使用 bearcat-...

    3 年前
  • npm 包 material-ui-arabic-datepicker 使用教程

    material-ui-arabic-datepicker 是一款基于 React 和 Material-UI 的阿拉伯语日期选择器组件。该组件具有简单易用、良好的可定制性和样式美观等特点，适用于需要...

    3 年前
  • npm 包 smoench-auth 使用教程

    介绍 smonch-auth 是一个基于 Node.js 平台的 npm 包，它为开发者提供了一种简单、安全、易扩展的身份认证解决方案。它使用 JSON Web Token（JWT）作为身份认证的方式...

    3 年前
  • NPM 包 Worker-run 使用教程

    在前端开发中，我们常常需要处理复杂的计算任务，而这些计算任务又需要长时间运行。这就会导致主线程被阻塞，影响用户体验。为此，我们需要使用多线程的技术来解决这个问题。在 Node.js 中，我们可以借助 ...

    3 年前
  • npm 包 hydraded-ws 使用教程

    什么是 hydrated-ws hydraded-ws 是一个基于 WebSocket 的 JavaScript 库，旨在提供高效、灵活和易用的双向通信解决方案。它支持浏览器和 Node.js 环境，...

    3 年前
  • npm 包 @moondef/utils 使用教程

    在前端开发中，我们经常需要使用一些工具函数来处理数据或者进行一些辅助功能的实现。而 @moondef/utils 这个 npm 包就是一个出色的工具包，提供了多个实用的函数，可以方便地用来增强我们的前...

    3 年前
  • npm 包 react-stateful-component 使用教程

    在 React 中，组件可以是有状态和无状态的。有状态组件可以使用 state 属性来保存和修改组件的状态。然而，为了创建一个有状态组件需要大量的代码，这并不方便。

    3 年前
  • npm 包 tailwindcss-fout-size 使用教程

    在现代网页设计中，选择合适的字体大小非常重要。然而，在设计过程中，对于字体大小的选择还需要考虑 FOUT（Flash of Unstyled Text，即未渲染文本内容的瞬间） 的问题。

    3 年前
  • npm 包 chuank 使用教程

    介绍 chuank 是一个基于 webpack 打包的 Vue.js 组件库，它主要包含一些常用的 UI 组件和工具函数，例如按钮组件、表单组件、分页组件、数据处理工具等。

    3 年前
  • npm 包 derek 使用教程

    介绍 npm 是前端领域中管理包和依赖的利器，derek 是一款用于检查提交信息是否满足规范的 npm 包，其具有灵活性和易扩展性，被广泛应用于开源社区及企业内部项目中。

    3 年前
  • npm 包 nuke-axios 使用教程

    在前端开发中，我们经常需要发送 AJAX 请求来获取数据。而 axios 作为现在比较流行的 AJAX 库，可以方便地发送请求和处理响应。不过，在真正使用 axios 发送请求之前，我们还需要进行一系...

    3 年前
  • npm 包 ros2-actionlibjs 使用教程

    ros2-actionlibjs 是一个基于 Node.js 的 npm 包，它提供了一个简单的操作 ROS 2 Actionlib 服务的 API，使得使用者可以轻松地在前端界面中实现与后端 ROS...

    3 年前
  • npm 包 url-constrictor 使用教程

    在前端开发中，web 应用经常需要操作 url，例如获取参数、修改参数等。这些操作可以手动编写代码实现，但是 npm 上有很多优秀的库可以帮助我们更方便快捷地操作 url，其中 url-constri...

    3 年前
  • NPM 包 Reason-Maybe 的使用教程

    简介 Reason-Maybe 是一个通过类型约束实现类似 Haskell 的 Maybe Monad 的 NPM 包。在函数式编程中，Maybe Monad 用于处理那些可能为空值的数据。

    3 年前
  • npm 包 @ermakovich/gulp-cucumber 使用教程

    前言 在现代 Web 应用开发过程中，前端自动化构建和测试已经成为开发流程不可或缺的一部分。在自动化构建和测试的过程中，使用 Gulp 构建任务和 Cucumber.js 进行测试已经成为了许多前端开...

    3 年前

相关推荐

    暂无文章