Skip to content

Vheissu/beeline

Repository files navigation

╔════════════════════════════════════════════════════════════════════╗
║  H I V E   T E R M I N A L   W A L L E T                           ║
╚════════════════════════════════════════════════════════════════════╝

🌈 beeline

A cyberpunk terminal wallet for the Hive blockchain

Type, sign, rule the chain – all within the neon grid.

npm version License: MIT

🆕 Latest Updates: Complete governance system with witness voting and proxy management, comprehensive transaction history with analytics and filtering, enhanced reward claiming, and powerdown status tracking.

⚡ Features

  • 🌈 Cyberpunk Aesthetic - Full neon color palette with ASCII art and animated effects
  • 🔐 Secure Key Management - PIN-encrypted key storage with OS keychain integration
  • 🚀 Password-Based Login - Derive all keys from your master Hive password
  • 👥 Multiple Account Support - Manage unlimited Hive accounts in one wallet
  • 💰 Complete Blockchain Operations - Transfers, power up/down, savings (20% APR), reward claiming, RC monitoring, powerdown status tracking
  • 📊 Transaction History - Comprehensive history with analytics, filtering by type/amount/date
  • 🏛️ Governance Operations - Witness voting, proxy management, witness discovery
  • 🔌 Plugin System - Extensible architecture for HiveEngine, price tracking, and community plugins
  • 🛡️ Security First - Memory scrubbing, encrypted storage, zero-click paranoia
  • 📱 Terminal Native - Pure command line interface with neon styling
  • 🎮 Mock Mode - Test all operations safely before going live

🚀 Quick Start

Installation

npm install -g beeline-cli

First Time Setup

# Login with your Hive account (initializes wallet automatically)
beeline login alice

# Check your balance
beeline balance

# Send a transfer
beeline transfer @bob 1 HIVE "Welcome to the neon grid!"

🎯 Core Commands

🔑 Account Management

# Login with master password (initializes wallet on first use)
beeline login alice                    # Import posting, active, memo keys
beeline login alice --roles active    # Import only active key
beeline login alice --no-pin          # Skip PIN encryption

# View all accounts
beeline accounts list

# Switch default account
beeline accounts switch alice

# View account details
beeline accounts info alice

# Remove account (with confirmation)
beeline accounts remove alice

🔐 Key Management

# View all keys in vault
beeline keys list

# Import individual key (advanced users)
beeline keys import alice posting     # Will prompt for private key WIF

# Remove specific key
beeline keys remove alice posting

# Set default account
beeline keys set-default alice

💰 Wallet Operations

Balance Checking

# Check balance
beeline balance                        # Use default account
beeline balance alice                  # Specific account  
beeline balance @alice                 # @ prefix optional
beeline balance alice --format json   # JSON output
beeline balance alice --mock          # Test with mock data (safe)

Transfers with Memos

# Basic transfers
beeline transfer @bob 10 HIVE                    # No memo
beeline transfer @alice 5.000 HBD               # No memo, precise amount

# Transfers with memos (optional)
beeline transfer @bob 10 HIVE "Hello friend!"          # Personal message
beeline transfer @alice 5 HBD "Payment for coffee"     # Payment reference
beeline transfer @charlie 1.000 HIVE "Invoice #123"    # Business reference

# Multi-account transfers
beeline transfer @customer 100 HIVE "Order #456" --from @business
beeline transfer @friend 0.001 HIVE "Testing" --from @testaccount

# Safe testing (recommended first!)
beeline transfer @bob 10 HIVE "Test message" --mock
beeline transfer @alice 5 HBD --mock                    # Mock without memo

# Skip confirmation prompts (for automation)
beeline transfer @recipient 1 HIVE "Automated payment" --confirm

Transfer Examples by Use Case

# Personal payments
beeline transfer @friend 5 HIVE "Thanks for dinner!"
beeline transfer @sibling 10 HBD "Birthday gift"

# Business transactions  
beeline transfer @supplier 250 HIVE "Invoice #2024-001" --from @company
beeline transfer @employee 50 HBD "Salary bonus" --from @business

# Content creator tips
beeline transfer @blogger 1 HIVE "Great article!"
beeline transfer @artist 2 HBD "Love your work!"

# Testing and development
beeline transfer @testaccount 0.001 HIVE "Connection test" --mock
beeline transfer @any 999 HIVE "Safe testing" --mock

