• Stars
    star
    1,950
  • Rank 23,766 (Top 0.5 %)
  • Language
    C++
  • License
    Other
  • Created over 8 years ago
  • Updated 6 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The blockchain for Smart Media Tokens (SMTs) and decentralized applications.

Steem - The Blockchain That Will Tokenize The Web

Welcome to the official repository for Steem, the blockchain that will revolutionize the web, and soon the blockchain for Smart Media Tokens!

Steem is the first blockchain which introduced the "Proof of Brain" social consensus algorithm for token allocation.

Being one of the most actively developed blockchain projects currently in existence, it's become fertile soil for entrepreneurial pursuits. It has also become home for many cryptocurrency centric projects.

Steem aims to be the preferred blockchain for dApp development with Smart Media Tokens at its core. With SMTs, everyone can leverage the power of Steem.

Originally, Steem was announced on the Bitcointalk forum prior to the start of any mining. (Steem is currently not mineable)

Documents

Advantages

  • Free Transactions (Resource Credits = Freemium Model)
  • Fast Block Confirmations (3 seconds)
  • Time Delay Security (Vested Steem & Savings)
  • Hierarchical Role Based Permissions (Keys)
  • Integrated Token Allocation
  • Smart Media Tokens (soon)
  • Lowest Entry-Barrier for User Adoption in the market
  • Dozens of dApps already built on Steem and many more to come

Technical Details

  • Currency symbol STEEM
  • SBD - Steem's very own stable coin with a one-way peg
  • Delegated Proof-of-Stake Consensus (DPOS)
  • 10% APR inflation narrowing to 1% APR over 20 years
    • 75% of inflation to "Proof of Brain" social consensus algorithm.
    • 15% of inflation to stakeholders.
    • 10% of inflation to block producers.

Installation

Getting started with Steem is fairly simple. You can either choose to use docker-images, build with docker manually or build from source directly. All steps have been documented and while many different OS are supported, the easiest one is Ubuntu 16.04.

Quickstart

Just want to get up and running quickly? We have pre-built Docker images for your convenience. More details are in our Quickstart Guide.

Building

We strongly recommend using one of our pre-built Docker images or using Docker to build Steem. Both of these processes are described in the Quickstart Guide.

But if you would still like to build from source, we also have build instructions for Linux (Ubuntu LTS) and macOS.

Dockerized P2P Node

To run a p2p node (ca. 2GB of memory is required at the moment):

docker run \
    -d -p 2001:2001 -p 8090:8090 --name steemd-default \
    steemit/steem

docker logs -f steemd-default  # follow along

Dockerized Full Node

To run a node with all the data (e.g. for supporting a content website) ca. 14GB of memory, and growing, is required:

docker run \
    --env USE_WAY_TOO_MUCH_RAM=1 --env USE_FULL_WEB_NODE=1 \
    -d -p 2001:2001 -p 8090:8090 --name steemd-full \
    steemit/steem

docker logs -f steemd-full

CLI Wallet

We provide a basic cli wallet for interfacing with steemd. The wallet is self-documented via command line help. The node you connect to via the cli wallet needs to be running the account_by_key_api, condenser_api, and needs to be configured to accept WebSocket connections via webserver-ws-endpoint.

Testing

See doc/devs/testing.md for test build targets and info on how to use lcov to check code test coverage.

Configuration

Config File

Run steemd once to generate a data directory and config file. The default location is witness_node_data_dir. Kill steemd. It won't do anything without seed nodes. If you want to modify the config to your liking, we have two example configs used in the docker images. ( consensus node, full node ) All options will be present in the default config file and there may be more options needing to be changed from the docker configs (some of the options actually used in images are configured via command line).

Seed Nodes

A list of some seed nodes to get you started can be found in doc/seednodes.txt.

This same file is baked into the docker images and can be overridden by setting STEEMD_SEED_NODES in the container environment at docker run time to a whitespace delimited list of seed nodes (with port).

Environment variables

There are quite a few environment variables that can be set to run steemd in different ways:

  • USE_WAY_TOO_MUCH_RAM - if set to true, steemd starts a 'full node'
  • USE_FULL_WEB_NODE - if set to true, a default config file will be used that enables a full set of API's and associated plugins.
  • USE_NGINX_FRONTEND - if set to true, this will enable an NGINX reverse proxy in front of steemd that proxies WebSocket requests to steemd. This will also enable a custom healthcheck at the path '/health' that lists how many seconds away from current blockchain time your node is. It will return a '200' if it's less than 60 seconds away from being synced.
  • USE_MULTICORE_READONLY - if set to true, this will enable steemd in multiple reader mode to take advantage of multiple cores (if available). Read requests are handled by the read-only nodes and write requests are forwarded back to the single 'writer' node automatically. NGINX load balances all requests to the reader nodes, 4 per available core. This setting is still considered experimental and may have trouble with some API calls until further development is completed.
  • HOME - set this to the path where you want steemd to store it's data files (block log, shared memory, config file, etc). By default /var/lib/steemd is used and exists inside the docker container. If you want to use a different mount point (like a ramdisk, or a different drive) then you may want to set this variable to map the volume to your docker container.

