Skip to content

Receipt generator bot #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
heisdaniele wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Receipt generator bot #34

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
0aae4d0
Create README.md
heisdaniele Mar 21, 2025
37d6687
Add files via upload
heisdaniele Mar 21, 2025
045bbca
Create .env.example
heisdaniele Mar 21, 2025
18221d6
Create .env.example
heisdaniele Mar 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions MCP ideas/.env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
TELEGRAM_BOT_TOKEN=yourbottoken

# Base Network RPC URL (optional, default is https://mainnet.base.org)
BASE_RPC_URL=https://mainnet.base.org
4 changes: 4 additions & 0 deletions MCP ideas/Base-Receipt-Generator/.env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
TELEGRAM_BOT_TOKEN=yourbottoken

# Base Network RPC URL (optional, default is https://mainnet.base.org)
BASE_RPC_URL=https://mainnet.base.org
56 changes: 56 additions & 0 deletions MCP ideas/Base-Receipt-Generator/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Base Blockchain Receipt Generator

## Overview
Base Blockchain Receipt Generator is a Telegram bot that allows users to verify transactions on the Base network and generate professional, customizable receipts in PDF format. The bot makes it easy for merchants, freelancers, and businesses to create proof of payment for their Base network transactions.

## Features
- **Transaction Verification**: Verify transactions on the Base network
- **PDF Receipt Generation**: Create professional PDF receipts for verified transactions
- **Business Customization**: Add your business name, logo, and Base address
- **Transaction History**: View past receipts generated through the bot
- **Coming Soon**: Send and receive Base tokens directly through the bot

## Demo Video
Check out the bot in action:

[![Base Blockchain Receipt Generator Demo](https://img.youtube.com/vi/YhboDYnbn5w/0.jpg)](https://youtube.com/shorts/YhboDYnbn5w?si=FWwhCyAOXaco96G_)

[Watch the demo on YouTube](https://youtube.com/shorts/YhboDYnbn5w?si=FWwhCyAOXaco96G_)

## How It Works
1. Start a chat with the bot on Telegram
2. Set up your business name and logo (optional)
3. Verify a transaction by entering the transaction hash or URL
4. The bot fetches transaction details from the Base network
5. A professional PDF receipt is generated with your business info and transaction details
6. The receipt is delivered directly in the chat and saved for future reference

## Technology Stack
- Node.js
- Telegram Bot API
- PDFKit for PDF generation
- Axios for API calls
- Base Network APIs for transaction verification

## Installation
1. Clone the repository
2. Install dependencies with `npm install`
3. Configure your `.env` file with your Telegram bot token
4. Start the bot with `npm start`

## Future Plans
- Direct Base token transfers within the bot
- Accept payments via QR code
- Multiple currency support
- Integration with accounting software
- Invoice generation

## Contribution
Contributions are welcome! Feel free to submit pull requests or open issues.

## License
MIT License

---

*This project was created for the Base Builder Quest submission.*
Loading