Binary reference

online-info-switch

Online information hub for Kodachi OS - RSS feeds, paste services, freshness proofs, and connectivity status

Version10.0.1 (build 1)Size10.5MBAuthorWarith Al MaawaliLicenseProprietaryWebsitehttps://www.digi77.com

File Information

Property	Value
Binary Name	online-info-switch
Version	10.0.1 (build 1)
Build Date	Not disclosed
Rust Version	1.82.0
File Size	10.5MB
Author	Warith Al Maawali
License	Proprietary
Category	Kodachi Binary
Description	Online information hub for Kodachi OS - RSS feeds, paste services, freshness proofs, and connectivity status
Git Commit	unknown
Metadata Generated	2026-09-10T20:34:47Z
Binary Timestamp	Unknown
JSON Data	View Raw JSON

SHA256 Checksum

2d93d5fa4a3cb7501ea2637f9f4a42eb2d97e07a4493cda8afe378e604cb0cd5

Features

#	Feature
1	Online/offline status checking via health-control
2	RSS feed aggregation from security news sources
3	Public paste service integration
4	Proof of freshness with current news and blockchain data
5	Crypto and precious metals prices, Bitcoin balance lookups
6	Kodachi cloud, knet and Tor exit checks

Security Features

Feature	Description
Authentication	Not provided by cli-core (see online-auth)
Encryption	Not provided by cli-core
Input Validation	Argument parsing via clap; per-command validation is the consumer's responsibility
Rate Limiting	Not provided by cli-core

System Requirements

Requirement	Value
OS	Linux (Debian-based)
Privileges	root/sudo for system operations
Dependencies	OpenSSL, libcurl

Global Options

Flag	Description
`-h, --help`	Print help information
`-v, --version`	Print version information
`-n, --info`	Display detailed information
`-e, --examples`	Show usage examples
`--json`	Output in JSON format
`-o, --output-format <FORMAT>`	Force output format (text\|json)
`--json-pretty`	Pretty-print JSON output with indentation
`--json-human`	Enhanced JSON output with improved formatting (like jq)
`--json-filter <FIELD1,FIELD2>`	Return only specified JSON fields (comma-separated)
`--fields <FIELD_LIST>`	Select specific fields to include in output (comma-separated)
`--limit <NUMBER>`	Limit number of results returned
`--offset <NUMBER>`	Skip first N results (for pagination)
`-d, --work-dir <PATH>`	Working directory (defaults to auto-detected base directory)
`--port <PORT>`	Set custom port number (1024-65535)
`--log-level <LEVEL>`	Set log level (error\|warn\|info\|debug)
`--verbose`	Enable verbose output
`--quiet`	Suppress non-essential output
`--no-color`	Disable colored output
`--config <FILE>`	Use custom configuration file
`--timeout <SECS>`	Set operation timeout in seconds (optional; no default applied)

Commands

Connectivity

`status`

Show current online/offline status

Usage:

online-info-switch status

Options:

--json: Emit the status as compact JSON (global flag)
-t, --timeout <SECONDS>: Global request timeout

Examples:

online-info-switch status

online-info-switch status --json

online-info-switch status --json-pretty

Kodachi Cloud

`releases`

Check Kodachi release information

Usage:

online-info-switch releases [EDITION]

Options:

[EDITION]: Edition to report on: binary_pack, terminal or desktop. Omit for all of them

Examples:

online-info-switch releases

online-info-switch releases binary_pack

online-info-switch releases desktop

online-info-switch releases --json-pretty

`cloud-stats`

Fetch Kodachi cloud infrastructure statistics

Usage:

online-info-switch cloud-stats

Options:

-t, --timeout <SECONDS>: Request timeout. The stats endpoint can be slow
--json: Emit the statistics as compact JSON (global flag)

Examples:

online-info-switch cloud-stats

online-info-switch cloud-stats --timeout 120

online-info-switch cloud-stats --json-pretty

`knet-status`

Check Kodachi network connection status

Usage:

online-info-switch knet-status

Options:

-t, --timeout <SECONDS>: Request timeout for the knet lookup
--json: Emit the knet state as compact JSON (global flag)

Examples:

online-info-switch knet-status

online-info-switch knet-status --json

online-info-switch knet-status --timeout 60

