Gear Protocol is a Substrate-based solution for developers, enabling anyone to run a dApp in just a few minutes.

Hit the :star: button to keep up with daily protocol's development progress!

Getting Started

1. :open_hands: The easiest way to get started with Gear Protocol is by using the demo environment at https://idea.gear-tech.io.

2. :wrench: Follow the instructions from "Getting started in 5 minutes" to compile the Rust test program to Wasm. :running: Upload and run the program on the Vara Network Testnet via Gear Idea, send a message to a program, check how it is going.

3. :scroll: Write your own program or use one from the comprehensive examples library as a basis for a convenient and swift onboarding process.

4. :computer: Download and run your Gear node locally or create your own multi-node local testnet.

5. :dolphin: Deep dive to the Examples section of the Gear Wiki for more details about how to implement and run your dApp with Gear.

Run Gear Node

For Linux/MacOS users install script is available:

curl --proto '=https' --tlsv1.2 -sSf https://get.gear.rs/install.sh | 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:

   • macOS M-series (ARM): gear-nightly-aarch64-apple-darwin.tar.xz
   • macOS Intel x64: gear-nightly-x86_64-apple-darwin.tar.xz
   • Linux x64: gear-nightly-x86_64-unknown-linux-gnu.tar.xz
   • Windows x64: gear-nightly-x86_64-pc-windows-msvc.zip

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

   gear
   

3. Connect to the Vara network:

   gear --chain=vara
   

4. 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
   

5. Get more info about usage details, flags, available options and subcommands:

   gear --help
   

Implement and run your own blockchain application

1. Visit the Gear Wiki to explore dApp examples in action and gain a deeper understanding of their functionalities. Write your own program or take one from the available templates. Adapt a template in accordance with your business needs.

2. Test your program off-chain, test it on-chain using a local node, then upload to Gear-powered network via Gear Idea.

3. Implement frontend application that interacts with your program using JS API. React application examples are available here.

Gear Protocol components

• core - engine for distributed computing core components.

• node - substrate-based node, ready for hacking :rocket:.

• gstd - standard library for implementing programs with Gear Protocol.

• gtest - fast and lightweight tool for debugging program logic.

• gclient - a tool for testing programs with a real blockchain network.

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

Go to https://docs.gear.rs to dive into the documentation on Gear Protocol crates.

What does Gear Protocol do?

Gear Protocol provides the easiest and most cost-effective way
to run Wasm programs compiled from
many popular languages, such as Rust, C/C++ and more.

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

Programs are stored in the blockchain’s state
and are invoked preserving their state upon request.

Gear Protocol facilitates a seamless transition to Web3,
enabling the operation of dApps, microservices, middleware, and open APIs.

:fire: Key features

• Programs run in Wasm VM (near-native code execution speed)
• Unique :crown: : Parallelizable architecture (even greater speed)
• Unique :crown: : Actor model for message-passing communications - secure, effective, clear
• Unique :crown: : Continued messaging automation, payless transactions, and other features enable the implementation of truly on-chain user-friendly dApps.
• Unique :crown: : dApp in minutes using Gear Protocol's libraries
• Based on Substrate

Main capabilities

• Gear Protocol enables anyone to create and run a custom-logic decentralized programs.
• Programs can support business logic of any other projects running in the Gear-powered network (such as the Vara Network) and interact with them.
• Establish cross-chain communications between other Substrate-supported blockchains, allowing anyone to run a dApp in the Dotsama ecosystem in a very cost-less manner.
• A Gear node can run as a standalone instance running microservices, middleware, open API and more.

Why?

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

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

Programs running on the blockchain network can serve as the equivalent of microservices, which are the essential building blocks of decentralized applications.

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 the room for improvements remains related to:

• Optimisation of the user experience when using Web3 applications
• Lack of interoperability with other networks

How does it work?

The internal flow of Gear Protocol:

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

Performance

Performance charts can be seen here: https://gear-tech.github.io/performance-charts.

Contribution

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: https://github.com/gear-tech/gear/issues

License

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

• About us • Gear Wiki • News • Events • Vara Network •