💳 Wallet
Wallet Guide
Create and manage a TXM wallet. Generate addresses, check balance, and send transactions.
Security Model
Private keys are generated locally using secp256k1 ECDSA and encrypted at rest with Argon2id + ChaCha20-Poly1305. Keys are never transmitted over the network.
Self-custody. There is no recovery service. If you lose
wallet.json or forget your passphrase, funds are unrecoverable. Back up both immediately after creation.Create a Wallet
bash
export TENSORIUM_WALLET=~/tensorium-node/wallet.json export TENSORIUM_WALLET_PASSPHRASE="your-strong-passphrase" txmwallet create
Output:
address=txm1abc123xyz... public_key=02ab34... wallet_version=2 encrypted=true
Get your address
txmwallet getnewaddress # → txm1abc123xyz...
Backup
cp ~/tensorium-node/wallet.json ~/wallet-backup-$(date +%Y%m%d).json # Verify backup is readable TENSORIUM_WALLET=~/wallet-backup-*.json \ TENSORIUM_WALLET_PASSPHRASE="your-passphrase" \ txmwallet unlock-check
Check Balance
bash
export TENSORIUM_WALLET=~/tensorium-node/wallet.json export TENSORIUM_WALLET_PASSPHRASE="your-passphrase" export TENSORIUM_STATE=~/tensorium-node/state.json txmwallet balance
Shows mature (spendable) and immature (pending maturity) balances separately. Mining rewards become spendable after 100 confirmations.
Send a Transaction
bash — build, sign, and broadcast
export TENSORIUM_WALLET=~/tensorium-node/wallet.json export TENSORIUM_WALLET_PASSPHRASE="your-passphrase" export TENSORIUM_STATE=~/tensorium-node/state.json # Build and sign (1 TXM = 100,000,000 atoms) txmwallet send txm1recipient_address 100000000 /tmp/tx.json # Broadcast to node txmwallet broadcast /tmp/tx.json 127.0.0.1:23332
Transaction will propagate to peers via P2P and be confirmed in the next block.
Commands Reference
| Command | Description |
|---|---|
txmwallet create | Generate keypair and save encrypted wallet |
txmwallet getnewaddress | Print wallet address (txm1…) |
txmwallet show | Print public wallet info (address, pubkey) |
txmwallet balance | Scan chain state for wallet UTXOs |
txmwallet send <to> <atoms> [file] | Build and sign a transaction |
txmwallet broadcast [file] [rpc] | Submit signed tx to node RPC |
txmwallet unlock-check | Verify passphrase can decrypt wallet |
Units
1 TXM100,000,000 atoms
0.00000001 TXM1 atom (smallest unit)
Block reward1,523,557,865 atoms = 15.23557865 TXM