From 812a78023fc31db3413fff79d236db967ec1fae0 Mon Sep 17 00:00:00 2001 From: hcastc00 Date: Thu, 11 Dec 2025 13:04:04 +0100 Subject: [PATCH 1/4] Fix URLs and set standard 6060 port --- README.md | 11 ++++++----- dappnode_package.json | 18 +++++++++++++----- docker-compose.yml | 4 ++-- getting-started.yml | 8 ++++---- package_variants/sepolia/dappnode_package.json | 6 +++--- 5 files changed, 28 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 97eda75..6ae5b99 100644 --- a/README.md +++ b/README.md @@ -51,11 +51,11 @@ During installation, you'll need to configure: ## 🌐 Network Variants This package supports multiple StarkNet networks: + | Network | Package | RPC Port | Monitor Port | RPC Endpoint | WebSocket Endpoint | |-----------|-------------------------------------|----------|--------------|---------------------------------------------|-----------------------------------------------------| -| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 9545 | 9547 | http://pathfinder.dappnode:9545/ | ws://pathfinder.dappnode:9546/ws | -| **Sepolia** | `pathfinder-sepolia.dappnode.eth` | 9555 | 9557 | http://pathfinder-sepolia.dappnode:9555/ | ws://pathfinder-sepolia.dappnode:9556/ws | - +| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 6060 | 9547 | | ws://pathfinder.dappnode:6061/ws | +| **Sepolia** | `pathfinder-sepolia.dappnode.eth` | 9555 | 9557 | | ws://pathfinder-sepolia.dappnode:9556/ws | > **Note**: The Monitor port is used for metrics and health check endpoints for monitoring and observability. @@ -70,7 +70,7 @@ The Pathfinder node exposes a StarkNet JSON-RPC API compatible with the official curl -X POST \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"starknet_blockNumber","params":[],"id":1}' \ - http://pathfinder.dappnode:9545/ + http://pathfinder.dappnode:6060/ # Sepolia - Get chain ID curl -X POST \ @@ -95,7 +95,7 @@ The package includes a Grafana dashboard for monitoring: - **Base Image**: `eqlabs/pathfinder` - **Exposed Ports**: - - **Mainnet**: `9545` (JSON-RPC), `9547` (Monitor) + - **Mainnet**: `6060` (JSON-RPC), `9547` (Monitor) - **Sepolia**: `9555` (JSON-RPC), `9557` (Monitor) - **Data Persistence**: Node data stored in persistent Docker volume - **Environment Variables**: @@ -132,6 +132,7 @@ The package includes a Grafana dashboard for monitoring: ### Logs Access View logs through the DAppNode interface: + 1. Go to Packages → Pathfinder 2. Click on "Logs" tab 3. Adjust log level in configuration if needed diff --git a/dappnode_package.json b/dappnode_package.json index 878a7c8..eda08b8 100644 --- a/dappnode_package.json +++ b/dappnode_package.json @@ -4,19 +4,27 @@ "description": "Pathfinder - Starknet Node Client", "type": "service", "author": "DAppNode Association (https://github.com/dappnode)", - "categories": ["Developer tools", "Blockchain"], - "keywords": ["starknet"], - "architectures": ["linux/amd64", "linux/arm64"], + "categories": [ + "Developer tools", + "Blockchain" + ], + "keywords": [ + "starknet" + ], + "architectures": [ + "linux/amd64", + "linux/arm64" + ], "upstreamArg": "UPSTREAM_VERSION", "upstreamVersion": "v0.21.2", "upstreamRepo": "eqlabs/pathfinder", "links": { "homepage": "https://github.com/dappnode/DAppNodePackage-pathfinder-generic", - "api": "http://pathfinder.dappnode:9545/" + "api": "http://pathfinder.dappnode:6060/" }, "repository": { "type": "git", "url": "https://github.com/dappnode/DAppNodePackage-pathfinder-generic" }, "license": "GPL-3.0" -} +} \ No newline at end of file diff --git a/docker-compose.yml b/docker-compose.yml index 526fc60..2354aea 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -12,8 +12,8 @@ services: RUST_LOG: info PATHFINDER_DB_DIR: /usr/share/pathfinder/data PATHFINDER_WEBSOCKET_ENABLED: "true" - PATHFINDER_HTTP_RPC_ADDRESS: 0.0.0.0:9545 - PATHFINDER_WS_RPC_ADDRESS: 0.0.0.0:9546 + PATHFINDER_HTTP_RPC_ADDRESS: 0.0.0.0:6060 + PATHFINDER_WS_RPC_ADDRESS: 0.0.0.0:6061 PATHFINDER_MONITOR_ADDRESS: 0.0.0.0:9547 volumes: - pathfinder-data:/usr/share/pathfinder/data diff --git a/getting-started.yml b/getting-started.yml index eec382b..3480f5f 100644 --- a/getting-started.yml +++ b/getting-started.yml @@ -29,7 +29,7 @@ This package supports multiple StarkNet networks: | Network | Package | RPC Port | Monitor Port | RPC Endpoint | WebSocket Endpoint | |---------|---------|----------|----------------|--------------|--------------|-------------------| -| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 9545 | 9547 | `http://pathfinder.dappnode:9545/` | `ws://pathfinder.dappnode:9545/ws` | +| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 6060 | 9547 | `http://pathfinder.dappnode:6060/` | `ws://pathfinder.dappnode:6060/ws` | | **Sepolia** | `pathfinder-sepolia.dappnode.eth` | 9555 | 9557 | `http://pathfinder-sepolia.dappnode:9555/` | `ws://pathfinder-sepolia.dappnode:9555/ws` | > **Note**: The Monitor port is used for metrics and health check endpoints for monitoring and observability. @@ -45,7 +45,7 @@ The Pathfinder node exposes a StarkNet JSON-RPC API compatible with the official curl -X POST \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"starknet_blockNumber","params":[],"id":1}' \ - http://pathfinder.dappnode:9545/ + http://pathfinder.dappnode:6060/ # Sepolia - Get chain ID curl -X POST \ @@ -58,7 +58,7 @@ curl -X POST \ ```javascript // Mainnet WebSocket -const wsMainnet = new WebSocket('ws://pathfinder.dappnode:9545/ws'); +const wsMainnet = new WebSocket('ws://pathfinder.dappnode:6060/ws'); // Sepolia WebSocket const wsSepolia = new WebSocket('ws://pathfinder-sepolia.dappnode:9555/ws'); @@ -89,7 +89,7 @@ The package includes a Grafana dashboard for monitoring: - **Base Image**: `eqlabs/pathfinder` - **Exposed Ports**: - - **Mainnet**: `9545` (JSON-RPC), `9547` (Monitor) + - **Mainnet**: `6060` (JSON-RPC), `9547` (Monitor) - **Sepolia**: `9555` (JSON-RPC), `9557` (Monitor) - **Data Persistence**: Node data stored in persistent Docker volume - **Environment Variables**: diff --git a/package_variants/sepolia/dappnode_package.json b/package_variants/sepolia/dappnode_package.json index 6d00e27..f7767d9 100644 --- a/package_variants/sepolia/dappnode_package.json +++ b/package_variants/sepolia/dappnode_package.json @@ -3,8 +3,8 @@ "version": "0.1.0", "shortDescription": "Pathfinder - StarkNet full node in Sepolia", "links": { - "RPC": "http://pathfinder-sepolia.dappnode:9545/", - "WS": "ws://pathfinder-sepolia.dappnode:9545/ws" + "RPC": "http://pathfinder-sepolia.dappnode:6060/", + "WS": "ws://pathfinder-sepolia.dappnode:6060/ws" }, "exposable": [ { @@ -18,4 +18,4 @@ "port": 9556 } ] -} +} \ No newline at end of file From a7d1b09ddfb54f8c20300c666733c0a692d43603 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9ctor?= <47385090+hcastc00@users.noreply.github.com> Date: Mon, 15 Dec 2025 11:58:47 +0100 Subject: [PATCH 2/4] Update getting-started.yml --- getting-started.yml | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/getting-started.yml b/getting-started.yml index 3480f5f..f35f580 100644 --- a/getting-started.yml +++ b/getting-started.yml @@ -29,8 +29,8 @@ This package supports multiple StarkNet networks: | Network | Package | RPC Port | Monitor Port | RPC Endpoint | WebSocket Endpoint | |---------|---------|----------|----------------|--------------|--------------|-------------------| -| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 6060 | 9547 | `http://pathfinder.dappnode:6060/` | `ws://pathfinder.dappnode:6060/ws` | -| **Sepolia** | `pathfinder-sepolia.dappnode.eth` | 9555 | 9557 | `http://pathfinder-sepolia.dappnode:9555/` | `ws://pathfinder-sepolia.dappnode:9555/ws` | +| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 6060 | 9547 | `http://pathfinder.dappnode:6060/` | `ws://pathfinder.dappnode:6061/` | +| **Sepolia** | `pathfinder-sepolia.dappnode.eth` | 6060 | 9547 | `http://pathfinder-sepolia.dappnode:6060/` | `ws://pathfinder-sepolia.dappnode:6061/` | > **Note**: The Monitor port is used for metrics and health check endpoints for monitoring and observability. @@ -51,17 +51,17 @@ curl -X POST \ curl -X POST \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"starknet_chainId","params":[],"id":1}' \ - http://pathfinder-sepolia.dappnode:9555/ + http://pathfinder-sepolia.dappnode:6060/ ``` ### WebSocket Interface ```javascript // Mainnet WebSocket -const wsMainnet = new WebSocket('ws://pathfinder.dappnode:6060/ws'); +const wsMainnet = new WebSocket('ws://pathfinder.dappnode:6060/'); // Sepolia WebSocket -const wsSepolia = new WebSocket('ws://pathfinder-sepolia.dappnode:9555/ws'); +const wsSepolia = new WebSocket('ws://pathfinder-sepolia.dappnode:6061/'); wsMainnet.onopen = function() { wsMainnet.send(JSON.stringify({ @@ -88,9 +88,6 @@ The package includes a Grafana dashboard for monitoring: ### Docker Configuration - **Base Image**: `eqlabs/pathfinder` -- **Exposed Ports**: - - **Mainnet**: `6060` (JSON-RPC), `9547` (Monitor) - - **Sepolia**: `9555` (JSON-RPC), `9557` (Monitor) - **Data Persistence**: Node data stored in persistent Docker volume - **Environment Variables**: - `PATHFINDER_ETHEREUM_API_URL`: L1 Ethereum node URL @@ -167,6 +164,6 @@ This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) --- -**Made with ❤️ by the DAppNode community** +**Made with ❤️ by the DAppNode Association** -For support, join our [Discord](https://discord.gg/dappnode) or visit our [forum](https://discourse.dappnode.io/). +For support, join our [Discord](https://discord.gg/dappnode). From c8304544ce06149d069744a8a3a3a5febe4b16d4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9ctor?= <47385090+hcastc00@users.noreply.github.com> Date: Mon, 15 Dec 2025 12:03:03 +0100 Subject: [PATCH 3/4] Update README.md --- README.md | 24 +++++------------------- 1 file changed, 5 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 6ae5b99..1535116 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,6 @@ A DAppNode package for running [Pathfinder](https://github.com/eqlabs/pathfinder - **JSON-RPC API**: Access StarkNet through standard JSON-RPC endpoints - **WebSocket Support**: Real-time data access via WebSocket connections - **Easy Configuration**: Simple setup wizard for network configuration -- **Grafana Dashboard**: Built-in monitoring dashboard for node metrics - **Multi-Architecture**: Supports both AMD64 and ARM64 architectures ## 📋 Prerequisites @@ -54,8 +53,8 @@ This package supports multiple StarkNet networks: | Network | Package | RPC Port | Monitor Port | RPC Endpoint | WebSocket Endpoint | |-----------|-------------------------------------|----------|--------------|---------------------------------------------|-----------------------------------------------------| -| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 6060 | 9547 | | ws://pathfinder.dappnode:6061/ws | -| **Sepolia** | `pathfinder-sepolia.dappnode.eth` | 9555 | 9557 | | ws://pathfinder-sepolia.dappnode:9556/ws | +| **Mainnet** | `pathfinder.dnp.dappnode.eth` | 6060 | 9547 | | ws://pathfinder.dappnode:6061/ | +| **Sepolia** | `pathfinder-sepolia.dappnode.eth` | 6060 | 9547 | | ws://pathfinder-sepolia.dappnode:6061/ | > **Note**: The Monitor port is used for metrics and health check endpoints for monitoring and observability. @@ -76,27 +75,14 @@ curl -X POST \ curl -X POST \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"starknet_chainId","params":[],"id":1}' \ - http://pathfinder-sepolia.dappnode:9555/ + http://pathfinder-sepolia.dappnode:6060/ ``` -## 📊 Monitoring - -The package includes a Grafana dashboard for monitoring: - -- Node synchronization status -- Block height and sync progress -- RPC call metrics -- Resource usage (CPU, memory, disk) -- Network connectivity - ## 🐳 Technical Details ### Docker Configuration - **Base Image**: `eqlabs/pathfinder` -- **Exposed Ports**: - - **Mainnet**: `6060` (JSON-RPC), `9547` (Monitor) - - **Sepolia**: `9555` (JSON-RPC), `9557` (Monitor) - **Data Persistence**: Node data stored in persistent Docker volume - **Environment Variables**: - `PATHFINDER_ETHEREUM_API_URL`: L1 Ethereum node URL @@ -174,6 +160,6 @@ This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) --- -**Made with ❤️ by the DAppNode community** +**Made with ❤️ by the DAppNode Association** -For support, join our [Discord](https://discord.gg/dappnode) or visit our [forum](https://discourse.dappnode.io/). +For support, join our [Discord](https://discord.gg/dappnode). From 51ee9db00d2e59bd09da18e0cca9bc5a48b8a698 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9ctor?= <47385090+hcastc00@users.noreply.github.com> Date: Mon, 15 Dec 2025 12:03:56 +0100 Subject: [PATCH 4/4] Update dappnode_package.json --- package_variants/sepolia/dappnode_package.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/package_variants/sepolia/dappnode_package.json b/package_variants/sepolia/dappnode_package.json index f7767d9..2bc3ec5 100644 --- a/package_variants/sepolia/dappnode_package.json +++ b/package_variants/sepolia/dappnode_package.json @@ -4,18 +4,18 @@ "shortDescription": "Pathfinder - StarkNet full node in Sepolia", "links": { "RPC": "http://pathfinder-sepolia.dappnode:6060/", - "WS": "ws://pathfinder-sepolia.dappnode:6060/ws" + "WS": "ws://pathfinder-sepolia.dappnode:6061/" }, "exposable": [ { "name": "Pathfinder Sepolia RPC", "description": "JSON RPC endpoint for Pathfinder Sepolia", - "port": 9555 + "port": 6060 }, { "name": "Pathfinder Sepolia WebSocket", "description": "WebSocket RPC endpoint for StarkNet Sepolia", - "port": 9556 + "port": 6061 } ] -} \ No newline at end of file +}