🎮 Development & Testing

# Show version and system info
beeline version

# Get help for any command
beeline --help                # Show all commands
beeline help login            # Detailed help for login
beeline transfer --help       # Transfer command options
beeline accounts --help       # Account management help
beeline keys --help          # Key management help

🔍 Complete Command Reference

Account Management Commands

# Login (creates wallet on first use)
beeline login alice                    # Login with all keys (posting, active, memo)
beeline login alice --roles posting   # Login with specific key only
beeline login alice --no-pin          # Skip PIN encryption (less secure)
beeline login alice --no-verify       # Skip blockchain verification
beeline login alice --force           # Overwrite existing keys

# Account operations
beeline accounts list                  # View all accounts
beeline accounts list --format json   # JSON output
beeline accounts switch alice          # Set default account
beeline accounts info alice            # Detailed account info
beeline accounts remove alice          # Remove account (with confirmation)
beeline accounts remove alice --force  # Remove without confirmation

Key Management Commands

# View keys
beeline keys list                     # Show all keys in vault

# Manual key import (advanced users)
beeline keys import alice posting     # Import specific key role
beeline keys import alice active --no-pin  # Import without PIN

# Key management
beeline keys remove alice posting     # Remove specific key
beeline keys set-default alice        # Set default account

Balance Commands

# Live balance checking (now includes powerdown status when active)
beeline balance                       # Default account with powerdown info
beeline balance alice                 # Specific account
beeline balance @alice                # @ prefix accepted
beeline balance alice --format json  # JSON output with powerdown data
beeline balance alice --node custom  # Custom RPC node

# Safe testing
beeline balance alice --mock         # Mock data (no network)

Transfer Commands

# Basic syntax: beeline transfer <to> <amount> <currency> [memo] [options]

# Minimal transfers
beeline transfer @alice 1 HIVE
beeline transfer @bob 5.000 HBD

# With memos
beeline transfer @alice 1 HIVE "Hello!"
beeline transfer @bob 5 HBD "Payment for services"

# Multi-account
beeline transfer @customer 100 HIVE "Order" --from @business
beeline transfer @friend 1 HIVE "Gift" --from @personal

# Options
beeline transfer @alice 1 HIVE --mock           # Safe testing
beeline transfer @alice 1 HIVE --confirm        # Skip confirmation
beeline transfer @alice 1 HIVE --node custom    # Custom node

Power Operations

# Power up HIVE to Hive Power
beeline powerup 10 HIVE                          # Power up to self
beeline powerup 5.000 HIVE @alice                # Power up to another account
beeline powerup 100 HIVE @alice --from @business # Power up from specific account

# Power down Hive Power to liquid HIVE (13 weeks)
beeline powerdown 10 HP                          # Power down in HP units
beeline powerdown 5000 VESTS                     # Power down in VESTS units
beeline powerdown 50 HP --from @alice            # Power down from specific account

# Safe testing for power operations
beeline powerup 10 HIVE --mock                   # Test power up safely
beeline powerdown 10 HP --mock                   # Test power down safely

Power Operation Commands

# Power up (convert HIVE to Hive Power)
beeline powerup 10 HIVE                          # Power up to self
beeline powerup 5.000 HIVE @alice                # Power up to another account  
beeline powerup 100 HIVE @alice --from @business # Power up from specific account
beeline powerup 10 HIVE --mock                   # Test power up safely
beeline powerup 10 HIVE --confirm                # Skip confirmation prompt

# Power down (convert Hive Power to liquid HIVE over 13 weeks)
beeline powerdown 10 HP                          # Power down 10 Hive Power
beeline powerdown 5000 VESTS                     # Power down 5000 vesting shares
beeline powerdown 50 HP --from @alice            # Power down from specific account
beeline powerdown 10 HP --mock                   # Test power down safely
beeline powerdown 10 HP --confirm                # Skip confirmation prompt

# Check powerdown status and schedule
beeline powerdown-status                         # Check default account powerdown status
beeline powerdown-status alice                   # Check specific account powerdown status
beeline powerdown-status alice --format json     # JSON output format

Savings Operations (20% APR on HBD)

