@azeth/sdk 0.2.0

package/dist/messaging/message-router.js

@@ -0,0 +1,307 @@
+import { RateLimiter } from './rate-limiter.js';
+// ── Named constants ──
+/** Default maximum messages per sender per 60-second window */
+const DEFAULT_MAX_MESSAGES_PER_MINUTE = 10;
+/** Default minimum reputation score required to invoke services */
+const DEFAULT_MIN_REPUTATION = 30;
+/** Maximum tracked senders before the rate limiter evicts old entries */
+const MAX_TRACKED_SENDERS = 10_000;
+/** Message router for XMTP structured message dispatch.
+ *
+ *  Receives raw message strings, parses them, dispatches by type,
+ *  and returns JSON response strings. Handles rate limiting, reputation
+ *  gating, service execution, and capabilities advertising.
+ */
+export class MessageRouter {
+    _skills;
+    _agentName;
+    _agentAddress;
+    _httpEndpoint;
+    _minReputationForService;
+    _reputationChecker;
+    _onFriendRequest;
+    _onFriendAccept;
+    _textFallbackHandler;
+    _handlers = new Map();
+    _rateLimiter;
+    /** Create a new MessageRouter with the given options.
+     *
+     *  @param options - Router configuration including skills, agent identity, and callbacks
+     */
+    constructor(options) {
+        this._skills = options.skills;
+        this._agentName = options.agentName;
+        this._agentAddress = options.agentAddress;
+        this._httpEndpoint = options.httpEndpoint;
+        this._minReputationForService = options.minReputationForService ?? DEFAULT_MIN_REPUTATION;
+        this._reputationChecker = options.reputationChecker;
+        this._onFriendRequest = options.onFriendRequest;
+        this._onFriendAccept = options.onFriendAccept;
+        this._textFallbackHandler = options.textFallbackHandler;
+        this._rateLimiter = new RateLimiter(options.maxMessagesPerMinute ?? DEFAULT_MAX_MESSAGES_PER_MINUTE, MAX_TRACKED_SENDERS);
+    }
+    /** Route an incoming message to the appropriate handler and return a JSON response.
+     *
+     *  Flow: rate limit check → JSON parse → structured dispatch or text fallback.
+     *  All responses are valid JSON strings.
+     *
+     *  @param sender - Sender identifier (address or inbox ID)
+     *  @param content - Raw message content string
+     *  @returns JSON response string
+     */
+    async routeMessage(sender, content) {
+        // Rate limit check
+        if (!this._rateLimiter.checkLimit(sender)) {
+            const resp = {
+                type: 'error',
+                error: 'Rate limit exceeded',
+                code: 'RATE_LIMITED',
+            };
+            return JSON.stringify(resp);
+        }
+        // Try JSON parse
+        try {
+            const parsed = JSON.parse(content);
+            if (typeof parsed === 'object' &&
+                parsed !== null &&
+                'type' in parsed &&
+                typeof parsed.type === 'string') {
+                return await this._handleStructuredMessage(sender, parsed);
+            }
+        }
+        catch {
+            // Not valid JSON — fall through to text handler
+        }
+        // Text fallback
+        return await this._handleTextMessage(sender, content);
+    }
+    /** Register a handler function for a named service.
+     *
+     *  The handler will be invoked when a `service-request` message
+     *  arrives for a free skill matching the given name.
+     *
+     *  @param serviceName - Service name (case-insensitive matching at dispatch time)
+     *  @param handler - Async function that processes the request payload
+     */
+    registerHandler(serviceName, handler) {
+        this._handlers.set(serviceName.toLowerCase(), handler);
+    }
+    /** Remove a previously registered handler for a service.
+     *
+     *  @param serviceName - Service name to unregister
+     */
+    removeHandler(serviceName) {
+        this._handlers.delete(serviceName.toLowerCase());
+    }
+    /** Get the names of all services that have registered handlers.
+     *
+     *  @returns Array of service names with active handlers
+     */
+    getRegisteredHandlers() {
+        return Array.from(this._handlers.keys());
+    }
+    /** Build the capabilities response advertising this agent's services.
+     *
+     *  @returns CapabilitiesResponse with service catalog, free/paid separation, and usage examples
+     */
+    buildCapabilities() {
+        const freeSkills = this._skills.filter(s => !s.price);
+        const paidSkills = this._skills.filter(s => !!s.price);
+        const firstFree = freeSkills[0];
+        return {
+            type: 'capabilities',
+            agentAddress: this._agentAddress,
+            name: this._agentName,
+            services: this._skills.map(s => ({
+                name: s.name,
+                description: s.description,
+                price: s.price ?? null,
+                method: s.method ?? 'POST',
+            })),
+            freeServices: freeSkills.map(s => s.name),
+            paidServices: paidSkills.map(s => s.name),
+            httpEndpoint: this._httpEndpoint,
+            usage: {
+                free: firstFree
+                    ? { type: 'service-request', service: firstFree.name, payload: {} }
+                    : null,
+                paid: paidSkills.length > 0
+                    ? `Use HTTP with x402 payment at ${this._httpEndpoint ?? '<http-endpoint>'}`
+                    : null,
+            },
+        };
+    }
+    /** Stop the rate limiter cleanup timer.
+     *
+     *  Call this when the router is no longer needed to prevent timer leaks.
+     */
+    destroy() {
+        this._rateLimiter.destroy();
+    }
+    // ── Private: Structured message dispatch ──
+    async _handleStructuredMessage(sender, message) {
+        // Reputation gating for service requests
+        if (message.type === 'service-request' && this._reputationChecker) {
+            try {
+                const rep = await this._reputationChecker(sender);
+                if (rep < this._minReputationForService) {
+                    const resp = {
+                        type: 'error',
+                        error: 'Insufficient reputation to use services',
+                        code: 'INSUFFICIENT_REPUTATION',
+                    };
+                    return JSON.stringify(resp);
+                }
+            }
+            catch (err) {
+                const resp = {
+                    type: 'error',
+                    error: `Reputation check failed: ${err instanceof Error ? err.message : String(err)}`,
+                    code: 'REPUTATION_CHECK_FAILED',
+                };
+                return JSON.stringify(resp);
+            }
+        }
+        switch (message.type) {
+            case 'service-request':
+                return this._handleServiceRequest(sender, message);
+            case 'service-inquiry':
+                return this._handleServiceInquiry(message);
+            case 'friend-request': {
+                if (this._onFriendRequest) {
+                    await this._onFriendRequest(sender, message);
+                    const resp = { type: 'ack', received: 'friend-request' };
+                    return JSON.stringify(resp);
+                }
+                const resp = { type: 'ack', received: 'friend-request', note: 'no handler registered' };
+                return JSON.stringify(resp);
+            }
+            case 'friend-accept': {
+                if (this._onFriendAccept) {
+                    await this._onFriendAccept(sender, message);
+                    const resp = { type: 'ack', received: 'friend-accept' };
+                    return JSON.stringify(resp);
+                }
+                const resp = { type: 'ack', received: 'friend-accept', note: 'no handler registered' };
+                return JSON.stringify(resp);
+            }
+            case 'capabilities':
+                return JSON.stringify(this.buildCapabilities());
+            default: {
+                const resp = { type: 'ack', received: message.type };
+                return JSON.stringify(resp);
+            }
+        }
+    }
+    async _handleServiceRequest(sender, request) {
+        // Find matching skill (case-insensitive)
+        const skill = this._skills.find(s => s.name.toLowerCase() === request.service.toLowerCase());
+        // Unknown skill
+        if (!skill) {
+            const caps = this.buildCapabilities();
+            const resp = {
+                type: 'service-response',
+                requestId: request.id,
+                status: 'error',
+                result: `Unknown service: ${request.service}`,
+                available: caps.services.map(s => s.name),
+            };
+            return JSON.stringify(resp);
+        }
+        // Paid skill — redirect to HTTP + x402
+        if (skill.price) {
+            const resp = {
+                type: 'service-response',
+                requestId: request.id,
+                status: 'payment-required',
+                result: `${request.service} costs ${skill.price}. Use HTTP with x402 payment.`,
+                httpEndpoint: this._httpEndpoint
+                    ? `${this._httpEndpoint}/api/${skill.name}`
+                    : undefined,
+                usage: `Pay via x402 at ${this._httpEndpoint ?? '<http-endpoint>'}/api/${skill.name}`,
+            };
+            return JSON.stringify(resp);
+        }
+        // Free skill — look up handler
+        const handler = this._handlers.get(skill.name.toLowerCase());
+        if (!handler) {
+            const caps = this.buildCapabilities();
+            const resp = {
+                type: 'service-response',
+                requestId: request.id,
+                status: 'error',
+                result: `No handler registered for service: ${skill.name}`,
+                available: caps.services.map(s => s.name),
+            };
+            return JSON.stringify(resp);
+        }
+        // Execute handler
+        try {
+            const result = await handler(sender, request.payload);
+            const resp = {
+                type: 'service-response',
+                requestId: request.id,
+                status: 'success',
+                result,
+            };
+            return JSON.stringify(resp);
+        }
+        catch (err) {
+            const resp = {
+                type: 'service-response',
+                requestId: request.id,
+                status: 'error',
+                result: err instanceof Error ? err.message : String(err),
+            };
+            return JSON.stringify(resp);
+        }
+    }
+    _handleServiceInquiry(inquiry) {
+        const skill = this._skills.find(s => s.name.toLowerCase() === inquiry.service.toLowerCase());
+        if (skill) {
+            const resp = {
+                type: 'service-details',
+                service: skill.name,
+                available: true,
+                description: skill.description,
+                price: skill.price ?? null,
+                method: skill.method ?? 'POST',
+                paid: !!skill.price,
+                capabilities: skill.tags ?? [],
+                httpEndpoint: this._httpEndpoint
+                    ? `${this._httpEndpoint}/api/${skill.name}`
+                    : undefined,
+                authentication: 'ERC-8128',
+                payment: 'x402',
+            };
+            return JSON.stringify(resp);
+        }
+        const resp = {
+            type: 'service-details',
+            service: inquiry.service,
+            available: false,
+            allServices: this._skills.map(s => s.name),
+        };
+        return JSON.stringify(resp);
+    }
+    // ── Private: Text message fallback ──
+    async _handleTextMessage(sender, content) {
+        // Try custom text fallback handler
+        if (this._textFallbackHandler) {
+            const result = await this._textFallbackHandler(sender, content);
+            if (result !== null) {
+                return result;
+            }
+        }
+        // Default: return capabilities if skills exist
+        if (this._skills.length > 0) {
+            return JSON.stringify(this.buildCapabilities());
+        }
+        // No skills configured
+        return JSON.stringify({
+            type: 'info',
+            message: `This agent (${this._agentName}) has no services configured.`,
+        });
+    }
+}
+//# sourceMappingURL=message-router.js.map

