Skip to content

Conversation

@0xvsr
Copy link
Contributor

@0xvsr 0xvsr commented Oct 28, 2025

Description

This PR adds Onchain to the x402 ecosystem page under the Services/Endpoints category.

Project Overview

Onchain is an x402 payment aggregator that provides intelligent routing across multiple facilitators with automatic failover and redundancy.

What is Onchain?

  • Multi-Facilitator Routing: Single API integration that routes to multiple x402 facilitators (Coinbase CDP, x402.rs)
  • Intelligent Selection: Optimize routing by speed, cost, or reliability based on your priority
  • Automatic Failover: If one facilitator is down, payments automatically route to healthy alternatives
  • Production-Ready: Built-in error handling, retry logic, and health monitoring from day one

Current Status:

  • Live on Base mainnet
  • Progressive network expansion planned (Ethereum, Polygon, Solana)
  • Zero facilitator fees for USDC on Base

Why Onchain Matters to x402 Ecosystem

Reduces Integration Complexity: Developers integrate once with Onchain instead of managing multiple facilitator integrations (3 lines of code vs 50+)

Increases Reliability: Multi-facilitator redundancy means payments succeed even if individual facilitators experience downtime

Demonstrates Protocol Strength: Shows how x402's open standard enables innovation on top of the protocol layer

Lowers Risk: Eliminates vendor lock-in - no dependency on a single facilitator's uptime or pricing

Technical Stack

  • Payment Protocol: x402 (routes to multiple facilitators)
  • Blockchain: Base (launching network, expanding to others)
  • API: REST endpoints for verify/settle operations
  • Client SDK: Node.js/Express middleware + standalone client
  • Languages Supported: Any (REST API) or Node.js (SDK)

Submission Checklist

  • Logo added to /public/logos/onchain.png
  • Metadata created in /app/ecosystem/partners-data/onchain/metadata.json
  • Category: Services/Endpoints
  • Website live and accessible: https://onchain.fi
  • API documentation complete: https://onchain.fi/docs
  • Working mainnet integration verified

Links

We're excited to contribute to the x402 ecosystem and help developers build more resilient payment integrations!

Tests

This PR only adds static metadata and assets for the ecosystem page. No code changes were made to the core functionality.

Manual Verification:

  • ✅ Verified metadata.json follows the required schema for Services/Endpoints
  • ✅ Confirmed logo file is properly formatted (PNG, 512x512)
  • ✅ Tested that all URLs are live and accessible
  • ✅ Verified category requirements are met (mainnet integration, API docs, uptime focus)
  • ✅ Validated JSON syntax

Requirements Met (Services/Endpoints):

  • ✅ Working mainnet integration on Base
  • ✅ Comprehensive API documentation at onchain.fi/docs
  • ✅ Built for 99% uptime with automatic failover architecture
  • ✅ Production-ready with live API at api.onchain.fi

Checklist

  • I have formatted and linted my code
  • All new and existing tests pass
  • My commits are signed (required for merge)

@cb-heimdall
Copy link

cb-heimdall commented Oct 28, 2025

✅ Heimdall Review Status

Requirement Status More Info
Reviews 1/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@vercel
Copy link

vercel bot commented Oct 28, 2025

@0xvsr is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

Copy link
Contributor

@Must-be-Ash Must-be-Ash left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi there,
Just a couple of thing:

  1. You have links pointing to the repo but it's not public (eg. on the bottom of the email "Example Code.
  2. Wrong URL in the bottom of the email for API Reference. I have seen them available on the docs so just a heads up.
    thanks!

@cb-heimdall
Copy link

Review Error for Must-be-Ash @ 2025-10-29 20:43:14 UTC
User failed mfa authentication, either user does not exist or public email is not set on your github profile. \ see go/mfa-help

@CarsonRoscoe CarsonRoscoe merged commit b5fcb22 into coinbase:main Oct 29, 2025
12 of 13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants