ProxyHubb Docs

Getting started

Environments, authentication, and the buyer vs provider mental model.

ProxyHubb has two sides: buyers consume residential bandwidth through the edge gateway; providers run a node and earn from metered usage. Settlement is Solana-backed on public testnet (devnet).

Environments (testnet)

RoleValue
Webhttps://proxyhubb.com
Control APIhttps://api.proxyhubb.com
Buyer CONNECT / SOCKS5proxy.proxyhubb.com:8090
Provider tunnelproxy.proxyhubb.com:3128
Docshttps://docs.proxyhubb.com
SolanaDevnet

Override the buyer endpoint locally with PROXYHUBB_PROXY_ENDPOINT or NEXT_PUBLIC_PROXY_ENDPOINT.

Authentication

CredentialHeaderUsed for
Dashboard JWTAuthorization: Bearer <jwt>Session intents, marketplace orders, most UI APIs
API key phub_… / pk_…X-API-Key (or Bearer)Bulk pools, partner B2B purchase (orders:create)

Mint API keys in the dashboard (Settings → API keys) or via POST /v1/bulk/api-keys with a JWT.

Wallet login (challenge → signed login → refresh) is the public auth path. Email/password registration is not an active runtime flow.

Two buyer paths

  1. Connect session intent — dashboard JWT → POST /v1/sessions/intent → use session-intent:<token> at the buyer proxy. Best for rotating/sticky quick-start in Connect.
  2. Marketplace order — create order → fund Solana escrow → GET /v1/orders/:id/credentials → username/password at the same buyer host.

Bulk pools are a third path for partners who want many endpoints under one API key.

First request checklist

  1. Open Connect or mint a JWT via wallet auth.
  2. Create a rotating intent (UI or SDK).
  3. Smoke-test: curl -x "http://session-intent:[email protected]:8090" https://httpbin.org/ip
  4. For longer-lived access, place a marketplace order and fetch credentials.

Common errors

SymptomLikely causeFix
401 on Control APIMissing/expired JWT or wrong API keyRefresh session or mint a new key
403 on intent createUsing API key instead of JWTSession intents require a dashboard JWT
Proxy 407 / auth failedBad username/password or expired intentRe-issue intent or re-fetch order credentials
Proxy 501Absolute-URI forward proxy (no CONNECT)Use HTTP CONNECT or SOCKS5 — see Buyer proxy
Order credentials 409Escrow/session not active yetWait for funding + activation, then retry

Next steps