chore: view node configuration for testnet

[MicBun]

Summary by CodeRabbit

• Documentation
  • Added comprehensive testnet setup guide with network information, Quick Start workflow including configuration and initialization steps, and troubleshooting guidance for common issues like firewall configuration and peer discovery.

[holdex]

Time Submission Status

Member	Status	Time	Action	Last Update
MicBun	✅ Submitted	1h	Update time	Feb 17, 2026, 10:23 PM
@vinarmani	❌ Missing	-	⚠️ Submit time	-

---

You can submit time with the command. Example:

@holdex pr submit-time 15m

See available commands to help comply with our Guidelines.

[coderabbitai]

📝 Walkthrough

Walkthrough

This pull request adds testnet-v1 configuration files for TRUF.NETWORK, including network documentation with setup instructions and a genesis configuration file containing initial blockchain parameters.

Changes

Cohort / File(s)	Summary
Testnet-v1 Configuration configs/network/testnet-v1/README.md, configs/network/testnet-v1/genesis.json	Introduces testnet-v1 setup documentation with Quick Start workflow, DockerPostgres setup, and node initialization steps. Genesis file defines network parameters including chain ID, validator configuration, and consensus parameters.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 A network takes shape, the testnet awaits,
With genesis blocks and configuration gates,
Validators poised, the chain takes its flight,
TRUF.NETWORK testnet shines oh-so-bright! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Title check	❓ Inconclusive	The title 'chore: view node configuration for testnet' is vague and does not clearly describe the actual changes. The PR adds new configuration files (README.md and genesis.json) for testnet-v1, but the title uses unclear language like 'view' that doesn't accurately represent adding new documentation and configuration files.	Revise the title to be more specific, such as 'chore: add testnet-v1 configuration and setup documentation' to clearly indicate that new files are being added for network setup.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch testnet

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (1)

configs/network/testnet-v1/README.md (1)

24-30: Consider pinning the Docker image tag and noting the trust auth implication.

Two minor observations:

1. ghcr.io/trufnetwork/kwil-postgres:latest — pinning to a specific version tag would improve reproducibility and prevent unexpected breakage from upstream changes.
2. POSTGRES_HOST_AUTH_METHOD=trust allows passwordless access from any connection. This is fine for a local testnet setup, but a brief note warning users not to expose port 5432 publicly would be helpful.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@configs/network/testnet-v1/README.md` around lines 24 - 30, Update the docker
run example to use a pinned image tag instead of
ghcr.io/trufnetwork/kwil-postgres:latest (replace :latest with a specific
version like :vX.Y.Z) and add a short warning next to
POSTGRES_HOST_AUTH_METHOD=trust and the exposed port 5432 noting that trust
allows passwordless access and the port must not be exposed publicly in
production; reference the docker run command, the image name
ghcr.io/trufnetwork/kwil-postgres:latest, the environment variable
POSTGRES_HOST_AUTH_METHOD=trust, and the exposed port 5432 so reviewers can
locate and update the README entry.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@configs/network/testnet-v1/README.md`:
- Around line 24-30: Update the docker run example to use a pinned image tag
instead of ghcr.io/trufnetwork/kwil-postgres:latest (replace :latest with a
specific version like :vX.Y.Z) and add a short warning next to
POSTGRES_HOST_AUTH_METHOD=trust and the exposed port 5432 noting that trust
allows passwordless access and the port must not be exposed publicly in
production; reference the docker run command, the image name
ghcr.io/trufnetwork/kwil-postgres:latest, the environment variable
POSTGRES_HOST_AUTH_METHOD=trust, and the exposed port 5432 so reviewers can
locate and update the README entry.