> For the complete documentation index, see [llms.txt](https://docs.logos.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.logos.co/lez/get-started/quickstart-for-the-logos-execution-zone-wallet.md). # Quickstart for the Logos Execution Zone wallet #### Set up the wallet, connect to a sequencer, and run a minimal transfer flow. {% hint style="warning" %} This page should be accurate for the specific version referenced in this doc, but it may not have been run end-to-end as written. Expect minor gaps (for example, missing environment details) and be prepared to troubleshoot. We are actively working to complete and verify this content. {% endhint %} {% hint style="info" %} * **Permissions**: No special permissions required. * **Product**: Logos Execution Zone wallet CLI. {% endhint %} {% hint style="success" %} A public LEZ testnet is available. This quickstart runs against a local sequencer you start yourself, but you can browse live testnet activity in the block explorer, and the testnet sequencer is reachable at its public RPC endpoint. * Explorer: * Sequencer RPC: {% endhint %} The Logos Execution Zone (LEZ, for short) is a programmable blockchain that records transactions, maintains public on-chain state, and exposes a sequencer endpoint that clients (like a wallet) can submit transactions to. LEZ separates account state into public (visible, on-chain) and private (hidden, off-chain). You choose which one you are using by creating a public or private account and using it in transactions. This ability to maintain a public and private state is provided by the Logos Execution Environment (LEE), that defines what an account is, how transactions are structured, and how executions are validated when some data must remain private. You can think of LEZ as the blockchain you connect to and where transactions are recorded, and LEE as the execution model that powers it. {% hint style="info" %} This quickstart covers the public wallet flow only so you can get set up quickly. Privacy-preserving transfers require local proof generation and take longer to run. For the private workflow, see [Transfer native tokens on the Logos Execution Zone](/lez/transfer-tokens/transfer-native-tokens-on-the-logos-execution-zone.md). {% endhint %} When a transaction touches the private state, the client runs the private part locally using your private keys and local client data, producing a zero-knowledge proof (ZKP). Validators verify the proof and accept the state update (for example, updating public balances), so the network stays correct even though the private data is never published. {% hint style="info" %} In the context of the Logos Execution Zone, a zero-knowledge proof (ZKP) is a cryptographic proof that lets a blockchain client, such as a wallet, prove a private transaction followed LEE’s rules without revealing the private inputs (like balances). Using ZKPs, LEZ can safely accept the resulting state update and keep the public chain consistent with private execution, even though the network never sees the private values. {% endhint %} In this quickstart, you install the wallet tooling, connect to a local sequencer endpoint, and complete a minimal transfer flow with balance checks. In wallet terms, the wallet client is your control panel for the system: you install it, create and manage public or private accounts, sync private state, and send commands. ## Before you start * This guide is intended for a developer audience with CLI-first workflow familiarity. * You should have a basic knowledge of blockchain concepts like accounts, transactions, and balances. * You will use the Rust toolchain to complete this tutorial, but you don't need prior Rust experience. * Commands assume a bash-compatible shell. ## Step 1: Install the prerequisites To run the LEZ wallet CLI, you first need to install system dependencies, the Rust toolchain, and the Logos Blockchain circuits files. ### Install system build dependencies Install the build prerequisites you need to compile the sequencer and wallet. {% hint style="success" %} These prerequisites include a working C toolchain and linker on your machine. You may already have these installed if you have experience building software from source. {% endhint %} Choose the instructions for your operating system: ```bash # Ubuntu / Debian sudo apt update apt install git curl build-essential clang libclang-dev pkg-config libssl-dev ``` ```bash # Fedora sudo dnf install git curl gcc glibc-devel clang clang-devel pkgconf-pkg-config openssl-devel llvm-libs ``` ```bash # macOS xcode-select --install brew install pkg-config openssl ``` ### Install Rust and RISC Zero components {% hint style="info" %} Rust is the language used for wallet development, while RISC Zero is the proof toolchain used to generate the ZKPs. {% endhint %} 1. Install Rust with `rustup`: ```bash # Install the official Rust compiler. -y installs non-interactively (required in CI/Docker, where there is no TTY for the rustup TUI). curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable ``` 2. Install the RISC Zero components: ```bash # Source the env file under $HOME/.cargo and install the RISC Zero component . "$HOME/.cargo/env" curl -L https://risczero.com/install | bash ``` 3. Restart your shell to ensure the `cargo` and `rzup` commands are available. 4. Add the RISC Zero components to your Rust toolchain with `rzup`: ```bash rzup install ``` ### Set up the `wallet` binary prerequisites and build the wallet The Logos Blockchain repository provides a script that downloads a circuits release required by the `wallet` build. {% hint style="success" %} "Circuits" are prebuilt files used for privacy-preserving execution (zero-knowledge proofs). Even though the quickstart flow uses public transactions, the current `wallet` build still requires these files to be present locally. {% endhint %} 1. Create a workspace folder and clone the Logos Blockchain repository: ```bash mkdir -p ~/logos/src cd ~/logos/src git clone https://github.com/logos-blockchain/logos-blockchain.git ``` 2. Run the script to download the circuits release:

This script downloads logos-blockchain-circuits-<version>-<platform>.tar.gz and installs it under ~/.logos-blockchain-circuits by default.

```bash cd logos-blockchain ./scripts/setup-logos-blockchain-circuits.sh ``` 3. From the same workspace folder, clone the Logos Execution Zone repository: ```bash cd ~/logos/src git clone https://github.com/logos-blockchain/logos-execution-zone.git cd logos-execution-zone ``` 4. From the repository root, install the wallet CLI: ```bash cargo install --path wallet --force ``` 5. Confirm that the `wallet` command is available: ```bash wallet help ``` ## Step 2: Start the LEZ sequencer in standalone mode Open a new terminal window and start the LEZ sequencer from the root of the Logos Execution Zone repository: ```bash cd ~/logos/src/logos-execution-zone RUST_LOG=info cargo run --features standalone -p sequencer_service sequencer/service/configs/debug/sequencer_config.json ``` {% hint style="info" %} This quickstart uses standalone mode, which runs only the LEZ sequencer locally. The full local stack also runs a Logos Blockchain node and the indexer service for development and block exploration, but it adds extra components and is covered separately. {% endhint %} You should see the sequencer starting up at `localhost:3040` and logging information to the terminal: ```bash [2026-02-24T16:27:58Z INFO sequencer_runner] HTTP server started [2026-02-24T16:27:58Z INFO actix_server::server] Tokio runtime found; starting in existing Tokio runtime [2026-02-24T16:27:58Z INFO actix_server::server] starting service: "actix-web-service-0.0.0.0:3040", workers: 4, listening on: 0.0.0.0:3040 [2026-02-24T16:27:58Z INFO sequencer_runner] Starting main sequencer loop [2026-02-24T16:27:58Z INFO sequencer_runner] Starting pending block retry loop [2026-02-24T16:27:58Z INFO sequencer_runner] Starting bedrock block listening loop [2026-02-24T16:27:58Z INFO sequencer_runner] Sequencer running. Monitoring concurrent tasks... ``` ## Step 3 (optional): Configure the wallet home directory The wallet reads its configuration from a "wallet home" directory. If the `NSSA_WALLET_HOME_DIR` environment variable is not set, it falls back to `~/.nssa/wallet`. If you want the wallet to initialise in a different location, set the variable before continuing. For example, to set the wallet home to a `.wallet-home` folder in the current directory, run: ```bash export NSSA_WALLET_HOME_DIR="$PWD/.wallet-home" ``` {% hint style="info" %} The `wallet help` output incorrectly states that `NSSA_WALLET_HOME_DIR` "must be set." In practice, the binary falls back to `~/.nssa/wallet` when unset, as described above. The mismatch is in the help string. {% endhint %} ## Step 4: Initialise the wallet local storage and verify connectivity The wallet persistent storage is defined by the `storage.json` file. When you run any `wallet` subcommand, the wallet checks whether `storage.json` exists in the wallet home directory. If it does not exist, it requires a password to initialise the wallet storage. {% hint style="success" %} Leave the sequencer running in the other terminal window while you initialise the wallet storage. {% endhint %} Run a `wallet` command to initialise the storage. Use the built-in health check: ```bash wallet check-health ``` If the wallet storage was not previously initialised, this command prints `Persistent storage not found, need to execute setup`, and prompts you to create a password. You can choose any password you like, but make sure to remember it, as you will need it to access the wallet in the future. {% hint style="warning" %} The wallet uses this password as a seed to deterministically generate your public and private key trees. The wallet stores the derived key material and local state in storage.json under the wallet home directory. {% endhint %} ## Step 5: Complete a minimal wallet flow In this flow, you create and initialise an account, claim testnet funds, send a transfer, and confirm resulting balances. In this task, wallet account and transfer commands interact with the authenticated-transfer program, and sequencer processing determines the resulting account state. Public and private account paths share command patterns, while private paths can include local proof generation. ### Create and initialise the sender public account 1. Create a sender public account and record the `account_id` value: ```bash cd ~/logos/src/logos-execution-zone wallet account new public ``` 2. Using the sender public `account_id` from the previous step, check the sender status: ```bash wallet account get --account-id ``` Example: ```bash wallet account get --account-id Public/14TYHiuzKiNR1ydETpr9mJMkjY6jf1hQFZ11d3X8Tc7N ``` You should see `Account is Uninitialized` in the output. New accounts start uninitialised, so no program owns them yet. A program can claim an uninitialised account (for example, the authenticated-transfer program or the token program). After a program claims an account, only that program can modify the account state. LEZ makes one exception for account credits, where any program can credit native tokens to any account. For account debits, LEZ requires the owning program. 3. Initialise the sender account, then check the updated state:

Running wallet auth-transfer init initialises the sender account under the authenticated-transfer program, so the account can debit native tokens when you send transfers.

```bash wallet auth-transfer init --account-id ``` In the output, you should see `status: "Transaction submitted"`, and the transaction hash. If you change to the terminal session where the sequencer is running, you can see a message similar to this: `Validated transaction with hash , including it in block`. 4. Check the account updated state: ```bash wallet account get --account-id ``` In the output you should see `Account owned by authenticated transfer program`, with `"balance":0`. ### Claim funds using the Piñata faucet "Piñata" is the name of the LEZ-specific testnet faucet program that funds accounts with native tokens. 1. Fund the sender account via Piñata: ```bash # This may take a few seconds to complete wallet pinata claim --to ``` 2. Check the sender account balance: ```bash wallet account get --account-id ``` In the output you should see `Account owned by authenticated transfer program`, with a `"balance":150`. ### Create and fund the recipient public account 1. Create a recipient public account and record the `account_id` value. Complete this step in the same terminal session as the sender account commands to avoid exporting `NSSA_WALLET_HOME_DIR` again. ```bash wallet account new public ``` 2. Send 37 tokens from sender to recipient: ```bash wallet auth-transfer send \ --from \ --to \ --amount 37 ``` Example: ```bash wallet auth-transfer send \ --from Public/14TYHiuzKiNR1ydETpr9mJMkjY6jf1hQFZ11d3X8Tc7N \ --to Public/74zHyMW81mtfcd6VMaLnpnAna8k2V4AN2Ygyy9LcEAQQ \ --amount 37 ``` 3. Check sender and recipient balances: ```bash # Sender account wallet account get --account-id ``` This should show a `"balance":113` (150 - 37 = 113). ```bash # Recipient account wallet account get --account-id ``` This should show a `"balance":37`. ## Next steps * [Transfer native tokens on the Logos Execution Zone](https://github.com/logos-co/logos-docs/blob/main/docs/lez/get-started/transfer-native-tokens-on-the-logos-execution-zone.md) * [Create and transfer custom tokens on the Logos Execution Zone](https://github.com/logos-co/logos-docs/blob/main/docs/lez/get-started/create-and-transfer-custom-tokens-on-the-logos-execution-zone.md) --- # 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.logos.co/lez/get-started/quickstart-for-the-logos-execution-zone-wallet.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.