run402

library2.37.0jsnpmunverified

Command-line interface for Run402 — provision Postgres databases, deploy static sites, run Node 22 serverless functions, host content-addressed CDN assets, send email, and sign on-chain, all paid autonomously with x402 USDC micropayments on Base. Version 2.37.0, active development, Node >=22 required. Key differentiators include testnet prototype tier (free), JSON-only output for scripting, and GitHub Actions OIDC integration.

devops

npm install run402

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · RUN402

run402

devopsjavascriptv2.37.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

None (CLI)

✓ npx run402 <command>

✗ require('run402')

run402 is a CLI tool, not a library. Use npx or install globally.

Initializes a Run402 allowance (testnet), provisions a Postgres database, deploys a static site from ./dist, and claims a subdomain.

run402 init run402 tier set prototype run402 projects provision --name my-app run402 sites deploy-dir ./dist run402 subdomains claim my-app

Debug

Known issues

gotchaAll commands output JSON to stdout and errors to stderr; exit code 0 on success, 1 on failure. Scripts must handle JSON pipes correctly.

fix

Always pipe stdout to jq or parse JSON; check exit code for success/failure.

affects: >=2.0.0

deprecatedThe 'deploy-dir' command may be deprecated in favor of 'deploy apply' with a manifest. Check docs for latest workflow.

fix

Use 'deploy apply --manifest app.json' for new deployments.

affects: >=2.30.0

breakingNode engine requirement increased to >=22. Older Node versions will fail on install with engine mismatch.

fix

Update Node.js to version 22 or later.

affects: >=2.0.0

gotchaAllowance must be created and funded before provisioning resources. Running 'init' performs both steps but requires testnet faucet availability.

fix

Run 'run402 init' first, then verify with 'run402 allowance balance'.

affects: >=2.0.0

gotchax402 micropayments require a wallet with testnet USDC on Base. The testnet prototype tier is free but limited.

fix

Ensure wallet is configured and testnet USDC is obtained via faucet (run402 allowance fund).

affects: >=2.0.0

Errors

Common errors & fixes

Error: Node.js version XX is not supported. Must be >=22

Node.js version too old

fix

Upgrade Node.js to v22 or later (e.g., 'nvm install 22').

Error: Allowance not found. Run 'run402 init' first.

No allowance configured

fix

Run 'run402 init' to create and fund an allowance.

Error: Insufficient balance for operation.

Allowance balance too low

fix

Run 'run402 allowance fund' to request testnet USDC.

Upgrade

Version history

2.37.0latest on npm

Audit

Dependencies

noderequiredEngine requirement: Node >=22

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/kychee-com/run402 ↗

packagerun402 ↗

homepagehttps://run402.com ↗