Circle-Hackathon / Circle-Hackathon-HK-2023

0 stars 0 forks source link

C-Wallet Manager Bot #13

Open 0xAngelaTsang opened 9 months ago

0xAngelaTsang commented 9 months ago

C-Wallet Manager Bot

a Telegram Wallet Bot with Circle API Integration

Introduction

This Telegram bot is designed to manage digital wallets using the Circle API. It allows users to create wallets, add payment methods, and handle transactions such as deposits, withdrawals, and transfers within the Telegram platform, making financial management more accessible and efficient.

Purpose and Motivation

The primary goal of this project is to simplify and streamline digital wallet management. In the digital age, integrating financial functionalities into widely used messaging platforms like Telegram can significantly enhance user experience. This bot leverages the Circle API to offer a range of financial transactions, catering to users seeking efficient and secure financial management. It embodies a step towards integrating financial services seamlessly into everyday applications, a growing trend in the fintech industry.

Features

Installation

Prerequisites

Steps

  1. Clone the repository:

    git clone [repository-url]
  2. Navigate to the project directory:

    cd [project-directory]
  3. Install required dependencies:

    pip install requests python-telegram-bot

Setup

Setting Environment Variables

  1. Set the Circle API Key and Telegram Bot Token as environment variables. Replace [your_circle_api_key] and [your_telegram_bot_token] with your actual keys.

    • On Unix/Linux/MacOS:

      export CIRCLE_API_KEY='[your_circle_api_key]'
      export TELEGRAM_BOT_TOKEN='[your_telegram_bot_token]'
    • On Windows (Command Prompt):

      set CIRCLE_API_KEY=[your_circle_api_key]
      set TELEGRAM_BOT_TOKEN=[your_telegram_bot_token]

Running the Bot

Run the bot using the following command:

python tgwallet.py

Usage

Interact with the bot using the following commands in Telegram:

Additional Notes

Troubleshooting

If you encounter issues, check the application logs for detailed error messages. Ensure that your environment variables are correctly set and that the bot has internet access to communicate with the Circle API.

0xAngelaTsang commented 9 months ago

Github: https://github.com/AngelaTsangHKUST/Wallet/blob/main/tgwallet.py