#ark #protocols #server

aspd

Ark协议的服务器实现

1个不稳定版本

0.0.0 2024年7月23日

9#ark

Download history 113/week @ 2024-07-20 24/week @ 2024-07-27

137 每月下载量

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

无运行时依赖