0.2.7 |
|
---|---|
0.2.6 |
|
0.2.2 |
|
0.1.7 |
|
在 #faucet 分类中排名第18
1MB
17K 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 | 返回创建/资助账户的交易 |
注意
- Type bool 表示您将值设置为字符串 "true" 或 "false"
- 对于由 pub_key 定义的可定义的现有账户,服务提交一个转账资金交易。
- 对于由 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
依赖关系
~132MB
~2.5M SLoC