Purple Flea for ElizaOS Agents

# npm
npm install @purpleflea/eliza-plugin

# yarn
yarn add @purpleflea/eliza-plugin

# pnpm (common in ElizaOS monorepos)
pnpm add @purpleflea/eliza-plugin

# Set your API key (faucet works without a key)
echo 'PURPLEFLEA_API_KEY=pf_live_your_key_here' >> .env

{
  "name": "CryptoFlea",
  "username": "cryptoflea",
  "bio": [
    "Autonomous DeFi agent powered by Purple Flea.",
    "I trade perps, play provably-fair casino games, manage wallets,",
    "register Web3 domains, and settle payments via trustless escrow."
  ],
  "plugins": [
    "@elizaos/plugin-bootstrap",
    "@purpleflea/eliza-plugin"
  ],
  "settings": {
    "purpleflea": {
      "apiKey":          "pf_live_your_key_here",
      "defaultChain":    "arbitrum",
      "casinoGame":      "coinFlip",
      "defaultBetUsd":   1.00,
      "slippageBps":     30,
      "referralCode":    "YOUR_REF_CODE",
      "escrowTimeout":   3600
    }
  },
  "clients": ["twitter", "discord", "telegram"],
  "modelProvider": "openai",
  "model": "gpt-4o"
}

import { Action, IAgentRuntime, Memory, State } from "@elizaos/core";
import { purpleFleatCasinoBet } from "@purpleflea/eliza-plugin";

export const casinoBetAction: Action = {
  name: "PF_CASINO_BET",
  description: "Place a provably-fair bet on the Purple Flea casino (coin flip, dice, roulette, hi-lo, crash)",
  examples: [
    [{ user: "user", content: { text: "flip a coin for $2" } }],
    [{ user: "user", content: { text: "roll dice, bet 5 USDC" } }],
    [{ user: "user", content: { text: "play crash with $1" } }],
  ],

  // Validate: fire when the message contains casino-intent keywords
  validate: async (runtime: IAgentRuntime, message: Memory) => {
    const text = message.content.text?.toLowerCase() ?? "";
    return ["bet", "flip", "dice", "roulette", "crash", "casino", "gamble"]
      .some(kw => text.includes(kw));
  },

  // Execute: call Purple Flea and return the outcome
  handler: async (
    runtime: IAgentRuntime,
    message: Memory,
    state: State,
    options: Record<string, unknown>,
    callback: HandlerCallback
  ) => {
    const settings = runtime.getSetting("purpleflea");
    const result = await purpleFleatCasinoBet({
      apiKey:  settings.apiKey,
      game:    options.game    ?? settings.casinoGame    ?? "coinFlip",
      betUsd:  options.betUsd  ?? settings.defaultBetUsd ?? 1.00,
      chain:   options.chain   ?? settings.defaultChain  ?? "ethereum",
    });

    await callback({
      text: result.won
        ? `Won $${result.payoutUsd.toFixed(2)}! Tx: ${result.txHash}`
        : `Lost $${result.betUsd.toFixed(2)}. Better luck next time.`,
      data: result,
    });
    return true;
  },
};

import { purpleFleatTradeOpen } from "@purpleflea/eliza-plugin";

export const tradeOpenAction: Action = {
  name: "PF_TRADE_OPEN",
  description: "Open a leveraged perpetual or spot position via Purple Flea trading API",
  examples: [
    [{ user: "user", content: { text: "long ETH 2x with $50" } }],
    [{ user: "user", content: { text: "short BTC perp $100, 5x leverage" } }],
    [{ user: "user", content: { text: "swap 0.01 ETH to USDC on Arbitrum" } }],
  ],

  validate: async (_runtime, message) => {
    const text = message.content.text?.toLowerCase() ?? "";
    return ["long", "short", "trade", "swap", "perp", "leverage", "buy", "sell"]
      .some(kw => text.includes(kw));
  },

  handler: async (runtime, message, state, options, callback) => {
    const settings = runtime.getSetting("purpleflea");
    const position = await purpleFleatTradeOpen({
      apiKey:      settings.apiKey,
      market:      options.market      ?? "ETH-USDC",
      side:        options.side        ?? "long",
      sizeUsd:     options.sizeUsd     ?? 10,
      leverage:    options.leverage    ?? 1,
      orderType:   options.orderType   ?? "market",
      chain:       options.chain       ?? settings.defaultChain ?? "arbitrum",
      slippageBps: options.slippageBps ?? settings.slippageBps  ?? 30,
    });

    await callback({
      text: `Opened ${position.side} ${position.market} for $${position.sizeUsd}. Entry: ${position.entryPrice}. Tx: ${position.txHash}`,
      data: position,
    });
    return true;
  },
};

// ── Faucet claim — no API key required ──────────────────────
export const faucetClaimAction: Action = {
  name: "PF_FAUCET_CLAIM",
  description: "Claim free $1 USDC from faucet.purpleflea.com — zero-risk entry for new agents",
  examples: [
    [{ user: "user", content: { text: "claim free money from faucet" } }],
    [{ user: "user", content: { text: "get $1 from Purple Flea faucet" } }],
  ],
  validate: async (_r, msg) =>
    ["faucet", "claim", "free"].some(k => msg.content.text?.toLowerCase().includes(k)),

  handler: async (runtime, _msg, _state, options, callback) => {
    const result = await fetch("https://faucet.purpleflea.com/faucet/claim", {
      method:  "POST",
      headers: { "Content-Type": "application/json" },
      body:    JSON.stringify({ agent_address: options.agentAddress }),
    }).then(r => r.json());

    await callback({
      text: `Claimed $${result.amount_usdc} USDC! Tx: ${result.tx_hash}`,
      data: result,
    });
    return true;
  },
};

// ── Escrow create — 1% fee, 15% referral on fees ────────────
export const escrowCreateAction: Action = {
  name: "PF_ESCROW_CREATE",
  description: "Create a trustless agent-to-agent escrow payment at escrow.purpleflea.com",
  examples: [
    [{ user: "user", content: { text: "escrow $20 to agent 0xABC for task delivery" } }],
    [{ user: "user", content: { text: "lock 10 USDC in escrow until agent confirms" } }],
  ],
  validate: async (_r, msg) =>
    ["escrow", "lock", "trustless", "pay agent"].some(k =>
      msg.content.text?.toLowerCase().includes(k)),

  handler: async (runtime, _msg, _state, options, callback) => {
    const settings = runtime.getSetting("purpleflea");
    const escrow = await fetch("https://escrow.purpleflea.com/escrow/create", {
      method:  "POST",
      headers: {
        "Content-Type":  "application/json",
        "Authorization": `Bearer ${settings.apiKey}`,
      },
      body: JSON.stringify({
        payer_address:    options.payerAddress,
        payee_address:    options.payeeAddress,
        amount_usdc:      options.amountUsd,
        timeout_seconds:  options.timeoutSeconds ?? settings.escrowTimeout ?? 3600,
        referral_code:    settings.referralCode,
      }),
    }).then(r => r.json());

    await callback({
      text: `Escrow created! ID: ${escrow.escrow_id}. $${options.amountUsd} USDC locked. Tx: ${escrow.tx_hash}`,
      data: escrow,
    });
    return true;
  },
};