Skip to content

Commit

Permalink
Add info about community nodes
Browse files Browse the repository at this point in the history
  • Loading branch information
danieljperry committed Jan 28, 2025
1 parent c126baf commit 09e5838
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 0 deletions.
4 changes: 4 additions & 0 deletions docs/resources/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -441,6 +441,10 @@ The light wallet protocol has two techniques to sync:

Typically, it is much faster to sync a wallet by connecting to a trusted node. Therefore, if you have access to a synced node that you trust, you may want to add that node to your trusted peers list. _We recommend that you only add your own full nodes to this list_.

### How can I connect to a community node instead of farming with my own full node?

Unfortunately, connecting to a community node is not secure, and we therefore never recommend doing so. See our [node syncing guide](https://docs.chia.net/troubleshooting/node-syncing/#community-nodes) for more info.

#### Prerequisites

1. Chia needs to be version 1.3.0 or later on all computers
Expand Down
24 changes: 24 additions & 0 deletions docs/troubleshooting/node-syncing.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,3 +91,27 @@ Setting up a VPN used to be a daunting task, but [Wireguard](https://www.wiregua
- the home server is configured to route all internet traffic (but not local) through the cloud server, while periodically sending a "keepalive" packet to ensure the connection stays open.

Here is a more detailed write-up with [example wireguard configuration](https://www.kmr.me/posts/wireguard/).

## Community Nodes

:::warning

We **never** recommend connecting to a community node. This section will detail why.

:::

A "community node" (AKA an untrusted node) is a node that other farmers can connect to, in order to avoid having to run their own full node.

While this may seem like a convenient setup, community nodes are inherently not secure, and we therefore never recommend connecting to them. The primary issue is that the community node can steal farmer rewards. The reason for this is because the farmer service was created with the security assumption that it would only connect to a local/trusted node.

This means that:

- The farmer never verifies anything that the node puts into a block
- The farmer blind-signs whatever the node sends it
- The farmer doesn't verify the reward address
- The community node can therefore modify the reward address before the farmer signs a block
- Any modifications we could make to the farmer would have widespread ripple effects to the rest of the node software, so we won't support any such modifications

In summary, if you farm using a community node, that node can steal all of your farming rewards as you earn them. The way to avoid this scenario is to run your own node.

Luckily, a high-powered system is not required to run a Chia node. In fact, the [minimum supported node hardware](https://docs.chia.net/coin-set-costs/#farming-spec) is the Raspberry Pi with a cheap external SSD to hold the database file. In order to expedite the process of syncing your full node, you can download a [database checkpoint](https://www.chia.net/downloads/#database-checkpoint).

0 comments on commit 09e5838

Please sign in to comment.