diff --git a/cascade/concepts/erasure-coding.mdx b/cascade/concepts/erasure-coding.mdx index d21bdb3..a8bce48 100644 --- a/cascade/concepts/erasure-coding.mdx +++ b/cascade/concepts/erasure-coding.mdx @@ -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 diff --git a/ecosystem.mdx b/ecosystem.mdx index c7ce01c..2ab8096 100644 --- a/ecosystem.mdx +++ b/ecosystem.mdx @@ -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). diff --git a/networks.mdx b/networks.mdx index 2543be9..623547d 100644 --- a/networks.mdx +++ b/networks.mdx @@ -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 @@ -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"/' \ diff --git a/sdk/raptorq.mdx b/sdk/raptorq.mdx index 3ac140f..e925c23 100644 --- a/sdk/raptorq.mdx +++ b/sdk/raptorq.mdx @@ -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 | --- @@ -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" ``` --- @@ -51,7 +52,7 @@ import ( "fmt" "os" - raptorq "github.com/LumeraProtocol/rq-go" + raptorq "lumera.build/rq-go" ) func main() { diff --git a/sdk/rust-reference.mdx b/sdk/rust-reference.mdx index 33b6f22..6b3fc1a 100644 --- a/sdk/rust-reference.mdx +++ b/sdk/rust-reference.mdx @@ -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). -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. ## Crate layout diff --git a/sdk/rust.mdx b/sdk/rust.mdx index 690456f..11850c9 100644 --- a/sdk/rust.mdx +++ b/sdk/rust.mdx @@ -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 ``` diff --git a/validators/overview.mdx b/validators/overview.mdx index e8dd4e2..3300aea 100644 --- a/validators/overview.mdx +++ b/validators/overview.mdx @@ -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` | diff --git a/validators/testnet/node-setup.mdx b/validators/testnet/node-setup.mdx index 11fe6e5..5b81558 100644 --- a/validators/testnet/node-setup.mdx +++ b/validators/testnet/node-setup.mdx @@ -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 @@ -405,7 +404,7 @@ curl -fsSL localhost:26657/net_info | jq -r '.result.n_peers' ``` -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. ## Verification checklist