wallet

Documentation

Overview

Package wallet implements the `polycli heimdall wallet` umbrella command. It is a local-only command group: none of the subcommands talk to the network. Keys are stored in a go-ethereum v3 JSON keystore directory that is compatible with Foundry's `cast wallet`.

Keystore directory precedence (highest wins):

1. `--keystore-dir` flag.
2. `ETH_KEYSTORE` environment variable.
3. `~/.foundry/keystores/` if it already exists (honour existing cast users without migration).
4. `~/.polycli/keystores/` (default; created on demand).

Signing uses EIP-191 personal_sign by default. `--raw` signs a 32-byte hash directly. Hardware wallets (`--ledger`, `--trezor`), `vanity`, and `sign-auth` from cast are deliberately rejected with a pointer at `cast wallet` — see HEIMDALLCAST_REQUIREMENTS.md §3.4.

Index

• Constants
• Variables
• func Register(parent *cobra.Command, _ *config.Flags)

Constants

const DefaultDerivationPath = sharedwallet.DefaultDerivationPath

DefaultDerivationPath re-exports the shared constant so existing callers under cmd/heimdall/wallet keep their current import surface.

Variables

var ErrAccountExists = sharedwallet.ErrAccountExists

ErrAccountExists is re-exported from the shared wallet package so existing callers compile unchanged.

Functions

func Register

func Register(parent *cobra.Command, _ *config.Flags)

Register attaches the wallet umbrella command and its subcommands to parent. None of the wallet subcommands call config.Resolve — the heimdall network config is irrelevant to local key management — so the shared Flags handle is accepted only for signature symmetry with the other command groups.