Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
new changes
  • Loading branch information
williamalvarezdev committed Oct 10, 2022
commit 7d857219dbf76b62a19cbe2a21693fead27ac109
46 changes: 34 additions & 12 deletions docs/get-started/running-cardano.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,17 @@ This guide assumes you installed `cardano-node` and `cardano-cli` into your syst
This guide does not cover the topic of running a block-producing `cardano-node` or running a **Cardano Stake Pool**. For more information regarding that topic, please visit the [Stake Pool Operation](/docs/operate-a-stake-pool/) section.
:::

## Cardano blockchain nets:
### Testnet
There are two types of testnet: `preview` and `pre-prod`.

- **Preview Testnet**: Testing release candidates and mainnet releases. Leads mainnet hard forks by at least 4 weeks. This net is for those who just want to see how it runs, get familiarised and play with cardano-node.

- **Pre-Production Testnet**: Testing release candidates and mainnet releases. Forks at approximately same time as mainnet (within an epoch of each other). This net is ideal for those who are ready to run the mainnet but want to test it before running it.

### Production (Mainnet)
This is the live Production. Only gets official mainnet releases. Please use this net once you are ready to use the cardano-node.

### Configuration Files

The `cardano-node` application requires at least four configuration files to run as of writing this article.
Expand All @@ -33,22 +44,21 @@ Currently, the `cardano-node` topology is manually set by the community of netwo
For more information about **Cardano** blockchain eras and upgrades, please visit the [Cardano Roadmap](https://roadmap.cardano.org/en).
:::

You can download the current **Cardano** blockchain network configuration files here:
You can download the current **Cardano** blockchain network configuration files [here](https://book.world.dev.cardano.org/environments.html#pre-production-testnet):

Or by typing:

#### Mainnet / Production

#### Testnet / Preview
```
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/config.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/db-sync-config.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/submit-api-config.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/topology.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/byron-genesis.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/shelley-genesis.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/alonzo-genesis.json
curl -O -J https://book.world.dev.cardano.org/environments/preview/config.json
curl -O -J https://book.world.dev.cardano.org/environments/preview/db-sync-config.json
curl -O -J https://book.world.dev.cardano.org/environments/preview/submit-api-config.json
curl -O -J https://book.world.dev.cardano.org/environments/preview/topology.json
curl -O -J https://book.world.dev.cardano.org/environments/preview/byron-genesis.json
curl -O -J https://book.world.dev.cardano.org/environments/preview/shelley-genesis.json
curl -O -J https://book.world.dev.cardano.org/environments/preview/alonzo-genesis.json
```

#### Testnet / Sandbox
#### Testnet / Prerod

```
curl -O -J https://book.world.dev.cardano.org/environments/preprod/config.json
Expand All @@ -60,6 +70,18 @@ curl -O -J https://book.world.dev.cardano.org/environments/preprod/shelley-genes
curl -O -J https://book.world.dev.cardano.org/environments/preprod/alonzo-genesis.json
```

#### Mainnet / Production

```
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/config.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/db-sync-config.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/submit-api-config.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/topology.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/byron-genesis.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/shelley-genesis.json
curl -O -J https://book.world.dev.cardano.org/environments/mainnet/alonzo-genesis.json
```

The latest supported networks can be found at https://book.world.dev.cardano.org/environments.html

:::note
Expand Down
32 changes: 20 additions & 12 deletions docs/integrate-cardano/testnet-faucet.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,19 +8,27 @@ image: ../img/og/og-developer-portal.png

The testnet faucet is a service that provides test ada (tAda) to users of the Cardano testnet. These tokens have no value, but they enable users to experiment with Cardano testnet features without spending real ada on the mainnet. You can use test ada to [mint native tokens](../native-tokens/minting), to [play around with Cardano wallets](creating-wallet-faucet) or to [learn how to operate a stake pool](../operate-a-stake-pool/).

## How to get test ada
1. Default funds are in `tAda`. If you'd like to test the native token functionality, select `Testcoin` from the dropdown menu.
1. Enter the address of the account where you want to top up funds.
1. If you have been issued with an API key, please enter this to access any additional funds you may have been allocated.
1. Confirm the `I'm not a robot` box and solve the captcha if needed.
1. Click on `Request` and the funds will be in the testnet account you specified within a few minutes. Use the [Cardano testnet explorer](https://explorer.cardano-testnet.iohkdev.io/) in case you want to check any transactions on the Cardano testnet.

<div id="faucetcontainer">
<iframe name="iframe" height="300" width="100%" scrolling="no" src="https://testnets.cardano.org/en/testnets/cardano/tools/faucet/" class="faucet"></iframe>
</div>

## Testnets faucet

This portal allows you to send test ada to your wallet. You can access it [here](https://docs.cardano.org/cardano-testnet/tools/faucet).

:::note Return the test ada
Send your test tokens to this address: `addr_test1qqr585tvlc7ylnqvz8pyqwauzrdu0mxag3m7q56grgmgu7sxu2hyfhlkwuxupa9d5085eunq2qywy7hvmvej456flknswgndm3`
:::
:::

## How to get test ada
1. Define your environment. You can get tada for either the `preview` or `prepod testnet`.
2. Define your action. Select `Receive test ADA` in this case. You can also ask for `pool delegation` if you are managing a pool (learn [more](https://developers.cardano.org/docs/operate-a-stake-pool/)).
3. Enter the address of the account where you want to top up funds.
4. If you have been issued with an API key, please enter this to access any additional funds you may have been allocated.
5. Confirm the `I'm not a robot` box and solve the captcha if needed.
6. Click on `Request` and the funds will be in the testnet account you specified within a few minutes. Use the [Cardano testnet explorer](https://explorer.cardano-testnet.iohkdev.io/) in case you want to check any transactions on the Cardano testnet.

<!-- Commented iframe, but please feel free to test the w x h to fit it to the browser -->
<!-- <div id="faucetcontainer">
<iframe name="iframe" height="500" width="150%" src="https://testnets.cardano.org/en/testnets/cardano/tools/faucet/" class="faucet"></iframe>
</div> -->