@xona-labs/xpay 0.2.24 → 0.2.26

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,

package/dist/transfer/index.d.ts

@@ -1,11 +1,11 @@
 /**
- * Direct SPL / ERC-20 transfer — no x402, no provider, just send funds.
+ * Direct SPL / ERC-20 transfer - no x402, no provider, just send funds.
  *
  * Goes through the same guardrail as `use()` so a compromised CLI / agent
  * can't drain the wallet past the configured caps.
  *
  * Solana: any SPL token by symbol (USDC, BONK, JUP, …) or raw mint address.
- * EVM:    the network's stablecoin only — USDC, or USDT0 on Stable (other
+ * EVM:    the network's stablecoin only - USDC, or USDT0 on Stable (other
  *         ERC-20 addresses can be added to EVM_STABLECOIN as needed).
  */
 import type { Network } from "../types.js";
@@ -17,7 +17,7 @@ export interface SplTokenInfo {
     decimals: number;
     symbol: string;
 }
-/** Well-known Solana SPL tokens — symbol (uppercase) → info. */
+/** Well-known Solana SPL tokens - symbol (uppercase) → info. */
 export declare const SOLANA_TOKENS: Record<string, SplTokenInfo>;
 /** Symbols users can name in CLI / MCP. */
 export declare const KNOWN_SOLANA_SYMBOLS: string[];
