feat: gnobro, a terminal-based realm browser

contribs/gnodev/Makefile

@@ -5,11 +5,13 @@ GOTEST_FLAGS ?= $(GOBUILD_FLAGS) -v -p 1 -timeout=5m
 rundep := go run -modfile ../../misc/devdeps/go.mod
 golangci_lint := $(rundep) github.com/golangci/golangci-lint/cmd/golangci-lint
 
-install:
+install: install.gnodev
+install.gnodev:
  go install $(GOBUILD_FLAGS) ./cmd/gnodev
 
-build:
- go build $(GOBUILD_FLAGS) -o build/gnodev ./cmd/gnodev
+# keep gnobro out the default install for now
+install.gnobro:
+ go install $(GOBUILD_FLAGS) ./cmd/gnobro
 
 lint:
  $(golangci_lint) --config ../../.github/golangci.yml run ./...

contribs/gnodev/README.md

@@ -1,30 +1,67 @@
-## `gnodev`: Your Gno Companion Tool
+## `gnodev`: Your Gno Development Companion
 
-`gnodev` is designed to be a robust and user-friendly tool in your realm package development journey, streamlining your workflow and enhancing productivity.
+`gnodev` is a robust tool designed to streamline your Gno package development process, enhancing productivity
+by providing immediate feedback on code changes.
 
-We will only give a quick overview below. You may find the official documentation at [docs/gno-tooling/gnodev.md](../../docs/gno-tooling/cli/gnodev.md).
+Please note that this is a quick overview. For a more detailed guide, refer to the official documentation at
+[docs/gno-tooling/gnodev.md](../../docs/gno-tooling/cli/gnodev.md).
 
 ### Synopsis
-**gnodev** [**-minimal**] [**-no-watch**] [**PKG_PATH ...**]
+**gnodev** [**options**] [**PKG_PATH ...**]
 
 ### Features
