Skip to content

Consolidate configs, fix URL handling, improve docs and developer tooling#102

Draft
Copilot wants to merge 2 commits intomainfrom
copilot/consolidate-configs-and-docs
Draft

Consolidate configs, fix URL handling, improve docs and developer tooling#102
Copilot wants to merge 2 commits intomainfrom
copilot/consolidate-configs-and-docs

Conversation

Copy link

Copilot AI commented Feb 28, 2026

Thirteen medium-priority maintenance gaps across configuration consistency, documentation accuracy, and developer onboarding. Changes address all items from the linked issue.

Configuration

  • versions.env — single source of truth for AVALANCHEGO_VERSION=1.14.1 and SUBNET_EVM_VERSION=0.8.0; both update-validator-*.sh scripts now source it instead of hardcoding stale versions
  • API scripts — all 11 scripts that hardcoded 127.0.0.1:9650 now source api/env.sh; fixed /ext/P/ext/bc/P in platform.getBlockchains.sh and platform.getBlockchainStatus.sh
  • api/env.sh — fixed permissions to +x (was the only non-executable .sh file)
  • Genesis duplication — removed genesis/ (exact copy of chains/testnet/); updated subnet-cli-wizard.sh to reference chains/testnet/ as canonical
  • JSON normalization — all avalanchego/configs/chains/**/*.json reformatted with jq . (eliminated tab/space mix)

Documentation

  • README — fixed "Archieve" → "Archive", em-dash → --http-host, SUBNET_MAINNETSUBNET_TESTNET in testnet example, removed internal Asana link
  • avalanchego/configs/README.md — added human-readable timestamp reference table for all upgrade.json Unix timestamps (e.g. 17677890002026-01-07 12:30:00 UTC)

Infrastructure & Developer Experience

  • rpc/mainnet/…/default — added mainnet Nginx config mirroring the existing testnet config (proxies to 2PDRxzc6…/rpc and /ws)
  • requirements.txt — pins requests==2.32.3 and websockets==13.1 for Python RPC tests
  • CONTRIBUTING.md — setup steps, repo structure map, API script usage, JSON formatting guide
  • Makefile — targets: setup, test-rpc, test-ws, fmt (runs jq . across all configs), check-versions
Original prompt

This section details on the original issue you should resolve

<issue_title>[Feature][Medium] Consolidate configs, improve documentation, add IaC and developer tooling</issue_title>
<issue_description>## Summary

Thirteen medium-priority improvements for maintainability, documentation, and developer experience:

Configuration

  1. Inconsistent URL handling — Most API scripts hardcode 127.0.0.1:9650 instead of using api/env.sh. Some use /ext/P vs /ext/bc/P inconsistently.
  2. Genesis file duplication — Files in genesis/ are exact copies of chains/testnet/. Should consolidate to a single canonical location.
  3. Version drift — README says v1.14.1/v0.8.0, scripts say v1.10.11/v0.5.6. Create a single versions.env file.
  4. Mixed indentation in JSON configs — Chain config files mix tabs and spaces. Normalize with jq ..
  5. Upgrade.json timestamps undocumented — Unix timestamps (e.g., 1767789000) have no human-readable date comments.

Documentation

  1. README typos and stale references — "Archieve" should be "Archive", em-dash in --http-host, internal Asana link, references to old repo names, misleading variable name SUBNET_MAINNET used for testnet.

Infrastructure

  1. No IaC — No Terraform, Ansible, Docker, or systemd configs. All infrastructure management is manual.
  2. No mainnet Nginx config — Only testnet config exists; mainnet endpoint documented but no config in repo.
  3. Backup script limitations — No rotation, encryption, remote storage, or verification.

Developer Experience

  1. No Makefile, setup script, or CONTRIBUTING.md — Missing standard onboarding tooling.
  2. No requirements.txt — Python tests import requests and websockets without pinning versions.
  3. api/env.sh not executable — Has -rw-r--r-- permissions while all other .sh files are -rwxr-xr-x.
  4. Inconsistent JSON formatting — API scripts use wildly different indentation styles.

🤖 Generated with Claude Code</issue_description>

Comments on the Issue (you are @copilot in this section)


🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Co-authored-by: numbers-official <181934381+numbers-official@users.noreply.github.com>
Copilot AI changed the title [WIP] Consolidate configurations and improve documentation consistency Consolidate configs, fix URL handling, improve docs and developer tooling Feb 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature][Medium] Consolidate configs, improve documentation, add IaC and developer tooling

2 participants