Add NodeReader for node config and update controllers

Introduced NodeReader to manage node URLs, queries, and params from nodes.json. Updated address_controller.py and transaction_controller.py to use NodeReader instead of config_manager for building API URLs. Added nodes.json for node and query configuration, and adjusted .dockerignore and .gitignore for IDE and venv exclusions.

Author: Pymmdrza

.dockerignore

@@ -1,7 +1,8 @@
 # Git
 .git
 .gitignore
-
+venv/*
+.idea
 # Python
 __pycache__
 *.pyc
@@ -13,7 +14,6 @@ venv/
 .env
 
 # IDE
-.idea
 .vscode
 *.swp
 *.swo

.gitignore

@@ -0,0 +1,2 @@
+.idea
+venv

app/config/__init__.py

@@ -1,3 +1,3 @@
 from .config_manager import config
-
-__all__ = ['config']
+from .node_reader import NodeReader
+__all__ = ['config', 'NodeReader']

app/config/__pycache__/node_reader.cpython-38.pyc

@@ -51,8 +51,6 @@ def __init__(self):
 
             config_path = os.path.join(current, 'config.json')
 
-            logging.info(f"Looking for config file at: {config_path}")
-
             if not os.path.exists(config_path):
                 logging.error(f"Config file not found at: {config_path}")
                 raise FileNotFoundError(f"Config file not found at: {config_path}")

app/config/config_manager.py

@@ -0,0 +1,100 @@
+import json
+import os
+from typing import Dict, List, Optional, Any
+from dataclasses import dataclass
+
+@dataclass
+class Node:
+    nodes: List[str]
+    query: Dict[str, Any]
+    params: Dict[str, Any]
+
+class NodeReader:
+    def __init__(self) -> None:
+        current = os.getcwd()
+        self.path = os.path.join(current, "nodes.json")
+        self.nodes: List[Node] = []
+
+    @property
+    def data(self) -> List[Node]:
+        return self.nodes
+
+    @data.setter
+    def data(self, value: List[Node]) -> None:
+        self.nodes = value
+
+    @staticmethod
+    def reader():
+        try:
+            current = os.path.dirname(os.path.abspath(__file__))
+            node_path = os.path.join(current, 'nodes.json')
+            if not os.path.exists(node_path):
+                raise FileNotFoundError(f"Config file not found at: {node_path}")
+
+            with open(node_path, 'r') as f:
+                content = json.load(f)
+            return content
+        except Exception as e:
+            print(f"Failed to NodeReader: {str(e)}")
+            raise
+
+    @classmethod
+    def get_nodes(cls) -> List[Node]:
+        reader = cls.reader()
+        nodes = reader.get('nodes')
+        if not nodes:
+            raise ValueError("No nodes found in config file")
+        return nodes
+
+    @classmethod
+    def get_query(cls, _Query: str) -> Optional[str]:
+        """
+        Standard queries:
+        - address
+        - tx
+        - block
+        - blockIndex
+        """
+        query_standard = ["address", "tx", "block", "blockIndex"]
+        if _Query not in query_standard:
+            raise ValueError(f"Invalid query type: {_Query}")
+        reader = cls.reader()
+        _query = reader.get('query')
+        if not _query:
+            raise ValueError("No nodes found in config file")
+        return _query.get(_Query)
+
+    @classmethod
+    def get_params(cls) -> Dict[str, Any]:
+        reader = cls.reader()
+        params = reader.get('params')
+        if not params:
+            raise ValueError("No nodes found in config file")
+        return params
+
+    @classmethod
+    def get_addr_params(cls, method: str) -> Optional[str]:
+        """params for address endpoint
+        Standard methods:
+        - basic # return address details without txs details
+        - txs # return address details with txs all details
+        - txsLight # return address details with txid and vin and vout
+        - txLight # return address details with txid only
+        """
+        params = cls.get_params()
+        addr = params.get('addr')
+        if not addr:
+            raise ValueError("No address params found in config file")
+        return addr.get(method)
+
+# Example Usage:
+# nodereader = NodeReader()
+# nodes = nodereader.get_nodes()
+# print(nodes)
+# addr_query = nodereader.get_query('address')
+# tx_query = nodereader.get_query('tx')
+# block_query = nodereader.get_query('block')
+# block_index_query = nodereader.get_query('blockIndex')
+# addr_params = nodereader.get_addr_params('basic')
+# tx_params = nodereader.get_addr_params('txs')
+# tx_light_params = nodereader.get_addr_params('txsLight')

app/config/node_reader.py

@@ -0,0 +1,21 @@
+{
+  "nodes": [
+    "https://bitcoin.atomicwallet.io/api/v2",
+    "https://btcbook.guarda.co/api/v2",
+    "https://btc1.trezor.io/api/v2"
+  ],
+  "query": {
+    "address": "address/",
+    "tx": "tx/",
+    "block": "block/",
+    "blockIndex": "block-index/"
+  },
+  "params": {
+    "addr": {
+      "basic": "?details=basic",
+      "txs": "?details=txs",
+      "txsLight": "?details=txslight",
+      "txLight": "?details=txlight"
+    }
+  }
+}

app/config/nodes.json

@@ -1,15 +1,26 @@
 from datetime import datetime
 from typing import Optional, Dict, Any
 from app.config.config_manager import config
+from app.config.node_reader import NodeReader
 from app.utils.api_client import make_request
 
+nr = NodeReader()
+base_urls = nr.get_nodes() # Get base urls List
+addr_query = nr.get_query('address')
+tx_query = nr.get_query('tx')
+block_query = nr.get_query('block')
+block_index_query = nr.get_query('blockIndex')
+params_basic = nr.get_addr_params('basic')
+params_txs = nr.get_addr_params('txs')
+params_txslight = nr.get_addr_params('txsLight')
+node_url = base_urls[0] # atomic = 0 | guarda = 1 | trezor = 2
+
+
 def get_address_details(address: str, page: int = 1, per_page: int = 10) -> Optional[Dict[str, Any]]:
     """Get address information with transaction details"""
     try:
-        # Get address details with full transactions
-        url = config.get_node_url('address') + address + config.get_node_suffix('address', 'txs')
+        url = f"{node_url}{addr_query}{address}{params_basic}"
         addr = make_request(url)
-
         if not addr:
             return None
 

app/controllers/address_controller.py

@@ -1,12 +1,18 @@
 from datetime import datetime
 from typing import Optional, Dict, Any
 from app.config.config_manager import config
+from app.config.node_reader import NodeReader
 from app.utils.api_client import make_request
 
+nr = NodeReader()
+nodes = nr.get_nodes()
+tx_query = nr.get_query('tx')
+basic_url = f"{nodes[0]}{tx_query}"
+
 def get_transaction_details(tx_hash: str) -> Optional[Dict[str, Any]]:
     """Get detailed transaction information"""
     try:
-        url = config.get_node_url('tx') + tx_hash
+        url = f"{basic_url}{tx_hash}?page=1"
         tx = make_request(url)
 
         if not tx: