keyring-agent-core 0.1.0 → 0.2.0

package/dist/tools/builtin/wallet-action/SendTokenTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendTokenTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet-action/SendTokenTool.ts"],"names":[],"mappings":"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"}

package/dist/tools/builtin/wallet-action/SwapTokenTool.d.ts

@@ -0,0 +1,247 @@
+import { BaseTool } from '../../BaseTool';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+import type { ToolKind, ToolParameter, ToolResult, UIPayload, UserContext } from '../../../types';
+/**
+ * Tool: open-swap-token-form
+ *
+ * A STANDALONE wallet-action tool (NOT a `BaseWalletActionTool`), built as the
+ * mirror of {@link BuyTokenTool}: it does the quote + approval work itself and
+ * ships a custom `SwapTokenConfirmTx` UI payload the FE executes directly. That's
+ * why `swap_token` is intentionally NOT a member of `WalletActionType`.
+ *
+ * The defining difference from BUY: the SOURCE is a token the user ALREADY HOLDS.
+ * Buy starts from a destination ("buy PEPE") and asks which wallet token to pay
+ * with; swap starts from the user's own token ("swap USDC") and asks what to
+ * receive. The source is therefore always balance-checked — we never quote a
+ * swap the user can't fund.
+ *
+ *   - "swap usdc to usdt" → from = USDC (held), to = USDT.
+ *   - "swap usdc"         → from = USDC (held); destination unknown ⇒ trending
+ *                           picker so the user picks what to receive.
+ *   - "swap"              → nothing named ⇒ source picker built from the wallet's
+ *                           own holdings so the user picks what to swap FROM.
+ *
+ * Branches, picked deterministically from the args:
+ *
+ *  0. **Source picker** — the user named NO source (`from_symbol`/`from_address`
+ *     empty). The tool fetches the wallet's native + ERC-20 holdings and emits
+ *     `actionButtons` so the user picks which token to swap FROM. A click
+ *     re-submits a prompt like `"swap USDC"` which routes back here.
+ *
+ *  1. **Destination picker (trending)** — the user named the source only. The
+ *     tool fetches the chain's live trending list (minus the source token) and
+ *     emits `actionButtons` so the user picks what to receive. A click submits a
+ *     prompt like `"swap USDC to PEPE"` which routes back for the standard flow.
+ *
+ *  1.4 **Balance check** — the source token is named (amount optional). Runs
+ *     before anything else so we never proceed with a token the user can't fund:
+ *     if the wallet holds NONE of it, the tool offers the tokens the user DOES
+ *     hold instead (source picker); if it holds SOME but less than the requested
+ *     amount, it reports the shortfall and emits 25/50/75/100% buttons sized off
+ *     the real balance. Skipped for the native source token.
+ *
+ *  1.5 **Amount picker** — source + dest known but no amount given. The tool
+ *     reads the source balance and emits 25/50/75/100% buttons so the user sizes
+ *     the swap in one tap (or types a custom amount).
+ *
+ *  1.75 **Confirm tx** — source + dest + a SOURCE amount are all known. The tool
+ *     fetches a swap quote (estimated receive amount + the raw swap tx), checks
+ *     allowance, and emits a `SwapTokenConfirmTx` payload bundling the estimate,
+ *     the raw swap transaction, and the approve transaction (when one is needed).
+ *     The FE executes approve (if any) then swap itself.
+ *
+ *  When none of the above produces a result (couldn't resolve a token, quote
+ *  failed, …) the tool returns an error/_instructions object — it never opens a
+ *  generic form.
+ *
+ * Amount disambiguation mirrors BuyTokenTool. The swap is EXACT_INPUT (deBridge),
+ * so the amount that seeds the quote is the SOURCE amount:
+ *   - "swap 10 USDC to USDT"  → from_amount = "10"
+ *   - "swap USDC to 5 USDT"   → to_amount = "5" (converted to a source amount via
+ *                                live USD prices, like BuyTokenTool's buy side).
+ */
+export declare class SwapTokenTool extends BaseTool {
+    name: string;
+    kind: ToolKind;
+    category: string;
+    noSuggestions: boolean;
+    private readonly moralis?;
+    /** Trending tokens come from Pantograph (top-gainers), not Moralis. */
+    private readonly pantograph?;
+    /** Branch-tracing on/off — shares AgentCore's `debug` flag (passed in). */
+    private readonly debug;
+    constructor(config?: MoralisServiceConfig, options?: {
+        debug?: boolean;
+    });
+    /**
+     * Branch-tracing logger. Prints which branch the tool takes and the key
+     * values feeding that decision. Enabled by AgentCore's shared `debug` flag.
+     */
+    private dbg;
+    description: string;
+    parameters: ToolParameter[];
+    execute(args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        actionButtons: {
+            label: string;
+            prompt: string;
+        }[];
+        _instructions: string;
+    } | {
+        ui: UIPayload;
+        _instructions: string;
+    } | {
+        error: string;
+        _instructions: string;
+    }>;
+    private buildResult;
+    private normaliseAddress;
+    private normaliseAmount;
+    private requireChain;
+    /**
+     * Resolve a token reference (symbol "USDC" or address "0x…") on a chain.
+     * Wallet balances first (most reliable), then Pantograph search. Decimals come
+     * from the API — never from the LLM.
+     */
+    private resolveContractAddress;
+    /**
+     * Resolve one side of the swap (from or to). Honours the `"native"` sentinel
+     * the swap providers expect. Never errors — a side that can't be resolved
+     * just comes back with `address: null`.
+     */
+    private resolveSide;
+    /**
+     * Source token + dest token + a source-token amount are known. Fetch a swap
+     * quote (estimated receive amount + raw swap tx), check approval, and return a
+     * `SwapTokenConfirmTx` UI payload the FE executes itself. Returns `null` when
+     * anything we need can't be produced (bad chain, quote failed, non-EVM tx).
+     */
+    private buildConfirmTx;
+    /**
+     * deBridge only quotes EXACT_INPUT, so a "swap to X of the dest token" request
+     * has no input amount to seed the quote. Convert the desired output into a
+     * source-token amount using each side's live USD price:
+     *
+     *   fromAmount ≈ (toAmount × toPriceUsd) / fromPriceUsd × (1 + buffer)
+     *
+     * The +2% buffer covers slippage + fees so the user receives AT LEAST roughly
+     * the requested amount (the confirm panel still shows the REAL estimate from
+     * the quote, not this derived figure). Returns `null` when either token's USD
+     * price can't be fetched — the caller then asks for a from amount instead.
+     */
+    private deriveFromAmountFromTo;
+    /**
+     * Best-effort live USD price for one side of the swap, sourced from
+     * Pantograph (via `MoralisService.getTokenMetadata`). The native coin
+     * (`'native'`) is looked up with the zero address. Returns `null` when no
+     * positive price is available so the caller can degrade gracefully.
+     */
+    private getUsdPrice;
+    /**
+     * Resolve the FROM-side amount, which may be plain ("10"), a PERCENT of the
+     * held source-token balance ("50%"), or a USD value ("5$"). Percent reads the
+     * wallet's source-token balance; usd divides by the source token's USD price.
+     * Returns a plain token amount string, or `null` when nothing usable was given
+     * / the balance or price needed for a percent/usd couldn't be fetched.
+     */
+    private resolveFromAmountSpec;
+    /**
+     * Resolve the TO-side amount, which may be plain ("5") or a USD value ("5$").
+     * USD divides by the DEST token's price to get how many dest tokens "$X worth"
+     * is — that token figure then flows through Branch 1.3 to derive the from
+     * amount. A PERCENT on the to side is meaningless, so it's ignored (returns
+     * null). Returns a plain token amount string or `null`.
+     */
+    private resolveToAmountSpec;
+    /**
+     * Check whether the source token needs an allowance for this swap and, if so,
+     * return a ready-to-sign ERC-20 approve tx. deBridge only reports the spender
+     * (`tx.to`), so we encode the approve calldata ourselves; integrated providers
+     * (Relay) hand back the approve tx directly.
+     */
+    private buildApproveTx;
+    /** Human amount → smallest-unit decimal string (no float drift via BigInt). */
+    private toRawAmount;
+    /**
+     * Pull a human-readable failure reason out of a failed quote. Adapters set
+     * `errorMessage` (string) and `error` (string or a provider object). deBridge
+     * also nests a reason in `raw.errorMessage` / `raw.error`. Falls back to a
+     * generic line so the caller always has something to show.
+     */
+    private extractQuoteError;
+    /**
+     * Estimated receive amount in the dest token's smallest units. Shape differs
+     * per provider — deBridge same-chain: `raw.tokenOut.minAmount`; deBridge
+     * cross-chain: `raw.estimation.dstChainTokenOut.amount`; Relay:
+     * `raw.details.currencyOut.{amount|minimumAmount}`.
+     */
+    private extractOutRaw;
+    private buildSourcePicker;
+    private buildToTrendingPicker;
+    /**
+     * Guard the swap flow against a source token the user can't fund. Returns:
+     *   - `null` when the user holds enough (or no amount yet, or balances can't be read).
+     *   - `no_from_balance` (+ source picker buttons) when the wallet holds none of it.
+     *   - `insufficient_from_balance` (+ percentage buttons) when it holds some but
+     *     less than the requested amount.
+     */
+    private checkFromBalance;
+    /**
+     * Read the connected wallet's balance of the source token. Returns the held
+     * amount + on-chain symbol, or `null` when balances can't be fetched / the
+     * token isn't held (zero balance or not held at all).
+     *
+     * For the NATIVE source coin the returned balance is the SPENDABLE figure —
+     * the held balance minus a silently-estimated swap gas reserve (gasLimit
+     * 1_000_000 × gasPrice) — so the percent buttons, amount picker, and balance
+     * check all stay within what the user can actually swap while still covering
+     * gas. The reserve is never surfaced; callers only ever expose the spendable
+     * number. ERC-20 sources are returned at their raw held balance (gas is paid
+     * in the native coin, not the source token).
+     */
+    private readFromBalance;
+    /**
+     * 25/50/75/100% quick-spend buttons sized off a held balance. 100% spends the
+     * EXACT held string; the partial fractions are float-trimmed. The amount rides
+     * in the prompt; the label is a bare percent.
+     */
+    private percentSpendButtons;
+    private buildAmountPicker;
+    /**
+     * Trim IEEE-754 noise from a computed amount (≤8 significant digits) and
+     * ALWAYS return plain decimal notation — never exponential ("1.5e-7").
+     */
+    private trimAmount;
+    /** Format a number as a plain decimal string, expanding any e-notation. */
+    private toPlainDecimal;
+    /**
+     * Sanitize an amount STRING from an external source (e.g. Moralis
+     * `balance_formatted`): expand e-notation to plain decimal; else pass through.
+     */
+    private cleanAmountString;
+    /**
+     * Build the source-picker click-prompt ("swap {token}") from the LLM-supplied,
+     * already-localized template. Falls back to English when the LLM omits one.
+     */
+    private buildSwapFromPrompt;
+    /**
+     * Build the "swap X to Y" click-prompt from the LLM-supplied, already-localized
+     * template by substituting placeholders:
+     *   {from} → source token    {to} → destination token
+     *   {from_amount} → quantity swapped (next to {from})
+     *   {to_amount} → quantity received  (next to {to})
+     * The localized verb and "to" preposition live INSIDE the template, so we only
+     * substitute concrete values. Only one side ever carries an amount; the unused
+     * amount placeholder is replaced with '' (no preposition is attached to it, so
+     * nothing dangles). Falls back to an English template when the LLM omits one.
+     */
+    private buildSwapToPrompt;
+    /**
+     * Format a 24h price-change percentage: ~6 significant digits, no trailing
+     * noise, and always plain decimal (never exponential for a tiny change).
+     */
+    private formatPercent;
+    /** Compact price string: e.g. 0.00001234 → "0.00001234", 1234.5 → "1,234.50". */
+    private formatPrice;
+}
+//# sourceMappingURL=SwapTokenTool.d.ts.map

