Create Contract

Create and Compile Your First Contract

In order to initialize a new Phat Contract project you can use our hello world template:

git clone

This will create a folder phat-hello in your work directory. The folder contains a scaffold Cargo.toml and a, which both contain the necessary building blocks for using Phat Contract.

The contains our hello world contract ‒ a ETH balance reader.

In order to build the contract just execute this command in the phat-hello folder:

cargo +nightly contract build

Always add +nightly when compiling your contract since ink! toolchain requires the nightly Rust. Otherwise you may encounter a lot of problems.

As a result you’ll get the following files in the target/ink folder of your contract: phat_hello.wasm, metadata.json and phat_hello.contract. The .contract file combines the WASM and metadata into one file and needs to be used when instantiating the contract.

Run Unit Tests Locally

Before you really upload and deploy your contract to the blockchain, you are encouraged run local unit tests to check its correctness.

In the phat-hello folder, run

cargo +nightly test -- --nocapture

and ensure you see all tests passed.

Do not use cargo +nightly contract test here, cargo +nightly test will give you more details if something goes wrong.

-- --nocapture is optional to see the output during testing.

Now you have successfully compiled and locally test your first Phat Contract. Now it’s time to deploy it to a real blockchain.

Edit this page on GitHub