How to
Deploy on Supra
in 10 Steps!
Get Started
Building on
Supra!
Welcome, here is your quick guide to getting
started with blockchain development on
Supra's Layer 1 (L1).
Getting started with blockchain development can be overwhelming
due to the variety of tools, concepts, and technologies involved.
That’s exactly why this guide exists—to simplify the process and
break everything down into easy, actionable steps.
To build and interact effectively with any L1, including Supra's, you
need to know what tools you’re working with. This isn't just a random
list; it's your starter pack filled with the key components every
developer needs to get started with confidence.
2
If you're starting fresh, here are the
basic steps to get up and running
on Supra's Layer 1.
Step-by-Step
Starting
from Scratch
3
The Command Line Interface (CLI)
is your gateway to interacting with
Supra's blockchain.
Downloading CLI
4
01 Docker allows you to create an environment for Supra’s CLI
by storing it in a container, which holds all the necessary files
in an isolated setting.
Download Docker: For Windows, Mac, Linu
Follow Docker post-installation steps.
(Linux only, if needed).
5
02 Create a folder for your Docker container environment
Open your Command Prompt terminal
Create a folder in your Documents, called supra.
Type in Command Prompt:
cd Documents && mkdir supra
Note: You can make this folder anywhere you would like,
we have suggested an example so it’s easier to follow.
Example:
Type in Command Prompt:
curl --output compose.yaml "https://
raw.githubusercontent.com/Entropy-Foundation/supra-
dev-hub/refs/heads/main/Scripts/compose.yaml"
6
03 Start Your Docker Environment
Execute the command to create your container using
the compose.yaml file. This file includes all the necessary
parameters for the container setup.
Type in Command Prompt:
docker compose up -d
This will create your supra_cli container.
04 Enter Your Container
To be able to interact with SupraCLI, we will work from within
the container.
Type in Command Prompt:
docker exec -it supra_cli /bin/bash
7
05 Type supra
While being in your supra_cli container, type supra
8
Your profile acts as your
blockchain identity, allowing
you to sign transactions and
interact with the network.
Creating
a Profile
9
06 Generate Profile
To create a profile, you will need to type in Command
Prompt:
supra profile new <PROFILE_NAME>
10
Before you can interact with the
network or deploy smart contracts,
you'll need testnet $SUPRA to
cover transaction fees.
Fund a Profile
11
07 Add Testnet $SUPRA to Your Profile
To fund your profile with testnet $SUPRA, run the following
command in your terminal:
supra move account fund-with-faucet --profile
<PROFILE_NAME> --rpc-url <RPC_URL>
Note: Here is the RPC_URL network information
12
Interacting with a smart contract
allows you to deploy, manage, and
test its functions directly on the
blockchain, ensuring it performs
as intended.
Interact
with Smart
Contract
13
08 Create a New Move Package
In your supra_cli container move into the folder configs
Create a folder called move_workspace
Directory Structure in Docker Container:
supra_cli/
└── supra/
└── configs/
└── move_workspace/
└── <project_folder>/
Type in Command Prompt:
supra move tool init --package-dir /supra/configs/
move_workspace/<PROJECT_NAME> --name <PACKAGE_NAME>
14
09 Add Your Address to the Environment
Open the Move.toml file and enter your exampleAddress
under the profile created in Step 6. Replace the placeholder
text "Enter Your Address" with your actual address.
Note: To view your profile list, run: supra key -l
Use the account_address from that list when adding it to
your Move.toml.
15
10 Publish the “transfer” Smart Contract on Supra L1
Copy the “transfer” module from the Write a Module section.
Then run the following command in your terminal:
supra move tool publish --package-dir /supra/
configs/move_workspace/<PROJECT_NAME> --profile
<YOUR_PROFILE> --rpc-url <RPC_URL>
Note: Here is the RPC_URL network information
16
You have officially deployed your first smart
contract on Supra’s L1—congrats!
This is just the beginning of your journey as a blockchain
developer. Now that you’ve mastered the basics, you can start
exploring more complex smart contract functionalities,
experiment with dApp development, and contribute to the
growing Supra ecosystem.
Continue building and expanding your skills with Supra’s
developer tools and resources.
17
Here are some example smart
contracts to help you dive
deeper and expand your skills.
Example Smart
Contracts to
Get You Rolling
18
Crypto Index Fund Smart Contract
Build a crypto index fund smart contract using
Supra's price feed Oracle with the Move
programming language on the Sui Blockchain.
This guide walks you through creating an
index fund that tracks the value of a basket of
crypto assets with equal weighting, integrating
Supra's Oracle for real-time price data.
Visit Guide →
Crowdfunding Smart Contract
Learn how to create a crowdfunding smart
contract using Supra’s price feed Oracle on the
Sui blockchain. This guide demonstrates how
easily Supra's Oracle can be integrated into any
smart contract, equipping you to add price
feed functionality to your own projects.
Visit Guide →
Lottery Smart Contract
This guide shows you how to build a lottery
smart contract using Supra's Verifiable Random
Function (VRF) on the Aptos blockchain.
Integrating the Supra VRF ensures fairness and
transparency in the lottery draw. You'll also
learn how to apply VRF in other smart contract
use cases.
Visit Guide →
19
Important
Resources
for Supra
20
Supra's Developer
The central hub for all technical resources,
Documentation guides, and APIs. It provides comprehensive
documentation for Supra's tools, APIs,
SDKs, and best practices.
Supra's Dev Docs are the foundation of your
development journey. They help you
understand Supra's architecture, coding
standards, and tools, making it easier to build
secure, efficient, and scalable dApps. If you
ever get stuck, this should be your first stop.
Developer Documentation →
Supra's Network
This section breaks down the nuts and bolts
Information of Supra's network, including RPC URLs, node
configurations, and how the infrastructure
works behind the scenes.
To build on Supra, you need to connect to
the right network—whether it's the testnet
for experimenting or the mainnet for real
deployments. This resource ensures you're
plugged into the correct environment for
your development needs.
Network Information →
21
Install Supra's CLI The Command Line Interface (CLI) is your
direct line to Supra's blockchain. It's like having
a backstage pass that lets you deploy smart
contracts, interact with the network, and manage
nodes from your terminal.
The CLI streamlines your workflow, making it
faster and easier to handle development
tasks. Whether you're deploying a contract or
checking network status, the CLI puts powerful
tools right at your fingertips.
Prerequisites: Download Docker
Download Link →
Post Installation Steps (Linux Only) →
Download Supra CLI →
Creating CLI
Key profiles are like your digital ID on
Key Profiles the blockchain. They use cryptography to sign
transactions securely, ensuring your activity
is verified and authentic.
Without key profiles, you can't interact
with the blockchain in a meaningful way.
They're essential for deploying contracts,
transferring tokens, and maintaining
security across the network.
CLI Key Profiles →
22
Testnet Faucet A faucet provides free testnet tokens,
which are like play money for developers.
You can use them to simulate transactions
and test your smart contracts.
Testing is crucial in blockchain development.
The faucet lets you experiment freely without
risking real funds, helping you catch bugs
and optimize your code before going live.
Testnet Faucet →
Learn Move 101 An introductory guide to the Move programming
language, designed specifically for building
secure, high-performance smart contracts.
Move is at the core of Supra's smart contract
development. Understanding its principles and
syntax will help you write more safe, and more
scalable contracts for Supra's ecosystem.
Move 101 →
23
StarKey Wallet A secure, easy-to-use wallet for managing
your Supra tokens, interacting with dApps,
and signing transactions.
A good wallet is essential for both developers
and users. StarKey makes it simple to manage
your assets, test dApps, and participate in the
Supra ecosystem without hassle.
StarKey Wallet →
Block Explorer
A blockchain explorer that lets you view
(SupraScan) transactions, monitor smart contracts, and
track network activity in real-time.
Transparency is a core principle of blockchain.
SupraScan helps you audit transactions,
debug smart contracts, and gain insights into
how your dApp interacts with the network.
SupraScan →
24
Supra Dev-Hub This repository is a central hub for developers
working on the Supra L1 Chain. It provides
essential resources, troubleshooting guides,
and a collaborative platform for discussions
and issue resolution.
Whether you're looking for community support,
sharing insights, or resolving technical issues,
Supra Dev-Hub is your go-to resource for
collaborative development.
Supra Dev-Hub →
Supra Move VS A powerful VS Code plugin built to simplify
Extension development on Supra's MoveVM.
It brings syntax highlighting, smart suggestions,
and auto-completion right into your editor — no
more jumping between tabs or docs.
This is your go-to tool for writing, testing, and
navigating Move smart contracts faster and
cleaner inside VS Code.
Supra Move VS Extension →
25
Supra Dapp Your fast lane to building dApps on the Supra
Templates network.
The @supranpm/supra-dapp-templates
package jumpstarts your development with
ready-to-use templates — whether you're
testing contracts, integrating StarKey Wallet, or
building with Supra's SDK and VRF.
Just run one CLI command and follow the
prompts. It’s that easy.
From boilerplates to full-stack examples, these
templates help you go from zero to deployed
without the setup headache. Great for
hackathons, MVPs, or learning the stack.
Supra Dapp Templates →
26
