sms-wallet-agent 1.0.0

package/README.md

@@ -0,0 +1,162 @@
+# sms-wallet-agent
+
+Interact with Solana blockchain wallets through SMS messages. Text a phone number and receive wallet information instantly — no crypto knowledge required.
+
+## How It Works
+
+```
+SMS → Twilio → Express Webhook → Intent Parser → Wallet Service → SMS Response
+```
+
+## Features
+
+- **balance** — Get SOL balance for any wallet
+- **activity** — View recent transactions summarized for SMS
+- **portfolio** — SOL balance + top SPL tokens
+- **track** — Get notified when a wallet has activity
+- **stop** — Stop tracking a wallet
+
+Read-only. Never requests private keys, seed phrases, or passwords. Never signs or broadcasts transactions.
+
+## Installation
+
+```bash
+npm install -g sms-wallet-agent
+```
+
+Or clone and install locally:
+
+```bash
+git clone <repo-url>
+cd sms-wallet-agent
+npm install
+npm run build
+npm link
+```
+
+## Configuration
+
+Copy the example env file and fill in your credentials:
+
+```bash
+cp .env.example .env
+```
+
+| Variable | Description |
+|---|---|
+| `PORT` | Server port (default: `3000`) |
+| `SOLANA_RPC_URL` | Solana RPC endpoint |
+| `TWILIO_ACCOUNT_SID` | Twilio account SID |
+| `TWILIO_AUTH_TOKEN` | Twilio auth token |
+| `TWILIO_PHONE_NUMBER` | Your Twilio phone number |
+
+Data is stored in `~/.config/sms-wallet-agent/`:
+
+- `config.json` — App configuration
+- `tracked-wallets.json` — Phone-to-wallet tracking mappings
+- `state.json` — Last-known wallet state for change detection
+
+## Run
+
+```bash
+sms-wallet-agent start
+```
+
+You should see:
+
+```
+✓ SMS server running on port 3000
+✓ Tracking active
+```
+
+## Twilio Setup
+
+1. Expose your local server with ngrok:
+
+```bash
+ngrok http 3000
+```
+
+2. In the [Twilio Console](https://console.twilio.com/), go to your phone number settings.
+
+3. Set the webhook URL for incoming messages:
+
+```
+https://YOUR_NGROK_URL/sms
+```
+
+Method: `POST`
+
+4. Send a text to your Twilio number:
+
+```
+balance 8xQeWvG816bUx9EPjZmqJ9jZmqJ9jZmqJ9jZmqJ9jZmq
+```
+
+## Commands
+
+Text any of these to your Twilio number:
+
+| Command | Example | Response |
+|---|---|---|
+| `help` | `help` | List of available commands |
+| `balance` | `balance 8xQe...` | SOL balance |
+| `activity` | `activity 8xQe...` | Recent activity summary + Solscan link |
+| `portfolio` | `portfolio 8xQe...` | SOL + top tokens |
+| `track` | `track 8xQe...` | Start activity notifications |
+| `stop` | `stop 8xQe...` | Stop tracking |
+
+### Example Conversation
+
+```
+You:   balance 8xQeWvG816bUx9EP...
+Agent: Balance:
+       2.41 SOL
+
+You:   activity 8xQeWvG816bUx9EP...
+Agent: Recent Activity:
+
+       • SOL received
+       • Swapped BONK -> SOL
+       • NFT Transfer
+
+       View:
+       https://solscan.io/account/8xQe...
+
+You:   track 8xQeWvG816bUx9EP...
+Agent: Done.
+
+       I will notify you when this wallet has activity.
+
+[Later, automatically:]
+Agent: 🚨 Wallet Activity
+
+       Wallet:
+       8xQe...EPjZ
+
+       Event:
+       NFT Sale
+
+       Amount:
+       4.2 SOL
+```
+
+## Development
+
+```bash
+npm install
+npm run dev        # Run with tsx (hot reload)
+npm run build      # Compile TypeScript
+npm start          # Run compiled build
+```
+
+## Security
+
+- Read-only wallet queries only
+- No private keys, seed phrases, or passwords ever requested
+- No transaction signing or broadcasting
+- All tracking data stored locally on your machine
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildCli(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,QAAQ,IAAI,OAAO,CA4BlC"}

package/dist/cli.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCli = buildCli;
+const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
+const server_1 = require("./server");
+const storage_1 = require("./storage");
+const logger_1 = require("./utils/logger");
+function buildCli() {
+    const program = new commander_1.Command();
+    program
+        .name('sms-wallet-agent')
+        .description('Interact with Solana wallets through SMS')
+        .version('1.0.0');
+    program
+        .command('start')
+        .description('Start the SMS webhook server and wallet tracking engine')
+        .action(() => {
+        const spinner = (0, ora_1.default)('Starting SMS wallet agent...').start();
+        const config = (0, storage_1.loadConfig)();
+        const port = Number(process.env.PORT) || config.port;
+        const rpcUrl = process.env.SOLANA_RPC_URL || config.rpcUrl;
+        (0, storage_1.saveConfig)({ port, rpcUrl });
+        spinner.succeed('Configuration loaded');
+        logger_1.log.info(`Config directory: ${(0, storage_1.getConfigDir)()}`);
+        logger_1.log.info(`Solana RPC: ${rpcUrl}`);
+        (0, server_1.createServer)();
+    });
+    return program;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;AAMA,4BA4BC;AAlCD,yCAAoC;AACpC,8CAAsB;AACtB,qCAAwC;AACxC,uCAAiE;AACjE,2CAAqC;AAErC,SAAgB,QAAQ;IACtB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,kBAAkB,CAAC;SACxB,WAAW,CAAC,0CAA0C,CAAC;SACvD,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,yDAAyD,CAAC;SACtE,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,8BAA8B,CAAC,CAAC,KAAK,EAAE,CAAC;QAE5D,MAAM,MAAM,GAAG,IAAA,oBAAU,GAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;QACrD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC;QAE3D,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7B,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACxC,YAAG,CAAC,IAAI,CAAC,qBAAqB,IAAA,sBAAY,GAAE,EAAE,CAAC,CAAC;QAChD,YAAG,CAAC,IAAI,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC;QAElC,IAAA,qBAAY,GAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/handlers/sms.d.ts

@@ -0,0 +1,7 @@
+import { WalletService } from '../services/wallet';
+export declare class SmsHandler {
+    private walletService;
+    constructor(walletService: WalletService);
+    handle(body: string, from: string): Promise<string>;
+}
+//# sourceMappingURL=sms.d.ts.map

package/dist/handlers/sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../src/handlers/sms.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,qBAAa,UAAU;IACT,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAE1C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA+C1D"}

package/dist/handlers/sms.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmsHandler = void 0;
+const intent_1 = require("../parser/intent");
+const storage_1 = require("../storage");
+const logger_1 = require("../utils/logger");
+const validation_1 = require("../utils/validation");
+class SmsHandler {
+    walletService;
+    constructor(walletService) {
+        this.walletService = walletService;
+    }
+    async handle(body, from) {
+        const command = (0, intent_1.parseIntent)(body);
+        logger_1.log.info(`SMS from ${from}: ${body.slice(0, 50)}${body.length > 50 ? '...' : ''}`);
+        switch (command.type) {
+            case 'help':
+                return intent_1.HELP_TEXT;
+            case 'balance':
+                return this.walletService.getBalance(command.wallet);
+            case 'activity':
+                return this.walletService.getActivity(command.wallet);
+            case 'portfolio':
+                return this.walletService.getPortfolio(command.wallet);
+            case 'track': {
+                const error = this.walletService.validateWallet(command.wallet);
+                if (error)
+                    return error;
+                (0, storage_1.addTrackedWallet)(from, command.wallet);
+                const latestSig = await this.walletService.getLatestSignature(command.wallet);
+                (0, storage_1.updateWalletState)(command.wallet, {
+                    lastSignature: latestSig,
+                    lastChecked: new Date().toISOString(),
+                });
+                logger_1.log.success(`Wallet added: ${(0, validation_1.truncateAddress)(command.wallet)} for ${from}`);
+                return 'Done.\n\nI will notify you when this wallet has activity.';
+            }
+            case 'stop': {
+                const removed = (0, storage_1.removeTrackedWallet)(from, command.wallet);
+                if (!removed) {
+                    return 'This wallet is not being tracked.';
+                }
+                logger_1.log.success(`Tracking removed: ${(0, validation_1.truncateAddress)(command.wallet)} for ${from}`);
+                return 'Tracking removed.';
+            }
+            case 'unknown':
+            default:
+                return intent_1.UNKNOWN_TEXT;
+        }
+    }
+}
+exports.SmsHandler = SmsHandler;
+//# sourceMappingURL=sms.js.map

package/dist/handlers/sms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.js","sourceRoot":"","sources":["../../src/handlers/sms.ts"],"names":[],"mappings":";;;AAAA,6CAAwE;AAExE,wCAIoB;AACpB,4CAAsC;AACtC,oDAAsD;AAEtD,MAAa,UAAU;IACD;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,IAAY;QACrC,MAAM,OAAO,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;QAClC,YAAG,CAAC,IAAI,CAAC,YAAY,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEnF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,MAAM;gBACT,OAAO,kBAAS,CAAC;YAEnB,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAEvD,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAExD,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAEzD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChE,IAAI,KAAK;oBAAE,OAAO,KAAK,CAAC;gBAExB,IAAA,0BAAgB,EAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAEvC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC9E,IAAA,2BAAiB,EAAC,OAAO,CAAC,MAAM,EAAE;oBAChC,aAAa,EAAE,SAAS;oBACxB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACtC,CAAC,CAAC;gBAEH,YAAG,CAAC,OAAO,CAAC,iBAAiB,IAAA,4BAAe,EAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;gBAC5E,OAAO,2DAA2D,CAAC;YACrE,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,OAAO,GAAG,IAAA,6BAAmB,EAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,mCAAmC,CAAC;gBAC7C,CAAC;gBACD,YAAG,CAAC,OAAO,CAAC,qBAAqB,IAAA,4BAAe,EAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;gBAChF,OAAO,mBAAmB,CAAC;YAC7B,CAAC;YAED,KAAK,SAAS,CAAC;YACf;gBACE,OAAO,qBAAY,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAlDD,gCAkDC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv_1 = __importDefault(require("dotenv"));
+const cli_1 = require("./cli");
+dotenv_1.default.config();
+const program = (0, cli_1.buildCli)();
+program.parse(process.argv);
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAEA,oDAA4B;AAC5B,+BAAiC;AAEjC,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,OAAO,GAAG,IAAA,cAAQ,GAAE,CAAC;AAC3B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/dist/parser/intent.d.ts

@@ -0,0 +1,5 @@
+import { Command } from '../types';
+export declare function parseIntent(body: string): Command;
+export declare const HELP_TEXT = "Commands:\n\nbalance <wallet>\nactivity <wallet>\nportfolio <wallet>\ntrack <wallet>\nstop <wallet>";
+export declare const UNKNOWN_TEXT = "Unknown command. Text \"help\" for available commands.";
+//# sourceMappingURL=intent.d.ts.map

package/dist/parser/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/parser/intent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAInC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuCjD;AAED,eAAO,MAAM,SAAS,wGAMR,CAAC;AAEf,eAAO,MAAM,YAAY,2DAAyD,CAAC"}

package/dist/parser/intent.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNKNOWN_TEXT = exports.HELP_TEXT = void 0;
+exports.parseIntent = parseIntent;
+const COMMANDS = ['help', 'balance', 'activity', 'portfolio', 'track', 'stop'];
+function parseIntent(body) {
+    const trimmed = body.trim();
+    if (!trimmed) {
+        return { type: 'unknown', raw: '' };
+    }
+    const parts = trimmed.split(/\s+/);
+    const command = parts[0].toLowerCase();
+    if (!COMMANDS.includes(command)) {
+        if (command === '?' || command === 'commands') {
+            return { type: 'help' };
+        }
+        return { type: 'unknown', raw: trimmed };
+    }
+    if (command === 'help') {
+        return { type: 'help' };
+    }
+    const wallet = parts.slice(1).join(' ').trim();
+    if (!wallet) {
+        return { type: 'unknown', raw: trimmed };
+    }
+    switch (command) {
+        case 'balance':
+            return { type: 'balance', wallet };
+        case 'activity':
+            return { type: 'activity', wallet };
+        case 'portfolio':
+            return { type: 'portfolio', wallet };
+        case 'track':
+            return { type: 'track', wallet };
+        case 'stop':
+            return { type: 'stop', wallet };
+        default:
+            return { type: 'unknown', raw: trimmed };
+    }
+}
+exports.HELP_TEXT = `Commands:
+
+balance <wallet>
+activity <wallet>
+portfolio <wallet>
+track <wallet>
+stop <wallet>`;
+exports.UNKNOWN_TEXT = `Unknown command. Text "help" for available commands.`;
+//# sourceMappingURL=intent.js.map

package/dist/parser/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/parser/intent.ts"],"names":[],"mappings":";;;AAIA,kCAuCC;AAzCD,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAExF,SAAgB,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAoC,CAAC,EAAE,CAAC;QAC7D,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACtC,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QACvC,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAClC;YACE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAEY,QAAA,SAAS,GAAG;;;;;;cAMX,CAAC;AAEF,QAAA,YAAY,GAAG,sDAAsD,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+import express from 'express';
+import { TrackingEngine } from './services/tracker';
+export declare function createServer(): {
+    app: express.Application;
+    tracker: TrackingEngine;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAA8B,MAAM,SAAS,CAAC;AAIrD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMpD,wBAAgB,YAAY,IAAI;IAC9B,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;CACzB,CA0CA"}

package/dist/server.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+const express_1 = __importDefault(require("express"));
+const twilio_1 = __importDefault(require("twilio"));
+const sms_1 = require("./handlers/sms");
+const wallet_1 = require("./services/wallet");
+const tracker_1 = require("./services/tracker");
+const storage_1 = require("./storage");
+const logger_1 = require("./utils/logger");
+const MessagingResponse = twilio_1.default.twiml.MessagingResponse;
+function createServer() {
+    const config = (0, storage_1.loadConfig)();
+    const port = Number(process.env.PORT) || config.port;
+    const rpcUrl = process.env.SOLANA_RPC_URL || config.rpcUrl;
+    const walletService = new wallet_1.WalletService(rpcUrl);
+    const smsHandler = new sms_1.SmsHandler(walletService);
+    const tracker = new tracker_1.TrackingEngine(walletService);
+    const app = (0, express_1.default)();
+    app.use(express_1.default.urlencoded({ extended: false }));
+    app.use(express_1.default.json());
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', service: 'sms-wallet-agent' });
+    });
+    app.post('/sms', async (req, res) => {
+        const body = req.body.Body ?? '';
+        const from = req.body.From ?? '';
+        const twiml = new MessagingResponse();
+        try {
+            const reply = await smsHandler.handle(body, from);
+            twiml.message(reply);
+        }
+        catch (err) {
+            logger_1.log.error(`SMS handler error: ${String(err)}`);
+            twiml.message('Something went wrong. Please try again later.');
+        }
+        res.type('text/xml');
+        res.send(twiml.toString());
+    });
+    app.listen(port, () => {
+        logger_1.log.success(`SMS server running on port ${port}`);
+        logger_1.log.info(`Webhook: POST http://localhost:${port}/sms`);
+        tracker.start();
+    });
+    return { app, tracker };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;;;AAUA,oCA6CC;AAvDD,sDAAqD;AACrD,oDAA4B;AAC5B,wCAA4C;AAC5C,8CAAkD;AAClD,gDAAoD;AACpD,uCAAuC;AACvC,2CAAqC;AAErC,MAAM,iBAAiB,GAAG,gBAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC;AAEzD,SAAgB,YAAY;IAI1B,MAAM,MAAM,GAAG,IAAA,oBAAU,GAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC;IAE3D,MAAM,aAAa,GAAG,IAAI,sBAAa,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,gBAAU,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,wBAAc,CAAC,aAAa,CAAC,CAAC;IAElD,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACjD,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QAClD,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACrD,MAAM,IAAI,GAAW,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QACzC,MAAM,IAAI,GAAW,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAEzC,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAClD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAG,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,KAAK,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;QACjE,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,YAAG,CAAC,OAAO,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;QAClD,YAAG,CAAC,IAAI,CAAC,kCAAkC,IAAI,MAAM,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC1B,CAAC"}

package/dist/services/tracker.d.ts

@@ -0,0 +1,17 @@
+import { WalletService } from './wallet';
+export declare class TrackingEngine {
+    private walletService;
+    private twilioClient;
+    private fromNumber;
+    private intervalId;
+    private running;
+    constructor(walletService: WalletService);
+    private initTwilio;
+    start(): void;
+    stop(): void;
+    private poll;
+    private notifySubscribers;
+    private formatNotification;
+    private sendSms;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/services/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/services/tracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAazC,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,OAAO,CAAS;gBAEZ,aAAa,EAAE,aAAa;IAKxC,OAAO,CAAC,UAAU;IAalB,KAAK,IAAI,IAAI;IAUb,IAAI,IAAI,IAAI;YAQE,IAAI;YAuCJ,iBAAiB;IAU/B,OAAO,CAAC,kBAAkB;YAgBZ,OAAO;CAatB"}

package/dist/services/tracker.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrackingEngine = void 0;
+const twilio_1 = __importDefault(require("twilio"));
+const storage_1 = require("../storage");
+const logger_1 = require("../utils/logger");
+const validation_1 = require("../utils/validation");
+const POLL_INTERVAL_MS = 60_000;
+class TrackingEngine {
+    walletService;
+    twilioClient = null;
+    fromNumber = null;
+    intervalId = null;
+    running = false;
+    constructor(walletService) {
+        this.walletService = walletService;
+        this.initTwilio();
+    }
+    initTwilio() {
+        const accountSid = process.env.TWILIO_ACCOUNT_SID;
+        const authToken = process.env.TWILIO_AUTH_TOKEN;
+        const phoneNumber = process.env.TWILIO_PHONE_NUMBER;
+        if (accountSid && authToken && phoneNumber) {
+            this.twilioClient = (0, twilio_1.default)(accountSid, authToken);
+            this.fromNumber = phoneNumber;
+        }
+        else {
+            logger_1.log.warn('Twilio credentials missing — tracking notifications disabled');
+        }
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        logger_1.log.success('Tracking active');
+        void this.poll();
+        this.intervalId = setInterval(() => void this.poll(), POLL_INTERVAL_MS);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        this.running = false;
+    }
+    async poll() {
+        const tracked = (0, storage_1.getAllTrackedWallets)();
+        if (tracked.length === 0)
+            return;
+        const state = (0, storage_1.loadState)();
+        const walletsSeen = new Set();
+        for (const entry of tracked) {
+            walletsSeen.add(entry.wallet);
+            try {
+                const lastSig = state[entry.wallet]?.lastSignature;
+                const events = await this.walletService.detectNewEvents(entry.wallet, lastSig);
+                if (events.length > 0) {
+                    for (const event of events) {
+                        await this.notifySubscribers(entry.wallet, event);
+                    }
+                }
+                const latestSig = await this.walletService.getLatestSignature(entry.wallet);
+                (0, storage_1.updateWalletState)(entry.wallet, {
+                    lastSignature: latestSig,
+                    lastChecked: new Date().toISOString(),
+                });
+            }
+            catch (err) {
+                logger_1.log.error(`Failed to check wallet ${(0, validation_1.truncateAddress)(entry.wallet)}: ${String(err)}`);
+            }
+        }
+        const updatedState = (0, storage_1.loadState)();
+        for (const wallet of Object.keys(updatedState)) {
+            if (!walletsSeen.has(wallet)) {
+                delete updatedState[wallet];
+            }
+        }
+        (0, storage_1.saveState)(updatedState);
+    }
+    async notifySubscribers(wallet, event) {
+        const subscribers = (0, storage_1.getAllTrackedWallets)().filter((w) => w.wallet === wallet);
+        const message = this.formatNotification(event);
+        for (const sub of subscribers) {
+            await this.sendSms(sub.phone, message);
+            logger_1.log.info(`Notified ${sub.phone} about ${event.event} on ${(0, validation_1.truncateAddress)(wallet)}`);
+        }
+    }
+    formatNotification(event) {
+        const lines = [
+            '🚨 Wallet Activity',
+            '',
+            `Wallet:\n${(0, validation_1.truncateAddress)(event.wallet, 6)}`,
+            '',
+            `Event:\n${event.event}`,
+        ];
+        if (event.amount) {
+            lines.push('', `Amount:\n${event.amount}`);
+        }
+        return lines.join('\n');
+    }
+    async sendSms(to, body) {
+        if (!this.twilioClient || !this.fromNumber)
+            return;
+        try {
+            await this.twilioClient.messages.create({
+                body,
+                from: this.fromNumber,
+                to,
+            });
+        }
+        catch (err) {
+            logger_1.log.error(`Failed to send SMS to ${to}: ${String(err)}`);
+        }
+    }
+}
+exports.TrackingEngine = TrackingEngine;
+//# sourceMappingURL=tracker.js.map

package/dist/services/tracker.js.map

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

package/dist/services/wallet.d.ts

@@ -0,0 +1,21 @@
+import { DetectedEvent, WalletActivity, WalletPortfolio } from '../types';
+export declare class WalletService {
+    private connection;
+    constructor(rpcUrl: string);
+    validateWallet(address: string): string | null;
+    getBalance(wallet: string): Promise<string>;
+    getActivity(wallet: string): Promise<string>;
+    getPortfolio(wallet: string): Promise<string>;
+    fetchRecentActivity(wallet: string, limit?: number): Promise<WalletActivity>;
+    fetchPortfolio(wallet: string): Promise<WalletPortfolio>;
+    detectNewEvents(wallet: string, lastSignature?: string): Promise<DetectedEvent[]>;
+    getLatestSignature(wallet: string): Promise<string | undefined>;
+    private summarizeSignature;
+    private detectEventFromSignature;
+    private classifyTransaction;
+    private detectTokenTransfer;
+    private extractSwapDetail;
+    private fetchEstimatedValue;
+    private fetchSolPrice;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/services/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/services/wallet.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,aAAa,EAEb,cAAc,EACd,eAAe,EAChB,MAAM,UAAU,CAAC;AAWlB,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAa;gBAEnB,MAAM,EAAE,MAAM;IAI1B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOxC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS3C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa5C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B7C,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAavE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmCxD,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC;IAiB3B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAOjD,kBAAkB;YAQlB,wBAAwB;IAqBtC,OAAO,CAAC,mBAAmB;IAqD3B,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,iBAAiB;YAuBX,mBAAmB;YAgBnB,aAAa;CAW5B"}