This repository is the Tikka ecosystem: frontend, SDK, backend, indexer, and oracle. Soroban smart contracts (Rust) live in a separate repo/folder and are not included here.
| Package | Role |
|---|---|
| client | Consumer web app — React 19, Vite, TypeScript. Reads from backend, writes via SDK. |
| sdk | NestJS library for Soroban contract interaction (tx build, simulate, sign, submit). Published as @tikka/sdk. |
| backend | API layer — auth (SIWS), metadata, indexer merge, notifications. NestJS, Fastify, Supabase. |
| indexer | Blockchain event ingestion — Horizon → decode → PostgreSQL (+ Redis cache). NestJS. |
| oracle | Randomness oracle — listens for draw requests, computes VRF/PRNG, submits to contract. NestJS. |
Auto-generated TypeDoc reference for @tikka/sdk:
crackedstudio.github.io/tikka
Covers all public APIs organized by module: Raffle · Ticket · Wallet · User · Network · Utils.
To regenerate locally: cd sdk && npm run docs
Full ecosystem specification: docs/ARCHITECTURE.md — diagram, data flows, contract interface, API design, and roadmap.
Soroban (Rust) raffle contracts are maintained outside this repo. Deploy and invoke them via the SDK once addresses are configured.