## 1、添加tg官方机器人
https://t.me/BotFather



## 2、选择/newBot、根据提示输入一个自定义的机器人名称
![image.png](/static/img/fef92eeff2faab9c6f014da31d71cee4.image.webp)
## 3、根据提示再次输入机器人用户名 保持唯一(和tg账号一样)
![image.png](/static/img/9e0a57b0fac238c166ea8fe798fa6842.image.webp)

tg机器人创建教程

## 采用宝塔面板部署USDT支付插件
### 1、先在宝塔面板安装docker容器




![image.png](/static/img/83e68dffd4ade33872d286a7a91319f0.image.webp)
### 2、准备工作将[conf.example.toml](https://github.com/v03413/bepusdt/blob/main/conf.example.toml) 配置文件下载下来上传到服务器文件、可以直接在宝塔文件上传、也可以通过服务器ftp传入任意位置.记录文件所在位置(文件全路径) 
**例如**:/www/wwwroot/usdtPay/conf.toml

![image.png](/static/img/1e30864da5f3ae31ccdc74776a1c9a85.image.webp)
#### 修改配置文件内容:
![image.png](/static/img/d3bf0ece8a3865520c2f08911ff180f6.image.webp)

![image.png](/static/img/10842f85e72114fffaf749d49d6886ef.image.webp)
配置文件中也有丰富的注释可以供参考 
疑问是我不需要对接tg机器人如何使用该插件? 
没有深究这个问题，但是现在是不配置tg机器人是无法启动的! 
tg机器人创建可查看: [tg机器人创建](https://www.tiger-blog.cn/post/7) 
如何获取自己账户的tg id查看: [如何获取自己账户的tg id](https://www.tiger-blog.cn/post/8)
### 3、选择容器->创建容器->命令创建
![image.png](/static/img/c6abc39e9969395457eccc113284f54d.image.webp)
#### 部署命令
```docker run -d --restart=unless-stopped \
-p 8080:8080 \
-v [配置文件路径]:/usr/local/bepusdt/conf.toml \
v03413/bepusdt:latest
```
[**配置文件路径**] 其中这个内容替换成你配置的文件路径
示例:

```docker run -d --restart=unless-stopped \
-p 8080:8080 \
-v /www/wwwroot/usdtPay/conf.toml:/usr/local/bepusdt/conf.toml \
v03413/bepusdt:latest
```
#### 将命令输入执行的命令行启动
![image.png](/static/img/692843efc7935da502820f661162679d.image.webp)
#### 启动完成绑定域名 可以通过反代容器实现
![image.png](/static/img/31493948a41412eee219f5e4c9dbc88f.image.webp)

## 项目来源声明
https://github.com/v03413/BEpusdt

记录一次搭建USDT支付插件


```python
import re


def extract_emails_from_file(filename):
    """从文件中提取所有邮箱地址"""
    with open(filename, 'r', encoding='utf-8') as file:
        content = file.read()
    # 使用正则表达式匹配邮箱地址
    emails = re.findall(r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b', content)
    return emails


def create_vcard(email):
    """为单个邮箱创建vCard字符串"""
    username = email.split('@')[0]
    vcard = f"""BEGIN:VCARD
VERSION:3.0
EMAIL:{email}
N:{username};{username};;;
X-RAMBLER-CONTACT-TYPE:manual
END:VCARD
"""
    return vcard


def generate_vcf(emails, output_filename):
    """生成包含所有邮箱的vcf文件"""
    with open(output_filename, 'w', encoding='utf-8') as vcf_file:
        for email in emails:
            vcard = create_vcard(email)
            vcf_file.write(vcard)
            vcf_file.write('\n')  # 每个vCard之间用空行分隔


def main():
    input_filename = input("请输入包含邮箱的文件名: ")
    output_filename = input("请输入输出的vcf文件名(例如: contacts.vcf): ")

    emails = extract_emails_from_file(input_filename)

    if not emails:
        print("没有找到任何邮箱地址。")
        return

    generate_vcf(emails, output_filename)
    print(f"成功生成 {len(emails)} 个联系人到 {output_filename}")


if __name__ == "__main__":
    main()
```

生成邮箱联系人(vcf文件)

# BEpusdt (Better Easy Payment Usdt)

<img src="https://www.tiger-blog.cn/static/img/4eb67525f3bbeee907b32397851a7d3c.tether.svg" width="15%" alt="tether">


<a href="https://www.gnu.org/licenses/gpl-3.0.html"><img src="https://img.shields.io/badge/license-GPLV3-blue" alt="license GPLV3"></a>
<a href="https://golang.org"><img src="https://img.shields.io/badge/Golang-1.23-red" alt="Go version 1.23"></a>
<a href="https://github.com/gin-gonic/gin"><img src="https://img.shields.io/badge/Gin-v1.9-blue" alt="Gin Web Framework v1.9"></a>
<a href="https://github.com/go-telegram/bot"><img src="https://img.shields.io/badge/Go_Telegram_Bot-v1.15-blue" alt="Golang Telegram Bot"></a>
<a href="https://github.com/v03413/bepusdt"><img src="https://img.shields.io/github/v/release/v03413/bepusdt" alt="Release v1.19.1"></a>


## 🪧 介绍

基本就是对`Epusdt`重新造了一次轮子，移除一些非必要依赖(`Redis MySQL`)，同时加入一些新特性，让个人`USDT.TRC20`
收款更好用、部署更便捷！




## 🎉 新特性

**🌟 目前支持收款类型：trx usdt.trc20 usdt.bep20(币安) usdt.erc20(以太) usdt.polygon usdt.xlayer(OKX)**

- ✅ 完全兼容 `Epusdt`，插件可无缝替换
- ✅ 实时同步 USDT 汇率，支持自定义浮动
- ✅ 无`MySQL Redis`依赖，支持`Docker`部署
- ✅ 支持非订单交易监控，钱包余额变动通知
- ✅ 支持自定义 USDT 支付精度与递增颗粒度
- ✅ 底层区块扫描，无第三方 API，秒级响应
- ✅ 支持波场能量代理与能量回收监控通知
- ✅ 原生支持易支付对接，无三方插件依赖
- ✅ 支持创建订单时 自定义超时 钱包地址
- ✅ 完整支持`等待支付 支付超时`回调
- ✅ 支持事件`WebHook` 方便多方协同

## 🚀 安装部署

- [Docker 安装教程（推荐🔥）](./docs/docker.md)
- [异次元发卡对接教程 🌟](./docs/acg-faka.md)
- [萌次元商城系统对接 🌟](./docs/mcy-shop.md)
- [独角数卡对接教程 🌟](./docs/dujiaoka.md)
- [彩虹易支付对接教程](https://github.com/v03413/Epay-BEpusdt)
- [https 配置教程](./docs/ssl.md)
- [Linux 手动安装教程](./docs/systemd.md)
- [Linux 时钟同步配置](./docs/systemd-timesyncd.md)
- [API 对接开发签名算法](./docs/sign.md)
- [对接 回调通知说明](./docs/notify-epusdt.md)
- [Webhook 事件回调](./docs/webhook.md)

## 🖼 功能截图

![screenshot](./docs/images/screenshot.png)

## 🤔 常见问题

### 如何获取参数 TG_BOT_ADMIN_ID

Telegram 搜索加入群`@BEpusdtChat`，随后发送命令`/info`，返回的`ID`就是`TG_BOT_ADMIN_ID`

## ⚠️ 特别注意

- 订单交易强依赖时间，请确保服务器时间准确性，否则可能导致订单异常！
- 部分功能依赖网络，请确保服务器网络纯洁性，否则可能导致功能异常！

## 📚 接口文档

<details>
<summary>创建订单</summary> 

### 请求地址

```http
POST /api/v1/order/create-transaction
```

### 请求数据

```json
{
 "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", // 可根据实际情况传入收款地址，亦可留空
 "trade_type": "usdt.trc20", // usdt.trc20(默认) tron.trx 可选列表 https://github.com/v03413/bepusdt/blob/16d8df2cc5acc3d41c1c014ecb5370bd97f7e955/app/model/orders.go#L25:L30
 "order_id": "787240927112940881", // 商户订单编号
 "amount": 28.88, // 请求支付金额，CNY
 "signature":"123456abcd", // 签名
 "notify_url": "https://example.com/callback", // 回调地址
 "redirect_url": "https://example.com/callback", // 支付成功跳转地址
 "timeout": 1200, // 超时时间(秒) 最低60；留空则取配置文件 expire_time，还是没有取默认600
 "rate": 7.4 // 强制指定汇率，留空则取配置汇率；支持多种写法，如：7.4表示固定7.4、～1.02表示最新汇率上浮2%、～0.97表示最新汇率下浮3%、+0.3表示最新加0.3、-0.2表示最新减0.2
}
```

### 响应内容

```json
{
 "status_code": 200,
 "message": "success",
 "data": {
 "trade_id": "b3d2477c-d945-41da-96b7-f925bbd1b415", // 本地交易ID
 "order_id": "787240927112940881", // 商户订单编号
 "amount": "28.88", // 请求支付金额，CNY
 "actual_amount": "10", // 实际支付数额 usdt or trx
 "token": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", // 收款地址
 "expiration_time": 1200, // 订单有效期，秒
 "payment_url": "https://example.com//pay/checkout-counter/b3d2477c-d945-41da-96b7-f925bbd1b415" // 收银台地址
 },
 "request_id": ""
}

```

</details>

<details>
<summary>取消订单</summary> 

商户端系统可以通过此接口取消订单，取消后，系统将不再监控此订单，同时释放对应金额占用。

### 请求地址

```http
POST /api/v1/order/cancel-transaction
```

### 请求数据

```json
{
 "trade_id": "0TJV0br98YbNTQe7nQ", // 交易ID
 "signature":"123456abcd" // 签名内容
}
```

### 响应内容

```json
{
 "data": {
 "trade_id": "0TJV0br98YbNTQe7nQ"
 },
 "message": "success",
 "request_id": "",
 "status_code": 200
}
```

</details>

<details>
<summary>回调通知</summary>

```json
{
 "trade_id": "b3d2477c-d945-41da-96b7-f925bbd1b415",
 "order_id": "787240927112940881",
 "amount": 28.88,
 "actual_amount": 10,
 "token": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
 "block_transaction_id": "12ef6267b42e43959795cf31808d0cc72b3d0a48953ed19c61d4b6665a341d10",
 "signature": "123456abcd",
 "status": 2 // 1:等待支付 2:支付成功 3:支付超时
}
```

</details>

## 🙏 感谢

- https://github.com/assimon/epusdt

## 📢 声明

- 本项目仅供个人学习研究使用，任何人或组织在使用过程中请符合当地的法律法规，否则产生的任何后果责任自负。

USDT支付插件

# Java笛卡尔积实现

**现实场景**:将相同对象数据集内容进行生成出所有不重复的结构数据。

笛卡尔积是指两个集合中所有可能的有序对的集合。在Java中，我们可以通过多种方式实现笛卡尔积的计算。




## 1. 使用嵌套循环实现

这是最基本的方法，适用于两个集合的笛卡尔积计算。

```java
import java.util.ArrayList;
import java.util.List;

public class CartesianProduct {
 public static <A, B> List<Pair<A, B>> cartesianProduct(List<A> listA, List listB) {
 List<Pair<A, B>> result = new ArrayList<>();
 for (A a : listA) {
 for (B b : listB) {
 result.add(new Pair<>(a, b));
 }
 }
 return result;
 }

 public static void main(String[] args) {
 List<Integer> list1 = List.of(1, 2);
 List<String> list2 = List.of("A", "B", "C");
 
 List<Pair<Integer, String>> product = cartesianProduct(list1, list2);
 
 product.forEach(p -> System.out.println(p.getFirst() + ", " + p.getSecond()));
 }
}

class Pair<A, B> {
 private final A first;
 private final B second;
 
 public Pair(A first, B second) {
 this.first = first;
 this.second = second;
 }
 
 public A getFirst() { return first; }
 public B getSecond() { return second; }
}
```

## 2. 使用Java 8 Stream实现

Java 8的Stream API提供了更简洁的实现方式：

```java
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class CartesianProduct {
 public static <A, B> List<Pair<A, B>> cartesianProduct(List<A> listA, List listB) {
 return listA.stream()
 .flatMap(a -> listB.stream()
 .map(b -> new Pair<>(a, b)))
 .collect(Collectors.toList());
 }

 public static void main(String[] args) {
 List<Integer> list1 = List.of(1, 2);
 List<String> list2 = List.of("A", "B", "C");
 
 List<Pair<Integer, String>> product = cartesianProduct(list1, list2);
 
 product.forEach(p -> System.out.println(p.getFirst() + ", " + p.getSecond()));
 }
}
```

## 3. 多个集合的笛卡尔积

对于多个集合的笛卡尔积，可以使用递归或Stream的reduce操作：

```java
import java.util.*;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class CartesianProduct {
 public static <T> List<List<T>> cartesianProduct(List<List<T>> lists) {
 if (lists.isEmpty()) {
 return Collections.singletonList(Collections.emptyList());
 }
 
 return lists.stream()
 .reduce((list1, list2) -> list1.stream()
 .flatMap(e1 -> list2.stream()
 .map(e2 -> Stream.concat(e1.stream(), Stream.of(e2))
 .collect(Collectors.toList()))
 .collect(Collectors.toList()))
 .orElse(Collections.emptyList());
 }

 public static void main(String[] args) {
 List<List<String>> lists = List.of(
 List.of("A", "B"),
 List.of("1", "2"),
 List.of("X", "Y")
 );
 
 List<List<String>> product = cartesianProduct(lists);
 
 product.forEach(System.out::println);
 }
}
```

## 4. 使用Guava库

Google的Guava库提供了现成的笛卡尔积工具：

```java
import com.google.common.collect.Lists;
import java.util.List;

public class CartesianProduct {
 public static void main(String[] args) {
 List<Integer> list1 = List.of(1, 2);
 List<String> list2 = List.of("A", "B", "C");
 
 List<List<Object>> product = Lists.cartesianProduct(list1, list2);
 
 product.forEach(System.out::println);
 }
}
```

## 注意事项

1. 笛卡尔积的计算复杂度是O(n*m)，对于大集合可能会导致内存问题
2. 对于多个集合的笛卡尔积，复杂度会指数级增长
3. 考虑使用惰性求值（如Stream）来处理大数据集

以上方法可以根据具体需求选择使用，简单场景使用嵌套循环即可，复杂场景可以考虑使用Stream或第三方库。