Getting Started

Welcome to FlowNodes

FlowNodes is a visual smart contract builder for Ethereum Mainnet. You drag audited blocks onto a canvas, connect them together, and the platform generates production-grade Solidity — or you describe what you want and the AI builds the block graph for you.

No Solidity knowledge required. Every contract runs through a live security scan and optimized compilation before you can deploy.

AI-Assisted

Describe in plain English, get a complete block graph in seconds

Audited Blocks

OpenZeppelin v5 components with Slither security scan before deploy

Non-Custodial

Sign In With Ethereum. Your keys, your contracts, always.

What is FlowNodes?

FlowNodes is a browser-based platform that lets you build Ethereum smart contracts visually. The core interface is a node-based canvas (powered by React Flow) where each node represents an audited smart contract component — an ERC-20 token, an access control role, a staking pool, an oracle, and so on.

When you connect these blocks together, FlowNodes generates the corresponding Solidity source code in real time. Compilation is done entirely in the browser using a WebAssembly build of solc 0.8.24, so there's no server round-trip.

Who is it for?

FlowNodes targets three audiences:

  • Founders & product buildersPrototype and deploy token economics, governance systems, or DeFi primitives without hiring a Solidity developer.
  • Junior Solidity devsLearn contract architecture by seeing how audited components fit together, then read the generated code.
  • Experienced engineersScaffold complex contracts 10× faster using pre-audited blocks, then tweak the generated Solidity in your own IDE.

Ethereum Mainnet only

FlowNodes is intentionally Mainnet-only. There are no testnets, no sidechains, no L2s. Every deployment goes to chainId: 1. This focus means the security pipeline, the gas estimates, and the Etherscan verification are all tuned for production use, not experiments.

Warning
You are deploying to Ethereum Mainnet with real ETH. Contracts are immutable unless you use the UUPS or Transparent Proxy upgrade pattern. Use the Slither security scan before every deployment.

Connecting your wallet

FlowNodes uses Sign-In With Ethereum (SIWE / EIP-4361) for authentication. There is no email, password, or third-party OAuth. Your Ethereum address is your identity.

  1. 1

    Click the Connect button

    On the landing page or the /login page, click the Connect Wallet button powered by RainbowKit. This supports MetaMask, WalletConnect, Coinbase Wallet, and any EIP-1193 injected provider.

  2. 2

    Select Ethereum Mainnet

    FlowNodes enforces chainId 1. If your wallet is on a different network, RainbowKit will prompt you to switch. You won't be able to proceed until you're on Mainnet.

  3. 3

    Sign the SIWE message

    After connecting, click "Sign In With Ethereum". Your wallet will show a human-readable EIP-4361 message including the domain (flownodes.xyz), your address, and a one-time nonce. This is a free signature — it costs no gas.

  4. 4

    First login: onboarding

    New accounts are taken through a short onboarding flow where you set a username. You'll receive 500 free credits immediately.

Note
The SIWE message is signed off-chain. FlowNodes never has custody of your private key. The signed message is verified server-side and a short-lived session cookie is issued.

Supported wallets

WalletConnection MethodNotes
MetaMaskBrowser extension / EIP-1193Most common. Works in all browsers.
WalletConnect v2QR code / deep linkSupports 400+ mobile wallets (Rainbow, Trust, etc.)
Coinbase WalletBrowser extension or mobileSupports smart accounts
Injected (EIP-1193)Any injected providerFrame, Rabby, Brave Wallet, etc.

Your first smart contract

The fastest way to create a contract is using the AI prompt. This walkthrough creates a simple ERC-20 token in under 2 minutes.

  1. 1

    Create a new project

    From your Dashboard, click "New Project". This creates a blank canvas with an auto-save timer running.

  2. 2

    Open the AI panel

    Click the sparkle (✦) icon in the top-right toolbar, or press ⌘I. The AI panel slides in from the right sidebar.

  3. 3

    Describe your contract

    Type something like: "ERC-20 token, 1 billion fixed supply, owner can burn, no mint after deployment". Press ⌘↵ to send.

  4. 4

    Review and accept the blocks

    The AI generates a FlowNodesGraph JSON and renders the proposed blocks on the canvas as a preview. Review them, then click "Accept All" in the AI panel banner.

  5. 5

    Compile

    Compilation starts automatically (debounced 800ms after the last change). Watch the "Compiled" indicator in the top bar turn green. Check the Output tab for any warnings.

  6. 6

    Run a security scan

    Click the "Scan" button in the top bar. Slither runs via an E2B sandbox and returns findings in the Problems panel. Fix any critical issues before deploying.

  7. 7

    Deploy

    Click the blue "Deploy" button (only enabled when compiled and no critical issues). The Deploy Modal walks you through gas estimation, constructor args, and the wagmi contract write.

Tip
You can also build contracts manually without AI by dragging blocks from the left sidebar onto the canvas. Each block has a + button that adds it to the canvas center, or you can drag-and-drop it to a specific position.

Credits and pricing

FlowNodes uses a credit system. Credits are purchased by depositing ETH into theFlowNodesPaymentVault smart contract on Mainnet. The exchange rate is set by the Chainlink ETH/USD price feed at the time of deposit. 1 credit ≈ $0.01 USD.

ActionCreditsApprox USD
New account bonus500 free
AI generation (simple, <20 words)5$0.05
AI generation (standard)10$0.10
AI generation (complex, >50 words)20$0.20
AI refinement / repair5$0.05
AI block explanation1$0.01
Slither security scan10$0.10
Full security audit50$0.50
Tenderly simulation5$0.05
Deploy to Mainnet200$2.00
Etherscan verification10$0.10

Topping up

Go to Credits page and enter an ETH amount. The vault contract emits a Deposited event which is indexed by an Alchemy webhook. Credits are added to your account after 12 block confirmations (~2.5 minutes).

Note
Compilation is always free — it runs locally in your browser via solc WASM. Only AI requests, security scans, simulations, and deployments consume credits.
Getting Started — FlowNodes Docs | FlowNodes