Install Causet and run the wallet demo locally.

1. Check prerequisites

   macOS or Linux (amd64/arm64). Docker Engine or Docker Desktop with Compose v2. Node.js 20+ for the wallets UI. Windows requires WSL2 running a supported Linux environment.

   Copy

   $ docker --version
   $ docker compose version
   $ node --version          # >= 20 for wallets UI
   $ curl --version

2. Install the CLI

   Copy

   $ curl -fsSL https://install.causet.io/install.sh | bash

   View install.sh Inspect the installer

3. Verify the installation

   Copy

   $ causet version

4. Run preflight

   causet doctor checks CLI version, compiler resolution, context files, and API/realtime reachability. For a fresh local setup, use causet context use env local after causet local up.

   Copy

   $ causet doctor

5. Create the wallet demo

   Scaffolds my-wallets/ from the public templates repo, runs npm install --prefix app, and provisions the local platform/application (compile + deploy to sandbox). If the Docker stack is not running, the CLI prompts to start it interactively. Does not start the Node UI or open a browser.

   Copy

   $ causet new wallets my-wallets

6. Start the local runtime

   Pulls images if needed, installs compose files into ~/.causet/local/ when missing, starts the stack, waits for health checks (default 2 minutes), and points the CLI at http://localhost:8085. Skip if step 5 already started the stack.

   Copy

   $ cd my-wallets
   $ causet local up

7. Open the demo UI

   The wallets template serves on port 3850 via app/server.mjs. Open the URL manually after the server prints its listen message.

   Copy

   $ npm run dev --prefix app

   Copy

   http://localhost:3850

8. Run one transaction

   From the UI, open a wallet and fund it — or submit intents from the CLI (amounts are integer cents):

   Copy

   $ causet intent OPEN_WALLET \
       --stream wallet_stream \
       --entity wallet-alice \
       --fork sandbox \
       --payload '{"wallet_id":"wallet-alice","owner":"alice","currency":"USD"}'

   Copy

   $ causet intent FUND_WALLET \
       --stream wallet_stream \
       --entity wallet-alice \
       --fork sandbox \
       --payload '{"wallet_id":"wallet-alice","amount":10000,"reference":"paycheck","movement_id":"fund-1"}'

9. Inspect state and timeline

   Confirm committed state and the decision/event timeline for the entity.

   Copy

   $ causet inspect state \
       --entity wallet-alice \
       --stream wallet_stream \
       --fork sandbox

   Copy

   $ causet inspect timeline \
       --entity wallet-alice \
       --stream wallet_stream \
       --fork sandbox \
       --all

$ causet doctor
$ causet local status
$ causet context show

✓ auth token                 not required (local open mode)
✓ platform context           local-platform
✓ application context        my-wallets
✓ api reachable              http://localhost:8085
✓ Local Docker stack healthy

Release CLI version: v10.0.12 · Pin with CAUSET_VERSION (see version pinning).