Merge branch 'master' into chain/test5

examples/gno.land/p/moul/realmpath/gno.mod

@@ -0,0 +1,6 @@
+module gno.land/p/moul/realmpath
+
+require (
+	gno.land/p/demo/uassert v0.0.0-latest
+	gno.land/p/demo/urequire v0.0.0-latest
+)

examples/gno.land/p/moul/realmpath/realmpath.gno

@@ -0,0 +1,100 @@
+// Package realmpath is a lightweight Render.path parsing and link generation
+// library with an idiomatic API, closely resembling that of net/url.
+//
+// This package provides utilities for parsing request paths and query
+// parameters, allowing you to extract path segments and manipulate query
+// values.
+//
+// Example usage:
+//
+//	import "gno.land/p/moul/realmpath"
+//
+//	func Render(path string) string {
+//	    // Parsing a sample path with query parameters
+//	    path = "hello/world?foo=bar&baz=foobar"
+//	    req := realmpath.Parse(path)
+//
+//	    // Accessing parsed path and query parameters
+//	    println(req.Path)             // Output: hello/world
+//	    println(req.PathPart(0))      // Output: hello
+//	    println(req.PathPart(1))      // Output: world
+//	    println(req.Query.Get("foo")) // Output: bar
+//	    println(req.Query.Get("baz")) // Output: foobar
+//
+//	    // Rebuilding the URL
+//	    println(req.String())         // Output: /r/current/realm:hello/world?baz=foobar&foo=bar
+//	}
+package realmpath
+
+import (
+	"net/url"
+	"std"
+	"strings"
+)
+
+const chainDomain = "gno.land" // XXX: std.ChainDomain (#2911)
+
+// Request represents a parsed request.
+type Request struct {
+	Path  string     // The path of the request
+	Query url.Values // The parsed query parameters
+	Realm string     // The realm associated with the request
+}
+
+// Parse takes a raw path string and returns a Request object.
+// It splits the path into its components and parses any query parameters.
+func Parse(rawPath string) *Request {
+	// Split the raw path into path and query components
+	path, query := splitPathAndQuery(rawPath)
+
+	// Parse the query string into url.Values
+	queryValues, _ := url.ParseQuery(query)
+
+	return &Request{
+		Path:  path,        // Set the path
+		Query: queryValues, // Set the parsed query values
+	}
+}
+
+// PathParts returns the segments of the path as a slice of strings.
+// It trims leading and trailing slashes and splits the path by slashes.
+func (r *Request) PathParts() []string {
+	return strings.Split(strings.Trim(r.Path, "/"), "/")
+}
+
+// PathPart returns the specified part of the path.
+// If the index is out of bounds, it returns an empty string.
+func (r *Request) PathPart(index int) string {
+	parts := r.PathParts() // Get the path segments
+	if index < 0 || index >= len(parts) {
+		return "" // Return empty if index is out of bounds
+	}
+	return parts[index] // Return the specified path part
+}
+
+// String rebuilds the URL from the path and query values.
+// If the Realm is not set, it automatically retrieves the current realm path.
+func (r *Request) String() string {
+	// Automatically set the Realm if it is not already defined
+	if r.Realm == "" {
+		r.Realm = std.CurrentRealm().PkgPath() // Get the current realm path
+	}
+
+	// Rebuild the path using the realm and path parts
+	relativePkgPath := strings.TrimPrefix(r.Realm, chainDomain) // Trim the chain domain prefix
+	reconstructedPath := relativePkgPath + ":" + strings.Join(r.PathParts(), "/")
+
+	// Rebuild the query string
+	queryString := r.Query.Encode() // Encode the query parameters
+	if queryString != "" {
+		return reconstructedPath + "?" + queryString // Return the full URL with query
+	}
+	return reconstructedPath // Return the path without query parameters
+}
+
+func splitPathAndQuery(rawPath string) (string, string) {
+	if idx := strings.Index(rawPath, "?"); idx != -1 {
+		return rawPath[:idx], rawPath[idx+1:] // Split at the first '?' found
+	}
+	return rawPath, "" // No query string present
+}

examples/gno.land/p/moul/realmpath/realmpath_test.gno

