Skip to main content

Develop a Smart Contract


Below is an example that use @artela/aspect-tool to deploy storage contract to Artela TestNet.


1. Setting up a new project​

Make sure you have a recent version of Node.js and npm installed, Start by installing the aspect-tool:

npm install -g @artela/aspect-tool

Project Initialization, to kick off your project with aspect-tool, follow these steps:

# Create a new directory and navigate into it
mkdir storage-demo && cd storage-demo

# Set up the npm project with aspect-tool
aspect-tool init

# Install the necessary dependencies
npm install

This will create a project directory with the following structure:

β”œβ”€β”€ asconfig.json
β”œβ”€β”€ aspect <-- Your aspect code resides here
β”‚Β Β  └── index.ts <-- Entry functions for the aspect
β”œβ”€β”€ contracts <-- Place your smart contracts here
β”œβ”€β”€ package.json
β”œβ”€β”€ project.config.json
β”œβ”€β”€ scripts <-- Utility scripts, including deploying, binding and etc.
β”‚Β Β  β”œβ”€β”€ aspect-deploy.cjs
β”‚Β Β  β”œβ”€β”€ bind.cjs
β”‚Β Β  β”œβ”€β”€ contract-call.cjs
β”‚Β Β  β”œβ”€β”€ contract-deploy.cjs
β”‚Β Β  β”œβ”€β”€ contract-send.cjs
β”‚Β Β  └── create-account.cjs
β”œβ”€β”€ tests
└── tsconfig.json

2. Create a Smart Contract​

Within the contracts directory of your project, create your smart contract source files with a .sol extension.

2.1.1. create a Storage.sol file​

// SPDX-License-Identifier: GPL-3.0

pragma solidity >=0.8.2 <0.9.0;

* @title Storage
* @dev Store & retrieve value in a variable
* @custom:dev-run-script ./scripts/deploy_with_ethers.ts
contract Storage {

uint256 number;

* @dev Store value in variable
* @param num value to store
function store(uint256 num) public {
number = num;

* @dev Return value
* @return value of 'number'
function retrieve() public view returns (uint256){
return number;

3. Compile the Smart Contract​

This step relies on solc, first check if solc is installed correctly

 npm install -g solc

solc --version

Compile your contract using:

npm run contract:build

βœ… Successful compilation will generate some *.abi files in the build/contract directory.

4. Deploy the Smart Contract​

4.1 Update project.config.json​

Update the project.config.json in the root directory with the appropriate network configuration:

"node": ""

For more details regarding development environment setup, please refer to artela devnet

4.2 Create a blockchain account (optional).​

Execute the following command under the storage-demo folder to create an account if you haven't already done so:

// create  deployer

npm run account:create

  • --skfile : privateKey path for sender. (optional, default value: ./privateKey.txt).

If your account lacks test tokens, join Discord,and request some in testnet-faucet channel.

4.3 Deploy your contract​

Execute the following command within the storage-demo folder, using the provided script:

npm run contract:deploy -- --abi ./build/contract/Storage.abi \
--bytecode ./build/contract/Storage.bin

Upon successful deployment, the terminal will display the contract address.

5. Call Contract​

Execute the following command within the storage-demo folder, call the Contract

5.1 Send transaction for store​

npm run contract:send -- --contract {artToken-address} \
--abi ./build/contract/Storage.abi \
--method store \
--args 100
npm run contract:call -- --contract {artToken-address}  \
--abi ./build/contract/Storage.abi \
--method retrieve

5.2 Check transaction​

Confirm the successful on Artela TestNet blockchain explorer using transaction hash in output.