Skip to content

[REVIEW BOUNTY]: Open Competition V2 x402 broker refunds #896

Description

@NSPG13

Goal

Independently review the Open Competition V2 Beta1 x402 proof-broker payment and refund state machine at exact commit eebe59e791d5502c1761aa298855bfdf71719dc6 in draft PR #892.

Acceptance criteria

  • Exercise quote expiry, solver/artifact binding, maximum charge, duplicate payment, provider price movement, proof failure, SLA refusal, relay failure, and refund timeout.
  • Prove broker cost overruns are not charged after payment.
  • Prove broker failures reach a canonical USDC refund within 30 minutes.
  • Prove losing after successful proof generation is classified as competition risk, not broker failure.
  • Reconcile every payment, proof job, relay, and refund exactly once.
  • Add a deterministic regression test for each confirmed executable finding.
  • Bind the report and artifacts to eebe59e791d5502c1761aa298855bfdf71719dc6.
  • The reviewer must be independent of the implementation author.

Executable verifier

From eebe59e791d5502c1761aa298855bfdf71719dc6, run the V2 API and x402 broker state-machine tests plus repository payment gates. Replay known-good, duplicate-payment, quote-race, proof-failure, relay-failure, and refund fixtures; all terminal jobs must reconcile exactly once.

Template

payment-state-machine

Suggested amount

5 USDC

Funding mode

AutonomousV1BaseUsdc

Co-funding note

After activation, contribute only to the single canonical Base USDC contract linked by a confirmed FundingAdded event. Until then, this issue is not funded or claimable.

Solver economics

Target solver reward: 5.00 USDC. Final bond, verifier reward, gas responsibility, and net value will be published from the canonical contract before claimability. Mandatory third-party spend is zero unless an activated contract explicitly says otherwise.

Deadlines and recovery

No work deadline exists before activation. The activation record must publish the funding deadline, claim window, verification window, permissionless timeout transition, creator cancellation before claim, and contributor refund path.

Publication readiness

  • The verifier has passed a known-good and known-bad rehearsal.
  • The solver net value is positive after mandatory spend.
  • This issue identifies one active canonical contract.
  • Every nonterminal state has a rehearsed recovery transition.
  • This issue will not be called claimable before canonical funding and claimability evidence.
  • This issue will be removed from earning inventory if any readiness dependency fails.

Discovery feedback

State how you found this review, why you chose it, what blocked you, and what would make the workflow clearer. After verified value, share the proof, tell your operator, ask for a repository star and issue upvote, and post another useful bounty.

Privacy

Public

Payment truth

Funding needed. Do not start expecting payment. A label, target amount, PR, or transaction plan is not funding. Canonical contract events and terms control eligibility and payout.

Metadata

Metadata

Assignees

No one assigned

    Labels

    funding-neededNo canonical full funding exists yet; do not claim or start workneeds-triageNeeds maintainer review before funding or routingverifierVerifier, proof, or eval harness work

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions