stratos-chain

README

Stratos-Chain

Stratos is the first decentralized data architecture that provides scalable, reliable, self-balanced storage, database and computation network, and offers a solid foundation for data processing. Stratos-Chain is a Golang implementation of the Stratos protocol.

---

Recommended hardware/software

• Recommended Hardware

    * CPU           i5 (4 cores)
    * RAM           16GB
    * Hard disk     2TB
  

• Software(tested version)

    * Ubuntu 18.04+
    * Go 1.16+ linux/amd64
  

• Platform

  • Linux(tested on Ubuntu18.04 and 20.04)

  • Mac OS

  • Windows

    It is possible to build and run the software on Windows. However, we did not test it on Windows completely. It may give you unexpected results, or it may require additional setup.

    An alternative option is to install a separate virtual Linux system using VirtualBox or VMware Workstation

---

Executables

The Stratos-Chain comes with 2 types of executables that can be found in stratos/stratos-chain/build directory.

Command	Description
stchaincli	the client end. It is the command line interface for interacting with stchaind. It is the entry point into the Stratos network (main-, test- or private net), capable of running as a full node (default), archive node (retaining all historical state) or a light node (retrieving data live). It can be used by other processes as a gateway into the Stratos network via JSON RPC endpoints.
stchaind	the app Daemon (server)

stchaincli

Usage:
  stchaincli [command]

Available Commands:
  status      Query remote node for status
  config      Create or query an application CLI configuration file
  query       Querying subcommands
  tx          Transactions subcommands
  rest-server Start LCD (light-client daemon), a local REST server
  keys        Add or view local private keys
  version     Print the app version
  help        Help about any command

Each stchaincli command may contain a set of flags or parameters. for more details, please refer to Stratos Chain stchaincli Commands(Part1) and Stratos Chain stchaincli Commands(Part2)

stchaind

Usage:
  stchaind [command]

Available Commands:
  init                Initialize private validator, p2p, genesis, and application configuration files
  collect-gentxs      Collect genesis txs and output a genesis.json file
  migrate             Migrate genesis to a specified target version
  gentx               Generate a genesis tx carrying a self delegation
  validate-genesis    validates the genesis file at the default location or at the location passed as an arg
  add-genesis-account Add a genesis account to genesis.json
  faucet              Run a faucet cmd
  debug               Tool for helping with debugging your application
  start               Run the full node
  unsafe-reset-all    Resets the blockchain database, removes address book files, and resets priv_validator.json to the genesis state
  tendermint          Tendermint subcommands
  export              Export state to JSON
  version             Print the app version
  help                Help about any command

Each stchaind command may contain a set of flags or parameters. for more details, please refer to Stratos-chain stchaind Commands

---

Connect to Stratos Network

Going through all the possible command line flags is out of scope here, but we've enumerated a few common parameter combos to get you up to speed quickly on how you can run your own Stratos instance.

A Full node on the test Stratos network

For prerequisites and detailed instructions of connecting to Tropos Incentive Testnet network, please read the Tropos Incentive Testnet.

Full node on the main Stratos network - TBA

Prerequisites and detailed instructions of main network will be added later.

---

Stratos Explorer

• https://explorer-tropos.thestratos.org/

---

References

• stchaincli Commands(Part1)

• stchaincli Commands(Part2)

• stchaind Commands

• REST APIs

• How to become a validator

• ppd terminal subcommands

---

Contribution

Thank you for considering to help out with the source code! We welcome contributions from anyone on the internet, and are grateful for even the smallest of fixes!

If you'd like to contribute to stratos-chain, please fork, fix, commit and send a pull request for the maintainers to review and merge into the main code base.

Please make sure your contributions adhere to our coding guidelines:

• Code must adhere to the official Go formatting guidelines (i.e. uses gofmt).
• Code must be documented adhering to the official Go commentary guidelines.
• Pull requests need to be based on and opened against the main branch.
• Commit messages should be prefixed with the package(s) they modify.
  • E.g. "eth, rpc: make trace configs optional"

---

License

Copyright 2022 Stratos

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.