Skip to content

docs: testnet address book instead of the dead seed; released rq-go and Rust SDK #14

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
a-ok123 merged 1 commit into from
Oct 9, 2026
Merged

docs: testnet address book instead of the dead seed; released rq-go and Rust SDK #14

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion cascade/concepts/erasure-coding.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Cascade uses RaptorQ, a fountain code standardized in [RFC 6330](https://www.rfc
3. Encoded symbols are distributed across SuperNodes.
4. Each SuperNode stores a subset of the symbols.

SuperNodes run the same encoding through [`rq-go`](https://pkg.go.dev/github.com/LumeraProtocol/rq-go), the official RaptorQ Go library.
SuperNodes run the same encoding through [`rq-go`](https://pkg.go.dev/lumera.build/rq-go), the official RaptorQ Go library.

## Decoding during download

Expand Down
2 changes: 1 addition & 1 deletion ecosystem.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Official SDKs, APIs, node software, and libraries for building applications on t
| [`sdk-go`](https://pkg.go.dev/github.com/LumeraProtocol/sdk-go) | Go SDK for gRPC queries, transactions, and protocol services. |
| [`sdk-rs`](/sdk/rust) | Rust SDK for server-side applications. |
| [`lumerad`](https://github.com/LumeraProtocol/lumera) | Official chain binary and CLI for developers and node operators. |
| [`rq-go`](https://pkg.go.dev/github.com/LumeraProtocol/rq-go) | Official Go implementation of RaptorQ (RFC 6330) erasure coding. |
| [`rq-go`](https://pkg.go.dev/lumera.build/rq-go) | Official Go implementation of RaptorQ (RFC 6330) erasure coding. |
| [LumeScope](/api/lumescope) | Read-only REST API for decoded protocol data, SuperNode metrics, and Action metadata. |

Start with the [JavaScript SDK](/sdk/javascript) or [Go SDK](/sdk/go). LumeScope endpoints are documented in the [API reference](/api/overview).
Expand Down
15 changes: 8 additions & 7 deletions networks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,12 +125,13 @@ Select a network below to view its chain parameters, genesis file, seed nodes, a

The claims file loaded into chain state at genesis is published next to it: [testnet-2/claims.csv](https://raw.githubusercontent.com/LumeraProtocol/lumera-networks/master/testnet-2/claims.csv).

### Seed Nodes
### Peers

Add the network seed node to the `[p2p]` section of `~/.lumera/config/config.toml`:
Testnet has no seed node. Download the address book that Lumera's snapshot service keeps current; your node dials peers from it:

```toml
seeds = "faff7c1350468c53121a669ac40e317a4a70c425@seeds.testnet.lumera.io:26656"
```bash
curl -fsSL -o ~/.lumera/config/addrbook.json \
https://snapshots.lumera.io/testnet/addrbook.json
```

### Minimum Gas Price
Expand All @@ -151,9 +152,9 @@ Select a network below to view its chain parameters, genesis file, seed nodes, a
curl -o ~/.lumera/config/genesis.json \
https://raw.githubusercontent.com/LumeraProtocol/lumera-networks/master/testnet-2/genesis.json

# Set seeds in config.toml
sed -i 's/seeds = ""/seeds = "faff7c1350468c53121a669ac40e317a4a70c425@seeds.testnet.lumera.io:26656"/' \
~/.lumera/config/config.toml
# Download the address book (testnet has no seed node)
curl -fsSL -o ~/.lumera/config/addrbook.json \
https://snapshots.lumera.io/testnet/addrbook.json

# Set gas price in app.toml
sed -i 's/minimum-gas-prices = ""/minimum-gas-prices = "0.025ulume"/' \
Expand Down
9 changes: 5 additions & 4 deletions sdk/raptorq.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@ Most developers interact with Cascade through the [SuperNode gRPC API](/api/grpc
| Linux | arm64 (including Raspberry Pi) |
| macOS | amd64 (Intel) |
| macOS | arm64 (Apple Silicon) |
| Windows | amd64 |

---

Expand All @@ -29,13 +28,15 @@ Most developers interact with Cascade through the [SuperNode gRPC API](/api/grpc
Add `rq-go` to your Go module.

```shell
go get github.com/LumeraProtocol/rq-go
go get lumera.build/rq-go@v0.3.0
```

The module path is `lumera.build/rq-go` from v0.3.0 on. Earlier versions were published as `github.com/LumeraProtocol/rq-go`; switch the import path when you upgrade.

Then import it in your source files.

```go
import "github.com/LumeraProtocol/rq-go"
import "lumera.build/rq-go"
```

---
Expand All @@ -51,7 +52,7 @@ import (
"fmt"
"os"

raptorq "github.com/LumeraProtocol/rq-go"
raptorq "lumera.build/rq-go"
)

func main() {
Expand Down
4 changes: 2 additions & 2 deletions sdk/rust-reference.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@ description: "Modules, settings, client surfaces, and helpers in the Lumera Rust

This page lists the public surface of the Rust SDK, `lumera-sdk-rs`. For a guided start see the [Rust SDK page](/sdk/rust).

The crate is `lumera-sdk-rs` and the library name is `lumera_sdk_rs`. It is at version `0.1.0` with no published releases, so add it from git rather than from crates.io.
The crate is [`lumera-sdk-rs`](https://crates.io/crates/lumera-sdk-rs) on crates.io and the library name is `lumera_sdk_rs`. Add it with `cargo add lumera-sdk-rs`. Release notes and source tarballs are in [Lumera releases](https://github.com/LumeraProtocol/releases/releases?q=sdk-rs).

<Note>
The crate is pre-1.0 and has no tagged releases. Pin a specific commit if you need a stable surface.
The crate is pre-1.0. Pin a version (for example `lumera-sdk-rs = "=0.1.0"`) if you need a stable surface.
</Note>

## Crate layout
Expand Down
2 changes: 1 addition & 1 deletion sdk/rust.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Because file transfers travel over HTTPS to SN-API, the SDK works from any machi
cargo init .

# Add the SDK and async runtime
cargo add lumera-sdk-rs --git https://github.com/LumeraProtocol/sdk-rs.git
cargo add lumera-sdk-rs
cargo add tokio --features full
```

Expand Down
2 changes: 1 addition & 1 deletion validators/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Run on testnet first. Testnet lets you rehearse the full setup with tokens that
| Chain ID | `lumera-testnet-2` |
| Denom | `ulume` (6 decimals, 1 LUME = 1,000,000 ulume) |
| Min gas price | `0.025ulume` |
| Seed node | `faff7c1350468c53121a669ac40e317a4a70c425@seeds.testnet.lumera.io:26656` |
| Peers | No seed node: download the address book from `https://snapshots.lumera.io/testnet/addrbook.json` |
| Genesis file | [testnet-2/genesis.json](https://raw.githubusercontent.com/LumeraProtocol/lumera-networks/master/testnet-2/genesis.json) |
| Public RPC | `https://lumera-testnet-rpc.polkachu.com` |
| Public API (LCD) | `https://lumera-testnet-api.polkachu.com` |
Expand Down
13 changes: 6 additions & 7 deletions validators/testnet/node-setup.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -123,22 +123,21 @@ jq -r .chain_id ~/.lumera/config/genesis.json

## Step 6. Configure the node

Set the [seed node](https://github.com/cosmos/chain-registry/blob/master/testnets/lumeratestnet/chain.json) and the minimum gas price.
Set the minimum gas price.

```bash
SEEDS="faff7c1350468c53121a669ac40e317a4a70c425@seeds.testnet.lumera.io:26656"

sed -i "s|^seeds *=.*|seeds = \"$SEEDS\"|" "$HOME/.lumera/config/config.toml"
sed -i "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.025ulume\"|" "$HOME/.lumera/config/app.toml"
```

Load a maintained [address book](https://www.polkachu.com/testnets/lumera/addrbooks) so a new node has peers to dial if the seed is unreachable.
Testnet has no seed node. Load the address book that Lumera's snapshot service keeps current, so a new node has peers to dial:

```bash
curl -fsSL -o "$HOME/.lumera/config/addrbook.json" \
https://snapshots.polkachu.com/testnet-addrbook/lumera/addrbook.json
https://snapshots.lumera.io/testnet/addrbook.json
```

Polkachu publishes another one at `https://snapshots.polkachu.com/testnet-addrbook/lumera/addrbook.json`.

Enable pruning so disk usage stays under control. Skip this only if you specifically need an archive node.

```bash
Expand Down Expand Up @@ -405,7 +404,7 @@ curl -fsSL localhost:26657/net_info | jq -r '.result.n_peers'
```

<Note>
If zero peers persists, check the logs. `Couldn't connect to any seeds` with `connection refused` means the seed is down. In that case, stop the node, refresh `seeds` from the [chain-registry](https://github.com/cosmos/chain-registry/blob/master/testnets/lumeratestnet/chain.json), install a current addrbook, then start it again. `config.toml` is only read at startup, so edits do nothing until you restart.
If zero peers persists, the address book is probably stale. Stop the node, download a current one (`https://snapshots.lumera.io/testnet/addrbook.json`), then start it again. If `config.toml` still lists `seeds` from an older setup, clear them: testnet has no seed node, and `config.toml` is only read at startup.
</Note>

## Verification checklist
Expand Down
Loading