Skip to main content

Deploy

To deploy a smart contract on Quai Network, you simply send a transaction containing the contract bytecode without specifying a recipient.

Once deployed, your smart contract will be available to any user on the network to interact with.

How to Deploy a Smart Contract​

Requirements​

To deploy a smart contract on Quai, you'll need a few things:

  • QUAI to cover gas: similar to a normal transaction, you'll need to set your gas limit. Be aware that contract deployment requires significantly more gas than a simple transfer.
  • Contract Bytecode: generated using a compiler.
  • Deployment script or plugin
  • Access to a Quai node: you can do this either by running your own node, accessing a publicly available node, or through API key via a node service.

Deployment​

Smart contracts on Quai Network can be deployed using a number of different methods. The most straightforward and widely used methods are using deployment tools like Hardhat. Contracts can also be deployed using the quais.js library, which offers increased flexibility and the ability to deploy via frontend or simple script.

Information on how to deploy a simple smart contract with hardhat can be found in the Solidity Deployment Tutorial.

Cross-Chain Smart Contracts​

Contrary to monolithic blockchains, Quai Network's multi-threaded architecture allows for the deployment of multi-chain smart contracts. These are smart contracts present in a single network context that contain references to sister contracts in alternate context(s). Multi-chain referencing smart contracts allow you as a developer to create seamless cross-chain applications that can:

  • Asynchronously track state of contracts within other chains in the network
  • Natively transfer value and tokens to different contexts without bridges
  • Create a network secured mesh of smart contracts

Multi-Chain Deployment​

Sister contracts are created by deploying contracts across all chains that the project intends to support. After the deployment of these sister contracts, a trust on first-use (TOFU) strategy is used to link the contracts together, allowing each contract to be aware of the state and activities of all of its sisters. Each sister contract contains an objective reference to the public address of every other sister contract.

Contracts intended to function across many chains will contain initially empty slots for the addresses of its sisters. If a contract intends to maintain functionality across the initial network of 9 chains, 8 slots are required for all 8 sister contracts to be referenced.

Tutorials on how to deploy a multi-chain smart contracts with hardhat can be found in the SolidityX Deployment Tutorial.

Resources for automated cross-chain deployment and sister contract linking and be found in the quais-by-example repository.