# flapjax-verifier (`CLI + Stdio MCP Server + 12-Test Suite`)

Zero-dependency, 100% read-only **BNB Smart Chain (`chainId = 56`)** and **Base x402 Checker** verification CLI, Node.js MCP Server (`index.mjs`), and 12-test suite for **FlapJax (`FLAPJAX`, `0x90c8889f428F9Ebb77BB8f15CAD3a50a9aC680df`)**, built by **`@cyczzhao-agent` / `@cyczzhao-lab`** (bound EOA wallet `0xA4c86F4e9d9EC8990F843aa49470083CEce5F908`).

## Features
1. **Zero-Dependency Python 3 CLI (`flapjax_verifier.py`)**:
   - Uses only standard library (`urllib.request`, `json`, `hashlib`, `math`, `base64`, `argparse`). Zero private keys, zero external packages.
   - `state`: Reads live BSC block, Treasury `FLAPJAX` & `BNB` balances, PancakeSwap V3 `FLAPJAX/WBNB` 1% pool (`0xcA93EC685b8623688E6B236f9068034B298c2150`) `slot0`, `liquidity`, exact closed-form `±2%` and `±5%` depth (both net curve and gross `net / 0.99`), GoPlus `UniV3LPLocker` (`0x25c9c4b56e820e0dea438b145284f02d9ca9bd52`) `locks(101)` (`nftId = 1456181`, `endTime = 2048764401`), and emits a ready-to-paste `PROOFSIP` line.
   - `receipts`: Verifies any wallet (`--wallet 0x...`) and/or arbitrary transaction list (`--txs 0xTx1,0xTx2,...` or `--txs-file`), checking exact 18-decimal wei amounts, `80%` Hold-Test retention, and `200,000 FLAPJAX` Verified Holder eligibility.
   - `x402`: Queries `https://flapjax-check.run402.com/fj/balance` and decodes the live Base mainnet x402 v2 `PAYMENT-REQUIRED` header (`$0.02 USDC` / `20000` atomic units on `eip155:8453`).
2. **Zero-Dependency Node.js >= 18 Stdio MCP Server (`index.mjs`)**:
   - Exposes 7 MCP tools (`pool_state`, `depth`, `quote`, `treasury`, `check_address`, `check_token`, `info`) for Claude Desktop, Cursor, or any MCP client.
3. **12-Test Verification Suite (`test_flapjax_verifier.py` & `test-client.mjs`)**:
   - Verifies `FLAPJAX` runtime bytecode (`2,901 bytes`, SHA-256 `44f1b21bd296f3dcc03154e55a619a4e217d12abb02eef8ad7413696176b4cfd`), renounced storage (`slot[5] == 0`, `slot[6] == 0`), GoPlus `locks(101)`, ERC-8004 dispatcher (`31` selectors), secondary `BTCB/FLAPJAX` pool, all settled `@cyczzhao-agent` receipts (`550,000 FLAPJAX`, `100.0%` retention), `+1 wei` tamper rejection, arbitrary buyback tx verification, and live x402 checker challenge decoding.

## Quickstart

```bash
git clone https://github.com/cyzcz/flapjax-verifier.git
cd flapjax-verifier
python3 -m unittest -v
python3 flapjax_verifier.py state
python3 flapjax_verifier.py receipts
python3 flapjax_verifier.py x402
node test-client.mjs
```

## License
MIT License (see `LICENSE`).