network/CONTRIBUTING.md
anonpenguin 917b0e5acd Enforce API key/JWT authentication and namespace gating in client
- Require API key or JWT by default for client connections - Auto-derive
namespace from JWT claim or API key format `ak_<rand>:<namespace>` -
Deny calls if per-call namespace override mismatches resolved namespace
- Guard Storage, PubSub, Database, and NetworkInfo operations with
access checks - Add context helpers for consistent namespace override
handling - Update docs and add end-to-end and unit tests for
authentication logic
2025-08-20 23:01:51 +03:00

1.0 KiB

Contributing to DeBros Network

Thanks for helping improve the network! This guide covers setup, local dev, tests, and PR guidelines.

Requirements

  • Go 1.22+ (1.23 recommended)
  • RQLite (optional for local runs; the Makefile starts nodes with embedded setup)
  • Make (optional)

Setup

git clone https://git.debros.io/DeBros/network.git
cd network
make deps

Build, Test, Lint

  • Build: make build
  • Test: make test
  • Format/Vet: make fmt vet (or make lint)

Useful CLI commands:

```bash
./bin/network-cli health
./bin/network-cli peers
./bin/network-cli status

Versioning

  • The CLI reports its version via network-cli version.
  • Releases are tagged (e.g., v0.18.0-beta) and published via GoReleaser.

Pull Requests

  1. Fork and create a topic branch.
  2. Ensure make build test passes; include tests for new functionality.
  3. Keep PRs focused and well-described (motivation, approach, testing).
  4. Update README/docs for behavior changes.

Thank you for contributing!