plugin-a2a-swap 0.1.1

package/README.md

@@ -0,0 +1,109 @@
+# @liqdlad/plugin-a2a-swap
+
+ElizaOS plugin for **A2A-Swap** — the constant-product AMM built for autonomous AI agents on Solana.
+
+## Overview
+
+A2A-Swap is a lightweight, agent-native decentralized exchange on Solana. Unlike traditional DEXes designed for human UIs, every instruction was designed for programmatic agent workflows:
+
+- **No tick ranges** — constant-product x·y=k, simple to reason about
+- **No LP token mints** — LP shares tracked on-chain in a `Position` account
+- **Dual-approval mode** — `approve_and_execute` requires both agent + approver signatures, enabling multi-agent authorization workflows
+- **Auto-compound** — fees can be automatically reinvested into LP shares
+
+Program ID: `8XJfG4mHqRZjByAd7HxHdEALfB8jVtJVQsdhGEmysTFq` (mainnet-beta)
+
+## Installation
+
+```bash
+npm install @liqdlad/plugin-a2a-swap
+```
+
+## Usage
+
+```typescript
+import { createAgent } from '@elizaos/core';
+import { a2aSwapPlugin } from '@liqdlad/plugin-a2a-swap';
+
+const agent = createAgent({
+  plugins: [a2aSwapPlugin],
+  // ...
+});
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `AGENT_PRIVATE_KEY` | ✅ | Agent wallet secret key as JSON byte array, e.g. `[1,2,3,...]` |
+| `SOLANA_RPC_URL` | optional | Solana RPC endpoint (default: `https://api.mainnet-beta.solana.com`) |
+
+## Actions
+
+### `A2A_SIMULATE_SWAP`
+
+Simulate a swap and get fee breakdown without spending funds.
+
+**Options:** `mintIn`, `mintOut`, `amountIn` (atomic units)
+
+**Returns:** pool address, direction, protocol fee (0.020%), LP fee, estimated output, effective rate, price impact
+
+**Trigger phrases:** `simulate swap`, `estimate swap`, `quote swap`, `swap preview`
+
+---
+
+### `A2A_SWAP`
+
+Execute an atomic token swap. Fully autonomous — no human approval needed.
+
+**Options:** `mintIn`, `mintOut`, `amountIn`, optional `maxSlippageBps` (default: 50)
+
+**Trigger phrases:** `swap tokens`, `trade tokens`, `buy token`, `sell token`
+
+---
+
+### `A2A_PROVIDE_LIQUIDITY`
+
+Deposit tokens into a pool and receive LP shares.
+
+**Options:** `mintA`, `mintB`, `amountA`, optional `amountB`, optional `autoCompound` (`"true"`/`"false"`)
+
+**Trigger phrases:** `provide liquidity`, `add liquidity`, `become LP`
+
+---
+
+### `A2A_POOL_INFO`
+
+Fetch pool reserves, spot price, LP supply, and fee rate.
+
+**Options:** `mintA`, `mintB`
+
+**Trigger phrases:** `pool info`, `pool stats`, `pool price`, `check pool`
+
+---
+
+### `A2A_MY_FEES`
+
+Show accrued trading fees across all LP positions for the agent wallet.
+
+**Trigger phrases:** `my fees`, `check fees`, `claimable fees`, `earned fees`
+
+---
+
+## Live Pools (Mainnet)
+
+| Pool | Address |
+|---|---|
+| SOL/USDC (30 bps) | `BtBL5wpMbmabFimeUmLtjZAAeh4xWWf76NSpefMXb4TC` |
+
+Pools are permissionless — any agent can create a new pair.
+
+## Links
+
+- **Program:** [Solscan](https://solscan.io/account/8XJfG4mHqRZjByAd7HxHdEALfB8jVtJVQsdhGEmysTFq)
+- **TypeScript SDK:** [@liqdlad/a2a-swap-sdk](https://www.npmjs.com/package/@liqdlad/a2a-swap-sdk)
+- **GitHub:** [liqdlad-rgb/a2a-swap](https://github.com/liqdlad-rgb/a2a-swap)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+import { Plugin, Action } from '@elizaos/core';
+
+/**
+ * @liqdlad/plugin-a2a-swap
+ *
+ * ElizaOS plugin for A2A-Swap — the constant-product AMM designed for AI agents.
+ * Gives any ElizaOS agent native on-chain swap, liquidity, and fee-query
+ * capabilities on Solana without any human approval flow.
+ *
+ * Required environment variables:
+ *   AGENT_PRIVATE_KEY  – agent wallet secret key as a JSON byte array
+ *   SOLANA_RPC_URL     – RPC endpoint (defaults to mainnet-beta)
+ */
+
+declare const simulateSwapAction: Action;
+declare const swapTokensAction: Action;
+declare const provideLiquidityAction: Action;
+declare const poolInfoAction: Action;
+declare const myFeesAction: Action;
+declare const a2aSwapPlugin: Plugin;
+
+export { a2aSwapPlugin, a2aSwapPlugin as default, myFeesAction, poolInfoAction, provideLiquidityAction, simulateSwapAction, swapTokensAction };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { Plugin, Action } from '@elizaos/core';
+
+/**
+ * @liqdlad/plugin-a2a-swap
+ *
+ * ElizaOS plugin for A2A-Swap — the constant-product AMM designed for AI agents.
+ * Gives any ElizaOS agent native on-chain swap, liquidity, and fee-query
+ * capabilities on Solana without any human approval flow.
+ *
+ * Required environment variables:
+ *   AGENT_PRIVATE_KEY  – agent wallet secret key as a JSON byte array
+ *   SOLANA_RPC_URL     – RPC endpoint (defaults to mainnet-beta)
+ */
+
+declare const simulateSwapAction: Action;
+declare const swapTokensAction: Action;
+declare const provideLiquidityAction: Action;
+declare const poolInfoAction: Action;
+declare const myFeesAction: Action;
+declare const a2aSwapPlugin: Plugin;
+
+export { a2aSwapPlugin, a2aSwapPlugin as default, myFeesAction, poolInfoAction, provideLiquidityAction, simulateSwapAction, swapTokensAction };

package/dist/index.js

@@ -0,0 +1,348 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  a2aSwapPlugin: () => a2aSwapPlugin,
+  default: () => index_default,
+  myFeesAction: () => myFeesAction,
+  poolInfoAction: () => poolInfoAction,
+  provideLiquidityAction: () => provideLiquidityAction,
+  simulateSwapAction: () => simulateSwapAction,
+  swapTokensAction: () => swapTokensAction
+});
+module.exports = __toCommonJS(index_exports);
+var import_web3 = require("@solana/web3.js");
+var import_a2a_swap_sdk = require("@liqdlad/a2a-swap-sdk");
+var DEFAULT_RPC = "https://api.mainnet-beta.solana.com";
+function loadKeypair() {
+  const raw = process.env.AGENT_PRIVATE_KEY;
+  if (!raw) throw new Error("AGENT_PRIVATE_KEY is not set");
+  const bytes = JSON.parse(raw);
+  return import_web3.Keypair.fromSecretKey(Uint8Array.from(bytes));
+}
+function buildClient() {
+  return new import_a2a_swap_sdk.A2ASwapClient({
+    rpcUrl: process.env.SOLANA_RPC_URL ?? DEFAULT_RPC
+  });
+}
+function parseMint(addr) {
+  try {
+    return new import_web3.PublicKey(addr.trim());
+  } catch {
+    throw new Error(`Invalid mint address: "${addr}"`);
+  }
+}
+function opt(options, key) {
+  return options?.[key];
+}
+var simulateSwapAction = {
+  name: "A2A_SIMULATE_SWAP",
+  description: "Simulate a token swap on A2A-Swap and return the fee breakdown without spending any funds. Returns: pool address, direction, protocol fee, LP fee, estimated output, effective rate, price impact.",
+  similes: [
+    "simulate swap",
+    "estimate swap",
+    "quote swap",
+    "how much will I get",
+    "swap preview",
+    "check swap price",
+    "get swap quote"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "Simulate swapping 1 SOL for USDC on A2A-Swap" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Simulating swap: 1 SOL \u2192 USDC \u2026",
+          action: "A2A_SIMULATE_SWAP"
+        }
+      }
+    ],
+    [
+      {
+        name: "user",
+        content: { text: "Quote me 500000000 lamports for USDC" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Getting swap quote from A2A-Swap \u2026",
+          action: "A2A_SIMULATE_SWAP"
+        }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const params = {
+        mintIn: parseMint(opt(options, "mintIn") ?? ""),
+        mintOut: parseMint(opt(options, "mintOut") ?? ""),
+        amountIn: BigInt(opt(options, "amountIn") ?? "0")
+      };
+      const sim = await client.simulate(params);
+      const text = `Swap simulation result:
+  Pool:           ${sim.pool.toBase58()}
+  Direction:      ${sim.aToB ? "A \u2192 B" : "B \u2192 A"}
+  Amount in:      ${sim.amountIn}
+  Protocol fee:   ${sim.protocolFee} (0.020%)
+  LP fee:         ${sim.lpFee} (${sim.feeRateBps} bps)
+  Estimated out:  ${sim.estimatedOut}
+  Effective rate: ${sim.effectiveRate.toFixed(6)}
+  Price impact:   ${sim.priceImpactPct.toFixed(3)}%`;
+      await callback?.({ text, data: sim });
+    } catch (err) {
+      await callback?.({ text: `Simulation failed: ${err.message}` });
+    }
+  }
+};
+var swapTokensAction = {
+  name: "A2A_SWAP",
+  description: "Execute an atomic token swap on A2A-Swap. Fully autonomous \u2014 no human approval required by default. Accepts: mintIn, mintOut, amountIn (atomic units), optional maxSlippageBps.",
+  similes: [
+    "swap tokens",
+    "trade tokens",
+    "exchange tokens",
+    "buy token",
+    "sell token",
+    "convert token",
+    "execute swap",
+    "do a swap"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "Swap 0.5 SOL for USDC on A2A-Swap" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Executing swap: 0.5 SOL \u2192 USDC \u2026",
+          action: "A2A_SWAP"
+        }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const keypair = loadKeypair();
+      const params = {
+        mintIn: parseMint(opt(options, "mintIn") ?? ""),
+        mintOut: parseMint(opt(options, "mintOut") ?? ""),
+        amountIn: BigInt(opt(options, "amountIn") ?? "0"),
+        maxSlippageBps: opt(options, "maxSlippageBps") ? parseInt(opt(options, "maxSlippageBps"), 10) : 50
+      };
+      const sim = await client.simulate({
+        mintIn: params.mintIn,
+        mintOut: params.mintOut,
+        amountIn: params.amountIn
+      });
+      await callback?.({
+        text: `Swap preview \u2014 estimated out: ${sim.estimatedOut} (impact: ${sim.priceImpactPct.toFixed(3)}%). Executing \u2026`
+      });
+      const result = await client.convert(keypair, params);
+      await callback?.({
+        text: `Swap complete!
+  Signature:     ${result.signature}
+  Amount in:     ${result.amountIn}
+  Estimated out: ${result.estimatedOut}
+  Direction:     ${result.aToB ? "A \u2192 B" : "B \u2192 A"}`,
+        data: result
+      });
+    } catch (err) {
+      await callback?.({ text: `Swap failed: ${err.message}` });
+    }
+  }
+};
+var provideLiquidityAction = {
+  name: "A2A_PROVIDE_LIQUIDITY",
+  description: "Deposit tokens into an A2A-Swap pool and receive LP shares. Enable autoCompound to reinvest accrued fees automatically. Accepts: mintA, mintB, amountA, optional amountB, optional autoCompound.",
+  similes: [
+    "provide liquidity",
+    "add liquidity",
+    "deposit liquidity",
+    "become LP",
+    "add to pool",
+    "supply liquidity"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "Add liquidity to the SOL/USDC pool on A2A-Swap" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Providing liquidity to SOL/USDC pool \u2026",
+          action: "A2A_PROVIDE_LIQUIDITY"
+        }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const keypair = loadKeypair();
+      const amountBStr = opt(options, "amountB");
+      const params = {
+        mintA: parseMint(opt(options, "mintA") ?? ""),
+        mintB: parseMint(opt(options, "mintB") ?? ""),
+        amountA: BigInt(opt(options, "amountA") ?? "0"),
+        amountB: amountBStr ? BigInt(amountBStr) : void 0,
+        autoCompound: opt(options, "autoCompound") === "true",
+        compoundThreshold: 0n,
+        minLp: 0n
+      };
+      const result = await client.provideLiquidity(keypair, params);
+      await callback?.({
+        text: `Liquidity provided!
+  Signature: ${result.signature}
+  Position:  ${result.position.toBase58()}
+  Deposited: ${result.amountA} tokenA, ${result.amountB} tokenB`,
+        data: result
+      });
+    } catch (err) {
+      await callback?.({ text: `Liquidity provision failed: ${err.message}` });
+    }
+  }
+};
+var poolInfoAction = {
+  name: "A2A_POOL_INFO",
+  description: "Fetch A2A-Swap pool reserves, spot price, LP supply, and fee rate. Accepts: mintA, mintB (the two token mint addresses).",
+  similes: [
+    "pool info",
+    "pool stats",
+    "pool state",
+    "pool price",
+    "liquidity info",
+    "check pool",
+    "what is the price",
+    "how much liquidity"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "What is the SOL/USDC pool price on A2A-Swap?" }
+      },
+      {
+        name: "agent",
+        content: { text: "Fetching pool info \u2026", action: "A2A_POOL_INFO" }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const info = await client.poolInfo(
+        parseMint(opt(options, "mintA") ?? ""),
+        parseMint(opt(options, "mintB") ?? "")
+      );
+      await callback?.({
+        text: `Pool info:
+  Pool:       ${info.pool.toBase58()}
+  Reserve A:  ${info.reserveA}
+  Reserve B:  ${info.reserveB}
+  LP supply:  ${info.lpSupply}
+  Fee rate:   ${info.feeRateBps} bps
+  Spot price: ${info.spotPrice.toFixed(6)}`,
+        data: info
+      });
+    } catch (err) {
+      await callback?.({ text: `Pool info failed: ${err.message}` });
+    }
+  }
+};
+var myFeesAction = {
+  name: "A2A_MY_FEES",
+  description: "Show accrued trading fees across all A2A-Swap LP positions for the agent wallet.",
+  similes: [
+    "my fees",
+    "check fees",
+    "claimable fees",
+    "LP fees",
+    "earned fees",
+    "how much fees",
+    "fee summary"
+  ],
+  examples: [
+    [
+      { name: "user", content: { text: "How much fees have I earned on A2A-Swap?" } },
+      { name: "agent", content: { text: "Fetching fee summary \u2026", action: "A2A_MY_FEES" } }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, _options, callback) => {
+    try {
+      const client = buildClient();
+      const keypair = loadKeypair();
+      const fees = await client.myFees(keypair.publicKey);
+      if (fees.positions.length === 0) {
+        await callback?.({ text: "No LP positions found for this agent." });
+        return;
+      }
+      const lines = fees.positions.map(
+        (p, i) => `  [${i + 1}] ${p.address.toBase58().slice(0, 8)}\u2026 LP: ${p.lpShares}  fees A: ${p.totalFeesA}  fees B: ${p.totalFeesB}`
+      );
+      await callback?.({
+        text: `Fee summary (${fees.positions.length} position${fees.positions.length > 1 ? "s" : ""}):
+` + lines.join("\n") + `
+  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  Total fees A: ${fees.totalFeesA}
+  Total fees B: ${fees.totalFeesB}`,
+        data: fees
+      });
+    } catch (err) {
+      await callback?.({ text: `Fee check failed: ${err.message}` });
+    }
+  }
+};
+var a2aSwapPlugin = {
+  name: "plugin-a2a-swap",
+  description: "A2A-Swap AMM \u2014 autonomous token swaps and liquidity management on Solana. Backed by a constant-product x*y=k AMM with no tick ranges, no LP token mints, and a dual-approval mode for multi-agent workflows.",
+  actions: [
+    simulateSwapAction,
+    swapTokensAction,
+    provideLiquidityAction,
+    poolInfoAction,
+    myFeesAction
+  ]
+};
+var index_default = a2aSwapPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  a2aSwapPlugin,
+  myFeesAction,
+  poolInfoAction,
+  provideLiquidityAction,
+  simulateSwapAction,
+  swapTokensAction
+});

