> For the complete documentation index, see [llms.txt](https://docs.validator247.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.validator247.com/testnet/penumbra.md). # Penumbra ## **Public Endpoints** > > > ## Manual Installation First make sure you have installed the latest system components ## System requirements ``` 8GB RAM 2-4 vCPUS ~200GB persistent storage (~20GB/week) ``` ## Installing pd ``` curl -sSfL -O https://github.com/penumbra-zone/penumbra/releases/download/v0.75.0/pd-x86_64-unknown-linux-gnu.tar.gz tar -xf pd-x86_64-unknown-linux-gnu.tar.gz sudo mv pd-x86_64-unknown-linux-gnu/pd /usr/local/bin/ # confirm the pd binary is installed by running: pd --version ``` ## Installing CometBFT From Source ``` echo export GOPATH=\"\$HOME/go\" >> ~/.bash_profile echo export PATH=\"\$PATH:\$GOPATH/bin\" >> ~/.bash_profile ``` Get Source Code ``` git clone https://github.com/cometbft/cometbft.git cd cometbft git checkout v0.37.5 make install ``` Compile ``` make install ``` to put the binary in $GOPATH/bin or use: ``` make build ``` check version ``` cometbft version ``` ## Joining a Testnet Resetting state ``` pd testnet unsafe-reset-all ``` Generating configs ``` pd testnet join --external-address IP_ADDRESS:26656 --moniker MY_NODE_NAME ``` Running pd and cometbft ``` pd start ``` Set up SystemD, you can create a separate tmux for convenient operation. After creating, save. ``` nano /etc/systemd/system/pd.service ``` edit service files to customize for your system ``` [Unit] Description=pd node After=network-online.target [Service] User=root WorkingDirectory=/root/.penumbra/testnet_data/node0 ExecStart=/usr/local/bin/pd start Restart=on-failure RestartSec=5 LimitNOFILE=65535 [Install] WantedBy=multi-user.target sudo systemctl daemon-reload sudo systemctl restart pd ``` Then (perhaps in another terminal), run CometBFT, specifying --home: ``` cometbft start --home ~/.penumbra/testnet_data/node0/cometbft ``` Check logs ``` sudo journalctl -u pd -f ``` ## Creat Wallet Installing pcli ``` curl --proto '=https' --tlsv1.2 -LsSf https://github.com/penumbra-zone/penumbra/releases/download/v0.75.0/pcli-installer.sh | sh ``` Create PATH Environment Variable ``` export PATH="$HOME/.cargo/bin:$PATH" source ~/.bashrc ``` confirm the pcli binary is installed by running: ``` pcli --version ``` Generating a Wallet ``` pcli init soft-kms generate ``` ## Becoming a validator Create a Definition Template ``` pcli validator definition template \ --tendermint-validator-keyfile ~/.penumbra/testnet_data/node0/cometbft/config/priv_validator_key.json \ --file validator.toml ``` Creat config validator: Edit parameters and save ``` nano validator.toml ``` Uploading a definition ``` pcli validator definition upload --file validator.toml ``` And verify that it’s known to the chain: ``` pcli query validator list --show-inactive ``` ## Delegating to your validator First find your validator’s identity key: ``` pcli validator identity ``` Delegate ``` pcli tx delegate 1penumbra --to [YOUR_VALIDATOR_IDENTITY_KEY] ``` check balance ``` pcli view balance ``` Updating your validator First fetch your existing validator definition from the chain: ``` pcli validator definition fetch --file validator.toml ``` After updating the validator definition you can upload it again to update your validator metadata on-chain: ``` pcli validator definition upload --file validator.toml ``` Upgrade steps Installing pcli -> Installing pd -> Edit the validator.json file -> Upload Validator.json Read details from the team's instructions > ## DONE --- # 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://docs.validator247.com/testnet/penumbra.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.