Skip to content

Commit bfb417f

Browse files
committed
docs/node/run-your-node: Further improve Steteless Client Node docs
1 parent 4081318 commit bfb417f

1 file changed

Lines changed: 29 additions & 5 deletions

File tree

‎docs/node/run-your-node/paratime-client-node.mdx‎

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,12 @@ accessible on the internet (for `TCP` and `UDP` traffic).
7878

7979
### Stateless Client Node (optional)
8080

81+
:::info
82+
83+
Stateless client is still in early stage, and thus not suitable for use cases where you need high availability.
84+
85+
:::
86+
8187
Client node requires sufficient disk space and must wait for state synchronization.
8288
A stateless client node avoids these problems by fetching the state and light blocks via configured gRPC endpoints
8389
(provider node addresses) and using a light client to verify the data against state roots from block headers.
@@ -97,12 +103,30 @@ consensus:
97103
# Add more node addresses as needed
98104
```
99105

100-
See the [State Sync](./advanced/sync-node-using-state-sync.md) documentation for configuring trusted period, height and
101-
hash for the light client.
106+
We recommend configuring a recent trust root (e.g. 1000 blocks old), that is younger than your providers last retained
107+
height, taking their pruning into account.
108+
109+
:::info
110+
111+
See the [State Sync](./advanced/sync-node-using-state-sync.md) documentation for more info on configuring trusted
112+
period, height and hash for the light client.
113+
114+
:::
115+
116+
The provider address can be a domain name, IP of a node on the network, or a path to the socket of a local node.
117+
To ensure compatibility, all provider nodes specified must be running the latest version of Oasis Core.
118+
119+
:::note
120+
121+
Make sure you allow all the methods listed in [this example](../grpc.mdx#envoy) in your gRPC proxy for Oasis node.
122+
123+
:::
124+
125+
:::tip
102126

103-
To ensure compatibility, all provider nodes specified must be running the latest version of Oasis Core. The provider
104-
address contains the `oasis1` prefix. It can also be an IP of a node on the network, or a path to the socket of a local
105-
node.
127+
You can use `grpc.oasis.io:443` or `grpc.testnet.oasis.io:443` as provider addresses for Mainnet and Testnet.
128+
129+
:::
106130

107131
### TEE ParaTime Client Node (optional)
108132

0 commit comments

Comments
 (0)