`vps-tor-check`

Check VPS Tor exit IP through SOCKS5 proxy

Usage:

online-info-switch vps-tor-check [OPTIONS]

Options:

--socks-host <HOST>: SOCKS5 proxy host. Supplying it disables port auto-detection
--socks-port <PORT>: SOCKS5 proxy port. When neither flag is given, ports 9050, 9150 and the Kodachi pool 10000 to 10019 are probed and the first listener wins

Examples:

online-info-switch vps-tor-check

online-info-switch vps-tor-check --socks-port 9150

online-info-switch vps-tor-check --socks-host 192.168.1.100 --socks-port 9051

online-info-switch vps-tor-check --json-pretty

Markets

`price`

Check cryptocurrency and precious metals prices

Usage:

online-info-switch price <COIN>

Options:

<COIN>: Symbol to price: btc, eth, xmr, azero, near, gold, silver, xau, xag, or all

Examples:

online-info-switch price btc

online-info-switch price xmr

online-info-switch price gold

online-info-switch price all

online-info-switch price all --json

`balance`

Check Bitcoin wallet balance

Usage:

online-info-switch balance <ADDRESS>

Options:

<ADDRESS>: Bitcoin address (legacy or bc1 Segwit). It is sent to public blockchain explorers, which see it and your exit IP

Examples:

online-info-switch balance 34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo

online-info-switch balance bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2 --json

News and Freshness

`rss`

Fetch RSS feeds from security news sources

Usage:

online-info-switch rss [OPTIONS]

Options:

-s, --sources <SOURCES>: Comma separated list of RSS sources to fetch. Conflicts with --random
-r, --random: Fetch from a single randomly chosen source. Conflicts with --sources
-m, --max-items <COUNT>: Maximum number of items to display

Examples:

online-info-switch rss

online-info-switch rss --max-items 5

online-info-switch rss --random

online-info-switch rss --sources "darkreading,wired"

online-info-switch rss --json-pretty

`freshness`

Show proof of system freshness

Usage:

online-info-switch freshness

Options:

--json: Emit the freshness proof as compact JSON (global flag)
-t, --timeout <SECONDS>: Global request timeout for the news and blockchain fetches

Examples:

online-info-switch freshness

online-info-switch freshness --json

online-info-switch freshness --json-pretty

`paste`

Upload content to public paste services

Usage:

online-info-switch paste [TEXT] [OPTIONS]

Options:

[TEXT]: Content to paste. Read from stdin when omitted. Conflicts with --file
-f, --file <PATH>: Read the content from a file instead. Conflicts with TEXT
-s, --services <SERVICES>: Comma separated services: paste.rs, dpaste.com, catbox.moe, termbin.com
--expire <DAYS>: Expiration in days. Accepted and parsed, but no backend service currently applies it
--allow-termbin-plaintext: Opt in to termbin.com. WARNING: plaintext TCP on port 9999, bypasses Tor and any proxy, exposes your real IP

Examples:

echo "Hello World" | online-info-switch paste

online-info-switch paste "Sample content"

online-info-switch paste --file /path/to/file.txt

online-info-switch paste "test" --services "paste.rs"

online-info-switch paste "test" --services "termbin.com" --allow-termbin-plaintext

online-info-switch paste "test" --json-pretty

Operational Scenarios

Scenario-oriented workflows generated from the binary's built-in -e --json examples.

Scenario 1: Quick Start

The four things this tool is reached for most. Every command needs network access, and none of them need root.

Step 1: Check whether the machine currently has working internet access

online-info-switch status

Expected Output: 🌐 System is online, followed by location and IP details when available

Note

Delegates the connectivity probe to health-control.

Step 2: Read the five most recent security headlines

online-info-switch rss --max-items 5

Expected Output: Five headlines, each with publication date, source and link

Step 3: Prove the system clock and its view of the world are current

online-info-switch freshness

Expected Output: Current UTC time, the latest headlines and current blockchain data

Note

Useful after a suspend or a clock reset, and as evidence that a snapshot was taken today.

Step 4: Read one market price as JSON, for scripting

online-info-switch price btc --json

Expected Output: {"success":true,"coin":"BTC","symbol":"BTC","price_usd":64210.5,"source":"...","timestamp":"..."}

Scenario 2: Output Formats

