1个不稳定版本
0.0.0 | 2024年7月23日 |
---|
9 在 #ark
137 每月下载量
1KB
rust-ark
比特币的Ark第二层支付协议的实现。
此存储库包含一个ASP服务器 aspd
,一个客户端钱包 bark
,以及包含用于这些实现的全部原语库。
演示
ark_demo.sh
脚本创建了一个很好的环境来测试 ark
。
source ark_demo.sh
首先,您需要设置一个regtest bicoind节点。如果您已经有了regtest
-node,您可以使用它。但您必须确保txindex
已启用。然而,如果启动一个新的regtest节点,教程将更容易遵循。
bd --daemon
您可以使用 type -a bd
来查看别名的作用。在这种情况下,它将告诉您 bd
是 bitcoind -regtest -datadir=/ark/test/bitcoindatadir -server -txdindex
的别名。
您可以使用 bitcoin-cli
,它被别名为 bcli
,来与节点交互。
bcli getnetworkinfo
然后,我们使用 aspd
-command 创建并配置了一个 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
配置中更改。