(Testing warp transpilation on truffle)

The Truffle Warp-transpiler Box provides the boilerplate Truffle structure necessary to start coding for StarkWare's Ethereum L2 solution, StarkNet. This is different from starknet box as it allows the developer to write solidity contracts and the compiler will automatically transpile these contracts to cairo contracts and deploy them on strakent without the user having to do any extra work.

1. As yet this box has not been officially published on truffles repo so for now to unbox run:

truffle unbox https://github.com/Vishvesh-rao/Truffle-Starknet-Box

2. The solidity contracts to be transpiled should be put into /contracts/starkent/ folder.

3. At this point if you are not in the root folder of your project then return to the root folder.

To enable transpilation run compile_starknet.mjs:

npm run starknet:compile

To deply cairo files present in contracts/starknet folder. To deploy transpiled contracts via warp run the below command giving constructor arguments after the command. Arguments must be comma seperated.

npm run starknet:deploy <constructor-arguments>

There are two folders present in the contracts folder ethereum and starknet.

The contracts/ethereum folder conatains all solidity files that are not meant to be transpiled example L1 code while the contracts/starknet folder contains files which will be automatically transpiled to cairo on running the compile command. However solidity files with name cairo_*.sol which are present in the ethereum folder with be selectively transpiled to cairo and put into the starknet folder.

By default all L1 files should be put into ethereum folder while solidity files meant for transpilation for L2 part should be put into starknet folder.

The main core of this box is in the scripts directory. This directory contains all the necessary l2 compilation/deploying files to enable cairo contracts to be deployed to starkWares networks.

On unboxing the entire box is set up and the ethereum folder is created under <project-root>/contracts/ethereum/solidity contracts in this folder with name starting with cairo_ will be comverted to cairo and stored in the starknet folder.

Solidity contracts present in the starknet folder will be converted into ciaro contracts and stored in <project-root>/contracts/starknet/.

The three main files that are releavant for transpiling solidity to cairo are present in the scripts folder.

• cairo_transpiler.mjs
• compile_starknet.mjs
• exec_shellcmd.mjs

Import order:

graph TD;
    compile_starknet.mjs-->cairo_transpiler.mjs;
    cairo_transpiler.mjs-->exec_shellcmd.mjs

This is the main executeble file which links truffle to warp and transpiling the contracts and is also responsible for certain folder creations, moving around of contracts, and at the end deleting any extra folders created and storing the transpiled cairo contracts into <project-root>/contracts/starknet/.

It imports from exec_shellcmd.mjs to enable execution of shell commands.

This is a utillity module which defines the run() fucntion to execute shell commands.

This contract is main module with regards to the compilation of cairo contracts stored in <project-root>/contracts/starknet/.

This imports cairo_transpiler.mjs module