Metadata

name: wdh
description: Call any of seven paid-per-call CLI utilities on WDH.sh — big-file transfer (≤5 GB), URL shortening, Chart.js rendering, hosted markdown pages, QR codes, paid feature requests, paid support tickets — settled in USDC on Base mainnet via x402 with no signup or API key. Use when the user wants any of these utilities and has an EVM wallet, or mentions x402, USDC, micropayment, pay-per-call, or any of the wdh.sh hostnames (files.wdh.sh, short.wdh.sh, charts.wdh.sh, md.wdh.sh, qr.wdh.sh, feedback.wdh.sh, support.wdh.sh). Costs $0.001–$5.00 USDC per call depending on tool.
version: 0.3.1
metadata: {"openclaw":{"requires":{"env":["WDH_WALLET_PRIVATE_KEY"],"anyBins":["bunx","npx","wdh"]},"primaryEnv":"WDH_WALLET_PRIVATE_KEY","envVars":[{"name":"WDH_WALLET_PRIVATE_KEY","required":true,"description":"Hex-encoded EVM private key (starts with 0x) for a wallet funded with USDC on Base mainnet. Every CLI command signs an x402 payment with this key."}],"emoji":"🦸","homepage":"https://wdh.sh"}}

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

Tool	Cost (USDC)	Purpose
`files`	$0.001 – $0.10 (size-tiered)	Big-file transfer to a public expiring URL (≤5 GB, ≤7 days)
`short`	$0.001	URL shortener — links never expire by default
`charts`	$0.005	Chart rendering proxy (Chart.js payload → PNG)
`md`	$0.002	Publish a markdown file as a hosted HTML page (≤30 days)
`qr`	$0.001	QR code image (PNG or SVG)
`feedback`	$1.00	Paid feature request — opens a Linear issue on the WDH team's tracker
`support`	$5.00	Paid support ticket — opens a high-priority Linear issue

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

Flag	Required	Default	Description
`<path>`	yes	—	Path to the file to upload (up to 5 GB)
`--expires <ttl>`	no	`24h`	TTL like `30m`, `24h`, `7d`. Max 7 days

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/<slug> 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

Flag	Required	Default	Description
`<url>`	yes	—	URL to shorten (http or https only)
`--slug <s>`	no	auto-generated	Custom slug. Matches `^[A-Za-z0-9_-]{3,32}$`
`--expires <ttl>`	no	never	TTL like `24h`, `30d`. Omit and the link persists indefinitely

`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

Flag	Required	Default	Description
`--type <kind>`	yes	—	Chart.js chart type (`bar`, `line`, `pie`, `doughnut`, `radar`, etc.)
`--data <json>`	yes	—	Chart.js JSON payload as a string (parsed and forwarded as the request body)

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

Flag	Required	Default	Description
`<file>`	yes	—	Path to a local markdown file (max 1 MB)
`--title <t>`	no	`Shared markdown`	Page title for the rendered HTML
`--expires <ttl>`	no	`7d`	TTL like `24h`, `7d`, `30d`. Max 30 days

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

Flag	Required	Default	Description
`<data>`	yes	—	Text or URL to encode (max 2048 chars)
`--size <px>`	no	`512`	Output size in pixels. Clamped to 64–2048
`--format <png\|svg>`	no	`png`	Output format
`--out <file>`	no	stdout	Write the image to a file path instead

`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 me@example.com

Flag	Required	Default	Description
`<title>`	yes	—	Issue title (max 200 chars)
`--body <text>`	no	from stdin	Issue body (max 10 000 chars). Omit to read from stdin
`--contact <email>`	no	—	Optional reply-to address

`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 me@example.com \
  --body "every /init returns 500 since 14:00 UTC" \
  --severity high

cat incident.md | bunx @wdhsh/cli support "x402 settlement timing out" \
  --contact me@example.com --severity critical

Flag	Required	Default	Description
`<title>`	yes	—	Ticket title (prefixed with `[support]`, max 200 chars)
`--contact <email>`	yes	—	Reply-to email
`--body <text>`	no	from stdin	Ticket body (max 10 000 chars). Omit to read from stdin
`--severity <lvl>`	no	`medium`	`low \| medium \| high \| critical` → Linear priority 4\|3\|2\|1

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 <file>).
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

Error	Cause	Fix
`WDH_WALLET_PRIVATE_KEY env var is required`	Env var unset	`export WDH_WALLET_PRIVATE_KEY=0x...`
402 retry fails / `insufficient funds`	Wallet has no USDC on Base	Top up; even $1 covers thousands of small calls
`failed: 413` on `files upload`	File >5 GB	Split the upload; 5 GB is the per-call max
`failed: 400` on `md publish`	Markdown >1 MB	Trim or split the document
`invalid duration`	Bad `--expires` value	Use formats like `30m`, `24h`, `7d`
`failed: 503` on `short create --slug`	8 slug collisions in a row	Pick a different slug or let it auto-generate

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.

Wdh

安装技能

WDH.sh

Prerequisites

Services Overview

Install

Commands

`files upload` — Big-file transfer

`short create` — URL shortener

`charts plot` — Chart.js rendering

`md publish` — Hosted markdown pages

`qr generate` — QR code images

`feedback` — Paid feature requests

`support` — Paid support tickets

Output Handling

Tips

Error Handling

Related

360 行为纵深安全审计引擎

Wdh

安装技能

WDH.sh

Prerequisites

Services Overview

Install

Commands

files upload — Big-file transfer

short create — URL shortener

charts plot — Chart.js rendering

md publish — Hosted markdown pages

qr generate — QR code images

feedback — Paid feature requests

support — Paid support tickets

Output Handling

Tips

Error Handling

Related

`files upload` — Big-file transfer

`short create` — URL shortener

`charts plot` — Chart.js rendering

`md publish` — Hosted markdown pages

`qr generate` — QR code images

`feedback` — Paid feature requests

`support` — Paid support tickets