Skip to content

Add Utilia Solana Preflight - #203

Open
mohamedkuch wants to merge 9 commits into
solana-foundation:mainfrom
mohamedkuch:agent/add-utilia-solana-preflight
Open

Add Utilia Solana Preflight#203
mohamedkuch wants to merge 9 commits into
solana-foundation:mainfrom
mohamedkuch:agent/add-utilia-solana-preflight

Conversation

@mohamedkuch

Copy link
Copy Markdown

What changed

  • Added utilia/solana-preflight as a native Solana x402 provider.
  • Committed a deterministic Solana-only OpenAPI 3.1 snapshot with five paid routes and one health route.
  • Added task-oriented routing language and spend-aware polling guidance.

Why

Utilia provides live priority-fee quantiles, unsigned transaction simulation, confirmed-failure diagnosis, token mint-risk evidence, and PDF-to-Markdown conversion. Listing it in pay-skills lets wallet-funded agents discover and call these APIs through pay skills search and the pay MCP catalog.

Agent impact

Agents can select the $0.002 fee feed immediately before building a transaction, use the higher-priced tools only when needed, and understand a bounded five-observations-per-hour spend pattern.

Validation

  • npx -y @solana/pay catalog check providers/utilia/solana-preflight/PAY.md -v
    • 5/5 paid routes return valid Solana-mainnet x402 USDC challenges
    • free /healthz route classified correctly
  • npx -y @solana/pay catalog check . --no-probe
    • registry check passed; existing repository warnings remain unrelated
  • git diff --check

@mohamedkuch
mohamedkuch marked this pull request as ready for review July 24, 2026 08:25
@greptile-apps

greptile-apps Bot commented Jul 24, 2026

Copy link
Copy Markdown

Greptile Summary

Adds Utilia as a native Solana preflight provider.

  • Defines routing and spend-aware guidance for transaction simulation, fee estimation, failure diagnosis, token-risk analysis, and PDF conversion.
  • Adds a committed OpenAPI 3.1 specification covering five paid x402 routes and one free health route.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failures remain.

Important Files Changed

Filename Overview
providers/utilia/solana-preflight/PAY.md Adds valid provider metadata and usage guidance, with the previously conflicting PDF price and routing prefix corrected.
providers/utilia/solana-preflight/openapi.json Adds the six-route API snapshot with consistent pricing and payment metadata.

Reviews (9): Last reviewed commit: "Update Utilia client version" | Re-trigger Greptile

Comment thread providers/utilia/solana-preflight/PAY.md
Comment thread providers/utilia/solana-preflight/PAY.md Outdated
@mohamedkuch

Copy link
Copy Markdown
Author

Addressed the automated review in 87b7a81: the PDF conversion price now matches the live/OpenAPI value ($0.0025), and use_case now uses the catalog-standard Use for ... routing prefix. Re-ran the live catalog verifier: all 5/5 paid routes passed Solana x402 compatibility.

@mohamedkuch

Copy link
Copy Markdown
Author

@lgalabru — the automated review is now clean (5/5), the live catalog verifier passes all 5 paid routes, and both review threads are resolved. Would appreciate a maintainer review when convenient. Thank you.

@greptile-apps

greptile-apps Bot commented Jul 25, 2026

Copy link
Copy Markdown

Want your agent to iterate on Greptile's feedback? Try greploops.

@mohamedkuch

Copy link
Copy Markdown
Author

A new independent integration proof is available: OOBE Synapse merged its native Utilia plugin after completing a funded $0.002 USDC call through the full quote, authorization, signing, retry, and settlement path. The test evidence and transaction are recorded here: OOBE-PROTOCOL/synapse-client-sdk#50 (comment)

This PR remains mergeable, the Greptile review is 5/5, and the catalog validator passes all five paid routes. @lgalabru, could you review or identify any remaining blocker?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant