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

Last updated