ZIGoals
Goals, Habits & Health = Wealth. Goal-oriented onchain wealth planning, progress tracking and strategy orchestration.
Current state
docs/STATUS.md is the live source of truth for releases, open work and known issues. In short, as of 2026-09-29:
- Unaudited Alpha. Mainnet is disabled. The Goal Manager contract and its code ID are not deployed, and financial signing/broadcast stays disabled.
PUBLIC_ALPHA_UNDEPLOYED means the web app is deployed while the contract is absent.
- Public web Alpha: Open the Alpha. It runs source
07f5c90 (Manual Alpha deployment #11, 2026-09-29), deployed through the manual owner-approved workflow with a rollback version captured before every upload. A merge never deploys. Exact version IDs and owner checks are in STATUS.
- In the app: Goals, Wealth, Markets, Habits, Health, Today and Activity, plus a fictional Showcase demo.
- Account sync: encrypted account sync and recovery (Run #11) are merged, but the hosted services are not activated. The owner's activation stages are in progress; Stage 4 local configuration passed.
- Testnet: the owner reports the dedicated test wallet is funded, but it is not on the CosmWasm upload whitelist, so no contract has been uploaded.
- Contract release: no release candidate is approved. The last attested candidate predates current
main; a fresh candidate from exact current main and explicit owner approval are required before any upload.
The local demo uses simulated balances and sends no blockchain transactions. Testnet assets have no monetary value.
Run locally
Use Node 24.19.0 (.node-version and .nvmrc) and pnpm 11.19.0 (packageManager). Use your preferred version manager. With an existing nvm installation, run nvm install then nvm use in this directory. fnm also supports these pin files. No global shell changes are required by this repository.
First run node scripts/doctor.mjs (or pnpm run doctor). It only reads local prerequisites and checks the optional local Docker socket; it does not install tools or query the chain. ERROR blocks the relevant prerequisite; WARNING identifies optional tools or uncommitted work. Use pnpm run doctor, with run: pnpm doctor is pnpm's own unrelated command. The owner's Node 22.23.1 could start the development server but does not meet the pinned, CI-tested version; switch the current terminal to 24.19.0 before installing or verifying. Then:
pnpm install --frozen-lockfile --ignore-scripts
NEXT_PUBLIC_APP_ENVIRONMENT=LOCAL_DEMO pnpm dev
Open the local app. No wallet, environment file, API key, Docker service, or chain connection is required for the local demo. It starts with 1,000 simulated ZIG. Create a goal, review it, add funds, withdraw, and close it when empty. Starting balance in the wizard is a planning input; funds enter the goal only through the separate Add funds action.
Names, targets, dates and notes stay in browser storage. Export them from Settings before clearing site data. Backups contain private information. Testnet metadata is isolated by network and wallet; removing metadata does not remove the onchain withdrawal path. Clearing local demo storage does remove its simulated ledger. Known testnet outcomes are retained in a separate IndexedDB journal; clearing site data can also erase that history. Recovery checks known receipts only and never automatically resubmits a transaction.
Verify the implementation
pnpm lint
pnpm typecheck
pnpm test
NEXT_PUBLIC_APP_ENVIRONMENT=PUBLIC_ALPHA_UNDEPLOYED pnpm build
pnpm audit --prod --audit-level high
pnpm verify:network
Browser tests require Google Chrome. Install a test browser with pnpm --filter @zigoals/web exec playwright install chrome if needed. With the app running on port 3100:
pnpm --filter @zigoals/web exec playwright test
For a full Chrome exit and relaunch with the same isolated test profile, keep the production server running and run node scripts/verify-browser-restart.mjs. It verifies retained transaction records, uncertain hashes, damaged-history warnings and account isolation. The wallet and external network responses are mocked; it never uses the owner's browser profile or requests a real signature.
The desktop and mobile tests exercise the local lifecycle, metadata backup/recovery, wallet-unavailable state, review-dialog keyboard navigation, journal reload/account scope/corruption, and the read-only ecosystem page. They do not prove live Keplr signing or testnet execution. CI is defined in .github/workflows/ci.yml; local command results and hosted CI results are separate evidence.
Contract development
Install Rust 1.85.1, rustfmt, clippy, and the wasm32-unknown-unknown target using the official rustup installer. The repository pins the toolchain and Cargo dependencies.
rustup toolchain install 1.85.1 --profile minimal --component rustfmt,clippy --target wasm32-unknown-unknown
cargo fmt --all -- --check
cargo clippy --workspace --all-targets --locked -- -D warnings
cargo test --workspace --locked
cargo schema --locked
node contracts/goal-manager/scripts/generate-types.mjs
This is the beginning of the README. Read the rest at the original. Read the full README ↗
