Open sourced federated Orcfax Validator Node

Foundation is formed of the complete history of the validator node
from July 11, 2023 to April 10, 2026.

Co-authored-by: george-orcfax <135040020+george-orcfax@users.noreply.github.com>

Author: george-orcfax

.codespellignore

@@ -0,0 +1,10 @@
+[codespell]
+skip =
+    *.po,
+    *.ts,
+    tests/*
+count =
+quiet-level = 3
+ignore-words-list =
+    placeholder,
+    double-click

.codespellrc

@@ -0,0 +1,21 @@
+# EditorConfig: https://EditorConfig.org. Provides sensible defaults for
+# non vscode editors.
+
+# top-most EditorConfig file
+root = true
+
+# Every file.
+[*]
+charset = "utf8"
+end_of_line = lf
+insert_final_newline = true
+
+indent_style = space
+indent_size = 4
+
+trim_trailing_whitespace = true
+
+# Python. (Duplicates used as placeholders)
+[*.py]
+indent_style = space
+indent_size = 4

.editorconfig

@@ -0,0 +1,12 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      time: "00:10"
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      time: "00:10"

.github/dependabot.yml

@@ -0,0 +1,26 @@
+---
+name: "linting - all"
+on:
+  pull_request:
+  push:
+    branches:
+      - "main"
+jobs:
+  lint:
+    name: "linting (python)"
+    runs-on: "ubuntu-latest"
+    steps:
+      - name: "Check out repository"
+        uses: "actions/checkout@v6"
+      - name: "Set up Python"
+        uses: "actions/setup-python@v6"
+        with:
+          python-version: "3.10"
+      - name: "install linting tooling"
+        continue-on-error: true
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements/local.txt ; pylint **/*.py
+      - name: "run linting via tox"
+        run: |
+          tox -e linting

.github/workflows/linting.yml

@@ -0,0 +1,25 @@
+name: pyreleaser
+on:
+  push:
+    tags:
+      - '*'
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: "checkout"
+        uses: actions/checkout@v6
+      - name: "fetch unshallow"
+        run: git fetch --prune --unshallow
+      - name: "list"
+        run: pwd && ls -la
+      - name: "deps"
+        run: python -m pip install -r requirements/local.txt
+      - name: "package"
+        run: make package-source
+      - name: "list"
+        run: ls -la ./dist/
+      - name: "release"
+        uses: ncipollo/release-action@v1.20.0
+        with:
+          artifacts: "dist/*"

.github/workflows/release.yml

@@ -0,0 +1,54 @@
+---
+name: "unit tests - all"
+on:
+    pull_request:
+    push:
+        branches: [main]
+jobs:
+  tox:
+    name: "Python ${{ matrix.python-version }} -- ${{ matrix.os }} "
+    runs-on: ${{ matrix.os }}
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.11", "3.12"]
+        experimental: [false]
+        include:
+          - os: ubuntu-latest
+            python-version: "3.13"
+            experimental: true
+          - os: macos-latest
+            python-version: "3.12"
+            experimental: true
+    steps:
+      - name: "check out repository"
+        uses: "actions/checkout@v6"
+        with:
+          submodules: 'true'
+      - name: "set up python ${{ matrix.python-version }}"
+        uses: "actions/setup-python@v6"
+        with:
+          python-version: "${{ matrix.python-version }}"
+      - name: "get pip cache dir"
+        id: "pip-cache"
+        run: |
+          echo "dir=$(pip cache dir)" >> $GITHUB_OUTPUT
+      - name: "show outputs.dir"
+        run: echo "${{ steps.pip-cache.outputs.dir }}"
+      - name: "cache pip packages"
+        uses: "actions/cache@v5"
+        with:
+          path: "${{ steps.pip-cache.outputs.dir }}"
+          key: "${{ runner.os }}-pip-${{ hashFiles('**/base.txt', '**/local.txt') }}"
+          restore-keys: |
+            ${{ runner.os }}-pip-
+      - name: "install tox"
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+      - name: "run tox"
+        env:
+          TOXENV: py3
+        run: |
+          tox

.github/workflows/unit-tests-all.yml

@@ -0,0 +1,22 @@
+.idea
+__pycache__
+venv
+*.egg*
+dist/*
+*.notes
+*.key
+*.crt
+*.pem
+wallet*
+cer-feeds.json
+.tox/*
+test_wallet_*
+*.env
+*.addr
+*.skey
+*.pkey
+*.vkey
+*.sh
+config.toml
+config.toml.prod
+config.toml.debug

.gitignore

@@ -0,0 +1,2 @@
+# Configurtion file for Markdown lint. Add exceptions here.
+default: true

.markdownlint.yaml

@@ -0,0 +1,46 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+    -   id: check-yaml
+    -   id: check-json
+    -   id: check-toml
+    -   id: end-of-file-fixer
+    -   id: trailing-whitespace
+    -   id: check-case-conflict
+-   repo: https://github.com/psf/black
+    rev: 24.8.0
+    hooks:
+    -   id: black
+- repo: https://github.com/pycqa/isort
+  rev: 5.13.2
+  hooks:
+  - id: isort
+    language_version: python3
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.6.7
+  hooks:
+    - id: ruff
+      args: ["--fix", "--show-fixes"]
+- repo: https://github.com/igorshubovych/markdownlint-cli
+  rev: v0.42.0
+  hooks:
+  - id: markdownlint
+- repo: https://github.com/codespell-project/codespell
+  rev: v2.3.0
+  hooks:
+    - id: codespell
+      args: [-I, .codespellignore]
+- repo: local
+  hooks:
+    - id: pylint
+      name: pylint
+      entry: pylint
+      language: python
+      language_version: python3
+      args:
+        [
+          "-rn", # Only display messages.
+          "-sn", # Don't display the pylint score.
+          "--rcfile=.pylintrc"
+        ]