NodeForge

Visual State-Machine Builder for Solana Agents

Design flows as connected nodes. NodeForge compiles state machines into ready-to-use Solana micro agents — no boilerplate, no friction.

Nodes → Logic → On-Chain Execution.

Features

NodeForge turns visual state diagrams into production-ready Solana agents.

Visual State Machines

Model agent behavior as nodes, edges, and conditions. Every path is explicit, debuggable, and easy to reason about.

Agent Scaffolding Engine

Compile a state machine spec into a full agent scaffold: entry points, configs, and state-machine JSON, ready for integration into Solana workflows.

Multi-Agent Ready

Design, reuse, and compose multiple state machines to orchestrate complex agent meshes across markets, pools, and protocols.

  • Graph validation (no orphan nodes, broken edges, or missing states).
  • Human-readable configs for risk, thresholds, and triggers.
  • CLI-first now, visual builder later.

About NodeForge

NodeForge is an experimental tooling layer for Solana that treats on-chain agents as state machines instead of scripts. You design behavior as flows, and NodeForge handles the scaffolding.

The v0 focuses on a code-based spec: you define nodes, edges, and transitions in a simple schema, and NodeForge compiles that spec into a deployable micro agent scaffold.

What NodeForge aims to solve:

  • Reduce boilerplate when building on-chain agents.
  • Make agent behavior auditable and explainable through graphs.
  • Enable visual builders, simulation, and versioning of agent logic.

Whitepaper Preview

The NodeForge whitepaper describes the full architecture from graph spec → compile engine → agent runtime.

1. Spec Layer

Defines the StateMachineSpec: nodes (start, decision, state, end), edges (transitions with conditions), and metadata. This is the source of truth for agent behavior.

2. Forge Engine

The NodeForge engine validates the graph, resolves transitions, and generates an AgentScaffold. It outputs virtual files like agent.ts, stateMachine.json, and config.json that can be wired into Solana workflows.

3. Future Visual Builder

A drag-and-drop interface will sit on top of the spec: builders connect nodes visually, then click Forge to export Solana-ready agents. Simulation, testing, and multi-agent orchestration will be layered on top.

NodeForge Demo Videos

Quick previews of NodeForge forging state-machine agents into scaffolds.

Trading Agent Forge

NodeForge compiles the tradingAgent spec into a full agent scaffold with generated files.

Multi-Agent Forge (Alert + Batch)

Alert agent forge and batch forge flow showing NodeForge compiling multiple state machines.