Trestle is a development framework for building juno contracts. The aim of the project is to make juno contracts development process simple, efficient and scalable. User can focus on logic of juno contract and not much about further steps in development. It facilitates features such as initiating project repo from contract templates, easy compilation of contracts, deployment, Interacting with contracts using schema and contract testing framework.
The minimum packages/requirements are as follows:
- Node 14+
- Yarn v1.22+ or NPM `v6.0+**
- Connection to an Juno node.
Installation from released version
To install trestle globally in your system you can use:
- Using Yarn:
yarn global add juno-trestle
- Using NPM:
npm install -g juno-trestle// or trestle-af
Installation from master.
The master branch corresponds to the latest version.
trestle on your system, follow the steps below:
$ git clone https://github.com/arufa-research/trestle.git $ cd trestle $ yarn install $ yarn build $ cd packages/trestle $ yarn link $ chmod +x $HOME/.yarn/bin/trestle
Setup Rust compiler
$ cd infrastructure $ make setup-rust
Follow our infrastructure README for instructions how to setup a private network.
Initialize a project
$ trestle init <project-name>
This will create a directory inside current directory with boiler-plate code. The
contracts/ directory has all the rust files for the contract logic.
scripts/ directory contains
.js scripts that user can write according to the use case, a sample script has been added to give some understanding of how a user script should look like.
test/ directory contains
.js scripts to run tests for the deployed contracts.
To see the possible tasks (commands) that are available, go to project's folder.
This is the list of built-in tasks. This is your starting point to find out what tasks are available to run.
Compile the project
To compile the contracts, Go to project directory:
$ cd <project-name> $ trestle compile
This command will generate compiled .wasm files in artifacts/contracts/ dir and schema .json files in artifacts/schema/ dir.
To clear artifacts data, use
$ trestle clean
This will remove the artifacts directory completely. To clean artifacts for only one contract, use
$ trestle clean <contract-name>
This will remove specific files related to that contract.
Running user scripts
User scripts are a way to define the flow of interacting with contracts on some network in form of a script. These scripts can be used to deploy a contract, query/transact with the contract.A sample script scripts/sample-script.js is available in the boilerplate.
$ yarn run test
This project is forked from hardhat, and just base on the hardhat-core part then modify it under MIT license.
hardhat - Hardhat is a development environment to compile, deploy, test, and debug your Ethereum software. Get Solidity stack traces & console.log.