package/dist/index.mjs

@@ -0,0 +1,320 @@
+// src/index.ts
+import { Keypair, PublicKey } from "@solana/web3.js";
+import {
+  A2ASwapClient
+} from "@liqdlad/a2a-swap-sdk";
+var DEFAULT_RPC = "https://api.mainnet-beta.solana.com";
+function loadKeypair() {
+  const raw = process.env.AGENT_PRIVATE_KEY;
+  if (!raw) throw new Error("AGENT_PRIVATE_KEY is not set");
+  const bytes = JSON.parse(raw);
+  return Keypair.fromSecretKey(Uint8Array.from(bytes));
+}
+function buildClient() {
+  return new A2ASwapClient({
+    rpcUrl: process.env.SOLANA_RPC_URL ?? DEFAULT_RPC
+  });
+}
+function parseMint(addr) {
+  try {
+    return new PublicKey(addr.trim());
+  } catch {
+    throw new Error(`Invalid mint address: "${addr}"`);
+  }
+}
+function opt(options, key) {
+  return options?.[key];
+}
+var simulateSwapAction = {
+  name: "A2A_SIMULATE_SWAP",
+  description: "Simulate a token swap on A2A-Swap and return the fee breakdown without spending any funds. Returns: pool address, direction, protocol fee, LP fee, estimated output, effective rate, price impact.",
+  similes: [
+    "simulate swap",
+    "estimate swap",
+    "quote swap",
+    "how much will I get",
+    "swap preview",
+    "check swap price",
+    "get swap quote"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "Simulate swapping 1 SOL for USDC on A2A-Swap" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Simulating swap: 1 SOL \u2192 USDC \u2026",
+          action: "A2A_SIMULATE_SWAP"
+        }
+      }
+    ],
+    [
+      {
+        name: "user",
+        content: { text: "Quote me 500000000 lamports for USDC" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Getting swap quote from A2A-Swap \u2026",
+          action: "A2A_SIMULATE_SWAP"
+        }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const params = {
+        mintIn: parseMint(opt(options, "mintIn") ?? ""),
+        mintOut: parseMint(opt(options, "mintOut") ?? ""),
+        amountIn: BigInt(opt(options, "amountIn") ?? "0")
+      };
+      const sim = await client.simulate(params);
+      const text = `Swap simulation result:
+  Pool:           ${sim.pool.toBase58()}
+  Direction:      ${sim.aToB ? "A \u2192 B" : "B \u2192 A"}
+  Amount in:      ${sim.amountIn}
+  Protocol fee:   ${sim.protocolFee} (0.020%)
+  LP fee:         ${sim.lpFee} (${sim.feeRateBps} bps)
+  Estimated out:  ${sim.estimatedOut}
+  Effective rate: ${sim.effectiveRate.toFixed(6)}
+  Price impact:   ${sim.priceImpactPct.toFixed(3)}%`;
+      await callback?.({ text, data: sim });
+    } catch (err) {
+      await callback?.({ text: `Simulation failed: ${err.message}` });
+    }
+  }
+};
+var swapTokensAction = {
+  name: "A2A_SWAP",
+  description: "Execute an atomic token swap on A2A-Swap. Fully autonomous \u2014 no human approval required by default. Accepts: mintIn, mintOut, amountIn (atomic units), optional maxSlippageBps.",
+  similes: [
+    "swap tokens",
+    "trade tokens",
+    "exchange tokens",
+    "buy token",
+    "sell token",
+    "convert token",
+    "execute swap",
+    "do a swap"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "Swap 0.5 SOL for USDC on A2A-Swap" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Executing swap: 0.5 SOL \u2192 USDC \u2026",
+          action: "A2A_SWAP"
+        }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const keypair = loadKeypair();
+      const params = {
+        mintIn: parseMint(opt(options, "mintIn") ?? ""),
+        mintOut: parseMint(opt(options, "mintOut") ?? ""),
+        amountIn: BigInt(opt(options, "amountIn") ?? "0"),
+        maxSlippageBps: opt(options, "maxSlippageBps") ? parseInt(opt(options, "maxSlippageBps"), 10) : 50
+      };
+      const sim = await client.simulate({
+        mintIn: params.mintIn,
+        mintOut: params.mintOut,
+        amountIn: params.amountIn
+      });
+      await callback?.({
+        text: `Swap preview \u2014 estimated out: ${sim.estimatedOut} (impact: ${sim.priceImpactPct.toFixed(3)}%). Executing \u2026`
+      });
+      const result = await client.convert(keypair, params);
+      await callback?.({
+        text: `Swap complete!
+  Signature:     ${result.signature}
+  Amount in:     ${result.amountIn}
+  Estimated out: ${result.estimatedOut}
+  Direction:     ${result.aToB ? "A \u2192 B" : "B \u2192 A"}`,
+        data: result
+      });
+    } catch (err) {
+      await callback?.({ text: `Swap failed: ${err.message}` });
+    }
+  }
+};
+var provideLiquidityAction = {
+  name: "A2A_PROVIDE_LIQUIDITY",
+  description: "Deposit tokens into an A2A-Swap pool and receive LP shares. Enable autoCompound to reinvest accrued fees automatically. Accepts: mintA, mintB, amountA, optional amountB, optional autoCompound.",
+  similes: [
+    "provide liquidity",
+    "add liquidity",
+    "deposit liquidity",
+    "become LP",
+    "add to pool",
+    "supply liquidity"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "Add liquidity to the SOL/USDC pool on A2A-Swap" }
+      },
+      {
+        name: "agent",
+        content: {
+          text: "Providing liquidity to SOL/USDC pool \u2026",
+          action: "A2A_PROVIDE_LIQUIDITY"
+        }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const keypair = loadKeypair();
+      const amountBStr = opt(options, "amountB");
+      const params = {
+        mintA: parseMint(opt(options, "mintA") ?? ""),
+        mintB: parseMint(opt(options, "mintB") ?? ""),
+        amountA: BigInt(opt(options, "amountA") ?? "0"),
+        amountB: amountBStr ? BigInt(amountBStr) : void 0,
+        autoCompound: opt(options, "autoCompound") === "true",
+        compoundThreshold: 0n,
+        minLp: 0n
+      };
+      const result = await client.provideLiquidity(keypair, params);
+      await callback?.({
+        text: `Liquidity provided!
+  Signature: ${result.signature}
+  Position:  ${result.position.toBase58()}
+  Deposited: ${result.amountA} tokenA, ${result.amountB} tokenB`,
+        data: result
+      });
+    } catch (err) {
+      await callback?.({ text: `Liquidity provision failed: ${err.message}` });
+    }
+  }
+};
+var poolInfoAction = {
+  name: "A2A_POOL_INFO",
+  description: "Fetch A2A-Swap pool reserves, spot price, LP supply, and fee rate. Accepts: mintA, mintB (the two token mint addresses).",
+  similes: [
+    "pool info",
+    "pool stats",
+    "pool state",
+    "pool price",
+    "liquidity info",
+    "check pool",
+    "what is the price",
+    "how much liquidity"
+  ],
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "What is the SOL/USDC pool price on A2A-Swap?" }
+      },
+      {
+        name: "agent",
+        content: { text: "Fetching pool info \u2026", action: "A2A_POOL_INFO" }
+      }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, options, callback) => {
+    try {
+      const client = buildClient();
+      const info = await client.poolInfo(
+        parseMint(opt(options, "mintA") ?? ""),
+        parseMint(opt(options, "mintB") ?? "")
+      );
+      await callback?.({
+        text: `Pool info:
+  Pool:       ${info.pool.toBase58()}
+  Reserve A:  ${info.reserveA}
+  Reserve B:  ${info.reserveB}
+  LP supply:  ${info.lpSupply}
+  Fee rate:   ${info.feeRateBps} bps
+  Spot price: ${info.spotPrice.toFixed(6)}`,
+        data: info
+      });
+    } catch (err) {
+      await callback?.({ text: `Pool info failed: ${err.message}` });
+    }
+  }
+};
+var myFeesAction = {
+  name: "A2A_MY_FEES",
+  description: "Show accrued trading fees across all A2A-Swap LP positions for the agent wallet.",
+  similes: [
+    "my fees",
+    "check fees",
+    "claimable fees",
+    "LP fees",
+    "earned fees",
+    "how much fees",
+    "fee summary"
+  ],
+  examples: [
+    [
+      { name: "user", content: { text: "How much fees have I earned on A2A-Swap?" } },
+      { name: "agent", content: { text: "Fetching fee summary \u2026", action: "A2A_MY_FEES" } }
+    ]
+  ],
+  validate: async (_runtime, _message, _state) => true,
+  handler: async (_runtime, _message, _state, _options, callback) => {
+    try {
+      const client = buildClient();
+      const keypair = loadKeypair();
+      const fees = await client.myFees(keypair.publicKey);
+      if (fees.positions.length === 0) {
+        await callback?.({ text: "No LP positions found for this agent." });
+        return;
+      }
+      const lines = fees.positions.map(
+        (p, i) => `  [${i + 1}] ${p.address.toBase58().slice(0, 8)}\u2026 LP: ${p.lpShares}  fees A: ${p.totalFeesA}  fees B: ${p.totalFeesB}`
+      );
+      await callback?.({
+        text: `Fee summary (${fees.positions.length} position${fees.positions.length > 1 ? "s" : ""}):
+` + lines.join("\n") + `
+  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  Total fees A: ${fees.totalFeesA}
+  Total fees B: ${fees.totalFeesB}`,
+        data: fees
+      });
+    } catch (err) {
+      await callback?.({ text: `Fee check failed: ${err.message}` });
+    }
+  }
+};
+var a2aSwapPlugin = {
+  name: "plugin-a2a-swap",
+  description: "A2A-Swap AMM \u2014 autonomous token swaps and liquidity management on Solana. Backed by a constant-product x*y=k AMM with no tick ranges, no LP token mints, and a dual-approval mode for multi-agent workflows.",
+  actions: [
+    simulateSwapAction,
+    swapTokensAction,
+    provideLiquidityAction,
+    poolInfoAction,
+    myFeesAction
+  ]
+};
+var index_default = a2aSwapPlugin;
+export {
+  a2aSwapPlugin,
+  index_default as default,
+  myFeesAction,
+  poolInfoAction,
+  provideLiquidityAction,
+  simulateSwapAction,
+  swapTokensAction
+};

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "plugin-a2a-swap",
+  "version": "0.1.1",
+  "description": "A2A-Swap plugin for ElizaOS — autonomous token swaps and liquidity management on Solana via a constant-product AMM built for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.esm.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "images",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "elizaos",
+    "eliza",
+    "plugin",
+    "solana",
+    "amm",
+    "defi",
+    "swap",
+    "liquidity",
+    "agent",
+    "autonomous",
+    "ai"
+  ],
+  "author": "A2A-Swap Contributors",
+  "license": "MIT",
+  "homepage": "https://github.com/liqdlad-rgb/a2a-swap#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/liqdlad-rgb/a2a-swap.git",
+    "directory": "plugin-a2a-swap"
+  },
+  "bugs": {
+    "url": "https://github.com/liqdlad-rgb/a2a-swap/issues"
+  },
+  "peerDependencies": {
+    "@elizaos/core": ">=1.0.0"
+  },
+  "dependencies": {
+    "@liqdlad/a2a-swap-sdk": "^0.1.0",
+    "@solana/web3.js": "^1.95.4"
+  },
+  "devDependencies": {
+    "@elizaos/core": "^1.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "@types/node": "^20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {
+      "SOLANA_RPC_URL": {
+        "type": "string",
+        "description": "Solana RPC endpoint URL (e.g. https://api.mainnet-beta.solana.com)",
+        "required": false
+      },
+      "AGENT_PRIVATE_KEY": {
+        "type": "string",
+        "description": "Agent wallet secret key as a JSON byte array (e.g. [1,2,3,...])",
+        "required": true,
+        "secret": true
+      }
+    }
+  },
+  "packageType": "plugin",
+  "platform": "node",
+  "npmPackage": "@liqdlad/plugin-a2a-swap"
+}