.TH AITBC-WALLET "1" "December 2025" "AITBC Wallet CLI" "User Commands"
.SH NAME
aitbc-wallet \- AITBC Blockchain Wallet Command Line Interface
.SH SYNOPSIS
.B aitbc-wallet
[\fIOPTIONS\fR] \fICOMMAND\fR [\fIARGS\fR]
.SH DESCRIPTION
The AITBC Wallet CLI is a command-line tool for interacting with the AITBC blockchain. It allows you to manage wallets, check balances, and monitor blockchain status without exposing your wallet to web interfaces.
.SH COMMANDS
.TP
\fBstatus\fR
Check if the wallet is connected to the AITBC blockchain node.
.TP
\fBlist\fR
List all local wallets stored in ~/.aitbc/wallets/.
.TP
\fBbalance\fR \fIADDRESS\fR
Get the AITBC token balance for the specified address.
.TP
\fBblock\fR [\fIHEIGHT\fR]
Show information about the latest block or a specific block height.
.SH EXAMPLES
Check blockchain connection status:
.P
.RS 4
.nf
$ aitbc-wallet status
==================================================
    AITBC Blockchain Wallet CLI
==================================================
Checking blockchain connection...

✅ Status: CONNECTED
📦 Node: http://127.0.0.1:9080
🔗 Latest Block: #42
🧮 Block Hash: 0x1234...abcd
⏰ Checked at: 2025-12-28 10:30:00
.fi
.RE
.P
List all wallets:
.P
.RS 4
.nf
$ aitbc-wallet list
==================================================
    AITBC Blockchain Wallet CLI
==================================================
Found 1 wallet(s) in /home/user/.aitbc/wallets:

🔐 Wallet ID: demo-wallet
   Address: aitbc1x7f8x9k2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c
   Public Key: 0x3aaa0a91f69d886a90...
   Created: 2025-12-28T10:30:00Z
.fi
.RE
.P
Check wallet balance:
.P
.RS 4
.nf
$ aitbc-wallet balance aitbc1x7f8x9k2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c
==================================================
    AITBC Blockchain Wallet CLI
==================================================
Checking balance for address: aitbc1x7f8x9k2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c

💰 Balance: 1000 AITBC
📍 Address: aitbc1x7f8x9k2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c
.fi
.RE
.SH FILES
.TP
.I ~/.aitbc/wallets/
Directory where local wallet files are stored.
.TP
.I /usr/local/bin/aitbc-wallet
The wallet CLI executable.
.SH ENVIRONMENT
.TP
.I BLOCKCHAIN_RPC
The blockchain node RPC URL (default: http://127.0.0.1:9080).
.SH SECURITY
.P
The wallet CLI is designed with security in mind:
.RS 4
.IP \(bu 4
No web interface - purely command-line based
.IP \(bu 4
Wallets stored locally in encrypted format
.IP \(bu 4
Only connects to localhost blockchain node by default
.IP \(bu 4
No exposure of private keys to network services
.RE
.SH BUGS
Report bugs to the AITBC project issue tracker.
.SH SEE ALSO
.BR aitbc-blockchain (8),
.BR aitbc-coordinator (8)
.SH AUTHOR
AITBC Development Team