# Deposit to savings (instant)
beeline deposit 100 HBD                          # Deposit HBD for 20% APR
beeline deposit 50 HIVE @alice                   # Deposit to another account
beeline deposit 1000 HBD --from @business        # Deposit from specific account

# Withdraw from savings (3-day processing)
beeline withdraw 100 HBD                         # Withdraw from savings
beeline withdraw 50 HIVE @alice                  # Withdraw to specific account
beeline withdraw 200 HBD --from @business        # Withdraw from specific account

# Safe testing for savings operations
beeline deposit 100 HBD --mock                   # Test deposit safely
beeline withdraw 50 HBD --mock                   # Test withdrawal safely

Reward Management

# Check available rewards
beeline claim --show-only                        # Show pending rewards
beeline claim alice --show-only                  # Check specific account

# Claim all rewards (HIVE, HBD, VESTS)
beeline claim                                    # Claim all rewards for default account
beeline claim alice                              # Claim rewards for specific account
beeline claim alice --all                        # Claim all without confirmation

# Safe testing
beeline claim --mock                             # Test reward claiming safely

Resource Credits (RC) Monitoring

# Check RC status
beeline rc                                       # Check default account RC
beeline rc alice                                 # Check specific account RC
beeline rc alice --format json                   # JSON output format

# Continuous monitoring
beeline rc alice --watch                         # Watch RC levels live
beeline rc alice --threshold 30                  # Custom warning threshold

# Transaction capacity estimates included automatically

Transaction History Commands

# View transaction history with filters and analytics
beeline history                               # Default account history (last 100 transactions)
beeline history alice                         # Specific account history
beeline history alice --limit 50             # Limit number of transactions
beeline history alice --type transfer        # Filter by operation type
beeline history alice --type transfer --type power_up # Multiple operation types
beeline history alice --currency HIVE        # Filter by currency
beeline history alice --direction incoming   # Filter by direction (incoming/outgoing/all)
beeline history alice --format json          # JSON output format

# Advanced filtering
beeline history alice --min-amount 10        # Transactions >= 10 units
beeline history alice --max-amount 100       # Transactions <= 100 units
beeline history alice --start-date 2024-01-01 # From specific date
beeline history alice --end-date 2024-02-01  # Until specific date
beeline history alice --analytics            # Show detailed analytics

Transaction History Features:

  • Complete Operation Support: transfers, power operations, rewards, savings, witness votes
  • Smart Filtering: by type, amount, currency, direction, date range
  • Analytics Dashboard: volume analysis, top recipients/senders, reward summaries
  • Multiple Formats: Table and JSON output with transaction details
  • User-Friendly Display: Human-readable descriptions and formatted amounts

Governance Commands

# Witness voting operations
beeline governance vote <witness>             # Vote for a witness
beeline governance unvote <witness>           # Remove witness vote
beeline governance vote @blocktrades          # @ prefix optional
beeline governance unvote @witness --from alice # Vote from specific account

# Witness proxy operations  
beeline governance proxy <account>            # Set witness voting proxy
beeline governance unproxy                    # Clear current proxy
beeline governance proxy @alice --from business # Set proxy from specific account

# Witness discovery and information
beeline governance witnesses                  # List top 30 witnesses by vote rank
beeline governance witnesses --limit 10      # Show top 10 witnesses
beeline governance witnesses --active        # Show only active witnesses
beeline governance witnesses --limit 5 --active # Combine filters

# Governance status and monitoring
beeline governance status                     # View your governance status
beeline governance status --from alice       # Check specific account status

# Safe testing with mock mode (recommended first!)
beeline governance vote @witness --mock      # Test voting safely
beeline governance proxy @alice --mock       # Test proxy setting safely
beeline governance unproxy --mock           # Test proxy clearing safely

# Skip confirmation prompts (for automation)
beeline governance vote @witness --confirm   # Skip confirmation prompt
beeline governance proxy @alice --confirm    # Direct execution

Governance Features:

  • Witness Voting: Vote/unvote for witnesses with PIN-protected security
  • Proxy Management: Set/clear witness voting proxy accounts
  • Witness Discovery: View ranked witness lists with active/inactive filtering
  • Status Monitoring: Track current votes, proxy settings, and voting power
  • Multi-Account Support: Vote from different accounts with --from flag
  • Mock Mode: Test all operations safely before executing
  • Cyberpunk UI: Full neon styling with animated spinners and status displays

