@xona-labs/xpay 0.2.24 → 0.2.25

package/dist/token/index.js

@@ -1,8 +1,8 @@
 /**
- * Solana token discovery — Jupiter Token API v2.
+ * Solana token discovery - Jupiter Token API v2.
  *
  * Keyless read-only search by ticker, name, or mint address. Returns live
- * market data (price, mcap, liquidity) plus Jupiter's verification flag —
+ * market data (price, mcap, liquidity) plus Jupiter's verification flag -
  * the main scam signal agents must check before swapping (anyone can mint a
  * token reusing a real project's ticker).
  */
@@ -10,23 +10,23 @@ import { Connection, PublicKey } from "@solana/web3.js";
 import { getMint } from "@solana/spl-token";
 import { SOLANA_TOKENS } from "../transfer/index.js";
 const DEFAULT_ENDPOINT = "https://api.jup.ag";
-/** Wrapped-SOL mint — Jupiter's sentinel for native SOL (wraps/unwraps automatically). */
+/** Wrapped-SOL mint - Jupiter's sentinel for native SOL (wraps/unwraps automatically). */
 export const NATIVE_SOL_MINT = "So11111111111111111111111111111111111111112";
-/** Thrown when a bare ticker matches several plausible tokens — retry with the exact mint. */
+/** Thrown when a bare ticker matches several plausible tokens - retry with the exact mint. */
 export class AmbiguousTokenError extends Error {
     candidates;
     constructor(input, candidates) {
         const list = candidates
             .map((c) => `  ${c.symbol} (${c.name}) mint ${c.mint}${c.verified ? " [verified]" : " [UNVERIFIED]"} liquidity $${Math.round(c.liquidity ?? 0).toLocaleString()}`)
             .join("\n");
-        super(`Token "${input}" is ambiguous — pass the exact mint address of the one you mean:\n${list}`);
+        super(`Token "${input}" is ambiguous - pass the exact mint address of the one you mean:\n${list}`);
         this.name = "AmbiguousTokenError";
         this.candidates = candidates;
     }
 }
 /**
  * Search tokens by ticker, name, or mint. Ranked verified-first, then by
- * liquidity. Read-only — no wallet, no signing.
+ * liquidity. Read-only - no wallet, no signing.
  */
 export async function findTokens(query, opts = {}) {
     const raw = await searchJupiter(query, opts);
@@ -46,7 +46,7 @@ export async function findTokens(query, opts = {}) {
 }
 /**
  * Deterministic single-token resolution for trading. Accepts a symbol or a
- * mint address; never silently picks between plausible candidates — throws
+ * mint address; never silently picks between plausible candidates - throws
  * {@link AmbiguousTokenError} instead so the caller can pass the exact mint.
  */
 export async function resolveTradeToken(input, opts = {}) {
@@ -57,7 +57,7 @@ export async function resolveTradeToken(input, opts = {}) {
         return { ...(info ?? fallbackToken(NATIVE_SOL_MINT, 9)), symbol: "SOL", verified: true };
     }
     // Well-known symbols pin to a canonical mint (avoids the ~20 lookalike
-    // "BONK"s Jupiter returns) — then still fetch live data by that mint.
+    // "BONK"s Jupiter returns) - then still fetch live data by that mint.
     const pinned = SOLANA_TOKENS[key] ?? Object.values(SOLANA_TOKENS).find((t) => t.symbol.toUpperCase() === key);
     if (pinned) {
         const [info] = await searchJupiter(pinned.mint, opts);
@@ -87,16 +87,16 @@ export async function resolveTradeToken(input, opts = {}) {
         throw new AmbiguousTokenError(input, sorted.slice(0, 5));
     }
     if (symbolMatches.length > 0) {
-        // Only unverified candidates — never auto-trade those by ticker.
+        // Only unverified candidates - never auto-trade those by ticker.
         throw new AmbiguousTokenError(input, symbolMatches.sort((a, b) => (b.liquidity ?? 0) - (a.liquidity ?? 0)).slice(0, 5));
     }
-    throw new Error(`Unknown token "${input}" — no exact ticker match on Jupiter. ` +
+    throw new Error(`Unknown token "${input}" - no exact ticker match on Jupiter. ` +
         `Try \`xpay token find ${input}\` to search, or pass the mint address directly.`);
 }
 /**
  * Label and price wallet balances via one batched Jupiter lookup (comma-
  * separated mints, max 100). Unknown mints get their real symbol/name; every
- * priceable token gets `usdPrice`/`usdValue`. Never throws — on any Jupiter
+ * priceable token gets `usdPrice`/`usdValue`. Never throws - on any Jupiter
  * failure the input balances are returned unchanged (a balance display must
  * not break because a market-data API hiccuped).
  */
@@ -186,7 +186,7 @@ export async function jupiterFetch(url, apiKey, init) {
                 reason = body?.error ?? body?.errorMessage ?? "";
             }
             catch { /* no body */ }
-            throw new Error(`Jupiter API ${res.status} ${res.statusText}${reason ? ` — ${reason}` : ""}` +
+            throw new Error(`Jupiter API ${res.status} ${res.statusText}${reason ? ` - ${reason}` : ""}` +
                 (res.status === 429 ? " (rate-limited; set JUPITER_API_KEY for higher limits)" : ""));
         }
         return res.json();
@@ -198,7 +198,7 @@ function numOrUndef(v) {
 function fallbackToken(mint, decimals) {
     return { mint, symbol: mint.slice(0, 6) + "…", name: "", decimals, verified: false };
 }
-/** Last resort for mints Jupiter has never indexed — decimals from chain, no price. */
+/** Last resort for mints Jupiter has never indexed - decimals from chain, no price. */
 async function onChainToken(mint) {
     const rpc = process.env.XPAY_SOLANA_RPC ?? "https://solana-mainnet.g.alchemy.com/v2/Ug5mqBVIbSHoa8ZHgTUSJ";
     try {
@@ -207,7 +207,7 @@ async function onChainToken(mint) {
         return fallbackToken(mint, info.decimals);
     }
     catch {
-        throw new Error(`Token mint ${mint} not found on Jupiter or on-chain — check the address.`);
+        throw new Error(`Token mint ${mint} not found on Jupiter or on-chain - check the address.`);
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/token/rwa.d.ts

@@ -1,5 +1,5 @@
 /**
- * RWA (real-world asset) discovery on Solana — Jupiter Token API v2.
+ * RWA (real-world asset) discovery on Solana - Jupiter Token API v2.
  *
  * "RWA" covers every tokenized off-chain asset: equities, ETFs, treasuries,
  * commodities, private credit. What is actually TRADABLE on Solana DEXes
@@ -12,7 +12,7 @@
  *     so it is pinned here explicitly).
  *
  * Permissioned funds (BlackRock BUIDL, Ondo OUSG) exist on Solana but are
- * KYC-gated: unverified on Jupiter, zero DEX liquidity, not swappable — they
+ * KYC-gated: unverified on Jupiter, zero DEX liquidity, not swappable - they
  * are deliberately excluded.
  *
  * Jupiter's tag ENDPOINT rejects `rwa`/`stocks`/`xstocks` as queries (only
@@ -34,7 +34,7 @@ export interface RwaFindOptions extends TokenApiOptions {
     category?: RwaCategory;
     /** Max results. Default 20. */
     limit?: number;
-    /** Include unverified tokens (excluded by default — same scam caveat as any ticker). */
+    /** Include unverified tokens (excluded by default - same scam caveat as any ticker). */
     includeUnverified?: boolean;
 }
 /**

package/dist/token/rwa.js

@@ -1,5 +1,5 @@
 /**
- * RWA (real-world asset) discovery on Solana — Jupiter Token API v2.
+ * RWA (real-world asset) discovery on Solana - Jupiter Token API v2.
  *
  * "RWA" covers every tokenized off-chain asset: equities, ETFs, treasuries,
  * commodities, private credit. What is actually TRADABLE on Solana DEXes
@@ -12,7 +12,7 @@
  *     so it is pinned here explicitly).
  *
  * Permissioned funds (BlackRock BUIDL, Ondo OUSG) exist on Solana but are
- * KYC-gated: unverified on Jupiter, zero DEX liquidity, not swappable — they
+ * KYC-gated: unverified on Jupiter, zero DEX liquidity, not swappable - they
  * are deliberately excluded.
  *
  * Jupiter's tag ENDPOINT rejects `rwa`/`stocks`/`xstocks` as queries (only
@@ -28,7 +28,7 @@ import { searchTokens } from "./index.js";
  * its top-100 between runs.
  */
 const SWEEP_QUERIES = ["xstock", "Ondo Tokenized", "tokenized", "treasury", "remora"];
-/** Ondo USDY — treasury-backed yieldcoin, tagged yield/yb on Jupiter rather than rwa. */
+/** Ondo USDY - treasury-backed yieldcoin, tagged yield/yb on Jupiter rather than rwa. */
 const USDY_MINT = "A1KLoBrKBde8Ty9qtNQUtq3C2ortoC3u7twggz7sEto6";
 const CACHE_TTL_MS = 5 * 60_000;
 let sweepCache;

package/dist/tools/index.d.ts

@@ -21,7 +21,7 @@ export interface ClaudeToolDef {
     input_schema: Record<string, unknown>;
 }
 export interface ToolOptions {
-    /** Sana API key — when present, registers sana_* tools alongside xpay_* tools. */
+    /** Sana API key - when present, registers sana_* tools alongside xpay_* tools. */
     sanaApiKey?: string;
 }
 /** Anthropic Claude tool definitions. */

package/dist/tools/index.js

@@ -27,7 +27,7 @@ export function forClaude(xpay, opts = {}) {
             name: "xpay_discover",
             description: "Find paid HTTP services across the agentic-commerce catalog (PayAI + others). " +
                 "Returns ranked candidates with price, network, and payment recipient. " +
-                "Results may include AgenC marketplace agent listings (metadata.source === 'agenc') — " +
+                "Results may include AgenC marketplace agent listings (metadata.source === 'agenc') - " +
                 "those are priced in SOL lamports and execute as on-chain escrow hires, not HTTP calls. " +
                 "When the user asks specifically about the AgenC marketplace, pass sources: ['agenc'] " +
                 "(optionally with no query) to list ALL its listings instead of the few slots it gets " +
@@ -49,12 +49,12 @@ export function forClaude(xpay, opts = {}) {
         {
             name: "xpay_use",
             description: "Call a specific resource from the catalog. Handles x402 payment automatically. " +
-                "Prefer passing the full `resource` object returned by xpay_discover — it includes " +
+                "Prefer passing the full `resource` object returned by xpay_discover - it includes " +
                 "pre-fetched payment requirements so payment goes through without a probe round-trip. " +
                 "Fall back to `resourceUrl` only when you have a URL but no catalog entry. " +
                 "If the resource is an AgenC marketplace listing it executes as a Solana escrow hire " +
                 "instead: SOL is escrowed on-chain and the result is a hire receipt (task PDA + tx " +
-                "signature), NOT an HTTP response — the provider works asynchronously; poll progress " +
+                "signature), NOT an HTTP response - the provider works asynchronously; poll progress " +
                 "with xpay_agenc_status.",
             input_schema: {
                 type: "object",
@@ -119,7 +119,7 @@ export function forClaude(xpay, opts = {}) {
         },
         {
             name: "xpay_report",
-            description: "Comprehensive USDC activity report for the wallet — totals, net flow, daily timeline, top counterparties, and biggest transactions. " +
+            description: "Comprehensive USDC activity report for the wallet - totals, net flow, daily timeline, top counterparties, and biggest transactions. " +
                 "Powered by OrbitX402 (on-chain data fetched server-side, no RPC exposed). " +
                 "Use this instead of history for a full picture of spending and income.",
             input_schema: {
@@ -144,10 +144,10 @@ export function forClaude(xpay, opts = {}) {
         },
         {
             name: "xpay_token_find",
-            description: "Find Solana tokens by ticker, name, or mint address (Jupiter registry). Read-only — no " +
+            description: "Find Solana tokens by ticker, name, or mint address (Jupiter registry). Read-only - no " +
                 "wallet, no spending. Returns mint, price, market cap, liquidity, and a `verified` flag. " +
                 "ALWAYS check `verified` before suggesting a swap: unverified tokens can be scams reusing a " +
-                "real token's ticker. This tool alone answers price/info questions — only proceed to a swap " +
+                "real token's ticker. This tool alone answers price/info questions - only proceed to a swap " +
                 "if the user explicitly asked to trade, and then use the xpay_swap tool with the chosen mint " +
                 "(do NOT write code or call DEX APIs yourself).",
             input_schema: {
@@ -161,17 +161,17 @@ export function forClaude(xpay, opts = {}) {
         },
         {
             name: "xpay_swap",
-            description: "THE ONLY way to swap tokens — a single tool call that quotes, signs, and executes inside the " +
+            description: "THE ONLY way to swap tokens - a single tool call that quotes, signs, and executes inside the " +
                 "user's own xpay wallet via Jupiter (Solana only). NEVER write code or scripts (Python/JS/curl) " +
                 "to swap, and never call Jupiter or DEX APIs directly: custom code bypasses the user's guardrail " +
                 "caps and token-verification safety, and has no access to the wallet key anyway. When the user " +
-                "actually wants to swap, this one tool call does everything (quote + sign + execute) — but " +
+                "actually wants to swap, this one tool call does everything (quote + sign + execute) - but " +
                 "xpay_token_find alone answers informational questions; do NOT follow it with a swap unless the " +
                 "user asked to trade. Swaps are irreversible and guardrail caps are enforced before signing. Before calling, show the " +
                 "user: the input amount + USD value, the expected output amount, and the output token's mint + " +
-                "verification status — and get their explicit approval. Never swap unprompted, and never swap " +
+                "verification status - and get their explicit approval. Never swap unprompted, and never swap " +
                 "into an unverified token without the user confirming the exact mint. Ambiguous tickers return " +
-                "an error listing candidate mints — pass the exact mint to disambiguate.",
+                "an error listing candidate mints - pass the exact mint to disambiguate.",
             input_schema: {
                 type: "object",
                 properties: {
@@ -189,7 +189,7 @@ export function forClaude(xpay, opts = {}) {
                 "fun.noxa.fi memecoin scene) right now, with price, market cap, 24h volume, and the token's " +
                 "contract address. FREE, read-only, no wallet. Use this to answer 'what's hot on Robinhood " +
                 "Chain' and to get the exact contract address to pass to xpay_trade. Pass newOnly:true for " +
-                "the freshest launches (higher risk). This is Robinhood *Chain* on-chain data — unrelated to " +
+                "the freshest launches (higher risk). This is Robinhood *Chain* on-chain data - unrelated to " +
                 "the Robinhood brokerage app or stock trading.",
             input_schema: {
                 type: "object",
@@ -201,7 +201,7 @@ export function forClaude(xpay, opts = {}) {
         },
         {
             name: "xpay_trade_quote",
-            description: "Quote a Robinhood Chain trade WITHOUT executing — no signing, no funds moved, no guardrail. " +
+            description: "Quote a Robinhood Chain trade WITHOUT executing - no signing, no funds moved, no guardrail. " +
                 "Buy a token with native ETH or sell it back to ETH, routed through Uniswap V3 (NOXA Fun " +
                 "pools). Returns expected output, min output after slippage, pool fee, USD estimate, and " +
                 "whether the token is a verified NOXA launch. Use this to preview a trade before calling " +
@@ -220,16 +220,16 @@ export function forClaude(xpay, opts = {}) {
         },
         {
             name: "xpay_trade",
-            description: "Trade tokens on Robinhood Chain (Arbitrum L2) via Uniswap V3 — quotes, signs, and executes " +
+            description: "Trade tokens on Robinhood Chain (Arbitrum L2) via Uniswap V3 - quotes, signs, and executes " +
                 "in ONE call from the user's own xpay wallet. Buy a memecoin with native ETH, or sell it back " +
                 "to ETH (v1 supports ETH↔token only). This is distinct from xpay_swap, which is Solana/Jupiter. " +
-                "NEVER write code or call DEX/router contracts yourself — custom code bypasses the guardrail and " +
+                "NEVER write code or call DEX/router contracts yourself - custom code bypasses the guardrail and " +
                 "has no wallet key. Trades are IRREVERSIBLE; guardrail caps are enforced before signing. Before " +
                 "calling: show the user the input amount + USD value, expected output, the token's contract " +
                 "address, and whether it's a verified NOXA launch (unverified tokens can be scams reusing a " +
-                "ticker) — and get explicit approval. Prefer passing the exact contract address from " +
+                "ticker) - and get explicit approval. Prefer passing the exact contract address from " +
                 "xpay_trending_tokens over a symbol (memecoin tickers aren't unique). Fund the wallet with ETH " +
-                "on Robinhood Chain first (bridge via Across or Uniswap) — the wallet pays its own gas here.",
+                "on Robinhood Chain first (bridge via Across or Uniswap) - the wallet pays its own gas here.",
             input_schema: {
                 type: "object",
                 properties: {
@@ -243,8 +243,8 @@ export function forClaude(xpay, opts = {}) {
         },
         {
             name: "xpay_x_user",
-            description: "Realtime X (Twitter) profile lookup — followers, bio, verification status. This is a PAID " +
-                "call (~$0.01 USDC from the wallet via x402, at cost — no markup); guardrail caps apply. " +
+            description: "Realtime X (Twitter) profile lookup - followers, bio, verification status. This is a PAID " +
+                "call (~$0.01 USDC from the wallet via x402, at cost - no markup); guardrail caps apply. " +
                 "Great for due diligence on a token's or project's X account before a swap. Don't spam it: " +
                 "results barely change minute to minute, so one call per account per conversation is enough.",
             input_schema: {
@@ -258,7 +258,7 @@ export function forClaude(xpay, opts = {}) {
         {
             name: "xpay_x_posts",
             description: "Recent posts from an X (Twitter) account (up to 10, excludes retweets/replies) with " +
-                "engagement metrics. PAID call (~$0.06 USDC from the wallet via x402, at cost — no markup); " +
+                "engagement metrics. PAID call (~$0.06 USDC from the wallet via x402, at cost - no markup); " +
                 "guardrail caps apply. Use for checking what a project/account is actually saying right now " +
                 "(e.g. before swapping into their token). One call per account per conversation is enough.",
             input_schema: {
@@ -272,11 +272,11 @@ export function forClaude(xpay, opts = {}) {
         },
         {
             name: "xpay_zauth_reposcan",
-            description: "Repository security scan via zauth (partner) — scans a git repo for code provenance and " +
+            description: "Repository security scan via zauth (partner) - scans a git repo for code provenance and " +
                 "vulnerabilities. PAID call (~$0.05 USDC from the wallet via x402; guardrail caps apply). " +
                 "Scans can take a while: if the response still says status \"scanning\", check later with " +
                 "xpay_zauth_scan_status using the returned sessionToken (the long JWT string, NOT the short " +
-                "scanId — the token is valid ~1 hour). Do NOT call this tool again for the same repo, that " +
+                "scanId - the token is valid ~1 hour). Do NOT call this tool again for the same repo, that " +
                 "pays for a second scan. Results are informational: report them to the user, never " +
                 "auto-remediate or trigger further payments based on findings.",
             input_schema: {
@@ -290,15 +290,15 @@ export function forClaude(xpay, opts = {}) {
         {
             name: "xpay_zauth_scan_status",
             description: "Check a running zauth repo scan by sessionToken (returned by xpay_zauth_reposcan). " +
-                "FREE, read-only, no wallet — always use this to follow up on a pending scan instead of " +
+                "FREE, read-only, no wallet - always use this to follow up on a pending scan instead of " +
                 "re-calling xpay_zauth_reposcan, which would pay again. Pass the sessionToken (the long " +
-                "JWT starting with \"eyJ\"), NOT the scanId — the scanId is rejected with a 401.",
+                "JWT starting with \"eyJ\"), NOT the scanId - the scanId is rejected with a 401.",
             input_schema: {
                 type: "object",
                 properties: {
                     sessionToken: {
                         type: "string",
-                        description: "sessionToken from a pending xpay_zauth_reposcan result — the long JWT string " +
+                        description: "sessionToken from a pending xpay_zauth_reposcan result - the long JWT string " +
                             "(starts with \"eyJ\"), not the scanId. Valid ~1 hour after the scan started.",
                     },
                 },
@@ -497,7 +497,7 @@ export function forClaude(xpay, opts = {}) {
             const sources = input.sources;
             return xpay.discover({
                 query: input.query,
-                // Browsing a single catalog implies "show me what's there" — don't
+                // Browsing a single catalog implies "show me what's there" - don't
                 // truncate to the mixed-results default.
                 limit: input.limit ?? (sources?.length === 1 ? 50 : 5),
                 networks: input.network ? [input.network] : undefined,
@@ -505,7 +505,7 @@ export function forClaude(xpay, opts = {}) {
             });
         },
         xpay_use: async (input) => {
-            // Prefer the full resource object from xpay_discover — it carries
+            // Prefer the full resource object from xpay_discover - it carries
             // pre-fetched accepts[] so we take the catalog path (no probe round-trip).
             if (input.resource && typeof input.resource === "object") {
                 const parsed = ResourceSchema.safeParse(input.resource);
@@ -513,7 +513,7 @@ export function forClaude(xpay, opts = {}) {
                     return xpay.use(parsed.data, { body: input.body });
                 }
             }
-            // Fallback: only a URL was provided — probe the resource for a 402 challenge.
+            // Fallback: only a URL was provided - probe the resource for a 402 challenge.
             const url = input.resourceUrl;
             if (!url)
                 throw new Error("xpay_use: provide either `resource` (full object from xpay_discover) or `resourceUrl`");
@@ -544,13 +544,13 @@ export function forClaude(xpay, opts = {}) {
                     continue;
                 const signer = xpay.wallet.signer(n);
                 if (typeof signer.tokenBalances === "function") {
-                    // Full token breakdown — same path as the CLI. Solana balances are
+                    // Full token breakdown - same path as the CLI. Solana balances are
                     // enriched via Jupiter: unknown mints get real symbols/names, and
                     // priceable tokens carry usdPrice/usdValue.
                     const raw = await signer.tokenBalances().catch(() => []);
                     let tokens = n === "solana" ? await enrichTokenBalances(raw) : raw;
                     // Robinhood Chain: the signer only knows a hardcoded token list, so
-                    // pull the wallet's full ERC-20 holdings from the chain explorer —
+                    // pull the wallet's full ERC-20 holdings from the chain explorer -
                     // this is how memecoins bought via xpay_trade show up. Native ETH
                     // still comes from the signer.
                     if (n === "robinhood") {
@@ -635,7 +635,7 @@ export function forClaude(xpay, opts = {}) {
             });
             if (!isScanPending(result.data))
                 return { ...result, data: compactScanReport(result.data) };
-            // Paid + scan kicked off — poll the free status endpoint for a while.
+            // Paid + scan kicked off - poll the free status endpoint for a while.
             // Poll responses don't echo the sessionToken, so keep the kickoff's
             // copy and re-attach it if the scan outlives our window.
             const sessionToken = result.data.sessionToken;
@@ -646,7 +646,7 @@ export function forClaude(xpay, opts = {}) {
                     data: {
                         ...data,
                         sessionToken,
-                        note: "Scan still running — check later with xpay_zauth_scan_status, passing this " +
+                        note: "Scan still running - check later with xpay_zauth_scan_status, passing this " +
                             "sessionToken (the long JWT, NOT the scanId). Do not re-run xpay_zauth_reposcan " +
                             "for this repo; that pays again.",
                     },

package/dist/trading/discovery.d.ts

@@ -1,9 +1,9 @@
 /**
- * Robinhood Chain token discovery — GeckoTerminal public API.
+ * Robinhood Chain token discovery - GeckoTerminal public API.
  *
  * GeckoTerminal indexes Robinhood Chain under the network id "robinhood"
  * (keyless, ~30 req/min). Used for the trending/new token tools and for the
- * USD pricing attached to trade quotes. Discovery is read-only market data —
+ * USD pricing attached to trade quotes. Discovery is read-only market data -
  * the trade path itself never depends on it.
  */
 export interface DiscoveredToken {
@@ -18,7 +18,7 @@ export interface DiscoveredToken {
     priceChange24hPct?: number;
     /** Liquidity pool: 20-byte address (Uniswap v3) or 32-byte id (v4). */
     pool: string;
-    /** True for v4 pool ids — xpay_trade only routes v3 pools today. */
+    /** True for v4 pool ids - xpay_trade only routes v3 pools today. */
     poolIsV4: boolean;
     dex?: string;
     poolCreatedAt?: string;
@@ -27,7 +27,7 @@ export interface DiscoveredToken {
 export declare function trendingTokens(opts?: {
     limit?: number;
 }): Promise<DiscoveredToken[]>;
-/** Tokens from the most recently created pools (fresh launches — high risk). */
+/** Tokens from the most recently created pools (fresh launches - high risk). */
 export declare function newTokens(opts?: {
     limit?: number;
 }): Promise<DiscoveredToken[]>;
@@ -44,14 +44,14 @@ export interface TokenHolding {
 /**
  * All ERC-20 balances a wallet holds on Robinhood Chain, via the chain's
  * Blockscout explorer API (keyless). This is what surfaces memecoins bought
- * through `xpay trade` — the on-chain signer only knows a hardcoded token list.
+ * through `xpay trade` - the on-chain signer only knows a hardcoded token list.
  * Best-effort: returns [] if the explorer is unreachable.
  */
 export declare function robinhoodHoldings(address: string): Promise<TokenHolding[]>;
 /**
  * Resolve a token symbol to its contract address via trending + new pools.
  * Throws when the symbol is unknown or matches several distinct contracts
- * (memecoin symbols are not unique — pass the address instead).
+ * (memecoin symbols are not unique - pass the address instead).
  */
 export declare function resolveTokenBySymbol(symbol: string): Promise<DiscoveredToken>;
 //# sourceMappingURL=discovery.d.ts.map

package/dist/trading/discovery.js

@@ -1,9 +1,9 @@
 /**
- * Robinhood Chain token discovery — GeckoTerminal public API.
+ * Robinhood Chain token discovery - GeckoTerminal public API.
  *
  * GeckoTerminal indexes Robinhood Chain under the network id "robinhood"
  * (keyless, ~30 req/min). Used for the trending/new token tools and for the
- * USD pricing attached to trade quotes. Discovery is read-only market data —
+ * USD pricing attached to trade quotes. Discovery is read-only market data -
  * the trade path itself never depends on it.
  */
 const DEFAULT_ENDPOINT = "https://api.geckoterminal.com/api/v2";
@@ -31,7 +31,7 @@ function poolsToTokens(payload, limit) {
     const out = [];
     for (const pool of data) {
         const attrs = pool.attributes ?? {};
-        // base_token id looks like "robinhood_0x020b…" — address after the prefix.
+        // base_token id looks like "robinhood_0x020b…" - address after the prefix.
         const baseId = pool.relationships?.base_token?.data?.id ?? "";
         const address = baseId.includes("_") ? baseId.slice(baseId.indexOf("_") + 1) : "";
         if (!address.startsWith("0x"))
@@ -64,7 +64,7 @@ export async function trendingTokens(opts = {}) {
     const payload = await gtFetch(`/networks/${GT_NETWORK}/trending_pools?page=1`);
     return poolsToTokens(payload, opts.limit ?? 10);
 }
-/** Tokens from the most recently created pools (fresh launches — high risk). */
+/** Tokens from the most recently created pools (fresh launches - high risk). */
 export async function newTokens(opts = {}) {
     const payload = await gtFetch(`/networks/${GT_NETWORK}/new_pools?page=1`);
     return poolsToTokens(payload, opts.limit ?? 10);
@@ -83,7 +83,7 @@ export async function tokenPriceUsd(address) {
 /**
  * All ERC-20 balances a wallet holds on Robinhood Chain, via the chain's
  * Blockscout explorer API (keyless). This is what surfaces memecoins bought
- * through `xpay trade` — the on-chain signer only knows a hardcoded token list.
+ * through `xpay trade` - the on-chain signer only knows a hardcoded token list.
  * Best-effort: returns [] if the explorer is unreachable.
  */
 export async function robinhoodHoldings(address) {
@@ -132,7 +132,7 @@ function atomsToHuman(atoms, decimals) {
 /**
  * Resolve a token symbol to its contract address via trending + new pools.
  * Throws when the symbol is unknown or matches several distinct contracts
- * (memecoin symbols are not unique — pass the address instead).
+ * (memecoin symbols are not unique - pass the address instead).
  */
 export async function resolveTokenBySymbol(symbol) {
     const wanted = symbol.trim().toUpperCase();
@@ -146,7 +146,7 @@ export async function resolveTokenBySymbol(symbol) {
             matches.set(t.address.toLowerCase(), t);
     }
     if (matches.size === 0) {
-        throw new Error(`xpay.trade: unknown token "${symbol}" — not in Robinhood Chain trending/new pools. ` +
+        throw new Error(`xpay.trade: unknown token "${symbol}" - not in Robinhood Chain trending/new pools. ` +
             "Pass the token's contract address instead.");
     }
     if (matches.size > 1) {

package/dist/trading/index.d.ts

@@ -1,15 +1,15 @@
 /**
- * Robinhood Chain token trading — direct Uniswap V3 (NOXA Fun launchpad).
+ * Robinhood Chain token trading - direct Uniswap V3 (NOXA Fun launchpad).
  *
  * NOXA Fun tokens (fun.noxa.fi) launch straight into Uniswap V3 pools quoted
  * in WETH, so trading them is plain V3: quote via QuoterV2, execute via
- * SwapRouter02. No third-party API or key — everything is on-chain against the
+ * SwapRouter02. No third-party API or key - everything is on-chain against the
  * chain's own RPC. GMGN was ruled out (no chain-4663 support, gated API).
  *
  * Scope v1: ETH ⇄ token only (buy with native ETH, sell back to native ETH).
  * The router auto-wraps ETH on buys; sells unwrap WETH → ETH via multicall.
  *
- * A trade is irreversible and risks wallet value, so — exactly like `swap` —
+ * A trade is irreversible and risks wallet value, so, exactly like `swap`,
  * it runs through the guardrail *before* signing.
  */
 import type { Network } from "../types.js";
@@ -24,7 +24,7 @@ export declare const RH_CONTRACTS: {
     readonly weth: "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73";
     readonly noxaLauncher: "0xD9eC2db5f3D1b236843925949fe5bd8a3836FCcB";
 };
-/** Trading settings — profile `config.trading`, overridable per call. */
+/** Trading settings - profile `config.trading`, overridable per call. */
 export interface TradeConfig {
     /** Default max slippage in bps (100 = 1%). */
     slippageBps?: number;
@@ -75,7 +75,7 @@ export interface TradeQuote {
     /** Input-side USD estimate (GeckoTerminal spot). Best-effort. */
     usdValue?: number;
     /**
-     * True when the counterparty token was NOT confirmed as a NOXA Fun launch —
+     * True when the counterparty token was NOT confirmed as a NOXA Fun launch -
      * it may still be tradeable, but treat the pool/price with more suspicion.
      */
     unverified: boolean;
@@ -86,7 +86,7 @@ export interface TradeResult extends TradeQuote {
     /** Transaction hash on Robinhood Chain. */
     txHash: string;
 }
-/** Quote a trade without executing — no guardrail, no signing, no funds moved. */
+/** Quote a trade without executing - no guardrail, no signing, no funds moved. */
 export declare function tradeQuote(args: Omit<TradeArgs, "guardrail">): Promise<TradeQuote>;
 /** Execute a trade on Robinhood Chain. Guardrail runs before signing. */
 export declare function trade(args: TradeArgs): Promise<TradeResult>;

package/dist/trading/index.js

@@ -1,15 +1,15 @@
 /**
- * Robinhood Chain token trading — direct Uniswap V3 (NOXA Fun launchpad).
+ * Robinhood Chain token trading - direct Uniswap V3 (NOXA Fun launchpad).
  *
  * NOXA Fun tokens (fun.noxa.fi) launch straight into Uniswap V3 pools quoted
  * in WETH, so trading them is plain V3: quote via QuoterV2, execute via
- * SwapRouter02. No third-party API or key — everything is on-chain against the
+ * SwapRouter02. No third-party API or key - everything is on-chain against the
  * chain's own RPC. GMGN was ruled out (no chain-4663 support, gated API).
  *
  * Scope v1: ETH ⇄ token only (buy with native ETH, sell back to native ETH).
  * The router auto-wraps ETH on buys; sells unwrap WETH → ETH via multicall.
  *
- * A trade is irreversible and risks wallet value, so — exactly like `swap` —
+ * A trade is irreversible and risks wallet value, so, exactly like `swap`,
  * it runs through the guardrail *before* signing.
  */
 import { Contract, MaxUint256, getAddress, isAddress } from "ethers";
@@ -25,7 +25,7 @@ export const RH_CONTRACTS = {
 };
 /** Fee tiers probed (in bps*100) when the pool fee isn't known up front. NOXA uses 10000 (1%). */
 const FEE_TIERS = [10000, 3000, 500, 100];
-const DEFAULT_SLIPPAGE_BPS = 100; // 1% — memecoin pools with a 1% fee move fast.
+const DEFAULT_SLIPPAGE_BPS = 100; // 1% - memecoin pools with a 1% fee move fast.
 const MAX_SLIPPAGE_BPS = 5000; // 50% hard ceiling.
 const QUOTER_ABI = [
     "function quoteExactInputSingle((address tokenIn,address tokenOut,uint256 amountIn,uint24 fee,uint160 sqrtPriceLimitX96)) returns (uint256 amountOut,uint160 sqrtPriceX96After,uint32 initializedTicksCrossed,uint256 gasEstimate)",
@@ -42,7 +42,7 @@ const ERC20_ABI = [
     "function allowance(address owner,address spender) view returns (uint256)",
     "function approve(address spender,uint256 amount) returns (bool)",
 ];
-// NOXA Fun token surface — non-standard getters a plain ERC-20 lacks.
+// NOXA Fun token surface - non-standard getters a plain ERC-20 lacks.
 const NOXA_TOKEN_ABI = [
     "function liquidityPool() view returns (address)",
     "function pairToken() view returns (address)",
@@ -54,14 +54,14 @@ const NOXA_TOKEN_ABI = [
 // SwapRouter02 recipient constant: keep output in the router for a follow-up unwrap.
 const ROUTER_ADDRESS_THIS = "0x0000000000000000000000000000000000000002";
 const NATIVE_ETH = { symbol: "ETH", decimals: 18 };
-/** Quote a trade without executing — no guardrail, no signing, no funds moved. */
+/** Quote a trade without executing - no guardrail, no signing, no funds moved. */
 export async function tradeQuote(args) {
     return (await prepare(args)).quote;
 }
 /** Execute a trade on Robinhood Chain. Guardrail runs before signing. */
 export async function trade(args) {
     const { quote, ethersWallet, side, token } = await prepare(args);
-    // Guardrail *before* signing — same security boundary as swap/pay/transfer.
+    // Guardrail *before* signing - same security boundary as swap/pay/transfer.
     // Reuse the "swap" scheme so host-whitelist is skipped and the USD estimate
     // is priced from `extra.usdEstimate` (see Guardrail.estimateUsd).
     await args.guardrail.check({
@@ -140,7 +140,7 @@ async function prepare(args) {
         throw new Error(`xpay.trade: only Robinhood Chain ("robinhood") is supported (got "${network}")`);
     }
     if (!args.wallet.has(ROBINHOOD_NETWORK)) {
-        throw new Error('xpay.trade: no "robinhood" signer configured — add it to your profile networks');
+        throw new Error('xpay.trade: no "robinhood" signer configured - add it to your profile networks');
     }
     if (!Number.isFinite(args.amount) || args.amount <= 0) {
         throw new Error("xpay.trade: amount must be a positive number");
@@ -180,7 +180,7 @@ async function prepare(args) {
     // A buy that would breach a cap is failed up front with a clear message
     // rather than reverting opaquely on-chain. The cap info is surfaced on the
     // quote only when this trade is actually within striking distance of a cap
-    // (>25% of it) — established tokens leave a far-future endBlock set with wide
+    // (>25% of it) - established tokens leave a far-future endBlock set with wide
     // caps, so reporting it unconditionally would be misleading noise.
     let boundRestriction;
     if (restriction && side === "buy") {
@@ -232,7 +232,7 @@ function isEth(ref) {
 async function resolveToken(wallet, ref) {
     let address = ref.trim();
     if (!isAddress(address)) {
-        // Treat as a symbol — resolve via GeckoTerminal trending/new pools.
+        // Treat as a symbol - resolve via GeckoTerminal trending/new pools.
         const found = await resolveTokenBySymbol(address);
         address = found.address;
     }
@@ -244,7 +244,7 @@ async function resolveToken(wallet, ref) {
     ]);
     return { address, symbol, decimals };
 }
-/** Probe a token's NOXA Fun surface — pool, fee tier, launch restrictions. */
+/** Probe a token's NOXA Fun surface - pool, fee tier, launch restrictions. */
 async function inspectToken(wallet, address) {
     const t = new Contract(address, NOXA_TOKEN_ABI, wallet);
     try {
@@ -277,7 +277,7 @@ async function inspectToken(wallet, address) {
         return meta;
     }
     catch {
-        // Not a NOXA token (getters reverted) — still tradeable if a V3 pool exists.
+        // Not a NOXA token (getters reverted) - still tradeable if a V3 pool exists.
         return { isNoxa: false };
     }
 }
@@ -287,7 +287,7 @@ async function quoteBestFee(wallet, tokenIn, tokenOut, amountIn, fees) {
     let lastErr;
     for (const fee of fees) {
         try {
-            // QuoterV2 quote fns are non-view (revert-to-return) — must use staticCall.
+            // QuoterV2 quote fns are non-view (revert-to-return) - must use staticCall.
             const res = await quoter.quoteExactInputSingle.staticCall({
                 tokenIn,
                 tokenOut,