skale-sfuel-skill

When to use

Use when the user asks to mine or top up sFUEL for an address on a SKALE chain.

Inputs

• chain: one of [europa, ...]
• address: EVM address (0x + 40 hex chars)

Preconditions

• Python 3.11+ installed
• Dependencies installed: pip install -r requirements.txt
• RPC env vars set (example):
  • SKALE_RPC_EUROPA
• If required, credentials/signing method configured (see Security section)

Procedure

1. Validate address format.
2. Normalize chain name and ensure it is supported.
3. Run:

python3 scripts/mine_sfuel.py --chain <chain> --address <address>

4. Parse stdout as JSON.
5. If success: summarize tx hash / amount / final balance if provided.
6. If error: show error, suggest fixes (missing env var, RPC failure, rate limits).

Output format

The script returns JSON:

• ok: boolean
• chain: string
• address: string
• tx_hash: string (if sent)
• amount: string (optional)
• message: string
• error: string (only if ok=false)

Security

• Never print private keys.
• Prefer using a wallet/signing flow rather than embedding keys in repo.
• If private key env var is used, warn user and recommend dedicated low-value key.

pip install -r requirements.txt --prerelease=allow uv pip install -r requirements.txt --prerelease=allow