Getting Started

A quick introduction to Push Protocol
Push Protocol (previously EPNS) is the world’s first decentralized communication & notification protocol for Web3.
Using the protocol, any smart contract, dApp, or backend service can communicate both on-chain and off-chain via user wallet addresses in an open, gasless, multichain, and platform-agnostic fashion.
Being an open communication middleware, Push is building a suite of products to enable notifications, chats, video, audio and more that can be integrated and shown on any crypto wallet, mobile app, browser extension, or dApps enabling a native communication layer for Web3.0. We currently have four major products, Push Notifications, Push Chat and Push Video and Push Audio.
Quick Guide to Getting Started with Push Protocol 🛣
  • Any user who activates themselves on the protocol to send a notification is called a Channel.
  • In other words, a Channel is any service (protocol, dApp, or even web2 service) that wants to send notifications out to web3 usernames (wallet addresses).
  • A wallet address can create only one Channel on the protocol.
  • A channel is free to delegate (or revoke delegates) sending notifications functionality to any other wallet addresses on their behalf.
  • Creating a channel requires 50 PUSH, Channel info (Channel name, Image, description, CTA), and some ETH.
  • Channels can send notifications to their users(wallet addresses) in a number of ways, including:
    • Javascript SDK (Gasless. Best for automated logic from dApp / Backend)
    • Showrunners Framework (Scaffold/Gasless. Best for automated logic via scaffold backend)
    • Smart contract to Smart contract (requires gas, Best for instant on-chain events, piggybacks on an on-chain transaction via Interface ABI call)
    • Manually from Push dApp (Gasless, Best for manual logic)
    • Users can gaslessly opt-in to receive notifications from these Channels. See the entire walkthrough here.
  • Opted-in users are called subscribers of the Channels. Subscribers of the Channel receive notifications from those Channels in their Inboxes.
  • Non-opted users or non-subscribers of the Channel aren't alerted when they receive a notif from a non-subscribed channel, instead, it lands in their spam folder.
  • Currently, we have Staging and Prod dApp that interfaces with EPNS Protocol to enable communication & notifications.

Developer Guides & Concepts

Push Chat
Push Video
🖥 Learn everything about channels, their working mechanisms, and how to create one.
🔔 Explore all about notifications, their types, the different ways of sending and receiving notifications as well as other imperative details.
Understand the key features of EPNS SDK and how to use it in your own project easily.
📝 Learn about the details of Push Chat and how to easily integrate it.
🛠 Learn about the showrunners framework and how to use it to build out notifications for your specific use cases.
📝 Learn about the details of Push Video and how to easily integrate it:
How to integrate Push Video