@elisym/sdk 0.10.0 → 0.10.2

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { Address, TransactionSigner, Rpc, SolanaRpcApi } from '@solana/kit';
 import { Filter, Event } from 'nostr-tools';
-import { A as Asset } from './assets-CMf-v55Z.cjs';
-export { C as Chain, K as KNOWN_ASSETS, N as NATIVE_SOL, U as USDC_SOLANA_DEVNET, a as assetByKey, b as assetKey, f as formatAssetAmount, p as parseAssetAmount, r as resolveAssetFromPaymentRequest, c as resolveKnownAsset } from './assets-CMf-v55Z.cjs';
+import { A as Asset } from './assets-C-nzSYD4.cjs';
+export { C as Chain, K as KNOWN_ASSETS, N as NATIVE_SOL, U as USDC_SOLANA_DEVNET, a as assetByKey, b as assetKey, f as formatAssetAmount, p as parseAssetAmount, r as resolveAssetFromPaymentRequest, c as resolveKnownAsset } from './assets-C-nzSYD4.cjs';
 import { z } from 'zod';
 export { G as GlobalConfig, a as GlobalConfigSchema, S as SessionSpendLimitEntry, b as SessionSpendLimitEntrySchema } from './global-schema-CddHP2nk.cjs';
 
@@ -97,6 +97,13 @@ interface Job {
     amount?: number;
     txHash?: string;
     createdAt: number;
+    /**
+     * Payment asset, derived from the `payment-required` feedback's embedded
+     * payment request when present. Undefined means either no payment-required
+     * feedback was observed for this job, or the embedded request was missing
+     * an `asset` field (treated as native SOL by callers).
+     */
+    asset?: PaymentAssetRef;
 }
 interface SubmitJobOptions {
     /** Job input text. Sent unencrypted if providerPubkey is not set. */
@@ -349,10 +356,7 @@ declare function computeRankKey(agent: Agent): RankKey;
 declare function compareAgentsByRank(a: Agent, b: Agent): number;
 declare class DiscoveryService {
     private pool;
-    private defaultRpc?;
-    constructor(pool: NostrPool, defaultRpc?: Rpc<SolanaRpcApi> | undefined);
-    /** Configure the Solana RPC used for on-chain payment verification in `fetchAgents`. */
-    setRpc(rpc: Rpc<SolanaRpcApi> | undefined): void;
+    constructor(pool: NostrPool);
     /** Count elisym agents (kind:31990 with "elisym" tag). */
     fetchAllAgentCount(): Promise<number>;
     /**
@@ -371,20 +375,26 @@ declare class DiscoveryService {
     /** Enrich agents with kind:0 metadata (name, picture, about). Mutates in place and returns the same array. */
     enrichWithMetadata(agents: Agent[]): Promise<Agent[]>;
     /**
-     * Fetch elisym agents filtered by network, ranked by verified paid-job recency.
+     * Fetch elisym agents filtered by network, ranked by paid-job recency and
+     * positive-feedback rate.
      *
      * Ranking algorithm:
-     * 1. Bucket each agent into 1-minute slots by `lastPaidJobAt` (last on-chain
-     *    verified payment). Cold-start agents (no verified paid job) go into a
+     * 1. Bucket each agent into 1-minute slots by `lastPaidJobAt` (newest
+     *    `payment-completed` feedback timestamp). Cold-start agents go into a
      *    sentinel bucket below all populated buckets.
      * 2. Within a bucket, sort by positive review rate descending.
      * 3. Tiebreak by raw `lastPaidJobAt`, then `lastSeen` (NIP-89 freshness).
      *
-     * On-chain verification uses {@link verifyJobPaymentQuick} - one-shot, cached.
-     * If `rpc` is not configured, all agents fall through to cold-start and order
-     * is determined by `lastSeen` only.
+     * NOTE: We trust the `payment-completed` feedback timestamp directly; we do
+     * not verify the embedded `tx` signature on-chain. Public Solana devnet RPC
+     * rate-limits trivially exceed what discovery needs (N agents * up-to-5
+     * candidates), and the resulting 429s blocked discovery entirely. This
+     * means a malicious customer can publish a fake `payment-completed` to lift
+     * an agent's ranking. Acceptable trade-off for devnet / MVP; tighten via
+     * recipient-tied checks when the network moves to mainnet with a paid RPC
+     * provider.
      */
-    fetchAgents(network?: Network, limit?: number, rpcOverride?: Rpc<SolanaRpcApi>): Promise<Agent[]>;
+    fetchAgents(network?: Network, limit?: number): Promise<Agent[]>;
     /**
      * Publish a capability card (kind:31990) as a provider.
      * Solana address is validated for Base58 format only - full decode
@@ -528,11 +538,6 @@ interface ElisymClientFullConfig extends ElisymClientConfig {
     payment?: PaymentStrategy;
     /** Custom upload URL for file uploads (defaults to nostr.build). */
     uploadUrl?: string;
-    /**
-     * Solana RPC used by `discovery.fetchAgents` for on-chain payment verification.
-     * If omitted, ranking falls back to NIP-89 freshness only (no paid-job promotion).
-     */
-    rpc?: Rpc<SolanaRpcApi>;
 }
 declare class ElisymClient {
     readonly pool: NostrPool;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Address, TransactionSigner, Rpc, SolanaRpcApi } from '@solana/kit';
 import { Filter, Event } from 'nostr-tools';
-import { A as Asset } from './assets-CMf-v55Z.js';
-export { C as Chain, K as KNOWN_ASSETS, N as NATIVE_SOL, U as USDC_SOLANA_DEVNET, a as assetByKey, b as assetKey, f as formatAssetAmount, p as parseAssetAmount, r as resolveAssetFromPaymentRequest, c as resolveKnownAsset } from './assets-CMf-v55Z.js';
+import { A as Asset } from './assets-C-nzSYD4.js';
+export { C as Chain, K as KNOWN_ASSETS, N as NATIVE_SOL, U as USDC_SOLANA_DEVNET, a as assetByKey, b as assetKey, f as formatAssetAmount, p as parseAssetAmount, r as resolveAssetFromPaymentRequest, c as resolveKnownAsset } from './assets-C-nzSYD4.js';
 import { z } from 'zod';
 export { G as GlobalConfig, a as GlobalConfigSchema, S as SessionSpendLimitEntry, b as SessionSpendLimitEntrySchema } from './global-schema-CddHP2nk.js';
 
@@ -97,6 +97,13 @@ interface Job {
     amount?: number;
     txHash?: string;
     createdAt: number;
+    /**
+     * Payment asset, derived from the `payment-required` feedback's embedded
+     * payment request when present. Undefined means either no payment-required
+     * feedback was observed for this job, or the embedded request was missing
+     * an `asset` field (treated as native SOL by callers).
+     */
+    asset?: PaymentAssetRef;
 }
 interface SubmitJobOptions {
     /** Job input text. Sent unencrypted if providerPubkey is not set. */
@@ -349,10 +356,7 @@ declare function computeRankKey(agent: Agent): RankKey;
 declare function compareAgentsByRank(a: Agent, b: Agent): number;
 declare class DiscoveryService {
     private pool;
-    private defaultRpc?;
-    constructor(pool: NostrPool, defaultRpc?: Rpc<SolanaRpcApi> | undefined);
-    /** Configure the Solana RPC used for on-chain payment verification in `fetchAgents`. */
-    setRpc(rpc: Rpc<SolanaRpcApi> | undefined): void;
+    constructor(pool: NostrPool);
     /** Count elisym agents (kind:31990 with "elisym" tag). */
     fetchAllAgentCount(): Promise<number>;
     /**
@@ -371,20 +375,26 @@ declare class DiscoveryService {
     /** Enrich agents with kind:0 metadata (name, picture, about). Mutates in place and returns the same array. */
     enrichWithMetadata(agents: Agent[]): Promise<Agent[]>;
     /**
-     * Fetch elisym agents filtered by network, ranked by verified paid-job recency.
+     * Fetch elisym agents filtered by network, ranked by paid-job recency and
+     * positive-feedback rate.
      *
      * Ranking algorithm:
-     * 1. Bucket each agent into 1-minute slots by `lastPaidJobAt` (last on-chain
-     *    verified payment). Cold-start agents (no verified paid job) go into a
+     * 1. Bucket each agent into 1-minute slots by `lastPaidJobAt` (newest
+     *    `payment-completed` feedback timestamp). Cold-start agents go into a
      *    sentinel bucket below all populated buckets.
      * 2. Within a bucket, sort by positive review rate descending.
      * 3. Tiebreak by raw `lastPaidJobAt`, then `lastSeen` (NIP-89 freshness).
      *
-     * On-chain verification uses {@link verifyJobPaymentQuick} - one-shot, cached.
-     * If `rpc` is not configured, all agents fall through to cold-start and order
-     * is determined by `lastSeen` only.
+     * NOTE: We trust the `payment-completed` feedback timestamp directly; we do
+     * not verify the embedded `tx` signature on-chain. Public Solana devnet RPC
+     * rate-limits trivially exceed what discovery needs (N agents * up-to-5
+     * candidates), and the resulting 429s blocked discovery entirely. This
+     * means a malicious customer can publish a fake `payment-completed` to lift
+     * an agent's ranking. Acceptable trade-off for devnet / MVP; tighten via
+     * recipient-tied checks when the network moves to mainnet with a paid RPC
+     * provider.
      */
-    fetchAgents(network?: Network, limit?: number, rpcOverride?: Rpc<SolanaRpcApi>): Promise<Agent[]>;
+    fetchAgents(network?: Network, limit?: number): Promise<Agent[]>;
     /**
      * Publish a capability card (kind:31990) as a provider.
      * Solana address is validated for Base58 format only - full decode
@@ -528,11 +538,6 @@ interface ElisymClientFullConfig extends ElisymClientConfig {
     payment?: PaymentStrategy;
     /** Custom upload URL for file uploads (defaults to nostr.build). */
     uploadUrl?: string;
-    /**
-     * Solana RPC used by `discovery.fetchAgents` for on-chain payment verification.
-     * If omitted, ranking falls back to NIP-89 freshness only (no paid-job promotion).
-     */
-    rpc?: Rpc<SolanaRpcApi>;
 }
 declare class ElisymClient {
     readonly pool: NostrPool;

package/dist/index.js

@@ -1,7 +1,7 @@
 import { getTransferSolInstruction } from '@solana-program/system';
 import { findAssociatedTokenPda, TOKEN_PROGRAM_ADDRESS, getCreateAssociatedTokenIdempotentInstruction, ASSOCIATED_TOKEN_PROGRAM_ADDRESS, getTransferCheckedInstruction } from '@solana-program/token';
 import { pipe, createTransactionMessage, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, setTransactionMessageComputeUnitLimit, setTransactionMessageComputeUnitPrice, appendTransactionMessageInstructions, signTransactionMessageWithSigners, address, AccountRole, isAddress, getProgramDerivedAddress, assertAccountExists, getAddressDecoder, fetchEncodedAccount, decodeAccount, getStructDecoder, fixDecoderSize, getBytesDecoder, getU8Decoder, getOptionDecoder, getU16Decoder, getBooleanDecoder, getI64Decoder } from '@solana/kit';
-import Decimal2 from 'decimal.js-light';
+import Decimal3 from 'decimal.js-light';
 import { z } from 'zod';
 import { verifyEvent, finalizeEvent, getPublicKey, nip19, generateSecretKey, SimplePool } from 'nostr-tools';
 import * as nip44 from 'nostr-tools/nip44';
@@ -151,8 +151,6 @@ async function getProtocolConfig(rpc, programId, options) {
     );
   }
 }
-
-// src/payment/assets.ts
 var NATIVE_SOL = {
   chain: "solana",
   token: "sol",
@@ -233,16 +231,10 @@ function parseAssetAmount(asset, human) {
   }
   return raw;
 }
+var FormatDecimal = Decimal3.clone({ toExpNeg: -100, toExpPos: 100, precision: 50 });
 function formatAssetAmount(asset, raw) {
-  const sign = raw < 0n ? "-" : "";
-  const abs = raw < 0n ? -raw : raw;
-  const unit = 10n ** BigInt(asset.decimals);
-  const whole = abs / unit;
-  const frac = abs % unit;
-  if (asset.decimals === 0) {
-    return `${sign}${whole} ${asset.symbol}`;
-  }
-  return `${sign}${whole}.${frac.toString().padStart(asset.decimals, "0")} ${asset.symbol}`;
+  const value = new FormatDecimal(raw.toString()).div(new FormatDecimal(10).pow(asset.decimals));
+  return `${value.toString()} ${asset.symbol}`;
 }
 var BPS_DENOMINATOR = 1e4;
 function assertLamports(value, field) {
@@ -260,7 +252,7 @@ function calculateProtocolFee(amount, feeBps) {
   if (amount === 0 || feeBps === 0) {
     return 0;
   }
-  return new Decimal2(amount).mul(feeBps).div(BPS_DENOMINATOR).toDecimalPlaces(0, Decimal2.ROUND_CEIL).toNumber();
+  return new Decimal3(amount).mul(feeBps).div(BPS_DENOMINATOR).toDecimalPlaces(0, Decimal3.ROUND_CEIL).toNumber();
 }
 function validateExpiry(createdAt, expirySecs) {
   if (!Number.isInteger(createdAt) || createdAt <= 0) {
@@ -994,95 +986,9 @@ async function createPaymentRequestWithOnchainConfig(rpc, programId, recipient,
     options
   );
 }
-var NEGATIVE_CACHE_TTL_MS = 6e4;
-var verifyCache = /* @__PURE__ */ new Map();
-function clearQuickVerifyCache() {
-  verifyCache.clear();
-}
-async function verifyJobPaymentQuick(rpc, txSignature, expectedRecipient) {
-  if (!txSignature) {
-    return { verified: false, txSignature: "", reason: "invalid_input" };
-  }
-  if (!expectedRecipient || !isAddress(expectedRecipient)) {
-    return { verified: false, txSignature, reason: "invalid_input" };
-  }
-  const cacheKey2 = `${txSignature}:${expectedRecipient}`;
-  const cached = verifyCache.get(cacheKey2);
-  if (cached) {
-    if (cached.result.verified) {
-      return cached.result;
-    }
-    if (Date.now() - cached.cachedAt < NEGATIVE_CACHE_TTL_MS) {
-      return cached.result;
-    }
-  }
-  const result = await doVerifyOnce(rpc, txSignature, expectedRecipient);
-  verifyCache.set(cacheKey2, { result, cachedAt: Date.now() });
-  return result;
-}
-async function doVerifyOnce(rpc, txSignature, expectedRecipient) {
-  const sigStr = txSignature;
-  if (!rpc || typeof rpc.getTransaction !== "function") {
-    return { verified: false, txSignature: sigStr, reason: "rpc_error" };
-  }
-  let tx;
-  try {
-    tx = await rpc.getTransaction(txSignature, {
-      commitment: "confirmed",
-      encoding: "json",
-      maxSupportedTransactionVersion: 0
-    }).send();
-  } catch {
-    return { verified: false, txSignature: sigStr, reason: "rpc_error" };
-  }
-  if (!tx) {
-    return { verified: false, txSignature: sigStr, reason: "not_found" };
-  }
-  if (!tx.meta || tx.meta.err) {
-    return { verified: false, txSignature: sigStr, reason: "tx_failed" };
-  }
-  const accountKeys = tx.transaction.message.accountKeys;
-  const recipientStr = expectedRecipient;
-  const recipientIdx = accountKeys.indexOf(recipientStr);
-  if (recipientIdx !== -1) {
-    const preBalances = tx.meta.preBalances;
-    const postBalances = tx.meta.postBalances;
-    if (preBalances && postBalances) {
-      const pre = preBalances[recipientIdx];
-      const post = postBalances[recipientIdx];
-      if (pre !== void 0 && post !== void 0) {
-        const delta = BigInt(post) - BigInt(pre);
-        if (delta > 0n) {
-          return { verified: true, txSignature: sigStr };
-        }
-      }
-    }
-  }
-  const postTokenBalances = tx.meta.postTokenBalances;
-  const preTokenBalances = tx.meta.preTokenBalances;
-  if (postTokenBalances) {
-    for (const post of postTokenBalances) {
-      if (post.owner !== recipientStr) {
-        continue;
-      }
-      const pre = preTokenBalances?.find(
-        (entry) => entry.owner === recipientStr && entry.mint === post.mint
-      );
-      const preAmount = pre ? BigInt(pre.uiTokenAmount.amount) : 0n;
-      const postAmount = BigInt(post.uiTokenAmount.amount);
-      if (postAmount > preAmount) {
-        return { verified: true, txSignature: sigStr };
-      }
-    }
-  }
-  return { verified: false, txSignature: sigStr, reason: "recipient_mismatch" };
-}
-
-// src/services/discovery.ts
 var RANKING_ACTIVITY_WINDOW_SECS = 30 * 24 * 60 * 60;
 var RANKING_BUCKET_SIZE_SECS = 60;
 var COLD_START_BUCKET = -Infinity;
-var MAX_PAID_CANDIDATES_PER_AGENT = 5;
 function toDTag(name) {
   const tag = name.toLowerCase().replace(/[^a-z0-9\s-]/g, (ch) => "_" + ch.charCodeAt(0).toString(16).padStart(2, "0")).replace(/\s+/g, "-").replace(/^-+|-+$/g, "");
   if (!tag) {
@@ -1206,37 +1112,9 @@ function buildAgentsFromEvents(events, network) {
   }
   return agentMap;
 }
-function pickSolanaAddress(agent) {
-  for (const card of agent.cards) {
-    const addr = card.payment?.address;
-    if (card.payment?.chain === "solana" && typeof addr === "string" && addr.length > 0) {
-      return addr;
-    }
-  }
-  return null;
-}
-async function verifyNewestPaidCandidate(rpc, recipient, candidatesNewestFirst) {
-  const settled = await Promise.allSettled(
-    candidatesNewestFirst.map(
-      (candidate) => verifyJobPaymentQuick(rpc, candidate.txSignature, recipient)
-    )
-  );
-  for (let i = 0; i < settled.length; i++) {
-    const entry = settled[i];
-    if (entry?.status === "fulfilled" && entry.value.verified) {
-      return candidatesNewestFirst[i] ?? null;
-    }
-  }
-  return null;
-}
 var DiscoveryService = class {
-  constructor(pool, defaultRpc) {
+  constructor(pool) {
     this.pool = pool;
-    this.defaultRpc = defaultRpc;
-  }
-  /** Configure the Solana RPC used for on-chain payment verification in `fetchAgents`. */
-  setRpc(rpc) {
-    this.defaultRpc = rpc;
   }
   /** Count elisym agents (kind:31990 with "elisym" tag). */
   async fetchAllAgentCount() {
@@ -1325,20 +1203,26 @@ var DiscoveryService = class {
     return agents;
   }
   /**
-   * Fetch elisym agents filtered by network, ranked by verified paid-job recency.
+   * Fetch elisym agents filtered by network, ranked by paid-job recency and
+   * positive-feedback rate.
    *
    * Ranking algorithm:
-   * 1. Bucket each agent into 1-minute slots by `lastPaidJobAt` (last on-chain
-   *    verified payment). Cold-start agents (no verified paid job) go into a
+   * 1. Bucket each agent into 1-minute slots by `lastPaidJobAt` (newest
+   *    `payment-completed` feedback timestamp). Cold-start agents go into a
    *    sentinel bucket below all populated buckets.
    * 2. Within a bucket, sort by positive review rate descending.
    * 3. Tiebreak by raw `lastPaidJobAt`, then `lastSeen` (NIP-89 freshness).
    *
-   * On-chain verification uses {@link verifyJobPaymentQuick} - one-shot, cached.
-   * If `rpc` is not configured, all agents fall through to cold-start and order
-   * is determined by `lastSeen` only.
+   * NOTE: We trust the `payment-completed` feedback timestamp directly; we do
+   * not verify the embedded `tx` signature on-chain. Public Solana devnet RPC
+   * rate-limits trivially exceed what discovery needs (N agents * up-to-5
+   * candidates), and the resulting 429s blocked discovery entirely. This
+   * means a malicious customer can publish a fake `payment-completed` to lift
+   * an agent's ranking. Acceptable trade-off for devnet / MVP; tighten via
+   * recipient-tied checks when the network moves to mainnet with a paid RPC
+   * provider.
    */
-  async fetchAgents(network = "devnet", limit, rpcOverride) {
+  async fetchAgents(network = "devnet", limit) {
     const filter = {
       kinds: [KIND_APP_HANDLER],
       "#t": ["elisym"]
@@ -1387,7 +1271,6 @@ var DiscoveryService = class {
         agent.lastSeen = ev.created_at;
       }
     }
-    const paidCandidates = /* @__PURE__ */ new Map();
     for (const ev of feedbackEvents) {
       if (!verifyEvent(ev)) {
         continue;
@@ -1414,33 +1297,12 @@ var DiscoveryService = class {
       const txTag = ev.tags.find((t) => t[0] === "tx");
       const txSignature = txTag?.[1];
       if (status === "payment-completed" && typeof txSignature === "string" && txSignature) {
-        const list = paidCandidates.get(targetPubkey);
-        const candidate = { txSignature, createdAt: ev.created_at };
-        if (list) {
-          list.push(candidate);
-        } else {
-          paidCandidates.set(targetPubkey, [candidate]);
+        if (!agent.lastPaidJobAt || ev.created_at > agent.lastPaidJobAt) {
+          agent.lastPaidJobAt = ev.created_at;
+          agent.lastPaidJobTx = txSignature;
         }
       }
     }
-    const rpc = rpcOverride ?? this.defaultRpc;
-    if (rpc && paidCandidates.size > 0) {
-      const perAgent = Array.from(paidCandidates.entries()).map(([agentPubkey, list]) => {
-        const agent = agentMap.get(agentPubkey);
-        const recipient = agent ? pickSolanaAddress(agent) : null;
-        if (!agent || !recipient) {
-          return Promise.resolve();
-        }
-        const ordered = [...list].sort((a, b) => b.createdAt - a.createdAt).slice(0, MAX_PAID_CANDIDATES_PER_AGENT);
-        return verifyNewestPaidCandidate(rpc, recipient, ordered).then((winner) => {
-          if (winner) {
-            agent.lastPaidJobAt = winner.createdAt;
-            agent.lastPaidJobTx = winner.txSignature;
-          }
-        });
-      });
-      await Promise.all(perAgent);
-    }
     agents.sort(compareAgentsByRank);
     return agents;
   }
@@ -2140,6 +2002,7 @@ var MarketplaceService = class {
       let status = "processing";
       let amount;
       let txHash;
+      let asset;
       if (result) {
         status = "success";
         const amtTag = result.tags.find((t) => t[0] === "amount");
@@ -2148,9 +2011,18 @@ var MarketplaceService = class {
       const allFeedbacksForReq = feedbacksByRequestId.get(req.id) ?? [];
       for (const fb of allFeedbacksForReq) {
         const txTag = fb.tags.find((t) => t[0] === "tx");
-        if (txTag?.[1]) {
+        if (txTag?.[1] && !txHash) {
           txHash = txTag[1];
-          break;
+        }
+        if (!asset) {
+          const amtTag = fb.tags.find((t) => t[0] === "amount");
+          const requestJson = amtTag?.[2];
+          if (requestJson) {
+            const parsed = parsePaymentRequest(requestJson);
+            if (parsed.ok && parsed.data.asset) {
+              asset = parsed.data.asset;
+            }
+          }
         }
       }
       if (feedback) {
@@ -2179,6 +2051,7 @@ var MarketplaceService = class {
         resultEventId: result?.id,
         amount,
         txHash,
+        asset,
         createdAt: req.created_at
       });
     }
@@ -2789,7 +2662,7 @@ var ElisymClient = class {
   payment;
   constructor(config = {}) {
     this.pool = new NostrPool(config.relays ?? RELAYS);
-    this.discovery = new DiscoveryService(this.pool, config.rpc);
+    this.discovery = new DiscoveryService(this.pool);
     this.marketplace = new MarketplaceService(this.pool);
     this.ping = new PingService(this.pool);
     this.media = new MediaService(config.uploadUrl);
@@ -2917,6 +2790,89 @@ function lamportsToSol(lamports) {
   const frac = lamports % LAMPORTS_PER_SOL2;
   return `${whole}.${frac.toString().padStart(9, "0")}`;
 }
+var NEGATIVE_CACHE_TTL_MS = 6e4;
+var verifyCache = /* @__PURE__ */ new Map();
+function clearQuickVerifyCache() {
+  verifyCache.clear();
+}
+async function verifyJobPaymentQuick(rpc, txSignature, expectedRecipient) {
+  if (!txSignature) {
+    return { verified: false, txSignature: "", reason: "invalid_input" };
+  }
+  if (!expectedRecipient || !isAddress(expectedRecipient)) {
+    return { verified: false, txSignature, reason: "invalid_input" };
+  }
+  const cacheKey2 = `${txSignature}:${expectedRecipient}`;
+  const cached = verifyCache.get(cacheKey2);
+  if (cached) {
+    if (cached.result.verified) {
+      return cached.result;
+    }
+    if (Date.now() - cached.cachedAt < NEGATIVE_CACHE_TTL_MS) {
+      return cached.result;
+    }
+  }
+  const result = await doVerifyOnce(rpc, txSignature, expectedRecipient);
+  verifyCache.set(cacheKey2, { result, cachedAt: Date.now() });
+  return result;
+}
+async function doVerifyOnce(rpc, txSignature, expectedRecipient) {
+  const sigStr = txSignature;
+  if (!rpc || typeof rpc.getTransaction !== "function") {
+    return { verified: false, txSignature: sigStr, reason: "rpc_error" };
+  }
+  let tx;
+  try {
+    tx = await rpc.getTransaction(txSignature, {
+      commitment: "confirmed",
+      encoding: "json",
+      maxSupportedTransactionVersion: 0
+    }).send();
+  } catch {
+    return { verified: false, txSignature: sigStr, reason: "rpc_error" };
+  }
+  if (!tx) {
+    return { verified: false, txSignature: sigStr, reason: "not_found" };
+  }
+  if (!tx.meta || tx.meta.err) {
+    return { verified: false, txSignature: sigStr, reason: "tx_failed" };
+  }
+  const accountKeys = tx.transaction.message.accountKeys;
+  const recipientStr = expectedRecipient;
+  const recipientIdx = accountKeys.indexOf(recipientStr);
+  if (recipientIdx !== -1) {
+    const preBalances = tx.meta.preBalances;
+    const postBalances = tx.meta.postBalances;
+    if (preBalances && postBalances) {
+      const pre = preBalances[recipientIdx];
+      const post = postBalances[recipientIdx];
+      if (pre !== void 0 && post !== void 0) {
+        const delta = BigInt(post) - BigInt(pre);
+        if (delta > 0n) {
+          return { verified: true, txSignature: sigStr };
+        }
+      }
+    }
+  }
+  const postTokenBalances = tx.meta.postTokenBalances;
+  const preTokenBalances = tx.meta.preTokenBalances;
+  if (postTokenBalances) {
+    for (const post of postTokenBalances) {
+      if (post.owner !== recipientStr) {
+        continue;
+      }
+      const pre = preTokenBalances?.find(
+        (entry) => entry.owner === recipientStr && entry.mint === post.mint
+      );
+      const preAmount = pre ? BigInt(pre.uiTokenAmount.amount) : 0n;
+      const postAmount = BigInt(post.uiTokenAmount.amount);
+      if (postAmount > preAmount) {
+        return { verified: true, txSignature: sigStr };
+      }
+    }
+  }
+  return { verified: false, txSignature: sigStr, reason: "recipient_mismatch" };
+}
 var SessionSpendLimitEntrySchema = z.object({
   chain: z.enum(["solana"]),
   token: z.string().min(1).max(16).regex(/^[a-z0-9]+$/, "token must be lowercase alphanumeric"),
@@ -2927,7 +2883,7 @@ var GlobalConfigSchema = z.object({
   session_spend_limits: z.array(SessionSpendLimitEntrySchema).max(16).optional()
 }).strict();
 function formatSol(lamports) {
-  const sol = new Decimal2(lamports).div(LAMPORTS_PER_SOL);
+  const sol = new Decimal3(lamports).div(LAMPORTS_PER_SOL);
   if (sol.gte(1e6)) {
     return `${sol.idiv(1e6)}m SOL`;
   }
@@ -2941,12 +2897,12 @@ function compactSol(sol) {
     return "0";
   }
   if (sol.gte(1e3)) {
-    return sol.toDecimalPlaces(0, Decimal2.ROUND_FLOOR).toString();
+    return sol.toDecimalPlaces(0, Decimal3.ROUND_FLOOR).toString();
   }
   const maxFrac = 9;
   for (let d = 1; d <= maxFrac; d++) {
     const s = sol.toFixed(d);
-    if (new Decimal2(s).eq(sol)) {
+    if (new Decimal3(s).eq(sol)) {
       return s.replace(/0+$/, "").replace(/\.$/, "");
     }
   }