Setting the issue. One moment.
Contents
Issue No. 31Convex Foundation · Official
Convex-Dev /convex
Convex Main Repository - Decentralised platform for the Internet of Value
20 chapters · 30 minutes · 6,568 words
Convex Main Repository - Decentralised platform for the Internet of Value
20 chapters · 30 minutes · 6,568 words
20 chapters · 30 min
npx skills add Convex-Dev/convexTypeset in this issue’s own colours, resolved from a curated brand profile.
Convex is a decentralised network and execution platform. It realises the vision of a true Stateful Internet, where the network itself securely hosts, executes, and persists both code and data on a self-sovereign-federated basis.
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.
develop, last pushed 8 August 2026.SKILL.md, not by matching a directory convention. One layout observed: .claude/skills/*/SKILL.md.h1 and no skipped levels:/Convex-Dev/convex.md, and each chapter at its own .md URL.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) |
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 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| Name | Description | Maven | Javadoc |
|---|---|---|---|
| convex-core (opens in a new tab) | CVM, data structures and consensus |  (opens in a new tab) |  (opens in a new tab) |
| convex-peer (opens in a new tab) | Peer implementation and networking |  (opens in a new tab) |  (opens in a new tab) |
| convex-cli (opens in a new tab) | Command Line Tools |  (opens in a new tab) |  (opens in a new tab) |
| convex-gui (opens in a new tab) | Convex Desktop GUI Interface |  (opens in a new tab) |  (opens in a new tab) |
| convex-db (opens in a new tab) | SQL database with JDBC and PostgreSQL protocol |  (opens in a new tab) |  (opens in a new tab) |
| convex-x402 (opens in a new tab) | x402 payment protocol support |  (opens in a new tab) |  (opens in a new tab) |
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.
The fastest way to try Convex is the Web Sandbox (opens in a new tab) — a live REPL on the public testnet. Evaluate an expression, then deploy and call a one-line smart contract:
;; Free query — no account needed
(+ 1 2 3)
;; => 6
;; With a faucet-funded account, deploy and call an actor (a smart contract)
(deploy '(defn ^:callable greet [name] (str "Hello, " name "!")))
;; => #1234 ;; your new actor's address
(call #1234 (greet "world"))
;; => "Hello, world!"Want the full walkthrough — including the TypeScript, Python, and Java SDKs against the testnet? See the Quick Start guide (opens in a new tab).
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:
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 installTry Convex Lisp straight from the terminal — no network, keys or setup needed:
convex eval "(+ 1 2)"
# => 3
convex repl # interactive REPL on an ephemeral local instanceBoth commands run against any network too, e.g. convex repl --host localhost.
Launch the desktop GUI:
convex desktopStart a local peer test network with GUI:
convex local guiSee all available commands:
convex --help.cvx demos in convex-core/src/test/resources/examples (opens in a new tab): fungible tokens, assets, trust monitors, the Torus DEX, and language.cvx for the language itself.convex-core/src/test/java/convex/core/examples (opens in a new tab) (start with RawCVM.java).Contributions 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.
See CONTRIBUTING.md (opens in a new tab) to get started, BUILD.md (opens in a new tab) for build and release detail, and AGENTS.md (opens in a new tab) for the conventions any coding agent working in this repository should follow.
We use Discord as for discussing Convex - you can join the public server at https://discord.com/invite/xfYGq4CT7v (opens in a new tab)
Alternatively, email: info(at)convex.world
Copyright 2017-2026 The Convex Foundation and Contributors
Unless otherwise specified, source code is available under the terms of the Convex Public License (opens in a new tab)