Local Setup

LICEN is built as a Turbo monorepo containing a Next.js web application, a Node.js orchestrator, smart contracts, and an Envio indexer.

Prerequisites

Node.js: v20 or higher.
pnpm: v9 or higher (npm install -g pnpm).
PostgreSQL: A local instance or a cloud URL (like Neon).
Foundry: For smart contract development (curl -L https://foundry.paradigm.xyz | bash).

git clone https://github.com/your-username/licen.git
cd licen
pnpm install

Each application in the apps and packages directory requires a .env file. You can usually find a .env.example in each folder to guide you.

The most critical variables across the stack are:

DATABASE_URL: Your PostgreSQL connection string.
ORCHESTRATOR_API_SECRET: A shared secret between the Web App and the Orchestrator.
ORCHESTRATOR_PRIVATE_KEY: A secp256k1 private key used to decrypt ECIES envelopes.
NEXT_PUBLIC_ORCHESTRATOR_PUBLIC_KEY: The corresponding public key for the web app to encrypt envelopes.

The Web App and the Orchestrator both use Drizzle ORM to connect to the database.

Ensure your DATABASE_URL is set, then run the migrations:

# Push schema for the Web App
cd apps/web
pnpm db:push

# Push schema for the Orchestrator
cd ../../packages/orchestrator
pnpm db:push

You can start the entire stack or individual components.

To start the Next.js Web Application:

cd apps/web
pnpm dev

The app will be available at http://localhost:3000.

To start the Orchestrator (Optional - usually better to let the production orchestrator handle background tasks even when developing the UI locally):

cd packages/orchestrator
pnpm dev