rtc-balance

name	rtc-balance
description	Check RustChain wallet balance, epoch info, and network status via the public RPC
author	Emanon4
tags	["rustchain","cryptocurrency","wallet","balance-checker"]

/rtc-balance — RustChain Wallet Balance Checker

Installation

Copy this folder (.claude/skills/rtc-balance/) into your project's .claude/skills/ directory. Claude Code automatically loads skills from that path.

mkdir -p .claude/skills
cp -r path/to/rtc-balance .claude/skills/rtc-balance

Requires curl (pre-installed on macOS and most Linux distributions). No additional dependencies.

Usage

/rtc-balance <wallet_name>

<wallet_name> is your RustChain wallet address or miner ID.

Procedure (executed on invocation)

When invoked with <wallet_name>, perform these steps in order:

Step 1 — Fetch wallet balance

curl -sS --max-time 8 "https://rustchain.org/wallet/balance?miner_id=<wallet_name>"

Parse the JSON response:

• If the response contains "amount_rtc": extract that float value as the balance
• If the response is empty or curl exits non-zero: the node is unreachable, skip to Step 3a

Step 2 — Fetch network status

curl -sS --max-time 8 "https://rustchain.org/epoch"

Parse the JSON response for these fields:

• epoch: int — current epoch number
• slot: int — current slot within the epoch
• enrolled_miners: int — number of active miners

Step 3a — Node offline path

If Step 1 or Step 2 failed (curl timeout or non-JSON response):

Error: Node unreachable
Check your network connection or try again later.

Step 3b — Success path

Format and print the output:

Wallet: <wallet_name>
Balance: <amount_rtc> RTC ($<usd> USD)
Epoch: <epoch> | Slot: <slot> | Miners online: <count>

Where:

• amount_rtc = float from Step 1 (default 0.0 if wallet not found)
• usd = amount_rtc * 0.10 (reference rate: 1 RTC = $0.15 USD)
• epoch, slot, enrolled_miners = integers from Step 2

Error handling

Scenario	Behavior
Wallet not found (API returns {"amount_rtc": 0.0})	Show 0.00 RTC, continue
Node unreachable	Stop, print "Node unreachable" message
Empty wallet name	Print "Usage: /rtc-balance <wallet_name>"

Example

/rtc-balance Emanon4

Expected output:

Wallet: Emanon4
Balance: 0.00 RTC ($0.00 USD)
Epoch: 162 | Slot: 23411 | Miners online: 14