Depending on the type of network you are using, you can use transactions to:
- Create accounts and mint fake Diem Coins in testnet
- Create a ChildVASP account in mainnet and pre-mainnet
If you are using testnettestnet - A publicly deployed instance of the Diem network that runs using a set of validator test nodes. The testnet is a demonstration of the Diem network that is built for experimenting with new ideas. It simulates a digital payment system; the coins on the testnet have no real world value., you can use the FaucetFaucet - The way to create Diem currency on our testnet with no real-world value. The Faucet is a service running along with the testnet. This service exists only to facilitate minting coins for the testnet. You can use the Faucet by sending a request to create coins and transfer them into a given account on your behalf. service to perform certain actions that only by performed by the Diem Association on mainnetmainnet - The production network for the Diem Payment Network.. You can do the following by sending requests to the faucet service endpoint:
- Create a ParentVASP accountParentVASP account - The ParentVASP account is your unique root account. You can have only one parent account per Regulated VASP. Diem Networks will create a ParentVASP account on your behalf with your authentication key..
- Mint and add fake Diem Coins to accounts for testing.
To create a ParentVASP account in testnet, send a request like the code example below to the faucet server:
http://<faucet server address>/?amount=<amount>&auth_key=<auth_key>¤cy_code=<currency_code>
In this example request,
auth_keyis the authorization key for an account.
amountis the amount of money available as the account balance.
currency_codeis the specified currency for the amount.
This request first checks if there is an account available for the authorization key specified. If the account given by
auth_key doesn’t exist, a ParentVASP account will be created with the balance of the
amount in the
currency_code specified. If the account already exists, this will simply give the account the specified amount of
currency_code Diem Coins.
If you are a Regulated VASP, and have been approved by Diem Networks as a participant on the Diem Payment Network (DPN), you first need to complete an application with Diem Networks to have a ParentVASP account created on your behalf.
Once Diem Networks creates your ParentVASP account (let’s call it Account A), you can create a ChildVASP accountChildVASP account - The ChildVASP account is the child of your ParentVASP account. A ChildVASP account stores the address of its ParentVASP. You can have any number of ChildVASP accounts if you wish.
To create a ChildVASP account, send the create_child_vasp_account transaction script from your Account A (your ParentVASP account).
With a single ParentVASP account, you can create up to 256 ChildVASP accounts. This transaction script allows you to specify:
- Which currency the new account should hold, or if it should hold all known currencies.
- If you want to initialize the ChildVASP account with a specified amount of coins in a given currency.
A Regulated VASP can purchase Diem Coins from a Designated Dealer.
Updated 4 months ago