> 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 # ... ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://www.docszh.com/berachain-docs/nodes/node-guides/kurtosis.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.