Information Commands

beeline version                       # Version and system info
beeline --help                       # Main help
beeline <command> --help             # Command-specific help

Plugin System Commands

# Plugin management
beeline plugins list                 # List installed plugins
beeline plugins install <path>       # Install plugin from directory
beeline plugins uninstall <name>     # Remove installed plugin

# Run plugin commands
beeline run-plugin <command> [args]  # Execute plugin command

# Built-in plugins
beeline run-plugin he-tokens beggars # HiveEngine: Show token balances
beeline run-plugin he-info BEE       # HiveEngine: Token information
beeline run-plugin he-market BEE     # HiveEngine: Market data
beeline run-plugin he-transfer alice 10 BEE "Payment" --mock # HiveEngine: Transfer tokens
beeline run-plugin prices            # Price Tracker: Crypto prices
beeline run-plugin hive-price        # Price Tracker: HIVE analysis

🔐 Security Features

PIN Protection

When you login or import keys, you can set a PIN for additional encryption:

beeline login alice  # Will prompt for PIN (recommended)
beeline login alice --no-pin  # Skip PIN, use OS keychain only

Your keys are stored with multiple layers of security:

  • PIN Encryption - AES-256 encryption with your chosen PIN
  • OS Keychain - Secure storage using your system's keychain
  • Memory Scrubbing - Keys are wiped from memory after use

Multiple Security Levels

  1. Maximum Security (PIN + OS Keychain)

    beeline login alice  # Default mode
  2. Standard Security (OS Keychain only)

    beeline login alice --no-pin
  3. Mock Mode (No real keys required)

    beeline balance alice --mock
    beeline transfer @bob 1 HIVE --mock

👥 Multi-Account Workflow

Beeline is designed for users with multiple Hive accounts:

Setting Up Multiple Accounts

# Add your main account (shows welcome sequence)
beeline login alice

# Add your alt account
beeline login alice-alt

# Add your business account  
beeline login mycompany

# Add content creator account
beeline login alice-creator

Managing Multiple Accounts

# View all accounts
beeline accounts list

# View specific account details
beeline accounts info alice
beeline accounts info mycompany

# Switch default account
beeline accounts switch alice-alt

# Check which account is default
beeline accounts list  # Shows (default) indicator

Multi-Account Operations

# Use default account
beeline balance                    # Uses current default
beeline transfer @friend 5 HIVE   # From default account

# Use specific account
beeline balance mycompany
beeline transfer @customer 100 HIVE "Invoice #123" --from mycompany
beeline transfer @collaborator 25 HBD "Project payment" --from alice-creator

# Switch and operate
beeline accounts switch mycompany
beeline balance                    # Now shows mycompany balance
beeline transfer @supplier 500 HIVE "Bulk order"

Multi-Account Use Cases

# Personal vs Business separation
beeline login alice                # Personal account
beeline login alice-business       # Business account
beeline transfer @friend 5 HIVE "Dinner" --from alice
beeline transfer @vendor 200 HIVE "Services" --from alice-business

# Content creator workflow
beeline login creator              # Main creator account
beeline login creator-tips         # Tips and donations account
beeline transfer @collaborator 50 HIVE "Video editing" --from creator
beeline balance creator-tips       # Check tip earnings

# Testing and development
beeline login testaccount          # Test account
beeline transfer @anyone 0.001 HIVE "API test" --from testaccount --mock

Transaction History Use Cases

# Business accounting and reconciliation
beeline history business-account --analytics           # Comprehensive business analytics
beeline history business-account --type transfer --currency HIVE  # HIVE transfers only
beeline history business-account --start-date 2024-01-01 --end-date 2024-01-31  # Monthly records

# Personal finance tracking
beeline history alice --direction incoming --min-amount 10  # Major incoming payments
beeline history alice --type author_reward --type curation_reward  # Content earnings
beeline history alice --analytics --format json            # Detailed analytics export

# Tax preparation and auditing
beeline history creator --start-date 2024-01-01            # Year-to-date transactions
beeline history creator --type transfer --direction outgoing # Business expenses
beeline history creator --currency HBD --analytics         # HBD-specific analysis

# Security monitoring
beeline history alice --type transfer --direction outgoing  # Monitor outgoing transfers
beeline history alice --min-amount 100                     # Large transactions only
beeline history alice --limit 20                           # Recent activity check

