Merge branch 'master' into false-positive-unused

Author: notJoon

.github/workflows/examples.yml

@@ -6,9 +6,9 @@ on:
       - master
   pull_request:
     paths:
-      - gnovm/**/*.gno
-      - examples/**/*.gno
-      - examples/**/gno.mod
+      # any change to gnovm code can make examples fail
+      - gnovm/**
+      - examples/**
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}

.github/workflows/gnovm.yml

@@ -8,6 +8,7 @@ on:
     paths:
       - gnovm/**
       - tm2/** # GnoVM has a dependency on TM2 types
+      - examples/** # gnovm has some tests that depend on examples
       # We trigger the testing workflow for changes to the main go.mod,
       # since this can affect test results
       - go.mod

docs/builders/deploy-packages.md

@@ -150,7 +150,7 @@ a third-party web extension wallet, such as Adena.
 [^1]: Read more about package paths [here](../resources/gno-packages.md).
 [^2]: Other network configurations can be found [here](../resources/gnoland-networks.md).
 [^3]: Address namespaces ([PA namespaces](../resources/gno-packages.md#package-path-structure)) are automatically granted to
-users. Users can register a username using the [gno.land user registry](https://gno.land/r/demo/users),
+users. Users can register a username using the [gno.land user registry](https://gno.land/r/gnoland/users),
 which will grant them access to a matching namespace for that specific network.
 [^4]: Automatic gas estimation is being worked on for `gnokey`. Follow progress
 [here](https://github.com/gnolang/gno/pull/3330).

docs/resources/glossary.md

@@ -265,8 +265,9 @@ or calling a realm function.
 The smallest unit of GNOT. 1 GNOT = 1,000,000 ugnot (micro-GNOT).
 
 ### User Registry
+
 A system realm that allows users to register usernames and claim matching
-namespaces for deploying code. Found at `gno.land/r/demo/users`.
+namespaces for deploying code. List of releases found at `gno.land/r/gnoland/users`.
 See [Users and Teams](./users-and-teams.md) for details.
 
 ### wugnot

docs/resources/gno-packages.md

@@ -93,7 +93,7 @@ depth as long as the full package path doesn't exceed `256` characters.
 
 To register a custom namespace:
 
-1. Register a username at `gno.land/r/demo/users`
+1. Register a username at `gno.land/r/gnoland/users`
 2. Once registered, you can deploy packages under that namespace
 3. Only you can deploy to your namespace
 

docs/resources/users-and-teams.md

@@ -11,23 +11,24 @@ In gno.land, users can register a unique username that:
 
 To register a username:
 
-1. Visit the user registry realm at [`gno.land/r/demo/users`](https://gno.land/r/demo/users)
-2. Check if your desired username is available
+1. Visit the user registry realm at [`gno.land/r/gnoland/users`](https://gno.land/r/gnoland/users)
+2. Check if your desired username is available by 
 3. Register using the following command:
 
 ```bash
 gnokey maketx call \
-  --pkgpath "gno.land/r/demo/users" \
+  --pkgpath "gno.land/r/gnoland/users/v1" \
   --func "Register" \
   --args "YOUR_USERNAME" \
   --gas-fee 1000000ugnot \
   --gas-wanted 2000000 \
+  --send "1000000ugnot" \
   --remote https://rpc.gno.land:443 \
   --chainid portal-loop \
   YOUR_KEY_NAME
 ```
 
-The registration costs 200 GNOT, which serves as an anti-spam measure and ensures users value their identities.
+The registration costs 1 GNOT, which serves as an anti-spam measure and ensures users value their identities.
 
 ## Username Ownership
 
@@ -46,7 +47,7 @@ gno.land/p/YOUR_USERNAME/...  # Pure packages
 gno.land/r/YOUR_USERNAME/...  # Realms
 ```
 
-For example, a user with username "alice" could deploy:
+For example, a user with the username "alice" could deploy:
 - `gno.land/r/alice/blog` - A personal blog realm
 - `gno.land/p/alice/utils` - A utility package
 
@@ -85,4 +86,4 @@ For more information on users and namespaces, refer to:
 - [Realms](./realms.md) - Learn about stateful applications that can be deployed under your namespace
 - [Deploying Packages](../builders/deploy-packages.md) - Instructions for deploying code under your namespace
 
-To explore registered users, visit the [User Registry](https://gno.land/r/demo/users) on the Portal Loop network.
+To explore registered users, visit the [User Registry](https://gno.land/r/gnoland/users) on the Portal Loop network.

docs/users/explore-with-gnoweb.md

@@ -36,7 +36,7 @@ Let's break it down:
 - `type` represents the type of package found on this path. There are two available
   options - `p` & `r` - pure packages and realms, respectively.
 - `namespace` is the namespace of the package. Namespaces can be registered using
-  the `gno.land/r/demo/users` realm, granting a user permission to deploy under
+  the `gno.land/r/gnoland/users` realms, granting a user permission to deploy under
   that specific namespace.
 - `package name` represents the name of the package found on the path. This part has
   to match the top-level package declaration in Gno files.

examples/Makefile

@@ -22,13 +22,6 @@ GOIMPORTS_FLAGS ?= $(GOFMT_FLAGS)
 # test suite flags.
 GOTEST_FLAGS ?= -v -p 1 -timeout=30m
 
-# Official packages (non-overridable): more reliable and tested modules, distinct from the experimentation area.
-OFFICIAL_PACKAGES = ./gno.land/p
-OFFICIAL_PACKAGES += ./gno.land/r/demo
-OFFICIAL_PACKAGES += ./gno.land/r/gnoland
-OFFICIAL_PACKAGES += ./gno.land/r/sys
-OFFICIAL_PACKAGES += ./gno.land/r/gov
-
 ########################################
 # Dev tools
 .PHONY: transpile
@@ -45,7 +38,7 @@ test:
 
 .PHONY: lint
 lint:
-	go run ../gnovm/cmd/gno tool lint -v $(OFFICIAL_PACKAGES)
+	go run ../gnovm/cmd/gno tool lint -v .
 
 .PHONY: test.sync
 test.sync:

examples/gno.land/p/agherasie/forms/create.gno

@@ -0,0 +1,80 @@
+package forms
+
+import (
+	"std"
+	"time"
+
+	"gno.land/p/demo/json"
+)
+
+const dateFormat = "2006-01-02T15:04:05Z"
+
+func CreateField(label string, fieldType string, required bool) Field {
+	return Field{
+		Label:     label,
+		FieldType: fieldType,
+		Required:  required,
+	}
+}
+
+// CreateForm creates a new form with the given parameters
+func (db *FormDB) CreateForm(title string, description string, openAt string, closeAt string, data string) (string, error) {
+	// Parsing the dates
+	var parsedOpenTime, parsedCloseTime time.Time
+
+	if openAt != "" {
+		var err error
+		parsedOpenTime, err = time.Parse(dateFormat, openAt)
+		if err != nil {
+			return "", errInvalidDate
+		}
+	}
+
+	if closeAt != "" {
+		var err error
+		parsedCloseTime, err = time.Parse(dateFormat, closeAt)
+		if err != nil {
+			return "", errInvalidDate
+		}
+	}
+
+	// Parsing the json submission
+	node, err := json.Unmarshal([]byte(data))
+	if err != nil {
+		return "", errInvalidJson
+	}
+
+	fieldsCount := node.Size()
+	fields := make([]Field, fieldsCount)
+
+	// Parsing the json submission to create the gno data structures
+	for i := 0; i < fieldsCount; i++ {
+		field := node.MustIndex(i)
+
+		fields[i] = CreateField(
+			field.MustKey("label").MustString(),
+			field.MustKey("fieldType").MustString(),
+			field.MustKey("required").MustBool(),
+		)
+	}
+
+	// Generating the form ID
+	id := db.IDCounter.Next().String()
+
+	// Creating the form
+	form := Form{
+		ID:          id,
+		Owner:       std.PreviousRealm().Address(),
+		Title:       title,
+		Description: description,
+		CreatedAt:   time.Now(),
+		openAt:      parsedOpenTime,
+		closeAt:     parsedCloseTime,
+		Fields:      fields,
+	}
+
+	// Adding the form to the database
+	db.Forms = append(db.Forms, &form)
+
+	return id, nil
+}

examples/gno.land/p/agherasie/forms/create_test.gno

@@ -0,0 +1,70 @@
+package forms
+
+import (
+	"std"
+	"testing"
+
+	"gno.land/p/demo/testutils"
+	"gno.land/p/demo/urequire"
+)
+
+func TestCreateForm(t *testing.T) {
+	alice := testutils.TestAddress("alice")
+	std.TestSetOriginCaller(alice)
+	db := NewDB()
+	title := "Simple Form"
+	description := "This is a form"
+	openAt := "2021-01-01T00:00:00Z"
+	closeAt := "2021-01-02T00:00:00Z"
+	data := `[
+		{
+			"label": "Name",
+			"fieldType": "string",
+			"required": true
+		},
+		{
+			"label": "Age",
+			"fieldType": "number",
+			"required": false
+		},
+		{
+			"label": "Is this a test?",
+			"fieldType": "boolean",
+			"required": false
+		},
+		{
+			"label": "Favorite Food",
+			"fieldType": "['Pizza', 'Schnitzel', 'Burger']",
+			"required": true
+		},
+		{
+			"label": "Favorite Foods",
+			"fieldType": "{'Pizza', 'Schnitzel', 'Burger'}",
+			"required": true
+		}
+	]`
+
+	urequire.NotPanics(t, func() {
+		id, err := db.CreateForm(title, description, openAt, closeAt, data)
+		if err != nil {
+			panic(err)
+		}
+		urequire.True(t, id != "", "Form ID is empty")
+
+		form, err := db.GetForm(id)
+		if err != nil {
+			panic(err)
+		}
+
+		urequire.True(t, form.ID == id, "Form ID is not correct")
+		urequire.True(t, form.Owner == alice, "Owner is not correct")
+		urequire.True(t, form.Title == title, "Title is not correct")
+		urequire.True(t, form.Description == description, "Description is not correct")
+		urequire.True(t, len(form.Fields) == 5, "Not enough fields were provided")
+		urequire.True(t, form.Fields[0].Label == "Name", "Field 0 label is not correct")
+		urequire.True(t, form.Fields[0].FieldType == "string", "Field 0 type is not correct")
+		urequire.True(t, form.Fields[0].Required == true, "Field 0 required is not correct")
+		urequire.True(t, form.Fields[1].Label == "Age", "Field 1 label is not correct")
+		urequire.True(t, form.Fields[1].FieldType == "number", "Field 1 type is not correct")
+	})
+}

examples/gno.land/p/agherasie/forms/doc.gno

@@ -0,0 +1,25 @@
+// # Gno forms
+
+// gno-forms is a package which demonstrates a form editing and sharing application in gno
+
+// ## Features
+// - **Form Creation**: Create new forms with specified titles, descriptions, and fields.
+// - **Form Submission**: Submit answers to forms.
+// - **Form Retrieval**: Retrieve existing forms and their submissions.
+// - **Form Deadline**: Set a precise time range during which a form can be interacted with.
+
+// ## Field Types
+// The system supports the following field types:
+
+// | type         | example                                                                                         |
+// |--------------|-------------------------------------------------------------------------------------------------|
+// | string       | `{"label": "Name", "fieldType": "string", "required": true}`                                    |
+// | number       | `{"label": "Age", "fieldType": "number", "required": true}`                                     |
+// | boolean      | `{"label": "Is Student?", "fieldType": "boolean", "required": false}`                           |
+// | choice       | `{"label": "Favorite Food", "fieldType": "['Pizza', 'Schnitzel', 'Burger']", "required": true}` |
+// | multi-choice | `{"label": "Hobbies", "fieldType": "{'Reading', 'Swimming', 'Gaming'}", "required": false}`     |
+
+// ## Web-app
+
+// The external repo where the initial development took place and where you can find the frontend is [here](https://github.com/agherasie/gno-forms).
+package forms

examples/gno.land/p/agherasie/forms/errors.gno

@@ -0,0 +1,15 @@
+package forms
+
+import "errors"
+
+var (
+	errNoOpenDate       = errors.New("Form has no open date")
+	errNoCloseDate      = errors.New("Form has no close date")
+	errInvalidJson      = errors.New("Invalid JSON")
+	errInvalidDate      = errors.New("Invalid date")
+	errFormNotFound     = errors.New("Form not found")
+	errAnswerNotFound   = errors.New("Answer not found")
+	errAlreadySubmitted = errors.New("You already submitted this form")
+	errFormClosed       = errors.New("Form is closed")
+	errInvalidAnswers   = errors.New("Invalid answers")
+)