Fix balance tracker so that it can be run standalone in addition to just

as part of hafbe

.env.example

@@ -114,8 +114,19 @@ NETWORK_NAME=haf
 # REPUTATION_TRACKER_VERSION=${HIVE_API_NODE_VERSION}
 
 
-# REPTRACKER_SCHEMA="hafbe-rt"
-# BTRACKER_SCHEMA="hafbe-bt"
+# There are two ways of running Balance Tracker: as a standalone app, or
+# integrated with HAF Block Explorer.  While you can technically run both,
+# there's no good reason to do so--you'll just waste disk space and processing
+# power maintaining two copies of the data.
+# Regardless of which way you decide to run Balance Tracker, you will need
+# to run a single API server, and it needs to know which schema the data is
+# stored in.  It will be in "hafbe_bal" if you're running HAF Block Explorer,
+# and "btracker_app" if you're running Balance Tracker standalone.
+# The default behavior is to serve data from the HAF Block Explorer, but 
+# if you're only running the standalone Balance Tracker, uncomment the next
+# line:
+# BTRACKER_SCHEMA="btracker_app"
+ 
 # The default setup will run the recommended version of HAF block explorer,
 # you can run a custom version by un-commenting and modifying the
 # values below

balance_tracker.yaml

+# Note, most of the services in this file are only used in the uncommon case where
+# the node is running Balance Tracker standalone.  Balance Tracker is typically
+# run as part of HAF Block Explorer, and the services related to that usage are
+# in haf_block_explorer.yaml.
+# The exception is the postgrest server & rewriter.  Those are shared between the two
 services:
   balance-tracker-install:
     image: ${BALANCE_TRACKER_IMAGE:-${HIVE_API_NODE_REGISTRY:-registry.hive.blog}/balance_tracker}:${BALANCE_TRACKER_VERSION:-${HIVE_API_NODE_VERSION}}
     profiles:
-      - apps
-      - hafbe
-      - balance-tracker-setup
+      - balance-tracker-standalone
     environment:
       POSTGRES_HOST: haf
     networks:
       haf-network:
     command:
       - install_app
-      - --schema=${BTRACKER_SCHEMA:-hafbe_bal}
+      - --schema=btracker_app
       - --swagger-url=${PUBLIC_HOSTNAME}
     depends_on:
       haf:
         condition: service_healthy
+  # to uninstall Balance Tracker (standalone), shut down the stack and run a command like:
+  #   docker compose --profile core --profile balance-tracker-standalone-uninstall up -d
   balance-tracker-uninstall:
     image: ${BALANCE_TRACKER_IMAGE:-${HIVE_API_NODE_REGISTRY:-registry.hive.blog}/balance_tracker}:${BALANCE_TRACKER_VERSION:-${HIVE_API_NODE_VERSION}}
     profiles:
-      - balance-tracker-uninstall
+      - balance-tracker-standalone-uninstall
     environment:
       POSTGRES_HOST: haf
     networks:
       haf-network:
     command:
       - uninstall_app
-      - --schema=${BTRACKER_SCHEMA:-hafbe_bal}
+      - --schema=btracker_app
     depends_on:
       haf:
         condition: service_healthy
@@ -41,7 +46,7 @@ services:
       haf-network:
     command:
       - process_blocks
-      - --schema=${BTRACKER_SCHEMA:-hafbe_bal}
+      - --schema=btracker_app
     healthcheck:
       test: ["CMD-SHELL","/app/block-processing-healthcheck.sh"]
       interval: 60s
@@ -80,6 +85,10 @@ services:
     depends_on:
       balance-tracker-install:
         condition: service_completed_successfully
+        required: false # allow this service to be missing (when only running hafbe)
+      block-explorer-install-balance-tracker:
+        condition: service_completed_successfully
+        required: false # allow this service to be missing (when only running standalone)
       haf:
         condition: service_healthy
   balance-tracker-postgrest-rewriter:

haf_base.yaml

@@ -43,6 +43,7 @@ services:
         host    haf_block_log    haf_admin        ${COMPOSE_PROJECT_NAME}-block-explorer-uninstall-1.${NETWORK_NAME}            trust\n
         host    haf_block_log    hafbe_owner      ${COMPOSE_PROJECT_NAME}-block-explorer-uninstall-1.${NETWORK_NAME}            trust\n
         host    haf_block_log    haf_admin        ${COMPOSE_PROJECT_NAME}-block-explorer-uninstall-balance-tracker-1.${NETWORK_NAME}           trust\n
+        host    haf_block_log    haf_admin        ${COMPOSE_PROJECT_NAME}-block-explorer-install-balance-tracker-1.${NETWORK_NAME}             trust\n
         host    haf_block_log    haf_admin        ${COMPOSE_PROJECT_NAME}-block-explorer-uninstall-reputation-tracker-1.${NETWORK_NAME}        trust\n
 
 

haf_block_explorer.yaml

@@ -14,12 +14,14 @@ services:
     depends_on:
       haf:
         condition: service_healthy
-      balance-tracker-install:
+      block-explorer-install-balance-tracker:
         condition: service_completed_successfully
       hafah-install:
         condition: service_completed_successfully
       reputation-tracker-install:
         condition: service_completed_successfully
+  # to uninstall HAF Block Explorer, shut down the stack and run a command like:
+  #   docker compose --profile core --profile block-explorer-uninstall up -d
   block-explorer-uninstall:
     image: ${HAF_BLOCK_EXPLORER_IMAGE:-${HIVE_API_NODE_REGISTRY:-registry.hive.blog}/haf_block_explorer}:${HAF_BLOCK_EXPLORER_VERSION:-${HIVE_API_NODE_VERSION}}
     profiles:
@@ -33,6 +35,22 @@ services:
     depends_on:
       haf:
         condition: service_healthy
+  block-explorer-install-balance-tracker:
+    image: ${BALANCE_TRACKER_IMAGE:-${HIVE_API_NODE_REGISTRY:-registry.hive.blog}/balance_tracker}:${BALANCE_TRACKER_VERSION:-${HIVE_API_NODE_VERSION}}
+    profiles:
+      - apps
+      - hafbe
+    environment:
+      POSTGRES_HOST: haf
+    networks:
+      haf-network:
+    command:
+      - install_app
+      - --schema=hafbe_bal
+      - --swagger-url=${PUBLIC_HOSTNAME}
+    depends_on:
+      haf:
+        condition: service_healthy
   block-explorer-uninstall-balance-tracker:
     image: ${BALANCE_TRACKER_IMAGE:-${HIVE_API_NODE_REGISTRY:-registry.hive.blog}/balance_tracker}:${BALANCE_TRACKER_VERSION:-${HIVE_API_NODE_VERSION}}
     profiles:
@@ -43,6 +61,7 @@ services:
       haf-network:
     command:
       - uninstall_app
+      - --schema=hafbe_bal
     depends_on:
       block-explorer-uninstall:
         condition: service_completed_successfully
@@ -100,7 +119,7 @@ services:
       PGRST_DB_POOL: 20
       PGRST_DB_POOL_ACQUISITION_TIMEOUT: 10
       PGRST_DB_ROOT_SPEC: root
-      PGRST_DB_EXTRA_SEARCH_PATH: ${BTRACKER_SCHEMA:-hafbe_bal}, ${REPTRACKER_SCHEMA:-reptracker_app}
+      PGRST_DB_EXTRA_SEARCH_PATH: hafbe_bal, reptracker_app
       # PGRST_OPENAPI_SERVER_PROXY_URI: http://${PUBLIC_HOSTNAME}/hafbe_api/
     networks:
       haf-network: