1个不稳定版本

0.0.0 2024年7月23日

#6 in #bark

Download history 75/week @ 2024-07-17 72/week @ 2024-07-24 3/week @ 2024-07-31

每月150次下载

CC0 许可证

1KB

rust-ark

Ark第二层支付协议的Bitcoin实现。

此仓库包含一个ASP服务器,aspd,一个客户端钱包,bark,以及包含所有这些实现所需原语的库。

演示

ark_demo.sh 脚本创建了一个很好的环境来与 ark 玩。

source ark_demo.sh

首先,您需要设置一个regtest bicoind节点。如果您已经有一个 regtest-node,您可以使用它。您只需要确保 txindex 已启用。然而,如果您启动一个新的regtest节点,教程会更容易遵循。

bd --daemon

您可以使用 type -a bd 来查看别名的作用。在这种情况下,它将告诉您 bdbitcoind -regtest -datadir=/ark/test/bitcoindatadir -server -txdindex 的别名。

您可以使用别名 bitcoin-cli(别名 bcli)与节点交互。

bcli getnetworkinfo

然后我们使用 aspd-命令创建和配置一个ark-server。我们的ark-server将在 regtest 上运行,并使用我们在几行之前启动的 bitcoin-node。

aspd create \
    --network regtest \
    --datadir ./test/arkdatadir \
    --bitcoind-url $BITCOIND_URL \
    --bitcoind-cookie $BITCOIND_COOKIE

服务器可以使用以下命令启动

aspd start --datadir ./test/arkdatadir

服务器将立即开始工作,但需要一些资金才能正常工作。您可以在日志中找到链上地址,并向其发送一些资金。

bcli generatetoaddress 1 <asp-addr>

只有在生成100个额外区块后,资金才能使用。

bcli generatetoaddress 100 mtDDKi5mDjZqGzmbnfUnVQ8ZhCPMPVsApj

接下来,您可以启动一些客户端。要创建客户端,请使用以下命令

bark --datadir ./test/bark create \
    --regtest \
    --asp http://localhost:3535 \
    --bitcoind $BITCOIND_URL \
    --bitcoind-cookie $BITCOIND_COOKIE

bark --datadir ./test/bark2 create \
    --regtest \
    --asp http://localhost:3535 \
    --bitcoind $BITCOIND_URL \
    --bitcoind-cookie $BITCOIND_COOKIE

这些将创建单独的钱包,并打印一个您可以用来 以与上述ASP相同的方式为其提供资金 的链上地址。请注意,客户端可以在没有任何链上余额的情况下接收链下Ark交易,但需要一点链上资金才能执行单方面退出。

您可以使用以下方法找到钱包

BARK1_ADDR=$(bark --datadir ./test/bark1 get-address)
bcli generatetoaddress 1 $BARK1_ADDR
bcli generatetoaddress 100 mtDDKi5mDjZqGzmbnfUnVQ8ZhCPMPVsApj

要使用链上钱包,有一些命令可用

BARK2_ADDR=$(bark --datadir ./test/bark2 get-address)
bark --datadir ./test/bark1 send-onchain $BARK2_ADDR "0.1 btc"
bark --datadir ./test/bark2 balance

一旦我们有资金,我们就可以加入Ark,之后余额将显示链上和链下元素。

bark --datadir ./test/bark1 onboard "1 btc"
bark --datadir ./test/bark1 balance

请记住,如果您不偶尔生成区块,所有交易都只是在内存池中...

bcli generatetoaddress 1 mtDDKi5mDjZqGzmbnfUnVQ8ZhCPMPVsApj

然后,让我们发送一些链下资金

## Should be empty..
BARK2_PK=$(bark --datadir ./test/bark2 get-vtxo-pubkey)
# For now every client has just a single pubkey.
echo "${BARK2_PK}"
bark --datadir ./test/bark1 send-round ${BARK2_PK} "0.1 btc"
bark --datadir ./test/bark2 balance

您会注意到发送时会有轻微的延迟,这是因为客户端需要等待下一轮的开始,并且目前不支持跨轮次支付。轮次间隔可以在 aspd 配置中更改。

无运行时依赖