Skip to content

RentOps/cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RentOps CLI

A command-line interface for monitoring and reclaiming dormant rent-exempt SOL from Kora Node operations.

Features

  • Deep Scan: Introspect transaction history to identify accounts funded by your Kora Node.
  • Status Classification: Automatically distinguishes between RECLAIMABLE accounts (node-owned) and SPONSORED accounts (user-owned).
  • Rent Reclamation: Safely closes eligible accounts and returns rent to the node treasury.
  • Safety Checks: Prevents accidental closure of accounts with non-zero token balances or incorrect ownership.
  • Whitelist Management: Maintain a list of protected accounts to exclude from scans.

Usage

General Syntax

rentops [COMMAND] [OPTIONS]

Commands

1. Scan Analyze a Kora Node's history to find rent-locked accounts.

rentops scan --kora-node <NODE_ADDRESS> --network mainnet

2. Stats View current global metrics (total locked, reclaimed, active accounts).

rentops stats

3. Reclaim Close a specific account and recover rent. Requires the private key of the account authority.

rentops reclaim --account <TARGET_ACCOUNT> --kora-node <DESTINATION_WALLET> --network mainnet

Note: If the account is user-owned, you must provide the user's private key.

4. Whitelist Manage protected accounts.

rentops whitelist list
rentops whitelist add --account <ADDRESS>
rentops whitelist remove --account <ADDRESS>

Installation

Linux (x86_64)

Use the automated installer:

curl -sL https://raw.githubusercontent.com/rentops/binaries/main/install.sh | bash

macOS / Windows / Other Linux

Build from source using Rust.

Prerequisites:

Build & Install:

  1. Clone the repository:

    git clone https://github.com/rentops/cli.git
    cd cli
  2. Build and install to Cargo bin:

    cargo install --path .
  3. Verify installation:

    rentops --help

Configuration

The CLI connects to the RentOps backend. By default, it points to the public production API. To use a custom backend (e.g., local instance), set the environment variable:

export RENTOPS_API_URL="http://localhost:3000"