Skip to content

THCloud CLI v0.1.0 - Initial Release with Filecoin Sector Management

Pre-release
Pre-release

Choose a tag to compare

@xiaoliwe xiaoliwe released this 26 Dec 05:01
· 51 commits to main since this release

THCloud CLI Tool v0.1.0

THCloud CLI Tool (thctl) is a powerful command-line interface for managing and operating various services on the THCloud platform.

馃帀 New Features

Filecoin Sector Management

  • sectors list: List all sectors for a specified miner
  • sectors status: Get sector status information
  • sectors info: Get detailed sector information
  • sectors penalty: Query sector penalties
  • sectors vested: Check vested funds

Multiple Storage Provider Support

  • Filecoin: Complete sector management functionality
  • OSS: Alibaba Cloud Object Storage Service
  • COS: Tencent Cloud Object Storage
  • S3: Amazon Simple Storage Service

Output Format Support

  • JSON format
  • YAML format
  • Table format (default)

馃摜 Download and Installation

Choose the appropriate version for your operating system:

  • macOS (Intel): thctl-darwin-amd64.tar.gz
  • macOS (Apple Silicon): thctl-darwin-arm64.tar.gz
  • Linux: thctl-linux-amd64.tar.gz
  • Windows: thctl-windows-amd64.zip

Installation Steps

macOS/Linux:

# Extract the downloaded file
tar xzf thctl-darwin-amd64.tar.gz  # or your corresponding version

# Install to system directory
sudo cp thctl-darwin-amd64 /usr/local/bin/thctl
sudo chmod 755 /usr/local/bin/thctl

# Verify installation
thctl --version

Windows:

  1. Extract thctl-windows-amd64.zip
  2. Rename the extracted thctl-windows-amd64.exe to thctl.exe
  3. Move it to a directory in your PATH environment variable

馃殌 Quick Start

  1. Set up environment variables:
# Filecoin API Configuration
export FULLNODE_API_INFO="<your-lotus-api-token>:/ip4/<lotus-api-ip>/tcp/<lotus-api-port>/http"

# THCloud API Configuration (Optional)
export THC_API_KEY="your-api-key"
  1. Basic command usage:
# View help
thctl --help

# List sectors
thctl fil sectors list --miner f01234

# Check sector status
thctl fil sectors status --miner f01234 --sector 1

# Query sector penalty
thctl fil sectors penalty --miner f01234 --sector 1

# Check vested funds
thctl fil sectors vested --miner f01234

馃摑 Configuration

Default configuration file location: $HOME/.thctl/config.yaml

Example configuration:

fil:
  lotus:
    api_url: "http://127.0.0.1:1234/rpc/v0"
    auth_token: "your-lotus-token"
output: "table"  # json, yaml, table

馃摎 Documentation

For detailed documentation, please refer to:

馃攧 Changelog

For a complete list of changes, see CHANGELOG.md

馃 Contributing

Issues and Pull Requests are welcome!

馃搫 License

Apache License 2.0