package/dist/messaging/message-router.js.map

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

package/dist/messaging/rate-limiter.d.ts

@@ -0,0 +1,31 @@
+/** Per-sender rate limiter for incoming XMTP messages.
+ *
+ *  Tracks timestamps of recent messages per sender and rejects messages
+ *  that exceed the configured rate. Stale entries are cleaned up on a
+ *  configurable interval.
+ */
+export declare class RateLimiter {
+    private readonly _limits;
+    private readonly _maxPerMinute;
+    /** M-6: Maximum number of tracked senders to prevent unbounded memory growth */
+    private readonly _maxSenders;
+    private _cleanupInterval;
+    /** @param maxPerMinute Maximum messages per sender per minute (default 10)
+     *  @param maxSenders Maximum tracked sender entries before eviction (default 10_000) */
+    constructor(maxPerMinute?: number, maxSenders?: number);
+    /** Check whether a sender is within their rate limit.
+     *
+     *  Records the current timestamp if allowed.
+     *
+     *  @param sender - Sender identifier (typically an address)
+     *  @returns `true` if the message is within the limit, `false` if rate-limited
+     */
+    checkLimit(sender: string): boolean;
+    /** Get remaining message quota for a sender within the current minute window */
+    getRemainingQuota(sender: string): number;
+    /** Purge expired entries from all senders */
+    private _cleanup;
+    /** Stop the cleanup timer and clear all state */
+    destroy(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/messaging/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/messaging/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,gBAAgB,CAA+C;IAEvE;4FACwF;gBAC5E,YAAY,SAAK,EAAE,UAAU,SAAS;IAMlD;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAqBnC,gFAAgF;IAChF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOzC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ;IAYhB,iDAAiD;IACjD,OAAO,IAAI,IAAI;CAOhB"}

package/dist/messaging/rate-limiter.js

@@ -0,0 +1,74 @@
+/** Per-sender rate limiter for incoming XMTP messages.
+ *
+ *  Tracks timestamps of recent messages per sender and rejects messages
+ *  that exceed the configured rate. Stale entries are cleaned up on a
+ *  configurable interval.
+ */
+export class RateLimiter {
+    _limits = new Map();
+    _maxPerMinute;
+    /** M-6: Maximum number of tracked senders to prevent unbounded memory growth */
+    _maxSenders;
+    _cleanupInterval = null;
+    /** @param maxPerMinute Maximum messages per sender per minute (default 10)
+     *  @param maxSenders Maximum tracked sender entries before eviction (default 10_000) */
+    constructor(maxPerMinute = 10, maxSenders = 10_000) {
+        this._maxPerMinute = maxPerMinute;
+        this._maxSenders = maxSenders;
+        this._cleanupInterval = setInterval(() => this._cleanup(), 300_000);
+    }
+    /** Check whether a sender is within their rate limit.
+     *
+     *  Records the current timestamp if allowed.
+     *
+     *  @param sender - Sender identifier (typically an address)
+     *  @returns `true` if the message is within the limit, `false` if rate-limited
+     */
+    checkLimit(sender) {
+        const now = Date.now();
+        const timestamps = this._limits.get(sender) ?? [];
+        const recent = timestamps.filter(ts => now - ts < 60_000);
+        if (recent.length >= this._maxPerMinute) {
+            this._limits.set(sender, recent);
+            return false;
+        }
+        // M-6: Evict oldest sender entry if at capacity (FIFO eviction)
+        if (this._limits.size >= this._maxSenders && !this._limits.has(sender)) {
+            const oldestKey = this._limits.keys().next().value;
+            if (oldestKey !== undefined)
+                this._limits.delete(oldestKey);
+        }
+        recent.push(now);
+        this._limits.set(sender, recent);
+        return true;
+    }
+    /** Get remaining message quota for a sender within the current minute window */
+    getRemainingQuota(sender) {
+        const now = Date.now();
+        const timestamps = this._limits.get(sender) ?? [];
+        const recent = timestamps.filter(ts => now - ts < 60_000);
+        return Math.max(0, this._maxPerMinute - recent.length);
+    }
+    /** Purge expired entries from all senders */
+    _cleanup() {
+        const now = Date.now();
+        for (const [sender, timestamps] of this._limits.entries()) {
+            const recent = timestamps.filter(ts => now - ts < 60_000);
+            if (recent.length === 0) {
+                this._limits.delete(sender);
+            }
+            else {
+                this._limits.set(sender, recent);
+            }
+        }
+    }
+    /** Stop the cleanup timer and clear all state */
+    destroy() {
+        if (this._cleanupInterval) {
+            clearInterval(this._cleanupInterval);
+            this._cleanupInterval = null;
+        }
+        this._limits.clear();
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/messaging/rate-limiter.js.map

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

package/dist/messaging/xmtp.d.ts

@@ -0,0 +1,144 @@
+import { type XMTPMessage, type XMTPConfig, type XMTPConversation, type MessageHandler } from '@azeth/common';
+import type { MessageRouter } from './message-router.js';
+export type { XMTPConfig, XMTPConversation };
+/** Parameters for sending a message via XMTP */
+export interface SendMessageParams {
+    /** Recipient Ethereum address */
+    to: `0x${string}`;
+    /** Message content (text) */
+    content: string;
+    /** Content type hint (default: 'text/plain') */
+    contentType?: string;
+}
+/** Interface for the XMTP messaging client */
+export interface MessagingClient {
+    /** Initialize the client with a private key and optional config */
+    initialize(privateKey: `0x${string}`, config?: XMTPConfig): Promise<void>;
+    /** Send a message to an Ethereum address. Returns the conversation ID. */
+    sendMessage(params: SendMessageParams): Promise<string>;
+    /** Register a handler for incoming messages. Returns an unsubscribe function. */
+    onMessage(handler: MessageHandler): () => void;
+    /** Check if an address is reachable on the XMTP network */
+    canReach(address: `0x${string}`): Promise<boolean>;
+    /** List active conversations */
+    getConversations(): Promise<XMTPConversation[]>;
+    /** Whether the client has been successfully initialized */
+    isReady(): boolean;
+    /** Tear down the client, stopping the agent and clearing state */
+    destroy(): Promise<void>;
+}
+/** XMTP messaging client backed by @xmtp/agent-sdk.
+ *
+ *  Provides E2E encrypted agent-to-agent messaging via the XMTP network.
+ *  Messages are rate-limited per sender and reachability results are cached.
+ */
+export declare class XMTPClient implements MessagingClient {
+    private _agent;
+    /** Static Client class from @xmtp/agent-sdk, used for fetchInboxStates.
+     *  The Agent's client instance doesn't expose this method, so we use the static version. */
+    private _ClientClass;
+    private _xmtpEnv;
+    private _handlers;
+    private _rateLimiter;
+    private _reachabilityCache;
+    private _reachabilityCacheTtlMs;
+    private _maxMessageLength;
+    private _ready;
+    private _listening;
+    private _messageStreamAbort;
+    private _convStreamAbort;
+    private _messageRouter;
+    private _autoReply;
+    /** Initialize the XMTP client with a private key.
+     *
+     *  Creates an XMTP Agent using the provided private key and config.
+     *  Must be called before any messaging operations.
+     *
+     *  @param privateKey - Owner's private key (0x-prefixed hex)
+     *  @param config - Optional XMTP configuration
+     *  @throws AzethError if initialization fails
+     */
+    initialize(privateKey: `0x${string}`, config?: XMTPConfig): Promise<void>;
+    /** Send a text message to an Ethereum address.
+     *
+     *  Checks reachability, creates or finds a DM conversation, then sends.
+     *
+     *  @param params - Message parameters (to, content, contentType)
+     *  @returns The conversation ID
+     *  @throws AzethError if the recipient is unreachable, content exceeds limits, or sending fails
+     */
+    sendMessage(params: SendMessageParams): Promise<string>;
+    /** Register a handler for incoming messages.
+     *
+     *  Starts the agent's message listener on first handler registration.
+     *  Returns an unsubscribe function that removes the handler.
+     *
+     *  @param handler - Async function called for each incoming message
+     *  @returns Unsubscribe function
+     */
+    onMessage(handler: MessageHandler): () => void;
+    /** Check if an Ethereum address is reachable on the XMTP network.
+     *
+     *  Results are cached with a configurable TTL (default 5 minutes).
+     *  Returns `false` on errors rather than throwing.
+     *
+     *  @param address - Ethereum address to check
+     *  @returns Whether the address can receive XMTP messages
+     */
+    canReach(address: `0x${string}`): Promise<boolean>;
+    /** List active XMTP conversations.
+     *
+     *  @returns Array of conversation summaries
+     */
+    getConversations(): Promise<XMTPConversation[]>;
+    /** Read recent messages from a specific conversation.
+     *
+     *  Syncs conversations first, then fetches messages from the conversation
+     *  matching the given ID. Returns messages sorted by timestamp (newest first).
+     *
+     *  @param conversationId - The XMTP conversation ID to read from
+     *  @param limit - Maximum number of messages to return (default 20, max 100)
+     *  @returns Array of messages with sender, content, and timestamp
+     */
+    getMessages(conversationId: string, limit?: number): Promise<XMTPMessage[]>;
+    /** Read recent messages from a conversation with a specific peer address.
+     *
+     *  Convenience method that finds the conversation by peer address
+     *  and reads messages from it.
+     *
+     *  @param peerAddress - The Ethereum address of the conversation peer
+     *  @param limit - Maximum number of messages to return (default 20, max 100)
+     *  @returns Array of messages, or empty array if no conversation found
+     */
+    getMessagesByPeer(peerAddress: `0x${string}`, limit?: number): Promise<XMTPMessage[]>;
+    /** Whether the client has been successfully initialized and is ready */
+    isReady(): boolean;
+    /** Attach a MessageRouter for structured message dispatch.
+     *
+     *  When a router is set and autoReply is enabled (via XMTPConfig or by
+     *  setting autoReply=true here), incoming messages are automatically
+     *  routed through the router and responses sent back to the sender.
+     *
+     *  @param router - The MessageRouter instance to use for dispatch
+     *  @param autoReply - Enable auto-reply (default: uses config value)
+     */
+    setRouter(router: MessageRouter, autoReply?: boolean): void;
+    /** Tear down the XMTP client.
+     *
+     *  Stops the agent, clears all handlers, caches, and timers.
+     */
+    destroy(): Promise<void>;
+    private _requireReady;
+    /** Start streaming incoming messages and new conversations */
+    private _startListening;
+    /** Process a single incoming message from the stream */
+    private _handleIncoming;
+    /** Extract peer address from a conversation object.
+     *
+     *  Uses `peerInboxId` + `client.fetchInboxStates()` to resolve the peer's
+     *  wallet address. This avoids `conv.members()` which throws an internal
+     *  error in XMTP SDK v5 due to private field access issues on listed conversations.
+     */
+    private _extractPeerAddress;
+}
+//# sourceMappingURL=xmtp.d.ts.map

package/dist/messaging/xmtp.d.ts.map

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