{"owner":"AmazingAng","repo":"WTF-Solidity","hasSkills":true,"totalSkillsCount":86,"totalTokensCount":82021,"categories":["plugin-manifest","anthropic-skill"],"hasMcp":false,"mcpConfig":null,"found":["Topics/Tools/TOOL05_Dune/readme.md","Topics/Tools/TOOL02_Infura/readme.md","Topics/Tools/TOOL04_Alchemy/readme.md","Topics/Tools/TOOL01_Remix/readme.md","Topics/Tools/TOOL03_Ganache/readme.md","Topics/Onchain_debug/01_tools/readme.md","Topics/Tools/TOOL07_Foundry/readme.md","Topics/Tools/TOOL06_Hardhat/package.json","Topics/Tools/TOOL06_Hardhat/readme.md","Topics/Tools/TOOL08_ZAN/readme.md","out/extensions/IERC721Metadata.sol/IERC721Metadata.json","Topics/Tools/TOOL06_Hardhat/package-lock.json","Topics/Onchain_debug/01_tools/en/readme.md","Topics/Tools/TOOL07_Foundry/hello_wtf/package-lock.json","Topics/Tools/TOOL07_Foundry/hello_wtf/package.json","Languages/pt-br/Topics/Onchain_debug/01_tools/readme.md","Languages/pt-br/Topics/Tools/TOOL01_Remix/readme.md","Languages/pt-br/Topics/Tools/TOOL02_Infura/readme.md","Languages/pt-br/Topics/Tools/TOOL03_Ganache/readme.md","Languages/pt-br/Topics/Tools/TOOL04_Alchemy/readme.md","Languages/pt-br/Topics/Tools/TOOL05_Dune/readme.md","Languages/pt-br/Topics/Tools/TOOL06_Hardhat/package-lock.json","Languages/pt-br/Topics/Tools/TOOL06_Hardhat/package.json","Languages/pt-br/Topics/Tools/TOOL06_Hardhat/readme.md","Languages/pt-br/Topics/Tools/TOOL07_Foundry/readme.md","Languages/pt-br/Topics/Onchain_debug/01_tools/en/readme.md","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/package-lock.json","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/package.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/forge-std/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/forge-std/package.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/CHANGELOG.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/CODE_OF_CONDUCT.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/CONTRIBUTING.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/FUNDING.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/GUIDELINES.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/RELEASING.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/SECURITY.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/package-lock.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/package.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/renovate.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/slither.config.json","Topics/Tools/TOOL07_Foundry/hello_wtf/broadcast/Counter.s.sol/1/run-1666193264.json","Topics/Tools/TOOL07_Foundry/hello_wtf/broadcast/Counter.s.sol/1/run-1666193265.json","Topics/Tools/TOOL07_Foundry/hello_wtf/broadcast/Counter.s.sol/1/run-latest.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/better-tires-pull.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/blue-jars-lay.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/bright-cooks-brush.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/config.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/curly-pandas-flow.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/flat-flies-hear.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/fruity-coats-smash.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/gentle-apples-dance.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/happy-pants-decide.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/smooth-cows-notice.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/spicy-seals-bake.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/sweet-houses-cheer.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/tangy-jokes-begin.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.changeset/tidy-turkeys-build.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.github/PULL_REQUEST_TEMPLATE.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/audits/2017-03.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/audits/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/contracts/package.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/docs/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/fv/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/test/TESTING.md","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/lib/forge-std/README.md","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/lib/forge-std/package.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.github/ISSUE_TEMPLATE/bug_report.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/.github/ISSUE_TEMPLATE/feature_request.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/erc4626-tests/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/forge-std/CONTRIBUTING.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/forge-std/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/forge-std/RELEASE_CHECKLIST.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/forge-std/package.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/halmos-cheatcodes/README.md","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/scripts/solhint-custom/package.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/scripts/upgradeable/README.md","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/broadcast/Counter.s.sol/1/run-1666193264.json","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/broadcast/Counter.s.sol/1/run-1666193265.json","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/broadcast/Counter.s.sol/1/run-latest.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/forge-std/src/test/fixtures/broadcast.log.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/test/utils/cryptography/ecdsa_secp256r1_sha256_p1363_test.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/forge-std/test/fixtures/broadcast.log.json","Topics/Tools/TOOL07_Foundry/hello_wtf/lib/openzeppelin-contracts/lib/forge-std/test/fixtures/test.json","Languages/pt-br/Topics/Tools/TOOL07_Foundry/hello_wtf/lib/forge-std/src/test/fixtures/broadcast.log.json"],"skills":{"Topics/Tools/TOOL05_Dune/readme.md":"# WTF Solidity极简入门-工具篇5：使用Dune可视化区块链数据 \n\n我最近在重新学 Solidity，巩固一下细节，也写一个“WTF Solidity极简入门”，供小白们使用（编程大佬可以另找教程），每周更新 1-3 讲。\n\n推特：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy_](https://twitter.com/WTFAcademy_)\n\n社区：[Discord](https://discord.gg/5akcruXrsk)｜[微信群](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[官网 wtf.academy](https://wtf.academy)\n\n所有代码和教程开源在 github: [github.com/AmazingAng/WTF-Solidity](https://github.com/AmazingAng/WTF-Solidity)\n\n-----\n## Dune是什么？\n\n\n`Dune`是区块链查询分析工具，每个人可以通过写类sql语言查询区块链上的所有信息，例如巨鲸，链上交易的数据等等。同时`Dune`能便捷的将数据转换为可视化的图表。\n\n> 以太坊是数据库，智能合约是数据表，来自钱包的交易是每个表中的行。\n\n这句话讲出了区块链的精髓：区块链本质上就是公开的存储数据的分布式账本，现在我们可以通过Dune来查询这个分布式账本的数据。\n\n[Dune官网](https://dune.xyz/)\n\n![dune可视化](./img/1.png)\n\n![dune可视化](./img/2.png)\n\n\n## 第一个查询\n\n目标：查询**过去 24 小时在 Uniswap 上购买的 DAI稳定币**\n\n1. 注册登陆Dune。\n2. 点击右上角**new query**新建查询，输入代码：\n\n ```sql\n SELECT\n SUM(token_a_amount) AS dai_bought\n FROM\n dex.\"trades\"\n WHERE\n block_time > now() - interval '24 hours'\n AND token_a_symbol = 'DAI'\n AND project = 'Uniswap';\n ```\n3. 点击右下角的**Run**执行查询，得到最近的24h内通过uniswap购买DAI的数量。\n\n![dune sql query](./img/3.png)\n\n\n## 从0开始构建查询\n\n**目标：学会使用 SELECT, WHERE, LIMIT**\n\n我们查询其中一个表，以aave为例：[aave合约](https://etherscan.io/address/0x398ec7346dcd622edc5ae82352f02be94c62d119#writeProxyContract)\n\n通过查询aave这个合约，它有deposit（存储）这个方法，并且有该事件（事件会在执行的时候广播）。\n\n![etherscan](./img/6.png)\n\n回到Dune查找对应的表，根据在Ethereum上搜索aave相关的表，并对应事件,`LendingPool_evt_Deposit`找到该表。\n\n![dune query db table](./img/13.png)\n\n### 学习：SELECT 、 LIMIT、WHERE查询数据\n\n然后我们通过Dune可以查询对应的存储数据\n\n```sql\nSELECT * FROM aave.\"LendingPool_evt_Deposit\"\nlimit 100\n```\n\n![dune query](./img/7.png)\n\n就可以得到aave合约中存储方法的相应数据，通过这个数据可以做一些筛选\n\n#### 各个字段的意义\n\n_user：发起存款的钱包地址\n\n_reserve：作为抵押品存放的代币地址\n\n_amount：存入的代币数量\n\n_timestamp：交易被挖掘到区块链的时间戳\n\n\n#### 使用 WHERE过滤数据\n\n查询过滤特殊的地址`0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee`\n\n```sql\nSELECT *, (_amount / 1e18) as _amount FROM aave.\"LendingPool_evt_Deposit\"\nWHERE _reserve = '\\xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'\nlimit 100\n```\n\n带上了查询条件，能够快速的筛选我们需要的数据\n\n查看抵押品为USDC，USDC合约地址：`xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48`\n\n```sql\nSELECT * FROM aave.\"LendingPool_evt_Deposit\"\nWHERE _reserve = '\\xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'\nlimit 100\n```\n\n以上案例参考 [Your guide to basic SQL while learning Ethereum at the same time](https://towardsdatascience.com/your-guide-to-basic-sql-while-learning-ethereum-at-the-same-time-9eac17a05929)\n\n### 实践链上转账\n\n\n实践`Ethereum.Transactions`表的转账查询\n\n\n```sql\nselect * from ethereum.transactions\nLIMIT 10\n```\n\n![DUNE面板说明](./img/14.png)\n\n### 字段和转账对应说明\n\n看这个[hash](https://etherscan.io/tx/0xfa69f5eb0218f56ae602ef7f01588d9193a891e6fe7ba7e1c3994075a689bb51)转账 \n\n![image-20220314174346876](./img/16.png)\n\n由[0x22fff189c37302c02635322911c3b64f80ce7203](https://etherscan.io/token/0xdac17f958d2ee523a2206206994597c13d831ec7?a=0x22fff189c37302c02635322911c3b64f80ce7203) 转账到 [0x8aae242452471d2dfea145214ceedf87ca043198](https://etherscan.io/token/0xdac17f958d2ee523a2206206994597c13d831ec7?a=0x8aae242452471d2dfea145214ceedf87ca043198)\n\nhash：`0xfa69f5eb0218f56ae602ef7f01588d9193a891e6fe7ba7e1c3994075a689bb51`\n\n我们可以直接通过dune查到该条信息\n\n```sql\nselect * from ethereum.transactions\nWHERE hash='\\xfa69f5eb0218f56ae602ef7f01588d9193a891e6fe7ba7e1c3994075a689bb51'\n```\n\n![dune-查询](./img/15.png)\n\ndune中的字段，也是和etherscan中一一对应。\n\n\n\n### 数据可视化\n\n![dune query to visualization](./img/11.png)\n\n点击 New visualization 就可以选择你需要的视图，比如我点击 `bar chart`\n\n![dune visualization](./img/12.png)\n\n就会将我刚才筛选的数据可视化。看最长的几根，就是借贷最多的几个账号。\n\n\n\n## 总结\n\n这一讲，我们介绍了Dune的基础用法。通过Dune，我们能够将链上的数据转换为可视化的数据，更好的了解链上热点。\n","Topics/Tools/TOOL02_Infura/readme.md":"# WTF Solidity极简入门-工具篇2：Infura, 连接链下与链上的桥梁\n\n我最近在重新学 Solidity，巩固一下细节，也写一个“WTF Solidity极简入门”，供小白们使用（编程大佬可以另找教程），每周更新 1-3 讲。\n\n推特：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy_](https://twitter.com/WTFAcademy_)\n\n社区：[Discord](https://discord.gg/5akcruXrsk)｜[微信群](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[官网 wtf.academy](https://wtf.academy)\n\n所有代码和教程开源在 github: [github.com/AmazingAng/WTF-Solidity](https://github.com/AmazingAng/WTF-Solidity)\n\n-----\n`Infura`是Consensys(小狐狸钱包母公司)开发的区块链基础设施，帮助用户/开发者更好的与以太坊区块链交互。\n\n## 连接应用和区块链\n\n![链下链上交互](./img/infura1.png)\n\n在以太坊上开发的Dapp应用（链下）需要与区块链（链上）交互。早期，以太坊上的基础设施很少，开发者需要在本地部署以太坊节点来完成链下和链上的交互，非常麻烦，且耗时数日。\n\n`Infura`在链下、链上之间搭了一座桥，让两者的交互变的简单。它为用户提供对以太坊和IPFS网络的即时、可扩展的`API`访问。开发者在`Infura`官网注册后，就可以免费申请的以太坊`API KEY`，就可以利用`Infura`的节点与区块链交互。另外，小狐狸`metamask`钱包内置了`Infura`服务，方便用户访问以太坊网络。\n\n## 创建`Infura` API Key\n\n### 1. 打开Infura官网并注册\n\n网址：[infura.io](https://infura.io)\n![Infura官网](./img/infura2.png)\n\n### 2. 创建API Key\n注册后，进入控制台Dashboard，并点击右上角的 **CREATE NEW KEY** 按钮。\n\n![创建API Key](./img/infura3.png)\n\n### 3. 填写API Key信息\n\n`NETWORK`选择 **Web3 API (Formerly Ethereum)**，有的版本这里显示的是**Ethereum**，`NAME`随便填一个，我填的`WTF`，之后点击**CREATE**按钮。\n\n![填写信息](./img/infura4.png)\n\n### 4. API Key创建完毕\n\n回到控制台Dashboard，可以看到名为`WTF`的API Key已经创建完毕。在控制台Dashboard，点击 **MANAGE KEY** 按钮，可以查看API Key详情。\n\n\n![API Key创建完毕](./img/infura5.png)\n\n### 5. 查看API Key详情\n\n进入API Key详情页，我们可以看到我们的API Key（图中`184d`开头的一组密钥）。在下面的 **NETWORK ENDPOINT** 栏中，可以查到以太网主网/测试网的rpc节点链接，用于访问链上数据并交互。另外，你可以申请免费的Layer2 rpc节点，包括`Polygon`，`Optimism`和`Arbitrum`，但是需要绑定`visa`卡。领`Optimism`空投那次，公开rpc节点卡爆了，而使用`Infura`的私人rpc节点的人可以正常领取。\n\n![查看信息](./img/infura6.png)\n\n## 使用`Infura` API Key \n### Javascript (`ethers.js`)\n在`ether.js`中，我们可以利用`Infura` API Key来创建`JsonRpcProvider`，与链上交互。\n\n```javascript\nconst { ethers } = require(\"ethers\");\n// 填上你的Infura API Key\nconst INFURA_ID = '' \nconst provider = new ethers.providers.JsonRpcProvider(`https://mainnet.infura.io/v3/${INFURA_ID}`)\n```\n\n### `MetaMask`小狐狸钱包\n\n进入小狐狸钱包设置 **Setting** 页面，点击网络 **Network**，点击添加网络 **Add Network**。你可以利用下面的参数在小狐狸中添加`Optimism` Layer2链：\n\n```\n网络名称（Network Name）: Optimism\nRPC URL：填在Infura申请的optimism rpc链接\n链ID (Chain ID): 10\n符号 (Chain Symbol): ETH\n区块链浏览器URL (Blockchain Explorer URL): https://optimistic.etherscan.io\n```\n\n![小狐狸配置私人rpc](./img/infura7.png)\n\n## 总结\n\n这一讲，我们介绍了如何创建并使用`Infura` API Key便捷访问以太坊区块链。","Topics/Tools/TOOL04_Alchemy/readme.md":"# WTF Solidity极简入门-工具篇4：Alchemy, 区块链API和节点基础设施\n\n我最近在重新学 Solidity，巩固一下细节，也写一个“WTF Solidity极简入门”，供小白们使用（编程大佬可以另找教程），每周更新 1-3 讲。\n\n推特：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy_](https://twitter.com/WTFAcademy_)\n\n社区：[Discord](https://discord.gg/5akcruXrsk)｜[微信群](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[官网 wtf.academy](https://wtf.academy)\n\n所有代码和教程开源在 github: [github.com/AmazingAng/WTF-Solidity](https://github.com/AmazingAng/WTF-Solidity)\n\n-----\n## Alchemy是什么\n\n`Alchemy` 超级节点是 Ethereum、Polygon、Solana、Arbitrum、Optimism、Flow 和 Crypto.org 使用最广泛的区块链 API。获得节点的所有功能，包括 JSON-RPC 支持，但具有在区块链上运行世界级应用程序所需的超强可靠性、数据准确性和可扩展性。\n\n## 连接应用和区块链\n\n在以太坊上开发的Dapp应用（链下）需要与区块链（链上）交互。早期，以太坊上的基础设施很少，开发者需要在本地部署以太坊节点来完成链下和链上的交互，非常麻烦，且耗时数日。\n\n`Alchemy` 和 `Infura`在链下、链上之间搭了一座桥，让两者的交互变的简单。它为用户提供对以太坊和IPFS网络的即时、可扩展的`API`访问。开发者在`Alchemy` 和 `Infura`官网注册后，就可以免费申请的以太坊`API KEY`，就可以利用它们的节点与区块链交互。另外，小狐狸`metamask`钱包内置了`Infura`服务，方便用户访问以太坊网络。\n\n关于`Infura`的介绍，可以参考 [WTF Solidity极简入门-工具篇2：Infura, 连接链下与链上的桥梁](https://github.com/AmazingAng/WTF-Solidity/blob/main/Topics/Tools/TOOL02_Infura/readme.md)\n\n## Alchemy 和 Infura 的区别\n\n![Alchemy 和 Infura 的区别](./img/alchemy-1.png)\n\n左边是`alchemy` 右边是 `Infura`，我们来对比下免费的套餐\n\n### 访问量的区别\n\n`Alchemy`每天没有访问限制，`Infura`每天有100,000的访问限制。\n\n`Alchemy`每个月有`300,000,000`的访问量，`Infura`每个月有`3,000,000`的访问量。\n\n\n### 支持公链的区别（免费版本）\n\n![公链的区别](./img/alchemy-2.png)\n\n`Alchemy`支持：ETH、Polygon、Solana、Arbitrum、Optimism\n\n`Infura`支持：ETH、ETH2、IPFS、Filecoin \n\n### Alchemy支持enhanced-apis\n\n![Alchemy支持enhanced-apis](./img/alchemy-3.png)\n\n\nAlchemy自己封装了一些web3的api，大家可以自己看文档获取更多的细节。\n\n[Alchemy - enhanced-apis](https://dashboard.alchemyapi.io/enhanced-apis)\n\n## 创建`Alchemy` API Key\n\n### 1. 打开Alchemy官网并注册\n\n网址：[alchemy.com](https://www.alchemy.com/)\n\n![Alchemy官网](./img/alchemy-4.png)\n\n\n### 2. 创建API Key\n注册后，进入控制台Dashboard，并点击右上角的 **+ CREATE APP** 按钮。\n\n![创建API Key](./img/alchemy-5.png)\n\n\n### 3. 填写API Key信息\n\n`CHAIN`：选择你需要的网络，如果是以太网就是 `Ethereum`。\n\n`NETWORK`:并选择是主网还是测试网。\n\n![填写API Key信息](./img/alchemy-6.png)\n\n填写完成之后点击 `CREATE APP` 即可创建。\n\n### 4. API Key创建完毕\n\n回到控制台Dashboard，可以看到名为`WTFSolidity`的API Key已经创建完毕。在控制台Dashboard，点击 **view key** 按钮，可以查看API Key详情。\n\n![查看api key](./img/alchemy-7.png)\n\n\n### 5. 查看API Key详情\n\n可以看到我们创建好了相应的api key，最常用的https和websockets都支持。\n\n![查看api key 详情](./img/alchemy-8.png)\n\n\n## 使用`Alchemy` API Key \n\n### Javascript (`ethers.js`)\n在`ether.js`中，我们可以利用`Alchemy` API Key来创建`JsonRpcProvider`，与链上交互。\n\n```javascript\nconst { ethers } = require(\"ethers\");\n// 填上你的Alchemy API Key\nconst ALCHEMY_ID = '' \nconst provider = new ethers.providers.JsonRpcProvider(`https://eth-mainnet.g.alchemy.com/v2/${ALCHEMY_ID}`)\n```\n\n### `MetaMask`小狐狸钱包\n\n进入小狐狸钱包设置 **Setting** 页面，点击网络 **Network**，点击添加网络 **Add Network**。你可以利用下面的参数在小狐狸中添加`Alchemy` 的eth链：\n\n```\n网络名称（Network Name）: Alchemy-eth\nRPC URL：填在alchemy申请的optimism rpc链接\n链ID (Chain ID): 1\n符号 (Chain Symbol): ETH\n区块链浏览器URL (Blockchain Explorer URL): https://etherscan.io\n```\n\n![小狐狸钱包添加新的网络](./img/alchemy-9.png)\n\n\n## 总结\n\n这一讲，我们介绍了如何创建并使用`Alchemy` API Key便捷访问以太坊区块链。\n","Topics/Tools/TOOL01_Remix/readme.md":"# WTF Solidity极简入门-工具篇1：Remix\n\n我最近在重新学 Solidity，巩固一下细节，也写一个“WTF Solidity极简入门”，供小白们使用（编程大佬可以另找教程），每周更新 1-3 讲。\n\n推特：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy_](https://twitter.com/WTFAcademy_)\n\n社区：[Discord](https://discord.gg/5akcruXrsk)｜[微信群](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[官网 wtf.academy](https://wtf.academy)\n\n所有代码和教程开源在 github: [github.com/AmazingAng/WTF-Solidity](https://github.com/AmazingAng/WTF-Solidity)\n\n-----\n\n`Remix`是以太坊官方推荐的智能合约开发IDE，非常易用。`Remix`让你可以直接在浏览器中快速部署测试智能合约，而不需要安装配置任何程序。这一讲，我们将完整的介绍如何使用`Remix`部署合约，并调用其中的函数。\n\n**Remix官网**：[remix.ethereum.org](https://remix.ethereum.org)\n\n## 1.打开Remix\n![Remix Layout](./img/remix1.png)\n\n打开官网进入`Remix`，我们可以看到Remix由四个面板组成：\n1. 图标面板：上面有代表不同功能的图标，点击后，相应的功能个会显示在侧面版上。\n2. 侧面版：各种功能的 `GUI`。\n3. 主面板：代码编辑器。\n4. 终端：将显示与 `GUI` 交互的结果，也可以在此处运行脚本。\n\n## 2. 图标面板\n![图标面板](./img/remix2.png)\n\n图标面板默认有4个图标，其中`文件`，`编译`，`部署`是最常用的。在你添加更多的`remix`插件后，它们也会显示在图标面板上。\n\n## 3. 部署简单合约\n### i. 选择合约文件\n首先点击`文件`图标，侧面版会变为`文件浏览器`。\n![文件图标](./img/remix3.png)\n\n我们可以在`文件浏览器`中管理我们的workspace，文件夹和文件。\n![文件浏览器](./img/remix4.png)\n\n在`contract`文件夹下面，有三个`remix`自带的合约例子，分别是`1_Storage.sol`, `2_Owner.sol`和`3_Ballot.sol`。\n\n点击`1_Storage.sol`，代码会显示在主面板的代码编辑器上。这个合约非常简单：它一个状态变量`number`，在链上存储一个`uint256`类型的数字；它有两个函数，`store()`函数将一个数字赋值给`number`变量；`retrieve()`展示`number`变量的数值。\n\n### ii. 编译\n接下来，点击`编译`图标，进入`Solidity Compiler`。在这里，我们选择`Solidity 0.8.7`版本，然后点击`Compile 1_Storage.sol`按钮进行编译。在合约成功编译后，`编译`图标上会显示绿色对勾。\n\n![编译](./img/remix5.png)\n\n你也可以尝试在优化中选在优化（`Enable Optimization`），次数设置为`200`，有时会省`gas`消耗。\n\n### iii. 部署\n下一步，我们要把编译好的合约部署到本地虚拟机或链上。首先点击`部署`，进入部署界面。\n\n![部署](./img/remix6.png)\n\n在`ENVIRONMENT`中，我们可以选择我们部署的环境，默认的是`JavaScript VM`，所有交易都在本地浏览器的沙盒区块链中执行，使用的是它给你的虚拟钱包地址；你也可以选择`Injected Web3`，即连接你的`metamask`钱包，所有交易会在真实的区块链中执行。\n\n这里，我们选择`JavaScript VM`，你可以在钱包地址（`ACCOUNT`）栏看到虚拟机给你分配的测试地址。不需要调整`Gas`，也不用往合约里发送`ETH`。在`CONTRACT`栏中选择你要部署的合约`Storage`。`1_Storage.sol`文件中只有一个合约，因此默认就是部署它；但当文件包含多个合约时，我们需要手动选择要部署的合约。\n\n点击`DEPLOY`键，部署完毕！\n\n**注意**：如果我们选择的是`Injected Web3`来部署合约，每一笔交易都将上链，需要钱包确认交易并支付`gas`。\n\n### iv. 调用\n在合约部署成功后，我们可以在`Deployed Contracts`中找到我们部署的合约`Storage`。展开它，我们将看到所有的外部函数：`store`和`retrieve`。\n\n![调用](./img/remix7.png)\n\n我们在`store`函数那行的文本框中输入`100`，并点击函数名调用它。调用成功后，我们可以在终端上看到`log`信息，点击`Debug`按钮可以查看交易详情。\n\n![交易详情](./img/remix8.png)\n\n之后，我们调用`retrieve`函数，显示`number`变量被成功更新为`100`。\n\n![变量被更新为100，调用成功](./img/remix9.png)\n\n## 总结\n\n这一讲，我们介绍了如何使用`Remix`编译，部署并调用智能合约。\n\n","Topics/Tools/TOOL03_Ganache/readme.md":"# WTF Solidity极简入门-工具篇3：Ganache，搭建本地测试网络\n\n我最近在重新学 Solidity，巩固一下细节，也写一个“WTF Solidity极简入门”，供小白们使用（编程大佬可以另找教程），每周更新 1-3 讲。\n\n推特：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy_](https://twitter.com/WTFAcademy_)\n\n社区：[Discord](https://discord.gg/5akcruXrsk)｜[微信群](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[官网 wtf.academy](https://wtf.academy)\n\n所有代码和教程开源在 github: [github.com/AmazingAng/WTF-Solidity](https://github.com/AmazingAng/WTF-Solidity)\n\n-----\n\n`Ganache` 是一个适用于 “开发场景”（或开发过程中的）的 **以太坊区块链网络**，它使开发以太坊应用程序（的工作）更快、更容易、更安全。它包括所有流行的 RPC 功能和特性（如事件），并且可以确定性地运行以使开发变得轻而易举。\n\n> 可以理解 ganache 是一个以太坊区块链“模拟器”，在开发过程中 “模拟” 生产环境、方便的获取合约调用的上下文。\n\n> ⚠️ 注意：**请不要在生产环境中作为区块链网络使用** 如果需要请使用 geth 或 openethereum 等节点应用。\n\n`Ganache` 同时有着 GUI 版本，适合于新手快速配置使用。\n\n## Ganache 的项目设施\n\n- 官网：[https://trufflesuite.com/ganache/](https://trufflesuite.com/ganache/)\n- 文档：[https://trufflesuite.com/docs/ganache/](https://trufflesuite.com/docs/ganache/)\n- Github：\n - UI: [https://github.com/trufflesuite/ganache-ui](https://github.com/trufflesuite/ganache-ui)\n - CLI: [https://github.com/trufflesuite/ganache](https://github.com/trufflesuite/ganache)\n - 旧版（已弃用）: [https://github.com/trufflesuite/ganache-cli](https://github.com/trufflesuite/ganache-cli)\n- 适用于命令行/npm的文档：[https://trufflesuite.com/blog/introducing-ganache-7/](https://trufflesuite.com/blog/introducing-ganache-7/)\n\n\n> ⚠️ 注意：Ganache 的官网中的 Github repo 为UI版本。CLI 版本在 npm 中有 `ganache` & `ganache-cli`，其中 `ganache-cli` 已被弃用。\n\n## 为什么要使用Ganache？\n\nGanache 的主要功能有：\n- 开箱即用，快速启动一个EVM区块链网络（可以设置 miner、出块时间）；\n- 方便的 fork（分叉）已经存在的区块链网络（无需等待区块同步）；\n- [使用 `console.log`](https://github.com/trufflesuite/ganache#consolelog-in-solidity) 在 Solidity 开发过程中方便的调试，；\n- [快进时间（Fast-forward time）](https://trufflesuite.com/blog/introducing-ganache-7/#6-fast-forward-time)，模拟智能合约在未来时间的状态；\n- 模拟任何一个账户（你可以无需私钥模拟环境中使用任意用户的Token）；\n\n有的时候想要实现合约的测试，或者一些合约开发，你需要去测试网领取eth。有时候faucet又没有eth可以领取，这个时候，其实你可以选择自己在本地 fork 一个网络，想要多少eth都可以直接生成。原理是 fork 一个主网的网络运行在本地（或是可以称作运行在本地的 Chain）。\n\nfork主网还有一个好处，你可以直接mock现在主网上的所有环境，比如dex交易所的代币余额等，你知道合约地址，可以直接进行测试和交换使用等。\n\n## 命令行安装（推荐）\n\n[完整包的说明 ganache - npm](https://www.npmjs.com/package/ganache)\n```shell\nnpm install ganache --global\n```\n您也可以单独安装该项至您的项目目录（在不使用 `--global` 的情况下）编写 `package.json` 中的 script 配置启动。 \n在 Ganache 7 后您可以在 node.js 的 Javascript 脚本中引入并直接使用。它将会提供一个 [EIP-1193(Ethereum Provider JavaScript API)](https://eips.ethereum.org/EIPS/eip-1193) provider、一个 JSON-RPC 服务端、Web3.js & ethers provider。同时您也可以在[浏览器中](https://github.com/trufflesuite/ganache#browser-use)使用它。\n\n\n### 启动GANACHE\n\n```shell\nganache\n```\n\n### 帮助 / 说明\n```\nganache --help\n```\n通过帮助，你可以了解 ganache 的主要功能和相关配置方法、参数。这其中包括：\n- **Chain**: 设置网络的版本、ID、时间、合约大小限制、hardfork的版本规则；\n- **Database**: 设置保存链到数据库；\n- **Logging**: 设置 EVM opcodes、RPC 请求和响应的 log；\n- **Miner**: 设置矿工，包括：出块时间、默认的 gas price、Txn gas limit、难度、instamine、价格上涨；\n- **Wallet**: 设置钱包的默认余额、解锁钱包；\n- **Fork**: 分叉（fork）网络的设置包括：fork 目标网络 RPC URL、块高、userAgent、缓存策略，支持提供用户名/密码（如果目标 RPC 存在 Basic Authentication）；\n- **Server**: 设置本地 Chain 的监听地址&端口；\n### Fork 主网启动\n\n以下命令会自动生成10个eth账号，每个账号带有100eth的数量。\n\n```shell\nganache -f https://eth-mainnet.alchemyapi.io/v2/YOUR_API_KEY\n```\n\n您也可以fork其他以太坊区块链网络，例如 BSC、Polygon、Astar 等，您需要寻找并使用他们的RPC节点。\n\n### Fork主网固定账号启动\n\n`wallet.accounts`主要参数为私钥和需要生成的eth数量。\n\n注意单位为`wei`，案例中换算之后是`1000eth`\n\n```shell\nganache -f https://eth-mainnet.alchemyapi.io/v2/YOUR_API_KEY --wallet.accounts=ACCOUNT_PRIATE_KEY,AMOUNT_WEI --wallet.accounts=ACCOUNT_PRIATE_KEY,1000000000000000000000\n```\n\n### 推进时间 (Fast Forward time)\n\n需要操纵时间的原因或场景：一些合约锁住了用户的Token，设计了释放周期/时间逐步释放这些被锁住的Token，或者在未来某个特定时间允许用户进行一些操作。\n\nGanache 允许我们通过 RPC 调用（方法 `evm_increaseTime` 和 `evm_setTime` ）来推进区块链上的时间。\n\n大多数情况下我们无法等到这个时间，我们可以使用 `evm_increaseTime` 将区块链当前时间戳**增加指定的时间量**（以秒为单位）（以十六进制格式传入）。这将返回以秒为单位调整的总时间。\n\n```\ncurl -H 'Content-Type: application/json' --data' {\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"evm_increaseTime\", \"params\": [\"0x15180\"] }' http://localhost:8545\n```\n\n此外，您可以使用 `evm_setTime` 将其设置为特定的时间戳；它接受具有毫秒精度的 JavaScript 时间戳，并返回给定时间戳和当前时间之间的秒数。\n\n这里有个在项目中应用的案例（很实用）：[liquity 项目合约测试 - ForwardTime 的功能实现](https://github.com/liquity/dev/blob/0c61ed8b7181450da214d4f10a1327c2082bd4f4/packages/contracts/utils/testHelpers.js#L1104-L1119)\n### 通过GUI使用 Ganache\n不太推荐，如果你是新上手，可以通过这个快速熟悉 Ganache。\n\n[点击下载Ganache - Truffle Suite](https://trufflesuite.com/ganache/)\n\n#### 客户端界面\n![](./img//ganache-7.png)\n\n#### 初始化新建工作空间\n\n![](./img//ganache-8.png)\n\n点击quickstart就可以快速启动，但是快速启动默认的网络端口是 7545，如果你用remix链接的时候需要修改一下。启动完成之后就如下图所示：\n\n![](./img/ganache-9.png)\n\n第一行可以看到你现在的网络`rpc server`, 默认是地址和端口是`127.0.0.1:7545`，如果你在remix中使用默认的，需要把端口改为7545。\n\n\n\n#### remix 链接默认ganache\n\n![](./img/ganache-10.png)\n\n选择环境为 ganache provider，具体端口看你的设置,需要跟ganache的端口一致。\n\n![](./img/ganache-11.png)\n\n端口改为和本地ganache默认一样的`7545`\n\n#### 测试部署一个合约\n\n这里能看到区块里的交易信息，显示我部署了一个合约地址。\n\n![](./img/ganache-12.png)\n\n![](./img/ganache-13.png)\n\n\n#### 自定义配置\n\n有时候你可能需要自定义配置，比如你的网络端口，或者你需要fork主网，你可以在初始化空间的时候配置。\n\n选择`new workspace`\n\n![](./img/ganache-14.png)\n\n\n#### 设置端口和网络ID\n\n端口：可以将默认端口7545改成8545，看你的习惯\n\n![](./img/ganache-15.png)\n\n\n#### fork主网\n\n这里的地址填入你alchemy的主网地址即可\n\n没有的话申请一个 [Alchemy - Blockchain APIs and Node Infrastructure](https://alchemy.com/?r=7ad384cba6732c9d) 或者参考 [Infura, 连接链下与链上的桥梁](https://github.com/AmazingAng/WTF-Solidity/tree/main/Topics/Tools/TOOL02_Infura/readme.md) 申请一个infura的链接。\n\n在chain forking下面的`ENTER CUSTOM URL`里面填入你的eth mainnet地址即可\n\n![](./img/ganache-16.png)\n\n\n#### 设置固定账号和余额\n\n![](./img/ganache-17.png)\n\n最后点击 save workspace 就可以启动啦。\n\n\n## web3js/ethersjs 链接 ganache\nganache生成的本地rpc地址为 `127.0.0.1:8545` UI的默认地址和命令行有区别，所以我上述做了变更。像remix默认使用的就是8454端口\n\n```js\n\n// web3js\n\nconst web3 = new Web3(Web3.givenProvider || \"http://127.0.0.1:8545\");\n\n// ethersjs\nconst provider = new ethers.providers.JsonRpcProvider(\"http://127.0.0.1:8545\");\n\n```\n\n## remix链接本地ganache\n\n把环境链接修改为 ganache即可没，这样你就可以把他部署在你本地的eth网络环境上了。\n\n![](./img/ganache-1.png)\n\n\n### 测试部署合约\n\n这里就将合约部署在了我们本地运行的ganache上。\n\n![](./img/ganache-2.png)\n\n命令行会输出部署的相应细节\n\n![](./img/ganache-3.png)\n\n可以看到部署成功之后，可以方便的调用各种方法\n\n![](./img/ganache-4.png)\n\n### 部署合约，查询v神余额\n\n这个合约写了一个可以查询eth余额的方法，因为我们fork了主网，所以查询一下v神在我们本地测试网络的余额，应该和主网的余额是一样的。\n\n```solidity\n// contracts/GLDToken.sol†\n// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ncontract XBXToken {\n\n function getETHBalance(address _address) view external returns(uint256) {\n return address(_address).balance;\n }\n\n}\n\n```\n\n[v神主网钱包地址](https://etherscan.io/address/0xab5801a7d398351b8be11c439e05c5b3259aec9b)\n\n![](./img/ganache-5.png)\n\n通过remix调用查看fork之后，本地部署该地址余额\n\n![](./img/ganache-6.png)\n\n本地fork的网络查询v神余额与主网上的余额一致，fork主网测试成功。\n\n## 总结\n\n至此我们就完整fork了一个主网，为下一步做合约开发搭建好了必要的本地环境。","Topics/Onchain_debug/01_tools/readme.md":"# OnChain Transaction Debugging: 1. Tools\n\nAuthor: [SunSec](https://twitter.com/1nf0s3cpt)\n\n当初我在学习链上交易分析时，很少相关教学文章，只能自己慢慢地收集资料从中挖掘如何分析到测试。我们将推出一系列 Web3 安全的教学文章, 帮助更多人加入 Web3 安全，共创安全网路。\n\n第一个系列我们将介绍如何进行链上分析到撰写攻击重现。此技能将能帮助你分析攻击过程和漏洞原因甚至套利机器人如何套利！\n\n## 工欲善其事，必先利其器\n\n在进入分析之前，我先介绍一些常用工具，正确的工具可以帮助你做研究时更有效率。\n\n### Transaction debugging tools\n\n[Phalcon](https://phalcon.blocksec.com/) | [Ethtx](https://ethtx.info/) | [Tenderly](https://dashboard.tenderly.co/explorer)\n\nTransaction Viewer 这类工具是最常用的，可以帮助我们针对想要分析的交易 Transaction，以可视化列出函数呼叫的流程以及每个函数带入了什么的参数等。\n每个工具大同小异，只差异在链的支援度不同和辅助功能，我个人是比较常用 Phalcon 的 Transaction Viewer，如果遇到不支援的链则会使用 Tenderly，Tenderly 支援最多链，但是可读性就不是这么方便，需要 Debug 慢慢分析。不过我最初在研究链上分析是先学习 Ethtx 和 Tenderly。\n\n#### 链支援度比较\n\nPhalcon： `Ethereum、BSC、Cronos、Avalanche C-Chain、Polygon`\n\nEthtx： `Ethereum、Goerli testnet`\n\nTendery： `Ethereum、Polygon、BSC、Sepolia、Goerli、Gnosis、POA、RSK、Avalanche C-Chain、Arbitrum、Optimism、Fantom、Moonbeam、Moonriver`\n\n#### 实务操作\n\n以 JayPeggers - Insufficient validation + Reentrancy [事件](https://github.com/SunWeb3Sec/DeFiHackLabs/#20221229---jay---insufficient-validation--reentrancy)来当例子 [TXID](https://phalcon.blocksec.com/tx/eth/0xd4fafa1261f6e4f9c8543228a67caf9d02811e4ad3058a2714323964a8db61f6)\n使用 Blocksec 开发的 Phalcon 工具来说明，下图可以看到该交易的基本资讯和余额变化，从余额变化可以快速看出攻击者大概获利多少，以这个例子攻击者获利 15.32 ETH。\n\n![210571234-402d96aa-fe5e-4bc4-becc-190bd5a78e68-2](https://user-images.githubusercontent.com/107249780/210686382-cc02cc6a-b8ec-4cb7-ac19-402cd8ff86f6.png)\n\nInvocation Flow 可视化函数调用流程: 可以让我们知道这一笔交易调用流程和函数呼叫的层级，有没有使用闪电贷、涉及了哪些项目、呼叫了哪些函数带入了什么参数和原始 data 等等\n\n![图片](https://user-images.githubusercontent.com/52526645/210572053-eafdf62a-7ebe-4caa-a905-045e792add2b.png)\n\nPhalcon 2.0 新增了资金流向和 Debug + 源代码分析可以在 Trace 的过程中边看程式执行的片段、参数、返回值，分析上方便了不少。\n\n![image](https://user-images.githubusercontent.com/107249780/210821062-d1da8d1a-9615-4f1f-838d-34f27b9c3f41.png)\n\n换 Sam 的 Transaction Viewer 来看看 [TXID](https://tx.eth.samczsun.com/ethereum/0xd4fafa1261f6e4f9c8543228a67caf9d02811e4ad3058a2714323964a8db61f6)\n跟 Phalcon 类似但 Sam 整合了许多小工具在里面，如下图的眼睛点下去可以看到 Storage 的变化和每个呼叫所消耗的 Gas。\n\n![210574290-790f6129-aa82-4152-b3e1-d21820524a0a-2](https://user-images.githubusercontent.com/107249780/210686653-f964a682-d2a7-4b49-bafc-c9a2b0fa2c55.png)\n\n点击最左边的 Call，可以把原始 Input data 尝试 Decode。\n\n![图片](https://user-images.githubusercontent.com/52526645/210575619-89c8e8de-e2f9-4243-9646-0661b9483913.png)\n\n再来换 Tendery 来看看 [TXID](https://dashboard.tenderly.co/tx/mainnet/0xd4fafa1261f6e4f9c8543228a67caf9d02811e4ad3058a2714323964a8db61f6)\n在 Tendery 介面上，一样可以看到基本资讯，但在 Debug 的部分就不是可视化，需要一步一步 Debug 走下去分析，不过好处是可以边 Debug 边看程式码还有 Input data 的转换过程。\n\n![图片](https://user-images.githubusercontent.com/52526645/210577802-c455545c-80d7-4f35-974a-dadbe59c626e.png)\n\n到这边就可以帮我们厘清大概这笔交易做了哪些事情，在还没有开始写 Poc 时，如果想要快速重放攻击可以吗? 可以! 可以使用Tendery 或 Phalcon，这两个工具另外支援了模拟交易重现，在上图右上角有一个按钮 Re-Simulate，工具会自动帮你带上该交易的参数值如下图\n从图中的栏位可以依照需求任意改变如改block number, From, Value, Input data 等\n\n![图片](https://user-images.githubusercontent.com/52526645/210580340-f2abf864-e540-4881-8482-f28030e5e35b.png)\n\n### Ethereum Signature Database\n\n[4byte](https://www.4byte.directory/) | [etherface](https://www.etherface.io/hash)\n\n在原始 Input data，前面 4bytes 为 Function Signature. 有时遇到 Etherscan 或分析工具无法解出来时，可以透过 Signature Database 来查看看可能是什么 Function。\n\n以下举例假设我们不知道 `0xac9650d8` 是什么 Function\n![图片](https://user-images.githubusercontent.com/52526645/210582149-61a6d973-b458-432f-b586-250c94c3ae24.png)\n\n透过 sig.eth 查询，可以看到这个 4 bytes signature 为 `multicall(bytes[])`\n![图片](https://user-images.githubusercontent.com/52526645/210583416-c31bbe07-fa03-4701-880d-0ae485b171f7.png)\n\n### Useful tools\n\n[ABI to interface](https://gnidan.github.io/abi-to-sol/) | [Get ABI for unverified contracts](https://abi.w1nt3r.xyz/) | [ETH Calldata Decoder](https://apoorvlathey.com/eth-calldata-decoder/) | [ETHCMD - Guess ABI](https://www.ethcmd.com/)\n\nABI to interface: 在开发 Poc 时需要呼叫其他合约时要有 Interface 接口，我们可以透过这个工具帮你快速产生你要的接口。\n先去 Etherscan 把 ABI 复制下来，贴过去工具上就可以看到产生出来的 Interface。\n[例子](https://etherscan.io/address/0xb3da8d6da3ede239ccbf576ca0eaa74d86f0e9d3#code)\n\n![图片](https://user-images.githubusercontent.com/52526645/210587442-e7853d8b-0613-426e-8a27-d70c80e2a42d.png)\n![图片](https://user-images.githubusercontent.com/52526645/210587682-5fb07a01-2b21-41fa-9ed5-e7f45baa0b3e.png)\n\nETH Calldata Decoder: 有时候在没有 ABI 的情况下想要解看看 Input data 可以试试看 ETH Calldata Decoder，在前面介绍到 Sam 的工具就有支援 Input data decode。\n\n![图片](https://user-images.githubusercontent.com/52526645/210585761-efd8b6f1-b901-485f-ae66-efaf9c84869c.png)\n\nGet ABI for unverified contracts: 如果遇到未开源的合约，可以透过这个工具尝试列举出这个合约中存在的 Function Signature.\n[例子](https://abi.w1nt3r.xyz/mainnet/0xaE9C73fd0Fd237c1c6f66FE009d24ce969e98704)\n\n![图片](https://user-images.githubusercontent.com/52526645/210588945-701b0e22-7390-4539-9d2f-e13479b52824.png)\n\n### Decompile tools\n\n[Etherscan-decompile bytecode](https://etherscan.io/address/0xaE9C73fd0Fd237c1c6f66FE009d24ce969e98704#code) | [Dedaub](https://library.dedaub.com/decompile) | [heimdall-rs](https://github.com/Jon-Becker/heimdall-rs)\n\nEtherscan 内建有一个反编译功能但可读性偏差，个人比较常使用 Dedaub，可读性好一点，也是常常最多人DM 问我都使用哪个工具反编译。\n我们拿一个 MEV Bot 被攻击来当[例子](https://twitter.com/1nf0s3cpt/status/1577594615104172033)\n可以自己试试解看看 [例子](https://bscscan.com/address/0x64dd59d6c7f09dc05b472ce5cb961b6e10106e1d#code)\n\n首先把未开源合约的 Bytecodes 复制下来贴到 Dedaub 上，点 Decompile 即可。\n![截图 2023-01-05 上午10 33 15](https://user-images.githubusercontent.com/107249780/210688395-927c6126-b6c1-4c6d-a0c7-a3fea3db9cdb.png)\n\n![图片](https://user-images.githubusercontent.com/52526645/210591478-6fa928f3-455d-42b5-a1ac-6694f97386c2.png)\n\n第一课分享就先到这边，想学更多可以参考以下学习资源。\n\n---\n\n## 学习资源\n\n[samczsun's eth txn explorer and vscode extension](https://www.youtube.com/watch?v=HXgu239mPBc)\n\n[Vulnerabilities in DeFi by Daniel V.F.](https://www.youtube.com/watch?v=9fcOffCg2ig)\n\n[Tenderly.co - Debug Transaction](https://www.youtube.com/watch?v=90GN9Ut8LhU)\n\n[Reversing The EVM: Raw Calldata](https://degatchi.com/articles/reading-raw-evm-calldata)\n\nhttps://web3sec.xrex.io/\n","Topics/Tools/TOOL07_Foundry/readme.md":"# WTF Solidity 极简入门-工具篇 7：Foundry，以 Solidity 为中心的开发工具包\n\n我最近在重新学 Solidity，巩固一下细节，也写一个“WTF Solidity 极简入门”，供小白们使用（编程大佬可以另找教程），每周更新 1-3 讲。\n\n推特：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy\\_](https://twitter.com/WTFAcademy_)\n\n社区：[Discord](https://discord.gg/5akcruXrsk)｜[微信群](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[官网 wtf.academy](https://wtf.academy)\n\n所有代码和教程开源在 github: [github.com/AmazingAng/WTF-Solidity](https://github.com/AmazingAng/WTF-Solidity)\n\n---\n\n## 什么是 Foundry?\n来自 Foundry [官网 (getfoundry.sh) ](https://getfoundry.sh) 对该工具的介绍：\n\n> Foundry是 一个用 Rust编写的用于以太坊应用程序开发的极快、可移植和模块化的工具包 ( Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.)\n\n项目设施：\n- 官网：[https://getfoundry.sh](https://getfoundry.sh)\n- Github 仓库：[https://github.com/foundry-rs/foundry](https://github.com/foundry-rs/foundry)\n- 文档：[https://book.getfoundry.sh](https://book.getfoundry.sh)\n\n介绍的解释：\n- **用 Rust 语言编写**： Foundry 完全采用 Rust 语言开发， [Github 上的源代码仓库](https://github.com/foundry-rs/foundry) 是一个 Rust 语言工程。我们可以通过获取 [Release 的二进制文件](https://github.com/foundry-rs/foundry/releases)，也可以通过 Rust 语言的 cargo 包管理[工具编译&构建安装](https://github.com/foundry-rs/foundry#installing-from-source);\n- **用于以太坊应用程序开发**： Foundry 作为 以太坊（Solidity语言）项目/应用程序开发的 “工程化” 工具，提供专业 Solidity 开发环境与“工具链”。**通过它你可以快速、方便的完成依赖项管理、编译、运行测试、部署，并可以通过命令行和 Solidity 脚本与链进行交互**;\n- **极快**： Foundry 利用 [ethers-solc](https://github.com/gakonst/ethers-rs/tree/master/ethers-solc/) 比较于传统通过 Node.js 辅助完成的测试用例/工程，Foundry 构建、测试的执行速度很快（创建一个工程，写一些测试用例跑一下会感受到震撼）;\n- **可移植**: Foundry 工程支持与其他类型的工程集成（如：[与 Hardhat 集成](https://book.getfoundry.sh/config/hardhat)）;\n- **模块化**：通过 git submodule & 构建目录映射，快速方便的引入依赖;\n\n\n\n## 为什么选择 Foundry？\n\n如果你满足以下条件或有过类似体验，你一定要试试 Foundry：\n\n- ~~如果你有 Rust “语言信仰”~~，如果你是个专业的 以太坊（Solidity语言）应用开发者；\n- 你曾经用过类似 Hardhat.js 这样的工具；\n- 你厌倦了大量测试用例的等待，需要有工具**更加快速**的跑完你的测试用例；\n- 你觉得处理 BigNumber 稍微有一点点🤏麻烦;\n- 有过**通过 Solidity 语言本身完成测试用例**（或测试合约的合约）的需求；\n- 你觉得通过 git submodule 的方式管理依赖更加方便（而不是 npm）；\n- ···\n\n\n如果有以下情况 Foundry 可能不适合你：\n- Solidity 初学者；\n- 你的项目不需要写测试用例、不需要过多在 Solidity 工程方面的自动化操作；\n\n\n## Foundry 的主要功能\n> 该部分源于 Foundry book ([https://book.getfoundry.sh](https://book.getfoundry.sh))，让章节的理解更容易。\n\n- [创建以太坊（Solidity）智能合约应用开发项目](https://book.getfoundry.sh/projects/creating-a-new-project)，[开发已有的项目](https://book.getfoundry.sh/projects/working-on-an-existing-project);\n- [管理以太坊(Solidity)智能合约的依赖项目](https://book.getfoundry.sh/projects/dependencies);\n- [创建由 Solidity 语言编写的测试用例（并且能很快速的执行测试用例）](https://book.getfoundry.sh/forge/writing-tests): 并且支持[模糊测试](https://book.getfoundry.sh/forge/fuzz-testing)与[差异测试](https://book.getfoundry.sh/forge/differential-ffi-testing)等方便、专业的测试方式;\n- 通过 [Cheatcodes（作弊码）](https://book.getfoundry.sh/forge/cheatcodes) 在 Solidity语言 编写的测试用例中**进行 “EVM环境之外” 的 vm 功能进行交互与断言**：更换测试用例语句执行者的钱包地址（更换 `msg.sender`）、对 EVM 外的 Event 事件进行断言；\n- 执行过程与错误追踪：[“函数堆栈”级的错误追踪（Traces）](https://book.getfoundry.sh/forge/traces)；\n- [部署合约和自动化的完成scan上合约的开源验证](https://book.getfoundry.sh/forge/deploying)；\n- 在项目中支持[完整的gas使用情况追踪](https://book.getfoundry.sh/forge/gas-tracking)：包括合约测试细节的gas用量和gas报告；\n- 交互式[调试器](https://book.getfoundry.sh/forge/debugger)；\n\n## Foundry 的组成\n\nFoundry 项目由 `Forge`, `Cast`, `Anvil` 几个部分（命令行工具）组成\n\n- Forge: Foundry 项目中**执行初始化项目、管理依赖、测试、构建、部署智能合约**的命令行工具;\n- Cast: Foundry 项目中**与 RPC 节点交互**的命令行工具。可以进行智能合约的调用、发送交易数据或检索任何类型的链上数据;\n- Anvil: Foundry 项目中**启动的本地测试网/节点**的命令行工具。可以使用它配合测试前端应用与部署在该测试网的合约或通过 RPC 进行交互; \n\n## 快速使用 --- 创建一个 Foundry 项目\n\n> 内容出自 Foundry book 的 Getting Start 部分\n\n即将完成的过程：\n1. 安装 Foundry;\n2. 初始化一个 Foundry 项目;\n3. 理解初始化过程中添加的智能合约、测试用例；\n4. 执行构建&测试;\n \n \n### 安装 Foundry\n\n对于不同的环境：\n- MacOS / Linux （等 Unix like 系统）：\n - 通过 `foundryup` 安装（👈Foundry 项目首页推荐的方式）;\n - 通过 源代码构建 安装;\n- Windows\n - 通过 源代码构建 安装;\n- Docker 环境\n - 参考 Foundry Package: [ https://github.com/gakonst/foundry/pkgs/container/foundry](https://github.com/gakonst/foundry/pkgs/container/foundry)\n- Github Action： 用于构建完整的 Action 流程\n - 参考 [https://github.com/foundry-rs/foundry-toolchain](https://github.com/foundry-rs/foundry-toolchain)\n\n---\n\n#### 通过[脚本](https://raw.githubusercontent.com/foundry-rs/foundry/master/foundryup/install)快速安装\n通过有`bash`的（或者类Unix环境）快速安装\n```shell\n$ curl -L https://foundry.paradigm.xyz | bash\n```\n执行后将会安装 `foundryup`，在此后执行它\n```shell\n$ foundryup\n```\n如果一切顺利，您现在可以使用三个二进制文件：`forge`、`cast` 和 `anvil`。\n\n\n\n### 初始化一个 Foundry 项目\n\n通过 `forge` 的 `forge init` 初始化项目 \"hello_wtf\"\n```shell\n$ forge init hello_wtf\n\nInitializing /Users/username/hello_wtf...\nInstalling forge-std in \"/Users/username/hello_wtf/lib/forge-std\" (url: Some(\"https://github.com/foundry-rs/forge-std\"), tag: None)\n Installed forge-std\n Initialized forge project.\n```\n该过程通过安装依赖`forge-std`初始化了一个 Foundry 项目\n\n在项目目录中看到\n\n```shell\n$ tree -L 2 \n.\n├── foundry.toml # Foundry 的 package 配置文件\n├── lib # Foundry 的依赖库\n│   └── forge-std # 工具 forge 的基础依赖\n├── script # Foundry 的脚本\n│   └── Counter.s.sol # 示例合约 Counter 的脚本\n├── src # 智能合约的业务逻辑、源代码将会放在这里\n│   └── Counter.sol # 示例合约\n└── test # 测试用例目录\n └── Counter.t.sol # 示例合约的测试用例\n```\n提示：\n- 依赖项作为 git submodule 在 `./lib` 目录中\n- 关于 Foundry 的 package 配置文件请详细参考: [https://github.com/foundry-rs/foundry/blob/master/config/README.md#all-options](https://github.com/foundry-rs/foundry/blob/master/config/README.md#all-options)\n\n\n### 理解初始化过程中添加的智能合约、测试用例\n\n#### src 目录\n\n主要由业务逻辑构成\n`src` 目录中的 `./src/Counter.sol`:\n```solidity\n// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.13;\n\ncontract Counter { // 一个很简单的 Counter 合约\n uint256 public number; // 维护一个 public 的 uint256 数字\n\n // 设置 number 变量的内容\n function setNumber(uint256 newNumber) public { \n number = newNumber;\n }\n\n // 让 number 变量的内容自增\n function increment() public {\n number++;\n }\n}\n```\n\n#### script 目录\n\n参考 Foundry 项目文档中的 [Solidity-scripting](https://book.getfoundry.sh/tutorials/solidity-scripting) 该目录主要由“部署”脚本构成（也可通过该脚本调用 Foundry 提供的 `vm` 功能实现应用业务逻辑之外的高级功能，等同于 Hardhat.js 中的 scripts）。\n\n详见script 目录中的 `./script/Counter.s.sol`：\n\n```solidity\n// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.13; // 许可 和 Solidity版本标识\n\nimport \"forge-std/Script.sol\"; // 引入foundry forge中的Script库\nimport \"../src/Counter.sol\"; // 引入要部署的Counter合约\n\n// 部署脚本继承了Script合约\ncontract CounterScript is Script {\n // 可选函数，在每个函数运行之前被调用\n function setUp() public {}\n\n // 部署合约时会调用run()函数\n function run() public {\n vm.startBroadcast(); // 开始记录脚本中合约的调用和创建\n new Counter(); // 创建合约\n vm.stopBroadcast(); // 结束记录\n }\n}\n```\n\nFoundry的部署脚本是一个用Solidity写的智能合约，虽然它不会被部署，但符合Solidity的规范。你可以用`forge script`运行脚本并部署合约。\n\n```shell\nforge script script/Counter.s.sol:CounterScript\n```\n\n\n#### test 目录\n\n主要由合约的测试用例构成\n\ntest 目录中的 `./test/Counter.t.sol`\n\n```solidity\n// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.13;\n\nimport \"forge-std/Test.sol\"; // 引入 forge-std 中用于测试的依赖\nimport \"../src/Counter.sol\"; // 引入用于测试的业务合约\n\n// 基于 forge-std 的 test 合约依赖实现测试用例\ncontract CounterTest is Test { \n Counter public counter;\n\n // 初始化测试用例\n function setUp() public { \n counter = new Counter();\n counter.setNumber(0);\n }\n\n // 基于初始化测试用例\n // 断言测试自增后的 counter 的 number 返回值 同等于 1\n function testIncrement() public {\n counter.increment();\n assertEq(counter.number(), 1);\n }\n\n // 基于初始化测试用例\n // 执行差异测试测试\n // forge 测试的过程中\n // 为 testSetNumber 函数参数传递不同的 unit256 类型的 x\n // 达到测试 counter 的 setNumber 函数 为不同的 x 设置不同的数\n // 断言 number() 的返回值等同于差异测试的 x 参数\n function testSetNumber(uint256 x) public {\n counter.setNumber(x);\n assertEq(counter.number(), x);\n }\n\n // 差异测试：参考 https://book.getfoundry.sh/forge/differential-ffi-testing\n}\n```\n\n### 执行构建&测试\n\n在项目目录中通过执行 `forge build` 完成构建\n```shell\n$ forge build\n\n[⠒] Compiling...\n[⠢] Compiling 10 files with 0.8.17\n[⠰] Solc 0.8.17 finished in 1.06s\nCompiler run successful\n```\n\n完成构建后 通过 `forge test` 完成测试\n```shell\n$ forge test\n\n[⠢] Compiling...\nNo files changed, compilation skipped\n\nRunning 2 tests for test/Counter.t.sol:CounterTest\n[PASS] testIncrement() (gas: 28312)\n[PASS] testSetNumber(uint256) (runs: 256, μ: 27609, ~: 28387)\nTest result: ok. 2 passed; 0 failed; finished in 9.98ms\n```\n\n至此，您已完成上手使用 Foundry 并且初始化一个项目。\n\n\n\n\n\n## Foundry Cast的进阶使用\n主要介绍Foundry Cast的使用，使用Cast在命令行下达到[Ethereum (ETH) Blockchain Explorer](https://etherscan.io/) 的效果。\n\n练习如下目标\n* 查询区块\n* 查询交易\n* 交易解析\n* 账户管理\n* 合约查询\n* 合约交互\n* 编码解析\n* 本地模拟链上交易\n\n\n\n## 区块相关\n\n### 查询区块\n\n```shell\n# $RPC_MAIN 替换成需要的RPC地址\ncast block-number --rpc-url=$RPC_MAIN\n```\n\n输出结果：\n\n```\n15769241\n```\n> 将环境变量的ETH_RPC_URL设置为 --rpc-url 你就不需要在每个命令行后面增加 --rpc-url=$RPC_MAIN 我这里直接设置为主网\n\n### 查询区块信息\n\n```shell\n# cast block --rpc-url=$RPC_MAIN\n\ncast block 15769241 --rpc-url=$RPC_MAIN\n\n# 格式化\n\ncast block 15769241 --json --rpc-url=$RPC_MAIN\n\n\n```\n\n输出结果：\n\n```shell \nbaseFeePerGas 22188748210\ndifficulty 0\nextraData 0x\ngasLimit 30000000\ngasUsed 10595142\nhash 0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\nlogsBloom 0x1c6150404140580410990400a61d01e30030b00100c2a6310b11b9405d012980125671129881101011501d399081855523a106443aef3ab07148626315f721550290981058030b2af90b213961204c6103d2002a076c9e12d0800475b8231f0d06a20100da57c60aa0c008280128284418503340087c8650104c34500c18aa1c2070878008c21c64207d1424000244811415afc507640448122060644c181204ba412f0af11365020880508105551226004c0801c1840183003a42062a5a2444c13266020c00081440008038492740a8204a0c6c050a29d52405b92e4b20f028a97a604c6b0849ca81c4d06009258b4206217803a168824484deb8513242f082\nminer 0x4675C7e5BaAFBFFbca748158bEcBA61ef3b0a263\nmixHash 0x09b7a94ef1d6c93caaff49ca8bf387652e0e33e116076b61f4d5ee79f0b91f92\nnonce 0x0000000000000000\nnumber 15769241\nparentHash 0x95c60d89f2275a6a7b1a9545cf1fb6d8c614402cd7311c82bc7972c177f7812d\nreceiptsRoot 0xe0240d60c448387123e412114cd0165b2af7b926d34bb824f8c544b022aa76f9\nsealFields []\nsha3Uncles 0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347\nsize 149912\nstateRoot 0xaa3e9d839e99c4791827c81df9c9129028a320432920205f191e3fb261d0951c\ntimestamp 1666026803\ntotalDifficulty 58750003716598352816469\ntransactions: [\n\t0xc4f5c10e4419698edaf7431df464340b389e4b79db959d58f42e82e8d1ed18ae\n\t0xb90edeacf833ac6cb91a326c775ed86d8047a467404bd8c69782d2260983eaad\n\t0x6f280650e35238ab930c9a0f3163443fffe2efedc5b553f408174d4bcd89cd8d\n\t0x2e0eafea64aaf2f53240a16b11a4f250ba74ab9ca5a1a90e6f2a6e92185877d2\n\t0x34f41d22ed8209da379691640cec5bfb8bf9404ad0f7264709b7959d61532343\n\t0x7569ab5ce2d1ca13a0c65ad52cc901dfc186e8ff8800793550b97760cbe34db2\n\t0xcdeef0ffe859fcf96fb52e22a9789295c6f1a94280df9faf0ebb9d52abefb3e7\n\t0x00d6793f3dbdd616351441b9e3da9a0de51370174e0d9383b4aae5c3c9806c2a\n\t0xff3daf63a431af021351d3da5f2f39a894352328d7f3df96afab1888f5a7093f\n\t0x7938399bee5293c384831c8e5aa698cdb491d568f9ebfb6d5c946f4ef7bf7e51\n\t0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\n\t0x0435d78a1b62484fbe3a7680d68ba4bdf0d692f087f4a6b70eb377421c58a5dd\n\t0xe16d1fa4d60cca7447850337c63cdf7b888318cc1bbb893b115f262dc01132d7\n\t0x44af4f696dcfedee682d7e511ad2469780443052565eea731b86b652a175c05e\n\t0xe88732f92ac376efb6e7517e66fc586447e0d065b8686556f2c1a7c3b7a519ce\n\t0x7ee890b096e97fc0c7e3cf74e0f0402532e0f3b8fa0e0c494d3d691d031f57e7\n\t...]\n```\n\n## 交易相关\n\n### 查询交易\n\n```shell\n# 跟ethersjs中的 provider.getTransaction 类似\n# cast tx [FIELD] --rpc-url=$RPC\n\n# 跟ethersjs中的 provider.getTransactionReceipt类似\n# cast receipt [FIELD] --rpc-url=$RPC \n\ncast tx 0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0 --rpc-url=$RPC \n\ncast receipt 0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0 --rpc-url=$RPC\n\n# 只获取logs\n\ncast receipt 0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0 logs --rpc-url=$RPC\n\n```\n\n第一条命令行结果：\n\n```shell\nblockHash 0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\nblockNumber 15769241\nfrom 0x9C0649d7325990D98375F7864eA167B5EAdCD46a\ngas 313863\ngasPrice 35000000000\nhash 0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\ninput 0x38ed173900000000000000000000000000000000000000000000000332ca1b67940c000000000000000000000000000000000000000000000000000416b4849e6ba1475000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000009c0649d7325990d98375f7864ea167b5eadcd46a00000000000000000000000000000000000000000000000000000000634d91c1000000000000000000000000000000000000000000000000000000000000000200000000000000000000000097be09f2523b39b835da9ea3857cfa1d3c660cbb0000000000000000000000001bbf25e71ec48b84d773809b4ba55b6f4be946fb\nnonce 14\nr 0x288aef25af73a4d1916f8d37107ef5f24729a423f23acc38920829c4180fe794\ns 0x7644d26a91da02ff1e774cc821febf6387b8ee9f3e3085140b781819d0d8ede0\nto 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D\ntransactionIndex 10\nv 38\nvalue 0\n```\n\n第二行命令行结果：\n\n```shell\nblockHash 0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\nblockNumber 15769241\ncontractAddress\ncumulativeGasUsed 805082\neffectiveGasPrice 35000000000\ngasUsed 114938\nlogs [{\"address\":\"0x97be09f2523b39b835da9ea3857cfa1d3c660cbb\",\"topics\":[\"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\"0x0000000000000000000000009c0649d7325990d98375f7864ea167b5eadcd46a\",\"0x000000000000000000000000f848e97469538830b0b147152524184a255b9106\"],\"data\":\"0x00000000000000000000000000000000000000000000000332ca1b67940c0000\",\"blockHash\":\"0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\",\"blockNumber\":\"0xf09e99\",\"transactionHash\":\"0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\",\"transactionIndex\":\"0xa\",\"logIndex\":\"0x2\",\"removed\":false},{\"address\":\"0x1bbf25e71ec48b84d773809b4ba55b6f4be946fb\",\"topics\":[\"0x06b541ddaa720db2b10a4d0cdac39b8d360425fc073085fac19bc82614677987\",\"0x000000000000000000000000f848e97469538830b0b147152524184a255b9106\",\"0x000000000000000000000000f848e97469538830b0b147152524184a255b9106\",\"0x0000000000000000000000009c0649d7325990d98375f7864ea167b5eadcd46a\"],\"data\":\"0x0000000000000000000000000000000000000000000000044b0a580cbdcfc0d90000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\",\"blockHash\":\"0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\",\"blockNumber\":\"0xf09e99\",\"transactionHash\":\"0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\",\"transactionIndex\":\"0xa\",\"logIndex\":\"0x3\",\"removed\":false},{\"address\":\"0x1bbf25e71ec48b84d773809b4ba55b6f4be946fb\",\"topics\":[\"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\"0x000000000000000000000000f848e97469538830b0b147152524184a255b9106\",\"0x0000000000000000000000009c0649d7325990d98375f7864ea167b5eadcd46a\"],\"data\":\"0x0000000000000000000000000000000000000000000000044b0a580cbdcfc0d9\",\"blockHash\":\"0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\",\"blockNumber\":\"0xf09e99\",\"transactionHash\":\"0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\",\"transactionIndex\":\"0xa\",\"logIndex\":\"0x4\",\"removed\":false},{\"address\":\"0xf848e97469538830b0b147152524184a255b9106\",\"topics\":[\"0x1c411e9a96e071241c2f21f7726b17ae89e3cab4c78be50e062b03a9fffbbad1\"],\"data\":\"0x00000000000000000000000000000000000000000000213ebfba613ffdcdd6ad0000000000000000000000000000000000000000000018b4b7f855bdcaac3b14\",\"blockHash\":\"0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\",\"blockNumber\":\"0xf09e99\",\"transactionHash\":\"0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\",\"transactionIndex\":\"0xa\",\"logIndex\":\"0x5\",\"removed\":false},{\"address\":\"0xf848e97469538830b0b147152524184a255b9106\",\"topics\":[\"0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822\",\"0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d\",\"0x0000000000000000000000009c0649d7325990d98375f7864ea167b5eadcd46a\"],\"data\":\"0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000332ca1b67940c00000000000000000000000000000000000000000000000000044b0a580cbdcfc0d90000000000000000000000000000000000000000000000000000000000000000\",\"blockHash\":\"0x016e71f4130bac96a20761acbc0ba82a77c26f85513f1661adfd406d1c809543\",\"blockNumber\":\"0xf09e99\",\"transactionHash\":\"0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\",\"transactionIndex\":\"0xa\",\"logIndex\":\"0x6\",\"removed\":false}]\nlogsBloom 0x00200000000000000000000080000000000000000000000000010000000008000000000000800000000000000000000000000000002000000000000000000000000000000000000000000008000000200000000000000000000000400000100000000000800000002000000000000000000000400000000000000010000000000000000000000000005000000000040000000000000000080000004004000000000000084100000000000000000000000000000040000000000000000000040000000002000000000000000000000000000000000000001000002000000020000000000000000000000000000000000000004000000000000000000000000000\nroot\nstatus 1\ntransactionHash 0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\ntransactionIndex 10\ntype 0\n\n```\n\n### 交易解析\n\nCast 会从 [Ethereum Signature Database](https://sig.eth.samczsun.com.) 解析对应的方法名称\n\n```shell\n# cast 4byte 解析交易的名称\ncast 4byte 0x38ed1739\n```\n\n输出结果：\n\n```shell\nswapExactTokensForTokens(uint256,uint256,address[],address,uint256)\n```\n\n### 交易签名 \n\n> 使用 Keccak-256 能够计算出方法名\n> 函数名为被调函数原型[1]的Keccak-256哈希值的前4个字节。这允许EVM准确无误地识别被调函数。\n\n交易签名：\n\n```shell\n# cast sig \n\ncast sig \"swapExactTokensForTokens(uint256,uint256,address[],address,uint256)\"\n\n```\n\n输出结果：\n\n```shell\n0x38ed1739\n```\n\n所以你可以看到最终都是 `0x38ed1739`\n\n有些方法名称可能没有，你可以通过`cast upload-signature `上传给 [Ethereum Signature Database](https://sig.eth.samczsun.com) \n\n### 交易解码\n\n```shell\n# 获得calldata\ncast tx 0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0 input --rpc-url=$RPC\n\n# 可以通过该方法decode交易的数据，类似etherscan中的decode方法\n# cast pretty-calldata \ncast pretty-calldata 0x38ed173900000000000000000000000000000000000000000000000332ca1b67940c000000000000000000000000000000000000000000000000000416b4849e6ba1475000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000009c0649d7325990d98375f7864ea167b5eadcd46a00000000000000000000000000000000000000000000000000000000634d91c1000000000000000000000000000000000000000000000000000000000000000200000000000000000000000097be09f2523b39b835da9ea3857cfa1d3c660cbb0000000000000000000000001bbf25e71ec48b84d773809b4ba55b6f4be946fb\n```\n\n输出结果：\n\n```shell\n Possible methods:\n - swapExactTokensForTokens(uint256,uint256,address[],address,uint256)\n ------------\n [0]: 00000000000000000000000000000000000000000000000332ca1b67940c0000\n [1]: 00000000000000000000000000000000000000000000000416b4849e6ba14750\n [2]: 00000000000000000000000000000000000000000000000000000000000000a0\n [3]: 0000000000000000000000009c0649d7325990d98375f7864ea167b5eadcd46a\n [4]: 00000000000000000000000000000000000000000000000000000000634d91c1\n [5]: 0000000000000000000000000000000000000000000000000000000000000002\n [6]: 00000000000000000000000097be09f2523b39b835da9ea3857cfa1d3c660cbb\n [7]: 0000000000000000000000001bbf25e71ec48b84d773809b4ba55b6f4be946fb\n```\n\n### 模拟运行\n\n```\n# Usage: cast run --rpc-url \n\ncast run 0x20e7dda515f04ea6a787f68689e27bcadbba914184da5336204f3f36771f59f0\n```\n\n运行结果：\n\n![cast-run](./img/1.png)\n\n可以在结果中看到运行消耗的gas，以及方法顺序调用的过程，以及释放的emit的事件。通过这个可以了解一个hash的内在过程。类似 [BlockSec Building BlockChain Security Infrastructure](https://blocksec.com/) 和 [Tenderly | Ethereum Developer Platform](https://tenderly.co/) 可以结合使用。\n\n## 账户管理\n\n### 新建账户\n\n```shell\n# 新建一个账号\n# cast wallet new [OUT_DIR] \ncast wallet new\n\n# 新建一个keystore的账号，带有密码\n# cast wallet new \ncast wallet new ~/Downloads\n```\n\n第一条命令行结果输出：\n\n```shell\nSuccessfully created new key pair.\nAddress: 0xDD20b18E001A80d8b27B8Caa94EeAC884D1c****\nPrivate Key: edb4444199bddea91879c0214af27c0c7f99****bf18e46ba4078a39ccdbe0bc\n```\n\n第二条命令行结果输出：\n\n```shell\nEnter secret:\nCreated new encrypted keystore file: `/Users/EasyPlux/Downloads/b5832df5-21e9-4959-8c85-969eec9c0***`\\nPublic Address of the key: 0x58c1C8f6A7D92A9b20A5343949cd624570Ab****\n```\n\n### 账户签名\n\n```shell\n# 两种方法都可以使用签名，第一种载入刚才生成的keystore私钥，第二种直接输入自己的私钥。\ncast wallet sign --keystore= \ncast wallet sign -i\n```\n\n### 账户验证\n\n```shell\ncast wallet verify --address
\n```\n\n## 合约交互\n\n### 获取合约\n\n```shell\ncast etherscan-source \n\ncast etherscan-source 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 --etherscan-api-key='key'\n\n```\n\n### 下载合约\n\n```shell\n#cast etherscan-source -d \n# 我这里已经将$WETH的地址写入环境变量，如果没写入的，可以写成合约地址\ncast etherscan-source $WETH -d ~/Downloads\n```\n\n### 调用合约(读数据)\n\n`cast call` 用于从区块链上读取数据（调用只读函数），该操作不会改变区块链状态，也不需要支付 Gas 费用。下面我们调用 `WETH` 合约的`balanceOf`方法,查看 `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` 账号的余额\n\n```shell\n#cast call [OPTIONS] [TO] [SIG] [ARGS]... [COMMAND] --rpc-url=$RPC\n\ncast call $WETH \"balanceOf(address)\" 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 --rpc-url=$RPC\n\n# 输出\n# 0x0000000000000000000000000000000000000000000000230d12770f2845219c\n\n# 格式化输出 在参数后面加一个返回值的格式\n\ncast call $WETH \"balanceOf(address)(uint256)\" 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 --rpc-url=$RPC\n\n# 输出\n# 646577988758891995548\n\n```\n\n### 调用合约(写数据)\n\n`cast send` 用于发送交易并修改区块链状态（调用改变状态的函数），该操作会消耗 Gas 费用，需要签名并发送交易。\n\n```shell\n#cast send [OPTIONS] [TO] [SIG] [ARGS]... [COMMAND] --rpc-url=$RPC\n\ncast send 0x... \"deposit(address,uint256)\" 0x... 1 --rpc-url=$RPC\n\n```\n\n\n### 解析ABI\n\n可以根据ABI反向解析出solidity代码\n```shell\n# cast interface [OPTIONS] \ncast interface ./weth.abi\n```\n\n## 编码解码\n\n```shell\ncast --to-hex \n\ncast --to-dec \n\ncast --to-unit \n\ncast --to-wei \n\ncast --to-rlp \n\ncast --from-rlp\n\n```\n\n## Tips\n\n### 设置ETH_RPC_URL\n将环境变量的`ETH_RPC_URL`设置为 `--rpc-url`的值，这样你就不需要在每个命令行后面增加 `--rpc-url=$RPC_MAIN`，我这里直接设置为主网，如下：\n``` shell\nexport ETH_RPC_URL=your_rpc_url\nsource ~/.bashrc # 如果你使用的是 Bash\nsource ~/.zshrc # 如果你使用的是 Zsh\ncast block-number # 不用再配置 --rpc-url 参数\n```\n\n### 设置ETHERSCAN_API_KEY\n设置`ETHERSCAN_API_KEY`环境变量可以直接代替 `--etherscan-api-key`\n\n### JSON格式化\n\n加上 `--json` 可以格式化输出\n\n```shell\ncast block 15769241 --json --rpc-url=$RPC_MAIN\n```\n\n## Anvil本地节点的使用\n\n### 基本命令行\n\nanvil 跟 hardhat 还有 truffle中的ganache都是一样的，是一个本地的eth节点，同样拥有各种fork的功能。\n\n```shell\nanvil \nanvil --accounts= --balance= \nanvil --mnemonic= \nanvil --fork-url=$RPC --fork-block-number=\n```\n\n### RPC的使用\n\n```shell\nanvil_* -> hardhat_* \n\nanvil_impersonateAccount \n\nanvil_setStorageAt\n```\n\n## Forge命令行进阶的使用\n\n代码存放在`WTFSolidity/Topics/Tools/TOOL07_Foundry/hello_wtf`\n\n代码目录树如下：\n\n```shell\n.\n├── broadcast\n│ └── Counter.s.sol \n├── foundry.toml # foundry配置文件\n├── lib\n│ └── forge-std\n├── node_modules # 使用npm依赖包目录，你也可以直接使用forge install\n│ └── @openzeppelin\n├── package-lock.json\n├── package.json\n├── script\n│ └── Counter.s.sol # 脚本合约\n├── src\n│ └── Counter.sol\n└── test\n ├── Counter.t.sol\n └── Test.t.sol # 测试合约\n```\n\n### 初始化项目\n```shell\n\nforge init  \n\n# 使用模板初始化项目\nforge init --template \n\n```\n\n## 热更新\n\n```shell\nforge build -w\n```\n\n\n### 测试\n\n```shell\n# 三个v会现实详细的log信息，还显示失败测试的堆栈跟踪\nforge test -vvv\n# 四个v显示所有测试的堆栈跟踪，并显示失败测试的设置（setup）跟踪。\nforge test -vvvv\n# 热更新模式\nforge test -vvv -w\n\n# log打印 需要 - vv 2个v以上才可以\n```\n\n使用 console2.log(\"test\") 来打印\n\n```js\n\n\nfunction testSetNumber(uint256 x) public {\n console2.log(\"testNumber: %s==============\", x);\n counter.setNumber(x);\n assertEq(counter.number(), x);\n }\n```\n\n\n使用 emit log 来打印\n\n```js\nfunction testNumberIs42() public {\n emit log(\"test\");\n assertEq(testNumber, 42);\n }\n```\n\n改变 block.timestamp\n\n```js\n\nfunction testCheatCode()public {\n console2.Log(\"before:\"block.timestamp);\n vm.warp(1000);\n console2.log(\"after:\"block.timestamp);\n}\n\n```\n\n改变msg.sender 【可以模拟管理员账户】\n\n```js\n// 只有第一次有影响\nvm.prank(address)\n\n\n// 多次影响\nvm.startPrank(address)\n...code\nvm.stopPrank()\n\n```\n\n\n改变账户余额（也可以用于改变大多数ERC20代币余额）\n\n```js\nfunction testCheatCode()public{\n\tconsole2.Log(\"before:\"alice.balance);\n\tvm.deal(alice,1 ether);\n\tconsole2.Log(\"after:\"alice.balance);\n}\n\n```\n\n## 安装插件\n\n### 使用forge安装插件\n\n```shell\nforge install [OPTIONS] /@\n```\n\n### 使用npm安装插件\n\n```shell\nnpm init -y\nnpm i @openzeppelin/contracts \n// yarn add @openzeppelin/contracts\n```\n\n安装完成之后需要配置`foundry.toml`方法，在libs中添加 `node_modules`文件夹。\n\n```toml\n[profile.default]\nsrc = 'src'\nout = 'out'\nlibs = ['lib','node_modules']\n```\n\n\n## 测试一\n\n新建`test/Test.t.sol`\n\n```js\n// SPDX-License-Identifier: SEE LICENSE IN LICENSE\npragma solidity ^0.8.13;\n\nimport \"forge-std/Test.sol\";\nimport \"../src/Counter.sol\";\n// 导入IERC20的接口，通过该接口可以调用对应的方法\nimport {IERC20} from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\ncontract IERC20Test is Test {\n // 声明Counter合约对象变量\n Counter public counter;\n // 声明一个地址变量\n address public alice;\n // 声明一个msgSender\n address public msgSender;\n // 声明帮助合约函数\n Helper public h;\n\n //定义一个IERC20 合约对象\n IERC20 public dai;\n\n function setUp() public {\n // new测试合约对象\n counter = new Counter();\n // 调用对象方法\n counter.setNumber(0);\n // new helper对象\n h = new Helper();\n\n alice = address(10086);\n console2.log(alice);\n dai = IERC20(0x6B175474E89094C44Da98b954EedeAC495271d0F);\n }\n\n // 测试给合约地址转账\n function testCheatCode() public {\n console2.log(\"before:\", dai.balanceOf(alice));\n deal(address(dai), alice,1 ether);\n console2.log(\"after:\", dai.balanceOf(alice));\n }\n // 测试改变合约msg.sender\n function testCheatAddress() public {\n console2.log(\"before:\", h.whoCalled());\n vm.prank(address(1));\n console2.log(\"after:\", h.whoCalled());\n }\n}\n\n\ncontract Helper {\n function whoCalled() public view returns (address) {\n return msg.sender;\n }\n}\n```\n\n\n运行测试：\n\n因为本地没有dai的部署合约，所以我们直接fork主网， -vvv可以显示console2.log，-w表示watch模式。\n\n```shell\nforge test -vvv --fork-url=$ETH_RPC_URL -w\n```\n\n输出结果：\n\n```shell\nRunning 2 tests for test/Test.t.sol:IERC20Test\n[PASS] testCheatAddress() (gas: 12873)\nLogs:\n 0x0000000000000000000000000000000000002766\n before: 0xb4c79daB8f259C7Aee6E5b2Aa729821864227e84\n after: 0x0000000000000000000000000000000000000001\n\n[PASS] testCheatCode() (gas: 153596)\nLogs:\n 0x0000000000000000000000000000000000002766\n before: 0\n after: 1000000000000000000\n\nTest result: ok. 2 passed; 0 failed; finished in 5.61s\n```\n\n### 代码中fork网络\n\n```js\nfunction testCodeFork() public {\n console2.log(address(dai));\n string memory rpc = vm.envString(\"ETH_RPC_URL\");\n uint256 mainnet = vm.createFork(rpc);\n vm.selectFork(mainnet);\n // 这边下面开始就是直接fork网络了\n console2.log(\"before:\",dai.balanceOf(alice));\n deal(address(dai),alice,1 ether);\n console2.log(\"after:\",dai.balanceOf(alice));\n }\n```\n\n### 从代码中读取环境变量\n\n```js\n// 通过 vm.envAddress 获取环境变量中的地址\n dai = IERC20(vm.envAddress(\"DAI\"));\n```\n\n### 完整代码\n\n```js\n// SPDX-License-Identifier: SEE LICENSE IN LICENSE\npragma solidity ^0.8.13;\n\nimport \"forge-std/Test.sol\";\nimport \"../src/Counter.sol\";\n// 导入IERC20的接口，通过该接口可以调用对应的方法\nimport {IERC20} from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\ncontract IERC20Test is Test {\n // 声明Counter合约对象变量\n Counter public counter;\n // 声明一个地址变量\n address public alice;\n // 声明一个msgSender\n address public msgSender;\n // 声明帮助合约函数\n Helper public h;\n\n //定义一个IERC20 合约对象\n IERC20 public dai;\n\n function setUp() public {\n // new测试合约对象\n counter = new Counter();\n // 调用对象方法\n counter.setNumber(0);\n // new helper对象\n h = new Helper();\n\n alice = address(10086);\n console2.log(alice);\n // 通过 vm.envAddress 获取环境变量中的地址\n dai = IERC20(vm.envAddress(\"DAI\"));\n }\n\n\n // 测试给合约地址转账\n function testCheatCode() public {\n console2.log(\"before:\", dai.balanceOf(alice));\n deal(address(dai), alice,1 ether);\n console2.log(\"after:\", dai.balanceOf(alice));\n }\n // 测试改变合约msg.sender\n function testCheatAddress() public {\n console2.log(\"before:\", h.whoCalled());\n vm.prank(address(1));\n console2.log(\"after:\", h.whoCalled());\n }\n\n function testCodeFork() public {\n console2.log(address(dai));\n string memory rpc = vm.envString(\"ETH_RPC_URL\");\n uint256 mainnet = vm.createFork(rpc);\n vm.selectFork(mainnet);\n // 这边下面开始就是直接fork网络了\n console2.log(\"before:\",dai.balanceOf(alice));\n deal(address(dai),alice,1 ether);\n console2.log(\"after:\",dai.balanceOf(alice));\n }\n\n}\n\n\ncontract Helper {\n function whoCalled() public view returns (address) {\n return msg.sender;\n }\n}\n```\n\n### vm.sol\n\n`vm.sol` 中还有很多封装好的方法可以直接使用\n\n```js\n// Sets the *next* call's msg.sender to be the input address\n function prank(address) external;\n // Sets all subsequent calls' msg.sender to be the input address until `stopPrank` is called\n function startPrank(address) external;\n // Sets the *next* call's msg.sender to be the input address, and the tx.origin to be the second input\n function prank(address,address) external;\n // Sets all subsequent calls' msg.sender to be the input address until `stopPrank` is called, and the tx.origin to be the second input\n function startPrank(address,address) external;\n // Resets subsequent calls' msg.sender to be `address(this)`\n function stopPrank() external;\n // Sets an address' balance, (who, newBalance)\n function deal(address, uint256) external;\n // Sets an address' code, (who, newCode)\n function etch(address, bytes calldata) external;\n // Expects an error on next call\n function expectRevert(bytes calldata) external;\n function expectRevert(bytes4) external;\n function expectRevert() external;\n // Records all storage reads and writes\n function record() external;\n // Gets all accessed reads and write slot from a recording session, for a given address\n function accesses(address) external returns (bytes32[] memory reads, bytes32[] memory writes);\n```\n\n\n## 运行脚本\n\n```shell\nforge script [OPTIONS] [ARGS]...\nforge script script/Counter.s.sol:CounterScript\n```\n\n`script/Counter.s.sol` 脚本代码\n\n```js\n// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.13;\n\nimport \"forge-std/Script.sol\";\n\ncontract CounterScript is Script {\n// 每次初始化会运行\n function setUp() public {\n console2.log(\"setup \");\n }\n\n function run() public {\n vm.broadcast();\n console2.log(\"run\");\n }\n\n function someFunction(uint256 x) public {\n console2.log(\"some other func\");\n console2.log(x);\n }\n}\n\n```\n\n指定方法，带参数的测试运行\n\n```shell\nforge script script/Counter.s.sol --sig=\"someFunction(uint256 x)\" 10\n```\n\n## 脚本部署合约\n\n编写部署脚本：\n```solidity\n// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.13;\n\nimport \"forge-std/Script.sol\";\n// 引入合约\nimport \"../src/Counter.sol\";\n\ncontract CounterScript is Script {\n function setUp() public {\n console2.log(\"setup \");\n }\n\n function run() public {\n // 开始记录脚本中合约的调用和创建\n vm.startBroadcast();\n //生成合约对象\n Counter c = new Counter();\n // 结束记录\n vm.stopBroadcast();\n }\n}\n\n```\n\n测试部署：\n\n```shell\nforge script script/Counter.s.sol -vvvv --rpc-url=http://127.0.0.1:8545\n```\n\n正式部署：\n\n```\nforge script script/Counter.s.sol -vvvv --rpc-url=$RPC_MAIN --broadcast --private-key=privete_key\n```\n\n部署完成之后会多一个broadcast文件夹，查看该文件夹有`run-latest.json`可以看到部署的相应信息。\n\n### 部署多个网络\n\n使用fork代码可以部署多个网络\n\n\n```js\nuint256 mainnet = vm.createFork(rpc);\n```\n\n## 命令行部署合约\n\n部署并开源合约，其中 `--etherscan-api-key` 为以太坊浏览器（或其他 EVM 浏览器）中申请的 API key，`--verify` 为部署后开源合约。\n```solidity\n# forge create --rpc-url --private-key --etherscan-api-key --verify src/YourContract.sol:YourContract --constructor-args \n forge create --rpc-url $RPC_MAIN \\ \n --private-key privete_key \\ \n --etherscan-api-key xxxx \\ \n --verify \\\n src/Counter.sol:Counter\n```\n\n## Tips： \n\n```shell\nforge test --gas-report\n\n# 获取合约相关信息，例如abi、bytecode等等\nforge inspect \n\n# 生成gas快照\nforge snapshot\n\n# 当前快照文件与最新更改进行比较，对比gas是否减少\nforge snapshot --diff \n\n# 交互式Debugger\nforge script script/Counter.s.sol --debug\n\n# 链上交易debugger\nforge run --debug\n\n```\n\n\n\n## 总结\n\n这一讲我们介绍了以Solidity为中心的开发工具，并介绍了如何利用Foundry编译，部署，测试智能合约。由于Foundry的部署和测试脚本都是用Solidity编写，免去了开发者学习javascript的时间成本，并提供了更多练习Solidity的机会，推荐大家使用。\n\n\n## 参考\n[使用 foundry 框架加速智能合约开发](https://www.youtube.com/watch?v=EXYeltwvftw) \n[cast Commands - Foundry Book](https://book.getfoundry.sh/reference/cast/)\n[https://twitter.com/wp__lai](https://twitter.com/wp__lai)\n","Topics/Tools/TOOL06_Hardhat/package.json":"{\n \"name\": \"tool06_hardhat\",\n \"version\": \"1.0.0\",\n \"description\": \"我最近在重新学solidity，巩固一下细节，也写一个“WTF Solidity极简入门”，供小白们使用），每周更新1-3讲。\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"test\": \"echo \\\"Error: no test specified\\\" && exit 1\"\n },\n \"keywords\": [],\n \"author\": \"\",\n \"license\": \"ISC\",\n \"devDependencies\": {\n \"@nomicfoundation/hardhat-toolbox\": \"^4.0.0\",\n \"hardhat\": \"^2.22.2\"\n },\n \"directories\": {\n \"test\": \"test\"\n }\n}\n","Topics/Tools/TOOL06_Hardhat/readme.md":"# WTF Solidity极简入门-工具篇6：Hardhat以太坊开发环境\n\n我最近在重新学 Solidity，巩固一下细节，也写一个“WTF Solidity极简入门”，供小白们使用（编程大佬可以另找教程），每周更新 1-3 讲。\n\n推特：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy_](https://twitter.com/WTFAcademy_)\n\n社区：[Discord](https://discord.gg/5akcruXrsk)｜[微信群](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[官网 wtf.academy](https://wtf.academy)\n\n所有代码和教程开源在 github: [github.com/AmazingAng/WTF-Solidity](https://github.com/AmazingAng/WTF-Solidity)\n\n-----\n\nHardhat是以太坊最流行的开发环境，它可以帮你编译和部署智能合约，并且提供了Hardhat Network支持本地测试和运行Solidity。这一讲，我们将介绍如何安装Hardhat，使用Hardhat编写并编译合约，并运行简单的测试。\n\n## Hardhat安装\n\n### 安装node\n\n可以使用 nvm 安装node\n\n[GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions](https://github.com/nvm-sh/nvm)\n\n### 安装Hardhat\n\n打开命令行工具，输入：\n```shell\nmkdir hardhat-demo\ncd hardhat-demo\nnpm init -y\nnpm install --save-dev hardhat\n```\n\n### 创建Hardhat项目\n打开命令行工具，输入：\n\n```shell\ncd hardhat-demo\nnpx hardhat\n```\n\n选择第三项：创建空白项目配置 `Create an empty hardhat.config.js`\n\n```shell\nWelcome to Hardhat v2.22.2\n\n? What do you want to do? ...\n> Create a JavaScript project\n Create a TypeScript project\n Create a TypeScript project (with Viem)\n Create an empty hardhat.config.js\n Quit\n```\n\n### 安装插件\n```shell\nnpm install --save-dev @nomicfoundation/hardhat-toolbox\n```\n\n将插件添加到你的hardhat配置文件中 `hardhat.config.js`\n\n```js\nrequire(\"@nomicfoundation/hardhat-toolbox\");\n\n/** @type import('hardhat/config').HardhatUserConfig */\nmodule.exports = {\n solidity: \"0.8.21\",\n};\n```\n\n## 编写并编译合约\n如果你用过remix，那么你直接在remix上点击保存的时候，会自动帮你编译的。但是在本地的hardhat开发环境中，你需要手动编译合约。\n\n### 新建合约目录\n\n新建`contracts`合约目录，并添加第31章节的ERC20合约。\n\n### 编写合约\n这里的合约直接使用[WTF Solidity第31讲](https://github.com/AmazingAng/WTF-Solidity/blob/main/31_ERC20/readme.md)的ERC20合约\n\n```js\n// SPDX-License-Identifier: MIT\n// WTF Solidity by 0xAA\n\npragma solidity ^0.8.21;\n\nimport \"./IERC20.sol\";\n\ncontract ERC20 is IERC20 {\n\n mapping(address => uint256) public override balanceOf;\n\n mapping(address => mapping(address => uint256)) public override allowance;\n\n uint256 public override totalSupply; // 代币总供给\n\n string public name; // 名称\n string public symbol; // 符号\n \n uint8 public decimals = 18; // 小数位数\n\n // @dev 在合约部署的时候实现合约名称和符号\n constructor(string memory name_, string memory symbol_){\n name = name_;\n symbol = symbol_;\n }\n\n // @dev 实现`transfer`函数，代币转账逻辑\n function transfer(address recipient, uint amount) external override returns (bool) {\n balanceOf[msg.sender] -= amount;\n balanceOf[recipient] += amount;\n emit Transfer(msg.sender, recipient, amount);\n return true;\n }\n\n // @dev 实现 `approve` 函数, 代币授权逻辑\n function approve(address spender, uint amount) external override returns (bool) {\n allowance[msg.sender][spender] = amount;\n emit Approval(msg.sender, spender, amount);\n return true;\n }\n\n // @dev 实现`transferFrom`函数，代币授权转账逻辑\n function transferFrom(\n address sender,\n address recipient,\n uint amount\n ) external override returns (bool) {\n allowance[sender][msg.sender] -= amount;\n balanceOf[sender] -= amount;\n balanceOf[recipient] += amount;\n emit Transfer(sender, recipient, amount);\n return true;\n }\n\n // @dev 铸造代币，从 `0` 地址转账给 调用者地址\n function mint(uint amount) external {\n balanceOf[msg.sender] += amount;\n totalSupply += amount;\n emit Transfer(address(0), msg.sender, amount);\n }\n\n // @dev 销毁代币，从 调用者地址 转账给 `0` 地址\n function burn(uint amount) external {\n balanceOf[msg.sender] -= amount;\n totalSupply -= amount;\n emit Transfer(msg.sender, address(0), amount);\n }\n\n}\n\n```\n\n### 编译合约\n```shell\nnpx hardhat compile\n```\n\n看到如下输出，说明合约编译成功：\n\n```shell\nCompiling 2 Solidity files successfully\n```\n\n成功后，你会在文件夹下看到`artifacts`目录，里面的`json`文件就是编译结果。\n\n## 编写单元测试\n\n这里的单元测试非常简单，仅包含部署合约并测试合约地址是否合法（是否部署成功）。\n\n新建测试文件夹`test`，在其中新建`test.js`。单元测试中，我们会用到`chai`和`ethers.js`两个库，分别用于测试和链上交互。对`ethers.js`不了解的开发者，可以看下[WTF Ethers极简教程](https://github.com/WTFAcademy/WTF-Ethers)的前6讲。我们之后的教程会更详细的介绍`chai`和`mocha`。\n\n```js\nconst { expect } = require('chai');\nconst { ethers } = require('hardhat');\n\n\ndescribe(\"ERC20 合约测试\", ()=>{\n it(\"合约部署\", async () => {\n // ethers.getSigners,代表eth账号 ethers 是一个全局函数，可以直接调用\n const [owner, addr1, addr2] = await ethers.getSigners();\n // ethers.js 中的 ContractFactory 是用于部署新智能合约的抽象，因此这里的 ERC20 是我们代币合约实例的工厂。ERC20代表contracts 文件夹中的 ERC20.sol 文件\n const Token = await ethers.getContractFactory(\"ERC20\");\n // 部署合约, 传入参数 ERC20.sol 中的构造函数参数分别是 name, symbol 这里我们都叫做WTF\n const hardhatToken = await Token.deploy(\"WTF\", \"WTF\"); \n await hardhatToken.waitForDeployment();\n // 获取合约地址\n const ContractAddress = await hardhatToken.target;\n expect(ContractAddress).to.properAddress;\n });\n})\n```\n\n## 运行测试\n\n在命令行输入以下内容运行测试：\n\n```shell\nnpx hardhat test\n# 如果有多个文件想跑指定文件可以使用\nnpx mocha test/test.js\n```\n\n看到如下输出，说明测试成功。\n\n```shell\n ERC20 合约测试\n ✔ 合约部署 (1648ms)\n\n\n 1 passing (2s)\n```\n\n## 部署合约\n\n在remix中，我们只需要点击一下`deploy`就可以部署合约了，但是在本地hardhat中，我们需要编写一个部署脚本。\n\n新建一个`scripts`文件夹，我们来编写部署合约脚本。并在该目录下新建一个`deploy.js`\n\n输入以下代码\n\n```js\n// 我们可以通过 npx hardhat run