PaaS mode

Steemd now supports a PaaS mode (platform as a service) that currently works with Amazon's Elastic Beanstalk service. It can be launched using the following environment variables:

  • USE_PAAS - if set to true, steemd will launch in a format that works with AWS EB. Containers will exit upon failure so that they can be relaunched automatically by ECS. This mode assumes USE_WAY_TOO_MUCH_RAM and USE_FULL_WEB_NODE, they do not need to be also set.
  • S3_BUCKET - set this to the name of the S3 bucket where you will store shared memory files for steemd in Amazon S3. They will be stored compressed in bz2 format with the file name blockchain-$VERSION-latest.tar.bz2, where $VERSION is the release number followed by the git short commit hash stored in each docker image at /etc/steemdversion.
  • SYNC_TO_S3 - if set to true, the node will function to only generate shared memory files and upload them to the specified S3 bucket. This makes fast deployments and autoscaling for steemd possible.

System Requirements

For a full web node, you need at least 110GB of disk space available. Steemd uses a memory mapped file which currently holds 56GB of data and by default is set to use up to 80GB. The block log of the blockchain itself is a little over 27GB. It's highly recommended to run steemd on a fast disk such as an SSD or by placing the shared memory files in a ramdisk and using the --shared-file-dir=/path command line option to specify where. At least 16GB of memory is required for a full web node. Seed nodes (p2p mode) can run with as little as 4GB of memory with a 24 GB state file. Any CPU with decent single core performance should be sufficient. Steemd is constantly growing. As of August 2017, these numbers were accurate, but you may find you need more disk space to run a full node. We are also constantly working on optimizing Steem's use of disk space.

On Linux use the following Virtual Memory configuration for the initial sync and subsequent replays. It is not needed for normal operation.

echo    75 | sudo tee /proc/sys/vm/dirty_background_ratio
echo  1000 | sudo tee /proc/sys/vm/dirty_expire_centisecs
echo    80 | sudo tee /proc/sys/vm/dirty_ratio
echo 30000 | sudo tee /proc/sys/vm/dirty_writeback_centisecs

No Support & No Warranty

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

More Repositories

1

condenser

The greatest application front-end to the Steem Blockchain.
JavaScript
506
star
2

steem-js

Steem.js the official JavaScript library for Steem blockchain
JavaScript
471
star
3

steem-python

The official Python (3) library for the Steem Blockchain.
Python
154
star
4

devportal

Steem Platform Developer Documentation.
CSS
121
star
5

hivemind

Developer-friendly microservice powering social networks on the Steem blockchain.
Python
73
star
6

devportal-tutorials-js

Tutorials for the Developer Portal
JavaScript
44
star
7

sbds

Steem Blockchain Data Service
Python
37
star
8

smt-whitepaper

Smart Media Tokens whitepaper
TeX
29
star
9

jussi

JSON-RPC 2.0 Reverse Proxy Frontend for Steemit
Python
27
star
10

faucet

Steemit Account Creation Web Application
CSS
22
star
11

steem-uri-spec

steem:// signing spec and reference implementation
TypeScript
14
star
12

wallet

The wallet functionality of condenser
JavaScript
12
star
13

koa-jsonrpc

TypeScript
10
star
14

rcdemo

Python
10
star
15

rpc-auth

JSON-RPC 2.0 request authentication with Steem authorities
TypeScript
9
star
16

devportal-tutorials-py

Python
9
star
17

steem-ruby

Steem-ruby is the official Ruby library for the Steem blockchain
Ruby
9
star
18

lineman

JSON-RPC 2.0 WebSocket to HTTP proxy
TypeScript
8
star
19

tinman

Testnet management scripts
Python
8
star
20

yo

Modular event-driven notification service
Python
7
star
21

whitepaper

Steem Platform Whitepaper 2.0.
Makefile
7
star
22

steemnotify

Lua
6
star
23

libcrypto-js

Cryptographic utilities for Steem in Javascript. Zero dependencies.
JavaScript
5
star
24

redeemer-irredeemables

Makefile
4
star
25

hivemind-ruby

Ruby Object Relational Mapping for Hivemind
Ruby
4
star
26

steemdb

Volt
3
star
27

dbadmin

Admin console for steemit.com's backend database built with activeadmin
Ruby
3
star
28

bluepaper

Steem Bluepaper
Shell
3
star
29

conveyor

Conveyor - Steemit APIs
TypeScript
3
star
30

swift-steem

Steem client library for iOS, macOS and Linux written in Swift
C
3
star
31

irredeemables

General abuse list for filtering from frontends via hivemind
Makefile
2
star
32

simple_steem_client

A minimalist Steem RPC client in Python
Python
2
star
33

steemit-render

TypeScript
2
star
34

smt-wizard

A web based Smart Media Token (SMT) creation wizard.
HTML
2
star
35

hive2elastic

Fork of https://github.com/esteemapp/hive2elastic
Python
1
star
36

steem-docs

1
star
37

sdc-frontend

The nginx frontend proxy server for the sdc app
Shell
1
star
38

steem-deployments

steemit specific deployment scripts
Shell
1
star