GBLEND

A Foundry forge wrapper optimized for Fluent Network and WASM smart contract development.

Installation

Quick Install (Recommended)

1. Install gblendup:

curl -sSL https://raw.githubusercontent.com/fluentlabs-xyz/gblend/refs/tags/latest/gblendup/install | bash

2. Start a new terminal session or update source file

3. Install gblend using gblendup

gblendup

This will automatically download precompiled binaries for your platform or build from source if needed.

Verify Installation

After installation, verify gblend is working:

gblend --version

Updating

To update gblend to the latest version, simply run the installer again:

curl -sSL https://raw.githubusercontent.com/fluentlabs-xyz/gblend/refs/tags/latest/gblendup/install | bash

Motivation

gblend is a wrapper around Foundry's forge that uses Fluent's version of REVM and is designed to work with Wasm smart contracts. It enables you to:

• Compile Rust smart contracts for WASM execution
• Deploy contracts to Fluent Network
• Verify WASM contracts on-chain
• Create new projects using templates from fluentlabs-xyz/examples

The usage is very similar to regular Foundry forge with some additional features. For example, when verifying WASM contracts, you need to pass the --wasm argument. Otherwise, it works almost identically to forge.

Basic Commands

Project Management

# Create a new project using Fluent examples
gblend init my-project

# Create project with specific template
gblend init my-project --template <template-name>

# Build your contracts
# For reproducibility, builds are run inside a Docker container.  
# The first build may take longer as the container image needs to be downloaded.
gblend build

# Clean build artifacts
gblend clean

Testing

# Run tests
gblend test

# Run specific test
gblend test --match-test testMyFunction

# Run tests with gas reporting
gblend test --gas-report

Deployment

# Deploy a contract

# Deploy a WASM contract with verification
# contract name - rust package name in pascal case with .wasm suffix
gblend create PowerCalculator.wasm \        
    --rpc-url <rpc-url> \       
    --private-key <key> \        
    --broadcast \        
    --verify \       
    --wasm \
    --verifier blockscout \      
    --verifier-url <verifier-url>

# Deploy a Solidity contract
# NOTE: constructor args should be the last argument if used
gblend create src/BlendedCounter.sol:BlendedCounter \
    --rpc-url <rpc-url> \
    --private-key <key> \
    --broadcast \
    --constructor-args <args>

# Deploy using a script
gblend script script/BlendedCounter.s.sol:Deploy \
    --rpc-url <rpc-url> \
    --private-key <key> \
    --broadcast

Verification

# Verify a regular Solidity contract
gblend verify-contract <address> BlendedCounter \
    --verifier blockscout \
    --verifier-url <verifier-url>

gblend verify-contract <address> PowerCalculator.wasm \
    --wasm \
    --verifier blockscout \
    --verifier-url <verifier-url> \
    --constructor-args <args>

Configuration

gblend uses the same configuration system as Foundry forge. Create a foundry.toml file in your project root:

[profile.default]
src = "src"
out = "out"
libs = ["lib"]
optimizer = true
optimizer_runs = 200

[rpc_endpoints]
fluent = <rpc-url>

Differences from Standard Forge

• WASM Support: Native support for WASM contract compilation and deployment
• Enhanced Verification: --wasm flag for verifying WASM contracts
• Custom REVM: Support for the fluentbase REVM implementation.

Documentation

For complete documentation on forge commands, see the Foundry Book.

For Fluent-specific development guides, visit Fluent Documentation.

Contributing

Contributions are welcome! Please see our contributing guidelines.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Note: gblend is built on top of Foundry forge and maintains full compatibility with existing forge projects while adding Fluent Network and WASM-specific enhancements.