@@ -31,7 +31,7 @@ export interface TransferArgs {
     /**
      * Token to transfer.
      * - Solana: symbol ("USDC", "BONK", "JUP", …) or raw mint address.
-     * - EVM: only the network's stablecoin — "USDC", or "USDT0" on Stable.
+     * - EVM: only the network's stablecoin - "USDC", or "USDT0" on Stable.
      * Defaults to the network's stablecoin.
      */
     token?: string;

package/dist/transfer/index.js

@@ -1,17 +1,17 @@
 /**
- * Direct SPL / ERC-20 transfer — no x402, no provider, just send funds.
+ * Direct SPL / ERC-20 transfer - no x402, no provider, just send funds.
  *
  * Goes through the same guardrail as `use()` so a compromised CLI / agent
  * can't drain the wallet past the configured caps.
  *
  * Solana: any SPL token by symbol (USDC, BONK, JUP, …) or raw mint address.
- * EVM:    the network's stablecoin only — USDC, or USDT0 on Stable (other
+ * EVM:    the network's stablecoin only - USDC, or USDT0 on Stable (other
  *         ERC-20 addresses can be added to EVM_STABLECOIN as needed).
  */
 import { Connection, PublicKey, SystemProgram, Transaction, LAMPORTS_PER_SOL, } from "@solana/web3.js";
 import { getMint } from "@solana/spl-token";
 import { magicBlockPrivateTransfer } from "../magicblock/client.js";
-/** Well-known Solana SPL tokens — symbol (uppercase) → info. */
+/** Well-known Solana SPL tokens - symbol (uppercase) → info. */
 export const SOLANA_TOKENS = {
     USDC: { mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", decimals: 6, symbol: "USDC" },
     USDT: { mint: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB", decimals: 6, symbol: "USDT" },
@@ -58,7 +58,7 @@ export async function transfer(args) {
             throw new Error(`transfer: no stablecoin registered for EVM network "${network}"`);
         }
         // Accept the network's own symbol, plus the generic "USDC"/"USDT" the
-        // caller may default to — on Stable they all mean USDT0.
+        // caller may default to - on Stable they all mean USDT0.
         const tokenSymbol = (args.token ?? stablecoin.symbol).toUpperCase();
         const aliases = network === "stable" ? ["USDT0", "USDT", "USDC"] : ["USDC"];
         if (!aliases.includes(tokenSymbol)) {
@@ -83,7 +83,7 @@ export async function transfer(args) {
     if (tokenKey === "SOL") {
         if (args.private) {
             throw new Error(`transfer: native SOL is not supported by MagicBlock PER (SPL tokens only). ` +
-                `Use "wSOL" instead — it goes through the PER and settles as wrapped SOL on the other end.`);
+                `Use "wSOL" instead - it goes through the PER and settles as wrapped SOL on the other end.`);
         }
         return transferNativeSol(args);
     }
@@ -134,7 +134,7 @@ async function transferNativeSol(args) {
     const rpc = process.env.XPAY_SOLANA_RPC ?? "https://solana-mainnet.g.alchemy.com/v2/Ug5mqBVIbSHoa8ZHgTUSJ";
     const connection = new Connection(rpc, "confirmed");
     // Reconstruct keypair from the signer's signMessage so we can sign the tx.
-    // rawSolanaSigner keeps the keypair internally — we access it by signing a
+    // rawSolanaSigner keeps the keypair internally - we access it by signing a
     // known message and rebuilding. Instead, we use a lower-level approach:
     // delegate to signer.pay() with a synthetic SOL "requirement" if it supports
     // it, otherwise build the SystemProgram.transfer tx ourselves.
@@ -173,7 +173,7 @@ async function resolveSolanaToken(token) {
     // Reverse lookup by mint address.
     if (BY_MINT[token])
         return BY_MINT[token];
-    // Looks like a base58 mint address — fetch from chain.
+    // Looks like a base58 mint address - fetch from chain.
     if (/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(token)) {
         const rpc = process.env.XPAY_SOLANA_RPC ?? "https://solana-mainnet.g.alchemy.com/v2/Ug5mqBVIbSHoa8ZHgTUSJ";
         try {
@@ -203,7 +203,7 @@ function resolveNetwork(args) {
         // Auto-detect only across networks the profile actually opted into.
         // Robinhood and Stable signers are always registered (see
         // signersFromProfile), so keying off `wallet.has()` alone would make every
-        // EVM transfer ambiguous — reach those two with an explicit --network
+        // EVM transfer ambiguous - reach those two with an explicit --network
         // unless they're in the profile's `networks`.
         const evm = args.wallet.networks.filter((n) => EVM_NETWORKS.includes(n) && args.wallet.has(n));
         if (evm.length === 0)

package/dist/types.d.ts

@@ -8,9 +8,9 @@
 import { z } from "zod";
 /** A network slug. Keep this open-ended so new chains can be added without an SDK release. */
 export type Network = "solana" | "base" | "ethereum" | "arbitrum" | "optimism"
-/** Robinhood Chain (Arbitrum Orbit L2, eip155:4663) — ETH-native. */
+/** Robinhood Chain (Arbitrum Orbit L2, eip155:4663) - ETH-native. */
  | "robinhood"
-/** Stable (eip155:988) — Tether/Bitfinex payments L1, settles USDT0. */
+/** Stable (eip155:988) - Tether/Bitfinex payments L1, settles USDT0. */
  | "stable" | (string & {});
 /**
  * One payment option attached to a {@link Resource}.
@@ -189,7 +189,7 @@ export interface PlatformFeeResult {
     txSig?: string;
     /** Whether the fee was successfully charged. */
     success: boolean;
-    /** Error message if the fee charge failed (non-fatal — the use result is still returned). */
+    /** Error message if the fee charge failed (non-fatal - the use result is still returned). */
     error?: string;
 }
 /** Result returned by {@link XPay.use}. */
@@ -218,7 +218,7 @@ export interface UseResult {
 }
 /** Options passed to {@link XPay.discover}. */
 export interface DiscoverOptions {
-    /** Free-text query — matched against resource URL, metadata, and category. */
+    /** Free-text query - matched against resource URL, metadata, and category. */
     query?: string;
     /** Restrict to specific networks. Defaults to all configured. */
     networks?: Network[];
@@ -246,7 +246,7 @@ export interface Signer {
     address: string;
     /**
      * Sign an arbitrary message (used for x402 payment authorization payloads).
-     * The exact bytes signed depend on the network — see implementations.
+     * The exact bytes signed depend on the network - see implementations.
      */
     signMessage(message: Uint8Array): Promise<Uint8Array>;
     /**
@@ -280,7 +280,7 @@ export interface Signer {
      * Optional (EVM signers): sign an EIP-712 typed-data payload and return the
      * hex signature. When present, `use()` pays eip155 endpoints gaslessly via
      * a signed EIP-3009 `transferWithAuthorization` (the facilitator broadcasts
-     * and covers gas — no native ETH needed); when absent, it falls back to the
+     * and covers gas - no native ETH needed); when absent, it falls back to the
      * legacy `pay()` (broadcasts an ERC-20 transfer, wallet pays its own gas).
      */
     signEvmTypedData?(typedData: {
@@ -295,7 +295,7 @@ export interface Signer {
      * Optional (EVM signers): return the underlying ethers `Wallet` (connected to
      * a provider) so higher-level flows like on-chain DEX trades can read chain
      * state and broadcast arbitrary contract calls (swaps, approvals). Typed
-     * `unknown` to keep ethers out of the core type surface — callers cast it.
+     * `unknown` to keep ethers out of the core type surface - callers cast it.
      * Mirrors {@link Signer.getKitSigner}. Implemented by `rawEvmSigner`.
      */
     getEvmWallet?(): unknown;

package/dist/use/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Use — call a paid resource, handling x402 payment end-to-end.
+ * Use - call a paid resource, handling x402 payment end-to-end.
  *
  * Two modes:
  *  - **Catalog mode** (`resource` has `accepts[]`): we pick a requirement up
@@ -21,13 +21,13 @@ export interface UseArgs {
     guardrail: Guardrail;
     body?: unknown;
     headers?: Record<string, string>;
-    /** AgenC hire settings (RPC, review window) — used only for AgenC resources. */
+    /** AgenC hire settings (RPC, review window) - used only for AgenC resources. */
     agenc?: AgencHireConfig;
 }
 export declare function use(args: UseArgs): Promise<UseResult>;
 /**
  * Convenience: call any URL with x402 support. Agents can use this when they
- * have a URL but no catalog entry — e.g. crawled from the web.
+ * have a URL but no catalog entry - e.g. crawled from the web.
  */
 export interface UseByUrlArgs {
     url: string;
@@ -40,8 +40,8 @@ export interface UseByUrlArgs {
 export declare function useByUrl(args: UseByUrlArgs): Promise<UseResult>;
 /**
  * Charge the xPay platform fee ($0.01 USDC) via the x402 endpoint.
- * Fires after every successful `use` call (including AgenC hires — exported
- * for the agenc module). Non-fatal — a failure is reported in
+ * Fires after every successful `use` call (including AgenC hires - exported
+ * for the agenc module). Non-fatal - a failure is reported in
  * `platformFee.error` rather than throwing.
  */
 export declare function chargePlatformFee(wallet: Wallet): Promise<PlatformFeeResult>;

package/dist/use/index.js

@@ -1,5 +1,5 @@
 /**
- * Use — call a paid resource, handling x402 payment end-to-end.
+ * Use - call a paid resource, handling x402 payment end-to-end.
  *
  * Two modes:
  *  - **Catalog mode** (`resource` has `accepts[]`): we pick a requirement up
@@ -16,21 +16,21 @@ import { buildSvmPaymentHeader, isSvmNetwork } from "../x402/svm-payment.js";
 import { buildEvmPaymentHeader, hasEvmDomainParams, isEvmNetwork } from "../x402/evm-payment.js";
 import { isAgencResource } from "../agenc/api.js";
 export async function use(args) {
-    // AgenC listings are not HTTP resources — payment is an on-chain escrow
+    // AgenC listings are not HTTP resources - payment is an on-chain escrow
     // hire, so branch before any x402 catalog / live-challenge logic.
     if (isAgencResource(args.resource)) {
         const { useAgencHire } = await import("../agenc/hire.js");
         return useAgencHire(args);
     }
     // If we have accepts up front, pick the network we can actually pay on
-    // (balance-aware) and take the fast path — unless the chosen option is
+    // (balance-aware) and take the fast path - unless the chosen option is
     // missing fields that only a live 402 challenge carries.
     if (args.resource.accepts.length > 0) {
         const req = await args.wallet.pickRequirementByBalance(args.resource.accepts);
         if (req) {
             if (!reqNeedsLiveChallenge(args, req))
                 return useWithRequirements(args, req);
-            // Chosen option needs a live 402 (SVM v2 missing feePayer) — fall through.
+            // Chosen option needs a live 402 (SVM v2 missing feePayer) - fall through.
         }
         else if (args.wallet.pickRequirement(args.resource.accepts)) {
             // We can sign for an option but no payable network has the funds.
@@ -41,7 +41,7 @@ export async function use(args) {
     return useWithLiveChallenge(args);
 }
 /**
- * Catalog entries are snapshots — they carry payTo/asset/amount but not the
+ * Catalog entries are snapshots - they carry payTo/asset/amount but not the
  * per-facilitator settlement fields that only a fresh 402 challenge provides.
  * SVM v2 settlement needs `extra.feePayer` (the facilitator's fee-payer
  * pubkey); gasless EVM settlement needs the asset's EIP-712 domain params
@@ -75,7 +75,7 @@ export async function useByUrl(args) {
     });
 }
 async function useWithRequirements(args, req) {
-    // Guardrail runs *before* signing — this is the security boundary.
+    // Guardrail runs *before* signing - this is the security boundary.
     await args.guardrail.check({ resource: args.resource, requirement: req });
     const settled = await settle(args, req, args.resource.x402Version ?? 1);
     const res = await callResource(args, settled.header);
@@ -87,11 +87,11 @@ async function useWithLiveChallenge(args) {
     // Step 1: probe without payment.
     const probe = await callResource(args, undefined);
     if (probe.res.status !== 402) {
-        // No payment required — return the probe response as-is. (Useful when a
+        // No payment required - return the probe response as-is. (Useful when a
         // resource later becomes free or for sanity checks.)
         return finalize(probe, "unknown", "0");
     }
-    // Step 2: parse the 402 challenge — may live in the body OR a response header.
+    // Step 2: parse the 402 challenge - may live in the body OR a response header.
     const { accepts: reqs } = extractRequirements(probe.res.headers, probe.data);
     if (reqs.length === 0) {
         throw new Error(`xpay.use: ${args.resource.resource} returned 402 but no parseable accepts[] in body or headers`);
@@ -117,13 +117,13 @@ async function useWithLiveChallenge(args) {
  * value plus accounting fields. Picks the right encoding by network:
  *
  *   SVM (solana / solana:*) + signer has getKitSigner →
- *     canonical x402 v2 — sign-but-don't-broadcast, header carries the
+ *     canonical x402 v2 - sign-but-don't-broadcast, header carries the
  *     signed tx, facilitator settles. Returns header only (no txSig until
  *     the upstream call comes back).
  *
  *   EVM (eip155:* / base / ethereum / …) + signer has signEvmTypedData +
  *   requirement carries EIP-712 domain params →
- *     canonical x402 v2 — gasless EIP-3009 transferWithAuthorization
+ *     canonical x402 v2 - gasless EIP-3009 transferWithAuthorization
  *     signature in the header, facilitator broadcasts and pays gas.
  *
  *   Anything else (legacy v1) →
@@ -142,7 +142,7 @@ async function settle(args, req, x402Version) {
         });
         return { header, network };
     }
-    // Gasless EVM v2 — sign an EIP-3009 transferWithAuthorization, facilitator
+    // Gasless EVM v2 - sign an EIP-3009 transferWithAuthorization, facilitator
     // broadcasts and pays gas. Needs the EIP-712 domain params from the 402
     // challenge; catalog snapshots without them were already routed through the
     // live flow by reqNeedsLiveChallenge().
@@ -157,7 +157,7 @@ async function settle(args, req, x402Version) {
         });
         return { header, network };
     }
-    // Legacy path — sign + broadcast on our side, send txSig in the header.
+    // Legacy path - sign + broadcast on our side, send txSig in the header.
     const txSig = await signer.pay(req);
     return { header: paymentHeader(req, txSig, x402Version), network, txSig };
 }
@@ -168,7 +168,7 @@ async function callResource(args, paymentHeader) {
     };
     if (paymentHeader) {
         // Most x402 servers read `X-PAYMENT`; some (e.g. Nansen) read
-        // `Payment-Signature`. The payload is identical, so send both — servers
+        // `Payment-Signature`. The payload is identical, so send both - servers
         // ignore the header name they don't recognise.
         headers["x-payment"] = paymentHeader;
         headers["payment-signature"] = paymentHeader;
@@ -195,7 +195,7 @@ async function callResource(args, paymentHeader) {
 }
 function finalize(raw, network, amountPaid, txSig) {
     if (!raw.res.ok) {
-        throw new Error(`xpay.use: ${raw.res.status} ${raw.res.statusText} — ${typeof raw.data === "string" ? raw.data : JSON.stringify(raw.data)}`);
+        throw new Error(`xpay.use: ${raw.res.status} ${raw.res.statusText} - ${typeof raw.data === "string" ? raw.data : JSON.stringify(raw.data)}`);
     }
     // For SVM v2 calls the facilitator broadcasts and echoes settlement details
     // in the `PAYMENT-RESPONSE` header. If present, prefer its signature over
@@ -233,8 +233,8 @@ const PLATFORM_FEE_URL = "https://api.xona-agent.com/platform-fee";
 const PLATFORM_FEE_AMOUNT = 0.01;
 /**
  * Charge the xPay platform fee ($0.01 USDC) via the x402 endpoint.
- * Fires after every successful `use` call (including AgenC hires — exported
- * for the agenc module). Non-fatal — a failure is reported in
+ * Fires after every successful `use` call (including AgenC hires - exported
+ * for the agenc module). Non-fatal - a failure is reported in
  * `platformFee.error` rather than throwing.
  */
 export async function chargePlatformFee(wallet) {
@@ -262,7 +262,7 @@ export async function chargePlatformFee(wallet) {
         if (!req) {
             return { amount: PLATFORM_FEE_AMOUNT, success: false, error: `platform-fee: wallet has no signer for ${reqs.map(r => r.network).join(", ")}` };
         }
-        // Pay and retry — use a minimal UseArgs stub (no guardrail needed for our own fee).
+        // Pay and retry - use a minimal UseArgs stub (no guardrail needed for our own fee).
         const network = normalizeNetwork(req.network);
         const signer = wallet.signer(network);
         let header;
@@ -302,13 +302,13 @@ export async function chargePlatformFee(wallet) {
 /**
  * Build a clear "you can't afford this" error listing the USDC balance on each
  * network the wallet could have paid on. Raised only when every payable option
- * is underfunded — better than attempting a doomed payment and surfacing a raw
+ * is underfunded - better than attempting a doomed payment and surfacing a raw
  * 402 from the upstream provider.
  */
 async function insufficientBalanceError(reqs, wallet) {
     const nets = [...new Set(reqs.map((r) => normalizeNetwork(r.network)).filter((n) => wallet.has(n)))];
     const parts = await Promise.all(nets.map(async (n) => `${n} $${(await wallet.balance(n).catch(() => 0)).toFixed(2)}`));
-    return new Error(`xpay.use: insufficient USDC balance to pay on any funded network — ${parts.join(", ")}. ` +
+    return new Error(`xpay.use: insufficient USDC balance to pay on any funded network - ${parts.join(", ")}. ` +
         `Fund one of these and retry.`);
 }
 function normalizeNetwork(raw) {
@@ -324,7 +324,7 @@ function normalizeNetwork(raw) {
         return "robinhood";
     if (raw === "eip155:988")
         return "stable";
-    // Solana CAIP — any `solana:<genesis>` form collapses to our "solana" slug.
+    // Solana CAIP - any `solana:<genesis>` form collapses to our "solana" slug.
     if (raw === "solana" || raw.startsWith("solana:") || raw.startsWith("solana-"))
         return "solana";
     return raw;

package/dist/wallet/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Multi-network wallet. Thin facade over per-network {@link Signer}s.
  *
- * The wallet doesn't hold keys — signers do. This module just exposes a
+ * The wallet doesn't hold keys - signers do. This module just exposes a
  * unified view (addresses, balances) and lets callers pick which network to
  * use for a given payment.
  */
@@ -28,7 +28,7 @@ export interface Wallet {
     pickRequirement(reqs: PaymentRequirement[]): PaymentRequirement | undefined;
     /**
      * Balance-aware picker. Among requirements we have a signer for, prefer the
-     * first (in listed order) whose wallet balance covers the cost — so a $0
+     * first (in listed order) whose wallet balance covers the cost - so a $0
      * Base wallet falls through to a funded Solana one. When there are multiple
      * payable networks but none can cover the cost, returns `undefined` so the
      * caller can raise a clear "insufficient balance" error instead of attempting

package/dist/wallet/index.js

@@ -1,7 +1,7 @@
 /**
  * Multi-network wallet. Thin facade over per-network {@link Signer}s.
  *
- * The wallet doesn't hold keys — signers do. This module just exposes a
+ * The wallet doesn't hold keys - signers do. This module just exposes a
  * unified view (addresses, balances) and lets callers pick which network to
  * use for a given payment.
  */
@@ -18,7 +18,7 @@ export function createWallet(opts) {
     function matchNetwork(raw) {
         if (signers[raw])
             return raw;
-        // Solana CAIP — `solana:<genesis-hash>` (mainnet/devnet/testnet) → "solana".
+        // Solana CAIP - `solana:<genesis-hash>` (mainnet/devnet/testnet) → "solana".
         if ((raw === "solana" || raw.startsWith("solana:") || raw.startsWith("solana-")) && signers["solana"]) {
             return "solana";
         }
@@ -71,7 +71,7 @@ export function createWallet(opts) {
                 return candidates[0];
             // Multiple payable networks: read each balance in parallel and pick the
             // first (listed order) that covers the cost. Compare assumes USDC
-            // (6 decimals) — the asset for virtually all x402 calls.
+            // (6 decimals) - the asset for virtually all x402 calls.
             const scored = await Promise.all(candidates.map(async (req) => {
                 const net = matchNetwork(req.network);
                 const bal = await balanceOf(net);