Every command takes the same global output flags. --json is the one to script against.

Step 1: Compact single line JSON, meant for pipes and workflow steps

online-info-switch status --json

Expected Output: {"is_online":true,"status":"online","connectivity":"FullConnectivity","degraded":false,"message":"System is online","timestamp":"..."}

Step 2: Indented JSON, for reading by eye

online-info-switch status --json-pretty

Expected Output: The same object, indented over multiple lines

Step 3: Colorized, human oriented rendering of the JSON

online-info-switch status --json-human

Expected Output: The same fields, colored and aligned

Note

Colors are dropped automatically when the output is not a terminal.

Step 4: Raise the global request timeout for a slow endpoint

online-info-switch cloud-stats --timeout 120

Expected Output: Cloud statistics, or a timeout error after 120 seconds

Note

--timeout (-t) is a global flag, in seconds. Without it, cloud-stats uses 60s and knet-status uses 30s.

Scenario 3: RSS Feed Operations

Pull security headlines from the configured feeds. Feeds are fetched over the current routing, so they travel through Tor or the VPN when those are active.

Step 1: Fetch the newest items from every configured source

online-info-switch rss

Expected Output: Up to 10 headlines, each with date, source and link

Note

A source that is unreachable is skipped rather than failing the whole command.

Step 2: Fetch from one randomly chosen source instead of all of them

online-info-switch rss --random

Expected Output: Headlines from a single feed

Note

--random and --sources are mutually exclusive.

Step 3: Fetch only from the named sources

online-info-switch rss --sources "darkreading,wired"

Expected Output: Headlines from darkreading and wired only

Note

Comma separated. Short form: -s.

Step 4: Cap how many items come back

online-info-switch rss --max-items 5

Expected Output: The 5 newest headlines

Note

Defaults to 10. Short form: -m.

Step 5: Get the feed items as structured JSON

online-info-switch rss --json-pretty

Expected Output: {"items":[{"title":"...","pub_date":"...","source":"...","link":"..."}],"total_items":10}

Scenario 4: Paste Service Operations

Upload text to public paste services (paste.rs, dpaste.com and catbox.moe, all over HTTPS). Anything pasted becomes PUBLIC at a URL anyone can open, so never paste keys, credentials, or logs containing your IP. This command requires an authenticated session.

Step 1: Paste from stdin to the default HTTPS services

echo "Hello World" | online-info-switch paste

Expected Output: One URL per service: paste.rs, dpaste.com and catbox.moe

Note

Requires authentication: run `online-auth authenticate` first, otherwise the command returns "Authentication required" and exits non-zero.

Step 2: Paste a literal string

online-info-switch paste "Sample content"

Expected Output: Paste URLs from the default services

Note

The pasted content is public and unencrypted. Treat every paste as permanent.

Step 3: Paste the contents of a file

online-info-switch paste --file /path/to/file.txt

Expected Output: Paste URLs for the file contents

Note

Short form: -f. --file and the inline TEXT argument are mutually exclusive.

Step 4: Send to a single named service

online-info-switch paste "test" --services "paste.rs"

Expected Output: A single paste.rs URL

Note

Short form: -s, default "all". Known services: paste.rs, dpaste.com, catbox.moe and termbin.com.

Step 5: Send to several named services at once

online-info-switch paste "test" --services "dpaste.com,catbox.moe,paste.rs"

Expected Output: One URL per requested service

Step 6: Send to termbin.com, which needs an explicit opt-in

online-info-switch paste "test" --services "termbin.com" --allow-termbin-plaintext

Expected Output: A termbin.com URL

Note

WARNING: termbin.com uses unencrypted TCP on port 9999, which bypasses Tor and any proxy and exposes your real IP address. Without --allow-termbin-plaintext the service is skipped. Only use it on a trusted network when anonymity does not matter.

Step 7: Get the per-service results as JSON

online-info-switch paste "test" --json-pretty

Expected Output: {"results":[{"service":"paste.rs","success":true,"url":"https://paste.rs/abc"}],"success":true}

Note

When no service succeeds the result is success:false and the exit code is non-zero, so it can be tested in a workflow.

Scenario 5: Freshness Proof Operations

Combine the current time, the latest headlines and current blockchain data into evidence that the system's view of the world is up to date.

