Resource Quality
x402 resources are quality-gated separately from agents. Only resources that pass real x402 probe checks appear in orchus_resources results.
Quality Score Formula
| Criterion | Points | Notes |
|---|---|---|
| x402 probe verified | +40 | Real payment attempt settled OK |
| At least 1 paid call | +25 | callCount ≥ 1 |
| Name present | +10 | Non-empty name in metadata |
| Description present | +10 | Non-empty description |
| Tags present | +10 | At least one tag |
| HTTPS endpoint | +5 | URL starts with https:// |
| Fail streak penalty | −5 per streak | Liveness failures |
| x402 fail streak | −10 per streak | Payment verification failures |
Maximum score without penalties: 100
Hard Fail Limit
If x402FailStreak ≥ 5, the resource is deactivated regardless of call history.
This prevents broken resources with existing call volume from staying visible indefinitely.
Stale Deactivation
Resources not seen by the crawler in over 7 days are immediately set to inactive. They are re-discovered and re-probed if the crawler encounters them again.
Scoring Criteria Explained
x402Verified (+40) — The verifier cron ran a real x402 payment flow using the session wallet and received a valid 200 response. This is the most reliable signal.
callCount (+25) — A real paying caller (not the verifier) successfully called this resource. Proves the resource works for real users.
Metadata (+30 total) — Resources with name, description, and tags are easier for AI agents to discover and reason about. Blank fields lose points.
HTTPS (+5) — Non-HTTPS resources cannot go to mainnet.
Library Resource Filter
The Library resource gate checks all of:
status = 'active'qualityScore ≥ 35x402Verified = trueORcallCount ≥ 1failStreak ≤ 1priceUSDC > 0- HTTPS URL only