cowboy wallet

​

Synopsis

cowboy wallet create [--output <path>]
cowboy wallet address [--key <path>]
cowboy wallet balance [--key <path>] [--rpc-url <url>]
cowboy wallet upgrade [--key <path>]
cowboy wallet create-mnemonic [--output <path>] [--index <n>]
cowboy wallet import-mnemonic --mnemonic <phrase> [--output <path>] [--index <n>]
cowboy wallet accounts --mnemonic <phrase> [--count <n>]

​

Subcommands

​

cowboy wallet create

1. Generate a cryptographically random secp256k1 private key.
2. Write the 32-byte private key in PEM envelope format to the output file.
3. Print the public address (EVM-style checksum hex).

$ cowboy wallet create
Created wallet:
  Private key: .cowboy/key
  Address: 0x7a3B...F92E

• If the output file already exists, print an error and exit. Do not overwrite.
• Create parent directories (.cowboy/) if they don’t exist.

​

cowboy wallet address

1. Load the private key using key auto-discovery.
2. Derive the secp256k1 public key.
3. Print the EVM-style checksum hex address (20-byte, 0x-prefixed).

$ cowboy wallet address
0x7a3B...F92E

​

cowboy wallet balance

1. Load the private key using key auto-discovery.
2. Derive the public address.
3. Send GET /account/<address> to the RPC endpoint.
4. Print the balance in CBY.

$ cowboy wallet balance
Address: 0x7a3B...F92E
Balance: 1000.000000 CBY
Nonce: 0

• If the account doesn’t exist on-chain, print Balance: 0 CBY (not an error).
• If the RPC endpoint is unreachable, print an error with the URL that was tried.

​

cowboy wallet upgrade

1. Load the private key file (auto-discovered or explicit path).
2. If the file is already in PEM format, print a message and exit (no-op).
3. If the file is in hex format, re-encode as PEM and overwrite the file in-place.

$ cowboy wallet upgrade
Upgraded .cowboy/key from hex to PEM format.

• If the key is already PEM, prints a message and exits successfully without modifying the file.
• Both hex (64-char string) and 0x-prefixed hex are accepted as input.

​

cowboy wallet create-mnemonic

1. Generate a random 12-word BIP-39 mnemonic phrase.
2. Derive a secp256k1 private key using HD derivation path m/44'/60'/0'/0/<index>.
3. Write the private key in PEM format to the output file.
4. Print the mnemonic phrase and derived address.

$ cowboy wallet create-mnemonic
Mnemonic: abandon ability able about above absent absorb abstract absurd abuse access accident
  Private key: .cowboy/key
  Address: 0x1a2B...C3D4
  Derivation: m/44'/60'/0'/0/0

IMPORTANT: Write down your mnemonic phrase and store it securely.
           It cannot be recovered if lost.

• If the output file already exists, print an error and exit. Do not overwrite.

​

cowboy wallet import-mnemonic

1. Validate the provided mnemonic phrase (must be valid BIP-39).
2. Derive a secp256k1 private key using HD derivation path m/44'/60'/0'/0/<index>.
3. Write the private key in PEM format to the output file.
4. Print the derived address.

$ cowboy wallet import-mnemonic --mnemonic "abandon ability able about above absent absorb abstract absurd abuse access accident"
Imported wallet:
  Private key: .cowboy/key
  Address: 0x1a2B...C3D4
  Derivation: m/44'/60'/0'/0/0

• If the mnemonic is invalid, print Error: Invalid mnemonic phrase and exit.
• If the output file already exists, print an error and exit. Do not overwrite.

​

cowboy wallet accounts

1. Validate the provided mnemonic phrase.
2. Derive count addresses using sequential HD derivation indices (m/44'/60'/0'/0/0 through m/44'/60'/0'/0/<count-1>).
3. Print each index and its corresponding address.

$ cowboy wallet accounts --mnemonic "abandon ability able ..." --count 3
  0  0x1a2B...C3D4
  1  0x5e6F...A7B8
  2  0x9c0D...E1F2

• If the mnemonic is invalid, print Error: Invalid mnemonic phrase and exit.
• This command does not write any key files — it only prints addresses.

​

Testing

# Create a wallet
cowboy wallet create
cat .cowboy/key   # Should be PEM format

# Check address
cowboy wallet address   # Should print checksum hex address

# Check balance (requires running validator)
cowboy wallet balance   # Should show 0 CBY for new account

# Upgrade hex key to PEM
cowboy wallet upgrade

# Generate mnemonic wallet
cowboy wallet create-mnemonic --output .cowboy/mnemonic-key

# Import mnemonic
cowboy wallet import-mnemonic --mnemonic "your twelve word phrase ..." --output .cowboy/imported-key

# List derived accounts
cowboy wallet accounts --mnemonic "your twelve word phrase ..." --count 10