@vault77/summon 2.0.1

package/lib/swapClient.js

@@ -0,0 +1,84 @@
+import { SolanaTracker } from "solana-swap";
+import { loadConfig } from "./config.js";
+import { getPrivateKey } from "../utils/keychain.js";
+import { logger } from "../utils/logger.js";
+import { ConfigError, SwapError } from "./errors.js";
+import { notify } from "../utils/notify.js";
+
+const SWAP_DISCOUNT_CODE = "jduck-d815-4c28-b85d-17e9fc3a21a8";
+
+let clientPromise = null;
+let clientFactory = defaultFactory;
+
+export function ensureAdvancedTx(rpcUrl) {
+  if (!rpcUrl || typeof rpcUrl !== "string") {
+    throw new ConfigError("RPC URL is missing or invalid.");
+  }
+  if (rpcUrl.includes("advancedTx")) {
+    return rpcUrl;
+  }
+  const separator = rpcUrl.includes("?") ? "&" : "?";
+  return `${rpcUrl}${separator}advancedTx=true`;
+}
+
+export function setSwapClientFactory(factory) {
+  clientFactory = factory;
+  clientPromise = null;
+}
+
+export async function getSwapClient() {
+  if (!clientPromise) {
+    clientPromise = clientFactory().catch((err) => {
+      clientPromise = null;
+      throw err;
+    });
+  }
+  return clientPromise;
+}
+
+async function defaultFactory() {
+  const cfg = await loadConfig();
+  let raw;
+  try {
+    raw = await getPrivateKey();
+  } catch (err) {
+    if (cfg.notificationsEnabled !== false) {
+      notify({
+        title: "🔑 Keychain Missing",
+        subtitle: "No private key found",
+        message: "Run `summon keychain store` to add your wallet.",
+        sound: "Ping",
+      });
+    }
+    throw err;
+  }
+
+  // Lazy-load heavy deps only when needed
+  const [{ default: bs58 }, { Keypair }] = await Promise.all([
+    import("bs58"),
+    import("@solana/web3.js"),
+  ]);
+
+  let secretBytes;
+  if (raw.trim().startsWith("[")) {
+    secretBytes = Uint8Array.from(JSON.parse(raw));
+  } else {
+    secretBytes = bs58.decode(raw.trim());
+  }
+  const keypair = Keypair.fromSecretKey(secretBytes);
+
+  const rpcUrl = ensureAdvancedTx(cfg.rpcUrl);
+  const apiKey = SWAP_DISCOUNT_CODE;
+  const debugEnabled = Boolean(cfg.DEBUG_MODE || process.env.NODE_ENV === "development");
+
+  try {
+    const tracker = new SolanaTracker(keypair, rpcUrl, apiKey, debugEnabled);
+    if (debugEnabled && typeof tracker.setDebug === "function") {
+      tracker.setDebug(true);
+    }
+    return tracker;
+  } catch (err) {
+    logger.error("Failed to initialize swap client.", { error: err?.message });
+    throw new SwapError("Unable to initialize swap client.", { cause: err });
+  }
+}

package/lib/tradeFormat.js

@@ -0,0 +1,4 @@
+export function formatPercent(value, { fallback = "N/A" } = {}) {
+  const num = Number(value);
+  return Number.isFinite(num) ? num.toFixed(2) : fallback;
+}

package/lib/trades.js

