Welcome to the Marlin documentation portal! If you're new to Marlin then you are in the right place. This document provides details about how Marlin protocol works and you can use Marlin. This document is constantly updated with the latest updates and developments in Marlin Protocol.

Developers looking to build on the Marlin Network can start with the Multicast SDK.

To understand the specification of Marlin protocol, checkout our Specficiation Docs.


Marlin is an open collection of protocols and related libraries that provides high-performance network infrastructure for decentralized systems.

What does Marlin give you?


The Marlin Network is able to achieve global latencies of <150ms. This enables developers to build high-performance responsive distributed systems (including blockchains and dapps).


The Marlin Network can scale to a large number of nodes without compromising on performance. Developers are no longer limited by the fanout capabilities of a single node.

What can I build using Marlin?

Some examples of the things that you can build using Marlin include:

  • A blockchain/sidechain with low block times
  • A validator network with much shorter rounds
  • An efficient and performant order relay system for DEXes
  • A performant live streaming service
  • A scalable IoT data marketplace
  • A push notification system for dapps
  • A responsive multiplayer game

How does it work?

At the core of the Marlin Network is a decentralized relay network of nodes(called Swiftnodes) which contribute their bandwidth and provide networking services like message forwarding. These nodes are connected to each other in a mesh topology and are incentivized to propagate messages in a low latency fashion.

At any point in time, there are a number of Clients connected to Swiftnodes at the edge of the Marlin Network listening for new messages propagating through the network albeit filtered based on their interest.

As soon as a Swiftnode receives a message, it immediately propagates the message to other Swiftnodes in the Marlin Network. The Swiftnodes at the edge of the network then immediately forward the message to all interested Clients.

How to get involved?

We at Marlin work on interesting problems like figuring out cryptoeconomics for incentivizing full nodes to propagate blocks and transactions, creating network topologies in a rapidly changing network and finding efficient rounting paths with multiple sources and multiple destinations. Join us to contribute ideas or join our research discussions at Marlin Research.

Kickstart your application on the Marlin Network by using our Multicast SDK.