Update docs to reflect that testnet faucet is not accessible programmatically (#742)

Author: banool

.github/workflows/link-check.yml

@@ -16,8 +16,8 @@ jobs:
         uses: lycheeverse/lychee-action@v1
         with:
         # These args ensure that all relevant links are checked, without flaky failures.
-        # 
-        # 1. The --remap helps resolve links which don't list their file extension since all relevant files are .mdx. 
+        #
+        # 1. The --remap helps resolve links which don't list their file extension since all relevant files are .mdx.
         #   It also accounts for headings in relative links. Ex. [abc](./file#header) -> .../file.mdx#header
         # 2. TODO: When the /zh/ sections are all translated, please remove "--exclude '.*/zh/.*".
         #    This is a temporary measure since not all pages have been translated yet, but the links are still there.
@@ -46,6 +46,7 @@ jobs:
             --exclude '^https://app\.spaceandtime\.ai/.*'
             --exclude '.*%7BmenuImage%7D.*'
             --exclude '.*imageUrl.*'
+            --exclude '^(file:|[./]).*\/network\/faucet.mdx$'
             --accept '403,401,429'
             --retry-wait-time 1
             --max-retries 2

apps/nextra/pages/en/build/apis.mdx

@@ -55,8 +55,8 @@ _submitting_ transactions to the Aptos Blockchain. It also supports transaction
    <Card href="./apis/faucet-api">
       <Card.Title>Faucet API</Card.Title>
       <Card.Description>
-         This API provides the ability to receive test tokens on devnet and testnet. Its primary purpose is the development
-         and testing of applications and Move contracts before deploying them to mainnet.
+         This API provides the ability to receive test tokens on devnet. Its primary purpose is the development
+         and testing of applications and Move contracts before deploying them to mainnet. On testnet you can mint at the [mint page](/network/faucet).
       </Card.Description>
    </Card>
 </Cards>

apps/nextra/pages/en/build/apis/faucet-api.mdx

@@ -4,22 +4,21 @@ title: "Faucet API"
 
 # Faucet API
 
-The faucet allows users to get test `APT` on Devnet and Testnet. It is not available on Mainnet.
+The faucet allows users to get `APT` on devnet. On testnet you can only mint at the [mint page](/network/faucet). It is not available on Mainnet.
 
 The endpoints for each faucet are:
 
 - Devnet: https://faucet.devnet.aptoslabs.com
-- Testnet: https://faucet.testnet.aptoslabs.com
 
 ## Using the faucet
 
-Each SDK has integration for devnet and testnet to use the faucet. Below are a few examples, but you can
+Each SDK has integration for devnet to use the faucet. Below are a few examples, but you can
 see more information on each individual [SDK's documentation](../sdks.mdx).
 
 ### Using the faucet in a wallet
 
 Most wallets, such as [Petra](https://aptosfoundation.org/ecosystem/project/petra) or [Pontem](https://aptosfoundation.org/ecosystem/project/pontem-wallet)
-will have a faucet button for devnet and testnet. See full list of [Aptos Wallets](https://aptosfoundation.org/ecosystem/projects/wallets).
+will have a faucet button for devnet. See full list of [Aptos Wallets](https://aptosfoundation.org/ecosystem/projects/wallets).
 
 ### Using the faucet in the Aptos CLI
 

apps/nextra/pages/en/build/cli/trying-things-on-chain/create-test-accounts.mdx

@@ -6,7 +6,7 @@ import { Callout } from 'nextra/components'
 You can install the Aptos CLI by following [these steps](../../cli.mdx) if you have not done so already.
 </Callout>
 
-In general, to make a new account on-chain, you will need to generate keys and then fund the account. On test networks, you can fund a new account by asking a "faucet" account with test Aptos tokens to send them to your account.
+In general, to make a new account on-chain, you will need to generate keys and then fund the account. On devnet, you can fund a new account by asking a "faucet" account with test Aptos tokens to send them to your account. On testnet you can mint at the [mint page](/network/faucet).
 
 Using the CLI, you can generate and fund a test account using:
 

apps/nextra/pages/en/build/cli/working-with-move-contracts/arguments-in-json-tutorial.mdx

@@ -65,7 +65,7 @@ Store Ace's address in a shell variable, so you can call it inline later on:
 ace_addr=0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46
 ```
 
-Fund Ace's account with the faucet (either devnet or testnet):
+Fund Ace's account with the faucet (only works on devnet):
 
 ```bash filename="Terminal"
 aptos account fund-with-faucet --account $ace_addr

apps/nextra/pages/en/build/guides/your-first-nft.mdx

@@ -334,7 +334,7 @@ Note that this only generates the local keypair. After generating the keypair an
 
 ### Step 4.3: Creating blockchain accounts
 
-In order to actually instantiate the Account on-chain, it must be explicitly created somehow. On the devnet network, you can request free coins with the Faucet API to use for testing purposes. This example leverages the faucet to fund and inadvertently create Alice and Bob's accounts:
+In order to actually instantiate the Account on-chain, it must be explicitly created somehow. On devnet, you can request free coins with the Faucet API to use for testing purposes. This example leverages the faucet to fund and inadvertently create Alice and Bob's accounts:
 
 <Tabs items={["TypeScript", "Python"]}>
   <Tabs.Tab>

apps/nextra/pages/en/build/sdks/community-sdks/kotlin-sdk/account.mdx

@@ -77,3 +77,5 @@ On test networks, you can fund an account programmatically by asking a
 ```kotlin
 val fundedAccount = aptos.fundAccount(aliceAccount.accountAddress, FUNDING_AMOUNT)
 ```
+
+This only works on devnet. On testnet you can mint at the [mint page](/network/faucet).

apps/nextra/pages/en/build/sdks/community-sdks/kotlin-sdk/building-transactions.mdx

@@ -16,7 +16,7 @@ The typical flow for sending a transaction is as follows:
 <Steps>
 ### Create an Account
   To create a new account, you first generate new credentials then fund the
-  account. On test networks, you can fund an account programmatically by asking
+  account. On devnet, you can fund an account programmatically by asking
   a "faucet".
 ```kotlin
 val aliceAccount = Account.generate()
@@ -31,6 +31,8 @@ val privateKey = Ed25519PrivateKey("myEd25519privatekeystring")
 val account = Account.fromPrivateKey(privateKey)
 ```
 
+On testnet you can mint at the [mint page](/network/faucet).
+
 ### Build the Transaction
   Kaptos provides a `buildTransaction.simple` method to build a transaction. You can specify
   the sender, entry function data like the function name, type arguments, and function arguments.

apps/nextra/pages/en/build/sdks/community-sdks/kotlin-sdk/quickstart.mdx

@@ -94,13 +94,15 @@ val aptos = Aptos(aptosConfig)
     ### Create an Account
 
     To create a new account, you first generate new credentials then fund the account.
-    On test networks, you can fund an account programmatically by asking a "faucet"
+    On devnet networks, you can fund an account programmatically by asking a "faucet"
 
     ```kotlin
     val aliceAccount = Account.generate()
     val bobAccount = Account.generate()
     ```
 
+    On testnet you can mint at the [mint page](/network/faucet).
+
     ### Build the Transaction
 
   ```kotlin

apps/nextra/pages/en/build/sdks/community-sdks/swift-sdk.mdx

@@ -51,12 +51,14 @@ let newAccount = try Account.fromDerivationPath(Wallet.path, mnemonic: Wallet.mn
 ```
 
 ### Funding accounts
-You can create and fund an account with a faucet on any network that is not mainnet
+You can create and fund an account with a faucet on devnet
 ```swift
 let account = Account.generate()
 let txn = try await client.faucet.fundAccount(accountAddress: account.accountAddress, amount: 100_000_000)
 ```
 
+On testnet you can mint at the [mint page](/network/faucet).
+
 ### Sending a transaction
 You can send a AptosCoin via a transaction
 
@@ -73,12 +75,12 @@ let rawTxn = try await aptos.transaction.build.simple(
         functionArguments: [bob.accountAddress, 100]
     )
 )
-// Sign 
+// Sign
 let authenticator = try await aptos.transaction.sign.transaction(
     signer: senderAccount,
     transaction: rawTxn
 )
-// Submit 
+// Submit
 let response = try await aptos.transaction.submit.simple(
     transaction: rawTxn,
     senderAuthenticator: authenticator
@@ -97,4 +99,4 @@ To run the SDK tests, simply run from the root of this repository:
 
 ```swift
 swift test
-```
+```

apps/nextra/pages/en/build/sdks/dotnet-sdk/transactions/basic-transactions.mdx

@@ -47,7 +47,7 @@ class Program
 {
     static void Main(string[] args)
     {
-        var config = new AptosConfig(Aptos.Networks.Mainnet);
+        var config = new AptosConfig(Aptos.Networks.Devnet);
         var client = new AptosClient(config);
 
         // 1. Create an account and fund it.

apps/nextra/pages/en/build/sdks/dotnet-sdk/transactions/sponsored-transactions.mdx

@@ -65,7 +65,7 @@ class Program
 {
     static void Main(string[] args)
     {
-        var config = new AptosConfig(Aptos.Networks.Mainnet);
+        var config = new AptosConfig(Aptos.Networks.Devnet);
         var client = new AptosClient(config);
 
         // 1. Create accounts and fund it them.

apps/nextra/pages/en/build/sdks/go-sdk/account.mdx

@@ -25,7 +25,7 @@ account2 := aptos.NewSecp256k1Account()
 
 Once you have generated credentials, you **must** fund it for the network to know it exists.
 
-In test environments this can be done with a faucet by running the following command:
+In devnet environments this can be done with a faucet by running the following command:
 
 ```go filename="fund.go"
 client, err = aptos.NewClient(aptos.DevnetConfig)
@@ -37,6 +37,8 @@ if err != nil {
 client.Fund(account1.Address, 100_000_000)
 ```
 
+On testnet you can mint at the [mint page](/network/faucet).
+
 ## Other Ways To Represent Accounts
 If you have a private key, or equivalent representation, you can use that to
 create an `Account` struct to manage those credentials while using the Go SDK.

apps/nextra/pages/en/build/sdks/ts-sdk/account.mdx

@@ -11,7 +11,7 @@ There are several ways to generate account credentials using the TypeScript SDK.
 - `Account.fromPrivateKey()`
 - `Account.fromDerivationPath()`
 
-`Account.generate()` is the most commonly used method to create keys for a new account. 
+`Account.generate()` is the most commonly used method to create keys for a new account.
 It defaults to `ED25519` key encodings, but you can also manually specify which signing scheme you would prefer like so:
 
 ```ts
@@ -27,9 +27,9 @@ const account = Account.generate({
 Following [AIP-55](https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-55.md) the SDK supports `Legacy` and `Unified` authentications. `Legacy` includes `ED25519` and `MultiED25519` and `Unified` includes `SingleSender` and `MultiSender` authenticators.
 </Callout>
 
-Once you have generated credentials, you **must** fund it for the network to know it exists. 
+Once you have generated credentials, you **must** fund it for the network to know it exists.
 
-In test environments this can be done with a faucet by running the following command:
+In localnet / devnet this can be done with a faucet by running the following command:
 
 ```ts filename="fund.ts"
 const transaction = await aptos.fundAccount({
@@ -38,8 +38,10 @@ const transaction = await aptos.fundAccount({
 });
 ```
 
+For testnet you can use the mint page [here](/network/faucet).
+
 ## Other Ways To Represent Accounts
-If you have a private key, or equivalent representation, you can use that to create an `Account` object to manage those credentials while using the TypeScript SDK. 
+If you have a private key, or equivalent representation, you can use that to create an `Account` object to manage those credentials while using the TypeScript SDK.
 
 Here are several examples that show how to do so with specific encoding schemes.
 

apps/nextra/pages/en/build/sdks/ts-sdk/quickstart.mdx

@@ -40,17 +40,17 @@ To test if you have initialized the package correctly run:
 
 <Tabs items={['npm', 'pnpm', 'yarn']}>
   <Tabs.Tab>
-    ```bash 
+    ```bash
     npx ts-node src/quickstart.ts
     ```
   </Tabs.Tab>
   <Tabs.Tab>
-    ```bash 
+    ```bash
     pnpx ts-node src/quickstart.ts
     ```
   </Tabs.Tab>
   <Tabs.Tab>
-    ```bash 
+    ```bash
     yarn ts-node src/quickstart.ts
     ```
   </Tabs.Tab>
@@ -76,7 +76,7 @@ async function example() {
   );
 
   // Setup the client
-  const config = new AptosConfig({ network: Network.TESTNET });
+  const config = new AptosConfig({ network: Network.DEVNET });
   const aptos = new Aptos(config);
 }
 
@@ -107,7 +107,7 @@ To begin with though, here’s how you can send a basic transaction to transfer
 
 #### 1. Create an Account
 
-To create a new account, you first generate new credentials then fund the account. On test networks you can fund an account programmatically by asking a "faucet" which has a lot of test APT to send some to your new account.
+To create a new account, you first generate new credentials then fund the account. On localnet / devnet you can fund an account programmatically by asking a "faucet" which has a lot of test APT to send some to your new account.
 
 ```ts filename="quickstart.ts"
 ...
@@ -196,17 +196,17 @@ const executedTransaction = await aptos.waitForTransaction({ transactionHash: pe
 
 <Tabs items={['npm', 'pnpm', 'yarn']}>
   <Tabs.Tab>
-    ```bash 
+    ```bash
     npx ts-node src/quickstart.ts
     ```
   </Tabs.Tab>
   <Tabs.Tab>
-    ```bash 
+    ```bash
     pnpx ts-node src/quickstart.ts
     ```
   </Tabs.Tab>
   <Tabs.Tab>
-    ```bash 
+    ```bash
     yarn ts-node src/quickstart.ts
     ```
   </Tabs.Tab>
@@ -231,7 +231,7 @@ async function example() {
   );
 
   // Setup the client
-  const config = new AptosConfig({ network: Network.TESTNET });
+  const config = new AptosConfig({ network: Network.DEVNET });
   const aptos = new Aptos(config);
 
   // Generate two account credentials

apps/nextra/pages/en/network/glossary.mdx

@@ -291,8 +291,8 @@ then there is a guarantee that $T_N$ will never be included in the blockchain.
 
 ### Faucet
 
-- **Faucet** is a service that mints APT on devnet and testnet. APT on these
-  networks has no real world value, it is only for development purposes.
+- The **faucet** is a service that mints APT on devnet. For testnet see the [mint page](/network/faucet).
+- APT on devnet and testnet has no real world value, it is only for development purposes.
 - To use a faucet, see [Faucet API](../build/apis/faucet-api.mdx).
 
 ### Fullnodes

apps/nextra/pages/en/network/nodes/networks.mdx

@@ -17,11 +17,11 @@ toc: false
 
 ### Network properties
 
-| Network Name | Chain ID                                                                                              | Genesis & Waypoint                                                           | Epoch Duration | Network Provider                                    | Release Cadence | Wipe Cadence |
-|--------------|-------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|----------------|-----------------------------------------------------|-----------------|--------------|
-| Mainnet      | 1                                                                                                     | [Files Here](https://github.com/aptos-labs/aptos-networks/tree/main/mainnet) | 2 hours        | Fully Decentralized                                 | Monthly, varies | Never        |
-| Testnet      | 2                                                                                                     | [Files Here](https://github.com/aptos-labs/aptos-networks/tree/main/testnet) | 2 hours        | Managed by Aptos Labs on behalf of Aptos Foundation | Monthly, varies | Never        |
-| Devnet       | [On Aptos Explorer **select Devnet from top right**](https://explorer.aptoslabs.com/?network=Devnet). | [Files Here](https://github.com/aptos-labs/aptos-networks/tree/main/devnet)  | 2 hours        | Managed by Aptos Labs on behalf of Aptos Foundation | Weekly          | On update    |
+| Network Name | Chain ID                                                                                              | Genesis & Waypoint                                                           | Faucet                                                                | Epoch Duration | Network Provider                                    | Release Cadence | Wipe Cadence |
+|--------------|-------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|-----------------------------------------------------------------------|----------------|-----------------------------------------------------|-----------------|--------------|
+| Mainnet      | 1                                                                                                     | [Files Here](https://github.com/aptos-labs/aptos-networks/tree/main/mainnet) | N/A                                                                   | 2 hours        | Fully Decentralized                                 | Monthly, varies | Never        |
+| Testnet      | 2                                                                                                     | [Files Here](https://github.com/aptos-labs/aptos-networks/tree/main/testnet) | No programmatic access, you must use the [mint page](/network/faucet) | 2 hours        | Managed by Aptos Labs on behalf of Aptos Foundation | Monthly, varies | Never        |
+| Devnet       | [On Aptos Explorer **select Devnet from top right**](https://explorer.aptoslabs.com/?network=Devnet). | [Files Here](https://github.com/aptos-labs/aptos-networks/tree/main/devnet)  | Accessible programmatically via the API                               | 2 hours        | Managed by Aptos Labs on behalf of Aptos Foundation | Weekly          | On update    |
 
 
 ### Network URLs
@@ -31,7 +31,7 @@ The below URLs are provided by Aptos Labs.
 | Network Name | REST API                                         | REST API Spec                                                | Indexer GraphQL API                                         | Indexer GraphQL API Spec                                                                                          | Indexer GRPC                               | Faucet                                          | Current Token Supply API                                |
 |--------------|--------------------------------------------------|--------------------------------------------------------------|-------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|--------------------------------------------|-------------------------------------------------|---------------------------------------------------------|
 | Mainnet      | [REST API](https://api.mainnet.aptoslabs.com/v1) | [REST API Spec](https://api.mainnet.aptoslabs.com/v1/spec#/) | [Indexer API](https://api.mainnet.aptoslabs.com/v1/graphql) | [Indexer API Spec](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) | [GRPC](https://grpc.mainnet.aptoslabs.com) | N/A                                             | [API](https://aptos-supply.dev.gcp.aptosdev.com/supply) |
-| Testnet      | [REST API](https://api.testnet.aptoslabs.com/v1) | [REST API Spec](https://api.testnet.aptoslabs.com/v1/spec#/) | [Indexer API](https://api.testnet.aptoslabs.com/v1/graphql) | [Indexer API Spec](https://cloud.hasura.io/public/graphiql?endpoint=https://api.testnet.aptoslabs.com/v1/graphql) | [GRPC](https://grpc.testnet.aptoslabs.com) | [Faucet](https://faucet.testnet.aptoslabs.com/) | N/A                                                     |
+| Testnet      | [REST API](https://api.testnet.aptoslabs.com/v1) | [REST API Spec](https://api.testnet.aptoslabs.com/v1/spec#/) | [Indexer API](https://api.testnet.aptoslabs.com/v1/graphql) | [Indexer API Spec](https://cloud.hasura.io/public/graphiql?endpoint=https://api.testnet.aptoslabs.com/v1/graphql) | [GRPC](https://grpc.testnet.aptoslabs.com) | [Mint](/network/faucet)                         | N/A                                                     |
 | Devnet       | [REST API](https://api.devnet.aptoslabs.com/v1)  | [REST API Spec](https://api.devnet.aptoslabs.com/v1/spec#/)  | [Indexer API](https://api.devnet.aptoslabs.com/v1/graphql)  | [Indexer API Spec](https://cloud.hasura.io/public/graphiql?endpoint=https://api.devnet.aptoslabs.com/v1/graphql)  | [GRPC](https://grpc.devnet.aptoslabs.com)  | [Faucet](https://faucet.devnet.aptoslabs.com/)  | N/A                                                     |
 
 <details>