project-structure.md

Project Structure

What every part of the template is for.

.
├── README.md                 Project entry point and quickstart
├── package.json              Scripts and @quantova SDK dependencies
├── .env.example              Endpoints and keys template (copy to .env)
├── .gitignore                Ignores node_modules, .env, build output
├── src/
│   ├── client.js             Reusable q_ JSON-RPC client
│   └── config.js             Network selection (local | testnet | mainnet)
├── contracts/
│   ├── ExampleQRC20.sol      Example QRC20 token for the QVM
│   └── README.md             How to compile and deploy contracts
├── scripts/
│   ├── interact.js           Read height, chain id, balance
│   ├── deploy.js             Prepare/broadcast a QVM deployment
│   └── README.md             Script usage
├── test/
│   └── example.test.js       Starter tests (node:test)
├── docs/
│   ├── getting-started.md    This guide's neighbor — setup
│   ├── project-structure.md  You are here
│   ├── deploying.md          Deployment walkthrough
│   └── interacting.md        Reading and sending
└── .github/workflows/
    └── ci.yml                CI: install, lint, test

How the pieces fit

• src/config.js decides which network you talk to from QUANTOVA_NETWORK.
• src/client.js is a thin wrapper over the q_ JSON-RPC namespace; both scripts import it.
• scripts/interact.js is a read-only smoke test.
• scripts/deploy.js shows the deployment shape and signs with the @quantova SDK keyring.
• contracts/ExampleQRC20.sol is the thing you deploy.