Quickstart

Deploy a live, self-hosted digital asset on testnet. The abx CLI is the toolkit's front door: you run it directly, or a coding agent runs it (see Agent + skill).

Prerequisites

Node 22.5 or newer (the toolkit uses the built-in node:sqlite).
A browser wallet with Base Sepolia test ETH. Base Sepolia is the default chain. Get test ETH from a faucet.
Optionally, your own RPC endpoint. A public one is used by default.

1. Check your environment

npx abx doctor

doctor checks your RPC connection, the canonical factory, and your storage configuration. Fix anything it flags before deploying.

2. Run the demo

npx abx demo --sign

demo deploys a token to Base Sepolia, indexes it from the chain, and serves it locally. The --sign flag opens a browser wallet to sign the transaction, so no private key is stored anywhere. Open http://localhost:8787 and click Re-index from chain: the resolver rebuilds the token's state from the event logs.

3. Deploy something real

A digital asset can be a single piece, a collection, or a generative program. These are variations of one flow along the on-chain spectrum. The Deploy a digital asset guide covers all three. The entry points are:

npx abx deploy --sign                      # a single asset
npx abx deploy-series --dir ./art --sign   # a collection from a folder
npx abx deploy-code --sign                 # a generative or code project

Then serve and inspect:

npx abx serve      # the resolver: re-indexes from the chain and serves metadata and images
npx abx state      # a snapshot of on-chain state: owner, supply, minter, payee, royalty, renderer

Who signs

Every command that writes to the chain runs in one of three signing lanes:

--sign: sign in a browser wallet. Recommended to start; nothing is stored.
--send: sign and broadcast with a hot key from the environment.
--unsigned: print the raw transaction to sign elsewhere.

Add --dry-run to any write command to preview it without sending.