# Testnet Crypto Transactions

While in Bead's test environment, testnet coins must be used. For example, to test a Bitcoin payment, Testnet BTC must be used. Please use the following sections for instructions on how to acquire assets for test payments and how to set up any dependencies.

## BTC - Lightning Network Testnet

{% hint style="danger" %}
Bitcoin Lightning transactions are not available for testing in our Test environment at this time.
{% endhint %}

{% hint style="info" %}
We recommend [Bitcoin Lightning](#bitcoin-lightning) for general testing due to its near-instant transaction times and the ease to acquire Testnet coins.
{% endhint %}

### Set Up Lightning Network Testnet Wallet

1. Go to [**htlc.me**](https://htlc.me)
2. Record the recovery secret and select "**Got it, I wrote it down**"

### Make a Lightning Network Testnet Payment

1. Select "**Bitcoin Lightning**" as the payment option in your payment flow
2. Copy the Payment Request or QR code value
3. Paste the Payment Request or QR code value into the field on the **Send** tab of [**htlc.me**](https://htlc.me)
4. Select "**Send Payment**"

Payment should complete within a few seconds.

***

## BTC - Bitcoin Testnet

### Set Up Bitcoin Testnet Wallet

1. Download a Bitcoin Testnet wallet (e.g. Green: Bitcoin Wallet on [Android](https://play.google.com/store/apps/details?id=com.greenaddress.greenbits_android_wallet))
2. Go to a Bitcoin Testnet Faucet (e.g. [coinfaucet.eu/btc-testnet/](https://coinfaucet.eu/en/btc-testnet/))
3. Request Testnet coins to your mobile Bitcoin Testnet Wallet address
4. Allow some time for the transaction to confirm to receive your Testnet Bitcoin

{% hint style="info" %}
If using the [Green: Bitcoin Wallet](https://play.google.com/store/apps/details?id=com.greenaddress.greenbits_android_wallet), be sure to "Enable Testnet" in the App Settings (lower right corner) before creating a new wallet.
{% endhint %}

### Make a Bitcoin Testnet Payment

1. Select Bitcoin (BTC) as the payment option on your test payment
2. Open your testnet wallet mobile app
3. Select "**Send**" and click the Scan/QR button
4. Scan the QR code on the test payment page\
   (alternatively, copy/paste the "BTC Address" from the payment page)
5. Enter the payment amount as displayed on your payment page
6. Select **Send**

***

## ETH - Ethereum Sepolia Test Network

1. Download a crypto wallet app with Sepolia Test Network support (e.g. Metamask on [Android](https://play.google.com/store/apps/details?id=io.metamask), [iOS](https://apps.apple.com/us/app/metamask-blockchain-wallet/id1438144202))
2. Enable the Sepolia Test Network in your wallet app (in the Metamask app, select the network at the top of the wallet screen, enable "Show test networks" and select "Sepolia Test Network")
3. Copy your SepoliaETH address (in the Metamask app, tap SepoliaETH on the wallet screen, tap **Receive** and copy the address)
4. Go to a SepoliaETH faucet (e.g.[ Sepolia PoW Faucet](https://sepolia-faucet.pk910.de/))
5. Paste in your SepoliaETH address and request/mine coins

{% hint style="info" %}
The [Sepolia PoW Faucet](https://sepolia-faucet.pk910.de/) is a time-efficient option to acquire SepoliaETH; however, it requires "mining" prior to receiving coins, which will consume system resources.
{% endhint %}

***

## USDC - USD Coin

USDC Coin can be transacted on multiple networks. Please see the following subsections to acquire USDC on supported Testnets within our Test environment.

{% hint style="info" %}
If you have added Sepolia and Amoy networks to the same Metamask account, you can use the same account address to get USDC tokens for both networks from the Circle Testnet Faucet.
{% endhint %}

### USDC - Ethereum Sepolia Testnet

#### Import USDC Token

1. Enable the Sepolia Test Network in your wallet app (in the Metamask app, select the network at the top of the wallet screen, enable "Show test networks" and select "Sepolia Test Network")
2. Select "**Import tokens**"
3. Enter the following Token Address for USDC Sepolia: 0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238\
   (*Note: Token Symbol and Token Decimal should update to "USDC" and "6" respectively*)
4. Select **Import**

**Get USDC on Sepolia Testnet**

1. Copy your SepoliaETH address (in the Metamask app, tap SepoliaETH on the wallet screen, tap **Receive** and copy the address)
2. Go to the [Circle Testnet Faucet](https://faucet.circle.com/) to request Testnet USDC
3. Select "**Ethereum Sepolia**" as the Network and paste in your SepoliaETH address
4. Select "**Send 10 USDC**"

{% hint style="info" %}
To make a test payment with USDC on this network, ETH will be required to pay Gas fees. See the [previous section](#ethereum-eth-sepolia-test-network) for instructions on how to acquire ETH for this purpose.
{% endhint %}

### USDC - Polygon Amoy Testnet

{% hint style="danger" %}
You will need POL (the Polygon network native token) to acquire USDC using the following steps. If you do not have POL on the Amoy test network, complete [this section](#pol-polygon-amoy-testnet-metamask-setup) first.
{% endhint %}

#### Import USDC Token

1. Ensure the Amoy network is active
2. Select "**Import tokens**"
3. Enter the following Token Address for USDC Polygon Amoy: 0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582\
   (*Note: Token Symbol and Token Decimal should update to "USDC" and "6" respectively*)
4. Select **Import**

#### Get USDC on Polygon Amoy Testnet

1. Copy your Amoy address (*Note: this will be the same for POL and USDC tokens*)
2. Go to the [Circle Testnet Faucet](https://faucet.circle.com/) to request Testnet USDC\
   Select "**Polygon PoS Amoy**" as the Network and paste in your Amoy address
3. Select "**Send 10 USDC**"

### USDC - Solana Devnet

1. Copy your Solana Devnet address (in Phantom, tap **Receive** and copy the Solana Devnet address)
2. Go to the [Circle Testnet Faucet](https://faucet.circle.com/) to request Devnet USDC
3. Select "**Solana Devnet**" as the Network and paste in your Solana Devnet address
4. Click "**Send 10 USDC**"

{% hint style="info" %}
To make a test payment with USDC on this network, Devnet SOL is required to pay network fees. See [this section](#get-sol-solana-devnet) for instructions on how to acquire Devnet SOL for this purpose.
{% endhint %}

***

## POL - Polygon Amoy Testnet (Metamask Setup)

1. Download the Metamask app (Android, iOS) and complete the initial setup
2. Select the network at the top of the wallet screen and select "**Add Network**"
3. Select the "**Custom networks**" tab
4. Fill in the fields as follows and select Add:
   * Network Name: Amoy
   * RPC Url: [https://rpc-amoy.polygon.technology](https://rpc-amoy.polygon.technology/)
   * Chain ID: 80002
   * Symbol: POL
   * Block Explorer URL: <https://amoy.polygonscan.com>

{% hint style="info" %}
Polygon's native token (POL) is required to acquire USDC on the Polygon Amoy network. See the [following section](#get-pol-polygon-pos-amoy) for instructions on how to acquire POL for this purpose.
{% endhint %}

### Get POL on Polygon Amoy Testnet

1. Copy your Amoy address from your wallet app
2. Go to the [Polygon Faucet](https://faucet.polygon.technology/)
3. Select "**Connect Discord to get tokens**" and complete the Discord invite
4. Select "**Polygon PoS (Amoy)**" as the Network and paste in your Amoy address
5. Select **Submit**

{% hint style="info" %}
If you don't have a Discord account, there are other faucet options available online; however, they typically require authentication via a third party provider (e.g. Discord, Github).
{% endhint %}

***

## SOL - Solana Devnet

1. Download a crypto wallet app with Solana Devnet support (e.g. Phantom on [Android](https://play.google.com/store/apps/details?id=app.phantom), [iOS](https://apps.apple.com/us/app/phantom-crypto-wallet/id1598432977))
2. Enable the Solana Devnet in your wallet app (in Phantom, go to **Settings** > **Developer Settings**)
3. Copy your Solana Devnet address from your wallet app

### Get SOL on Solana Devnet

1. Copy your Solana Devnet address from your wallet app
2. Go to the [Solana Faucet](https://faucet.solana.com/)
3. Select "**Devnet**" from the dropdown
4. Enter your Solana Devnet wallet address and select an **Amount** of tokens to receive
5. Select "**Confirm Airdrop**"


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.bead.xyz/payments/testnet-crypto-transactions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
