TideVector — Whale-aware Signals with Risk-Gated Execution (MVP)

Tagline: Read the tide. Ride the vector.

This is a Solana-first starter for a system that:

1. Ingests wallet/pool signals (Helius webhooks + Birdeye/Dexscreener polling)
2. Runs risk gates (liq/age/holders/auth/taxes via RugCheck + your rules)
3. Decides and sizes positions with guardrails (cooldowns, stops, caps)
4. Executes via Jupiter (optionally with Jito bundles)
5. Logs everything to Postgres and exposes a simple dashboard

This repo is scaffolding: TypeScript server skeleton, SQL schema, infra docker-compose, and a static landing page using the TideVector brand kit included in /docs/brand_kit.

Quick start (infra)

cd infra
cp .env.example .env   # update passwords/keys later
docker compose up -d
# Services: postgres:5432, redis:6379, adminer:8080
psql postgresql://tv:tvpass@localhost:5432/tidevector -f sql/schema.sql

(If you don't have psql, connect via Adminer http://localhost:8080 then run the SQL in infra/sql/schema.sql)

Server (skeleton)

The server is plain Node/TypeScript. It includes endpoints:

• POST /webhooks/helius — receive wallet tx events
• GET /health — liveness
• (stubs) services/* for RugCheck, Birdeye, Dexscreener, Jupiter, Jito

You will need to run npm init -y && npm i express cors body-parser pg ioredis node-fetch and add ts-node-dev for dev, plus typescript @types/*. Since this is a scaffold, package.json is omitted on purpose.

Dashboard

A dead-simple static landing header in /dashboard to start productizing brand/positioning.

Security

• Use a bot wallet (burner) with low balances; rotate keys
• Limit approvals; schedule regular revokes
• Store secrets in env or KMS; never commit .env

License

MIT