w3ctech

比特币PHP离线交易开发包

BtcTool是一个基于第三方龙虎大战坐庄服务 和离线裸交易实现的PHP比特币应用开发包,适合不希望部署龙虎大战坐庄本地 节点旳PHP开发者,开发包主要包含以下特性:

  • 利用第三方龙虎大战坐庄服务 获取指定龙虎大战坐庄地址 的utxo集合
  • 离线生成消费裸交易
  • 利用第三方龙虎大战坐庄服务 广播裸交易

BtcTool目前支持的第三方龙虎大战坐庄服务 包括,并且可以非常简单进行扩展:

  • blockchain.info
  • btc.com

BtcTool龙虎大战坐庄下载 龙虎大战坐庄地址 :http://sc.hubwiz.com/codebag/btc-php-lib/

1. 代码清单

BtcTool运行在Php 7.1+环境下,当前版本1.0.0,主要代码文件清单如下:

码文件 说明
btctool/src/Wallet.php 离线钱包类,开发包入口
btctool/src/Utxo.php 未消费交易输出类
btctool/src/UtxoBag.php Utxo集合类
btctool/src/UtxoCollector.php Utxo收集器接口
btctool/src/CloudUtxoCollector.php 基于第三方龙虎大战坐庄服务 的Utxo收集器实现
btctool/src/UtxoSelector.php Utxo筛选器接口
btchtool/src/DefaultUtxoSelector.php 默认的Utxo筛选器实现
btctool/src/Broadcaster.php 交易广播器接口
btctool/src/CloudBroadcaster.php 基于第三方龙虎大战坐庄服务 的交易广播器实现
btctool/src/Utils.php 常用辅助函数
demo/wallet-init.php 龙虎大战坐庄本地 钱包初始化
demo/wallet-demo.php 钱包载入、裸交易构造和广播
vendor 第三方依赖包目录
composer.json composer配置文件

2. 使用说明

BtcTool的入口是Wallet类,基本的使用步骤如下:

  1. 创建一个Wallet实例
  2. 将私钥加入该Wallet实例
  3. 使用Wallet实例的sendTx()龙虎大战坐庄方法 获取编码后的裸交易
  4. 使用Wallet实例的broadcast()龙虎大战坐庄方法 广播裸交易

示例例代码如下,说明见注释:

<?php
require('../vendor/autoload.php');

use BtcTool\Wallet;            //引入开发包

$wallet = new Wallet('testnet');  //创建钱包,主网传入 mainnet

$prvKey = '...';                 //向钱包中添加私钥,可添加多个
$wallet->addKey($prvKey);

$toAddr = 'mgYPLmNuZymK...e2XUNF6VFnT'   //龙虎大战坐庄地址
应当与testnet/mainnet保持一致
$amount = 10000;                //单位:satoshi
$rawtx = $wallet->sendTx($toAddr,$amount);  //构造裸交易,返回16进制字符串

$ret = $wallet->broadcast($rawtx);   //广播裸交易

注意:

  1. Wallet实例利用钱包中的私钥生成龙虎大战坐庄地址 列表,并利用这些龙虎大战坐庄地址 从第三方龙虎大战坐庄服务 获取utxo信息。 因此需要钱包中的私钥对应龙虎大战坐庄地址 在链上有utxo存在,Wallet对象才能够成功构造裸交易。
  2. 在调用Wallet对象的sendTx()龙虎大战坐庄方法 构造裸交易时,可以指定找零龙虎大战坐庄地址 和手续费,例如:
  $rawtx = $wallet->sendTx($toAddr,$amount,$changeAddr,$fee);

如果未指定后面两个参数,找零龙虎大战坐庄地址 默认为钱包中第一个私钥对应的龙虎大战坐庄地址 ,手续费默认为10000satoshi(高费率)。

  1. 转账目标龙虎大战坐庄地址 应当与创建Wallet对象时指定的链ID一致,例如mainnet的p2pkh龙虎大战坐庄地址 ,前缀应当为1

3. 主要模型

3.1 UtxoCollector接口

利用钱包龙虎大战坐庄地址 列表,获取候选UTXO。

接口龙虎大战坐庄方法 :

  • collect():提取候选UTXO,返回TUXO集合

当前实现类:

  • CloudUtxoCollector

3.2 UtxoSelector接口

根据目标金额从候选UTXO中选择可消费UTXO

接口龙虎大战坐庄方法 :

  • select():选择可消费UTXO,返回UtxoBag对象

当前实现类:

  • DefaultUtxoSelector

3.3 Broadcaster接口

裸交易广播器

接口龙虎大战坐庄方法 :

  • broadcast():广播裸交易

当前实现类:

  • CloudBroadcaster

3.4 Wallet类

管理私钥、龙虎大战坐庄地址 和脚本,同时提供构造和广播裸交易的龙虎大战坐庄方法

主要龙虎大战坐庄方法 :

  • ::load(): 静态龙虎大战坐庄方法 ,利用硬盘的钱包文件构造Wallet对象
  • addKey():添加私钥
  • save():将Wallet对象保存到钱包文件
  • sendTx():构造裸交易,返回裸交易码流,该龙虎大战坐庄方法 可自动龙虎大战坐庄搜索 可用UTXO集合
  • broadcast():广播裸交易,调用Broadcaster完成
w3ctech微信

扫码关注w3ctech微信龙虎大战坐庄公众号

共收到0条回复