tollkit-wallet 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tollkit LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,103 @@
-# Temporary Holding Version
+# Tollkit Wallet
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A wallet for AI trading agents. It holds its keys on your computer, encrypted with your password, and lets an agent:
+
+- swap tokens on Base and Ethereum (via 0x) and Solana (via Jupiter)
+- pay for APIs that charge per call (x402 and MPP, in USDC or USDT)
+
+All of it happens inside limits that you set and the agent can't change.
+
+## What it checks before spending
+
+- **Limits:** per trade, per day, per payment, and per seller per day. These are counted under a lock, so parallel calls can't overspend.
+- **Approval:** anything over your threshold waits for you to tap Approve in Telegram. No answer means no.
+- **Sanctions:** every payment recipient is screened against the OFAC list.
+- **Seller check:** the seller's price and pay-to address are compared with its public listing (Tollkit Weigh Station).
+- **Swap safety:** the fee must be no more than 0.5%, the only contract ever approved is 0x AllowanceHolder (for exact amounts), and a minimum output is always set.
+- **Receipts:** every trade and payment is logged, and you can export them as CSV.
+
+## Fees
+
+Swaps cost a flat 0.5%, shown before every trade. On some Base and Ethereum pairs, 0x charges its own 0.15% on top, and this is shown separately. Payments for APIs carry no Tollkit fee.
+
+## Setup
+
+```
+npm install -g tollkit-wallet
+tollkit-wallet init                 # choose a password; prints your Base/Ethereum and Solana addresses
+tollkit-wallet budget               # see limits; change with e.g. budget per_trade_usd=100
+tollkit-wallet telegram <bot-token> <chat-id>   # optional: approvals in Telegram
+```
+
+Then fund the addresses. Base and Solana are on by default; turn Ethereum on with `tollkit-wallet budget chains=base,solana,ethereum` (its network fees are higher).
+
+## Withdrawals
+
+Funds can only be withdrawn to addresses you've saved, and saving one needs your password:
+
+```
+tollkit-wallet addresses add base 0xYourAddress "my coinbase"
+tollkit-wallet withdraw base 25 USDC 0xYourAddress
+```
+
+The agent has no tool for this.
+
+## Use with an agent (MCP)
+
+```json
+{
+  "mcpServers": {
+    "tollkit-wallet": {
+      "command": "tollkit-wallet",
+      "args": ["mcp"],
+      "env": { "TOLLKIT_WALLET_PASSWORD_FILE": "/path/to/a/file/with/your/password" }
+    }
+  }
+}
+```
+
+Tools: `wallet_status`, `wallet_balances`, `swap_quote`, `swap`, `pay_fetch`, `seller_check`, `receipts`. There is no tool for changing limits, approvals or keys.
+
+## Use with Coinbase AgentKit
+
+```ts
+import { AgentKit } from "@coinbase/agentkit";
+import { TollkitWallet } from "tollkit-wallet";
+import { tollkitWalletActionProvider } from "tollkit-wallet/agentkit";
+
+const wallet = await TollkitWallet.open(process.env.TOLLKIT_WALLET_PASSWORD!);
+const agentkit = await AgentKit.from({ walletProvider, actionProviders: [tollkitWalletActionProvider(wallet)] });
+```
+
+This adds `tollkit_swap`, `tollkit_swap_quote`, `tollkit_pay_fetch`, `tollkit_wallet_balances`, `tollkit_wallet_status`, `tollkit_seller_check` and `tollkit_receipts`. They use the Tollkit wallet's own keys and limits, whatever AgentKit wallet provider you use.
+
+## Use with ElizaOS
+
+```ts
+import { tollkitWalletPlugin } from "tollkit-wallet/elizaos";
+// in your character or project: plugins: [tollkitWalletPlugin]
+```
+
+Set `TOLLKIT_WALLET_PASSWORD` (or `TOLLKIT_WALLET_PASSWORD_FILE`) in the agent's settings or environment. The agent's model reads the request ("swap 25 USDC to SOL"), and the wallet checks it against your limits before anything is signed.
+
+## Use from code
+
+```ts
+import { TollkitWallet } from "tollkit-wallet";
+const w = await TollkitWallet.open(process.env.TOLLKIT_WALLET_PASSWORD!);
+const r = await w.pay("https://api.example.com/paid-endpoint");
+```
+
+## Where things live
+
+`~/.tollkit-wallet/` (or `TOLLKIT_WALLET_HOME`) holds:
+
+- `keystore.json` (encrypted)
+- `policy.json` (sealed with your password; editing it by hand pauses spending)
+- `ledger.jsonl` (receipts)
+- `telegram.json`
+- the cached sanctions list
+
+Swap quotes come through api.tollkit.dev. It holds the 0x and Jupiter API keys and adds the fee, and it only ever sees public data and signed transactions.
+
+If you lose the password, the funds can't be recovered.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,13 @@
+# Third-party notices
+
+## web3icons
+
+Coin and chain logos in `src/coin-icons.ts` come from web3icons (`@web3icons/core` 4.0.58, https://web3icons.io), by 0xa3k5, released under the MIT License:
+
+> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The coin and network names and logos are trademarks of their owners and are used only to identify the assets and networks the wallet supports.

package/dist/actions.d.ts

@@ -0,0 +1,141 @@
+/**
+ * The wallet's agent-facing actions, defined once and shared by the MCP
+ * server, the AgentKit provider and the ElizaOS plugin. Spending stays inside
+ * the owner's policy; nothing here can change limits, keys or withdrawal
+ * addresses.
+ */
+import { z } from "zod";
+import type { TollkitWallet } from "./wallet.js";
+export declare const SwapArgs: z.ZodObject<{
+    chain: z.ZodEnum<["base", "ethereum", "solana"]>;
+    sell: z.ZodString;
+    buy: z.ZodString;
+    amount: z.ZodString;
+    slippage_bps: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    chain: "base" | "ethereum" | "solana";
+    amount: string;
+    sell: string;
+    buy: string;
+    slippage_bps?: number | undefined;
+}, {
+    chain: "base" | "ethereum" | "solana";
+    amount: string;
+    sell: string;
+    buy: string;
+    slippage_bps?: number | undefined;
+}>;
+export declare const PayArgs: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    method?: "POST" | "GET" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}, {
+    url: string;
+    method?: "POST" | "GET" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}>;
+export declare const SellerArgs: z.ZodObject<{
+    url: z.ZodString;
+    pay_to: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    pay_to?: string | undefined;
+}, {
+    url: string;
+    pay_to?: string | undefined;
+}>;
+export declare const ReceiptArgs: z.ZodObject<{
+    since: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    since?: string | undefined;
+    limit?: number | undefined;
+}, {
+    since?: string | undefined;
+    limit?: number | undefined;
+}>;
+export declare const NoArgs: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export interface WalletAction<S extends z.ZodTypeAny = z.ZodTypeAny> {
+    name: string;
+    description: string;
+    schema: S;
+    spends: boolean;
+    run: (w: TollkitWallet, args: z.infer<S>) => Promise<unknown>;
+}
+export declare const ACTIONS: readonly [WalletAction<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>, WalletAction<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>, WalletAction<z.ZodObject<{
+    chain: z.ZodEnum<["base", "ethereum", "solana"]>;
+    sell: z.ZodString;
+    buy: z.ZodString;
+    amount: z.ZodString;
+    slippage_bps: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    chain: "base" | "ethereum" | "solana";
+    amount: string;
+    sell: string;
+    buy: string;
+    slippage_bps?: number | undefined;
+}, {
+    chain: "base" | "ethereum" | "solana";
+    amount: string;
+    sell: string;
+    buy: string;
+    slippage_bps?: number | undefined;
+}>>, WalletAction<z.ZodObject<{
+    chain: z.ZodEnum<["base", "ethereum", "solana"]>;
+    sell: z.ZodString;
+    buy: z.ZodString;
+    amount: z.ZodString;
+    slippage_bps: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    chain: "base" | "ethereum" | "solana";
+    amount: string;
+    sell: string;
+    buy: string;
+    slippage_bps?: number | undefined;
+}, {
+    chain: "base" | "ethereum" | "solana";
+    amount: string;
+    sell: string;
+    buy: string;
+    slippage_bps?: number | undefined;
+}>>, WalletAction<z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    method?: "POST" | "GET" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}, {
+    url: string;
+    method?: "POST" | "GET" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: string | undefined;
+}>>, WalletAction<z.ZodObject<{
+    url: z.ZodString;
+    pay_to: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    pay_to?: string | undefined;
+}, {
+    url: string;
+    pay_to?: string | undefined;
+}>>, WalletAction<z.ZodObject<{
+    since: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    since?: string | undefined;
+    limit?: number | undefined;
+}, {
+    since?: string | undefined;
+    limit?: number | undefined;
+}>>];

