gotabit

README

GotaBit Chain

The full-node software implementation of the GotaBit blockchain.

Explore the Docs

· Rest API · RPC API · GotaBit Scan · Chain App

Table of Contents

• What is GotaBit?
• Installation
  • From Binary
  • From Source
  • GotaBitd
• Node Setup
• Validators
• Delegators
• Testnet
• Talk to us
• License

What is GotaBit?

GotaBit is a public, open-source, proof-of-stake, sovereign blockchain in the Cosmos ecosystem. It aims to provide a sandbox environment for the deployment of such inter-operable smart contracts.

The network serves as a decentralized, permissionless, and censorship resistant zone for developers to efficiently and securely launch application specific smart contracts.

The GotaBit is powered by the Cosmos SDK, CosmWasm and Tendermint BFT consensus.

Installation

From Binary

The easiest way to install is to download a pre-built binary. You can find the latest binaries on the releases page.

From Source

Step 1: Install Golang

Go v1.18+ or higher is required for The GotaBit Node.

1. Install Go 1.18+ from the official site. Ensure that your GOPATH and GOBIN environment variables are properly set up by using the following commands:

   For Linux:

   wget <https://golang.org/dl/go1.18.2.linux-amd64.tar.gz>
   sudo tar -C /usr/local -xzf go1.18.2.linux-amd64.tar.gz
   export PATH=$PATH:/usr/local/go/bin
   export PATH=$PATH:$(go env GOPATH)/bin
   

   For Mac:

   export PATH=$PATH:/usr/local/go/bin
   export PATH=$PATH:$(go env GOPATH)/bin
   

2. Confirm your Go installation by checking the version:

   go version
   

Step 2: Get source code

Clone the source code from the official repo and check out the main branch for the latest stable release.

git clone https://github.com/gotabit/node
cd node
git checkout main

Step 3: Build GotaBit node

Run the following command to install gotabitd to your GOPATH and build the GotaBit node. gotabitd is the node daemon and CLI for interacting with a GotaBit node.

make install

Step 4: Verify your installation

Verify your installation with the following command:

gotabitd version --long

A successful installation will return the following:

name: gotabit
server_name: gotabitd
version: <x.x.x>
commit: <Commit hash>
build_tags: netgo,ledger
go: go version go1.18.2 linux/amd64
build_deps:
...

Gotabitd

gotabitd is the all-in-one CLI and node daemon for interacting with the GotaBit blockchain.

To view various subcommands and their expected arguments, use the following command:

 gotabitd --help

Stargate CosmosHub App

Usage:
  gotabitd [command]

Available Commands:
  add-genesis-account      Add a genesis account to genesis.json
  add-wasm-genesis-message Wasm genesis subcommands
  collect-gentxs           Collect genesis txs and output a genesis.json file
  config                   Create or query an application CLI configuration file
  debug                    Tool for helping with debugging your application
  export                   Export state to JSON
  gentx                    Generate a genesis tx carrying a self delegation
  help                     Help about any command
  init                     Initialize private validator, p2p, genesis, and application configuration files
  keys                     Manage your application's keys
  migrate                  Migrate genesis to a specified target version
  query                    Querying subcommands
  rollback                 rollback cosmos-sdk and tendermint state by one height
  start                    Run the full node
  status                   Query remote node for status
  tendermint               Tendermint subcommands
  tx                       Transactions subcommands
  validate-genesis         validates the genesis file at the default location or at the location passed as an arg
  version                  Print the application binary version information

Flags:
  -h, --help                help for gotabitd
      --home string         directory for config and data (default "/root/.gotabit")
      --log_format string   The logging format (json|plain) (default "plain")
      --log_level string    The logging level (trace|debug|info|warn|error|fatal|panic) (default "info")
      --trace               print out full stack trace on errors

Use "gotabitd [command] --help" for more information about a command.

Visit the documentation page for more info on usage.

Node Operators

If you're interested in running a node on the current GotaBit network, check out the docs to Join the GotaBit Mainnet.

Validators

If you want to participate and help secure GotaBit network, check out becoming a validator. Information on what a validator is and how to participate as one can be found at the Validator FAQ. If you're running a validator node on the GotaBit network, reach out to a Janitor on the GotaBit Discord to join the #validators-verified channel.

Delegators

If you still want to participate on the GotaBit network, check out becoming a delegator. Information what a delegator is and how to participate as one can be found at the Delegator FAQ.

Testnet

To participate in or utilize the current GotaBit testnet, take a look at the gotabit/testnets repository.

Talk to us

We have active, helpful communities on Twitter, Discord, and Telegram.

 

For updates on the GotaBit team's activities follow us on the GotaBit Twitter account.

License

This software is licensed under the Apache 2.0 license.

© 2022 GotaBit Limited