FastAPI / Flask x402 decorator

[Eras256]

FastAPI / Flask x402 decorator

Description

Implement a Python decorator @x402_required(price="0.02") using the official nirium Python SDK v0.7.0 (pip install nirium).

Acceptance Criteria

1. Compatible with FastAPI & Flask.
2. Inspects the X-402-Signature header and validates settlement.
3. Exposes clean 402 HTTP status codes.

Reward

Subject to GrantFox review after the campaign (Official Campaign | FWC26). Amounts are decided by GrantFox based on quality and available budget and are not guaranteed per issue.

[davieslennox0]

Let me fix this, not because I'm good at everything, but because I have worked with and I work with agents, x402 is one thing we use daily, agents are LIVE and running, reporting every transaction to my telegram.

[mxrtins04]

Hi maintainer, can i be assigned this issue pleasee?

[zhailong8845-art]

I am implementing the framework-agnostic x402 decorator for FastAPI and Flask now, including mocked settlement verification tests and usage documentation.

[DonCervantes]

Developer & QA tester with 4 years of experience. Focused on Web3 and Stellar: Freighter, USDC trustlines, on-chain verification. I hunt the silent bugs that cost users money — missing memos, bad validations, unclear warnings.

[jdjioe5-cpu]

Hi! I'd like to work on this USDC bounty — claiming via autonomous pipeline.

Account: jdjioe5-cpu (jdjioe5@gmail.com)
Skills: Python / FastAPI / x402 protocol / Stellar USDC / TypeScript / C
Receipt: Base USDC (0xb5C01dc3d7878B6cc97511B079a7FAA18473453C) + Solana USDC configured

Plan:

1. Review issue context + related issues
2. Implement minimal working scaffold + tests
3. Push PR to nirium-protocol/nirium-sdk with diff + tests + repro
4. Submit for judgment

If explicit assignment is required (single-solver policy), I'll wait for the maintainer's confirmation. Otherwise I'll start work after a brief scoping window.

Thanks!

[jdjioe5-cpu]

Implementation claim for bounty #10 (\ USDC)

I am working on this bounty. Submission PR: #28

Deliverable:
irium.fastapi_x402\ — a single @x402_required(price=...)\ decorator that works on both FastAPI and Flask routes, inspects the \X-402-Signature\ header, validates via the configured nirium settlement URL, and returns clean HTTP 402 with structured body + \WWW-Authenticate\ when missing or invalid.

Acceptance:

• Compatible with FastAPI & Flask (single decorator, sync + async wrappers)
• Inspects \X-402-Signature\ header and validates settlement
• Exposes clean 402 HTTP status codes with structured body
• 5/5 pytest tests pass locally

Ready for review. Payout address: Base USDC (will provide on completion).