# Use 3Land

The `Use 3Land` tool, part of AgentiPy, provides functionalities for interacting with the 3Land protocol on the Solana blockchain. This allows users to create and manage NFT collections and mint individual NFTs, leveraging an Agentipy proxy service for these operations.

## Functionality

This tool is implemented in the `ThreeLandManager` class. It appears to interact with a proprietary Agentipy proxy service (`agent.base_proxy_url`) which then calls the 3Land protocol. The agent's private key is encrypted and sent to this proxy.

### Key Methods:

* `create_3land_collection(agent: SolanaAgentKit, collection_symbol: str, collection_name: str, collection_description: str, main_image_url: Optional[str] = None, cover_image_url: Optional[str] = None, is_devnet: Optional[bool] = False) -> Optional[Dict[str, Any]]`:
  * Creates a new NFT collection on 3Land.
  * Parameters include `collection_symbol`, `collection_name`, `collection_description`, optional image URLs, and an `is_devnet` flag.
  * Returns a dictionary with the transaction details or an error.
* `create_3land_nft(agent: SolanaAgentKit, item_name: str, seller_fee: float, item_amount: int, item_symbol: str, item_description: str, traits: Any, price: Optional[float] = None, main_image_url: Optional[str] = None, cover_image_url: Optional[str] = None, spl_hash: Optional[str] = None, pool_name: Optional[str] = None, is_devnet: Optional[bool] = False, with_pool: Optional[bool] = False) -> Optional[Dict[str, Any]]`:
  * Mints a new NFT within the 3Land ecosystem.
  * Requires parameters like `item_name`, `seller_fee` (for royalties), `item_amount` (number to mint), `item_symbol`, `item_description`, and `traits` (metadata).
  * Optional parameters include `price`, image URLs, `spl_hash` (possibly for token-gated mints), `pool_name`, `is_devnet` flag, and `with_pool` flag.
  * Returns a dictionary with the transaction details or an error.

##

**Important Considerations:**

* **Proxy Service:** This tool relies on an Agentipy proxy service. The availability, authentication, and terms of use for this proxy are critical.
* **On-Chain Costs:** Creating NFT collections and minting NFTs are on-chain transactions that incur SOL fees.
* **API Keys:** The use of `agent.openai_api_key` in the payload to the proxy suggests it might be used for some purpose by the proxy service, even if not directly for OpenAI functionality in this specific tool.
* **Devnet/Mainnet:** Carefully manage the `is_devnet` flag to ensure operations are performed on the intended network.

## Source Code

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