@codlabs/scaf
v0.1.5
Published
Scaf is a development environment for the Sui blockchain. With Scaf you can: - Develop, build, and deploy [Sui Move smart contracts](https://docs.sui.io/build/move). - Interract with Sui Move smart contracts on `mainnet`, `testnet`, `devnet`, and `loc
Downloads
3
Readme
Scaf: Development Framework for the Sui Blockchain (alpha version)
Scaf is a development environment for the Sui blockchain. With Scaf you can:
- Develop, build, and deploy Sui Move smart contracts.
- Interract with Sui Move smart contracts on
mainnet
,testnet
,devnet
, andlocalnet
. - Manage a local project-specific Sui network for development, testing, and simulating contract interraction.
Prerequisites
Scaf requires the sui
CLI for building the Sui Move smart contracts and for
running the local network. To install the SUI CLI.
Installation
You can install Scaf with npm. To start a new project and develop Sui Move smart contracts
mkdir sui_move_project
cd sui_move_project
npm init -y
npm install @cnikolaou/scaf
Setup and Configuration
After installing scaf
, you can create a structure for your project with:
npx scaf
This will create the following structure:
.
├── packages/
├── scripts/
├── genesis.yaml
└── scaf.config.js
- The
packages/
directory includes sample Sui Move packages. - The
scripts/
directory includes a sample script that:- Starts a local, project-specific Sui blockchain with the
Network.startNetwork()
function. - Publishes the
packages/fungible_token
package in a local Sui blockchain. - Interracts with the published package.
- Starts a local, project-specific Sui blockchain with the
genesis.yaml
is the file used byNetwork.resetNetwork()
to configure the initial state of the local blockchain. You need to update the file with your public addresses underaccounts:
.scaf.config.js
selects against which network the script actions will run. The options aremainnet
,testnet
,devnet
, andlocalnet
.
Run
To run the sample project you need to create a local .env
file with the following information
(make sure not to include that file in any commit):
SEED='YOUR-SEED-PHRASE'
SCHEMA='SCHEMA-USED-FOR-PRIVATE-KEY'
SEND_TO='PUBLIC-ADDRESS-OF-RECEIVER'
Then run the sample script by:
npx scaf-run scripts/fungibleToken
And open the Sui explorer to see the results on the local network: https://suiexplorer.com/?network=local
You can create and run your own scripts that interract with the Sui blockchain (either
localnet
or any other Sui network), by selecting the active network for the scripts
in scaf.config.js
. You can automate interractions with smart contracts or deploying
your own Sui Move smart contracts.