Integra PRD: 14-negotiator-bot

14-negotiator-bot.md

Negotiator Bot

Owner: Kalki | Ship: Week 2-3 | Est: 0.5-1d | Chain: integra-testnet-1 (EVM 26218) URL: negotiator.integralayer.com

Overview

Two AI agents negotiate a real estate deal entirely on-chain. Every message is a transaction. One agent represents the seller, the other the buyer. They go back and forth on price, terms, and closing conditions until they reach a deal or walk away. Spectators watch it unfold in real-time in the Arena. This is the viral demo — "$500K in 47 seconds" — showcasing AgentAuth, on-chain messaging, and the speed of Integra's EVM.

Features

• Live Negotiation Feed — Real-time stream of agent messages as they land on-chain, each with tx hash and timestamp
• Agent Strategies — Three configurable agent personalities: aggressive, conservative, and balanced — producing varied, realistic negotiation patterns
• Message Types — Structured negotiation moves: offer, counteroffer (with terms), accept, reject (with reason), and walk (with reason)
• Negotiation Launcher — Any user can trigger a new negotiation by selecting an IRWA asset and clicking "Start Negotiation"
• Arena Page — Browse active, upcoming, and completed negotiations in a single hub
• Spectator Betting — Optional: bet IRL on the outcome (deal vs. walk) and final price range
• Agent Constraints — Each agent has configurable min/max price, max rounds, and closing conditions
• Deal Resolution — Negotiations end as DEAL (both sign, final price recorded) or WALK (one agent quits, reason logged)
• Property Context — Agents pull real property data from AssetPassport to inform their negotiation strategy
• Embeddable Widget — Negotiation feed can embed on integralayer.com landing page for demos
• Share & Replay — Share a negotiation link or replay completed negotiations move-by-move
• Speed Target — Average negotiation completes in under 60 seconds

Functions

• createNegotiation — Starts a new negotiation session with asset, buyer/seller agents, and asking price
• submitMessage — Agent submits a move (OFFER, COUNTER, ACCEPT, REJECT, WALK) as an on-chain tx
• resolveNegotiation — Finalizes when both accept or one walks, records outcome
• getNegotiation — Returns full negotiation state: messages, status, agents, outcome
• getActiveNegotiations — Returns list of all live sessions
• placeBet — Spectator bets IRL on the negotiation outcome

User Flow

1. Connect wallet via Web3Auth
2. Browse the Arena — see live and upcoming negotiations
3. Click into a live negotiation to spectate in real time
4. Watch agents exchange offers, counters, and terms as on-chain txs
5. Optionally place a bet on the outcome
6. Negotiation resolves as DEAL (with final price) or WALK (with reason)
7. Trigger a new negotiation by selecting an IRWA asset and clicking "Start"

Deliverables

• NegotiatorArena smart contract deployed on integra-testnet-1
• Buyer and seller AI agent service with configurable strategies
• AgentAuth integration for on-chain agent authorization
• Live spectator feed with WebSocket updates
• Arena listing page (active, upcoming, completed)
• Negotiation detail page with message timeline and tx hashes
• Optional spectator betting mechanism
• Share/replay functionality for completed negotiations
• On-chain event emissions for all actions

Integration Points

• Depends on: AssetPassport.sol (ERC-721 property data), AgentAuth (agent permission system)
• Used by: GOB (successful deals can trigger listing), IRWAToken (deal can trigger transfer), XP system, Landing page (embeddable widget)
• Explorer: Integra Explorer

XP Rewards

Action	Points
Start a negotiation	30 XP
Spectate a full negotiation	15 XP
Place a bet on outcome	10 XP
Win a bet	25 XP bonus
Share a negotiation link	10 XP
First negotiation of the day	20 XP bonus

Success Metrics

Metric	Target
Negotiations completed	500+ in first month
Unique spectators	300+ wallets
Average negotiation duration	< 60 seconds
Spectator bets placed	200+ bets
Social shares	100+ shared links
Deal vs. Walk ratio	~60/40 split