#ark #protocols #bark #aspd #server

bark-aspd

Ark协议的服务器实现

1 个不稳定版本

0.0.0 2024年7月23日

#5 in #bark

Download history 72/week @ 2024-07-17 51/week @ 2024-07-24 4/week @ 2024-07-31

每月下载量 127 次

CC0 许可证

1KB

rust-ark

比特币Ark第二层支付协议的实现。

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

演示

ark_demo.sh 脚本创建了一个优雅的环境来与 ark 进行交互。

source ark_demo.sh

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

bd --daemon

您可以使用 type - 来查看别名的作用。在这种情况下,它将告诉您 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 配置中更改。

无运行时依赖项