0.2.7 2022年8月16日
0.2.6 2022年8月13日
0.2.2 2022年7月22日
0.1.7 2022年7月10日
0.1.1 2022年6月6日

#17 in #faucet

每月 21 次下载
9 crate(2 个直接) 中使用

Apache-2.0

630KB
12K SLoC

水龙头

水龙头是一种用于在 Aptos 网络上创建和资助账户的服务。它旨在用于开发网络和测试网络。默认情况下,水龙头会接受提供的账户,创建一个新账户,在该账户中铸造大量硬币,并将铸造能力委托给该账户。然后使用该账户通过水龙头提供铸造服务。

铸造 API

铸造 API 可以创建并资助您的账户。

  • 基本 URL: http://faucet.testnet.aptoslabs.com/
  • 路径: /mint
  • 方法: POST

URL 查询参数

参数名称 类型 必需? 描述
amount int Y 铸造的硬币数量。此功能不一定始终启用。
pub_key string Y 您的账户公钥(ed25519)
return_txns bool N 返回创建/资助账户的交易

注意

  • 类型 bool 表示将值设置为字符串 "true" 或 "false"
  • 对于由 pub_key 定义的现有账户,服务提交 1 项转账资金交易。
  • 对于由 pub_key 定义的全新账户,服务首先发布创建账户的交易,然后发布转账资金的交易。
  • 所有转帐的资金都来自账户 0xa550c18。
  • 客户端如果在请求或事务执行失败时,应重试其请求。失败的一个原因是,在负载下,服务可能会发出具有重复序列号的事务。其中只有一个事务会被执行,其余的会失败。

响应

如果未提供查询参数 return_txns 或其不是 "true",则服务器返回一个包含事务哈希值的json编码列表。这些可以用于监控已提交事务的状态。

如果设置查询参数 return_txns,服务器将响应创建和为您的账户提供资金的事务。HTTP响应体是BCS编码的Vec<aptos_types::transaction::SignedTransaction>的十六进制编码字节。

解码示例(《源代码生成器)

  de = bcs.BcsDeserializer(bytes.fromhex(response.text))
  length = de.deserialize_len()

  txns = []
  for i in range(length):
    txns.push(de.deserialize_any(aptos_types.SignedTransaction))

如果事务执行失败,应重试铸造API调用。

示例

curl -X POST http://faucet.testnet.aptoslabs.com/mint\?amount\=1000000\&pub_key\=459c77a38803bd53f3adee52703810e3a74fd7c46952c497e75afb0a7932586d\&return_txns\=true
01000000000000000000000000000000dd05a600000000000001e001a11ceb0b010000000701000202020403061004160205181d0735600895011000000001010000020001000003020301010004010300010501060c0108000506080005030a020a020005060c05030a020a020109000b4469656d4163636f756e741257697468647261774361706162696c6974791b657874726163745f77697468647261775f6361706162696c697479087061795f66726f6d1b726573746f72655f77697468647261775f6361706162696c69747900000000000000000000000000000001010104010c0b0011000c050e050a010a020b030b0438000b051102020107000000000000000000000000000000010358555303585553000403a74fd7c46952c497e75afb0a7932586d0140420f00000000000400040040420f00000000000000000000000000035855532a610f6000000000020020056244e7bf776e471d818dc18fdf7b8833c5439ac9a96e126f8f32c7bc7c14b64026a2c45c8e4066c661dc4f36baa6ad61499999b548b9f63ad15853660c408cedec3078b7773a829ec48de8b04291cd11530734b2f91d5e42f35a4c6378cb7c09

依赖项

~90MB
~1.5M SLoC