Skip to content

iExecBlockchainComputing/web3telegram-sdk

Repository files navigation

iExec logo

Web3Telegram

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.

npmlicense

Installation

Web3Telegram will be 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

License

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