Moneymentum

Moneymentum is an institutional-grade quant toolkit for crypto portfolio management. Define portfolios as proportions, not positions. Stage and simulate before executing. Manage factor exposures, not symbols. Most crypto holders cannot answer basic questions about their portfolio's factor exposure; Moneymentum makes those exposures legible and adjustable.

Status

• DataClique landing at /: company site with product and ecosystem links.
• Frontend rebalancer at /portfolio (working, used daily): weight-based positions, cross-account leverage, staged trade preview, execution against Hyperliquid perps.
• Frontend prototype at /prototype: design reference for the target UI.
• Backend (active development): Rust + Axum API, Polars analytics, SQLite-backed ingestion runs and job queue. Ingests Hyperliquid open-high-low-close-volume (OHLCV) and funding rates on a built-in schedule (and on demand via cargo run --bin moneymentum-ingest -- --config config.toml); computes rolling beta to BTC and serves per-asset factor scores via GET /factors/<timeframe>.
• Vault program (planned): Anchor program on Solana for non-custodial managed deposits with two-phase withdrawal.

See ROADMAP.md for what's next.

Documentation

Doc	Purpose
SPEC.md	Product vision and target architecture
ROADMAP.md	Outcome epics ordered by priority
GitHub issues	Requirements, acceptance criteria, and sub-issues
CONTRIBUTING.md	Issue-based contributor workflow and completion requirements
AGENTS.md	Per-repo rules for AI coding agents

Quick start

Prerequisites

• Nix with flakes enabled
• Direnv (recommended)

Setup

git clone https://github.com/dataclique/moneymentum.git
cd moneymentum
direnv allow  # or: nix develop

Frontend

Run from frontend/:

bun run typecheck   # type check
bun run lint        # eslint
bun run test        # vitest
bun run dev         # dev server on :5173
bun run build       # production bundle

Backend

Run from repo root:

cargo check         # fast compilation verification
cargo test -q       # tests
cargo clippy        # lints (pedantic + nursery, panic-free)
cargo fmt           # format

cargo run --bin moneymentum -- --config config.toml
# on-demand candle + funding pull (no HTTP server):
cargo run --bin moneymentum-ingest -- --config config.toml

Configuration is loaded from a TOML file modeled on example.toml.

Pre-commit

pre-commit run -a

All dependencies are managed through Nix. Do not use bun install or similar directly.

Running AI coding agents

Use any coding agent with direnv enabled in its command environment. Confirm that it inherits the repository's Nix toolchain before running checks; an integrated terminal and an agent's command runner may use different shells. Agents follow AGENTS.md. No Nix wrapper is needed to launch the agent itself.

Infrastructure

Terraform provisions the server, then NixOS is bootstrapped onto it.

nix run .#tfCreateVars   # create + encrypt terraform vars
nix run .#tfInit
nix run .#tfPlan
nix run .#tfApply
nix run .#bootstrap      # bootstrap NixOS

nix run .#remote         # SSH
nix run .#tfEditVars

Infrastructure commands use age-encrypted state. The -i flag selects a custom SSH identity (defaults to ~/.ssh/id_ed25519).

master deploys automatically through the Deploy GitHub Actions workflow. The workflow pins the SSH host key from keys.nix, resolves the host IP from encrypted Terraform state, builds the frontend with Bun and cached dependencies, runs nix run .#deployServer for NixOS and backend services, then runs nix run .#deployFrontend to publish the static frontend files. The post-deploy-smoke-test job verifies the public frontend and /api/health.

Manual deployment uses the same split flow:

nix develop --impure .#frontend --command bash -c 'cd frontend && bun install --frozen-lockfile && bun run build'
nix run .#deployServer
nix run .#deployFrontend

Set DEPLOY_FRONTEND_URL and DEPLOY_HEALTH_URL repository variables when the public checks should use a domain or HTTPS instead of the raw droplet IP. Set DEPLOY_SMOKE_HOST when the post-deploy smoke test needs an explicit Host header, such as targeting a domain behind a load balancer; set DEPLOY_SMOKE_INSECURE to true only when those frontend and /api/health checks must skip TLS verification for self-signed certificates.

There is no standalone destroy command. To remove or reprovision resources, edit infra/main.tf, inspect nix run .#tfPlan, then apply the reviewed plan.