以太坊从零到略懂5:Truffle 快速入门体验智能合约
安装Truffle
在你可以使用 Truffle 之前,你必须使用 npm 安装它。打开终端并使用以下命令进行全局安装。
npm install -g truffle
注意:我们建议您将 npm 与 nvm 之类的节点版本管理器一起使用,这实际上是 npm 本身所推荐的。请参阅npm 的这篇文章,了解如何使用节点版本管理器安装 npm。我们还建议不要sudo
在安装 Truffle 时使用,因为许多用户在这样做后会报告权限错误。
创建项目
要使用大多数 Truffle 命令,您需要针对现有的 Truffle 项目运行它们。所以第一步是创建一个 Truffle 项目。
您可以创建一个裸项目模板,但对于那些刚刚开始的人,您可以使用Truffle Boxes,它们是示例应用程序和项目模板。我们将使用MetaCoin box,它创建一个可以在账户之间转移的代币:
- 为您的 Truffle 项目创建一个新目录:
mkdir MetaCoin
cd MetaCoin
- 下载(“拆箱”)MetaCoin 盒子:
truffle unbox metacoin
注意:您可以使用该truffle unbox <box-name>
命令下载任何其他Truffle盒。
注意:要创建不包含智能合约的裸 Truffle 项目,请使用truffle init
.
完成此操作后,您现在将拥有一个包含以下项目的项目结构:
contracts/
: Solidity 合约目录migrations/
:可编写脚本的部署文件的目录test/
: 用于测试应用程序和合约的测试文件目录truffle.js
: Truffle配置文件
探索项目
注意:此页面只是一个快速入门,因此我们不会在这里详细介绍。请参阅 Truffle 文档的其余部分以了解更多信息。
contracts/MetaCoin.sol
在文本编辑器中打开文件。这是一个创建 MetaCoin 代币的智能合约(用 Solidity 编写)。请注意,这也引用contracts/ConvertLib.sol
了同一目录中的另一个 Solidity 文件。- 打开
contracts/Migrations.sol
文件。这是一个单独的 Solidity 文件,用于管理和更新您部署的智能合约的状态。该文件随每个 Truffle 项目一起提供,通常不进行编辑。 - 打开
migrations/1_initial_migration.js
文件。该文件是在文件中Migrations
找到的合约的迁移(部署)脚本Migrations.sol
。 - 打开
migrations/2_deploy_contracts.js
文件。该文件是MetaCoin
合约的迁移脚本。(迁移脚本是按顺序运行的,所以以 . 开头的文件2
会在以1
. 开头的文件之后运行) - 打开
test/TestMetaCoin.sol
文件。这是一个用 Solidity 编写的测试文件,可确保您的合约按预期工作。 - 打开
test/metacoin.js
文件。这是一个用 JavaScript 编写的测试文件,它执行与上面的 Solidity 测试类似的功能。 - 打开
truffle-config.js
文件。这是 Truffle配置文件,用于设置网络信息和其他与项目相关的设置。该文件是空白的,但这没关系,因为我们将使用具有一些内置默认值的 Truffle 命令。
测试
- 在终端中,运行 Solidity 测试:
truffle test ./test/TestMetaCoin.sol
您将看到以下输出:
TestMetacoin
√ testInitialBalanceUsingDeployedContract (71ms)
√ testInitialBalanceWithNewMetaCoin (59ms)
2 passing (794ms)
注意:如果您在 Windows 上运行此命令时遇到问题,请参阅解决 Windows 上的命名冲突的文档。
这两个测试是根据合同运行的,并显示了测试应该做什么的描述。
- 运行 JavaScript 测试:
truffle test ./test/metacoin.js
您将看到以下输出:
Contract: MetaCoin
√ should put 10000 MetaCoin in the first account
√ should call a function that depends on a linked library (40ms)
√ should send coin correctly (129ms)
3 passing (255ms)
编译
- 编译智能合约:
truffle compile
您将看到以下输出:
Compiling .\contracts\ConvertLib.sol...
Compiling .\contracts\MetaCoin.sol...
Compiling .\contracts\Migrations.sol...
Writing artifacts to .\build\contracts
使用 Truffle Develop 迁移
注意:要使用Ganache,请跳到下一节。
要部署我们的智能合约,我们需要连接到区块链。Truffle 有一个内置的个人区块链,可用于测试。该区块链位于您的系统本地,不与以太坊主网络交互。
您可以使用Truffle Develop创建此区块链并与之交互。
- 运行Truffle开发:
truffle develop
您将看到以下信息:
Truffle Develop started at http://127.0.0.1:9545/
Accounts:
(0) 0x627306090abab3a6e1400e9345bc60c78a8bef57
(1) 0xf17f52151ebef6c7334fad080c5704d77216b732
(2) 0xc5fdf4076b8f3a5357c5e395ab970b5b54098fef
(3) 0x821aea9a577a9b44299b9c15c88cf3087f3b5544
(4) 0x0d1d4e623d10f9fba5db95830f7d3839406c6af2
(5) 0x2932b7a2355d6fecc4b5c0b6bd44cc31df247a2e
(6) 0x2191ef87e392377ec08e7c08eb105ef5448eced5
(7) 0x0f4f2ac550a1b4e2280d04c21cea7ebd822934b5
(8) 0x6330a553fc93768f612722bb8c2ec78ac90b3bbc
(9) 0x5aeda56215b167893e80b4fe645ba6d5bab767de
Private Keys:
(0) c87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3
(1) ae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f
(2) 0dbbe8e4ae425a6d2687f1a7e3ba17bc98c673636790f1b8ad91193c05875ef1
(3) c88b703fb08cbea894b6aeff5a544fb92e78a18e19814cd85da83b71f772aa6c
(4) 388c684f0ba1ef5017716adb5d21a053ea8e90277d0868337519f97bede61418
(5) 659cbb0e2411a44db63778987b1e22153c086a95eb6b18bdf89de078917abc63
(6) 82d052c865f5763aad42add438569276c00d3d88a2d062d36b2bae914d58b8c8
(7) aa3680d5d48a8283413f7a108367c7299ca73f553735860a87b08f39395618b7
(8) 0f62d96d6675f32685bbdb8ac13cda7c23436f63efbb9d07700d8669ff12b7c4
(9) 8d5366123cb560bb606379f90a0bfd4769eecc0557f1b362dcae9012b548b1e5
Mnemonic: candy maple cake sugar pudding cream honey rich smooth crumble sweet treat
⚠️ Important ⚠️ : This mnemonic was created for you by Truffle. It is not secure.
Ensure you do not use it on production blockchains, or else you risk losing funds.
truffle(development)>
这显示了与区块链交互时可以使用的十个帐户(及其私钥)。
- 在 Truffle Develop 提示符下,可以通过省略
truffle
前缀来运行 Truffle 命令。例如,要truffle compile
在提示符下运行,请键入compile
。将已编译的合约部署到区块链的命令是truffle migrate
,因此在提示符处键入:
migrate
您将看到以下输出:
Starting migrations...
======================
> Network name: 'develop'
> Network id: 4447
> Block gas limit: 6721975
1_initial_migration.js
======================
Deploying 'Migrations'
----------------------
> transaction hash: 0x3fd222279dad48583a3320decd0a2d12e82e728ba9a0f19bdaaff98c72a030a2
> Blocks: 0 Seconds: 0
> contract address: 0xa0AdaB6E829C818d50c75F17CFCc2e15bfd55a63
> account: 0x627306090abab3a6e1400e9345bc60c78a8bef57
> balance: 99.99445076
> gas used: 277462
> gas price: 20 gwei
> value sent: 0 ETH
> total cost: 0.00554924 ETH
> Saving migration to chain.
> Saving artifacts
-------------------------------------
> Total cost: 0.00554924 ETH
2_deploy_contracts.js
=====================
Deploying 'ConvertLib'
----------------------
> transaction hash: 0x97e8168f1c05fc40dd8ffc529b9a2bf45cc7c55b07b6b9a5a22173235ee247b6
> Blocks: 0 Seconds: 0
> contract address: 0xfb39FeaeF3ac3fd46e2123768e559BCe6bD638d6
> account: 0x627306090abab3a6e1400e9345bc60c78a8bef57
> balance: 99.9914458
> gas used: 108240
> gas price: 20 gwei
> value sent: 0 ETH
> total cost: 0.0021648 ETH
Linking
-------
* Contract: MetaCoin <--> Library: ConvertLib (at address: 0xfb39FeaeF3ac3fd46e2123768e559BCe6bD638d6)
Deploying 'MetaCoin'
--------------------
> transaction hash: 0xee4994097c10e7314cc83adf899d67f51f22e08b920e95b6d3f75c5eb498bde4
> Blocks: 0 Seconds: 0
> contract address: 0x6891Ac4E2EF3dA9bc88C96fEDbC9eA4d6D88F768
> account: 0x627306090abab3a6e1400e9345bc60c78a8bef57
> balance: 99.98449716
> gas used: 347432
> gas price: 20 gwei
> value sent: 0 ETH
> total cost: 0.00694864 ETH
> Saving migration to chain.
> Saving artifacts
-------------------------------------
> Total cost: 0.00911344 ETH
Summary
=======
> Total deployments: 3
> Final cost: 0.01466268 ETH
这显示了已部署合约的交易 ID 和地址。它还包括成本汇总和实时状态更新。
注意:您的交易哈希、合约地址和账户将与上述不同。
注意:要查看如何与合约交互,请跳到下一节。
替代方案:使用 Ganache 迁移
虽然 Truffle Develop 是一个一体化的个人区块链和控制台,但您也可以使用桌面应用程序Ganache来启动您的个人区块链。对于那些刚接触以太坊和区块链的人来说,Ganache 可能是一个更易于理解的工具,因为它预先显示了更多信息。
除了运行 Ganache 之外,唯一的额外步骤是它需要编辑 Truffle 配置文件以指向 Ganache 实例。
- 下载并安装Ganache。
truffle-config.js
在文本编辑器中打开。将内容替换为以下内容:
module.exports = {
networks: {
development: {
host: "127.0.0.1",
port: 7545,
network_id: "*"
}
}
};
这将允许使用 Ganache 的默认连接参数进行连接。
- 保存并关闭该文件。
- 启动甘纳许。
伽纳彻
- 在终端上,将合约迁移到 Ganache 创建的区块链:
truffle migrate
您将看到以下输出:
Compiling your contracts...
===========================
> Compiling ./contracts/ConvertLib.sol
> Compiling ./contracts/MetaCoin.sol
> Compiling ./contracts/Migrations.sol
> Artifacts written to /home/david/work/MetaCoin/build/contracts
> Compiled successfully using:
- solc: 0.5.16+commit.9c3226ce.Emscripten.clang
Starting migrations...
======================
> Network name: 'development'
> Network id: 5777
> Block gas limit: 6721975 (0x6691b7)
1_initial_migration.js
======================
Deploying 'Migrations'
----------------------
> transaction hash: 0x3eef05e35ce694c0b7112cc22ba462b9cc0563abc2cc444ee9683b6d89865e3c
> Blocks: 0 Seconds: 0
> contract address: 0x8CdaF0CD259887258Bc13a92C0a6dA92698644C0
> block number: 1
> block timestamp: 1587421933
> account: 0x627306090abaB3A6e1400e9345bC60c78a8BEf57
> balance: 99.9967165
> gas used: 164175 (0x2814f)
> gas price: 20 gwei
> value sent: 0 ETH
> total cost: 0.0032835 ETH
> Saving migration to chain.
> Saving artifacts
-------------------------------------
> Total cost: 0.0032835 ETH
2_deploy_contracts.js
=====================
Deploying 'ConvertLib'
----------------------
> transaction hash: 0x23de020bafa41e30615b1d775d2fa9604e876415408e012d1f0faf79eed3a32f
> Blocks: 0 Seconds: 0
> contract address: 0x345cA3e014Aaf5dcA488057592ee47305D9B3e10
> block number: 3
> block timestamp: 1587421933
> account: 0x627306090abaB3A6e1400e9345bC60c78a8BEf57
> balance: 99.99396028
> gas used: 95470 (0x174ee)
> gas price: 20 gwei
> value sent: 0 ETH
> total cost: 0.0019094 ETH
Linking
-------
* Contract: MetaCoin <--> Library: ConvertLib (at address: 0x345cA3e014Aaf5dcA488057592ee47305D9B3e10)
Deploying 'MetaCoin'
--------------------
> transaction hash: 0x0cc20353422c4d435f72e8e7850f8178f43bf8d00c8c0d09cc8e0ccdfa81b799
> Blocks: 0 Seconds: 0
> contract address: 0xf25186B5081Ff5cE73482AD761DB0eB0d25abfBF
> block number: 4
> block timestamp: 1587421934
> account: 0x627306090abaB3A6e1400e9345bC60c78a8BEf57
> balance: 99.98822922
> gas used: 286553 (0x45f59)
> gas price: 20 gwei
> value sent: 0 ETH
> total cost: 0.00573106 ETH
> Saving migration to chain.
> Saving artifacts
-------------------------------------
> Total cost: 0.00764046 ETH
Summary
=======
> Total deployments: 3
> Final cost: 0.01092396 ETH
这显示了已部署合约的交易 ID 和地址。它还包括成本汇总和实时状态更新。
注意:您的交易 ID 和合约地址可能与上述不同。
- 在 Ganache 中,单击“事务”按钮以查看事务已被处理。
- 要与合约交互,您可以使用 Truffle 控制台。Truffle 控制台类似于 Truffle Develop,除了它连接到现有的区块链(在本例中,是由 Ganache 生成的区块链)。
truffle console
您将看到以下提示:
truffle(development)>
与合约互动
通过以下方式使用控制台与合约交互:
注意:我们web3.eth.getAccounts()
在这些示例中使用,它返回一个 Promise,它解析为由助记符生成的所有帐户的数组。所以,给定上面我们的助记符生成的地址,指定(await web3.eth.getAccounts())[0]
就等同于地址0x627306090abab3a6e1400e9345bc60c78a8bef57
。
从 Truffle v5 开始,控制台支持 async/await 功能,从而可以与合约进行更简单的交互。
- 首先建立部署的 MetaCoin 合约实例和由 Truffle 的内置区块链或 Ganache 创建的帐户:
truffle(development)> let instance = await MetaCoin.deployed()
truffle(development)> let accounts = await web3.eth.getAccounts()
- 检查部署合约账户的元币余额:
truffle(development)> let balance = await instance.getBalance(accounts[0])
truffle(development)> balance.toNumber()
- 查看该余额值多少以太币(并注意合约将元币定义为价值 2 以太币):
truffle(development)> let ether = await instance.getBalanceInEth(accounts[0])
truffle(development)> ether.toNumber()
- 将一些元币从一个账户转移到另一个账户:
truffle(development)> instance.sendCoin(accounts[1], 500)
- 查看收到元币的账户余额:
truffle(development)> let received = await instance.getBalance(accounts[1])
truffle(development)> received.toNumber()
- 检查发送元币的账户余额:
truffle(development)> let newBalance = await instance.getBalance(accounts[0])
truffle(development)> newBalance.toNumber()
- 原文作者:知识铺
- 原文链接:https://geek.zshipu.com/post/web3.0/%E4%BB%A5%E5%A4%AA%E5%9D%8A%E4%BB%8E%E9%9B%B6%E5%88%B0%E7%95%A5%E6%87%825Truffle-%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8%E4%BD%93%E9%AA%8C%E6%99%BA%E8%83%BD%E5%90%88%E7%BA%A6/
- 版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议进行许可,非商业转载请注明出处(作者,原文链接),商业转载请联系作者获得授权。
- 免责声明:本页面内容均来源于站内编辑发布,部分信息来源互联网,并不意味着本站赞同其观点或者证实其内容的真实性,如涉及版权等问题,请立即联系客服进行更改或删除,保证您的合法权益。转载请注明来源,欢迎对文章中的引用来源进行考证,欢迎指出任何有错误或不够清晰的表达。也可以邮件至 sblig@126.com