Skip to main content

Deploy an EOS dApp on WAX

WAX is fully compatible with EOS smart contracts and offers free blockchain accounts and cheaper fees. This guide provides an overview of how to deploy your EOS dApps to the WAX mainnet.

Blockchain Accounts​

  1. To deploy your smart contracts to the WAX mainnet, you'll need to create a self-managed WAX Blockchain Account.

  2. Make sure you have enough WAX staked in your account to allocate resources.

  3. If your dApp interacts with blockchain accounts, your customers will also need to create a free, verified WAX Blockchain Account. You can send them to the following link:

    http://all-access.wax.io

    A WAX Cloud Wallet Account automatically creates a WAX Blockchain account for your customers and allows you to integrate WaxJS into your dApps. Refer to WAX Cloud Wallet Quickstartfor more information.

Development Environment​

If you'd like to test your smart contracts on WAX, you can:

  • Complete our Docker Quickstart(recommended) or use the WAX Blockchain Setupto build from source.
  • Build your contracts using the [WAX Contract Development Toolkit (WAX-CDT)](/docs/dapp-development/wax-cdt/.
  • [Set Up a Local dApp Environment](/docs/dapp-development/setup-local-dapp-environment/.
  • Deploy to the [WAX Testnet](/docs/dapp-development/testnet-quickstart/.
tip
Warning: Setting up WAX source code in your local development environment will overwrite a current EOS installation. If you'd like to keep your EOS environment, it's recommended that you use Docker, a virtual machine, or a separate development environment.

Deploy Your Smart Contracts​

You must compile your smart contracts using the [WAX Contract Development Toolkit (WAX-CDT)](/docs/dapp-development/wax-cdt/.

If you don't want to install the WAX source code, you can use our Docker Quickstartor custom scripts to deploy your smart contracts. Refer to Deploy Your dApp on WAXfor more information.