Wallet

The SUM Chain CLI wallet

sumchain-wallet is the repository-grounded wallet: generate keys into an encrypted keystore, inspect your address and balance, and sign or send Koppa transfers from the terminal.

Get the wallet

Build, then generate an encrypted keystore

Build the binary from source, then create a keypair. keygen prompts for a password and writes an encrypted keystore file, the private key is protected with Argon2 key derivation and AES-256-GCM.

Argon2AES-256-GCMno seed phrase

build

cargo build -p sumchain-wallet --release
# → binary at target/release/sumchain-wallet

keygen

sumchain-wallet keygen --output keystore.json
# prompts for a password, then prints your
# public key and address

Everyday use

Address, balance, and transfers

address & pubkey

sumchain-wallet address --key keystore.json
sumchain-wallet pubkey  --key keystore.json

balance

sumchain-wallet balance \
  --rpc https://rpc.sumchain.io \
  --address <YOUR_ADDRESS>

transfer (sign + send)

sumchain-wallet transfer \
  --key keystore.json \
  --rpc https://rpc.sumchain.io \
  --to <RECIPIENT> \
  --amount 1.5 \
  --chain-id 1

offline sign, then send

# Sign offline (air-gapped), broadcast later
sumchain-wallet sign-tx --key keystore.json \
  --to <RECIPIENT> --amount 1.5 --fee 0.001 \
  --nonce <N> --chain-id 1
sumchain-wallet send --rpc https://rpc.sumchain.io \
  --raw 0x<SIGNED_TX_HEX>

Keep your keystore safe

Your funds are controlled by the encrypted keystore file and its password. Back up keystore.json and remember the password, there is no seed phrase and no recovery if both are lost. Never share the keystore or password.

hosted (external)

Prefer a browser?

SUMaillet is a hosted browser wallet operated separately from this repository. It is not part of the SUM Chain codebase; the CLI wallet above is the repo-grounded path.

Open SUMaillet (hosted) ↗

Grounded in