Skip to content

Latest commit

 

History

History
229 lines (198 loc) · 12.4 KB

README3-zhchs.md

File metadata and controls

229 lines (198 loc) · 12.4 KB

基于Mixin Network的 Java 比特币开发教程: 创建比特币钱包

cover 我们已经创建过一个回复消息的机器人和一个能自动支付比特币的机器人.

通过本教程的学习，你可以学到如下内容

  1. 如何创建一个比特币钱包.
  2. 如何读取比特币钱包的余额.
  3. 如何支付比特币并即时确认.
  4. 如何将Mixin Network的比特币提现到你的冷钱包或第三方交易所.

前期准备：你要有一个Mixin Network账户。下面的代码创建一个帐号，并写到csv文件里。

  KeyPairGenerator kpg = KeyPairGenerator.getInstance("RSA");
  kpg.initialize(1024);
  KeyPair kp = kpg.genKeyPair();

  RSAPrivateKey priv = (RSAPrivateKey) kp.getPrivate();
  RSAPublicKey pub = (RSAPublicKey) kp.getPublic();

  String SessionSecret = Base64.getEncoder().encodeToString(pub.getEncoded());
  JsonObject walletInfo = mixinApi.createUser("java wallet",SessionSecret);
  System.out.println(walletInfo.get("session_id").getAsString());

  BufferedWriter writer = Files.newBufferedWriter(Paths.get(WALLET_FILANAME),
                                                  StandardOpenOption.CREATE,
                                                  StandardOpenOption.APPEND);
  CSVPrinter csvPrinter = new CSVPrinter(writer, CSVFormat.DEFAULT.withDelimiter(','));
  csvPrinter.printRecord(Arrays.asList(Base64.getEncoder().encodeToString(priv.getEncoded()),
                        walletInfo.get("pin_token").getAsString(),
                        walletInfo.get("session_id").getAsString(),
                        walletInfo.get("user_id").getAsString()));
  csvPrinter.flush();
  MixinAPI mixinApiUser = generateAPI_FromCSV();
  JsonObject asset = mixinApiUser.updatePin("","123456");
  System.out.println(asset);

上面的语句会在本地创建一个RSA密钥对，然后调用Mixin Network来创建帐号，最后保存帐号信息到csv文件.

现在你需要小心保管好你的帐号信息，在读取该账户的比特币资产余额或者进行其他操作时，将需要用到这些信息.

给新建的帐号创建一个比特币钱包

新账号并不默认内置比特币钱包， 现在读一下比特币余额就可以创建一个比特币钱包。

  MixinAPI mixinApiUser = generateAPI_FromCSV();
  JsonObject asset = mixinApiUser.getAsset(BTC_ASSET_ID);
  System.out.println(asset);
  System.out.println("------------------------BTC------Information---------------------------");
  System.out.println("The BTC wallet address is " + asset.get("public_key").getAsString());
  System.out.println("The BTC wallet balance is " + asset.get("balance").getAsString());
  System.out.println("-----------------------------------------------------------------------");

创建的帐号的比特币资产详细信息如下，其中public key就是比特币的存币地址:

Make your choose:2
2
{"type":"asset","asset_id":"c6d0c728-2624-429b-8e0d-d9d19b6592fa","chain_id":
"c6d0c728-2624-429b-8e0d-d9d19b6592fa","symbol":"BTC","name":"Bitcoin",
"icon_url":"https://images.mixin.one/HvYGJsV5TGeZ-X9Ek3FEQohQZ3fE9LBEBGcOcn4c4BNHovP4fW4YB97Dg5LcXoQ1hUjMEgjbl1DPlKg1TW7kK6XP=s128",
"balance":"0","public_key":"1KVcMVbSNdubRPKwGcaf9isuMXWFKCCkAH","account_name":"",
"account_tag":"","price_btc":"1","price_usd":"5081.36352765","change_btc":"0",
"change_usd":"-0.019033421740167297","asset_key":
"c6d0c728-2624-429b-8e0d-d9d19b6592fa","confirmations":6,"capitalization":0}
------------------------BTC------Information---------------------------
The BTC wallet address is 1KVcMVbSNdubRPKwGcaf9isuMXWFKCCkAH
The BTC wallet balance is 0
-----------------------------------------------------------------------

这个API能够提供若干与比特币有关的信息:

  • 存币地址:[public_key]
  • Logo: [icon_url]
  • 资产名字:[name]
  • 资产在Mixin Network的uuid: [asset_key]
  • 对美元的价格(Coinmarketcap.com提供): [price_usd]
  • 存币时确认的区块数量:[confirmations]

