Metadata-Version: 2.4
Name: powerloom-snapshotter-cli
Version: 0.4.1
Summary: CLI tool for deploying and managing Powerloom Snapshotter nodes
Project-URL: Bug Tracker, https://github.com/powerloom/snapshotter-lite-multi-setup/issues
Project-URL: Changelog, https://github.com/powerloom/snapshotter-lite-multi-setup/blob/master/CHANGELOG.md
Project-URL: Twitter, https://x.com/powerloom
Author-email: Powerloom Protocol <hello@powerloom.io>
License: MIT
License-File: LICENSE
Keywords: blockchain,cli,ethereum,node-management,powerloom,snapshotter,web3
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: <3.14,>=3.12
Requires-Dist: psutil>=5.9.8
Requires-Dist: pydantic>=2.10.4
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: rich>=13.7.0
Requires-Dist: toml>=0.10.2
Requires-Dist: typer[all]==0.15.4
Requires-Dist: web3>=6.15.1
Description-Content-Type: text/markdown

# Powerloom Snapshotter CLI

A powerful command-line interface for deploying and managing Powerloom Snapshotter nodes. Simplifies the process of running multiple snapshotter instances across different chains and data markets.

## Features

- 🚀 **Interactive Shell Mode** - Eliminates startup delays for multiple commands
- 📦 **Multi-Instance Management** - Deploy and manage multiple snapshotter nodes
- 🔧 **Easy Configuration** - Store credentials per chain/market combination  
- 🔍 **Built-in Diagnostics** - Check system health and troubleshoot issues
- 🐳 **Docker Integration** - Automated container and network management
- 🔐 **Secure Credential Storage** - Namespaced environment configurations

## Installation

```bash
# Install using pip
pip install powerloom-snapshotter-cli

# Install using pipx (recommended)
pipx install powerloom-snapshotter-cli
```

## Quick Start

### Interactive Shell (Recommended)

```bash
# Start interactive shell for faster command execution
powerloom-snapshotter-cli shell

# In shell mode:
powerloom-snapshotter> configure
powerloom-snapshotter> deploy
powerloom-snapshotter> status
```

### Direct Commands

```bash
# Configure credentials for a chain/market
powerloom-snapshotter-cli configure --env mainnet --market uniswapv2

# Deploy a snapshotter instance
powerloom-snapshotter-cli deploy

# Check status of running instances
powerloom-snapshotter-cli status

# View detailed status
powerloom-snapshotter-cli status --env mainnet --market uniswapv2
```

## Available Commands

- `configure` - Set up chain and market-specific credentials
- `deploy` - Deploy a new snapshotter instance
- `status` - View status of deployed instances
- `list` - Display available chains and data markets
- `diagnose` - Run system diagnostics
- `identity` - Manage multiple configurations
- `shell` - Start interactive mode

## Command Aliases

The CLI is available through multiple aliases:
- `powerloom-snapshotter-cli` (full name)
- `snapshotter` (short)

## Supported Chains & Markets

- **Mainnet**: Ethereum mainnet data markets
- **Devnet**: Development network for testing
- Multiple data markets including UniswapV2, AaveV3, and more

## Requirements

- Python 3.12 or higher
- Docker and Docker Compose
- Linux or macOS (Windows support via WSL)

## Documentation

- [Full Documentation](https://github.com/powerloom/snapshotter-lite-multi-setup/blob/master/CLI_DOCUMENTATION.md)
- [GitHub Repository](https://github.com/powerloom/snapshotter-lite-multi-setup)
- [Powerloom Website](https://powerloom.io)

## License

MIT License - see [LICENSE](https://github.com/powerloom/snapshotter-lite-multi-setup/blob/master/LICENSE) for details.

## Support

- [Report Issues](https://github.com/powerloom/snapshotter-lite-multi-setup/issues)
- [Discord Community](https://discord.gg/powerloom)
