> For the complete documentation index, see [llms.txt](https://www.docszh.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.docszh.com/berachain-docs/nodes/node-guides/kurtosis.md). # 使用 Kurtosis 运行本地开发网 本节将演示部署一个Berachain开发网 (未连接到 bArtio)。 {% hint style="info" %} Berachain开发网的原生dApp、合约等功能可能仍在开发中。 {% endhint %} ### 先决条件 开始之前，请确保你的本地设备上满足以下条件： * [Docker](https://docs.docker.com/get-docker/)：`version 25.0.2`或更高版本 * [Kurtosis](https://docs.kurtosis.com/install)：`v0.90.1`或更高版本 * [Foundry](https://book.getfoundry.sh/getting-started/installation)：`v0.2.0`或更高版本 (用于测试) ### Kurtosis本地开发网 本步骤需要设置并运行多个服务和执行客户端。 {% hint style="danger" %} **警告**：这可能需要相当多的资源来运行，如果遇到限制，请修改yaml配置文件以限制节点/服务的数量。 {% endhint %} 在默认的Kurtosis配置中，将运行以下内容： * 5个验证节点 * 3个全节点 * 6项附加服务 可以通过修改[beaconkit-all.yaml](https://github.com/berachain/beacon-kit/blob/main/kurtosis/beaconkit-all.yaml)以符合你的设备配置。 #### 第 1 步：复制代码库并运行节点 运行以下代码，复制Kurtosis代码库： ```bash git clone https://github.com/berachain/beacon-kit; cd beacon-kit; ``` 然后，运行以下代码，运行Make脚本： {% hint style="info" %} 如果遇到问题，请参阅[故障排除](#gu-zhang-pai-chu)。 {% endhint %} ```bash # FROM: ./beacon-kit make start-devnet; # [Expected Output]: # Checking for Kurtosis installation... # Kurtosis is already installed # /Applications/Xcode.app/Contents/Developer/usr/bin/make build-docker VERSION=kurtosis-local start-devnet-no-build # Build a release docker image for the Cosmos SDK chain... # docker build \ # --platform linux/arm64 \ # --build-arg GIT_COMMIT=f3738205bcd8c91f3c262618b078eeefb48a67f3 \ # --build-arg GIT_VERSION=kurtosis-local \ # --build-arg GIT_BRANCH=main \ # --build-arg GOOS=linux \ # --build-arg GOARCH=arm64 \ # -f ./Dockerfile \ # -t beacond:kurtosis-local \ # . # [+] Building 26.0s (33/41) # ... # Starlark code successfully run. No output was returned. # # ⭐ us on GitHub - https://github.com/kurtosis-tech/kurtosis # INFO[2024-06-27T00:16:11-04:00] ======================================================== # INFO[2024-06-27T00:16:11-04:00] || Created enclave: my-local-devnet || # INFO[2024-06-27T00:16:11-04:00] ======================================================== # Name: my-local-devnet # UUID: 3c23eccb8c64 # Status: RUNNING # Creation Time: Thu, 27 Jun 2024 00:14:55 EDT # Flags: # # ========================================= Files Artifacts ========================================= # UUID Name # b5aae73c6271 ancient-butterfly # 601914df8eea cosmos-genesis-final # 2c8346b3df40 el_cl_genesis_data # 38571b521297 genesis_file # 978405cf0e0f geth-config # 46c4a6d9988e jwt_file # 39ab7b9e6b01 kzg_trusted_setup # 0f6148946b08 multiple-premined-deposits # c59bf8b35b60 nether_genesis_file # 0c84ab86dd73 nethermind-config # e965d7a7faa0 node-beacond-config-0 # 030b600e169c node-beacond-config-1 # 8d644e614430 node-beacond-config-2 # 618d91e2218d node-beacond-config-3 # 447d51638f49 node-beacond-config-4 # 7d656edde80a prometheus-config # 9d93c25b6424 reth-config # 3e7411b9e325 vast-storm # # ========================================== User Services ========================================== # UUID Name Ports Status # 79f7561b4b43 blockscout http: 4000/tcp -> http://127.0.0.1:53414 RUNNING # 26c02bed0a42 blockscout-postgres postgresql: 5432/tcp -> postgresql://127.0.0.1:53306 RUNNING # fd16c170438f blockscout-verif http: 8050/tcp -> http://127.0.0.1:53345 RUNNING # f545ea9b37d9 blutgang admin: 5715/tcp -> http://127.0.0.1:52505 RUNNING # http: 3000/tcp -> http://127.0.0.1:52506 # b018cf002dc9 cl-full-beaconkit-0 cometbft-grpc: 9090/tcp -> 127.0.0.1:51243 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:51245 # cometbft-rest: 1317/tcp -> 127.0.0.1:51244 # cometbft-rpc: 26657/tcp -> 127.0.0.1:51246 # metrics: 26660/tcp -> 127.0.0.1:51247 # e2e1c5b99640 cl-full-beaconkit-1 cometbft-grpc: 9090/tcp -> 127.0.0.1:51235 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:51237 # cometbft-rest: 1317/tcp -> 127.0.0.1:51236 # cometbft-rpc: 26657/tcp -> 127.0.0.1:51233 # metrics: 26660/tcp -> 127.0.0.1:51234 # 85954427d8ed cl-full-beaconkit-2 cometbft-grpc: 9090/tcp -> 127.0.0.1:51239 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:51241 # cometbft-rest: 1317/tcp -> 127.0.0.1:51240 # cometbft-rpc: 26657/tcp -> 127.0.0.1:51242 # metrics: 26660/tcp -> 127.0.0.1:51238 # 01c06ac63cdf cl-seed-beaconkit-0 cometbft-grpc: 9090/tcp -> 127.0.0.1:51194 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:51191 # cometbft-rest: 1317/tcp -> 127.0.0.1:51195 # cometbft-rpc: 26657/tcp -> 127.0.0.1:51192 # metrics: 26660/tcp -> 127.0.0.1:51193 # 0f4df1fc5824 cl-validator-beaconkit-0 cometbft-grpc: 9090/tcp -> 127.0.0.1:52318 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:52315 # cometbft-rest: 1317/tcp -> 127.0.0.1:52314 # cometbft-rpc: 26657/tcp -> 127.0.0.1:52316 # metrics: 26660/tcp -> 127.0.0.1:52317 # 81d2e6091425 cl-validator-beaconkit-1 cometbft-grpc: 9090/tcp -> 127.0.0.1:52321 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:52323 # cometbft-rest: 1317/tcp -> 127.0.0.1:52322 # cometbft-rpc: 26657/tcp -> 127.0.0.1:52319 # metrics: 26660/tcp -> 127.0.0.1:52320 # 31ac5a4a8367 cl-validator-beaconkit-2 cometbft-grpc: 9090/tcp -> 127.0.0.1:52342 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:52339 # cometbft-rest: 1317/tcp -> 127.0.0.1:52338 # cometbft-rpc: 26657/tcp -> 127.0.0.1:52340 # metrics: 26660/tcp -> 127.0.0.1:52341 # 16a9f7c56f2c cl-validator-beaconkit-3 cometbft-grpc: 9090/tcp -> 127.0.0.1:52332 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:52329 # cometbft-rest: 1317/tcp -> 127.0.0.1:52328 # cometbft-rpc: 26657/tcp -> 127.0.0.1:52330 # metrics: 26660/tcp -> 127.0.0.1:52331 # 350ad296d808 cl-validator-beaconkit-4 cometbft-grpc: 9090/tcp -> 127.0.0.1:52337 RUNNING # cometbft-p2p: 26656/tcp -> 127.0.0.1:52334 # cometbft-rest: 1317/tcp -> 127.0.0.1:52333 # cometbft-rpc: 26657/tcp -> 127.0.0.1:52335 # metrics: 26660/tcp -> 127.0.0.1:52336 # 6e118e6069ea el-full-geth-2 engine-rpc: 8551/tcp -> 127.0.0.1:51205 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51208 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51204 # metrics: 9001/tcp -> 127.0.0.1:51206 # tcp-discovery: 30303/tcp -> 127.0.0.1:51207 # udp-discovery: 30303/udp -> 127.0.0.1:62535 # a02f6e9ffb57 el-full-reth-0 engine-rpc: 8551/tcp -> 127.0.0.1:51216 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51214 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51215 # metrics: 9001/tcp -> 127.0.0.1:51217 # tcp-discovery: 30303/tcp -> 127.0.0.1:51218 # udp-discovery: 30303/udp -> 127.0.0.1:63859 # 66ec4f86f9a8 el-full-reth-1 engine-rpc: 8551/tcp -> 127.0.0.1:51211 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51209 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51210 # metrics: 9001/tcp -> 127.0.0.1:51212 # tcp-discovery: 30303/tcp -> 127.0.0.1:51213 # udp-discovery: 30303/udp -> 127.0.0.1:52493 # 985f34bb632c el-seed-reth-0 engine-rpc: 8551/tcp -> 127.0.0.1:51178 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51181 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51182 # metrics: 9001/tcp -> 127.0.0.1:51179 # tcp-discovery: 30303/tcp -> 127.0.0.1:51180 # udp-discovery: 30303/udp -> 127.0.0.1:64586 # ff5d4880de7e el-validator-besu-0 engine-rpc: 8551/tcp -> 127.0.0.1:51449 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51452 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51453 # metrics: 9001/tcp -> 127.0.0.1:51450 # tcp-discovery: 30303/tcp -> 127.0.0.1:51451 # udp-discovery: 30303/udp -> 127.0.0.1:55464 # 3677d9c2ab08 el-validator-erigon-4 engine-rpc: 8551/tcp -> 127.0.0.1:51416 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51419 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51415 # metrics: 9001/tcp -> 127.0.0.1:51417 # tcp-discovery: 30303/tcp -> 127.0.0.1:51418 # udp-discovery: 30303/udp -> 127.0.0.1:52140 # 8a8d0605d110 el-validator-geth-3 engine-rpc: 8551/tcp -> 127.0.0.1:51456 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51454 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51455 # metrics: 9001/tcp -> 127.0.0.1:51457 # tcp-discovery: 30303/tcp -> 127.0.0.1:51458 # udp-discovery: 30303/udp -> 127.0.0.1:57790 # 27c61431bf07 el-validator-nethermind-1 engine-rpc: 8551/tcp -> 127.0.0.1:51440 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51443 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51444 # metrics: 9001/tcp -> 127.0.0.1:51441 # tcp-discovery: 30303/tcp -> 127.0.0.1:51442 # udp-discovery: 30303/udp -> 127.0.0.1:60619 # bb829e4f06e5 el-validator-reth-2 engine-rpc: 8551/tcp -> 127.0.0.1:51423 RUNNING # eth-json-rpc: 8545/tcp -> 127.0.0.1:51421 # eth-json-rpc-ws: 8546/tcp -> 127.0.0.1:51422 # metrics: 9001/tcp -> 127.0.0.1:51424 # tcp-discovery: 30303/tcp -> 127.0.0.1:51420 # udp-discovery: 30303/udp -> 127.0.0.1:52707 # cc6bfe221c4e goomy-blob-spammer RUNNING # 6e417d31c1dd grafana dashboards: 3000/tcp -> http://127.0.0.1:52841 RUNNING # 5c5b3c300c71 prometheus http: 9090/tcp -> http://127.0.0.1:52746 RUNNING # e5d817a7ff20 pyroscope pyroscope: 4040/tcp -> http://127.0.0.1:53224 RUNNING # fc84cfef2319 tx-fuzz-0 RUNNING # 1dd2fece619b tx-fuzz-1 RUNNING # 26df503b9a05 tx-fuzz-10 RUNNING # 9e979dffa8f3 tx-fuzz-11 RUNNING # e6bf3df68ab5 tx-fuzz-12 RUNNING # caf8e90eb636 tx-fuzz-13 RUNNING # b37cfe191eba tx-fuzz-14 RUNNING # ac0a401c2e31 tx-fuzz-15 RUNNING # c7877a3e9efa tx-fuzz-2 RUNNING # c13b0dd16da6 tx-fuzz-3 RUNNING # f92b5661000c tx-fuzz-4 RUNNING # 6afbb7c0a215 tx-fuzz-5 RUNNING # d6cc564bf8fd tx-fuzz-6 RUNNING # d6f6ac4fcba1 tx-fuzz-7 RUNNING # 00dc8cdbb379 tx-fuzz-8 RUNNING # 78f3100e7ce8 tx-fuzz-9 RUNNING ``` #### 第 2 步：测试本地开发网 测试本地开发网是否正常工作，只需运行本地区块浏览器： ```bash open http://127.0.0.1:53414; # 注意: 端口(53414)是随机的, 不同部署环境有所不同 ```
#### 第 3 步：配置钱包 查看现有的示例钱包地址和私钥列表，请参阅[Constants.star](https://github.com/berachain/beacon-kit/blob/main/kurtosis/src/constants.star) 首先，将开发网网络参数添加到MetaMask钱包。 {% hint style="info" %} 区块浏览器端口(53414)是随机的，不同部署环境有所不同，请检查操作日志。 {% endhint %} | 参数 | 值 | | ------- | ------------------------ | | 网络名称 | Berachain Local Devnet | | RPC地址 | | | 链 ID | 80087 | | Gas代币符号 | BERA | | 区块浏览器 | | 接下来，导入一个[Constants.star](https://github.com/berachain/beacon-kit/blob/main/kurtosis/src/constants.star)中示例钱包地址和私钥。 **文件位置**：`./kurtosis/src/constants.star` ```python # ... PRE_FUNDED_ACCOUNTS = [ new_prefunded_account( "0x20f33ce90a13a4b5e7697e3544c3083b8f8a51d4", # Import this ↓ "fffdbb37105441e14b0ee6330d855d8504ff39e705c3afa8f859ac9865f99306", # ), # ... ``` 成功导入，会在MetaMask钱包显示帐户`0x20f33ce90a13a4b5e7697e3544c3083b8f8a51d4`：
#### 第 4 步：部署合约 接下来，运行[Berachain Guides HelloWorld.sol](https://github.com/berachain/guides/blob/main/apps/hardhat-viem-helloworld/contracts/HelloWorld.sol)将`HelloWorld`合约部署到本地开发网。 ```bash # FROM: ./beacon-kit; mkdir tmp; touch tmp/HelloWorld.sol; ``` **文件位置：**`./tmp/HelloWorld.sol` ```solidity // SPDX-License-Identifier: UNLICENSED pragma solidity ^0.8.9; contract HelloWorld { // Events that allows for emitting a message event NewGreeting(address sender, string message); // Variables string greeting; // Main constructor run at deployment constructor(string memory _greeting) { greeting = _greeting; emit NewGreeting(msg.sender, _greeting); } // Get function function getGreeting() public view returns (string memory) { return greeting; } // Set function function setGreeting(string memory _greeting) public { greeting = _greeting; emit NewGreeting(msg.sender, _greeting); } } ``` 然后，运行`cast`请求，部署字节码。 ```bash # FROM: ./ forge create --rpc-url http://127.0.0.1:51208 --private-key fffdbb37105441e14b0ee6330d855d8504ff39e705c3afa8f859ac9865f99306 tmp/HelloWorld.sol:HelloWorld --constructor-args "Initial greeting message" --legacy; # [Expected Output]: # [⠊] Compiling... # No files changed, compilation skipped # Deployer: 0x20f33CE90A13a4b5E7697E3544c3083B8F8A51D4 # Deployed to: 0x4d31F9761DEe0132A17794018143360113575cFE # Transaction hash: 0xf18d36b5aeb9b5acc6711b65944a392fd659f34966156e475c5d15cb733677d9 ``` 接下来，你应该能在区块浏览器中，看到如下内容： ```bash # NOTE: The block explorer will take time to index everything so it might not show up right away open http://127.0.0.1:53414/tx/0xf18d36b5aeb9b5acc6711b65944a392fd659f34966156e475c5d15cb733677d9; ``` #### 第 5 步：读取合约 读取合约，以验证合约是否成功部署，以及初始消息是否已设置。 ```bash cast call 0x4d31F9761DEe0132A17794018143360113575cFE "getGreeting()" --rpc-url http://127.0.0.1:51208 | xxd -r -p; # [Expected Output]: # Initial greeting message ``` #### 第 6 步：写入合约 接下来，写入合约，并再次读取更新后的合约消息： ```bash cast send 0x4d31F9761DEe0132A17794018143360113575cFE "setGreeting(string)" "Hello From Devnet" --rpc-url http://127.0.0.1:51208 --private-key fffdbb37105441e14b0ee6330d855d8504ff39e705c3afa8f859ac9865f99306 --legacy; # [Expected Output]: # blockHash 0xa47a10872a0b162d7f95f2339a246b3be2fa0b5df262bc0ccb9ebd50bcc20269 # blockNumber 1783 # contractAddress # cumulativeGasUsed 29746 # effectiveGasPrice 258831769 # from 0x20f33CE90A13a4b5E7697E3544c3083B8F8A51D4 # gasUsed 29746 # logs [{"address":"0x4d31f9761dee0132a17794018143360113575cfe","topics":["0xcbc299eeb7a1a982d3674880645107c4fe48c3227163794e48540a7522722354"],"data":"0x00000000000000000000000020f33ce90a13a4b5e7697e3544c3083b8f8a51d40000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000001148656c6c6f2046726f6d204465766e6574000000000000000000000000000000","blockHash":"0xa47a10872a0b162d7f95f2339a246b3be2fa0b5df262bc0ccb9ebd50bcc20269","blockNumber":"0x6f7","transactionHash":"0xc7ef2bbd80866be88cbd83abddeeaeab10af5263bc1ef86ce683cafbd52d8a16","transactionIndex":"0x0","logIndex":"0x0","removed":false}] # logsBloom 0x00000000000000000000000000000000008000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000080000000100040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 # root # status 1 (success) # transactionHash 0xc7ef2bbd80866be88cbd83abddeeaeab10af5263bc1ef86ce683cafbd52d8a16 # transactionIndex 0 # type 0 # blobGasPrice # blobGasUsed # to 0x4d31F9761DEe0132A17794018143360113575cFE ``` 读取更新后的合约消息： ```bash cast call 0x4d31F9761DEe0132A17794018143360113575cFE "getGreeting()" --rpc-url http://127.0.0.1:51208 | xxd -r -p; # [Expected Output]: # Hello From Devnet ``` #### 第 7 步：重置 运行以下代码，可以删除所有服务和清理数据： ```bash # FROM: ./beacon-kit # NOTE: These may get stuck - in that case see Debugging Issues below make stop-devnet; make rm-devnet; # [Expected Output]: # kurtosis enclave stop my-local-devnet # ... ``` ### 故障排除 在MacOS系统中，Docker可能会停止运行。如出现此情况，请尝试运行`kurtosis clean -a`。如问题仍然存在，请尝试删除所有容器，并重启Docker。 ```bash # To remove all docker instances quickly docker rm -f $(docker ps -aq); # [Expected Output]: # 7c1dce7eebfb # 91bb1725781b # 41691876aeda # ... ```