Skip to main content

User Guide

Convex offers a comprehensive, full-stack solution for building decentralised applications (dApps) and open economic systems.

Core Concepts​

Convex Coins​

Learn about the native currency and accounts:

Smart Contracts​

Build on-chain logic with Convex:

  • Convex Lisp - The on-chain programming language
  • Actors - Smart contracts and autonomous actors
  • Recipes - Practical how-to guides

AI Agents​

Connect autonomous agents to the Convex economy:

Network Operations​

Run and operate peer infrastructure:

Learning Paths​

Choose your path based on what you want to build:

Application Developer​

Build apps that use Convex for state and transactions

  1. Start with Networks - Understand available networks
  2. Choose your SDK - Pick your programming language
  3. Follow SDK quickstart - Get your first transaction working
  4. Explore Recipes - Practical examples

Best for: Web apps, mobile apps, backend services

Smart Contract Developer​

Build autonomous actors and on-chain logic

  1. Learn Convex Lisp - Master the on-chain language
  2. Understand Actors - Smart contract concepts
  3. Study Recipes - Working examples
  4. Test with Local Peer - Fast iteration

Best for: DeFi protocols, DAOs, on-chain logic

Agent Developer​

Connect AI agents to real economic state

  1. Read AI Agents - Why Convex suits agentic systems
  2. Set up MCP Integration - Connect your agent to a peer
  3. Manage Agent Accounts - Keys, funding and delegation
  4. Design Agentic Economics - Agent-to-agent commerce

Best for: AI agents, autonomous services, machine-to-machine payments

Peer Operator​

Run peer infrastructure and participate in consensus

  1. Read Networks - Understand network architecture
  2. Study Peer Staking - Economic requirements
  3. Choose Deployment Method - Set up infrastructure
  4. Follow Security Guide - Secure operations

Best for: Infrastructure providers, validators, high-availability operations

Getting Started​

Networks​

Learn about Convex networks and how to connect to them:

  • Networks Guide - Understand network types, find available networks
    • Production networks (peer.convex.live)
    • Public testnets (with faucets)
    • Local development peers

Client SDKs​

Connect to Convex from your application using official client libraries:

  • TypeScript / JavaScript - For web apps, Node.js, Deno, React — with full type safety, or plain JavaScript Production ready • npm install @convex-world/convex-ts

  • Java - For JVM applications, Android, enterprise systems Production ready • world.convex:convex-java:0.8.8

  • Python - For Python applications, scripting, data science Production ready • pip install convex-sdk

For command-line interaction, see the Convex CLI.

I want to...