0.2.7 |
|
---|---|
0.2.6 |
|
0.2.2 |
|
0.1.7 |
|
0.1.1 |
|
#17 in #faucet
每月 21 次下载
在 9 个 crate(2 个直接) 中使用
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