Chainora DApp

Web frontend for Chainora built with Vite, React, TypeScript, TanStack Router, wagmi, and InterwovenKit.

Local Development Baseline

• Node 20 LTS
• Yarn 1.22.x
• A running chainora-api instance
• A reachable Chainora RPC endpoint and deployed contract addresses

Setup

1. Create the local env file

Copy .env.contracts.example to .env.local.

Required values for a real local run:

• VITE_CHAINORA_API_URL
• VITE_CHAINORA_REGISTRY_ADDRESS
• VITE_CHAINORA_FACTORY_ADDRESS
• VITE_CHAINORA_POOL_IMPLEMENTATION_ADDRESS
• VITE_CHAINORA_STABLECOIN_ADDRESS
• VITE_CHAINORA_RPC_URL
• VITE_CHAINORA_EXPLORER_URL
• VITE_CHAINORA_CHAIN_ID
• VITE_CHAINORA_TX_GAS_BUFFER_BPS (recommended, default is 12000 = +20%)
• VITE_CHAINORA_RELAY_CONNECT_TIMEOUT_MS
• VITE_INTERWOVEN_NETWORK
• VITE_INTERWOVEN_DEFAULT_CHAIN_ID

Username lookup is disabled by default in the example file because the sample Initia HTTP base used previously is not compatible with the current lookup code. For QR login from a real phone, VITE_CHAINORA_API_URL must point to a LAN-reachable backend host (for example http://192.168.x.x:8080) and must not be localhost/127.0.0.1.

2. Install dependencies

corepack yarn install

3. Start the app

corepack yarn dev

Set VITE_CHAINORA_API_URL explicitly in .env.local before running the app.

Validation

corepack yarn typecheck
corepack yarn build

There is currently no dedicated test runner or linter configured in this repo.