package/dist/actions.js

@@ -0,0 +1,80 @@
+/**
+ * The wallet's agent-facing actions, defined once and shared by the MCP
+ * server, the AgentKit provider and the ElizaOS plugin. Spending stays inside
+ * the owner's policy; nothing here can change limits, keys or withdrawal
+ * addresses.
+ */
+import { z } from "zod";
+import { resolveToken, toAtomic } from "./tokens.js";
+import { checkSeller } from "./seller.js";
+const MAX_BODY = 50_000;
+export const SwapArgs = z.object({
+    chain: z.enum(["base", "ethereum", "solana"]).describe("Chain to trade on"),
+    sell: z.string().describe("Token to sell: symbol (USDC, USDT, ETH, WETH, SOL) or contract/mint address"),
+    buy: z.string().describe("Token to buy: symbol or contract/mint address"),
+    amount: z.string().describe('Amount of the sell token in normal units, e.g. "25" or "0.01"'),
+    slippage_bps: z.number().int().min(1).max(1000).optional().describe("Max slippage in basis points (default 50, capped by the owner's limit)"),
+});
+export const PayArgs = z.object({
+    url: z.string().url().describe("The paid endpoint"),
+    method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional(),
+    headers: z.record(z.string()).optional(),
+    body: z.string().optional().describe("Request body, e.g. JSON text"),
+});
+export const SellerArgs = z.object({ url: z.string().url(), pay_to: z.string().optional() });
+export const ReceiptArgs = z.object({
+    since: z.string().optional().describe("ISO date, e.g. 2026-10-01"),
+    limit: z.number().int().min(1).max(500).optional(),
+});
+export const NoArgs = z.object({});
+async function swapRequest(w, a) {
+    const chain = a.chain;
+    const [sell, buy] = await Promise.all([resolveToken(chain, a.sell), resolveToken(chain, a.buy)]);
+    return { req: { chain, sell_token: sell.address, buy_token: buy.address, sell_amount: toAtomic(a.amount, sell.decimals), slippage_bps: a.slippage_bps ?? Math.min(50, w.policy.max_slippage_bps) }, sell, buy };
+}
+const bad = (e) => ({ ok: false, refused: { code: "bad_request", reason: e.message } });
+const def = (a) => a;
+export const ACTIONS = [
+    def({ name: "wallet_status", spends: false, schema: NoArgs,
+        description: "Wallet addresses, the owner's spending limits, what has been spent today, and whether approvals are on.",
+        run: async (w) => w.status() }),
+    def({ name: "wallet_balances", spends: false, schema: NoArgs,
+        description: "Balances of the native coin and USDC/USDT on each enabled chain.",
+        run: async (w) => w.balances() }),
+    def({ name: "swap_quote", spends: false, schema: SwapArgs,
+        description: "Get a checked quote for a spot swap without trading: dollar value, minimum received, Tollkit's 0.5% fee and any venue fee.",
+        run: async (w, a) => { try {
+            const { req, sell, buy } = await swapRequest(w, a);
+            return { ...(await w.quote(req)), sell, buy };
+        }
+        catch (e) {
+            return bad(e);
+        } } }),
+    def({ name: "swap", spends: true, schema: SwapArgs,
+        description: "Swap tokens (Base/Ethereum via 0x, Solana via Jupiter) within the owner's limits. Larger trades wait for the owner's approval. Flat 0.5% fee, shown in the result.",
+        run: async (w, a) => { try {
+            const { req, sell, buy } = await swapRequest(w, a);
+            return { ...(await w.swap(req)), sell, buy };
+        }
+        catch (e) {
+            return bad(e);
+        } } }),
+    def({ name: "pay_fetch", spends: true, schema: PayArgs,
+        description: "Fetch a URL and pay for it if it asks (x402 or MPP, USDC/USDT on Base, Ethereum or Solana). Checks the seller, screens the recipient against OFAC, stays within the owner's limits. Returns the response body.",
+        run: async (w, a) => {
+            const r = await w.pay(a.url, { method: a.method ?? (a.body ? "POST" : "GET"), headers: a.headers, body: a.body });
+            let body;
+            if (r.response) {
+                const t = await r.response.text();
+                body = t.length > MAX_BODY ? t.slice(0, MAX_BODY) + `\n…[truncated ${t.length - MAX_BODY} chars]` : t;
+            }
+            return { paid: r.paid, status: r.status, cost_usd: r.offer?.usd, protocol: r.offer?.protocol, chain: r.offer?.chain, tx: r.tx, refused: r.refused, content_type: r.response?.headers.get("content-type"), body };
+        } }),
+    def({ name: "seller_check", spends: false, schema: SellerArgs,
+        description: "Check a paid endpoint before buying: is it up, does its live price match its listing, does it pay where it says (Tollkit Weigh Station).",
+        run: async (_w, a) => checkSeller(a.url, a.pay_to ?? "") }),
+    def({ name: "receipts", spends: false, schema: ReceiptArgs,
+        description: "Recent trades, payments and withdrawals with amounts, fees and transaction hashes.",
+        run: async (w, a) => w.receipts(a.since).slice(-(a.limit ?? 50)) }),
+];
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/agentkit.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Coinbase AgentKit action provider.
+ *
+ *   import { AgentKit } from "@coinbase/agentkit";
+ *   import { TollkitWallet } from "tollkit-wallet";
+ *   import { tollkitWalletActionProvider } from "tollkit-wallet/agentkit";
+ *   const w = await TollkitWallet.open(process.env.TOLLKIT_WALLET_PASSWORD!);
+ *   const agentkit = await AgentKit.from({ walletProvider, actionProviders: [tollkitWalletActionProvider(w)] });
+ *
+ * Trades and payments use the Tollkit wallet's own keys and limits, not the
+ * AgentKit wallet provider, so they work the same whatever provider you use.
+ * Actions are returned directly (no decorators), so no per-call analytics
+ * events are sent from this provider.
+ */
+import { ActionProvider, type Action, type Network, type WalletProvider } from "@coinbase/agentkit";
+import type { TollkitWallet } from "./wallet.js";
+export declare class TollkitWalletActionProvider extends ActionProvider<WalletProvider> {
+    private readonly wallet;
+    constructor(wallet: TollkitWallet);
+    getActions(_walletProvider: WalletProvider): Action[];
+    /** Works on any network AgentKit is set to; the chain is chosen per action. */
+    supportsNetwork(_network: Network): boolean;
+}
+export declare const tollkitWalletActionProvider: (wallet: TollkitWallet) => TollkitWalletActionProvider;

