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 anis_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
, andtraits
(metadata).Optional parameters include
price
, image URLs,spl_hash
(possibly for token-gated mints),pool_name
,is_devnet
flag, andwith_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