package/dist/tools/builtin/wallet-action/SwapTokenTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapTokenTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet-action/SwapTokenTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAI7F,OAAO,KAAK,EAGV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,SAAS,EAET,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAcxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,IAAI,SAA0B;IAC9B,IAAI,EAAE,QAAQ,CAAY;IAC1B,QAAQ,SAAmB;IAE3B,aAAa,UAAQ;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAiB;IAC1C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAoB;IAChD,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,MAAM,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IASxE;;;OAGG;IACH,OAAO,CAAC,GAAG;IAOX,WAAW,SAUoF;IAE/F,UAAU,EAAE,aAAa,EAAE,CA8FzB;IAKI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;cAkC5E,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;uBAiuBvD;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE;uBAAiB,MAAM;;YAzW7D,SAAS;uBAAiB,MAAM;;;;;YArVpC,WAAW;IAoNzB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,YAAY;IAMpB;;;;OAIG;YACW,sBAAsB;IA2CpC;;;;OAIG;YACW,WAAW;IAuCzB;;;;;OAKG;YACW,cAAc;IAiI5B;;;;;;;;;;;OAWG;YACW,sBAAsB;IA4BpC;;;;;OAKG;YACW,WAAW;IAWzB;;;;;;OAMG;YACW,qBAAqB;IAgCnC;;;;;;OAMG;YACW,mBAAmB;IAmBjC;;;;;OAKG;YACW,cAAc;IA0C5B,+EAA+E;IAC/E,OAAO,CAAC,WAAW;IAanB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;YAmBP,iBAAiB;YAiEjB,qBAAqB;IAwFnC;;;;;;OAMG;YACW,gBAAgB;IA0F9B;;;;;;;;;;;;OAYG;YACW,eAAe;IAqD7B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;YAwBb,iBAAiB;IA+B/B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAKlB,2EAA2E;IAC3E,OAAO,CAAC,cAAc;IAwBtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB,iFAAiF;IACjF,OAAO,CAAC,WAAW;CAOpB"}