Environments

Clutch Protocol can run locally via Docker or on the public stage deployment.

Local development

Start the full stack with clutch-deploy:

git clone https://github.com/clutchprotocol/clutch-deploy.git
cd clutch-deploy
cp .env.example .env
docker compose up -d

SDK connection:

const sdk = new ClutchHubSdk('http://localhost:3000', publicKey);

Demo app (standalone clone):

git clone https://github.com/clutchprotocol/clutch-hub-demo-app.git
cd clutch-hub-demo-app
npm install
VITE_API_URL=http://localhost:3000 npm run dev

The stage deployment uses Cloudflare and nginx in front of the stack:

Service	URL
Demo app	https://app-stage.clutchprotocol.io
Hub API	https://api-stage.clutchprotocol.io
Node 1	wss://node1-stage.clutchprotocol.io/ws
Node 2	wss://node2-stage.clutchprotocol.io/ws
Node 3	wss://node3-stage.clutchprotocol.io/ws

SDK connection:

const sdk = new ClutchHubSdk('https://api-stage.clutchprotocol.io', publicKey);

The demo app auto-detects stage URLs: when served from app-stage.clutchprotocol.io, it uses api-stage.clutchprotocol.io automatically.

Service	URL
Marketing site	https://clutchprotocol.io
Documentation	https://docs.clutchprotocol.io
Demo app	https://demo.clutchprotocol.io

Alpha

Stage and demo environments are for testing. APIs and endpoints may change.

Loaded from config/{env}.toml with APP_ prefix overrides. Key settings:

Variable	Description
`VITE_API_URL`	Hub API base URL
`VITE_PUBLIC_NODE_ENDPOINTS`	Comma-separated node WS URLs for network info tab

Variable	Description
`VITE_EXPLORER_API_URL`	Explorer backend URL (default `http://localhost:8088`)

On test networks, fund wallets before creating ride requests:

await sdk.requestFaucet(publicKey);

Requires faucet_enabled = true and a funded faucet account on the server. See Faucet.