Plugins Overview¶

Hardhat Arbitrum Stylus provides a suite of plugins for Stylus development.

Bundler¶

Package: @cobuilders/hardhat-arbitrum-stylus

The @cobuilders/hardhat-arbitrum-stylus package is a bundler that re-exports all the individual plugins in the suite. Instead of installing and configuring each plugin separately, you can install the bundler and get everything at once.

Why use the bundler?

Single install - One package instead of multiple
Synchronized versions - All plugins are tested together
Simpler config - One import in your hardhat config

Installation:

npm install @cobuilders/hardhat-arbitrum-stylus

Configuration:

import type { HardhatUserConfig } from 'hardhat/config';
import hardhatToolboxViemPlugin from '@nomicfoundation/hardhat-toolbox-viem';
import hardhatArbitrumStylus from '@cobuilders/hardhat-arbitrum-stylus';

const config: HardhatUserConfig = {
  plugins: [hardhatToolboxViemPlugin, hardhatArbitrumStylus],
};

export default config;

This single import gives you access to all the plugins: Node, Compile, Deploy, and Test.

Individual Plugins¶

If you prefer granular control, you can install plugins individually:

npm install @cobuilders/hardhat-arb-node

Available Plugins¶

Plugin	Package	Status
Node	`@cobuilders/hardhat-arb-node`	✅ Available
Compile	`@cobuilders/hardhat-arb-compile`	✅ Available
Deploy	`@cobuilders/hardhat-arb-deploy`	✅ Available
Test	`@cobuilders/hardhat-arb-test`	✅ Available

All Tasks¶

npx hardhat arb:node start    # Start local Arbitrum node
npx hardhat arb:node stop     # Stop the node
npx hardhat arb:node status   # Check node status
npx hardhat arb:node logs     # View node logs
npx hardhat arb:compile       # Compile Stylus contracts
npx hardhat arb:deploy        # Deploy Solidity or Stylus contracts
npx hardhat arb:test          # Run tests