Add fart2fartcoin: detect a fart, buy Fartcoin

[rdyplayerB]

Fart2Fart(coin)

Every confirmed fart in the room buys Fartcoin. No wake word, no confirmation, no regrets.

"Warning. Room-clearing event detected. Magnitude six point two. Duration one point four seconds. Open a window and be on smell lookout."
"Bought one dollar of Fartcoin, about five point nine seven seven Fartcoin."

Sells a whole number of dollars of USDC on Base through the user's Bankr wallet and lands Fartcoin on Solana in one cross-chain swap. Spend limits are Bankr's (bankr.bot → Security); the ability only guards against buying the same fart twice. A fresh install is in dry run until the user says "turn fart trading on".

Trigger words: fart finder, fart detector, flatulence, fart trading, fart buy, fartcoin

Built on

• Add fart-finder: always-on flatulence detector for the DevKit #378 Fart Finder — the detector and cloud daemon, unchanged
• Add openhome-bankr: trade any Base token by voice #377 openhome-bankr — the Bankr quote-then-swap path and speech mapping, minus its voice confirmation and app-side caps

Layout

• main.py — voice skill: set dollars per fart, trading on/off, report, holdings, balance, plus Fart Finder's status/arm/disarm/sensitivity
• background.py — cloud daemon: poll, announce, buy hook, arrival check, daily line
• trade.py — pure Bankr functions and the source of truth; inlined into the two cloud files because the sandbox caches sibling modules across pushes
• devkit_functions.py, listener/, pi/ — device side, from Fart Finder

Testing

• Verified live on 2026-09-16 with a Mac standing in for the DevKit: a fart clip played through the speakers was detected, and nine seconds later Bankr filled a $1 buy (Base tx 0xf50b8ef8…d93a, 5.977 Fartcoin confirmed on Solana).
• 123 unit tests, no network. Passes validate_ability.py and the upload scan.
• Not yet run on DevKit hardware.

Notes for review

• Bankr requires a UUID idempotencyKey; it is derived deterministically from the fart event id.
• The Fartcoin position is small enough that the Bankr web wallet hides it by default; the API reports it with showLowValueTokens.

🤖 Generated with Claude Code

[github-actions]

🔀 Branch Merge Check

PR direction: ability/fart2fartcoin → dev

✅ Passed — ability/fart2fartcoin → dev is a valid merge direction

[github-actions]

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/fart2fartcoin
  ✅ All checks passed!

[github-actions]

🔍 Lint Results

🔧 Formatting fixes available

This PR is from a fork, so fixes could not be pushed automatically. Download the python-lint-results artifact from the workflow run for the patch file, then run:

git apply autofix.patch

❌ __init__.py Must Be Empty

The following __init__.py files must be completely empty:

community/fart2fartcoin/listener/__init__.py

Files linted: community/fart2fartcoin/background.py community/fart2fartcoin/devkit_functions.py community/fart2fartcoin/listener/classify.py community/fart2fartcoin/listener/copy.py community/fart2fartcoin/listener/gate.py community/fart2fartcoin/listener/magnitude.py community/fart2fartcoin/listener/pipeline.py community/fart2fartcoin/main.py community/fart2fartcoin/trade.py

✅ Flake8 — Passed

Fix the remaining issues and push again. The lint will re-run automatically.

[uzair401]

Closing.