Governance Use Cases

# Individual witness participation
beeline governance witnesses                        # Discover witness candidates
beeline governance vote @blocktrades                # Vote for trusted witnesses
beeline governance vote @gtg                        # Support multiple witnesses
beeline governance status                           # Monitor your votes

# Community proxy delegation
beeline governance proxy @hive-community           # Delegate voting to community
beeline governance proxy @witness-category         # Delegate to category expert
beeline governance status                           # Verify proxy status

# Multi-account governance management
beeline governance vote @witness --from @business  # Business account voting
beeline governance proxy @expert --from @personal  # Personal account proxy
beeline governance status --from @business         # Check business votes
beeline governance status --from @personal         # Check personal proxy

# Witness evaluation and switching
beeline governance witnesses --active --limit 10   # Top active witnesses
beeline governance unvote @inactive-witness        # Remove votes from inactive
beeline governance vote @new-witness               # Support new candidates
beeline governance status                           # Verify changes

# Safe governance testing
beeline governance vote @test-witness --mock       # Test voting process
beeline governance proxy @test-proxy --mock        # Test proxy setting
beeline governance witnesses                        # Always safe to browse

🎨 Cyberpunk Features

Visual Style

  • Neon Colors - Cyan, magenta, electric green with gradients
  • ASCII Art - Epic banners and grid patterns
  • Animated Effects - Spinning loaders and progress indicators
  • Styled Output - Color-coded roles, status indicators, and boxes

Command Styling

Every command features cyberpunk aesthetics:

  • 🔹 Account names with @ prefix
  • 🔸 Color-coded key roles (posting, active, memo, owner)
  • ⚡ Animated spinners during blockchain operations
  • 📦 Boxed output with neon borders
  • 🎯 Status indicators and progress feedback

🛠️ Advanced Usage

Key Roles Explained

  • 📝 posting - Social interactions (posts, votes, follows)
  • ⚡ active - Financial operations (transfers, power up/down)
  • 💬 memo - Private encrypted messages
  • 👑 owner - Account control (recovery, key changes) - Use with extreme caution

Import Strategies

  1. Password Login (Recommended)

    beeline login alice --roles posting,active,memo

    Automatically derives all keys from your master password

  2. Individual Key Import (Advanced)

    beeline keys import alice posting  # Import one key at a time
    beeline keys import alice active

    For users who prefer manual key management

Mock Mode for Testing

Test all operations safely before using real blockchain:

# Test balance checking
beeline balance alice --mock
beeline balance nonexistent --mock        # Works even for fake accounts

# Test transfers without broadcasting
beeline transfer @bob 10 HIVE "test" --mock
beeline transfer @alice 999 HIVE "big test" --mock --confirm
beeline transfer @anyone 5 HBD "safe test" --from @fakeaccount --mock

# Test power operations safely
beeline powerup 100 HIVE --mock           # Test power up
beeline powerdown 50 HP --mock            # Test power down

# Test savings operations safely  
beeline deposit 1000 HBD --mock           # Test savings deposit
beeline withdraw 500 HIVE --mock          # Test savings withdrawal

# Test reward claiming safely
beeline claim --mock                      # Test reward claiming

# Test RC monitoring (read-only operations)
beeline rc alice                          # Always safe - just reads data
beeline rc alice --format json           # JSON output

# Test account management (always safe)
beeline accounts list                      # No blockchain calls
beeline keys list                         # Local vault only

# Test all commands safely
beeline login testaccount --mock          # Will show error but safe
beeline transfer @test 1 HIVE --mock      # Always works

# Test history and governance operations (always safe - read-only)
beeline history alice                      # Always safe - just reads blockchain data
beeline governance witnesses               # Always safe - just reads blockchain data
beeline governance status                  # Always safe - just reads blockchain data

# Test governance operations safely
beeline governance vote @witness --mock    # Test witness voting safely
beeline governance proxy @alice --mock     # Test proxy setting safely
beeline governance unproxy --mock         # Test proxy clearing safely

Recommended Testing Workflow

# 1. Start with mock mode to learn commands
beeline balance alice --mock
beeline transfer @bob 1 HIVE "learning" --mock
beeline powerup 10 HIVE --mock             # Learn power operations
beeline deposit 100 HBD --mock             # Learn savings operations
beeline claim --mock                       # Learn reward claiming
beeline governance vote @witness --mock    # Learn governance operations
beeline governance proxy @alice --mock     # Learn proxy operations