@@ -0,0 +1,151 @@
+package realmpath_test
+
+import (
+	"net/url"
+	"std"
+	"testing"
+
+	"gno.land/p/demo/uassert"
+	"gno.land/p/demo/urequire"
+	"gno.land/p/moul/realmpath"
+)
+
+func TestExample(t *testing.T) {
+	std.TestSetRealm(std.NewCodeRealm("gno.land/r/lorem/ipsum"))
+
+	// initial parsing
+	path := "hello/world?foo=bar&baz=foobar"
+	req := realmpath.Parse(path)
+	urequire.False(t, req == nil, "req should not be nil")
+	uassert.Equal(t, req.Path, "hello/world")
+	uassert.Equal(t, req.Query.Get("foo"), "bar")
+	uassert.Equal(t, req.Query.Get("baz"), "foobar")
+	uassert.Equal(t, req.String(), "/r/lorem/ipsum:hello/world?baz=foobar&foo=bar")
+
+	// alter query
+	req.Query.Set("hey", "salut")
+	uassert.Equal(t, req.String(), "/r/lorem/ipsum:hello/world?baz=foobar&foo=bar&hey=salut")
+
+	// alter path
+	req.Path = "bye/ciao"
+	uassert.Equal(t, req.String(), "/r/lorem/ipsum:bye/ciao?baz=foobar&foo=bar&hey=salut")
+}
+
+func TestParse(t *testing.T) {
+	std.TestSetRealm(std.NewCodeRealm("gno.land/r/lorem/ipsum"))
+
+	tests := []struct {
+		rawPath        string
+		realm          string // optional
+		expectedPath   string
+		expectedQuery  url.Values
+		expectedString string
+	}{
+		{
+			rawPath:      "hello/world?foo=bar&baz=foobar",
+			expectedPath: "hello/world",
+			expectedQuery: url.Values{
+				"foo": []string{"bar"},
+				"baz": []string{"foobar"},
+			},
+			expectedString: "/r/lorem/ipsum:hello/world?baz=foobar&foo=bar",
+		},
+		{
+			rawPath:      "api/v1/resource?search=test&limit=10",
+			expectedPath: "api/v1/resource",
+			expectedQuery: url.Values{
+				"search": []string{"test"},
+				"limit":  []string{"10"},
+			},
+			expectedString: "/r/lorem/ipsum:api/v1/resource?limit=10&search=test",
+		},
+		{
+			rawPath:        "singlepath",
+			expectedPath:   "singlepath",
+			expectedQuery:  url.Values{},
+			expectedString: "/r/lorem/ipsum:singlepath",
+		},
+		{
+			rawPath:        "path/with/trailing/slash/",
+			expectedPath:   "path/with/trailing/slash/",
+			expectedQuery:  url.Values{},
+			expectedString: "/r/lorem/ipsum:path/with/trailing/slash",
+		},
+		{
+			rawPath:        "emptyquery?",
+			expectedPath:   "emptyquery",
+			expectedQuery:  url.Values{},
+			expectedString: "/r/lorem/ipsum:emptyquery",
+		},
+		{
+			rawPath:      "path/with/special/characters/?key=val%20ue&anotherKey=with%21special%23chars",
+			expectedPath: "path/with/special/characters/",
+			expectedQuery: url.Values{
+				"key":        []string{"val ue"},
+				"anotherKey": []string{"with!special#chars"},
+			},
+			expectedString: "/r/lorem/ipsum:path/with/special/characters?anotherKey=with%21special%23chars&key=val+ue",
+		},
+		{
+			rawPath:      "path/with/empty/key?keyEmpty&=valueEmpty",
+			expectedPath: "path/with/empty/key",
+			expectedQuery: url.Values{
+				"keyEmpty": []string{""},
+				"":         []string{"valueEmpty"},
+			},
+			expectedString: "/r/lorem/ipsum:path/with/empty/key?=valueEmpty&keyEmpty=",
+		},
+		{
+			rawPath:      "path/with/multiple/empty/keys?=empty1&=empty2",
+			expectedPath: "path/with/multiple/empty/keys",
+			expectedQuery: url.Values{
+				"": []string{"empty1", "empty2"},
+			},
+			expectedString: "/r/lorem/ipsum:path/with/multiple/empty/keys?=empty1&=empty2",
+		},
+		{
+			rawPath:      "path/with/percent-encoded/%20space?query=hello%20world",
+			expectedPath: "path/with/percent-encoded/%20space", // XXX: should we decode?
+			expectedQuery: url.Values{
+				"query": []string{"hello world"},
+			},
+			expectedString: "/r/lorem/ipsum:path/with/percent-encoded/%20space?query=hello+world",
+		},
+		{
+			rawPath:      "path/with/very/long/query?key1=value1&key2=value2&key3=value3&key4=value4&key5=value5&key6=value6",
+			expectedPath: "path/with/very/long/query",
+			expectedQuery: url.Values{
+				"key1": []string{"value1"},
+				"key2": []string{"value2"},
+				"key3": []string{"value3"},
+				"key4": []string{"value4"},
+				"key5": []string{"value5"},
+				"key6": []string{"value6"},
+			},
+			expectedString: "/r/lorem/ipsum:path/with/very/long/query?key1=value1&key2=value2&key3=value3&key4=value4&key5=value5&key6=value6",
+		},
+		{
+			rawPath:      "custom/realm?foo=bar&baz=foobar",
+			realm:        "gno.land/r/foo/bar",
+			expectedPath: "custom/realm",
+			expectedQuery: url.Values{
+				"foo": []string{"bar"},
+				"baz": []string{"foobar"},
+			},
+			expectedString: "/r/foo/bar:custom/realm?baz=foobar&foo=bar",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.rawPath, func(t *testing.T) {
+			req := realmpath.Parse(tt.rawPath)
+			req.Realm = tt.realm // set optional realm
+			urequire.False(t, req == nil, "req should not be nil")
+			uassert.Equal(t, req.Path, tt.expectedPath)
+			urequire.Equal(t, len(req.Query), len(tt.expectedQuery))
+			uassert.Equal(t, req.Query.Encode(), tt.expectedQuery.Encode())
+			// XXX: uassert.Equal(t, req.Query, tt.expectedQuery)
+			uassert.Equal(t, req.String(), tt.expectedString)
+		})
+	}
+}