@@ -0,0 +1,222 @@
+import { notify } from "../utils/notify.js";
+import { loadConfig } from "./config.js";
+import { SwapError } from "./errors.js";
+import { getSwapClient } from "./swapClient.js";
+
+// Wrapped SOL mint address on Solana
+const WRAPPED_SOL_MINT = "So11111111111111111111111111111111111111112";
+const VERIFY_ATTEMPTS = 20;
+const VERIFY_DELAY_MS = 1000;
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+async function verifySwap(tracker, txid) {
+  for (let attempt = 0; attempt < VERIFY_ATTEMPTS; attempt += 1) {
+    const details = await tracker.getTransactionDetails(txid);
+    if (details) {
+      if (details.meta?.err) {
+        const errText = typeof details.meta.err === "string"
+          ? details.meta.err
+          : JSON.stringify(details.meta.err);
+        throw new Error(`Transaction failed: ${errText}`);
+      }
+      return true;
+    }
+    await sleep(VERIFY_DELAY_MS);
+  }
+  return false;
+}
+
+/**
+ * Buy tokens: spend a specific amount of SOL to acquire <mint>.
+ * @param {string} mint       SPL token mint address
+ * @param {number|string} amountSol  Amount in SOL to spend, or "auto"/"<percent>%"
+ * @returns Promise resolving with txid, tokens received, and quote/rate details
+ */
+export async function buyToken(mint, amountSol) {
+  const cfg = await loadConfig();
+  const tracker = await getSwapClient();
+  const debugEnabled = Boolean(cfg.DEBUG_MODE || process.env.NODE_ENV === "development");
+  const notificationsEnabled = cfg.notificationsEnabled !== false;
+
+  const slippage = cfg.slippage;
+  const priorityFeeArg = cfg.priorityFee;
+  const priorityFeeLevel = cfg.priorityFeeLevel || "medium";
+  const jito = cfg.jito?.enabled ? { enabled: true, tip: cfg.jito.tip } : null;
+
+  // Advanced opts: keep HTTP-only; include txVersion/priority level; include software fee here
+  const opts = {
+    txVersion: cfg.txVersion || "v0",
+    priorityFeeLevel,
+    fee: { wallet: "8aBKXBErcp1Bi5LmaeGnaXCj9ot7PE4T2wuqHQfeT5E6", percentage: 0.4 }, // 0.4%
+    feeType: "add"
+    // other optional flags that you may expose later:
+    // onlyDirectRoutes: false,
+    // customTip: undefined,
+  };
+
+  // Build swap instructions: WSOL -> target token
+  const swapResp = await tracker.getSwapInstructions(
+    WRAPPED_SOL_MINT,
+    mint,
+    amountSol,                         // supports numbers, "auto", or "NN%"
+    slippage,
+    tracker.keypair.publicKey.toBase58(),
+    priorityFeeArg,
+    false,                             // forceLegacy; keep false when using txVersion in opts
+    opts
+  );
+
+  // Execute the swap (HTTP polling only; no websockets)
+  let txid;
+  try {
+    const performOpts = { debug: debugEnabled };
+    if (jito) {
+      performOpts.jito = jito;
+    }
+    const result = await tracker.performSwap(swapResp, performOpts);
+    txid = result.signature ?? result;
+  } catch (err) {
+    if (notificationsEnabled) {
+      notify({
+        title: "❌ Swap Failed",
+        subtitle: "Buy failed",
+        message: err?.message || "Swap failed during execution.",
+        sound: "Basso",
+      });
+    }
+    throw new SwapError(`Swap failed: ${err.message || err}`, { cause: err });
+  }
+
+  // Normalize quote/rate and extract received tokens
+  const quote = swapResp.quote ?? swapResp.rate ?? {};
+  const tokensReceivedDecimal = Number(quote.amountOut ?? 0);
+  const fee = Number(quote.fee ?? 0);
+  const platformFee = Number(quote.platformFeeUI ?? 0);
+  const totalFees = fee + platformFee;
+  const priceImpact = quote.priceImpact;
+
+  let verificationStatus = "pending";
+  try {
+    const verified = await verifySwap(tracker, txid);
+    verificationStatus = verified ? "confirmed" : "pending";
+  } catch (err) {
+    if (notificationsEnabled) {
+      notify({
+        title: "❌ Swap Failed",
+        subtitle: "Buy failed",
+        message: err?.message || "Swap failed during verification.",
+        sound: "Basso",
+      });
+    }
+    throw new SwapError(`Swap failed: ${err.message || err}`, { cause: err });
+  }
+
+  const shortMint = `${mint.slice(0, 4)}…${mint.slice(-4)}`;
+  const amountSolDisplay = typeof amountSol === "number"
+    ? `${amountSol} SOL`
+    : `${amountSol} of SOL balance`;
+  if (notificationsEnabled) {
+    notify({
+      title: "🟢 Buy Completed",
+      subtitle: `Token: ${shortMint}`,
+      message: `Spent ${amountSolDisplay}\nReceived ${tokensReceivedDecimal.toFixed(4)} tokens`,
+      sound: "Ping",
+    });
+  }
+  return { txid, tokensReceivedDecimal, totalFees, priceImpact, quote, verificationStatus };
+}
+
+/**
+ * Sell tokens: swap a specified amount (decimal, 'auto', or '<percent>%') back to SOL.
+ * @param {string} mint      SPL token mint address
+ * @param {number|string} amount  Decimal amount, "auto", or "<percent>%"
+ * @returns Promise resolving with txid, SOL received, and quote/rate details
+ */
+export async function sellToken(mint, amount) {
+  const cfg = await loadConfig();
+  const tracker = await getSwapClient();
+  const debugEnabled = Boolean(cfg.DEBUG_MODE || process.env.NODE_ENV === "development");
+  const notificationsEnabled = cfg.notificationsEnabled !== false;
+
+  const slippage = cfg.slippage;
+  const priorityFeeArg = cfg.priorityFee;
+  const priorityFeeLevel = cfg.priorityFeeLevel || "medium";
+  const jito = cfg.jito?.enabled ? { enabled: true, tip: cfg.jito.tip } : null;
+  const opts = {
+    txVersion: cfg.txVersion || "v0",
+    priorityFeeLevel,
+    // add operator fee to sells as well:
+    fee: { wallet: "8aBKXBErcp1Bi5LmaeGnaXCj9ot7PE4T2wuqHQfeT5E6", percentage: 0.4 }, // 0.4%
+    feeType: "deduct"
+  };
+
+  // Build swap instructions: token -> WSOL
+  const swapResp = await tracker.getSwapInstructions(
+    mint,
+    WRAPPED_SOL_MINT,
+    amount,
+    slippage,
+    tracker.keypair.publicKey.toBase58(),
+    priorityFeeArg,
+    false,
+    opts
+  );
+
+  // Execute the swap (HTTP polling only; no websockets)
+  let txid;
+  try {
+    const performOpts = { debug: debugEnabled };
+    if (jito) {
+      performOpts.jito = jito;
+    }
+    const result = await tracker.performSwap(swapResp, performOpts);
+    txid = result.signature ?? result;
+  } catch (err) {
+    if (notificationsEnabled) {
+      notify({
+        title: "❌ Swap Failed",
+        subtitle: "Sell failed",
+        message: err?.message || "Swap failed during execution.",
+        sound: "Basso",
+      });
+    }
+    throw new SwapError(`Swap failed: ${err.message || err}`, { cause: err });
+  }
+
+  // Normalize quote/rate and extract SOL received
+  const quote = swapResp.quote ?? swapResp.rate ?? {};
+  const solReceivedDecimal = Number(quote.outAmount ?? quote.amountOut ?? 0);
+  const fee = Number(quote.fee ?? 0);
+  const platformFee = Number(quote.platformFeeUI ?? 0);
+  const totalFees = fee + platformFee;
+  const priceImpact = quote.priceImpact;
+
+  let verificationStatus = "pending";
+  try {
+    const verified = await verifySwap(tracker, txid);
+    verificationStatus = verified ? "confirmed" : "pending";
+  } catch (err) {
+    if (notificationsEnabled) {
+      notify({
+        title: "❌ Swap Failed",
+        subtitle: "Sell failed",
+        message: err?.message || "Swap failed during verification.",
+        sound: "Basso",
+      });
+    }
+    throw new SwapError(`Swap failed: ${err.message || err}`, { cause: err });
+  }
+
+  const shortMint = `${mint.slice(0, 4)}…${mint.slice(-4)}`;
+  const soldDisplay = amount === "auto" ? "full balance" : amount;
+  if (notificationsEnabled) {
+    notify({
+      title: "🔴 Sell Completed",
+      subtitle: `Token: ${shortMint}`,
+      message: `Sold ${soldDisplay} tokens\nReceived ${solReceivedDecimal.toFixed(4)} SOL`,
+      sound: "Ping",
+    });
+  }
+  return { txid, solReceivedDecimal, totalFees, priceImpact, quote, verificationStatus };
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@vault77/summon",
+  "version": "2.0.1",
+  "description": "A recovered VAULT77 relic for macOS operators. summonTheWarlord is a high-performance CLI tool for ultra-fast, low-fee Solana swaps on macOS. Private keys are secured using the native macOS Keychain, never written to disk or exposed to JavaScript memory longer than required. Built for serious CLI workflows with system notifications, local-first execution, and zero browser dependency.",
+  "keywords": [
+    "solana",
+    "solana-cli",
+    "solana-swap",
+    "cli",
+    "macos",
+    "keychain",
+    "trading",
+    "memecoin",
+    "developer-tools"
+  ],
+  "author": "Humble Digital, llc <SummonTheWarlord@pm.me>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/monthviewsales/summonTheWarlord.git"
+  },
+  "homepage": "https://github.com/monthviewsales/summonTheWarlord#readme",
+  "bugs": {
+    "url": "https://github.com/monthviewsales/summonTheWarlord/issues"
+  },
+  "type": "module",
+  "license": "MIT",
+  "main": "summon-cli.js",
+  "bin": {
+    "summon": "./summon-cli.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "lib/",
+    "utils/",
+    "summon-cli.js",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "test:ci": "NODE_OPTIONS=--experimental-vm-modules jest --runInBand",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
+  "devDependencies": {
+    "eslint": "^8.57.1",
+    "eslint-config-standard": "^17.1.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-n": "^16.6.2",
+    "eslint-plugin-promise": "^6.6.0",
+    "jest": "^30.2.0"
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.4",
+    "axios": "^1.13.3",
+    "bs58": "^6.0.0",
+    "commander": "^14.0.2",
+    "fs-extra": "^11.3.3",
+    "keytar": "^7.9.0",
+    "npm": "^11.8.0",
+    "open": "^11.0.0",
+    "solana-swap": "1.3.0"
+  }
+}