简单介绍
bitcoincashjs 的这个中间件,它是bitcore-lib的一个分支。我看了下bitcore-lib,发现确实bitcoincashjs继承了它不少的优点,bitcoincashjs中间件主要实现了对交易的创建的功能,以及多重签名的创建和花费。
和一些封装好的rpc的区别
就是这个不用依赖于服务器创建交易,也就是说用这个中间件不用链接网络,减少了暴露私钥的风险,创建交易都是在本地完成,完成之后,在通过网络发送这个交易(可以通过别人提供的接口,也可以自己用rpc发送到自己服务器上)返回一个交易号就完成了这个交易。还有一些区别就是,bitcoincashjs 在其内部实现了一些随机生成地址、base58、签名等等一些东西,在一般的rpc当中就没有这些东西,都是和服务器交互相关的东西。
下面简单介绍下bitcoincashjs 的一些接口和功能。
1、创建一个随机地址,这个很简单,但是可能不经常用
const bch = require('bitcoincashjs');
const privateKey = new bch.PrivateKey();
const address = privateKey.toAddress();
console.log(address.toString())
这个在我们做钱包的时候就可以用,当然,你最好是在前端生成地址和私钥,不然别人不敢确信这个能用。
2、使用SHA256 哈希值创建一个地址
const bch = require('bitcoincashjs');
const value = new Buffer('Bitcoin Cash - Peer-to-Peer Electronic Cash');
const hash = bch.crypto.Hash.sha256(value);
const bn = bch.crypto.BN.fromBuffer(hash);
const address = new bch.PrivateKey(bn).toAddress();
console.log(address.toString())
3、把一个地址转化为其他任意BCH地址
const bch = require('bitcoincashjs');
const Address = bch.Address;
const BitpayFormat = Address.BitpayFormat;
const CashAddrFormat = Address.CashAddrFormat;
const address = new Address('1MF7A5H2nHYYJMieouip2SkZiFZMBKqSZe');
console.log(address.toString()) // 1MF7A5H2nHYYJMieouip2SkZiFZMBKqSZe
console.log(address.toString(BitpayFormat)) // Cchzj7d6fLX5CVd5Vf3jbxNbLNmm4BTYuG
console.log(address.toString(CashAddrFormat)) // bitcoincash:qr0q67nsn66cf3klfufttr0vuswh3w5nt5jqpp20t9
4、从任何比特币现金地址格式读取地址
const bch = require('bitcoincashjs');
const Address = bch.Address;
const fromString = Address.fromString;
const BitpayFormat = Address.BitpayFormat;
const CashAddrFormat = Address.CashAddrFormat;
const legacy = fromString('1MF7A5H2nHYYJMieouip2SkZiFZMBKqSZe',
'livenet', 'pubkeyhash');
const bitpay = fromString('Cchzj7d6fLX5CVd5Vf3jbxNbLNmm4BTYuG',
'livenet', 'pubkeyhash', BitpayFormat);
const cashaddr = fromString('bitcoincash:qr0q67nsn66cf3klfufttr0vuswh3w5nt5jqpp20t9',
'livenet', 'pubkeyhash', CashAddrFormat);
5、通过via WIF导入地址(这个很有用)
const bch = require('bitcoincashjs');
const wif = 'Kxr9tQED9H44gCmp6HAdmemAzU3n84H3dGkuWTKvE23JgHMW8gct';
const address = new bch.PrivateKey(wif).toAddress();
console.log(address.toString()) // 19AAjaTUbRjQCMuVczepkoPswiZRhjtg31
6、创建一笔交易,这里仅仅是一对一,如果想创建二对二交易在这里
const bch = require('bitcoincashjs');
const privateKey = new bch.PrivateKey('L1uyy5qTuGrVXrmrsvHWHgVzW9kKdrp27wBC7Vs6nZDTF2BRUVwy');
const utxo = {
'txId' : '115e8f72f39fad874cfab0deed11a80f24f967a84079fb56ddf53ea02e308986',
'outputIndex' : 0,
'address' : '17XBj6iFEsf8kzDMGQk5ghZipxX49VXuaV',
'script' : '76a91447862fe165e6121af80d5dde1ecb478ed170565b88ac',
'satoshis' : 50000
};
const transaction = new bch.Transaction()
.from(utxo)
.to('1Gokm82v6DmtwKEB8AiVhm82hyFSsEvBDK', 15000)
.sign(privateKey);
console.log(transaction.toString()) // 01000000018689302ea03ef...
7、验证比特币消息
const bch = require('bitcoincashjs');
const Message = bch.Message;
const message = new Message('Bitcoin Cash - Peer-to-Peer Electronic Cash.');
const address = '13Js7D3q4KvfSqgKN8LpNq57gcahrVc5JZ';
const signature = 'IJuZCwN/4HtIRulOb/zRLU1oCPVMiPvT5dJhgXxOuQNFaXoytoejPePUerSs9KSIvPL/BDimPe2cj/JabeDGmbc=';
console.log(message.verify(address, signature)) // true
8、签署比特币信息
const bch = require('bitcoincashjs');
const Message = bch.Message;
const message = new Message('Bitcoin Cash - Peer-to-Peer Electronic Cash.');
const privateKey =
new bch.PrivateKey('L23PpjkBQqpAF4vbMHNfTZAb3KFPBSawQ7KinFTzz7dxq6TZX8UA');
const signature = message.sign(privateKey);
console.log(signature.toString()) // IJuZCwN/4HtIRulOb/zRLU1oCP...
9、创建一个OP_RETURN交易
const bch = require('bitcoincashjs');
const privateKey = new bch.PrivateKey('L1uyy5qTuGrVXrmrsvHWHgVzW9kKdrp27wBC7Vs6nZDTF2BRUVwy');
const utxo = {
'txId' : '115e8f72f39fad874cfab0deed11a80f24f967a84079fb56ddf53ea02e308986',
'outputIndex' : 0,
'address' : '17XBj6iFEsf8kzDMGQk5ghZipxX49VXuaV',
'script' : '76a91447862fe165e6121af80d5dde1ecb478ed170565b88ac',
'satoshis' : 50000
};
const transaction = new bch.Transaction()
.from(utxo)
.addData('Bitcoin Cash - Peer-to-Peer Electronic Cash.') // Add OP_RETURN data
//这一条是我自己加的,在之前没有加就一直报错,希望有同样错误的小伙伴注意一下
.to('mhMmYqtR9wzbW9otiurkG9AGVNzjfww36v', 999920000)
.sign(privateKey);
console.log(transaction.toString()) // 01000000018689302ea03ef...
在创建OP_RETURN交易的时候,也要写明输出的地址,在官方的教程中没有写出来。导致了我很久都没有调试正确。希望有相同境遇的小伙伴注意。
9 、创建一个2-of-3的多签名的P2SH的地址
const bch = require('bitcoincashjs');
const publicKeys = [
'026477115981fe981a6918a6297d9803c4dc04f328f22041bedff886bbc2962e01',
'02c96db2302d19b43d4c69368babace7854cc84eb9e061cde51cfa77ca4a22b8b9',
'03c6103b3b83e4a24a0e33a4df246ef11772f9992663db0c35759a5e2ebf68d8e9'
];
const requiredSignatures = 2;
const address = new bch.Address(publicKeys, requiredSignatures);
console.log(address.toString()) // 36NUkt6FWUi3LAWBqWRdDmdTWbt91Yvfu7
关于这个publicKeys 的获取, 我在服务器上通过“validateaddress”这个命令获取到了publicKeys,获取这个需要你有私钥。
10、花费一个来自于2-of-2的多签名地址的钱
const bch = require('bitcoincashjs');
const privateKeys = [
new bch.PrivateKey('91avARGdfge8E4tZfYLoxeJ5sGBdNJQH4kvjJoQFacbgwmaKkrx'),
new bch.PrivateKey('91avARGdfge8E4tZfYLoxeJ5sGBdNJQH4kvjJoQFacbgww7vXtT')
];
const publicKeys = privateKeys.map(bch.PublicKey);
const address = new bch.Address(publicKeys, 2); // 2 of 2
const utxo = {
'txId' : '153068cdd81b73ec9d8dcce27f2c77ddda12dee3db424bff5cafdbe9f01c1756',
'outputIndex' : 0,
'address' : address.toString(),
'script' : new bch.Script(address).toHex(),
'satoshis' : 20000
};
const transaction = new bch.Transaction()
.from(utxo, publicKeys, 2)
.to('mtoKs9V381UAhUia3d7Vb9GNak8Qvmcsme', 20000)
.sign(privateKeys);
console.log(transaction.toString()) // 010000000156171cf0e9dba...
以上例子来源于bitcoincashjs 的GitHub。