Welcome to the WAX Source Code Repository!
This software enables businesses to rapidly build and deploy high-performance and high-security blockchain-based applications. For developer tips and tutorials, refer to our WAX Blockchain Developer Hive.
The Worldwide Asset eXchange™ (WAX) is a purpose-built blockchain and protocol token designed to make e-commerce transactions faster, easier, and safer for all participants. The WAX Blockchain mainnet uses Delegated Proof of Stake (DPoS) as its consensus mechanism and is fully backward compatible with EOS. The custom features and incentive mechanisms developed by WAX are designed to optimize the blockchain’s usability in e-commerce, and encourage voting on guilds and proposals.
WAX is creating a suite of blockchain-based tools upon which dApps, marketplaces, and native non-fungible tokens (NFTs) are built. These tools include services to support e-commerce operations such as an interactive block explorer, wallet, SSO and OAUTH, item creation, an RNG service, interactive item viewers, marketplace creation, and more. The resulting technology is a blockchain architecture that is extremely fast (500 millisecond block times), fee-less for customers and less expensive for developers, and leverages voting rewards to incentivize participation in the selection of block producers and proposals.
Some of the features of WAX Blockchain include:
- Token Swap in conjunction with Genesis Block Member Rewards
- Earning staking rewards
- Incentives and mechanics to address voter apathy
- Random Number Generator Native Blockchain Service
- WAX Account - Account Creation, Voting, Token Swap, and Balances
- Integrated with the OPSkins customer base (and other reasons to run dApps on WAX)
These features are in addition to the benefits you will find on EOSIO. The WAX Blockchain is a variant of EOSIO (see WAX_RELEASE_NOTES.md for details).
WAX is released under the open source MIT license and is offered “AS IS” without warranty of any kind, express or implied. Any security provided by the WAX software depends in part on how it is used, configured, and deployed. WAX is built upon many third-party libraries such as WABT (Apache License) and WAVM (BSD 3-clause), which are also provided “AS IS” without warranty of any kind. Without limiting the generality of the foregoing, WAX makes no representation or guarantee (and disclaims all implied warranties and guarantees) that WAX or any third-party libraries will perform as intended or will be free of errors, bugs or faulty code. Both may fail in large or small ways that could completely or partially limit functionality or compromise computer systems. If you use or implement WAX, you do so at your own risk. In no event will WAX be liable to any party for any damages whatsoever, even if it had been advised of the possibility of damage.
There is no public testnet running currently.
Installation Instructions
You have several ways to run a node and develop smart contracts on the WAX Blockchain:
- Use our production docker images. This is the official and recommended way, also the faster one, you can run a node in seconds. See the mainnet sample for more information.
- Complete our Docker Quickstart. You can also find WAX tutorials in the dApp Development section of the WAX Blockchain Developer Hive.
- Currently, we are not providing pre-compiled packages. Therefore, if you can't use our Docker images, you will have to compile the source code and install it with the following instructions:
Note: Building from source is not supported. We recommend using our Docker Images instead.
$ git clone https://github.com/worldwide-asset-exchange/wax-blockchain.git
$ cd wax-blockchain
$ git submodule update --init --recursive
# Build (and set the installation directory)
$ ./wax_build.sh -i ~/wax-blockchain
# This will install the blockchain in the previously set installation directory
$ ./wax_install.sh
# Optional: Add the blockchain to your path (it requires a console relogin)
echo "export PATH=~/wax-blockchain/bin:$PATH" >> ~/.bashrc
If you have previously installed wax-blockchain, please run the wax_uninstall script (it is in the directory where you cloned wax-blockchain).
Troubleshooting
If you have trouble when building the blockchain, may be this can help you:
Running a full node
The mainnet directory contains configuration files and instructions to launch a full node.
Supported Operating Systems
WAX currently supports the following operating systems:
- Amazon Linux 2
- CentOS 7
- Ubuntu 16.04
- Ubuntu 18.04
- MacOS 10.14 (Mojave)