Skip to content

example

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

example

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
.npmrc
.npmrc
 
 
README.md
README.md
 
 
package.json
package.json
 
 
server.ts
server.ts
 
 

README.md

Example Server

A demo server with both MPP and x402 gated endpoints, powered by Surfpool.

Prerequisites

  • Node.js 20+

Setup

pnpm install
pnpm dev      # watch mode — restarts on file changes
pnpm start    # single run

By default the server connects to the public Surfpool sandbox at 402.surfnet.dev:8899. No local setup needed.

Using a local Surfpool instead

If you prefer to run a local Surfpool instance:

# Install and start Surfpool
curl -sL https://run.surfpool.run/ | bash
surfpool start

# Point the server at localhost
RPC_URL=http://localhost:8899 pnpm dev

Then use --local with pay:

pay --local curl http://localhost:3402/mpp/quote/SOL

Endpoints

MPP (www-authenticate header)

pay --sandbox curl http://localhost:3402/mpp/quote/AAPL
pay --sandbox curl http://localhost:3402/mpp/weather/paris

x402 (X-PAYMENT-REQUIRED header)

pay --sandbox curl http://localhost:3402/x402/joke
pay --sandbox curl http://localhost:3402/x402/fact

Free

curl http://localhost:3402/health

Environment Variables

Variable Default Description
RPC_URL https://402.surfnet.dev:8899 Surfpool RPC endpoint
PORT 3402 Server port
NETWORK localnet Solana network
SECRET_KEY test-secret-key-for-dev MPP secret key
FEE_PAYER_KEY (generated) Base58 keypair for fee payer
RECIPIENT (fee payer) Payment recipient address

How it works

  • MPP endpoints use @solana/mpp with the www-authenticate / Authorization header flow
  • x402 endpoints use x402-express with the X-PAYMENT-REQUIRED / X-PAYMENT header flow
  • An embedded local facilitator runs on port 3403 to handle x402 verify/settle without needing an external service
  • Both are configured to accept USDC payments with server-sponsored fees
  • On startup, the server bootstraps the fee payer with 100 SOL + 1000 USDC via surfnet cheatcodes