Skip to main content

Development Environment

Development Environment​

Before You Start​

To develop smart contracts, you need to install the .NET SDK. Other tools for starting aelf nodes and publishing contracts are optional.

macOS Setup​

  1. Requirements:

    • macOS 10.7 or higher
    • 2GHz processor (3GHz recommended)
    • 8 GB RAM (16 GB recommended)
    • 10 GB free space
    • Broadband internet

  2. Apple M1 Support: Install Rosetta:

    Terminal
    /usr/sbin/softwareupdate --install-rosetta --agree-to-license

  3. Install Homebrew:

    Terminal
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    brew --version
    brew update

  4. Install Git:

    Terminal
    brew install git
    git --version

  5. Install .NET SDK:

    Terminal
    brew install --cask dotnet-sdk
    dotnet --version

  6. Install protoBuf:

    Terminal
    brew install protobuf
    protoc --version

  7. Install Redis:

    Terminal
    brew install redis
    redis-server

mac_install_redis1

  1. Install Node.js:

    Terminal
    brew install node
    npm --version

  2. Install aelf-command:

    Terminal
    npm i aelf-command -g

  3. Create an aelf Account:

    Terminal
    aelf-command create

    Similar Output:

    Terminal
    AElf [Info]: Your wallet info is :
    AElf [Info]: Mnemonic            : mirror among battle muffin cattle plunge tuition buzz hip mad surround recall
    AElf [Info]: Private Key         : 4bf625afea60e21aa5afcab5ea682b3dfb614941245698632d72a09ae13*****
    AElf [Info]: Public Key          : 04f9bb56a9eca921bd494e677307f0279c98f1d2ed6bdeaa6dd256878272eabd14e91ec61469d2a32ce5e63205930dabdc0b9f13fc80c1f4e31760618d182*****
    AElf [Info]: Address             : 21qciGwcaowwBttKMjMk86AW6WajhcodSHytY1vCyZb7p*****

Linux Setup​

  1. Requirements:

    • Ubuntu 18.04
    • Broadband internet

  2. Update Environment:

    Terminal
    sudo apt-get update

  3. Install Git:

    Terminal
    sudo apt-get install git -y
    git --version

  4. Install .NET SDK:

    Terminal
    wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
    sudo dpkg -i packages-microsoft-prod.deb
    sudo apt-get update
    sudo apt-get install -y dotnet-sdk-6.0
    dotnet --version

  5. Install protoBuf:

    Terminal
    curl -OL https://github.com/google/protobuf/releases/download/v21.9/protoc-21.9-linux-x86_64.zip
    unzip protoc-21.9-linux-x86_64.zip -d protoc3
    sudo mv protoc3/bin/* /usr/local/bin/
    sudo mv protoc3/include/* /usr/local/include/
    protoc --version

  6. Install Redis:

    Terminal
    sudo apt-get install redis -y
    redis-server

  7. Install Node.js:

    Terminal
    curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
    sudo apt-get install -y nodejs
    npm --version

  8. Install aelf-command:

    Terminal
    npm i aelf-command -g

  9. Create an aelf Account:

    Terminal
    aelf-command create

Windows Setup​

  1. Requirements:

    • Windows 10 or higher
    • Broadband internet

  2. Install Chocolatey:

    Terminal
    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
    choco

  3. Install Git:

    Terminal
    choco install git -y
    git --version

  4. Install .NET SDK:

    Terminal
    choco install dotnetcore-sdk -y
    dotnet --version

  5. Install protoBuf:

    Terminal
    choco install protoc -y
    protoc --version

  6. Install Redis:

    Terminal
    choco install redis-64 -y
    redis-server

windows_install_redis1

  1. Install Node.js:

    Terminal
    choco install nodejs -y
    npm --version

  2. Install aelf-command:

    Terminal
    npm i aelf-command -g

  3. Create an aelf Account:

    Terminal
    aelf-command create

Codespaces Setup​

  1. Open Codespaces: codespaces11

  2. Visit the aelfProject repo.

  3. Click "Code" > "Codespaces" > "+" to create a new codespace. codespaces21

  4. Check Installed Versions:

    Terminal
    git --version
    npm --version

  5. Update Environment:

    Terminal
    sudo apt-get update

  6. Install .NET SDK:

    Terminal
    wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
    sudo dpkg -i packages-microsoft-prod.deb
    sudo apt-get update
    sudo apt-get install -y dotnet-sdk-6.0
    dotnet --version

  7. Install protoBuf:

    Terminal
    curl -OL https://github.com/google/protobuf/releases/download/v21.9/protoc-21.9-linux-x86_64.zip
    unzip protoc-21.9-linux-x86_64.zip -d protoc3
    sudo mv protoc3/bin/* /usr/local/bin/
    sudo mv protoc3/include/* /usr/local/include/
    protoc --version

  8. Install Redis:

    Terminal
    sudo apt-get install redis -y
    redis-server

  9. Install aelf-command:

    Terminal
    npm i aelf-command -g

  10. Create an aelf Account:

    Terminal
    aelf-command create