Step 1: Print a human readable freshness proof

online-info-switch freshness

Expected Output: Current UTC time, the newest headlines and current blockchain data

Note

Needs network access: it fetches live news and blockchain data, so it fails offline.

Step 2: Get the freshness proof as compact JSON for archiving

online-info-switch freshness --json

Expected Output: {"utc_time":"...","local_time":"...","ip_address":"...","country":"...","country_flag":"...","headlines":[...],"bitcoin_block_height":123456,"crypto_prices":[...],"generated_at":"..."}

Step 3: Get the same proof, indented for reading

online-info-switch freshness --json-pretty

Expected Output: The freshness object, indented

Scenario 6: Cryptocurrency and Metals

Live prices for crypto and precious metals, plus Bitcoin balance lookups. Prices come from public APIs, so these commands need network access and can be rate limited.

Step 1: Check one cryptocurrency price

online-info-switch price btc

Expected Output: BTC: 64,210.50 USD

Note

Accepted symbols: btc, eth, xmr, azero, near, gold, silver, xau, xag and all.

Step 2: Check the Monero price

online-info-switch price xmr

Expected Output: XMR: 154.20 USD

Step 3: Check a precious metal spot price

online-info-switch price gold

Expected Output: XAU: 2,395.80 USD

Note

gold and silver are aliases for the xau and xag symbols; both spellings work.

Step 4: Fetch every supported crypto and metal in one call

online-info-switch price all

Expected Output: BTC, ETH, XMR, NEAR, AZERO, GOLD and SILVER prices

Note

Crypto and metals are fetched in parallel. A provider that fails is left out of the result rather than failing the command.

Step 5: Fetch every price as JSON, for a dashboard or a workflow step

online-info-switch price all --json

Expected Output: {"success":true,"prices":[{"symbol":"BTC","price_usd":64210.5}],"timestamp":"..."}

Step 6: Look up the balance of a legacy Bitcoin address

online-info-switch balance 34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo

Expected Output: The address balance in BTC

Note

The address is sent to public blockchain explorers, which see both it and your exit IP. Do not look up an address you want kept private over a clearnet route.

Step 7: Look up a Segwit (bc1) address balance as JSON

online-info-switch balance bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2 --json

Expected Output: {"address":"bc1...","balance_btc":0.0123,"success":true}

Scenario 7: Release Information

Query the official Kodachi release API for the current version of each edition.

Step 1: Show the release info for every edition

online-info-switch releases

Expected Output: Version, date and download info for binary_pack, terminal and desktop

Step 2: Show one edition only

online-info-switch releases binary_pack

Expected Output: Binary Pack version, release date and installation info

Note

Editions: binary_pack, terminal, desktop.

Step 3: Check the Desktop ISO release

online-info-switch releases desktop

Expected Output: Desktop ISO version and release date

Step 4: Get all release metadata as JSON, to compare against the installed version

online-info-switch releases --json-pretty

Expected Output: Indented JSON with one object per edition

Scenario 8: Cloud Infrastructure and Tor Exit

Check the Kodachi cloud backend, the knet connection and the Tor exit IP. These reach the Kodachi servers, so they need network access.

Step 1: Fetch Kodachi cloud infrastructure statistics

online-info-switch cloud-stats

Expected Output: User counts, challenge counts and infrastructure totals

Note

The stats endpoint can be slow, so the default timeout here is 60 seconds. Raise it with --timeout if it trips.

Step 2: Fetch the stats as JSON with a longer timeout

online-info-switch cloud-stats --timeout 120 --json-pretty

Expected Output: Indented JSON with the cloud statistics

Step 3: Check whether this machine is on the Kodachi network

online-info-switch knet-status

Expected Output: knet: On, or knet: Off

Note

Default timeout is 30 seconds, overridable with --timeout.

Step 4: Get the knet state as JSON, for the dashboard or a workflow condition

online-info-switch knet-status --json

Expected Output: {"success":true,"data":{"is_kodachi":true,"knet":"On"},"response_time_ms":42,"timestamp":"..."}

Step 5: Check the exit IP through the local Tor SOCKS5 proxy

online-info-switch vps-tor-check

Expected Output: Exit IP and the SOCKS5 proxy endpoint that was used; country is reported as unknown because the Tor check endpoint does not provide it

