How ton25467/nova works
Nova is a Go HTTP framework for registering and serving APIs, with request middleware and typed request/response helpers. Its core workflow is HTTP request → route match and handler chain → response. The repository also provides database adapters, API documentation/client generation, and a Web3 ticketing toolkit. The README is empty and source excerpts are partial, so links between unsampled subsystems are omitted rather than inferred.
Main entry points: engine.go HTTP engine · typed.go Typed handlers · context.go Request context · middleware Middleware
Components 20
HTTP Framework
- HTTP engine
engine.go - Route tree
tree.go - Request context
context.go - Middleware
middleware - Binding helpers
binding.go - Validation
validator.go - Typed handlers
typed.go - HTTP errors
errors.go
API Tooling
- OpenAPI docs
openapi.go - Swagger UI
swagger.go - Client generator
codegen - Generated SDKs
sdk
Data Adapters
- Database adapters
database - Database cache
database/cache.go
Web3 Ticketing
- Ethereum RPC
sdk/web3/client.go - Voucher signer
sdk/web3/signer.go - Ticket inventory
sdk/web3/inventory.go - Chain listener
sdk/web3/listener.go - Ticket contract
contracts/TicketSBT.sol
Other components
- HTTP client
Connections 15
- HTTP client → HTTP engine: sends request
- HTTP engine → Route tree: matches route
- HTTP engine → Request context: runs handlers
- HTTP engine → Middleware: runs chain
- Middleware → Request context: uses request
- Binding helpers → Request context: reads request
- Typed handlers → Request context: binds and responds
- Typed handlers → Binding helpers: uses binding
- Typed handlers → Validation: validates input
- Typed handlers → HTTP errors: returns errors
- HTTP engine → Client generator: generates TypeScript
- Client generator → Generated SDKs: generates clients
- HTTP client → Generated SDKs: uses client
- Ethereum RPC → Ticket contract: queries chain
- Chain listener → Ethereum RPC: uses RPC