Quick Start

​

Prerequisites

• Node.js 18+
• A Solana devnet keypair file or an EVM private key

pnpm add @faremeter/rides @faremeter/logs dotenv tsx
pnpm pkg set type=module

# Solana keypair file path
PAYER_KEYPAIR_PATH=$HOME/.config/solana/id.json

import "dotenv/config"
import { payer } from "@faremeter/rides"
import { getLogger } from "@faremeter/logs"

const logger = await getLogger(["quickstart"])

await payer.addLocalWallet(process.env.PAYER_KEYPAIR_PATH)

const response = await payer.fetch("https://helius.api.corbits.dev")

logger.info(`status: ${response.status}`)
logger.info(JSON.stringify(await response.json()))

pnpm tsx main.ts

​

What happened

1. payer.fetch made an HTTP request to the endpoint.
2. The server responded with 402 Payment Required and a set of payment requirements.
3. Rides found a compatible wallet, signed the payment locally, and retried the request with a payment header (X-PAYMENT for v1, PAYMENT-SIGNATURE for v2).
4. The server verified the payment through a facilitator and returned the resource.

​

Other wallet types

​

Next steps

• How x402 works — Understand the protocol behind the payment flow.
• Rides SDK — Full API reference for @faremeter/rides.
• Fetch Wrapper — Lower-level control with @faremeter/fetch.
• Middleware — Accept payments on your own server.