Skip to content

Latest commit

 

History

History
172 lines (116 loc) · 5.17 KB

README.md

File metadata and controls

172 lines (116 loc) · 5.17 KB

wallet

虚拟币钱包服务,转账/提现/充值/归集

完全实现与业务服务隔离,使用http服务相互调用

sdk列表

go示例 https://github.com/lmxdawn/wallet-v2-sdk-go

客户是PHP后端,特定增加一个php示例 https://github.com/lmxdawn/wallet-v2-sdk-php

目前有 Pro 版本,可以在 Issues 联系我

有 Pro 版本,更高级的钱包服务,可以wx 联系 appeth,添加时备注GitHub

计划支持

  • 以太坊(ERC20)
  • 波场(TRC20)
  • 币安(BEP20)
  • OKC(KIP20)
  • 比特币

接口文档

script/api.md

下载-打包

# 拉取代码
$ git clone https://github.com/lmxdawn/wallet.git
$ cd wallet

# 打包 (-tags "doc") 可选,加上可以运行swagger
$ go build [-tags "doc"]

# 直接运行示例配置
$ wallet -c config/config-example.yml

重新生成配置

# 生成配置文件
$ vim config.yml
$ wallet -c config.yml

配置文件参数解释

参数名 描述
coin_name 币种名称
contract 合约地址(为空表示主币)
contract_type 合约类型(波场需要区分是TRC20还是TRC10)
protocol 协议名称
network 网络名称(暂时BTC协议有用{MainNet:主网,TestNet:测试网,TestNet3:测试网3,SimNet:测试网})
rpc rpc配置
user rpc用户名(没有则为空)
pass rpc密码(没有则为空)
file db文件路径配置
wallet_prefix 钱包的存储前缀
hash_prefix 交易哈希的存储前缀
block_init 初始块(默认读取最新块)
block_after_time 获取最新块的等待时间
receipt_count 交易凭证worker数量
receipt_after_time 获取交易信息的等待时间
collection_after_time 归集等待时间
collection_count 归集发送worker数量
collection_max 最大的归集数量(满足多少才归集,为0表示不自动归集)
collection_address 归集地址
confirms 确认数量
recharge_notify_url 充值通知回调地址
withdraw_notify_url 提现通知回调地址
withdraw_private_key 提现的私钥地址

启动后访问: http://localhost:10009/swagger/index.html

Swagger

把 swag cmd 包下载 go get -u github.com/swaggo/swag/cmd/swag

这时会在 bin 目录下生成一个 swag.exe ,把这个执行文件放到 $GOPATH/bin 下面

执行 swag init 注意,一定要和main.go处于同一级目录

启动时加上 -tags "doc" 才会启动swagger。 这里主要为了正式环境去掉 swagger,这样整体编译的包小一些

启动后访问: http://ip:prot/swagger/index.html

第三方库依赖

log 日志 github.com/rs/zerolog

命令行工具 github.com/urfave/cli

配置文件 github.com/jinzhu/configor

环境依赖

go 1.16+

Redis 3

MySQL 5.7

其它

script/Generate MyPOJOs.groovy 生成数据库Model

合约相关

solcjs.cmd --version 查看版本

solcjs.cmd --abi erc20.sol

abigen --abi=erc20_sol_IERC20.abi --pkg=eth --out=erc20.go

准备

要实现这些功能首先得摸清楚我们需要完成些什么东西

  1. 获取最新区块
  2. 获取区块内部的交易记录
  3. 通过交易哈希获取交易的完成状态
  4. 获取某个地址的余额
  5. 创建一个地址
  6. 签名并发送luo交易
  7. 定义接口如下
type Worker interface {
getNowBlockNum() (uint64, error)
getTransaction(uint64) ([]types.Transaction, uint64, error)
getTransactionReceipt(*types.Transaction) error
getBalance(address string) (*big.Int, error)
createWallet() (*types.Wallet, error)
sendTransaction(string, string, *big.Int) (string, error)
}

实现

创建一个地址后把地址和私钥保存下来

通过一个无限循环的服务不停的去获取最新块的交易数据,并且把交易数据都一一验证是否完成 ,这里判断数据的接收地址(to)是否属于本服务创建的钱包地址,如果是本服务的创建过的地址则判断为充值成功,(这时逻辑服务里面需要做交易哈希做幂等)

用户发起一笔提出操作,用户发起提出时通过服务配置的私钥来打包并签名luo交易。(私钥转到用户输入的提出地址),这里把提交的luo交易的哈希记录到服务 通过一个无限循环的服务不停的去获取最新块的交易数据,并且把交易数据都一一验证是否完成 ,这里判断交易数据的哈希是否存在于服务,如果存在则处理**(这时逻辑服务里面需要做交易哈希做幂等)**

归集

通过定期循环服务创建的地址去转账到服务配置的归集地址里面,这里需要注意归集数量的限制,当满足固定的数量时才去归集(减少gas费)

一个简单的示例

github地址: golang 实现加密货币的充值/提现/归集服务

特别说明

创建钱包的方式可以用 create2 创建合约,这样可以实现不用批量管理私钥,防止私钥丢失或者被盗。