Fix Soroban external URL and improve PandoTx configuration

Major improvements to Soroban and PandoTx functionality:

• Replace soroban-announce boolean with union type for cleaner UX
• PandoTx Process option now only appears when Soroban announce is enabled
• Add dynamic hostname loading for Soroban external URLs
• Fix empty external URL logs during startup
• Improve health check robustness (300s timeout, 30 retries)
• Add .onion suffix handling for hostname files
• Fix Docker entrypoint hostname file creation
• Remove static hostname reading that failed before Tor startup

Resolves issues with confusing UI, empty URLs, and startup timing problems.

Author: linkinparkrulz

check-soroban.sh

@@ -39,11 +39,16 @@ if [ "$SOROBAN_ANNOUNCE" == "on" ]; then
     exit 61
   fi
 
+  # Add .onion suffix if missing
+  if [[ "$ONION_HOSTNAME" != *.onion ]]; then
+    ONION_HOSTNAME="${ONION_HOSTNAME}.onion"
+  fi
+  
   # Try to reach the RPC endpoint through the onion service
   RPC_API_URL="http://${ONION_HOSTNAME}/rpc"
   SOROBAN_ANNOUNCE_KEY=$([[ "$COMMON_BTC_NETWORK" == "testnet" ]] && echo "$SOROBAN_ANNOUNCE_KEY_TEST" || echo "$SOROBAN_ANNOUNCE_KEY_MAIN")
 
-  if ! curl -s -f --max-time 15 --retry 1 --retry-delay 5 \
+  if ! curl -s -f --max-time 300 --retry 30 --retry-delay 10 \
     -X POST -H 'Content-Type: application/json' \
     -d "{ \"jsonrpc\": \"2.0\", \"id\": 42, \"method\":\"directory.List\", \"params\": [{ \"Name\": \"$SOROBAN_ANNOUNCE_KEY\"}] }" \
     --proxy socks5h://localhost:9050 "$RPC_API_URL" > /dev/null 2>&1; then

config.env

@@ -67,11 +67,18 @@ export EXPLORER_INSTALL=on
 
 # Soroban configuration
 export SOROBAN_INSTALL=on
-export SOROBAN_ANNOUNCE=$(yq e '.soroban-announce' /root/start9/config.yaml | sed 's/true/on/; s/false/off/')
+SOROBAN_ANNOUNCE_CONFIG=$(yq e '.soroban-announce' /root/start9/config.yaml)
+if [ "$SOROBAN_ANNOUNCE_CONFIG" == "enabled" ]; then
+    export SOROBAN_ANNOUNCE=on
+    # PandoTx Process is only available when Soroban announce is enabled
+    export NODE_PANDOTX_PROCESS=$(yq e '.soroban-announce.pandotx-process' /root/start9/config.yaml | sed 's/true/on/; s/false/off/')
+else
+    export SOROBAN_ANNOUNCE=off
+    export NODE_PANDOTX_PROCESS=off
+fi
 
-# PandoTx configuration
+# PandoTx configuration (push is always available)
 export NODE_PANDOTX_PUSH=$(yq e '.pandotx-push' /root/start9/config.yaml | sed 's/true/on/; s/false/off/')
-export NODE_PANDOTX_PROCESS=$(yq e '.pandotx-process' /root/start9/config.yaml | sed 's/true/on/; s/false/off/')
 export NODE_PANDOTX_NB_RETRIES=$(yq e '.pandotx-retries' /root/start9/config.yaml)
 export NODE_PANDOTX_FALLBACK_MODE=$(yq e '.pandotx-fallback-mode' /root/start9/config.yaml)
 

docker_entrypoint.sh

@@ -133,42 +133,40 @@ data:
     masked: true
 EOF
 
