- Change file mode from 644 to 755 for all project files - Add chain_id parameter to get_balance RPC endpoint with default "ait-devnet" - Rename Miner.extra_meta_data to extra_metadata for consistency
225 lines
5.3 KiB
Groff
Executable File
225 lines
5.3 KiB
Groff
Executable File
.TH AITBC 1 "February 2026" "AITBC CLI" "User Commands"
|
|
.SH NAME
|
|
aitbc \- command-line interface for the AITBC network
|
|
.SH SYNOPSIS
|
|
.B aitbc
|
|
[\fIOPTIONS\fR] \fICOMMAND\fR [\fIARGS\fR]...
|
|
.SH DESCRIPTION
|
|
The AITBC CLI provides a comprehensive command-line interface for interacting
|
|
with the AITBC network. It supports job submission, mining operations, wallet
|
|
management, blockchain queries, marketplace operations, multi-chain management,
|
|
agent communication, analytics, system administration, monitoring, and test
|
|
simulations. The CLI provides 22 main command groups with over 100 subcommands
|
|
for complete network interaction.
|
|
.SH GLOBAL OPTIONS
|
|
.TP
|
|
\fB\-\-url\fR \fITEXT\fR
|
|
Coordinator API URL (overrides config)
|
|
.TP
|
|
\fB\-\-api\-key\fR \fITEXT\fR
|
|
API key (overrides config)
|
|
.TP
|
|
\fB\-\-output\fR [table|json|yaml]
|
|
Output format (default: table)
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
Increase verbosity (use -v, -vv, -vvv)
|
|
.TP
|
|
\fB\-\-debug\fR
|
|
Enable debug mode
|
|
.TP
|
|
\fB\-\-config\-file\fR \fITEXT\fR
|
|
Path to config file
|
|
.TP
|
|
\fB\-\-version\fR
|
|
Show version and exit
|
|
.TP
|
|
\fB\-\-help\fR
|
|
Show help message and exit
|
|
.SH COMMANDS
|
|
.TP
|
|
\fBadmin\fR
|
|
System administration commands (status, jobs, miners, analytics, logs, maintenance, audit-log)
|
|
.TP
|
|
\fBagent\fR
|
|
Advanced AI agent workflow and execution management
|
|
.TP
|
|
\fBagent-comm\fR
|
|
Cross-chain agent communication commands (register, list, discover, send, collaborate, reputation, status, network, monitor)
|
|
.TP
|
|
\fBanalytics\fR
|
|
Chain analytics and monitoring commands (summary, monitor, predict, optimize, alerts, dashboard)
|
|
.TP
|
|
\fBauth\fR
|
|
Manage API keys and authentication (login, logout, token, status, refresh, keys, import-env)
|
|
.TP
|
|
\fBblockchain\fR
|
|
Query blockchain information (blocks, block, transaction, status, sync-status, peers, info, supply, validators)
|
|
.TP
|
|
\fBchain\fR
|
|
Multi-chain management commands (list, create, delete, info, status, switch, validate)
|
|
.TP
|
|
\fBclient\fR
|
|
Submit and manage inference jobs (submit, status, blocks, receipts, cancel, history, batch-submit, template)
|
|
.TP
|
|
\fBconfig\fR
|
|
Manage CLI configuration (show, set, path, edit, reset, export, import, validate, environments, profiles, set-secret, get-secret)
|
|
.TP
|
|
\fBconfig-show\fR
|
|
Show current configuration
|
|
.TP
|
|
\fBdeploy\fR
|
|
Production deployment and scaling commands
|
|
.TP
|
|
\fBexchange\fR
|
|
Bitcoin exchange operations
|
|
.TP
|
|
\fBgenesis\fR
|
|
Genesis block generation and management commands
|
|
.TP
|
|
\fBgovernance\fR
|
|
Governance proposals and voting
|
|
.TP
|
|
\fBmarketplace\fR
|
|
GPU marketplace operations (gpu register/list/details/book/release, orders, pricing, reviews, agents, bid, offers, governance, test)
|
|
.TP
|
|
\fBminer\fR
|
|
Register as a miner and process jobs (register, poll, mine, heartbeat, status, earnings, update-capabilities, deregister, jobs, concurrent-mine)
|
|
.TP
|
|
\fBmonitor\fR
|
|
Monitoring, metrics, and alerting commands (dashboard, metrics, alerts, history, webhooks)
|
|
.TP
|
|
\fBmultimodal\fR
|
|
Multi-modal agent processing and cross-modal operations
|
|
.TP
|
|
\fBnode\fR
|
|
Node management commands
|
|
.TP
|
|
\fBoptimize\fR
|
|
Autonomous optimization and predictive operations
|
|
.TP
|
|
\fBplugin\fR
|
|
Manage CLI plugins
|
|
.TP
|
|
\fBsimulate\fR
|
|
Run simulations (init, user, workflow, load-test, scenario, results, reset)
|
|
.TP
|
|
\fBswarm\fR
|
|
Swarm intelligence and collective optimization
|
|
.TP
|
|
\fBversion\fR
|
|
Show version information
|
|
.TP
|
|
\fBwallet\fR
|
|
Manage wallets and transactions (balance, earn, spend, send, history, address, stats, stake, unstake, staking-info, liquidity-stake, liquidity-unstake, rewards, multisig-create, multisig-propose, multisig-sign, create, list, switch, delete, backup, restore, info, request-payment)
|
|
.SH EXAMPLES
|
|
.PP
|
|
Submit a job:
|
|
.RS
|
|
aitbc client submit --prompt "What is AI?" --model gpt-4
|
|
.RE
|
|
.PP
|
|
Check wallet balance:
|
|
.RS
|
|
aitbc wallet balance
|
|
.RE
|
|
.PP
|
|
Start mining:
|
|
.RS
|
|
aitbc miner register --gpu-model RTX4090 --memory 24 --price 0.5
|
|
.br
|
|
aitbc miner poll --interval 5
|
|
.RE
|
|
.PP
|
|
Monitor system:
|
|
.RS
|
|
aitbc monitor dashboard --refresh 5
|
|
.RE
|
|
.PP
|
|
List available GPUs:
|
|
.RS
|
|
aitbc marketplace gpu list
|
|
.RE
|
|
.PP
|
|
Query blockchain status:
|
|
.RS
|
|
aitbc blockchain sync-status
|
|
.RE
|
|
.PP
|
|
Manage configuration:
|
|
.RS
|
|
aitbc config set api_key your_api_key_here
|
|
.br
|
|
aitbc config show
|
|
.RE
|
|
.PP
|
|
Cross-chain agent communication:
|
|
.RS
|
|
aitbc agent-comm register --agent-id agent1 --chain-id ethereum
|
|
.br
|
|
aitbc agent-comm list --chain-id ethereum
|
|
.RE
|
|
.PP
|
|
Analytics and monitoring:
|
|
.RS
|
|
aitbc analytics summary --chain-id ethereum --hours 24
|
|
.br
|
|
aitbc analytics monitor --realtime
|
|
.RE
|
|
.PP
|
|
Multi-chain operations:
|
|
.RS
|
|
aitbc chain list
|
|
.br
|
|
aitbc chain create --name test-chain --type ethereum
|
|
.RE
|
|
.PP
|
|
Output in different formats:
|
|
.RS
|
|
aitbc wallet balance --output json
|
|
.br
|
|
aitbc marketplace gpu list --output yaml
|
|
.RE
|
|
.PP
|
|
Verbose output:
|
|
.RS
|
|
aitbc -vv blockchain blocks --limit 10
|
|
.RE
|
|
.PP
|
|
Configuration management:
|
|
.RS
|
|
aitbc config profiles save production
|
|
.br
|
|
aitbc config profiles load production
|
|
.RE
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
\fBCLIENT_API_KEY\fR
|
|
API key for authentication
|
|
.TP
|
|
\fBAITBC_COORDINATOR_URL\fR
|
|
Coordinator API URL
|
|
.TP
|
|
\fBAITBC_OUTPUT_FORMAT\fR
|
|
Default output format
|
|
.TP
|
|
\fBAITBC_CONFIG_FILE\fR
|
|
Path to configuration file
|
|
.SH FILES
|
|
.TP
|
|
\fB~/.config/aitbc/config.yaml\fR
|
|
Default configuration file
|
|
.TP
|
|
\fB~/.aitbc/wallets/\fR
|
|
Wallet storage directory
|
|
.TP
|
|
\fB~/.aitbc/audit/audit.jsonl\fR
|
|
Audit log file
|
|
.TP
|
|
\fB~/.aitbc/templates/\fR
|
|
Job template storage
|
|
.SH SEE ALSO
|
|
Full documentation: https://docs.aitbc.net
|
|
.SH AUTHORS
|
|
AITBC Development Team
|