Note

With neither flag given, the SOCKS port is auto-detected: ports 9050, 9150 and the Kodachi multi-instance pool 10000 to 10019 are probed in parallel and the first listener wins. Requires a running Tor.

Step 6: Check the Tor exit through a specific remote SOCKS5 proxy

online-info-switch vps-tor-check --socks-host 192.168.1.100 --socks-port 9051

Expected Output: Tor exit IP as seen through that proxy

Note

Passing EITHER flag disables auto-detection: the supplied values are used verbatim, and the one you leave out falls back to 127.0.0.1 or 9050.

Step 7: Get the exit check as JSON for a workflow

online-info-switch vps-tor-check --json-pretty

Expected Output: {"success":true,"data":{"exit_ip":"...","country":"unknown","socks_host":"127.0.0.1","socks_port":9050},"response_time_ms":42,"timestamp":"..."}

Environment Variables

Variable	Description	Default	Values
`NO_COLOR`	Disable all colored output when set	unset	1\|true\|yes (any value disables color)

Exit Codes

Code	Description
0	Success
1	General error
2	Invalid arguments
3	Permission denied
4	Network error
5	File not found

online-info-switch

Online information hub for Kodachi OS - RSS feeds, paste services, freshness proofs, and connectivity status

File Information

SHA256 Checksum

Features

Security Features

System Requirements

Global Options

Commands

Connectivity

status

Kodachi Cloud

releases

cloud-stats

knet-status

vps-tor-check

Markets

price

balance

News and Freshness

rss

freshness

Sharing

paste

Operational Scenarios

Scenario 1: Quick Start

Step 1: Check whether the machine currently has working internet access

Step 2: Read the five most recent security headlines

Step 3: Prove the system clock and its view of the world are current

Step 4: Read one market price as JSON, for scripting

Scenario 2: Output Formats

Step 1: Compact single line JSON, meant for pipes and workflow steps

Step 2: Indented JSON, for reading by eye

Step 3: Colorized, human oriented rendering of the JSON

Step 4: Raise the global request timeout for a slow endpoint

Scenario 3: RSS Feed Operations

Step 1: Fetch the newest items from every configured source

Step 2: Fetch from one randomly chosen source instead of all of them

Step 3: Fetch only from the named sources

Step 4: Cap how many items come back

Step 5: Get the feed items as structured JSON

Scenario 4: Paste Service Operations

Step 1: Paste from stdin to the default HTTPS services

Step 2: Paste a literal string

Step 3: Paste the contents of a file

Step 4: Send to a single named service

Step 5: Send to several named services at once

Step 6: Send to termbin.com, which needs an explicit opt-in

Step 7: Get the per-service results as JSON

Scenario 5: Freshness Proof Operations

Step 1: Print a human readable freshness proof

Step 2: Get the freshness proof as compact JSON for archiving

Step 3: Get the same proof, indented for reading

Scenario 6: Cryptocurrency and Metals

Step 1: Check one cryptocurrency price

Step 2: Check the Monero price

Step 3: Check a precious metal spot price

Step 4: Fetch every supported crypto and metal in one call

Step 5: Fetch every price as JSON, for a dashboard or a workflow step

Step 6: Look up the balance of a legacy Bitcoin address

Step 7: Look up a Segwit (bc1) address balance as JSON

Scenario 7: Release Information

Step 1: Show the release info for every edition

Step 2: Show one edition only

Step 3: Check the Desktop ISO release

Step 4: Get all release metadata as JSON, to compare against the installed version

Scenario 8: Cloud Infrastructure and Tor Exit

Step 1: Fetch Kodachi cloud infrastructure statistics

Step 2: Fetch the stats as JSON with a longer timeout

Step 3: Check whether this machine is on the Kodachi network

Step 4: Get the knet state as JSON, for the dashboard or a workflow condition

Step 5: Check the exit IP through the local Tor SOCKS5 proxy

Step 6: Check the Tor exit through a specific remote SOCKS5 proxy

Step 7: Get the exit check as JSON for a workflow

Environment Variables

Exit Codes

`status`

`releases`

`cloud-stats`

`knet-status`

`vps-tor-check`

`price`

`balance`

`rss`

`freshness`

`paste`