Files
bootnode/api/store/usage.go
zeekayandGitHub 97321f67b0 feat: Go rewrite scaffold — ZAP-first, Mount() per HIP-0106 (#1)
Adds a Go subsystem alongside the existing Python FastAPI service so
bootnode can fold into `superbase` per HIP-0106. The Python service in
`api/bootnode/` stays untouched.

What landed:

- `schema/bootnode.zap` — public typed surface (chains, RPC, tokens,
  NFTs, transfers, smart wallets, ERC-4337, gas, webhooks, fleets,
  nodes, usage). No `.capnp` anywhere — ZAP only, per brand policy.
- `zap/gen/` — hand-rolled Go bindings that match what `zapc generate`
  emits, so `go build` works without zapc installed locally.
- `api/mount.go` — the HIP-0106 contract:
    func Mount(r chi.Router, deps Deps) error
  mounts every FastAPI-parity route group through `api/handlers/`.
- `api/deps.go` — cross-subsystem ZAP client interfaces (IAM, KMS,
  Base, O11y, Commerce). No business logic, no hard imports — keeps
  the Bootnode module independent of sibling subsystems until they
  ship their typed clients.
- `api/handlers/` — 149 chi routes mounted (Python has 150). Each
  handler body is a 501 stub with a `TODO(bootnode-port)` pointing at
  the Python file + symbol to port.
- `api/middleware/` — IAM-backed auth, OTEL-friendly telemetry,
  per-org rate limit (stub).
- `api/store/` — per-tenant SQLite access via `deps.Base.Open(orgID,
  "bootnode")` per HIP-0302.
- `api/web3/` — chain registry + RPC pool surface (production version
  prefers luxfi/* over upstream go-ethereum).
- `cmd/bootnode/main.go` — standalone shim; same `api.Mount` superbase
  calls in production.
- `docs/PYTHON_TO_GO_PORT.md` — endpoint-by-endpoint port map.

Build: `go build ./...` and `go vet ./...` clean. Standalone shim
smokes 200 on /health, /ready, /v1/chains; 401 on auth-required
endpoints with no JWT; 501 on every TODO route.

Out of scope (not in this commit):
- Handler bodies (Phase 2 — porting in RPC → tokens → NFTs → ...
  priority order).
- superbase wiring (lands when the superbase repo opens its main).
- Python service removal (stays until handlers reach prod parity).
2026-05-18 23:36:46 -07:00

40 lines
1.2 KiB
Go

package store
import (
"context"
"errors"
bootnodezap "github.com/hanzoai/bootnode/zap/gen"
)
// UsageStore persists per-org/per-project compute-unit accounting.
// Hot-path counters live in deps.MQ (Redis-equivalent), durable
// accounting lives here in per-tenant SQLite, and roll-ups sync to
// Commerce via deps.Commerce.RecordUsage on a timer.
type UsageStore struct {
base BaseClient
}
// NewUsageStore builds the per-tenant usage store.
func NewUsageStore(b BaseClient) *UsageStore { return &UsageStore{base: b} }
// Append writes one billable call.
//
// TODO(bootnode-port): port from bootnode/core/billing/tracker.py
func (s *UsageStore) Append(ctx context.Context, r bootnodezap.UsageRecord) error {
_ = ctx
_ = r
return errors.New("store.UsageStore.Append: not implemented")
}
// Summary aggregates usage over (start, end).
//
// TODO(bootnode-port): port from bootnode/api/billing/__init__.py:usage_summary
func (s *UsageStore) Summary(ctx context.Context, orgID string, start, end int64) (bootnodezap.UsageSummary, error) {
_ = ctx
_ = orgID
_ = start
_ = end
return bootnodezap.UsageSummary{}, errors.New("store.UsageStore.Summary: not implemented")
}