Overview
Quickstart
Try Matura on BSC Testnet, or run the whole stack locally.
Try it on testnet (no setup)
- Open the app at
app.usematura.xyz. - Fund a wallet with test BNB from the BNB Testnet faucet
(gas for signing
executeRoute). - Connect the wallet (BNB Smart Chain Testnet, chain
97) and sign in with SIWE. - Use Issuer Demo to create a claim, then your Portfolio → Position to finance it (optimize → sign → submit). Watch it land in Portfolio → Activity with a BscScan link.
Verified contract addresses are on the Deployed addresses page.
Run the stack locally
Matura is a pnpm + Turborepo monorepo. Contracts need an even-LTS Node (22.13+/24) — the repo
pins <25.
# from the repo root
pnpm install
pnpm build # turbo: builds every package/app
# contracts: one terminal runs a local chain, another deploys + seeds
pnpm --filter @matura/contracts hardhat node
pnpm --filter @matura/contracts demo:local # deploy → seed → verify
# services
pnpm --filter @matura/api db:migrate # needs Postgres
pnpm --filter @matura/api dev # HTTP API
pnpm --filter @matura/api worker:dev # indexer worker (separate process)
# frontends
pnpm --filter @matura/app dev # product app → :3002
pnpm --filter @matura/landing dev # marketing → :3001
pnpm --filter @matura/docs dev # these docs → :3003For the full contract build/deploy/seed/faucet flow see the repository
packages/contracts/README.md,
and for the end-to-end deploy procedure the Deployment page.