Skip to main content

Deploy smart contracts with EverDev

This guide is designed for developers interested in smart-contracts programming, irrespective of their prior experience in blockchain development.
Thanks to our well structured step by step guidance, developers will gradually learn all the information needed to start deploying and interacting with smart-contracts.

In the interest of developers, Everscale network puts at their disposal smart-contracts programming using developer-friendly languages: Solidity and C++.

It should be noted that for developers experienced with Python or other languages such as C, C++, JavaScript, and C#, starting programming smart-contracts will be of maximum ease due to syntax similarity.
Familiarity with the mentioned programming languages will help developers make sense of differences in smart-contract languages.

Before proceeding with the launch of your Dapp, let us first go through an overview explaining what technical information needed for up-to-date smart-contracts programming we prepared for our developers.

What you can learn

Experienced developers with advanced knowledge of Solidity programming language and solid understanding of Ethereum blockchain design, are advised to consult our Learn section where all necessary technical information is provided in a comprehensive way.

For those with no prior knowledge of smart contracts, as well as for intermediaries and advanced developers who strive to learn new things in the blockchain industry, we recommend you to consult our DeBots page.
DeBots, in essence, is an intuitive, no prior knowledge required interface for smart contracts on the Everscale blockchain.

Having studied the information provided above, now, let's start our DApp launch.

Prerequisite

Generate a new project

mkdir my-project && cd $_
npm init --force
npm install --save everdev

Configure Giver

Giver wallet that will sponsor EVER for deploy operation.

Configure shared private key:

npx everdev signer add giver 172af540e43a524763dd53b26a066d472a97c4de37d5498170564510608250c3

Set Local Blockchain SE (Startup Edition) as the default network:

Startup SE at this step, you may have to wait until the docker image is downloaded:

npx everdev se start

A local network explorer is available at localhost check it.

Setup giver:

address=0:b5e9240fc2d2f1ff8cbb1d1dee7fb7cae155e5f6320e585fcc685698994a19a5
npx everdev network giver se $address --signer giver

Generate a new smart-contract

npx everdev sol create App

You got App.sol:

pragma ton-solidity >= 0.35.0;
pragma AbiHeader expire;

// This is class that describes you smart contract.
contract App {
// Contract can have an instance variables.
// In this example instance variable `timestamp`
// is used to store the time of `constructor`
// or `touch` function call.
uint32 public timestamp;

// Contract can have a `constructor`.
// The function that will be called when contract will be deployed to the blockchain.
// In this example constructor adds current time to the instance variable.
// All contracts need call `tvm.accept()` for succeeded deploy.
constructor() public {
// Check that contract's public key is set
require(tvm.pubkey() != 0, 101);
// Check that message has signature (msg.pubkey() is not zero) and
// message is signed with the owner's private key
require(msg.pubkey() == tvm.pubkey(), 102);
// The current smart contract agrees to buy some gas to finish the
// current transaction. This actions required to process external
// messages, which bring no value (hence no gas) with themselves.
tvm.accept();

timestamp = now;
}

function renderHelloWorld () public pure returns (string) {
return 'helloWorld';
}

// Updates variable `timestamp` with current blockchain time.
function touch() external {
// Each function that accepts external message must check that
// message is correctly signed.
require(msg.pubkey() == tvm.pubkey(), 102);
// Tells to the TVM that we accept this message.
tvm.accept();
// Update timestamp
timestamp = now;
}

function sendValue(address dest, uint128 amount, bool bounce) public view {
require(msg.pubkey() == tvm.pubkey(), 102);
tvm.accept();
// It allows to make a transfer with arbitrary settings
dest.transfer(amount, bounce, 0);
}
}

For more about Solidity and specific of Everscale Solidity

Compile smart-contract

npx everdev sol compile App.sol

You are got:

  • App.abi.jsonABI *.abi.json file — a file that describes the contract interface, the methods and parameters used to interact with it, for detail see ABI Specification V2.
  • App.tvcTVC *.tvc file — the compiled smart contract file. Used only when generating contract address and deploying contract code to the blockchain.

Deploy smart-contract

Generate the key pair for deploy contract

Key pair file — used calculate address contracts. In --sign parameter the corresponding seed phrase may be used instead of it.

npx everdev signer generate coder
npx everdev signer default coder

Deploy

note

The 1 EVER is 1000000000 nano EVER

npx everdev contract deploy --network se --value 1000000000 App

Address smart-contract

Address of smart-contract is calculated from TVC and signer (coder) public:

npx everdev contract info --network se --signer coder App

Interact with smart-contract

Read:

npx everdev contract run-local --network se App renderHelloWorld
npx everdev contract run-local --network se App timestamp

Write:

npx everdev contract run --network se --signer coder App touch

For more details see: Get started with Development Tools.