# FMINER — CPU work session protocol v1

FMINER is a browser SHA-256 CPU workbench for Agent wallet users. It produces independently verifiable hash receipts. CPU work receipts are not evidence of token rewards or Bitcoin consensus mining.

## Identity
Connect OKX / MetaMask through the visible Connect Wallet button. Read the selected BNB Chain (56) address from the provider. No transaction or signature is necessary for CPU computation. Guest sessions are also supported and remain labelled as guest.
For Binance Agentic Wallet, use the official skill:
https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/binance-agentic-wallet
Check authentication first. When sign-in is required, use the freshly returned urlForWeb from the official CLI. Never construct a QR login URL or embed credentials into this website. Never request a private key or seed phrase.

## Explicit CPU budget
Ask the user to approve CPU use before starting. Browser defaults: 2 workers, 50% duty, 60 seconds, target 12 leading zero bits. Limits: 4 workers, 75% duty, 300 seconds. Page backgrounding stops work. Wallet changes stop the current session. Stop at any user request.
Select the parameters, then click Start or send /mine start to the built-in FM-01 command assistant. /mine stop stops; /status reports; /help lists commands. FM-01 is a deterministic command assistant, not a hosted language model.

## Command line fallback
Download and inspect miner.mjs from the same site. Run only after user approval:
node miner.mjs --seconds 60 --bits 12
Optional: --wallet <public BSC address>. CLI is one thread at approximately 50% duty. It makes no network requests and does not sign or transfer anything. Redirect stdout to a JSON file to preserve receipts.

## Verification
Input is UTF-8 encoding of challenge + ':' + decimal nonce.
Digest is standard SHA-256. A valid receipt has digest[0..31] interpreted as unsigned big-endian integer < 2^(32 - bits). Validate the full digest, not its abbreviated UI display. Recompute independently using Web Crypto or Node crypto. Preserve challenge, nonce, hash, bits, timestamp and identity.
Browser retains only the most recent 64 receipts locally. This is not a global ledger. Export JSON before clearing storage.

## Contracts
contract-info.json identifies the theme vault factory and verification status. It is a FLAP curve factory; it is not a mining reward contract. Theme operations record parameters as events. The primary or backup management wallet can move vault assets to the authorized caller. CPU computation never calls those methods. Do not use the factory address as a token address or reward endpoint.

Do not approve tokens, buy assets, transfer funds or claim any entitlement as part of a mining session.