WDH.sh

A family of seven small, paid-per-call HTTP services for agents and humans. One CLI wraps every endpoint and signs payments automatically using the agent's wallet — no signups, no API keys, no subscriptions. Every call is settled in USDC on Base mainnet via the x402 protocol.

Prerequisites

• An EVM wallet with USDC on Base mainnet (eip155:8453). $1 of USDC covers thousands of calls except for feedback ($1) and support ($5).
• Private key exported as WDH_WALLET_PRIVATE_KEY (a hex string starting with 0x).
• Node.js 20+ (the CLI ships as @wdhsh/cli on npm and runs anywhere Node runs).

The buyer never submits an on-chain transaction directly. The Coinbase x402 facilitator handles settlement and pays gas. See https://x402.org for protocol detail.

Services Overview

Install

The CLI is published as @wdhsh/cli on npm. Use it via bunx or npx for zero-install, or install globally:

bunx @wdhsh/cli --help        # zero-install, one-shot
npm i -g @wdhsh/cli && wdh --help

export WDH_WALLET_PRIVATE_KEY=0x...

Once the env var is set, every command pays automatically. Without it the CLI refuses to run.

Commands

files upload — Big-file transfer

Multipart upload to files.wdh.sh. Returns a public download URL.

bunx @wdhsh/cli files upload ./report.pdf --expires 7d
bunx @wdhsh/cli files upload ./build.tar.gz                   # 24h default TTL

Size-tiered pricing: $0.001 (≤10 MB), $0.005 (≤100 MB), $0.02 (≤500 MB), $0.05 (≤2 GB), $0.10 (≤5 GB).

short create — URL shortener

Returns a short https://short.wdh.sh/\x3Cslug> URL. Links never expire by default — safe for business cards, printed materials, anywhere a permanent redirect target is wanted.

bunx @wdhsh/cli short create https://example.com/very/long/path
bunx @wdhsh/cli short create https://example.com --slug launch
bunx @wdhsh/cli short create https://example.com --expires 30d

charts plot — Chart.js rendering

Proxies a Chart.js payload to the chartsplat renderer. Writes raw PNG bytes to stdout (or to --out if provided).

bunx @wdhsh/cli charts plot \
  --type bar \
  --data '{"labels":["Q1","Q2","Q3","Q4"],"datasets":[{"label":"Revenue","data":[50,75,60,90]}]}' \
  > chart.png

See chartsplat docs for the full schema and supported chart types.

md publish — Hosted markdown pages

Publishes a local markdown file as a styled HTML page on md.wdh.sh. Returns the public URL.

bunx @wdhsh/cli md publish ./notes.md
bunx @wdhsh/cli md publish ./post.md --title "Launch notes"
bunx @wdhsh/cli md publish ./scratch.md --expires 24h

Renderer is markdown-it with HTML escaped and javascript: / data: / vbscript: / file: links dropped.

qr generate — QR code images

Renders a QR code as a PNG (default) or SVG.

bunx @wdhsh/cli qr generate "https://wdh.sh" --out wdh.png
bunx @wdhsh/cli qr generate "wifi:T:WPA;S:...;P:..." --size 1024 > wifi.png
bunx @wdhsh/cli qr generate "ping" --format svg > ping.svg

feedback — Paid feature requests

Files a $1.00 paid feature request as a Linear issue on the WDH team's tracker. Returns the issue URL.

bunx @wdhsh/cli feedback "Add Solana support" --body "We'd use this for..."
echo "long-form body here" | bunx @wdhsh/cli feedback "Title goes here"
bunx @wdhsh/cli feedback "Bug in qr" --body "..." --contact [email protected]

support — Paid support tickets

Files a $5.00 paid support ticket as a high-priority Linear issue. Severity maps to Linear priority. --contact is required so the team can follow up.

bunx @wdhsh/cli support "Files endpoint 500s" \
  --contact [email protected] \
  --body "every /init returns 500 since 14:00 UTC" \
  --severity high

cat incident.md | bunx @wdhsh/cli support "x402 settlement timing out" \
  --contact [email protected] --severity critical

Output Handling

• Most commands print a single line to stdout: the resulting URL (files, short, md, feedback, support) or the path that was written (qr --out \x3Cfile>).
• qr (without --out) and charts write raw image bytes to stdout — always pipe to a file: > chart.png.

Tips

• Wallet hygiene. Use a throwaway Base wallet for the agent — load it with the budget you're willing to spend and revoke by deleting the key.
• Idempotency for feedback / support. Those endpoints accept an Idempotency-Key header server-side (24h cache). The CLI doesn't surface that flag yet — re-running a command will file a duplicate Linear issue and charge again.
• Short links are permanent by default. Omitting --expires on short create means the redirect persists indefinitely — fine for business cards, printed QR targets, social bios. Add --expires only if you want it to lapse.
• Files are temporary. files upload defaults to a 24-hour TTL. Pass --expires 7d for the maximum.
• Charts payload. The --data JSON is a full Chart.js config (or just the inner data object — chartsplat accepts both). For OHLC / candlestick charts pass { x, o, h, l, c } points.

Error Handling

Related

• CLI on npm: @wdhsh/cli
• Per-service web docs: wdh.sh/docs
• The x402 protocol: x402.org
• The standalone chartsplat-x402 skill (uses chartsplat directly without WDH's proxy markup): chartsplat-x402 on ClawHub.