# 2. Test account management and information (always safe)
beeline accounts list
beeline keys list  
beeline history alice                       # Read blockchain data safely
beeline governance witnesses               # Read blockchain data safely
beeline governance status                  # Read blockchain data safely  

# 3. Only then proceed to real operations with small amounts
beeline login testaccount                  # Use test account first!
beeline balance testaccount               # Real blockchain check
beeline transfer @friend 0.001 HIVE "real test"  # Tiny real transfer

# 4. Scale up to normal operations
beeline login mainaccount
beeline balance
beeline transfer @recipient 10 HIVE "real payment"

🔌 Plugin System

Beeline features an extensible plugin architecture that allows community developers to create custom extensions for specialized functionality.

Installing Example Plugins

Beeline includes powerful example plugins that are NOT pre-installed for security reasons. You must manually install them to use their functionality:

# Install the HiveEngine plugin (tokens, transfers, trading, NFTs)
beeline plugins install examples/hiveengine-plugin

# Install the Price Tracker plugin (crypto prices, HIVE analysis)
beeline plugins install examples/price-tracker-plugin

# Verify installation
beeline plugins list

Why aren't plugins pre-installed?

  • Security First: Plugins can execute arbitrary code, so we require explicit user consent
  • User Choice: You only install plugins you actually need
  • Trust Model: You review and choose which plugins to trust with your wallet

Available Example Plugins

HiveEngine Plugin

Complete integration with HiveEngine sidechain with full contract coverage for tokens, NFTs, trading, and token creation:

# 📊 INFORMATION & ANALYSIS
beeline run-plugin he-tokens [account]    # Show token balances
beeline run-plugin he-info <symbol>       # Detailed token information
beeline run-plugin he-market <symbol>     # Market data and prices
beeline run-plugin he-top [limit]         # Top tokens by volume
beeline run-plugin he-nfts [account]      # NFT collections
beeline run-plugin he-mining              # Mining pool statistics
beeline run-plugin he-test                # API connectivity test

# 💸 TOKEN TRANSACTIONS
beeline run-plugin he-transfer <to> <amount> <symbol> [memo] # Transfer tokens
beeline run-plugin he-stake <amount> <symbol>                # Stake tokens for rewards
beeline run-plugin he-unstake <amount> <symbol>              # Unstake tokens (with cooldown)
beeline run-plugin he-delegate <amount> <symbol> <to>        # Delegate staked tokens
beeline run-plugin he-undelegate <amount> <symbol> <from>    # Undelegate tokens

# 💹 MARKET TRADING (Complete Coverage)
beeline run-plugin he-sell <amount> <symbol> <price>         # Create limit sell order
beeline run-plugin he-buy <amount> <symbol> <price>          # Create limit buy order
beeline run-plugin he-market-sell <amount> <symbol>          # Market sell at current rate
beeline run-plugin he-market-buy <hive_amount> <symbol>      # Market buy with SWAP.HIVE
beeline run-plugin he-cancel <buy|sell> <order_id>           # Cancel an existing order

# 🏭 TOKEN CREATION
beeline run-plugin he-create <name> <symbol> [options]       # Create new token
beeline run-plugin he-wizard                                 # Interactive token creation wizard
beeline run-plugin he-issue <amount> <symbol> <to>           # Issue tokens (creator only)

Example Usage:

# Check your HiveEngine tokens
beeline run-plugin he-tokens beggars

# Get detailed BEE token information
beeline run-plugin he-info BEE

# View BEE market data and prices
beeline run-plugin he-market BEE

# Transfer 10 BEE tokens to alice
beeline run-plugin he-transfer alice 10 BEE "Payment for services"

# Stake 50 LEO tokens for rewards
beeline run-plugin he-stake 50 LEO

# Delegate 25 staked LEO tokens to alice
beeline run-plugin he-delegate 25 LEO alice

# Market trading examples
beeline run-plugin he-sell 100 LEO 1.5          # Limit sell: 100 LEO at 1.5 SWAP.HIVE each
beeline run-plugin he-market-buy 10 BEE          # Market buy: spend 10 SWAP.HIVE on BEE tokens
beeline run-plugin he-market-sell 50 LEO         # Market sell: 50 LEO at current market rate
beeline run-plugin he-cancel sell 64a5f2b1...    # Cancel a sell order

