Code map
Where every part lives in the repository, how to run it on your machine, and how it is tested and deployed.
The repository is github.com/mitoshi-xyz/mitoshi, MIT licensed, a pnpm and Turborepo monorepo. Its history starts on 2026-10-22.
Run it locally
Needs Node 24+ and pnpm 12. The wallet's WASM build is committed, so Rust isn't needed.
pnpm installpnpm --filter @umbra-trade/web devThat serves localhost:3300 on Zcash testnet through the deployed relay (the app tints itself vermilion so test
money never passes for real money). pnpm --filter @umbra-trade/web dev:main serves mainnet on port 3301. Private wallets
are funded on mainnet only.
Checks
pnpm lint && pnpm typecheck && pnpm test| Package | Tests | What they cover |
|---|---|---|
packages/engine | 22 | Denominations, rest rules, scheduler, registry and positionWallet, leak meter, keys |
packages/rails | 7 | 1Click quote requests and the ed25519 signature check |
packages/venues | 7 | Polymarket Perps signing (4) and Solana transactions (3) |
CI runs Biome, the type checks, these tests and a full build on Node 24 for every push to main and every pull request.
Deploy
| What | Command |
|---|---|
| App and relay (Cloudflare) | pnpm --filter @umbra-trade/web-worker run deploy |
| Gateway (Vercel) | pnpm --filter @umbra-trade/gateway run deploy |
| This site (Cloudflare) | pnpm --filter @umbra-trade/docs run deploy |
| Rebuild the wallet WASM | pnpm --filter @umbra-trade/zwallet build:wasm (Rust, LLVM clang, the wasi-libc sysroot) |
The gateway's secrets (its OHTTP seed, the relay token, NEAR's partner key, Polymarket's builder credentials) are set on the host, never in the repository.