fluora-balance

What This Skill Does

The fluora-balance skill is a specialized utility designed to retrieve the USDC token balance for your configured Fluora wallet directly on the Base Mainnet blockchain. By leveraging the ethers.js library, this skill interacts with the Base RPC nodes to fetch real-time data from the official USDC contract address (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). It is intended to provide users with an accurate, instantaneous look at their liquid assets managed within the Fluora ecosystem. The skill operates by referencing your local configuration file located at ~/.fluora/wallets.json, ensuring that it always checks the specific wallet address associated with your unique account. Whether you need a simple human-readable output or a structured JSON response for programmatic integration, this tool provides both.

Installation

To install this skill, you can use the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/chetan-guevara/fluora-balance

Once the repository is synced, navigate to the scripts/ directory within your skill folder and run npm install to ensure all necessary dependencies, specifically ethers v6, are correctly installed on your system. No further configuration is required if you have already completed the initial Fluora system setup.

Use Cases

This skill is ideal for users who manage multiple digital assets and want a fast way to verify their USDC holdings on Base without navigating to a block explorer. It is perfect for developers building automation scripts that require balance awareness, traders verifying deposit confirmations, or anyone needing to check their account status before initiating a transaction. It abstracts away the complexity of RPC calls, ABI encoding, and smart contract interaction, presenting only the final, formatted balance.

Example Prompts

1. "What is my current USDC balance in my Fluora wallet?"
2. "How much money do I have in my Fluora account right now?"
3. "Check my Base Mainnet wallet balance for me."

Tips & Limitations

• If you receive a file not found error, ensure your environment variables and the ~/.fluora/ directory path are correctly set.
• If the balance returns as zero unexpectedly, verify that your wallets.json file contains the correct address for the USDC_BASE_MAINNET key.
• For developers: always use the --json flag when calling the script from other automation flows to prevent parsing issues with the human-readable output.
• This skill relies on external RPC nodes; if Base Mainnet is experiencing high traffic, you may occasionally see a connection timeout. Simply wait a few moments and retry.