-- **In-Memory Node**: Gnodev starts an in-memory node, and automatically loads
- the **examples** folder and any user-specified paths.
-- **Web Interface Server**: Starts a `gnoweb` server on `localhost:8888`.
-- **Hot Reload**: Monitors the example packages folder and specified directories for file changes,
- reloading the package and automatically restarting the node as needed.
-- **State Maintenance**: Ensures the current state is preserved by replaying all transactions.
+- **In-Memory Node**: Gnodev starts an in-memory node, automatically loading the **examples** folder and any
+ user-specified paths.
+- **Web Interface Server**: Gnodev starts a `gnoweb` server on [`localhost:8888`](https://localhost:8888).
+- **Balances and Keybase Customization**: Set account balances, load them from a file, or add new accounts via a flag.
+- **Hot Reload**: Monitors the **examples** folder and specified directories for file changes, reloading the
+ package and automatically restarting the node as needed.
+- **State Maintenance**: Ensures the previous node state is preserved by replaying all transactions.
+- **Transaction Manipulation**: Allows for interactive cancellation and redoing of transactions.
+- **State Export**: Export the current state at any time in a genesis doc format.
 
 ### Commands
-While `gnodev` is running, the user can trigger specific actions by pressing
-the following combinations:
-- **H**: Display help information.
-- **R**: Reload the node, without resetting the state.
-- **Ctrl+R**: Reset the current node state.
-- **Ctrl+C**: Exit `gnodev`.
+While `gnodev` is running, trigger specific actions by pressing the following combinations:
+- **H**: Display help information.
+- **A**: Display account balances.
+- **R**: Reload the node manually.
+- **P**: Cancel the last action.
+- **N**: Redo the last cancelled action.
+- **Ctrl+S**: Save the current state.
+- **Ctrl+R**: Restore the saved state.
+- **E**: Export the current state to a genesis file.
+- **Cmd+R**: Reset the current node state.
+- **Cmd+C**: Exit `gnodev`.
+
+### Usage
+Run `gnodev` followed by any specific options and/or package paths. The **examples** directory is loaded
+automatically. Use `--minimal` to prevent this.
+
+Example:
+```
+gnodev --add-account <bech32/name1>[:<amount1>] ./myrealm
+```
+
+### `gnobro`: realm interface
+`gnobro` is a terminal user interface (TUI) that allows you to browse realms within your terminal. It
+automatically connects to `gnodev` for real-time development. In addition to hot reload, it also has the
+ability to execute commands and interact with your realm.
+
+
+#### Usage
+**gnobro** [**options**] [**PKG_PATH **]
+
+Run gnobro followed by any specific options and/or a target pacakge path.
+
+Use `gnobro -h` for a detailed list of options.
+
+Example:
+```
+gnobro gno.land/r/demo/home
+```
 
-### Loading 'examples'
-The **examples** directory is loaded automatically. If working within this folder, you don't have to specify any additional paths to `gnodev`. Use `--minimal` to prevent this.
 
 ### Installation
 Run `make install` to install `gnodev`.
+
+Run `make install.gnobro` to install `gnobro`.

contribs/gnodev/cmd/gnobro/assets/banner_land_1.txt

@@ -0,0 +1,19 @@
+ . +
+ + . Hello %s, Welcome to
+ .
++ .,-:::::/ :::. :::. ... .
+ . ,;;-'````' `;;;;, `;;; .;;;;;;;.
+ [[[ [[[[[[/ [[[[[. '[[ ,[[ \[[,
+ "$$c. "$$ + $$$ "Y$c$$ $$$, $$$
+ `Y8bo,,,o88o 888 Y88 "888,_ _,88P
+ . `'YMUP"YMM MMM . YM "YMMMMMP" +
+ . .
+ ::: + :::. :::. :::. :::::::-.
+ ;;; ;;`;; `;;;;, `;;; ;;, `';,
+ + [[[ ,[[ '[[, + [[[[[. '[[ `[[ [[
+ $$' c$$$cc$$$c $$$ "Y$c$$ $$, $$
+ o88oo,.__ 888 888, 888 Y88 888_,o8P'
+ """"YUMMM YMM ""` MMM + YM MMMMP"` +
+ .
+ +
+ press <enter> to continue

contribs/gnodev/cmd/gnobro/assets/gn_hc1.utf8ans

@@ -0,0 +1,25 @@
+ · . · ·
+ . * . . * . ·
+ · · · · . . .
+ · . . . . · *
+ . · . . ·
+ ░░ ░░ ░ ░░ ░ ░░ ░ ░░ ░░░ ░░░░░░ ░░░ ░░░░ ░ ░░
+░░▒▒░░░▒▒░░░░░▒░░░░░░▒▒░░▒░░▒▒░▒░░░░░░░ ░░░░░░▒▒░▒▒▒░▒▒▒▒▒▒░░▒▒▒░░░▒▒▒▒░▒░░▒▒░░
+▒▒▓▓▒▒▒▓▓▒▒▒▒▒▓▒▒▒▒▒▒▓▓▒▒▓▒▒▓▓▒▓▒▒▒▒▒▒▒░▒▒▒▒▒▒▓▓▒▓▓▓▒▓▓▓▓▓▓▒▒▓▓▓▒▒▒▓▓▓▓▒▓▒▒▓▓▒▒
+▓▓██▓▓▓██▓▓▓▓▓█▓▓▓▓▓▓██▓▓█▓▓██▓█▓▓▓▓▓▓▓▒▓▓▓▓▓▓██▓███▓██████▓▓███▓▓▓████▓█▓▓██▓▓
+▀██▒███ █████ ██████▌▐██▒██▌██▒███████▓███▓██▌▐██▒██▌██▒█████▒████ ███▒███ ██
+ ▐▒▒▒█ █▒█▌ ▐▒███▌ ▐▒▒▒▌ ▐▒▒███▌█▒███▌███▌ ▐▒▒▒▌ ▐▒▒███▌█▒███ █▒▒▒█▌ ▐▒
+ ▒▒▒▒▄ ▄▒█ ▒█▒█▄ ▒▒▒░ ▀▒▒█▌ ▐▒██▐ █▒█▄ ▒▒▒░ ▀▒▒█▌ ▐▒ █▄ ▄▒▒ ▒ ▒
+ ░ ░ ▄ ▄▄▒▌ ▒█▒▀ ▀▒▒ ▒▒▒▀▄ ▄▒▄▀▀▄▐▒▀ ▀▒▒ ▒▒▒▀▄ ▄▒ █ ▄ ▄▄▄▀▀▄ ▒
+ ▀░ ▒░▒▄░ ▀▄▒▀▒▒ ▀█▒▄▄ ▄■▄▒▒▀ ▒▌░░▐░▀ ▒ ▀ ▄ ■▒░▀ ▒ ▀░ ▒░▌░░▐░ ▀▄
+ ▌░░▐ ▌░░▐
+ ▄▄▀▀▀▀▀▀▀▄▄▀▀▄▀▀▀▀▀▄ ▄▀▀▀▀▀▄ ▌▒▒▐ ▄▄▀▀▀▀▀▄ ▄▀▄▄▀▀▀▀▀▄ ▄▄▄▄▄▌▒▒▐
+ ▌▄▓▓▓▓▓▓▓▄ ▓▓▄▓▓▓▓▓▄▀▀▄▓▓▓▓▓▄▀▄ ▌▓▓▐ ▌▄▓▓▓▓▓▄▀▌▓▌▄▓▓▓▓▓▄▀▀▄▄▄▄▄▄▓▓▐
+ ▌█▌ ██ ███▀▄▄▀██ ▐██▀▀▀██▌▐ ▌██▐ ▐▐██▀▀▀██▌ ███▀▄▄▀██ ▐██▀▀▀███▐
+ ▌▀░░░░░░░░ ░░▌▌ ▌░░ ░░ ░░▐ ▌░░▐ ▌░░ ░░ ░░▌█ ▌░░ ░░▌ ▐░░▐
+ ▐ ▒▒ ▒▒▌▌ ▌▒▒ ▒▒▌ ▐▒▒▐▄▀▄▌▒▒▐ ▌▒▒▌ ▐▒▒ ▒▒▌▌ ▌▒▒ ▒▒▌ ▐▒▒▐
+ ▌▄▄ ▓▓ ▓▓▌▌ ▌▓▓ ▓▓▓ ▓▓▓ ▄▓▄ ▓▓ ▀▀ ▓▓▓ ▐▓▓ ▓▓▌▌ ▌▓▓ ▓▓▓ ▐▓▓▐
+░ ▌▀███████▀ ███▐ ▐▐██ ▄▀█████▀▄▄▀█▀▄▀████ ▄▀████▀██ ███▐ ▐▐██ ▄▀████▀██▐ ░
+▒ ▓▓▄▄▄▄▄▄▄▄▀▄▄▄▀ ▀▄▄▀ ▀▄▄▄▄▄▀ ▀▄▀ ▀▄▄▄▄▀ ▀▄▄▄▄▀▄▄▀▄▄▄▀ ▀▄▄▀ ▀▄▄▄▄▀▄▄▓ ▒
+▓ ▓
+█▓▒░ ░▒▓█

contribs/gnodev/cmd/gnobro/assets/gn_hc2.utf8ans

@@ -0,0 +1,25 @@
+ · . · ·
+ . + . . + . ·
+ · · · · . . .
+ · . . . . · +
+ . · . . ·
+ ░░ ░░ ░ ░░ ░ ░░ ░ ░░ ░░░ ░░░░░░ ░░░ ░░░░ ░ ░░
+░░▒▒░░░▒▒░░░░░▒░░░░░░▒▒░░▒░░▒▒░▒░░░░░░░ ░░░░░░▒▒░▒▒▒░▒▒▒▒▒▒░░▒▒▒░░░▒▒▒▒░▒░░▒▒░░
+▒▒▓▓▒▒▒▓▓▒▒▒▒▒▓▒▒▒▒▒▒▓▓▒▒▓▒▒▓▓▒▓▒▒▒▒▒▒▒░▒▒▒▒▒▒▓▓▒▓▓▓▒▓▓▓▓▓▓▒▒▓▓▓▒▒▒▓▓▓▓▒▓▒▒▓▓▒▒
+▓▓██▓▓▓██▓▓▓▓▓█▓▓▓▓▓▓██▓▓█▓▓██▓█▓▓▓▓▓▓▓▒▓▓▓▓▓▓██▓███▓██████▓▓███▓▓▓████▓█▓▓██▓▓
+▀██▒███ █████ ██████▌▐██▒██▌██▒███████▓███▓██▌▐██▒██▌██▒█████▒████ ███▒███ ██
+ ▐▒▒▒█ █▒█▌ ▐▒███▌ ▐▒▒▒▌ ▐▒▒███▌█▒███▌███▌ ▐▒▒▒▌ ▐▒▒███▌█▒███ █▒▒▒█▌ ▐▒
+ ▒▒▒▒▄ ▄▒█ ▒█▒█▄ ▒▒▒░ ▀▒▒█▌ ▐▒██▐ █▒█▄ ▒▒▒░ ▀▒▒█▌ ▐▒ █▄ ▄▒▒ ▒ ▒
+ ░ ░ ▄ ▄▄▒▌ ▒█▒▀ ▀▒▒ ▒▒▒▀▄ ▄▒▄▀▀▄▐▒▀ ▀▒▒ ▒▒▒▀▄ ▄▒ █ ▄ ▄▄▄▀▀▄ ▒
+ ▀░ ▒░▒▄░ ▀▄▒▀▒▒ ▀█▒▄▄ ▄■▄▒▒▀ ▒▌░░▐░▀ ▒ ▀ ▄ ■▒░▀ ▒ ▀░ ▒░▌░░▐░ ▀▄
+ ▌░░▐ ▌░░▐
+ ▄▄▀▀▀▀▀▀▀▄▄▀▀▄▀▀▀▀▀▄ ▄▀▀▀▀▀▄ ▌▒▒▐ ▄▄▀▀▀▀▀▄ ▄▀▄▄▀▀▀▀▀▄ ▄▄▄▄▄▌▒▒▐
+ ▌▄▓▓▓▓▓▓▓▄ ▓▓▄▓▓▓▓▓▄▀▀▄▓▓▓▓▓▄▀▄ ▌▓▓▐ ▌▄▓▓▓▓▓▄▀▌▓▌▄▓▓▓▓▓▄▀▀▄▄▄▄▄▄▓▓▐
+ ▌█▌ ██ ███▀▄▄▀██ ▐██▀▀▀██▌▐ ▌██▐ ▐▐██▀▀▀██▌ ███▀▄▄▀██ ▐██▀▀▀███▐
+ ▌▀░░░░░░░░ ░░▌▌ ▌░░ ░░ ░░▐ ▌░░▐ ▌░░ ░░ ░░▌█ ▌░░ ░░▌ ▐░░▐
+ ▐ ▒▒ ▒▒▌▌ ▌▒▒ ▒▒▌ ▐▒▒▐▄▀▄▌▒▒▐ ▌▒▒▌ ▐▒▒ ▒▒▌▌ ▌▒▒ ▒▒▌ ▐▒▒▐
+ ▌▄▄ ▓▓ ▓▓▌▌ ▌▓▓ ▓▓▓ ▓▓▓ ▄▓▄ ▓▓ ▀▀ ▓▓▓ ▐▓▓ ▓▓▌▌ ▌▓▓ ▓▓▓ ▐▓▓▐
+░ ▌▀███████▀ ███▐ ▐▐██ ▄▀█████▀▄▄▀█▀▄▀████ ▄▀████▀██ ███▐ ▐▐██ ▄▀████▀██▐ ░
+▒ ▓▓▄▄▄▄▄▄▄▄▀▄▄▄▀ ▀▄▄▀ ▀▄▄▄▄▄▀ ▀▄▀ ▀▄▄▄▄▀ ▀▄▄▄▄▀▄▄▀▄▄▄▀ ▀▄▄▀ ▀▄▄▄▄▀▄▄▓ ▒
+▓ ▓
+█▓▒░ ░▒▓█