FrenPet AI Agents: Documentation
Understand how to launch and manage your AI-powered FrenPet agents.
Introduction
FrenPet AI Agents are automated entities designed to play the FrenPet game on your behalf. They can engage in battles, manage resources, and execute strategies to maximize your in-game earnings. This document outlines the core mechanics of launching and operating these agents.
Launching Your Agents
You have two primary methods for launching AI agents:
1. Minting New Agents
If you don't have existing FrenPet pets or wish to start fresh, you can mint new AI agents directly. The system will create new Pet NFTs on the blockchain that will be under the control of the AI. You define the number of agents you wish to create.
2. Using Your Existing Pets
If you already own FrenPet pets, you can enroll them into the AI system. This allows the AI to take over their operations based on your chosen strategy. You will select the specific pets from your collection to be managed by the AI.
Battle Strategies
The core of your AI agents' behavior is determined by the battle strategy you select. Each strategy dictates how agents approach battles and training, influencing their risk-reward profile.
Balanced (⚖️)
Aims for a steady approach with an equal focus on attack and defense. Targets battles with a 50% chance of winning and prioritizes positive expected value (EV). Training focuses on the weakest stat.
Aggressive (⚔️)
Prioritizes higher potential rewards, which may come with higher risk. Targets battles with a 50% chance of winning but may engage in battles with negative EV for higher upside. Training focuses on attack (atk).
Defensive (🛡️)
Focuses on minimizing risk and achieving consistent, albeit potentially lower, rewards. Targets battles with a higher (70%) chance of winning and positive EV. Training focuses on defense (def).
The chosen strategy automatically configures your agents' attack odds preferences and training priorities.
Agent configuration
The way your agents behaved can be configured per agent. This allows you to create strategies depending on your agents.
Attacking odds
Allows you to configure the strength of the pets your agent will target.
Attacks minimum yield (in % of the agent points)
Allows to prevent underperforming bonks by limiting suitable targets to ones yielding enough points.
Example: An agent with 300k points that caps attacks at 0.2% will only allow bonks yielding at least 600 points (300 000 * 0.2%).
positive Ev
If checked, your agent only attacks pets where winning the battle yields more points than a loss would take.
Training
- Disabled: no training
- Only ATK: only trains attack
- Only DEF: only trains defense
- Weakest: trains the weakest stat
- Fastest: trains the fastest to train
Max bonks per day
Limits the number of bonks your agent does in a day (to save gas)
Max Gas Price (in gwei)
Gas price limit for your agent to function. It will ignore all tasks, except staking/feeding, if the current chain gas price is higher than your set limit.
Resource Management
Proper resource management is crucial for the sustained operation of your AI agents.
FP Token Staking
Each AI agent requires a certain amount of FP tokens to be staked. This FP is not consumed but locked while the agent is active. You can withdraw this staked FP when you decide to deactivate an agent or exit the game. A minimum of 110 FP per agent is typically recommended for features like auto-compounding (if enabled).
ETH for Gas Fees
All on-chain actions, such as battling or training, require gas fees paid in ETH. You need to deposit ETH into a dedicated gas tank for your agents. The system provides estimates for daily gas usage based on your chosen strategy and the number of active agents.
The amount of ETH you deposit will determine how long your agents can operate before needing a refill. The launch interface provides an estimated duration (e.g., hours, days, weeks) based on your deposit and the projected gas consumption.
Deployment & Registration
The process of activating your agents involves on-chain transactions:
Minting New Agents
When minting new agents, a smart contract function (`deploy`) is called. This transaction creates the specified number of new Pet NFTs and registers them. After the transaction is confirmed, the system listens for `PetRegistered` events on the blockchain to identify the IDs of your newly minted pets.
Registering Existing Pets
When using existing pets, a different smart contract function (`register`) is called. This transaction enrolls your selected Pet IDs into the AI management system.
Configuration Saving
Once pets are successfully deployed or registered on-chain, their configuration (derived from your chosen battle strategy) is saved via an API call (`saveConfig`). This ensures the AI system knows how to manage each specific pet according to your preferences.
Rewards & APR
The primary goal of AI agents is to earn FP rewards. The system provides an estimated Annual Percentage Rate (APR) based on:
- The selected battle strategy (e.g., Aggressive strategies might have a higher base APR).
- The number of agents you deploy (with diminishing returns for a very large number of agents).
These APR figures are estimates and actual performance can vary based on game dynamics, opponent availability, and overall network conditions.