🔷 Waves Platform Node

Waves is an open source blockchain platform.
You can use it to build your own decentralised applications. Waves provides full blockchain ecosystem including smart contracts language called RIDE.

✨ Demo

Waves node is a host connected to the blockchain network with the next functions:

• Processing and validation of transactions
• Generation and storage of blocks
• Network communication with other nodes
• REST API
• Extensions management

Learn more about Waves Node in the documentation.

🚀️ Getting started

A quick introduction of the minimal setup you need to get a running node.

Prerequisites:

• configuration file for a needed network from here
• waves-all*.jar file from releases

Linux systems:

sudo apt-get update
sudo apt-get install openjdk-8-jre
java -jar node/target/waves-all*.jar path/to/config/waves-{network}.conf

Mac systems (assuming already installed homebrew):

brew cask install adoptopenjdk/openjdk/adoptopenjdk8
java -jar node/target/waves-all*.jar path/to/config/waves-{network}.conf

Windows systems (assuming already installed OpenJDK 8):

java -jar node/target/waves-all*.jar path/to/config/waves-{network}.conf

Using docker image:

docker run -p 6869:6869 -p 6868:6868 -e WAVES_NETWORK=MAINNET -e WAVES_LOG_LEVEL=DEBUG -e WAVES_HEAP_SIZE=2g -v YOUR_LOCAL_PATH_HERE:/waves wavesplatform/node

More details on how to install a node for different platforms you can find in the documentation.

🔧 Configuration

The best starting point to understand available configuration parameters is the this article.

The easiest way to start playing around with configurations is to use default configuration files for different networks, they're available here.

Logging configuration with all available levels and parameters is described here.

👨‍💻 Development

The node can be built and installed wherever Java can run. To build and test this project, you will have to follow these steps:

sudo apt-get update
sudo apt-get install openjdk-8-jre                     # Ubuntu
# or
# brew cask install adoptopenjdk/openjdk/adoptopenjdk8 # Mac

git clone https://github.com/wavesplatform/Waves.git
cd Waves

sbt checkPR

sbt node-it/docker

sbt -Dwaves.it.max-parallel-suites=1 node-it/test

sbt node-it/testOnly *.TestClassName
# or 
# bash node-it/testOnly full.package.TestClassName

sbt packageAll                   # Mainnet
sbt -Dnetwork=testnet packageAll # Testnet

sudo dpkg -i node/target/*.deb

sbt "extension-module/run /path/to/configuration"

🤝 Contributing

If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.

For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.

Please follow the code of conduct during communication with the each other.

ℹ️ Support (get help)

Keep up with the latest news and articles, and find out all about events happening on the Waves Platform.

• Telegram Dev Chat
• Waves Blog

⛓ Links

• Documentation
• Blockchain clients for Mainnet: Waves Exchange, Waves FX, SIGN app
• Blockchain clients for Testnet: Waves Exchange
• Blockchain Explorer: Mainnet, Testnet, Stagenet
• Ride Online IDE

📝 Licence

The code in this project is licensed under MIT license

👏 Acknowledgements

We use YourKit full-featured Java Profiler to make Waves node faster. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications.

Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.