Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
May 31, 2022 18:55
September 15, 2023 16:49
July 25, 2021 10:47


Gear is a Substrate-based smart-contract platform allowing anyone to run dApp in a few minutes.

CI GitHubStars Discord Twitter License

Hit the โญ button to keep up with our daily progress!

Getting Started

  1. ๐Ÿ‘ The easiest way to get started with Gear is to use a demo environment on

  2. ๐Ÿ”ง Follow the instructions from "Getting started in 5 minutes" to compile the Rust test smart contract to WebAssembly. ๐Ÿƒ Upload and run smart contract in Gear demo environment on, send a message to a program, check how it is going.

  3. ๐Ÿ“œ Write your own smart contract or take one from the examples. A comprehensive amount of smart contract examples are available for your convenience and faster onboarding.

  4. ๐Ÿ’ป Download and run your Gear node locally or create your own multi-node local testnet.

  5. ๐Ÿฌ Deep dive to the Smart Contracts section of the Gear Wiki for more details about how to implement and run your dApp in Gear.

Run Gear Node

For Linux/MacOS users install script is available:

curl --proto '=https' --tlsv1.2 -sSf | sh

Gear node can run in a single Dev Net mode or you can create a Multi-Node local testnet or make your own build of Gear node.

  1. Compile and launch node as described in Gear Node README. Alternatively, download nightly build of Gear node:

  2. Run Gear node without special arguments to get a node connected to the testnet:

  3. One may run a local node in development mode for testing purposes. This node will not be connected to any external network. Use --dev argument for running the node locally and storing the state in temporary storage:

    gear --dev
  4. Get more info about usage details, flags, available options and subcommands:

    gear --help

Implement and run your own blockchain application

  1. Gear provides dApp application templates that cover various use cases - DeFi, DAO, NFT and more. Write your own smart contract or take one from the available templates. Adapt a template in accordance with your business needs.

  2. Test your smart contract off-chain, test it on-chain using a local node, then upload to Gear network.

  3. Implement an interface for your dApp for interaction Gear network using JS API or use provided by Gear on

Gear components

  • core - Gear engine for distributed computing core components.

  • node - Gear substrate-based node, ready for hacking ๐Ÿš€.

  • gstd - Standard library for Gear smart contracts.

  • gear-js - JSON-RPC API of Gear backend.

  • examples - Gear smart contract examples.

Go to to dive into the documentation on Gear crates.

What does Gear do?

Gear provides the easiest and most cost-effective way
to run WebAssembly programs (smart-contracts) compiled from
many popular languages, such as Rust, C/C++ and more.

Gear ensures very minimal, intuitive, and sufficient API
for running both newly written and existing programs
on multiple networks without the need to rewrite them.

Smart Contracts are stored in the blockchainโ€™s state
and are invoked preserving their state upon request.

Gear enables a seamless transition to Web3,
enabling the running of dApps, microservices, middleware and open APIs.

๐Ÿ”ฅ Key features

  • Programs run in Wasm VM (near-native code execution speed)
  • Unique ๐Ÿ‘‘ : Parallelizable architecture (even greater speed)
  • Unique ๐Ÿ‘‘ : Actor model for message-passing communications - secure, effective, clear
  • dApp in minutes using Gear libraries
  • Based on Substrate

Main capabilities

Gear enables anyone to create and run any custom-logic dApp and is a go-to solution for the following types of applications:

  • Run dApps that support business logic of any project in the decentralized Gear network (very fast). Upload programs to the network and interact with them.
  • Being a Polkadot parachain, Gear establishes cross-chain communications between other blockchains, allowing anyone to run a dApp in the Polkadot network in a very cost-less manner.
  • Join Substrate-supported blockchains in any other platform outside Polkadot.
  • A standalone instance running microservices, middleware, open API and more


The blockchain technology launched a rapid transition from centralized, server-based internet (Web2) to decentralized, distributed one (Web3).

Web3 introduces a new type of decentralized applications (dApps) that enable the existence of DeFi, DEX, Decentralized marketplaces, NFTs, Creators and Social Tokens.

Smart Contract is an equivalent of a microservice which is stored on the blockchain network and is the essential building block of a decentralized application.

Modern blockchains solve many issues of the older blockchain networks, such as:

  • Lack of scalability, low transaction speed, high transaction costs
  • Domain-specific development language (high barrier to entry)
  • Complex and inefficient native consensus protocols
  • Absence of intercommunication tools

But still have room for improvements due to:

  • Fixated, rigid native consensus protocols
  • Lack of interoperability with other networks

To resolve the interoperability issue, Parity technologies focused on creating a technology that connects every other blockchain:

  • Polkadot - a blockchain of blockchains. Provides a โ€œrelay chainโ€ (the primary blockchain) that enables โ€œparachainsโ€ (functional blockchains) to be deployed on top of it. All parachains are interconnected, creating a massive network of multifunctional blockchain services.
  • Substrate - a modular framework that allows to create custom-built blockchains with consensus mechanism, core functionality and security out of the box.

Building a blockchain with Substrate allows it to be deployed on any compatible relay chain such as Polkadot and Kusama. Substrate serves as a layer of communication between the relay chain and the parachain.

How does it work?

The internal flow of Gear:


Refer to the technical paper for some insights about how Gear works internally.


Performance charts can be seen here:


You can request a new feature by creating a new issue or discuss it with us on Discord. Here are some features in progress or planned:


Gear is licensed under GPL v3.0 with a classpath linking exception.

twit github discord medium medium
Wiki โ€ข Community โ€ข Events โ€ข About us