# Token creation
beeline run-plugin he-create "My Token" MYTOKEN --precision 8 --max-supply 1000000  # Command line
beeline run-plugin he-wizard                     # Interactive wizard (recommended)
beeline run-plugin he-issue 1000 MYTOKEN alice   # Issue tokens to alice

# Advanced features
beeline run-plugin he-nfts alice                 # View alice's NFT collections
beeline run-plugin he-top 15                     # Top 15 tokens by volume

# Safe testing with mock mode (highly recommended before live transactions)
beeline run-plugin he-transfer alice 10 BEE --mock
beeline run-plugin he-market-buy 5 LEO --mock
beeline run-plugin he-create "Test Token" TEST --mock

Price Tracker Plugin

Cryptocurrency price tracking with HIVE ecosystem focus:

# Price operations
beeline run-plugin prices [currency]       # Major crypto prices (USD/EUR/BTC)
beeline run-plugin hive-price              # Detailed HIVE analysis + portfolio
beeline run-plugin compare <coins...>      # Compare multiple cryptocurrencies

Example Usage:

# View major cryptocurrency prices
beeline run-plugin prices

# Get detailed HIVE analysis with your portfolio value
beeline run-plugin hive-price

# Compare Bitcoin, HIVE, and Ethereum
beeline run-plugin compare bitcoin hive ethereum

Plugin Management

# View installed plugins
beeline plugins list

# Install new plugin from directory
beeline plugins install examples/my-plugin
beeline plugins install /path/to/plugin

# Remove plugin
beeline plugins uninstall plugin-name

# Execute plugin commands
beeline run-plugin <command-name> [arguments]

Plugin Features

Beeline plugins support both command-line and interactive UI functionality:

Command-Line Interface

  • Standard CLI commands with arguments and flags
  • Support for --mock mode for safe testing
  • Integration with wallet operations and blockchain
  • Automatic help generation and command discovery

Interactive Terminal UI

  • Rich terminal interfaces using blessed.js
  • Forms, buttons, and keyboard navigation
  • Tab navigation between form elements
  • Real-time input validation and feedback
  • Cyberpunk-styled UI matching the wallet aesthetic

Plugin Capabilities

  • Access to wallet account information and balances
  • Safe API integrations with external services
  • Blockchain transaction construction and broadcasting
  • File system access for configuration and data storage
  • Full access to Node.js ecosystem and npm packages

Plugin Development

Create your own plugins using the simple plugin API. See PLUGIN_DEVELOPMENT.md for comprehensive documentation including UI development.

Quick Start:

# 1. Create plugin directory with package.json and index.js
mkdir my-plugin
cd my-plugin

# 2. Create package.json
echo '{"name": "my-plugin", "version": "1.0.0", "main": "index.js"}' > package.json

# 3. Create index.js with plugin code
# 4. Install plugin
beeline plugins install .

🔧 Development

Building from Source

git clone https://github.com/Vheissu/beeline
cd beeline
npm install
npm run build
./bin/run --help

Development Commands

npm run dev      # Run with ts-node
npm run build    # Compile TypeScript
npm run lint     # Code linting
npm test         # Run tests

🚨 Security Notes

⚠️ Important Security Practices

  1. Never share your private keys or master password
  2. Use PIN encryption for additional security
  3. Test with mock mode before live operations
  4. Keep your master password secure and backed up
  5. Be cautious with owner keys - they control your entire account

🔒 What Beeline Stores

  • Encrypted private keys in your OS keychain
  • Public keys and account metadata in local config
  • NO passwords or sensitive data in plain text

🛡️ What Beeline Doesn't Store

  • Your master password (memory is scrubbed immediately)
  • Unencrypted private keys
  • Transaction history (fetched fresh from blockchain)

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT License - see LICENSE file for details.

🌟 Acknowledgments

  • Built with OCLIF framework
  • Powered by DHive for Hive blockchain connectivity
  • Styled with Chalk and friends for terminal colors

Welcome to the neon grid, runner. Type, sign, rule the chain.

Find me on Hive @beggars

About

A CLI for the Hive blockchain.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published