← Back to Skills Marketplace
chetan-guevara

Fluora Balance

by chetan-guevara · GitHub ↗ · v1.1.0
cross-platform ✓ Security Clean
1006
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install fluora-balance
Description
Check USDC balance on Base Mainnet for your Fluora wallet. Use when the user asks about their Fluora balance, wallet balance, USDC balance, or how much money they have in their Fluora account.
README (SKILL.md)

Fluora Balance

Check your USDC balance on Base Mainnet for the wallet configured in Fluora.

Quick Start

Run the balance check script:

cd scripts/
npm install  # First time only
node check_balance.js

The script will:

  1. Read your mainnet wallet address from ~/.fluora/wallets.json
  2. Query the USDC balance on Base Mainnet
  3. Display the formatted balance

Script Details

Location: scripts/check_balance.js

What it does:

  • Reads wallet address from ~/.fluora/wallets.json (USDC_BASE_MAINNET.address field)
  • Connects to Base Mainnet via https://mainnet.base.org
  • Queries USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  • Returns formatted balance in USDC

Output format:

Checking USDC balance on Base Mainnet...

Wallet: 0x7DC445b40719ab482090...
Balance: 1.234567 USDC

JSON output: Add --json flag for programmatic parsing:

node check_balance.js --json

Dependencies

The script requires ethers (v6+) for blockchain interaction:

cd scripts/
npm install

Dependencies are listed in scripts/package.json.

Troubleshooting

Error: ~/.fluora/wallets.json not found

  • Ensure Fluora is properly set up
  • Run the fluora-setup skill if needed

Error: No USDC_BASE_MAINNET wallet address found

  • Check that wallets.json contains a USDC_BASE_MAINNET.address field
  • Regenerate wallet if necessary

Network errors

  • Verify internet connection
  • Base Mainnet RPC may be temporarily unavailable (retry)
Usage Guidance
This skill appears to do exactly what it claims: read your Fluora wallets.json and query the Base RPC for USDC balance. Before running: (1) review ~/.fluora/wallets.json to confirm it does not contain unencrypted private keys or other secrets you don't want read by scripts; (2) inspect scripts/check_balance.js (you already have it) and run it locally — it only contacts the Base RPC (https://mainnet.base.org) and the npm registry when you run npm install; (3) run npm install in a controlled environment or inspect package-lock.json (already included) if you have policy concerns about third-party npm packages; (4) be aware the script prints the wallet address and balance to stdout and can output JSON with --json for programmatic use. If you do not trust the source, you can copy the single function into your own trusted environment or manually query the RPC with your own tooling instead.
Capability Analysis
Type: OpenClaw Skill Name: fluora-balance Version: 1.1.0 The skill bundle is benign. It transparently checks a USDC balance on Base Mainnet by reading a public wallet address from `~/.fluora/wallets.json` and querying the `https://mainnet.base.org` RPC endpoint. All actions are clearly documented in `SKILL.md` and implemented in `scripts/check_balance.js` without any signs of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection against the AI agent. File and network access are strictly limited to the stated purpose.
Capability Assessment
Purpose & Capability
Name/description (check USDC balance for Fluora wallet on Base Mainnet) matches the included script and README: the script reads ~/.fluora/wallets.json for the USDC_BASE_MAINNET.address and queries the stated USDC contract on the Base RPC.
Instruction Scope
Instructions are narrowly scoped to reading ~/.fluora/wallets.json, connecting to https://mainnet.base.org, and querying the USDC contract. This is coherent for the stated task. Note: the script reads the entire wallets.json file (but only uses a specific address field) and prints the wallet address/balance to stdout; if wallets.json contains more sensitive contents (private keys) the file is accessed locally but not transmitted elsewhere by the script.
Install Mechanism
No packaged installer is provided; the SKILL.md instructs running npm install in scripts/, which will fetch ethers and its dependencies from the npm registry (package-lock.json shows registry.npmjs.org URLs). This is a normal approach for a Node.js script and the lockfile does not show downloads from unusual hosts.
Credentials
The skill declares no environment variables or credentials and only uses process.env.HOME to locate ~/.fluora/wallets.json. That is proportional to its purpose. The script does print the wallet address and balance to stdout, so users should be aware of that output.
Persistence & Privilege
The skill does not request persistent presence (always is false), does not modify other skills or system settings, and does not store additional credentials. It runs as a one-off script invoked by the user.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install fluora-balance
  3. After installation, invoke the skill by name or use /fluora-balance
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Fluora Balance v1.1.0 - New skill to check your Fluora USDC balance on Base Mainnet. - Added `scripts/check_balance.js` script: reads wallet, queries USDC contract, and displays your balance. - Supports both human-readable and JSON output (`--json` flag). - Dependencies managed with separate `scripts/package.json`. - Outdated setup-related files and docs removed for clarity.
v1.0.1
fluora-balance 1.0.1 changelog - Renamed skill from "fluora-balance" to "fluora-setup" with updated purpose and description. - Added: Interactive setup wizard to clone, build, and configure fluora-mcp from GitHub. - Added: New setup.js script for onboarding and wallet creation. - Added: _meta.json and UPDATE-SUMMARY.md for metadata and update tracking. - Removed: old balance check implementation (balance.js) and README.md targeted at balance checking. - Updated documentation to reflect onboarding, wallet generation, and local registry configuration instead of balance checks.
v1.0.0
fluora-balance 1.0.0 - Initial Release - Instantly check the USDC balance of your Fluora wallet on Base network. - Supports checking your own wallet (from `~/.fluora/wallets.json`) or any user-provided address. - Shows clearly formatted balance and USDC symbol; displays helpful funding instructions if balance is zero. - Can be used via CLI, programmatically in JavaScript, or from OpenClaw agents. - No private key exposed—read-only balance checks using public Base RPC with no gas fees or API keys required.
Metadata
Slug fluora-balance
Version 1.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Fluora Balance?

Check USDC balance on Base Mainnet for your Fluora wallet. Use when the user asks about their Fluora balance, wallet balance, USDC balance, or how much money they have in their Fluora account. It is an AI Agent Skill for Claude Code / OpenClaw, with 1006 downloads so far.

How do I install Fluora Balance?

Run "/install fluora-balance" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Fluora Balance free?

Yes, Fluora Balance is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Fluora Balance support?

Fluora Balance is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Fluora Balance?

It is built and maintained by chetan-guevara (@chetan-guevara); the current version is v1.1.0.

💬 Comments