Skip to content

iov-one/starnamed

Repository files navigation

Starnamed - A Cosmos SDK blockchain

Go Report Card GoDoc License Discord

The project

Starname is a blockchain platform that allows users to register and manage their own decentralized domain names, which can be used for various purposes such as sending and receiving cryptocurrency, creating unique identifiers for digital assets, and more. Starname is also a decentralized identity platform that enables users to have a universal username for the blockchain world.

This repository

This repository contains the source code for the Starname blockchain. It is has as the base the code of Wasmd repository, which is extended version of Cosmos SDK repository. Allow the starname blockchain to be a Cosmos SDK blockchain with the ability to run smart contracts written in Wasm.

All the knowledge about how to maintain and use a cosmos-sdk blockchain is applicable to the starname blockchain. The only difference is that the starname blockchain can run smart contracts written in Wasm and the custom modules that are required for the starname blockchain.

Installation

To install the starnamed CLI, follow these steps:

  • Binary installation :

    • (Linux Only) Download the latest release from the v0.11.6 release page and use.
  • Source installation :

    • Install Go 1.18 or higher.
    • Clone the starnamed repository.
    • Run make install to install the starnamed CLI.
  • Using the web app:

Usage

Once you have installed the starnamed CLI, you can use it to manage your Starname account and perform various operations on the Starname blockchain. Some examples of commands that you can use are:

  • Create your key pair:

    • starnamed keys add <your_key_name> This command will generate a key pair and store it in your local keyring. You will need to use this key pair to sign transactions that you send to the Starname blockchain. Copy the mnemonic phrase and keep it safe. You will need it to recover your key pair if you lose it.
  • Adding tokens to your account:

    • you can swap at the Osmosis swap pool (https://app.osmosis.zone/swap) and transfer the tokens to your account using the IBC protocol. The osmosis app has all the necessary information to do that.
  • Using the starname module:

    • starnamed tx starname --help This command will show you all the available commands that you can use to manage your Starname account.
      • Create domain: starnamed tx starname domain-register [flags]
      • Create account: starnamed tx starname account-register [flags]
      • Create a escrow: To use this command you must own a domain or account.
        • starnamed tx starname domain-escrow-create [flags]
        • starnamed tx starname account-escrow-create [flags]
      • You can also, all information to the account and domain, renew, transfer, add a certificate or delete the account or domain.

Documentation

External links

Usage

Contributors

Thanks to the current and former employees of IOV SAS and all the open-source developers in the Cosmos community!