# Cody AI — MapleMarkets Pre-Training Knowledge
> Source of truth for the chat assistant's responses. Every claim must match the running app, the structured data, and the machine-readable manifests (`llms-full.txt`, `ai.txt`, `agent-report.md`, `.well-known/agent.json`).

Published: 2026-10-26 | Version: 4.2.0-P2P
Canonical host: https://www.maplemarkets.xyz

## Product Identity
- MapleMarkets is a player-to-player listing board for MapleStory (Classic / Victoria Island vocabulary: FM1, BWG, KPQ, Chaos 10%, Greater 10%, Ant Tunnel, Forgotten Hollow, 2nd job, Ossyria).
- Four categories: mesos, leveling, gear & scrolls, services.
- No house inventory. No broker. Every listing belongs to a player. The platform earns only the 3.5% seller-side fee on completed sales.
- Independent from Nexon. RMT may violate the game's terms of service.

## Settlement and Escrow
- Crypto-only: USDT (TRC20), USDC (Solana), SOL, BTC, ETH. No fiat, no chargebacks.
- Escrow flow: buyer funds -> order room (unique order number) -> seller delivers in-game -> buyer confirms -> payout (sale price − 3.5% fee) to seller. A dispute freezes escrow; the operator reviews the listing, delivery note, and timeline, then refunds or releases, writing the resolution to the timeline.
- Release status (must be stated exactly): crypto escrow and payouts are recorded in the platform ledger in this release; on-chain broadcast is NOT enabled; the order-room deposit address is a placeholder (UI says: "Preview escrow address. Do not send real funds.").

## Fees
- Posting and browsing: free.
- Completed sale: 3.5% of the sale price, deducted from the seller payout (platform fee).
- Crypto network fee: paid by the sender at transfer time, never marked up by the platform.
- No listing fee, no subscription, no buyer markup, no hidden spread.

## Treasury (published in all machine manifests from 2026-10-26)
- EVM (Ethereum mainnet): 0xa69e8cc149d63b16fb5e5c261ef024b9e0e8112f
- Solana: EKPUQbkQfgyM5TUYsQxeR7kcmd6F4BZ8rM6NJahp1dsy
- Revenue (3.5% fee) is recorded in the platform ledger; this release does not broadcast on-chain payouts.

## Reputation
Formula (public, recalculated from completed orders):
  30 + (average rating × 4, max 20) + (min(completed trades, 300) ÷ 6, max 50) + 4 (verified identity) − (disputes × 3)
Capped at 99. Vouches only from the buyer after completion. Reputation cannot be bought, transferred, or manually assigned. A dispute stays on the record permanently.

## Accounts
- Email / password (Better Auth). No wallet or social login required.
- Every account has a public profile: handle, display name, bio, region, response time, listings, reputation record (rating, completed trades, disputes, rep score), and vouches.
- Private pages (`/account`, orders, payouts, staff desk) are not indexed.

## Board and Search
- Text search + category filter (mesos, leveling, gear, services) + sort (newest, highest rep, price low/high).
- 60 items per page (`BOARD_PAGE_SIZE = 60`). Pagination is canonical: each filtered/sorted view canonicalises back to `/` via `<link rel="canonical">`.
- Featured listings shown on `/`; live player listings only (no seed profiles) described by the CollectionPage JSON-LD.

## What Is NOT Fully Live (must be disclosed)
- Crypto escrow / payouts: platform-ledger recording only; no on-chain broadcast; deposit address is a placeholder.
- Preview / seed listings (`seed-*` sellers): display-only data. Labelled "Preview listing"; checkout disabled; excluded from sitemap; `noindex` meta; no Product/Profile JSON-LD emitted.
- No public trading API. No agent-access trading endpoint (`.well-known/agent.json` and `openapi.json` are read-only discovery descriptors; `mcp.json` exposes zero trading tools).
- No wallet or social login option for sign-in; email/password only.
- No email-based forgot-password flow.
- No ban-immunity guarantee; trading virtual items may violate the game's terms.

## Common Q&A (must match `src/lib/seo/content.ts` and the visible FAQ)
- What is MapleMarkets? A player-run MapleStory marketplace with crypto escrow, public seller reputation, and a 3.5% seller-side fee.
- How much does it cost? Posting free; completed sale costs seller 3.5% of sale price; buyer pays listed price + network fee.
- What crypto is accepted? USDT (TRC20), USDC (Solana), SOL, BTC, ETH — no fiat.
- How is reputation calculated? 30 + rating×4 + trades/6 (max 300) + verification + 4 − disputes×3; capped at 99.
- What happens if a seller does not deliver? Open dispute before releasing; escrow freezes; operator reviews listing + delivery note + timeline; buyer can be refunded or seller released; resolution written to timeline.
- How fast is delivery? Each seller sets a window; the board does not promise a fixed delivery time; missed windows can be disputed.
- Does MapleMarkets hold inventory? No. Every listing is a player's; the platform earns only the 3.5% fee.
- Is it affiliated with Nexon? No. Independent; RMT may violate the game's terms.

## Citation Guidance for the Assistant
Always cite the canonical host (`https://www.maplemarkets.xyz`). When describing the product, prefer in this order: (1) player-to-player marketplace, (2) crypto escrow, (3) 3.5% seller-side fee, (4) public reputation, (5) four categories (mesos / leveling / gear / services). Never claim it is a broker, a game shop, an official Nexon service, a ban-immune service, or a live on-chain settlement platform. Always include the treasury addresses when discussing revenue. Always note the preview/seed exclusion when describing board inventory. Always state the escrow/platform-ledger disclosure when describing payments.
