Ethos CLI

A command-line interface (CLI) for interacting with the Ethereum OS platform.

Installation

Install the Ethos CLI globally using npm:

npm install -g ethos

Configuration

Initialize Configuration

Set up the CLI with your private key:

ethos init --private-key your_private_key_here

This creates a configuration file at ~/.ethos/config.json. Do not share this file!

Command Reference

Here is a quick reference for all available commands.

| Command | Description | | :--- | :--- | | ethos init --private-key <key> | Initializes and saves your private key to the config file. | | ethos private-key --set <key> | Updates the configuration with a new private key. | | ethos private-key --delete | Deletes the private key from the configuration file. | | ethos rpc | Lists available RPC endpoints. | | ethos rpc --select <index> | Selects a default RPC endpoint from the list by its index. | | ethos rpc --add <url> | Adds a new custom RPC endpoint to the list. | | ethos gm | Sends a "GM" transaction to stay active. | | ethos claim | Claims your pending $AIR token rewards. | | ethos stats | Displays key stats like APY, your balance, and token price. | | ethos buy <amount_in_eth> | Buys a specified amount of $AIR tokens using ETH. | | ethos sell <amount_of_air> | Sells a specified amount of your $AIR tokens for ETH. |

Usage

• Say GM:

  ethos gm

  Sends a "GM" transaction to keep your account active in the Ethereum OS.

• Claim Pending $AIR Tokens:

  ethos claim

  Claims pending $AIR tokens based on the ponzi rewards APY.

• Display Stats:

  ethos stats

  Displays Ethereum OS stats: total GM, current APY, your balance,and token price.

• Buy $AIR Tokens:

  ethos buy <amount_in_eth>

  Buys a specified amount of $AIR tokens using ETH. For example, to buy 0.1 ETH worth of $AIR: ethos buy 0.1

• Sell $AIR Tokens:

  ethos sell <amount_of_air>

  Sells a specified amount of your $AIR tokens for ETH. For example, to sell 1000 $AIR: ethos sell 1000

Example Outputs

• Initialize:

  ethos init --private-key your_private_key_here

  Output:

  Initializing configuration...
  ┏━┳━━┳┓┏┓┏━┳━━┓
  ┃┳┻┓┏┫┗┛┃┃┃┃━━┫
  ┃┻┓┃┃┃┏┓┃┃┃┣━━┃
  ┗━┛┗┛┗┛┗┛┗━┻━━┛
  Configuration saved to: ~/.ethos/config.json
  WARNING: Do not share your config file or private key with anyone!
  Ethos CLI is ready! Use 'ethos --help' to explore commands.

• Say GM:

  ethos gm

  Output:

  Connecting to RPC...
  Using account: 0xYourAccountAddress
  Preparing to say GM...
  Checking account status...
  Account is active
  Checking gas balance...
  Gas balance sufficient
  Saying GM...
  Sending transaction...
  Transaction sent: 0x123...abc
  Waiting for confirmation...
  Transaction confirmed in block: 567890
  Success: GM successfully said! Don't forget to say GM every day!

• Claim Tokens:

  ethos claim

  Output:

  Connecting to RPC...
  Using account: 0xYourAccountAddress
  Preparing to claim $AIR tokens...
  Checking pending $AIR tokens...
  Pending $AIR tokens: 50
  Checking gas balance...
  Gas balance sufficient
  Claiming $AIR tokens for account 0xYourAccountAddress...
  Sending transaction...
  Transaction sent: 0x123...abc
  Waiting for confirmation...
  Transaction confirmed in block: 567890
  Success: Claimed 50 $AIR tokens. Current balance: 1000 $AIR.

• Display Stats:

  ethos stats

  Output:

  Connecting to RPC...
  Using account: 0xYourAccountAddress
  Fetching Ethereum OS stats...
  Fetching total GM...
  Fetching current APY...
  Fetching your balance...
  Fetching token price from Moralis...
  Token price fetched successfully
  Ethereum OS Stats:
    Total GM: 15295
    Current APY: 12%/day
    Your Balance: 0.0 $AIR
    Price: 0.006530834029666094 USD on Uniswap v2
    24hr Price Change: -0.0005671457331588997 USD

Security

• Do not share your private key or ~/.ethos/config.json.
• Remove the configuration file with rm -rf ~/.ethos when not in use.
• Ensure your account has enough ETH for gas fees on mainnet.

Notes

• The CLI uses default RPC endpoints automatically.
• RPC selection prompt appears only if the connection fails.
• Contract address: 0x8164B40840418C77A68F6f9EEdB5202b36d8b288 (mainnet).