Developer Reference
Solidity Tooling Compatibility
Pre-launch
Section
Developer Reference
Documentation category
Type
Guide
Technical reference
Summary
Full compatibility reference for Solidity development tools on SwssChain: Hardhat, Foundry, Remix, viem, wagmi, OpenZeppelin, and The Graph.
SWSS Foundation Notice

This documentation is restricted to authorised members of the SWSS Developer Community. Access is granted exclusively through SWSS DevHub, after KYB and SWSS Foundation approval.

All SwssChain GitHub repositories are private. Significant updates are currently deploying across the full SWSS Ecosystem. SDK and API specifications are subject to change at any time in accordance with security requirements and SwssChain Foundation governance decisions.

Join SWSS DevHub →Have a question? Use the Need Help? button below.
SDK Update Notice

SWSS SDK v2.1 is deploying across the ecosystem. API signatures may change during this period. Ensure your integration uses the latest schema from SWSS DevHub.

Article Content

Solidity Tooling Compatibility

All major Solidity development tools work on SwssChain without modification. The full Ethereum developer toolchain is supported. No SwssChain-specific tooling is required for standard smart contract development: if your project already runs on an EVM chain, it targets SwssChain with only a network configuration change.

Full Tooling Compatibility Reference

ToolVersionSwssChain SupportConfiguration Required
Hardhat2.xFullAdd network config: see EVM Compatibility page
FoundryLatestFullAdd rpc_endpoints to foundry.toml
Remix IDELatestFullConnect via injected provider (MetaMask)
Truffle5.xFullAdd network config to truffle-config.js
OpenZeppelin Contracts5.xFullNo changes needed
OpenZeppelin Upgrades3.xFullNo changes needed
ChainlinkLatestCompatibleCheck feed availability at DevHub
ethers.js6.xFullUse JsonRpcProvider with SwssChain RPC URL
web3.js4.xFullStandard connection: update RPC URL only
viem2.xFullDefine custom chain: see below
wagmi2.xFullAdd custom chain to createConfig
The GraphLatestCompatibleDeploy custom subgraph targeting SwssChain
TenderlyLatestCompatibleAdd SwssChain network in Tenderly dashboard

Remix IDE Setup

  1. Open remix.ethereum.org.
  2. Navigate to the Deploy & Run Transactions tab.
  3. Set Environment to Injected Provider: MetaMask.
  4. Ensure MetaMask is connected to SwssChain Mainnet (Chain ID 122605).
  5. Deploy and interact with contracts normally: Remix has no awareness of the difference between SwssChain and Ethereum at this layer.

viem Custom Chain Definition

import { defineChain } from 'viem';

export const swsschain = defineChain({
  id: 122605,
  name: 'SwssChain Mainnet',
  nativeCurrency: {
    decimals: 18,
    name: 'SWSS Coin',
    symbol: 'SWSS'
  },
  rpcUrls: {
    default: {
      http: [process.env.SWSSCHAIN_RPC_URL!],
      webSocket: [process.env.SWSSCHAIN_WS_URL!]
    }
  },
  blockExplorers: {
    default: {
      name: 'SwssChain Explorer',
      url: 'https://swssscan.swss.io'
    }
  }
});

wagmi Configuration

import { createConfig, http } from 'wagmi';
import { swsschain } from './chains';

export const wagmiConfig = createConfig({
  chains: [swsschain],
  transports: {
    [swsschain.id]: http(process.env.NEXT_PUBLIC_SWSSCHAIN_RPC)
  }
});

OpenZeppelin Usage

All OpenZeppelin contracts deploy and function identically on SwssChain. ERC-20, ERC-721, ERC-1155, Governor, AccessControl, and all proxy patterns (Transparent, UUPS, Beacon) work without modification. Upgradeable contracts using the OpenZeppelin Upgrades plugin for Hardhat or Foundry require no SwssChain-specific configuration. Timelock and governance contracts should be configured against the one-second block time, a delay expressed in blocks resolves in a second per block.

Next Steps