0.2.7 Aug 16, 2022
0.2.6 Aug 13, 2022
0.2.2 Jul 22, 2022
0.1.7 Jul 10, 2022
0.1.1 Jun 6, 2022

#18 in #faucet

Used in 9 crates (2 directly)


12K SLoC


Faucet is a service for creating and funding accounts on the Aptos Network. It is meant to be used for devnets and testnets. By default, the Faucet takes the provided account, creates a new account, mints a lot of Coin into that account, and delegates minting capability to that account. That account is then used to provide mint services via the faucet.

Mint API

The Mint API can create and fund your account.

  • Base URL: http://faucet.testnet.aptoslabs.com/
  • Path: /mint
  • Method: POST

URL Query Params:

param name type required? description
amount int Y Amount of coins to mint. This is not always enabled.
pub_key string Y Your account public key (ed25519)
return_txns bool N Returns the transactions for creating / funding the account


  • Type bool means you set value to a string "true" or "false"
  • For existing accounts as defined by the pub_key, the service submits 1 transfer funds transaction.
  • For new accounts as defined by the pub_key, the service first issues a transaction for creating the account and another for transferring funds.
  • All funds transferred come from the account 0xa550c18.
  • Clients should retry their request if the requests or the transaction execution failed. One reason for failure is that, under load, the service may issue transactions with duplicate sequence numbers. Only one of those transactions will be executed, the rest will fail.


If the query param return_txns is not provided, or it is not "true", the server returns a json-encoded list of transaction hash values. These can be used to monitor the status of submitted transactions.

If the query param return_txns is set, the server will respond with the transactions for creating and funding your account. The response HTTP body is hex encoded bytes of BCS encoded Vec<aptos_types::transaction::SignedTransaction>.

Decode Example (source code generator):

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

  txns = []
  for i in range(length):

You should retry the mint API call if the transaction execution fails.


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


~2M SLoC