比特币私钥呢？

比特币的私钥呢？这个私钥被Mixin Network通过多重签名保护，所以对用户来说是不可见的,比特币资产的提现和转账都需要用户提供正确的的RSA签名,PIN代码与会话密钥才能完成.

不只是比特币，还有以太坊，EOS等

这个帐号不只支持比特币，还支持以太坊，EOS等, 完整的区块链支持列表. 这个账户同时也支持所有的 ERC20 代币与 EOS 代币.

创建其它的币的钱包与创建比特币钱包过程一样，读对应的资产余额就可以.

Mixin Network 当前支持的加密货币 (2019-02-19)

crypto uuid in Mixin Network
EOS 6cfe566e-4aad-470b-8c9a-2fd35b49c68d
CNB 965e5c6e-434c-3fa9-b780-c50f43cd955c
BTC c6d0c728-2624-429b-8e0d-d9d19b6592fa
ETC 2204c1ee-0ea2-4add-bb9a-b3719cfff93a
XRP 23dfb5a5-5d7b-48b6-905f-3970e3176e27
XEM 27921032-f73e-434e-955f-43d55672ee31
ETH 43d61dcd-e413-450d-80b8-101d5e903357
DASH 6472e7e3-75fd-48b6-b1dc-28d294ee1476
DOGE 6770a1e5-6086-44d5-b60f-545f9d9e8ffd
LTC 76c802a2-7c88-447f-a93e-c29c9e5dd9c8
SC 990c4c29-57e9-48f6-9819-7d986ea44985
ZEN a2c5d22b-62a2-4c13-b3f0-013290dbac60
ZEC c996abc9-d94e-4494-b1cf-2a3fd3ac5714
BCH fd11b6e3-0b87-41f1-a41f-f0e9b49e5bf0

EOS的存币地址与其它的币有些不同，它由两部分组成： account_name and account tag, 如果你向Mixin Network存入EOS，你需要填两项数据： account name 是eoswithmixin,备注里输入你的account_tag,比如0aa2b00fad2c69059ca1b50de2b45569.

EOS的资产余额返回结果如下:

{"type":"asset","asset_id":"6cfe566e-4aad-470b-8c9a-2fd35b49c68d",
"chain_id":"6cfe566e-4aad-470b-8c9a-2fd35b49c68d",
"symbol":"EOS","name":"EOS",
"icon_url":"https://images.mixin.one/a5dtG-IAg2IO0Zm4HxqJoQjfz-5nf1HWZ0teCyOnReMd3pmB8oEdSAXWvFHt2AJkJj5YgfyceTACjGmXnI-VyRo=s128",
"balance":"0","public_key":"",
"account_name":"eoswithmixin","account_tag":"10ad0870e9595bdedb4334360a8d4165",
"price_btc":"0.00105635","price_usd":"5.38549443","change_btc":"-0.014835576787888972",
"change_usd":"-0.031082698851444927","asset_key":"eosio.token:EOS","confirmations":64,"capitalization":0}
------------------------EOS------Information---------------------------
The EOS wallet Name is eoswithmixin Tag is 10ad0870e9595bdedb4334360a8d4165
The EOS wallet balance is 0
-----------------------------------------------------------------------

存入比特币与读取比特币余额

现在，你可以向比特币的钱包存币了。

当然，在比特币网络里转币，手续费是相当贵的，费用的中位数在0.001BTC,按当前4000美元的价格，在4美元左右，有一个方便的办法，如果你有Mixin Messenger帐号，里面并且有比特币的话，可以直接提现比特币到新创建的帐号的比特币充值地址，它们在同一个Mixin Network网络内，手续费为0，而且1秒到账。

下面的代码，可以读取比特币钱包余额.

  JsonObject asset = mixinApiUser.getAsset(BTC_ASSET_ID);

Mixin Network网内免手续费的，并且即时确认

任何币在Mixin Network内部的交易，都是无手续费的，并且立刻到账。 前期准备： 账户设置了PIN

对于新创建的帐号，我们通过updatePin来设置新PIN码, 代码如下：

  MixinAPI mixinApiUser = generateAPI_FromCSV();
  JsonObject asset = mixinApiUser.updatePin("","123456");
  System.out.println(asset);

Mixin Network帐号之间的比特币支付

