> 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/use-lulo.md).

# Use Lulo

The `Use Lulo` tool, part of AgentiPy, allows users to interact with the Lulo Finance lending and borrowing protocol on Solana. It provides methods to lend assets (specifically USDC in one method, and any SPL token in another) to earn yield, and to withdraw previously lent assets. This tool interacts directly with the Lulo API (which seems to be also referred to as Flexlend).

## Functionality

This tool is implemented in the `LuloManager` class.

### Key Methods:

* `lend_asset(agent: SolanaAgentKit, amount: float) -> str`:
  * Lends a specified `amount` of USDC to Lulo. This method seems to use a Lulo Blink (Solana Action) URL: `https://blink.lulo.fi/actions`.
  * It constructs a payload with the agent's wallet address and makes a POST request.
  * The response contains a serialized transaction which is then signed by the agent's wallet and sent to the Solana network.
  * Returns the transaction signature.
* `lulo_lend(agent: SolanaAgentKit, mint_address: Pubkey, amount: float) -> str`:
  * Lends a specified `amount` of an SPL token (identified by `mint_address`) to Lulo.
  * This method uses the Flexlend API endpoint (`https://api.flexlend.fi/api/v1/deposit`) and requires a Flexlend API key (`agent.FLEXLEND_API_KEY` or `agent.flexland_api_key` - note the typo in the script for the latter).
  * The payload includes the owner's address, mint address, and deposit amount.
  * Similar to `lend_asset`, it processes the transaction returned by the API.
  * Returns the transaction signature.
* `lulo_withdraw(agent: SolanaAgentKit, mint_address: Pubkey, amount: float) -> str`:
  * Withdraws a specified `amount` of a previously lent SPL token (identified by `mint_address`) from Lulo.
  * Uses the Flexlend API endpoint (`https://api.flexlend.fi/api/v1/withdraw`) and requires a Flexlend API key.
  * Parameters and transaction handling are similar to `lulo_lend`.
  * Returns the transaction signature.

##

**Important Considerations:**

* **Direct API Interaction & On-Chain:** This tool interacts directly with Lulo/Flexlend APIs to get transaction details, which are then signed by the agent's wallet and submitted to the Solana blockchain. These are on-chain financial transactions.
* **API Key:** The `lulo_lend` and `lulo_withdraw` methods require a Flexlend API key (`agent.FLEXLEND_API_KEY` or `agent.flexland_api_key`). The `lend_asset` method for USDC might use a more open "blink" endpoint that may not require a user-specific API key.
* **Financial Risks:** Lending assets to DeFi protocols involves risks, including smart contract vulnerabilities and impermanent loss (if the protocol also involves liquidity provision aspects).
* **Token Support:** While `lend_asset` is specific to USDC, `lulo_lend` and `lulo_withdraw` can be used for other SPL tokens supported by Lulo/Flexlend.

## Source Code

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