Convex is a decentralised network and execution platform that powers the Internet of Value. It realises the vision of a true Stateful Internet, where the network itself securely hosts, executes, and persists both code and data.
Convex provides a full-stack platform for decentralised applications and programmable economic systems that manage digital assets. Ownership of accounts and assets is cryptographically enforced and can be governed (optionally) through smart contracts.
Unlike traditional blockchains, Convex is built on Lattice Technology, which leverages the mathematical properties of lattices to deliver superior consensus and verifiability. This foundation yields significant advantages over conventional blockchain designs:
| Feature | Convex Advantage |
|---|---|
| Global State Model | Single, consistent global state with immutable data structures and atomic transactions |
| Virtual Machine | Lambda-calculus-based VM supporting fully Turing-complete smart contracts |
| Throughput | Tens of thousands of write TPS today; designed to scale to millions in the future |
| Networking | Simple, robust random-gossip protocol |
| Confirmation Latency | Millisecond-range global consensus (network-speed dependent) |
| Energy Efficiency | 100% Green – powered by Convergent Proof-of-Stake (no energy-intensive mining) |
| Programming Language | Integrated on-chain compiler for Convex Lisp (a modern, secure Lisp dialect) |
- Developer-friendly: Write smart contracts in a powerful, functional Lisp that compiles and executes directly on-chain.
- Instant finality: Transactions confirm in milliseconds with cryptographic guarantees.
- Truly scalable: Lattice agreement eliminates the bottlenecks of linear blockchains.
- Sustainable by design: Minimal energy footprint while maintaining full decentralization and security.
Convex is the high-performance, eco-friendly backbone for the next generation of decentralised finance, agentic economies, self-sovereign ownership, and beyond.
This repository contains the core Convex distribution including:
- The Convex Virtual Machine (CVM) including data structures and execution environment
- The standard Convex Peer server implementation (NIO based) implementing Convergent Proof of Stake (CPoS) for consensus
- CLI Tools for operating Peers, scripting transactions and more
- The Etch database for persistent data storage
- SQL database layer with JDBC driver and PostgreSQL wire protocol server
- A Swing GUI for managing local peers / exploring the network
- A simple REST API server
- JMH Benchmarking suite
- Java Client API
The repository also contains core "on-chain" libraries providing key full-stack functionality and tools for decentralised applications, including:
convex.fungible- Fungible Tokensasset.nft.simple- Basic lightweight Non-fungible tokensconvex.asset- library for managing arbitrary digital assets using a common abstractionconvex.trust- library for access control and trusted operationstorus.exchange- decentralised exchange for trading fungible tokens and currencies- Example code and templates for various forms of smart contracts
| Name | Description | Maven | Javadoc |
|---|---|---|---|
| convex-core | CVM, data structures and consensus |  |
 |
| convex-peer | Peer implementation and networking |  |
 |
| convex-cli | Command Line Tools |  |
 |
| convex-gui | Convex Desktop GUI Interface |  |
 |
| convex-db | SQL database with JDBC and PostgreSQL protocol |  |
 |
For local use of Convex data structures and CVM execution, convex-core is typically sufficient. To run a peer or communicate with one over the network, include convex-peer as a dependency. Other modules are designed primarily as standalone applications or client libraries.
- Convex Virtual Machine (CVM) - Secure, Lambda Calculus-based environment for smart contracts and autonomous agents.
- Decentralised Consensus - Tamper-proof and censorship-resistant via Convergent Proof of Stake (CPoS).
- Performance and Scalability - Processes tens of thousands (and sometimes up to millions) of transactions per second with sub-second global consensus.
- Eco-Friendly - Minimal energy consumption with CPoS, ensuring a sustainable platform.
- Java 21+ (Download)
macOS / Linux:
curl -fsSL https://convex.world/install.sh | bashWindows (PowerShell):
irm https://convex.world/install.ps1 | iexThis installs convex.jar and adds a convex command to your PATH.
Download directly:
- Latest stable release
- Snapshot build (develop branch, may be unstable)
Docker:
docker pull convexlive/convex:latest
docker run convexlive/convex peer startBuild from source:
git clone https://github.com/Convex-Dev/convex.git
cd convex
mvn clean installLaunch the desktop GUI:
convex desktopStart a local peer test network with GUI:
convex local guiSee all available commands:
convex --helpContributions are welcome under the Convex Public License. Contributors retain copyright but must accept the license terms. A Contributors Agreement is required for all submissions to the core repository.
The Convex Foundation may award Convex Coins to contributors for significant ecosystem contributions. These native utility tokens enable network service access and may be exchangeable for other digital assets.
We use Discord as for discussing Convex - you can join the public server at https://discord.gg/5j2mPsk
Alternatively, email: info(at)convex.world
Copyright 2017-2025 The Convex Foundation and Contributors
Unless otherwise specified, source code is available under the terms of the Convex Public License