🪄 Welcome to Telegram Super dApp Account Abstraction Magic! 🪄

Transforming Telegram into a seamless blockchain hub with our Account Abstraction Magic SDK — making crypto asset management effortless, secure, and gas-free for everyone

Table of Contents

• Features
• Screenshots
• Installation
• Usage
• API Endpoints
• Folder Structure
• Technologies Used
• Contributing
• License
• Contact

Features

• 💼 Custodial Wallet: Created and securely stored in Azure Key Vault.
• 🔑 Smart Accounts: Auto-creation using ERC-4337 account abstraction.
• ⚡️ Mint NFTs: Easily mint NFTs with a single tap.
• 💸 No Gas Fees: Gasless transactions facilitated by advanced transaction management.
• 🏦 Token and NFT Management: Simple and secure transfers and swaps of tokens and NFTs.
• 🌐 View NFTs: NFTs displayed directly in the app wallet.
• 🔄 Built-in Token Swap: Powered by Uniswap for seamless token exchanges.
• 📲 Developer Friendly SDK: Facilitates further integration and development.

Screenshots

Installation

1. Clone the repository:

   git clone https://github.com/andreykobal/telegram-mini-app-aa.git

2. Navigate to the project directory:

   cd telegram-mini-app-aa

3. Install dependencies for the frontend:

   npm install

4. Install dependencies for the backend:

   cd ../backend
   npm install

Usage

1. Start the backend server:

   cd backend
   npm start

2. Start the frontend application:

   cd ..
   npm start

3. Open your browser and navigate to http://localhost:3000

API Endpoints

POST /authenticate

• Description: Authenticate a user using Telegram init data.
• Request Body:

  {
    "initData": "string"
  }

POST /mint

• Description: Mint a new NFT.
• Request Body:

  {
    "initData": "string"
  }

POST /transfer

• Description: Transfer an NFT to another address.
• Request Body:

  {
    "initData": "string",
    "tokenId": "string",
    "toAddress": "string"
  }

POST /getNFTs

• Description: Retrieve NFTs owned by the authenticated user.
• Request Body:

  {
    "initData": "string"
  }

POST /sendETH

• Description: Send ETH to another address.
• Request Body:

  {
    "initData": "string",
    "toAddress": "string",
    "amount": "string"
  }

POST /getBalances

• Description: Retrieve balances of the authenticated user's wallet.
• Request Body:

  {
    "initData": "string"
  }

POST /getUsdtToUsdcRate

• Description: Fetch the swap rate from USDT to USDC.
• Request Body:

  {
    "amount": "string"
  }

POST /getUsdcToUsdtRate

• Description: Fetch the swap rate from USDC to USDT.
• Request Body:

  {
    "amount": "string"
  }

POST /getUsdtToWethRate

• Description: Fetch the swap rate from USDT to WETH.
• Request Body:

  {
    "amount": "string"
  }

POST /getWethToUsdtRate

• Description: Fetch the swap rate from WETH to USDT.
• Request Body:

  {
    "amount": "string"
  }

POST /getUsdcToWethRate

• Description: Fetch the swap rate from USDC to WETH.
• Request Body:

  {
    "amount": "string"
  }

POST /getWethToUsdcRate

• Description: Fetch the swap rate from WETH to USDC.
• Request Body:

  {
    "amount": "string"
  }

POST /swapUsdtToUsdc

• Description: Swap USDT to USDC.
• Request Body:

  {
    "initData": "string",
    "amount": "string"
  }

POST /swapUsdcToUsdt

• Description: Swap USDC to USDT.
• Request Body:

  {
    "initData": "string",
    "amount": "string"
  }

POST /swapUsdtToWeth

• Description: Swap USDT to WETH.
• Request Body:

  {
    "initData": "string",
    "amount": "string"
  }

POST /swapWethToUsdt

• Description: Swap WETH to USDT.
• Request Body:

  {
    "initData": "string",
    "amount": "string"
  }

POST /swapUsdcToWeth

• Description: Swap USDC to WETH.
• Request Body:

  {
    "initData": "string",
    "amount": "string"
  }

POST /swapWethToUsdc

• Description: Swap WETH to USDC.
• Request Body:

  {
    "initData": "string",
    "amount": "string"
  }

POST /webhook

• Description: Handle Telegram webhook events.

Folder Structure

.
├── .gitignore
├── backend
│   ├── .gitignore
│   ├── index.js
│   ├── metadata.json
│   ├── models
│   │   ├── MetadataIndex.js
│   │   └── User.js
│   ├── nft.js
│   ├── package-lock.json
│   ├── package.json
│   ├── swap.js
│   ├── test-swap-copy.js
│   ├── test-swap.js
│   ├── utils
│   │   ├── delete-all-users.js
│   │   ├── delete-user.js
│   │   └── get-all-users.js
│   ├── webhook.js
│   └── WETH9.json
├── package-lock.json
├── package.json
├── public
│   ├── favicon.ico
│   ├── index.html
│   ├── logo192.png
│   ├── logo512.png
│   ├── manifest.json
│   └── robots.txt
├── README.md
└── src
    ├── App.css
    ├── App.js
    ├── App.test.js
    ├── balance.js
    ├── Buy.js
    ├── client.js
    ├── CustomSelect.css
    ├── CustomSelect.js
    ├── EthToUsdConverter.js
    ├── Home.js
    ├── icons
    ├── index.css
    ├── index.js
    ├── logo.svg
    ├── reportWebVitals.js
    ├── setupTests.js
    └── Swap.js

Technologies Used

• Frontend: React
• Backend: Node.js, Express
• Database: MongoDB
• Blockchain: Hardhat, Viem, Biconomy, Base
• Hosting: Azure, Vercel

Contributing

Contributions are welcome! Please read the contributing guidelines first.

License

This project is licensed under the MIT License - see the LICENSE file for details.