misc/deployments/test5.gno.land/CHECKLIST.md

@@ -0,0 +1,8 @@
+# Checklist Test5
+
+- [x] Collect all validators keys for genesis
+- [x] Collect all balances for genesis
+- [x] Generate Final Genesis File
+- [X] Collect list of public peer nodes for configurations
+- [ ] Generate Release Docker Images of Gnoland for test5
+- [ ] Change DNS entries

misc/deployments/test5.gno.land/README.md

@@ -0,0 +1,47 @@
+# Overview
+
+This deployment folder contains minimal information needed to launch a full test5.gno.land validator node.
+
+## `genesis.json`
+
+The initial `genesis.json` validator set is consisted of 6 entities (17 validators in total):
+
+- Gno Core - the gno core team (**6 validators**)
+- Gno DevX - the gno devX team (**4 validators**)
+- AiB - the AiB DevOps team (**3 validators**)
+- Onbloc - the [Onbloc](https://onbloc.xyz/) team (**2 validator**)
+- Teritori - the [Teritori](https://teritori.com/) team (**1 validator**)
+- Berty - the [Berty](https://berty.tech/) team (**1 validator**)
+
+Subsequent validators will be added through the governance mechanism in govdao, employing a preliminary simplified
+version Proof of Contribution.
+
+The addresses premined belong to different faucet accounts, validator entities and implementation partners.
+
+## `config.toml`
+
+The `config.toml` located in this directory is a **_guideline_**, and not a definitive configuration on how
+all nodes should be configured in the network.
+
+### Important params
+
+Some configuration params are required, while others are advised to be set.
+
+- `moniker` - the recognizable identifier of the node.
+- `consensus.timeout_commit` - the timeout value after the consensus commit phase. ⚠️ **Required to be `1s`** ⚠️.
+- `conseuns.peer_gossip_sleep_duration` - the timeout for peer gossip. ⚠️ **Required to be `10ms`** ⚠️.
+- `mempool.size` - the maximum number of txs in the mempool. **Advised to be `10000`**.
+- `p2p.laddr` - the listen address for P2P traffic, **specific to every node deployment**. It is advised to use a
+  reverse-proxy, and keep this value at `tcp://0.0.0.0:<port>`.
+- `p2p.max_num_outbound_peers` - the max number of outbound peer connections. **Advised to be `40`**.
+- `p2p.persistent_peers` - the persistent peers. ⚠️ **Required to be
+  `g16384atcuf6ew3ufpwtvhymwfyl2aw390aq8jtt@gno-core-sen-01.test5.gnoteam.com:26656,g1ty443uhf6qr2n0gv3dkemr4slt96e5hnmx90qh@gno-core-sen-02.test5.gnoteam.com:26656,g19x2gsyn02fldtq44dpgtcq2dq28kszlf5jn2es@gno-core-sen-03.test5.gnoteam.com:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,g18vg9lgndagym626q8jsgv2peyjatscykde3xju@devx-sen-1.test5.gnodevx.network:26656,g1fnwswr6p5nqfvusglv7g2vy0tzwt5npwe7stvv@devx-sen-2.test5.gnodevx.network:26656,[email protected]:26656`
+  ** ⚠️.
+- `p2p.pex` - if using a sentry node architecture, should be `false`. **If not, please set to `true`**.
+- `p2p.external_address` - the advertised peer dial address. If empty, will use the same port as the `p2p.laddr`. This
+  value should be **changed to `{{ your_ip_address }}:26656`**
+- `p2p.flush_throttle_timeout` - the timeout for flushing multiplex data. ⚠️ **Required to be `10ms`** ⚠️.
+- `rpc.laddr` - the JSON-RPC listen address, **specific to every node deployment**.
+- `telemetry.enabled` - flag indicating if telemetry should be turned on. **Advised to be `true`**.
+- `telemetry.exporter_endpoint` - endpoint for the otel exported. ⚠️ **Required if `telemetry.enabled=true`** ⚠️.
+- `telemetry.service_instance_id` - unique ID of the node telemetry instance, **specific to every node deployment**.