Web3Telegram offers developers methods to create apps that:

• enable an entity (such as a (d)app provider or an end-user) to message an Ethereum account holder without knowing her/his chatId or telegram username.
• eliminate the need for end-users to share their chatId or telegram username with multiple third-parties, reducing the risk of data breaches and spam.

Web3Telegram is composed of 3 methods:

• fetchMyContacts — that enables an entity to retrieve a list of Ethereum accounts whose owners have authorized the entity to message them
• fetchUserContacts — that enables an entity to retrieve a list of Ethereum accounts whose owners have authorized the provided user to message them
• sendTelegram — that allows an entity to message a user on telegram (previously fetched via the fetchMyContacts method) knowing only her/his Ethereum account.

Installation

Web3Telegram is available as an npm package.

npm:

npm install @iexec/web3telegram

yarn:

yarn add @iexec/web3telegram

Get started

Browser

import { IExecWeb3telegram } from '@iexec/web3telegram';

const web3Provider = window.ethereum;
const web3telegram = new IExecWeb3telegram(web3Provider);

NodeJS

import { IExecWeb3telegram, getWeb3Provider } from '@iexec/web3telegram';

const { PRIVATE_KEY } = process.env;

const web3Provider = getWeb3Provider(PRIVATE_KEY);
const web3telegram = new IExecWeb3telegram(web3Provider);

Documentation

• Web3telegram documentation
• Web3telegram technical design
• iExec Protocol documentation

License

This project is licensed under the terms of the Apache 2.0.