superfuse-forge

KO | EN

gitlite — search

#hacktoberfest #rust #deep-learning #linux #docker #macos #nodejs #windows #cli #awesome-list #vue #security #mcp #openai

superfuse-forge

(★ 19)

A developer-friendly framework/library in solidity to build cross-chain contracts in superchain Ecosystem

superfuse-forge Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>Keep Optimistic and be Superchain dApp developer!! </h1>

- [What is it for](#what-is-it-for)
- [Quickstart](#quickstart)
- [Architecture](#architecture)
- [Contributing](#contributing)
- [Acknowledgement](#acknowledgement)

>[!NOTE]
> You can find our relevant examples [`here`](https://github.com/Ratimon/superfuse-contracts-examples). Geneated contract code from the Superfuse Wizard is stored here due to documentation and testing purpose.

## What Is It For

One of our Swiss army knife toolset: **superfuse-forge** is a developer-friendly framework/library in solidity to build a variations of cross-chain contracts in superchain Ecosystem.

The features include:

- Type-safe smart contract deployment
- Re-usable  smart contract deployment and testing pipeline
- Standardized framework, minimizing developer mistake and enhancing better security
- Save deployment schemas in **json** file
- Separatable into each of modular and customizable deploy scripts
- Based on All-Solidity, so no context switching, no new testing syntax

Together with [`Redprint Wizard UI`](https://github.com/Ratimon/redprint-wizard), which is a code generator/ interactive playground oriented for OPStack development, it does not only help novice developers to deploy OPStack's smart contracts to deploy on OP mainnet, but also help them to use generated deployment script in their own projects.

## Quickstart

### Installation

Add the `superfuse-forge` using your favorite package manager, e.g., with pnpm:

```bash
pnpm init
pnpm add superfuse-forge
pnpm install
```

### Quick Guide

1. Set your working environment with **foundry** :

```bash
forge init my-project
cd my-project
```

2.  Add the `superfuse-forge` using your favorite package manager, e.g., with pnpm or Yarn:

```sh
pnpm add superfuse-forge
```
or
```sh
yarn add -D superfuse-forge
```

3. Configure permission and remapping (e.g. with txt" for `remappings.txt`) by modifing:

```diff
[profile.default]
src = "src"
out = "out"
libs = ["lib"]
+solc_version = '0.8.25'
+fs_permissions = [
+    { access = 'read-write', path = './deployments/' },
+    { access = 'read', path = './configs' },
+    { access = 'read', path = './test' },
+    { access = 'write', path = './deployment.json' },
+]

+[soldeer]
+remappings_location = "txt"
```

Then, add `remappings.txt` with following lines:

```txt
@superfuse-core/=node_modules/superfuse-forge/src
@superfuse-deploy/=node_modules/superfuse-forge/script
@superfuse-test/=node_modules/superfuse-forge/test/

@forge-std-v1.9.1/=node_modules/superfuse-forge/lib/forge-std-v1.9.1/src/
@solady-v0.0.292/=node_modules/superfuse-forge/lib/solady-v0.0.292/src/

@openzeppelin-v0.4.7.3/=node_modules/superfuse-forge/lib/openzeppelin-v0.4.7.3/contracts/
@openzeppelin-v0.5.0.2/=node_modules/superfuse-forge/lib/openzeppelin-v0.5.0.2/contracts/
```

>[!TIP]
> We use @<Lib>-v<Lib-Version>/ as a convention to avoid any naming conflicts with your previously installed libararies ( i.e. `@solady-0.0.292/` vs `@solady/`)

>[!NOTE]
>  You can check out dependencies'versions [`here`](https://github.com/Ratimon/superfuse-forge/blob/main/package.json#L31).

4. Copy `.env` as following.

```sh
MNEMONIC="test test test test test test test test test test test junk"
# local network 's default private key so it is still not exposed
DEPLOYER_PRIVATE_KEY=0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d
DEPLOYER_ADDRESS=0x70997970C51812dc3A010C7d01b50e0d17dc79C8
```

>[!NOTE]
>  The key or menemonic here must be secret and secure. you can configure it via our [Wizard](https://superfuse.ninja/), and the default values are based on above `.env`. You must choose your own secret. Otherwise, it does not mimic the production deployment environment.

4. Modify  `.gitignore` as following.

```diff
# ...
+node_modules/
```

5. Copy a set of smart contract including main contracts deploy scripts and test suites

```sh
rsync -av --exclude='interfaces/' --exclude='L2/' --exclude='libraries/' node_modules/superfuse-forge/src/ src/
```

>[!NOTE]
>  we, for this example, also need to reconfigue the new remapping:

```diff
# ...
+@main/=src/
+@script/=script/
@superfuse-core/=node_modules/superfuse-forge/src
@superfuse-deploy/=node_modules/superfuse-forge/script
@superfuse-test/=node_modules/superfuse-forge/test/

@forge-std-v1.9.1/=node_modules/superfuse-forge/lib/forge-std-v1.9.1/src/
@solady-v0.0.292/=node_modules/superfuse-forge/lib/solady-v0.0.292/src/

@openzeppelin-v0.4.7.3/=node_modules/superfuse-forge/lib/openzeppelin-v0.4.7.3/contracts/
@openzeppelin-v0.5.0.2/=node_modules/superfuse-forge/lib/openzeppelin-v0.5.0.2/contracts/
```

>[!TIP]
> You may choose your own remapping convention that suites your needs best!!!

For Deploy script, we now want to exclude [`/deployer`](./script/deployer/):

```sh
rsync -av --exclude='deployer/' node_modules/superfuse-forge/script/ script/
```

Now, copy a test suite:

```sh
cp node_modules/superfuse-forge/test/* test/
```

6. Compile and run test:

This will take a while to compile:
```sh
forge t
```

>[!TIP]
>Behind the scene, the test suite works by replicating the same environment as production script, because it utilizes the same deployment logic script inside `setUp()` as following:

```ts

/** ... */

// deployment logic
import {DeployMyERC20VotesScript} from "@script/000_DeployMyERC20VotesScript.s.sol";

contract ERC20VotesTest is Test {

/** ... */

function setUp() external {

/** ... */

deployerProcedue = getDeployer();
        deployerProcedue.setAutoBroadcast(false);

console.log("Setup MyERC20Votes ... ");

DeployMyERC20VotesScript myERC20VotesDeployments = new DeployMyERC20VotesScript();
        myERC20Votes = myERC20VotesDeployments.deploy();

deployerProcedue.deactivatePrank();

}
    /** ... */

}
```

>[!NOTE]
> You can chekout [this](https://github.com/Ratimon/redprint-forge/blob/main/script/example/000_DeployMyERC20VotesScript.s.sol)

superfuse-forge

superfuse-forge Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

superfuse-forge

superfuse-forge Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README