-# Start node
-if [ "$COMMON_BTC_NETWORK" = "testnet" ]; then
-	cp /home/node/app/static/admin/conf/index-testnet.js /home/node/app/static/admin/conf/index.js
-	ln -sf /etc/nginx/sites-available/testnet.conf /etc/nginx/sites-enabled/dojo.conf
-else
-	cp /home/node/app/static/admin/conf/index-mainnet.js /home/node/app/static/admin/conf/index.js
-	ln -sf /etc/nginx/sites-available/mainnet.conf /etc/nginx/sites-enabled/dojo.conf
-fi
-
-/home/node/app/wait-for-it.sh 127.0.0.1:3306 --timeout=720 --strict -- pm2-runtime -u node --raw /home/node/app/pm2.config.cjs &
-backend_process=$!
-
-# Start nginx
-/home/node/app/wait-for-it.sh 127.0.0.1:8080 --timeout=720 --strict -- nginx &
-frontend_process=$!
-
 # Start Soroban if enabled
 if [ "$SOROBAN_INSTALL" == "on" ]; then
     echo "Starting Soroban service..."
 
     # Create Soroban onion directory if announce is enabled
     if [ "$SOROBAN_ANNOUNCE" == "on" ]; then
+        # Create and set up Tor directory for Soroban
         mkdir -p /var/lib/tor/hsv3soroban
-        echo "soroban$(date +%s).onion" > /var/lib/tor/hsv3soroban/hostname
+        # Create empty hostname file that Tor will populate when ready
+        touch /var/lib/tor/hsv3soroban/hostname
+        chown -R soroban:soroban /var/lib/tor/hsv3soroban
+        chmod 755 /var/lib/tor/hsv3soroban
+        chmod 644 /var/lib/tor/hsv3soroban/hostname
     fi
 
     # Start Soroban as the soroban user
     su -s /bin/bash soroban -c '/usr/local/bin/soroban-restart.sh' &
     soroban_process=$!
     echo "Soroban started with PID: $soroban_process"
+
 else
     echo "Soroban is disabled (SOROBAN_INSTALL=$SOROBAN_INSTALL)"
     soroban_process=""
 fi
 
-echo 'All processes initalized'
+# Start node services
+/home/node/app/wait-for-it.sh 127.0.0.1:3306 --timeout=720 --strict -- pm2-runtime -u node --raw /home/node/app/pm2.config.cjs &
+backend_process=$!
+
+# Start nginx
+/home/node/app/wait-for-it.sh 127.0.0.1:8080 --timeout=720 --strict -- nginx &
+frontend_process=$!
+
+echo 'All processes initialized'
 
 # SIGTERM HANDLING
 trap _term SIGTERM

scripts/procedures/getConfig.ts

@@ -139,11 +139,31 @@ export const getConfig: T.ExpectedExports.getConfig = compat.getConfig({
     },
   },
   "soroban-announce": {
-    "type": "boolean",
+    "type": "union",
     "name": "Soroban Network Announce",
-    "description": "Announce this node to the Soroban network (allows processing others' transactions)",
-    "nullable": false,
-    "default": false,
+    "description": "Configure Soroban network participation",
+    "tag": {
+      "id": "enabled",
+      "name": "Soroban Network Announce",
+      "variant-names": {
+        "disabled": "Disabled",
+        "enabled": "Enabled"
+      },
+      "description": "Enable to participate in the Soroban network"
+    },
+    "default": "disabled",
+    "variants": {
+      "disabled": {},
+      "enabled": {
+        "pandotx-process": {
+          "type": "boolean",
+          "name": "PandoTx Process",
+          "description": "Process and relay transactions from other Soroban nodes",
+          "nullable": false,
+          "default": false
+        }
+      }
+    }
   },
   "pandotx-push": {
     "type": "boolean",
@@ -152,13 +172,6 @@ export const getConfig: T.ExpectedExports.getConfig = compat.getConfig({
     "nullable": false,
     "default": true,
   },
-  "pandotx-process": {
-    "type": "boolean",
-    "name": "PandoTx Process",
-    "description": "Process and relay transactions from other Soroban nodes (requires Network Announce)",
-    "nullable": false,
-    "default": false,
-  },
   "pandotx-retries": {
     "type": "number",
     "name": "PandoTx Retries",