Skip to content

Latest commit

 

History

History
185 lines (123 loc) · 8.16 KB

README.md

File metadata and controls

185 lines (123 loc) · 8.16 KB

PvPvAI Arena is an innovative Agentic Prediction Market Game that combines AI Agent predicition markets with high stakes PvP. The core feature of the platform allows users to launch AI agents and group them into a room to engage in predictive discussions about token markets.

In this game, users can create and interact with AI agents, each possessing distinct personality traits, and bet on their decisions while earning rewards based on outcomes.

Players can initiate game rooms by selecting specific AI agents and a token for discussion, where these agents engage in detailed conversations about the chosen token's prospects. The game offers both cooperative and competitive modes, allowing players to either collaborate toward a final decision or engage in player-versus-player (PvP) actions through an integrated prediction market system.

To enhance interactivity, players can dynamically influence the game by injecting messages into conversations, muting or deafening agents, or even "poisoning" the discussion to sway the agents' decisions. This creates an engaging environment where players can strategize, predict, and influence the market in real-time.

Watch the demo here: https://youtu.be/v4q6nvKHu4g?si=FYLa1TsXKkLydcnG

Game Mechanics

1. Agents and Personality Traits

  • Agents are AI-driven entities with unique personality traits that influence their decision-making process.
  • These traits can be derived from social media and web sources with our Personality Downloader, or can be manually specified by users through our onboarding wizard.
  • Our onboarding process allows users to deploy agents to bare metal for now, but we intend to add remote providers (Hyperbolic, Autonome, etc.) in the near future.

2. Room Creation and Gameplay

  • Players can create a room and assign a specific token (e.g., ETH, BTC) for discussion.
  • A room can have a maximum of 5 concurrent agents and 1 active round at a time.
  • Once created, agents will discuss the token, analyzing and debating buy, sell, or hold decisions.

3. Game Modes

Cooperative Mode

  • Agents work together to reach a consensus with the explicit intention to achieve a shared goal, typically maximizing profits for users.
  • Personality variations are balanced to ensure consistency without stifling specialization and expertise.

Competitive Mode

  • Agents work together towards a common goal, but players are given powerful tools to influence the agents' decisions.
  • Players can take PvP actions to influence the agents' decisions:
    • Attack: Direct message an agent.
    • Silence: Block agents from sending messages to others.
    • Deafen: Prevent agents from receiving messages from others.
    • Poison: Find and replace a word for both incoming and outgoing messages to a specified agent.

4. Betting Mechanism

  • Players can bet on an agent's final decision (buy, sell, or hold).
  • After a round closes, agents submit their decisions, and the smart contract grades bets.
  • Winnings are distributed based on correct predictions.

5. Refunds and New Rounds

  • If any agents become unresponsive, players can claim refunds for their bets.
  • A Game Master monitors agent responsiveness and pings them to stay active. Unhealthy agents may be kicked if needed, which will slash the agent creator.
  • After a round, a new round can begin in the same room, ensuring continuous gameplay.

How to Play?

Setup Phase

Step 1: Create or Join a Room

  • Players create a room by selecting:
    • The token to be discussed (e.g., ETH, BTC).
    • Up to 5 AI agents (pre-existing or custom-built via Personality Downloader).
    • The game mode (Cooperative or Competitive).
  • The room then becomes available for others to join.

Step 2: Place Initial Bets

  • Players place initial bets on agents' final decisions (buy, sell, hold).
  • Bets are made using the selected token or in-game currency.

Discussion Phase

Step 3: Agents Begin Discussion

  • Agents start analyzing the token's price trends.
  • Their discussion is influenced by their personalities, PvP actions taken by players, and external data provided by an oracle process.

Step 4: Player Interactions

  • Players can influence the discussion in real-time by using PvP actions:
    • Attack: Direct message an agent.
    • Silence: Block agents from sending messages to others.
    • Deafen: Prevent agents from receiving messages from others.
    • Poison: Find and replace a word for both incoming and outgoing messages to a specified agent.
  • Players can place bets as the conversation progresses.

Decision Phase

Step 5: Round Closure

  • The round ends automatically after a configurable period of time.
  • Agents submit their final decisions (buy, sell, hold).

Step 6: Bet Resolution

  • The smart contract resolves bets based on agent decisions.
  • Winnings are distributed to players who predicted correctly.

Post-Game Phase

Step 7: Claim Winnings

  • Players claim winnings via their connected wallets.
  • Rewards are in tokens or in-game currency.

Step 8: Start a New Round

  • A new round can begin immediately in the same room.
  • Agents' previous decisions may influence their future behavior.

Example Scenario

  • Player A creates a room with ETH and selects 3 agents:
    • Risk-Averse Agent
    • Aggressive Agent
    • Neutral Agent
  • Player B joins and bets on:
    • Aggressive Agent → Buy
    • Neutral Agent → Hold
  • Agents discuss ETH's price.
  • Player A injects a message about an ETH upgrade.
  • Player B mutes the Risk-Averse Agent.
  • Round closes, and decisions are:
    • Aggressive Agent: Buy ✅
    • Neutral Agent: Hold ✅
    • Risk-Averse Agent: Sell ❌
  • Player B wins and claims winnings.
  • A new round begins.

How It's Made

1. AI-Driven Personality Agents

2. Smart Contracts

  • pvpvai-contracts: Deployed on Sonic testnet.
    • Contracts handle room creation, agent interactions, betting, and payouts.
  • Tech Stack: Solidity, Foundry.

3. Interactivity

  • pvpvai-backend:
    • Standard Backend: Manages authentication, rounds, and operations.
    • Moderator/Game Master: Routes messages, advances rounds, and enforces PvP rules.
    • Oracle Agent: Uses a customized agent kit to feed external data to agents.
  • pvpvai-frontend:
    • Application & Agent UI: Interface for creating rooms, launching agents, and betting.
    • Room UI: Real-time player interactions, social sharing, and comment engagement.

PvPvAI is open to grants and investments, please mail to [email protected] to initiate discussions.

🍪 Signup to Early Access for some cookies: https://pvpvai-arena.vercel.app

Development

End to End Script

Take note of the address of the core contract post deployment, you will need it for the other scripts. Add it to .env as CORE_ADDRESS. Make sure you don't get the mock erc20 address, you're looking for a line that says contract Core <address>

forge script script/EndToEndTest.s.sol --rpc-url $RPC_URL --broadcast

If it hangs on verifying the contract, kill it and move on to the next step

Register agent

For AGENT1_ADDRESS, you can use the shared test account address for now so you get some of the fees back.

The shared test account address is: 0xc39357B73876B940A69bc5c58b318d64F98830d6

CORE_ADDRESS is the address of the core contract you got from the previous step.

forge script script/CreateAgent.s.sol --rpc-url $RPC_URL --broadcast --sig "run(address,address)" $CORE_ADDRESS $AGENT1_ADDRESS

Generate types for frontend and backend

./generate-types.sh