package/dist/agentkit.js

@@ -0,0 +1,40 @@
+/**
+ * Coinbase AgentKit action provider.
+ *
+ *   import { AgentKit } from "@coinbase/agentkit";
+ *   import { TollkitWallet } from "tollkit-wallet";
+ *   import { tollkitWalletActionProvider } from "tollkit-wallet/agentkit";
+ *   const w = await TollkitWallet.open(process.env.TOLLKIT_WALLET_PASSWORD!);
+ *   const agentkit = await AgentKit.from({ walletProvider, actionProviders: [tollkitWalletActionProvider(w)] });
+ *
+ * Trades and payments use the Tollkit wallet's own keys and limits, not the
+ * AgentKit wallet provider, so they work the same whatever provider you use.
+ * Actions are returned directly (no decorators), so no per-call analytics
+ * events are sent from this provider.
+ */
+import { ActionProvider } from "@coinbase/agentkit";
+import { ACTIONS } from "./actions.js";
+export class TollkitWalletActionProvider extends ActionProvider {
+    wallet;
+    constructor(wallet) {
+        super("tollkit_wallet", []);
+        this.wallet = wallet;
+    }
+    getActions(_walletProvider) {
+        return ACTIONS.map((a) => ({
+            name: `tollkit_${a.name}`,
+            description: a.description,
+            schema: a.schema,
+            invoke: async (args) => {
+                const parsed = a.schema.safeParse(args ?? {});
+                if (!parsed.success)
+                    return JSON.stringify({ ok: false, refused: { code: "bad_request", reason: parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ") } });
+                return JSON.stringify(await a.run(this.wallet, parsed.data));
+            },
+        }));
+    }
+    /** Works on any network AgentKit is set to; the chain is chosen per action. */
+    supportsNetwork(_network) { return true; }
+}
+export const tollkitWalletActionProvider = (wallet) => new TollkitWalletActionProvider(wallet);
+//# sourceMappingURL=agentkit.js.map

package/dist/agentkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentkit.js","sourceRoot":"","sources":["../src/agentkit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,cAAc,EAAkD,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,OAAO,2BAA4B,SAAQ,cAA8B;IAChD;IAA7B,YAA6B,MAAqB;QAAI,KAAK,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAArD,WAAM,GAAN,MAAM,CAAe;IAAiC,CAAC;IAE3E,UAAU,CAAC,eAA+B;QACjD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE;YACzB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,MAAM,EAAE,CAAC,CAAC,MAAa;YACvB,MAAM,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;gBAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpL,OAAO,IAAI,CAAC,SAAS,CAAC,MAAO,CAAC,CAAC,GAAW,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,CAAC;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED,+EAA+E;IAC/E,eAAe,CAAC,QAAiB,IAAa,OAAO,IAAI,CAAC,CAAC,CAAC;CAC7D;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAqB,EAAE,EAAE,CAAC,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAC"}

package/dist/approvals.d.ts

@@ -0,0 +1,21 @@
+import type { Decision } from "./telegram.js";
+export interface ApprovalRequest {
+    id: string;
+    text: string;
+    created: string;
+    expires: string;
+    status: "pending" | "approved" | "denied" | "timeout";
+    answered_by?: string;
+}
+/** The dashboard calls this every few seconds while it's open. */
+export declare function heartbeat(dir?: string): void;
+export declare function dashboardOpen(dir?: string, now?: number): boolean;
+export declare function pending(dir?: string, now?: number): ApprovalRequest[];
+/** Answer a pending request. Returns false if it was already answered or expired. */
+export declare function decide(dir: string | undefined, id: string, d: "approved" | "denied", by?: string): boolean;
+/** Wait for an answer from the dashboard. `signal` lets another channel (Telegram) win. */
+export declare function requestLocal(dir: string | undefined, text: string, o?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    pollMs?: number;
+}): Promise<Decision>;

package/dist/approvals.js

@@ -0,0 +1,71 @@
+/**
+ * Approvals on this computer, answered from the dashboard. Each request is a
+ * small file in <wallet>/approvals/; the process that wants to spend waits
+ * for the dashboard to mark it approved or denied. Used alongside Telegram:
+ * whichever answers first wins. Only used while the dashboard is open
+ * (it writes a heartbeat), so an agent never waits on a page nobody has open.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import path from "node:path";
+import { walletHome } from "./paths.js";
+const dirOf = (dir) => { const d = path.join(walletHome(dir), "approvals"); mkdirSync(d, { recursive: true, mode: 0o700 }); return d; };
+const fileOf = (dir, id) => path.join(dirOf(dir), `${id}.json`);
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function writeAtomic(f, v) { const t = `${f}.${process.pid}.tmp`; writeFileSync(t, JSON.stringify(v), { mode: 0o600 }); renameSync(t, f); }
+function read(f) { try {
+    return JSON.parse(readFileSync(f, "utf8"));
+}
+catch {
+    return null;
+} }
+/** The dashboard calls this every few seconds while it's open. */
+export function heartbeat(dir) { writeFileSync(path.join(dirOf(dir), ".heartbeat"), new Date().toISOString(), { mode: 0o600 }); }
+export function dashboardOpen(dir, now = Date.now()) {
+    try {
+        return now - statSync(path.join(dirOf(dir), ".heartbeat")).mtimeMs < 15_000;
+    }
+    catch {
+        return false;
+    }
+}
+export function pending(dir, now = Date.now()) {
+    return readdirSync(dirOf(dir)).filter((n) => n.endsWith(".json"))
+        .map((n) => read(path.join(dirOf(dir), n))).filter((r) => !!r && r.status === "pending" && Date.parse(r.expires) > now)
+        .sort((a, b) => a.created.localeCompare(b.created));
+}
+/** Answer a pending request. Returns false if it was already answered or expired. */
+export function decide(dir, id, d, by = "dashboard") {
+    if (!/^[0-9a-f]{16}$/.test(id))
+        return false;
+    const f = fileOf(dir, id);
+    const r = existsSync(f) ? read(f) : null;
+    if (!r || r.status !== "pending" || Date.parse(r.expires) <= Date.now())
+        return false;
+    writeAtomic(f, { ...r, status: d, answered_by: by });
+    return true;
+}
+/** Wait for an answer from the dashboard. `signal` lets another channel (Telegram) win. */
+export async function requestLocal(dir, text, o = {}) {
+    const id = randomBytes(8).toString("hex");
+    const now = Date.now(), timeout = o.timeoutMs ?? 5 * 60_000;
+    const f = fileOf(dir, id);
+    writeAtomic(f, { id, text, created: new Date(now).toISOString(), expires: new Date(now + timeout).toISOString(), status: "pending" });
+    while (Date.now() - now < timeout) {
+        const r = read(f);
+        if (r?.status === "approved" || r?.status === "denied")
+            return r.status;
+        if (o.signal?.aborted) {
+            const cur = read(f);
+            if (cur?.status === "pending")
+                writeAtomic(f, { ...cur, status: "timeout", answered_by: "other channel" });
+            return "timeout";
+        }
+        await sleep(o.pollMs ?? 400);
+    }
+    const r = read(f);
+    if (r?.status === "pending")
+        writeAtomic(f, { ...r, status: "timeout" });
+    return r?.status === "approved" || r?.status === "denied" ? r.status : "timeout";
+}
+//# sourceMappingURL=approvals.js.map

package/dist/approvals.js.map

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

package/dist/chains.d.ts

@@ -0,0 +1,16 @@
+/** Chains, tokens and the fixed addresses the wallet trusts. */
+export type Chain = "base" | "ethereum" | "solana";
+export declare const EVM_CHAIN_ID: Record<Exclude<Chain, "solana">, number>;
+/** 0x AllowanceHolder (Cancun chains incl. Ethereum and Base). The only contract we ever approve. docs.0x.org cheat sheet. */
+export declare const ALLOWANCE_HOLDER = "0x0000000000001fF3684f28c67538d4D072C22734";
+export declare const DEFAULT_RPC: Record<Chain, string>;
+/** Dollar stablecoins, valued at $1 for budgets. */
+export declare const STABLES: Record<Chain, Record<string, {
+    symbol: string;
+    decimals: number;
+}>>;
+export declare const NATIVE_EVM = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+export declare const WSOL = "So11111111111111111111111111111111111111112";
+export declare const isStable: (chain: Chain, token: string) => boolean;
+/** Tollkit's fee on swaps: flat, the same everywhere, shown before every trade. */
+export declare const SWAP_FEE_BPS = 50;

package/dist/chains.js

@@ -0,0 +1,26 @@
+export const EVM_CHAIN_ID = { ethereum: 1, base: 8453 };
+/** 0x AllowanceHolder (Cancun chains incl. Ethereum and Base). The only contract we ever approve. docs.0x.org cheat sheet. */
+export const ALLOWANCE_HOLDER = "0x0000000000001fF3684f28c67538d4D072C22734";
+export const DEFAULT_RPC = {
+    base: "https://mainnet.base.org",
+    ethereum: "https://ethereum-rpc.publicnode.com",
+    solana: "https://api.mainnet-beta.solana.com",
+};
+/** Dollar stablecoins, valued at $1 for budgets. */
+export const STABLES = {
+    base: { "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913": { symbol: "USDC", decimals: 6 } },
+    ethereum: {
+        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": { symbol: "USDC", decimals: 6 },
+        "0xdac17f958d2ee523a2206206994597c13d831ec7": { symbol: "USDT", decimals: 6 },
+    },
+    solana: {
+        EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v: { symbol: "USDC", decimals: 6 },
+        Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB: { symbol: "USDT", decimals: 6 },
+    },
+};
+export const NATIVE_EVM = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+export const WSOL = "So11111111111111111111111111111111111111112";
+export const isStable = (chain, token) => chain === "solana" ? token in STABLES.solana : token.toLowerCase() in STABLES[chain];
+/** Tollkit's fee on swaps: flat, the same everywhere, shown before every trade. */
+export const SWAP_FEE_BPS = 50;
+//# sourceMappingURL=chains.js.map

package/dist/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAA6C,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAElG,8HAA8H;AAC9H,MAAM,CAAC,MAAM,gBAAgB,GAAG,4CAA4C,CAAC;AAE7E,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,qCAAqC;IAC/C,MAAM,EAAE,qCAAqC;CAC9C,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,OAAO,GAAwE;IAC1F,IAAI,EAAE,EAAE,4CAA4C,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE;IACvF,QAAQ,EAAE;QACR,4CAA4C,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC7E,4CAA4C,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;KAC9E;IACD,MAAM,EAAE;QACN,4CAA4C,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC7E,4CAA4C,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;KAC9E;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,4CAA4C,CAAC;AACvE,MAAM,CAAC,MAAM,IAAI,GAAG,6CAA6C,CAAC;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAE,KAAa,EAAE,EAAE,CACtD,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvF,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};