feat: official documentation

docs/gno-docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs/gno-docs/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

docs/gno-docs/docs/explanation/gno-doc.md

@@ -0,0 +1,7 @@
+---
+id: gno-doc
+---
+
+# Gno Doc
+
+TODO 

docs/gno-docs/docs/explanation/gno-language.md

@@ -0,0 +1,7 @@
+---
+id: gno-language
+---
+
+# The Gno Language
+
+TODO

docs/gno-docs/docs/explanation/gno-modules.md

@@ -0,0 +1,7 @@
+---
+id: gno-modules
+---
+
+# Gno Modules
+
+TODO 

docs/gno-docs/docs/explanation/gno-test.md

@@ -0,0 +1,7 @@
+---
+id: gno-test
+---
+
+# Gno Test
+
+TODO

docs/gno-docs/docs/explanation/gno-tooling.md

@@ -0,0 +1,7 @@
+---
+id: gno-tooling
+---
+
+# Gno Tooling
+
+TODO

docs/gno-docs/docs/explanation/gnovm.md

@@ -0,0 +1,7 @@
+---
+id: gnovm
+---
+
+# GnoVM
+
+TODO

docs/gno-docs/docs/explanation/ibc.md

@@ -0,0 +1,7 @@
+---
+id: ibc
+---
+
+# IBC
+
+TODO

docs/gno-docs/docs/explanation/packages.md

@@ -0,0 +1,7 @@
+---
+id: packages
+---
+
+# Packages
+
+TODO

docs/gno-docs/docs/explanation/realms.md

@@ -0,0 +1,7 @@
+---
+id: realms
+---
+
+# Realms
+
+TODO

docs/gno-docs/docs/explanation/standard-library.md

@@ -0,0 +1,7 @@
+---
+id: explain-standard-library
+---
+
+# Gno Standard Library
+
+TODO 

docs/gno-docs/docs/explanation/tendermint2.md

@@ -0,0 +1,7 @@
+---
+id: tendermint2
+---
+
+# Tendermint2
+
+TODO

docs/gno-docs/docs/getting-started/browsing-gno-source-code.md

@@ -0,0 +1,7 @@
+---
+id: browsing-gno-source-code
+---
+
+# Browsing Gno Source Code
+
+TODO 

docs/gno-docs/docs/getting-started/installation.md

@@ -0,0 +1,111 @@
+---
+id: installation
+---
+
+# Installation
+
+## Overview
+
+In this tutorial, you will learn how to set up the Gno development environment locally, so you
+can get up and running writing Gno code. You will download and install all the necessary tooling,
+and validate that they are correctly configured to run on your machine.
+
+## Prerequisites
+
+- **Git**
+- **`make` (for running Makefiles)**
+- **Go 19+**
+
+## 1. Cloning the repository
+
+To get started with a local Gno.land development environment, you must clone the GitHub repository
+somewhere on disk:
+
+```bash
+git clone https://github.com/gnolang/gno.git
+```
+
+## 2. Installing the `gno` development toolkit
+
+Next, we are going to build and install the `gno` development toolkit.
+`gno` provides ample functionality to the user, among which is running, precompiling, testing and building `.gno` files.
+
+To install the toolkit, navigate to the `gnovm` folder from the repository root, and run the `build` make directive:
+
+```bash
+cd gnovm
+make build
+```
+
+This will build out the necessary `gno` binary into the `gnovm/cmd` sub-folder:
+
+![gno tool build](../../static/img/getting-started/installation/make-build-gnovm.gif)
+
+Next, to make development easier, we need to make the binary available system-wide.
+From the same `gnovm` sub-folder, you can run:
+
+```bash
+make install
+```
+
+To verify the `gno` binary is installed system-wide, you can run:
+
+```bash
+gno --help
+```
+
+You should get the help output from the command:
+
+![gno help](../../static/img/getting-started/installation/gno-help.gif)
+
+Alternatively, if you don't want to have the binary callable system-wide, you can run the binary directly:
+
+```bash
+go run ./cmd/gno --help
+```
+
+## 3. Installing other `gno` tools
+
+The next step is to install several other tools that are required for the Gno development environment, like
+
+- `gnoland` - the Gno [blockchain node](setting-up-a-local-chain.md)
+- `gnokey` - the Gno [private key manager](creating-a-key-pair.md)
+- `gnoweb` - the Gno [source code viewer](browsing-gno-source-code.md)
+- `gnofaucet` - the Gno [native currency faucet](setting-up-funds/running-a-faucet.md)
+
+To build these tools, from the root directory navigate to the `gno.land` sub-folder, and run the `build` make
+directive:
+
+```bash
+cd gno.land
+make build
+```
+
+This will build out the necessary binaries into the `gno.land/cmd` sub-folder:
+
+![gno tools build](../../static/img/getting-started/installation/make-build-gnoland.gif)
+
+Same as with the `gno` tool, we can make these binaries available system-wide.
+From the same `gno.land` sub-folder, you can run:
+
+```bash
+make install
+```
+
+To verify that, for example, the `gnokey` binary is installed system-wide, you can run:
+
+```bash
+gnokey --help
+```
+
+You should get the help output from the command:
+
+![gnokey help](../../static/img/getting-started/installation/gnokey-help.gif)
+
+## Conclusion
+
+That's it 🎉
+
+You have successfully built out and installed the necessary tools for Gno development!
+
+In further documents, you will gain a better understanding on how they are used to make Gno work.

