Skip to content

Latest commit

 

History

History
114 lines (74 loc) · 4.76 KB

bi-te-bi-qian-bao.md

File metadata and controls

114 lines (74 loc) · 4.76 KB
Raw

比特币钱包

关于如何在Leather(原Hiro)钱包中使用DLCs的说明，请访问:

{% embed url="https://leather.gitbook.io/developers/bitcoin/discreet-log-contracts" %}

Bitcoin Wallet Overview

签署DLC需要的功能并不总是存在于市场上现有的比特币钱包中。为了满足这一要求，DLC.Link将提供Rust和JavaScript编程语言的开源库。

DLC交易由两方处理，即要约人和承兑人。在我们当前的设置中，比特币钱包充当接受者，dApp充当提供者。它是处理接受签名，构建和签署合同执行交易(CETs)的比特币钱包，并广播到BTC区块链上。

Javascript DLC 接口的实例化

首先，使用npm安装DLC接口:

npm install dlc-wasm-wallet

然后将DLC界面导入到项目中:

import { JsDLCInterface } from 'dlc-wasm-wallet';

在使用谨慎日志合约(DLC)接口建立DLC之前，您必须使用特定的信息初始化它。这包括由比特币钱包提供的数据，例如用户的私钥、地址、选择的比特币网络、它的API端点以及证明方端点的URLs。

在提供了具体信息之后，您可以使用以下函数 new实例化DLC接口:

interface JsDLCInterface {
  new (
    userPrivateKey: string, // The user's private key.
    userAddress: string, // The user's address.
    bitcoinNetwork: string, // The Bitcoin network.
    bitcoinNetworkAPI: string, // The Bitcoin network API endpoint.
    attestorURLs: string // An array of attestor API endpoints (string[]), which has been converted into a JSON string.
  ): JsDLCInterface;
}

注意:在使用它们作为参数之前，确保所有必要的字段都是JSON字符串化的，因为接口使用JSON格式操作。

在底层，创建了一个DlcManager实例。

DlcManager用于管理区块链网络上分散的借贷合同的生命周期。它有几个方法来处理合同生命周期的不同阶段，比如创建、接受、签署和拒绝合同。\

比特币接待流程

第一步/收到报价

一旦合同在dApp中建立，发送到dApp的Router钱包(要约人的钱包)，经过验证并由要约人签名，就会收到要约。要约将包括一份合同，该合同已包含认证人公告和要约人参数。

如果您不熟悉如何从dApp请求报价，请参阅Interacting with Bitcoin Contracts。

收到要约后，比特币钱包可以审查合同并决定是否接受或拒绝。

Step 2 | Accept Offer第二步/接受报价

要接受比特币合约报价，必须使用accept_offer() 函数，该函数接受JSON格式的比特币合约报价作为参数。

当用户接受合约时，DLC接口的accept_offer()函数将使用临时合约id调用。

const bitcoinContractJSON = JSON.stringify(bitcoinContractOffer);

const acceptedBitcoinContract = await bitcoinContractInterface.accept_offer(bitcoinContractJSON);

一旦被接受，DlcManager会验证是否有足够的utxos可用，收集它们，并构建一个带有恒定id的退款签名。然后，它确保所有的CETs都由相关方和认证人签名。最后，它将合同保存在云存储中，并将其与用户的公钥关联起来。

第三步/发送接受要约到Router 钱包

在签署和广播比特币合约之前，您必须将接受的比特币合约报价发送到dApp的Router钱包。要做到这一点，你应该利用一个类似于下面的函数:

async function sendAcceptedBitcoinContractOfferToRouterWallet(
  acceptedBitcoinContractOffer: string,
  counterpartyWalletURL: string
) {
  return fetch(`${counterpartyWalletURL}/offer/accept`, {
    method: 'put',
    body: JSON.stringify({
      acceptMessage: acceptedBitcoinContractOffer,
    }),
    headers: { 'Content-Type': 'application/json' },
  }).then((res) => res.json());
}

const signedBitcoinContract = await sendAcceptedBitcoinContractOfferToRouterWallet(
  acceptedBitcoinContract,
  counterpartyWalletURL
);

如果Router钱包成功验证了接受的比特币合约报价，它将签署合约并将其返回给比特币钱包。

Step 4 | Sign and Broadcast第四步/签名与广播

要签名和广播比特币合约，必须使用countersign_and_broadcast()函数，该函数接受JSON格式的签名比特币合约作为参数。

const signedBitcoinContractJSON = JSON.stringify(signedBitcoinContract);

const txID = await bitcoinContractInterface.countersign_and_broadcast(signedBitcoinContractJSON);

该函数处理合同的签名和验证，并更新云存储中的合同。

函数执行后，比特币钱包将把合约广播到比特币区块链上。它返回合约的交易ID，你可以用它来跟踪区块链上的交易。