通过Mixin Messenger，我们可以先转比特币给机器人，然后让机器人转币给新用户。

  if ( input.equals("tbb") ) {
   MixinAPI mixinApiUser = generateAPI_FromCSV();
   JsonObject asset = mixinApi.getAsset(BTC_ASSET_ID);
   System.out.println(asset);
   if ( asset.get("balance").getAsFloat() > 0 ) {
       JsonObject transInfo = mixinApi.transfer(BTC_ASSET_ID,mixinApiUser.getClientID(),
                                                asset.get("balance").getAsString(),"hi");
       System.out.println("------------------------BTC Transfer from Bot Information---------------------------");
       System.out.println(transInfo);
       System.out.println("-----------------------------------------------------------------------");
    }
  }

读取Bitcoin的余额，来确认比特币是不是转成功了！ 注意mixinApiUser是新用户的。

  JsonObject asset = mixinApiUser.getAsset(BTC_ASSET_ID);

如何将比特币存入你的冷钱包或者第三方交易所

如果你希望将币存入你的冷钱包或者第三方交易所, 先要得到冷钱包或者你在第三方交易所的钱包地址，然后将钱包地址提交到Mixin Network.

  • 要点提示: 提现是需要支付收续费的,准备好比特币包地址!

增加目的钱包地址到Mixin Network

调用createAddress API, 将会返回一个address_id,下一步的提现操作会用到这个id。

  private static final String BTC_WALLET_ADDR  = "14T129GTbXXPGXXvZzVaNLRFPeHXD1C25C";
  private static final String BTC_ASSET_ID     = "c6d0c728-2624-429b-8e0d-d9d19b6592fa";

  MixinAPI mixinApiUser = generateAPI_FromCSV();
  JsonObject addrInfo = mixinApiUser.createWithdrawAddress(BTC_ASSET_ID,
                                                         BTC_WALLET_ADDR,"","","123456","hi");
  System.out.println(addrInfo);
  System.out.println("------------------------BTC---Withdrawal---Information---------------------------");
  System.out.println("The BTC Witchdrawal address is " + addrInfo.get("public_key").getAsString());
  System.out.println("The BTC withdraw fee  is " + addrInfo.get("fee").getAsString());
  System.out.print("Input the BTC withdraw amount:");
  String eosAmount = System.console().readLine();
  JsonObject withdrawInfo = mixinApiUser.withdrawals(addrInfo.get("address_id").getAsString(),
                                                 eosAmount,"","123456","memo");
  System.out.println(withdrawInfo);

这里的 14T129GTbXXPGXXvZzVaNLRFPeHXD1C25C 就是一个比特币钱包地址, 如下所示，提现费用是0.0025738 BTC, address_id 是"345855b5-56a5-4f3b-ba9e-d99601ef86c1".

Make your choose:wb
wb
{"type":"address","address_id":"58860d12-cbdc-40ae-8a4a-b0fc72f418b3",
"asset_id":"c6d0c728-2624-429b-8e0d-d9d19b6592fa","public_key":"14T129GTbXXPGXXvZzVaNLRFPeHXD1C25C",
"label":"hi","account_name":"","account_tag":"","fee":"0.00118846","reserve":"0","dust":"0.0001",
"updated_at":"2019-04-16T06:12:15.686517454Z"}
------------------------BTC---Withdrawal---Information---------------------------
The BTC Witchdrawal address is 14T129GTbXXPGXXvZzVaNLRFPeHXD1C25C
The BTC withdraw fee  is 0.00118846

创建提现地址成功后，你可以用readAddress读取最新的提现费。

 JsonObject addrInfo3 = mixinApiUser.getAddress(addrInfo.get("address_id").getAsString());
 System.out.println(addrInfo3);

提交提现请求，Mixin Network会即时处理提现请求.

提交提现请求到 Mixin Network, withdrawAddress.address_id 就是createAddress创建的。

  MixinAPI mixinApiUser = generateAPI_FromCSV();
  JsonObject addrInfo = mixinApiUser.createWithdrawAddress(BTC_ASSET_ID,
                                                         BTC_WALLET_ADDR,"","","123456","hi");
  System.out.println(addrInfo);
  System.out.println("------------------------BTC---Withdrawal---Information---------------------------");
  System.out.println("The BTC Witchdrawal address is " + addrInfo.get("public_key").getAsString());
  System.out.println("The BTC withdraw fee  is " + addrInfo.get("fee").getAsString());
  System.out.print("Input the BTC withdraw amount:");
  String eosAmount = System.console().readLine();
  JsonObject withdrawInfo = mixinApiUser.withdrawals(addrInfo.get("address_id").getAsString(),
                                                 eosAmount,"","123456","memo");
  System.out.println(withdrawInfo);
  System.out.println("-----------------------------------------------------------------------");

可以通过blockchain explore来查看进度.

完整的代码在这儿