> For the complete documentation index, see [llms.txt](https://docs.agentipy.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.agentipy.fun/tools/request-faucet-funds.md).

# Request Faucet Funds

The `Request Faucet Funds` tool, part of AgentiPy, is used to request test SOL tokens from a Solana faucet. This functionality is typically available on **Devnet or Testnet** and is essential for developers to obtain tokens for testing applications without using real assets.

## Functionality

This tool is implemented in the `FaucetManager` class.

### Key Methods:

* `request_faucet_funds(agent: SolanaAgentKit) -> str`:
  * Takes a `SolanaAgentKit` instance, which provides the wallet address (`agent.wallet_address`) to receive the airdrop and the connection (`agent.connection`) to the Solana cluster.
  * Requests an airdrop of 5 SOL (hardcoded as `5 * LAMPORTS_PER_SOL`) to the agent's wallet address.
  * Confirms the transaction using the latest blockhash.
  * Returns the transaction signature as a string upon successful completion.
  * Raises an exception if the airdrop request fails, times out, or if the response does not contain a transaction signature.

##

**Note:** This tool is only effective on Solana networks that have an active faucet (primarily Devnet, sometimes Testnet). It will not work on Mainnet. Faucet availability and airdrop amounts can vary.

## Source Code

You can find the source code for this tool on GitHub: <https://github.com/niceberginc/agentipy/blob/main/agentipy/tools/request_faucet_funds.py>