docs/gno-docs/docs/getting-started/setting-up-a-local-chain.md

@@ -0,0 +1,7 @@
+---
+id: setting-up-a-local-chain
+---
+
+# Setting up a Local Chain
+
+TODO

docs/gno-docs/docs/getting-started/setting-up-funds/premining-balances.md

@@ -0,0 +1,106 @@
+---
+id: premining-balances
+---
+
+# Premining Balances
+
+## Overview
+
+In this tutorial, you will gain an understanding on how to premine native currency on a local Gno.land chain.
+Additionally, you will understand how to query the account balance after you premine it.
+
+Premining balance is the process of making sure some accounts (addresses) have specific funds when the chain initially
+launches. In the context of local chain deployments, premine balances are used to ensure the user accounts (developers)
+have ample funds to interact with the chain and facilitate contract deployments.
+
+## Prerequisites
+
+- **`gnoland` and `gnokey` set up. Reference the [Installation](../installation.md#3-installing-other-gno-tools) guide
+  for steps**
+
+## 1. Clean chain data
+
+In order for us to premine funds on a fresh chain, we need to make sure we do not have any leftover blockchain data
+from previous chain runs.
+
+The blockchain node, when it runs, works with an embedded DB locally on disk to store execution data (such as
+configuration files, or the state DB). For Gno blockchain nodes, this working directory is labeled as `testdir` by
+default.
+
+To clean out old blockchain data, navigate to the `gno.land` folder and run the appropriate make command:
+
+```bash
+cd gno.land
+make fclean
+```
+
+## 2. Change the `genesis_balances.txt` file
+
+When the Gno node boots up, among other things, it reads a file called `genesis_balances.txt` to generate the initial
+balance set for the blockchain.
+
+An example of how this looks like in the initial `genesis.json` file after the chain starts:
+
+```bash
+  "app_state": {
+    "@type": "/gno.GenesisState",
+    "balances": [
+      "g1jg8mtutu9khhfwc4nxmuhcpftf0pajdhfvsqf5=10000000000000ugnot",
+      "g1us8428u2a5satrlxzagqqa5m6vmuze025anjlj=10000000000000ugnot",
+      "g1f4v282mwyhu29afke4vq5r2xzcm6z3ftnugcnv=1000000000000ugnot",
+      "g127jydsh6cms3lrtdenydxsckh23a8d6emqcvfa=1000000000000ugnot"
+    ],
+``` 
+
+The `genesis_balances.txt` file is located at `./gno.land/genesis/genesis_balances.txt`.
+
+To add a new entry to the premine table, simply append a line to the end of the file:
+
+```bash
+g1qpymzwx4l4cy6cerdyajp9ksvjsf20rk5y9rtt=10000000000ugnot # My address
+```
+
+Replace `g1qpymzwx4l4cy6cerdyajp9ksvjsf20rk5y9rtt` with the address you want balance on, and `10000000000ugnot` with the
+desired `ugnot` balance.
+
+## 3. Start the local chain
+
+Now that our address and the desired premine balance is located in the `genesis_balances.txt` file, we can start the
+local Gno node.
+
+To run the local Gno node, make sure you are in the `gno.land` sub-folder, and run the appropriate make command:
+
+```bash
+cd gno.land
+gnoland start
+```
+
+This command will initialize the Gno node, generate the `genesis.json` with our newly added premine information, and
+start the chain.
+
+![gnoland start](../../../static/img/getting-started/setting-up-funds/gnoland-start.gif)
+
+## 3. Check the account balance
+
+To check the balance of any account (or the account we just premined), we can use the following ABCI query:
+
+```bash
+gnokey query --remote localhost:26657 bank/balances/g1qpymzwx4l4cy6cerdyajp9ksvjsf20rk5y9rtt
+```
+
+Let's break down this command:
+
+- **`--remote`** - the JSON-RPC URL of the running Gno node. In the case of a local deployment, the default value
+  is `localhost:26657`
+- **`bank/balances/g1qpymzwx4l4cy6cerdyajp9ksvjsf20rk5y9rtt`** - the ABCI query targets the `bank` module to find
+  the `balances` for address `g1qpymzwx4l4cy6cerdyajp9ksvjsf20rk5y9rtt`. Replace the address with your desired address
+
+![gnokey query](../../../static/img/getting-started/setting-up-funds/gnokey-query.gif)
+
+## Conclusion
+
+That's it 🎉
+
+You have successfully premined a native currency balance on a locally-running Gno chain!
+Additionally, you have also learned how to query the native currency balance for an address, using built-in ABCI queries
+and the `gnokey` tool.