@azeth/sdk 0.2.0

package/dist/messaging/xmtp.js

@@ -0,0 +1,473 @@
+import crypto from 'node:crypto';
+import { AzethError, } from '@azeth/common';
+import { RateLimiter } from './rate-limiter.js';
+/** 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 class XMTPClient {
+    // We use `any` for the agent SDK types because they are imported dynamically
+    // and declaring full type stubs would be fragile. The public API is fully typed.
+    _agent = null;
+    /** 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. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _ClientClass = null;
+    _xmtpEnv = 'production';
+    _handlers = [];
+    _rateLimiter = null;
+    _reachabilityCache = new Map();
+    _reachabilityCacheTtlMs = 300_000; // 5 minutes default
+    _maxMessageLength = 10_000;
+    _ready = false;
+    _listening = false;
+    _messageStreamAbort = null;
+    _convStreamAbort = null;
+    _messageRouter = null;
+    _autoReply = false;
+    /** 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
+     */
+    async initialize(privateKey, config) {
+        if (this._ready)
+            return;
+        // Dynamic import of @xmtp/agent-sdk to keep it optional at load time
+        let Agent;
+        let ClientClass;
+        let createUser;
+        let createSigner;
+        try {
+            const sdk = await import('@xmtp/agent-sdk');
+            Agent = sdk.Agent;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            ClientClass = sdk.Client;
+            createUser = sdk.createUser;
+            createSigner = sdk.createSigner;
+        }
+        catch {
+            throw new AzethError('XMTP Agent SDK not installed. Run: pnpm add @xmtp/agent-sdk', 'INVALID_INPUT');
+        }
+        const user = createUser(privateKey);
+        const signer = createSigner(user);
+        // Resolve encryption key: config -> generate
+        let dbEncryptionKey;
+        if (config?.dbEncryptionKey) {
+            const hex = config.dbEncryptionKey.replace(/^0x/, '');
+            if (hex.length !== 64) {
+                throw new AzethError('dbEncryptionKey must be exactly 32 bytes (64 hex chars)', 'INVALID_INPUT', { field: 'dbEncryptionKey' });
+            }
+            dbEncryptionKey = Buffer.from(hex, 'hex');
+        }
+        else {
+            // MEDIUM-7 (Audit): Auto-generating a random encryption key. The XMTP local database
+            // will be encrypted with this ephemeral key. On process restart, the key is lost and
+            // the database becomes unreadable — all XMTP conversation history and group state will
+            // be inaccessible. For persistent messaging, always provide config.dbEncryptionKey.
+            console.warn('[XMTPClient] No dbEncryptionKey provided — auto-generating ephemeral key. '
+                + 'XMTP message history will be LOST on restart. Set dbEncryptionKey for persistence.');
+            dbEncryptionKey = crypto.randomBytes(32);
+        }
+        const env = config?.env ?? 'production';
+        const dbPath = config?.dbPath ?? null;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this._agent = await Agent.create(signer, {
+                env,
+                dbPath,
+                dbEncryptionKey,
+            });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            // Sanitize XMTP-internal identifiers (InboxIDs, hex hashes) from error messages
+            const sanitizedMsg = msg.replace(/[0-9a-fA-F]{32,}/g, '[redacted-id]');
+            throw new AzethError(`XMTP client creation failed: ${sanitizedMsg}`, 'NETWORK_ERROR', { cause: 'xmtp', originalError: e instanceof Error ? e.name : undefined });
+        }
+        // Store Client class + env for static fetchInboxStates calls
+        this._ClientClass = ClientClass ?? null;
+        this._xmtpEnv = env;
+        // Apply config
+        this._reachabilityCacheTtlMs = config?.reachabilityCacheTtlMs ?? 300_000;
+        this._maxMessageLength = config?.maxMessageLength ?? 10_000;
+        this._rateLimiter = new RateLimiter(config?.rateLimitPerMinute ?? 10);
+        this._autoReply = config?.autoReply ?? false;
+        this._ready = true;
+    }
+    /** 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
+     */
+    async sendMessage(params) {
+        this._requireReady();
+        if (params.content.length > this._maxMessageLength) {
+            throw new AzethError(`Message content exceeds maximum length of ${this._maxMessageLength} characters`, 'INVALID_INPUT', { field: 'content', maxLength: this._maxMessageLength });
+        }
+        const reachable = await this.canReach(params.to);
+        if (!reachable) {
+            throw new AzethError(`Recipient ${params.to} is not reachable on the XMTP network`, 'RECIPIENT_UNREACHABLE', { address: params.to });
+        }
+        try {
+            const dm = await this._agent.createDmWithAddress(params.to);
+            await dm.sendText(params.content);
+            return dm.id;
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            // Sanitize XMTP-internal identifiers (InboxIDs, hex hashes) from error messages
+            const sanitizedMsg = msg.replace(/[0-9a-fA-F]{32,}/g, '[redacted-id]');
+            throw new AzethError(`Failed to send XMTP message: ${sanitizedMsg}`, 'NETWORK_ERROR', { cause: 'xmtp', originalError: e instanceof Error ? e.name : undefined });
+        }
+    }
+    /** 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) {
+        this._handlers.push(handler);
+        if (!this._listening && this._ready) {
+            this._startListening();
+        }
+        return () => {
+            this._handlers = this._handlers.filter(h => h !== handler);
+        };
+    }
+    /** 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
+     */
+    async canReach(address) {
+        if (!this._ready || !this._agent)
+            return false;
+        const key = address.toLowerCase();
+        const cached = this._reachabilityCache.get(key);
+        if (cached && Date.now() < cached.expiresAt) {
+            return cached.reachable;
+        }
+        try {
+            const identifier = { identifier: key, identifierKind: 0 };
+            const results = await this._agent.client.canMessage([identifier]);
+            const reachable = results.get(key) ?? results.get(address) ?? false;
+            this._reachabilityCache.set(key, {
+                reachable,
+                expiresAt: Date.now() + this._reachabilityCacheTtlMs,
+            });
+            return reachable;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** List active XMTP conversations.
+     *
+     *  @returns Array of conversation summaries
+     */
+    async getConversations() {
+        if (!this._ready || !this._agent)
+            return [];
+        try {
+            // Include Unknown (0) + Allowed (1) consent states so new incoming DMs are visible.
+            // Without this, only Allowed conversations appear and new contacts are invisible.
+            const consentStates = [0, 1]; // Unknown, Allowed
+            await this._agent.client.conversations.syncAll(consentStates);
+            const conversations = await this._agent.client.conversations.list({ consentStates });
+            const results = [];
+            for (const conv of conversations) {
+                const peerAddress = await this._extractPeerAddress(conv);
+                results.push({
+                    id: conv.id,
+                    peerAddress,
+                    createdAt: conv.createdAt.getTime(),
+                });
+            }
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+    /** 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
+     */
+    async getMessages(conversationId, limit = 20) {
+        if (!this._ready || !this._agent)
+            return [];
+        const clampedLimit = Math.max(1, Math.min(100, limit));
+        try {
+            const consentStates = [0, 1]; // Unknown + Allowed
+            await this._agent.client.conversations.syncAll(consentStates);
+            const conversations = await this._agent.client.conversations.list({ consentStates });
+            const conv = conversations.find(c => c.id === conversationId);
+            if (!conv)
+                return [];
+            // Fetch more than requested to compensate for filtered internal messages
+            const rawMessages = await conv.messages({ limit: clampedLimit + 10 });
+            // Filter out XMTP internal messages (group membership events, etc.)
+            // Only include messages with string content (actual user text).
+            const textMessages = rawMessages.filter(msg => typeof msg.content === 'string');
+            // Batch-resolve sender inbox IDs to Ethereum addresses
+            const uniqueSenders = [...new Set(textMessages.map(m => m.senderInboxId).filter(Boolean))];
+            const senderMap = new Map();
+            if (uniqueSenders.length > 0 && this._ClientClass) {
+                try {
+                    const states = await this._ClientClass.fetchInboxStates(uniqueSenders, this._xmtpEnv);
+                    for (let i = 0; i < states.length; i++) {
+                        const state = states[i];
+                        if (state?.identifiers) {
+                            for (const id of state.identifiers) {
+                                if (id.identifierKind === 0 && id.identifier) {
+                                    senderMap.set(uniqueSenders[i], id.identifier);
+                                    break;
+                                }
+                            }
+                        }
+                    }
+                }
+                catch { /* resolution failed — fall back to inbox IDs */ }
+            }
+            return textMessages.slice(0, clampedLimit).map(msg => ({
+                sender: senderMap.get(msg.senderInboxId) ?? msg.senderInboxId ?? 'unknown',
+                content: msg.content,
+                contentType: 'text/plain',
+                timestamp: Number(msg.sentAtNs / 1000000n), // ns -> ms
+                conversationId,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** 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
+     */
+    async getMessagesByPeer(peerAddress, limit = 20) {
+        const conversations = await this.getConversations();
+        const conv = conversations.find(c => c.peerAddress.toLowerCase() === peerAddress.toLowerCase());
+        if (!conv)
+            return [];
+        return this.getMessages(conv.id, limit);
+    }
+    /** Whether the client has been successfully initialized and is ready */
+    isReady() {
+        return this._ready;
+    }
+    /** 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, autoReply) {
+        this._messageRouter = router;
+        if (autoReply !== undefined) {
+            this._autoReply = autoReply;
+        }
+    }
+    /** Tear down the XMTP client.
+     *
+     *  Stops the agent, clears all handlers, caches, and timers.
+     */
+    async destroy() {
+        this._ready = false;
+        this._listening = false;
+        if (this._messageStreamAbort) {
+            this._messageStreamAbort();
+            this._messageStreamAbort = null;
+        }
+        if (this._convStreamAbort) {
+            this._convStreamAbort();
+            this._convStreamAbort = null;
+        }
+        if (this._agent) {
+            try {
+                await this._agent.stop();
+            }
+            catch {
+                // Best-effort cleanup
+            }
+            this._agent = null;
+        }
+        this._handlers = [];
+        this._reachabilityCache.clear();
+        this._messageRouter = null;
+        this._autoReply = false;
+        if (this._rateLimiter) {
+            this._rateLimiter.destroy();
+            this._rateLimiter = null;
+        }
+    }
+    // ── Private ──────────────────────────────────────
+    _requireReady() {
+        if (!this._ready || !this._agent) {
+            throw new AzethError('XMTP client not initialized. Call initialize() first.', 'INVALID_INPUT');
+        }
+    }
+    /** Start streaming incoming messages and new conversations */
+    _startListening() {
+        if (this._listening || !this._agent)
+            return;
+        this._listening = true;
+        const agent = this._agent;
+        let abortMessages = false;
+        let abortConvs = false;
+        this._messageStreamAbort = () => { abortMessages = true; };
+        this._convStreamAbort = () => { abortConvs = true; };
+        // Stream all messages from existing conversations
+        void (async () => {
+            try {
+                await agent.client.conversations.syncAll([0, 1]); // Unknown + Allowed
+                const stream = await agent.client.conversations.streamAllMessages();
+                for await (const message of stream) {
+                    if (abortMessages)
+                        break;
+                    // Skip our own messages
+                    if (message.senderInboxId === agent.client.inboxId)
+                        continue;
+                    await this._handleIncoming(message);
+                }
+            }
+            catch (err) {
+                if (!abortMessages) {
+                    const msg = err instanceof Error ? err.message : 'Unknown error';
+                    console.error('[XMTPClient] Message stream error:', msg);
+                    this._listening = false;
+                }
+            }
+        })();
+        // Stream new conversations to pick up first messages from new contacts
+        void (async () => {
+            try {
+                const stream = await agent.client.conversations.stream();
+                for await (const conv of stream) {
+                    if (abortConvs)
+                        break;
+                    await conv.sync();
+                }
+            }
+            catch (err) {
+                if (!abortConvs) {
+                    const msg = err instanceof Error ? err.message : 'Unknown error';
+                    console.error('[XMTPClient] Conversation stream error:', msg);
+                }
+            }
+        })();
+    }
+    /** Process a single incoming message from the stream */
+    async _handleIncoming(message) {
+        // Skip XMTP internal messages (group membership events, etc.)
+        if (typeof message.content !== 'string')
+            return;
+        const content = message.content;
+        // Audit #10: Drop oversized messages to prevent memory exhaustion
+        const MAX_MESSAGE_SIZE = 65_536; // 64KB
+        if (content.length > MAX_MESSAGE_SIZE) {
+            return;
+        }
+        // Rate limit per sender inbox ID
+        if (this._rateLimiter && !this._rateLimiter.checkLimit(message.senderInboxId)) {
+            return;
+        }
+        // XMTPMessage.sender is typed as `string` to accommodate XMTP inbox IDs
+        // which are not necessarily valid Ethereum addresses.
+        const sender = message.senderInboxId ?? 'unknown';
+        const xmtpMessage = {
+            sender,
+            content,
+            contentType: 'text/plain',
+            timestamp: Number(message.sentAtNs / 1000000n), // ns -> ms
+            conversationId: message.conversationId,
+        };
+        for (const handler of this._handlers) {
+            try {
+                await handler(xmtpMessage);
+            }
+            catch {
+                // Individual handler errors should not crash the stream
+            }
+        }
+        // Auto-reply via router if enabled
+        if (this._messageRouter && this._autoReply) {
+            try {
+                const response = await this._messageRouter.routeMessage(sender, content);
+                // Send response back to the sender's conversation
+                const conversations = await this._agent.client.conversations.list({ consentStates: [0, 1] });
+                const conv = conversations.find(c => c.id === message.conversationId);
+                if (conv) {
+                    // Use the conversation's send method via DM creation
+                    // (createDmWithAddress handles finding or creating the conversation)
+                    const peerAddress = await this._extractPeerAddress(conv);
+                    const dm = await this._agent.createDmWithAddress(peerAddress);
+                    await dm.sendText(response);
+                }
+            }
+            catch {
+                // Auto-reply errors should not crash the stream
+            }
+        }
+    }
+    /** 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.
+     */
+    async _extractPeerAddress(conv) {
+        try {
+            const peerInboxId = conv.peerInboxId;
+            if (peerInboxId && this._ClientClass) {
+                // Use the static Client.fetchInboxStates — the Agent's client instance
+                // doesn't expose this method despite the type declarations claiming so.
+                const states = await this._ClientClass.fetchInboxStates([peerInboxId], this._xmtpEnv);
+                const state = states?.[0];
+                if (state?.identifiers) {
+                    for (const id of state.identifiers) {
+                        // identifierKind 0 = Ethereum address
+                        if (id.identifierKind === 0 && id.identifier) {
+                            return id.identifier;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // fetchInboxStates can fail on network errors — fall through to sentinel
+        }
+        // L-13 fix (Audit #8): Return a clearly invalid sentinel rather than the zero address,
+        // which could be confused with a real address and cause accidental fund transfers.
+        return '0xdeaddeaddeaddeaddeaddeaddeaddeaddeaddead';
+    }
+}
+//# sourceMappingURL=xmtp.js.map

package/dist/messaging/xmtp.js.map

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

package/dist/payments/agreements.d.ts

@@ -0,0 +1,87 @@
+import { type PublicClient, type WalletClient, type Chain, type Transport, type Account } from 'viem';
+import { type AzethContractAddresses, type PaymentAgreement } from '@azeth/common';
+import type { AzethSmartAccountClient } from '../utils/userop.js';
+export interface CreateAgreementParams {
+    payee: `0x${string}`;
+    token: `0x${string}`;
+    amount: bigint;
+    interval: number;
+    endTime?: bigint;
+    maxExecutions?: number;
+    totalCap?: bigint;
+}
+export interface AgreementResult {
+    agreementId: bigint;
+    txHash: `0x${string}`;
+}
+/** Create a recurring payment agreement via ERC-4337 UserOperation.
+ *
+ *  Routes the call through the smart account so msg.sender = smart account address.
+ *  The SmartAccountClient wraps the PaymentAgreementModule.createAgreement() call
+ *  inside AzethAccount.execute() via a UserOp submitted to EntryPoint v0.7.
+ */
+export declare function createPaymentAgreement(publicClient: PublicClient<Transport, Chain>, smartAccountClient: AzethSmartAccountClient, addresses: AzethContractAddresses, account: `0x${string}`, params: CreateAgreementParams): Promise<AgreementResult>;
+/** Get agreement details */
+export declare function getAgreement(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`, agreementId: bigint): Promise<PaymentAgreement>;
+/** Find an active agreement from a given account to a specific payee.
+ *  Iterates from newest to oldest (newest more likely active).
+ *  Scans at most MAX_AGREEMENT_SCAN agreements to prevent O(n) RPC calls.
+ *
+ *  @param publicClient - viem public client for on-chain reads
+ *  @param addresses - Contract addresses containing paymentAgreementModule
+ *  @param account - The payer's smart account address
+ *  @param payee - The payee address to match
+ *  @param token - Optional token address to filter by
+ *  @returns The first matching active agreement, or null
+ */
+export declare function findAgreementWithPayee(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`, payee: `0x${string}`, token?: `0x${string}`): Promise<PaymentAgreement | null>;
+/** Execute a due payment agreement via ERC-4337 UserOperation.
+ *
+ *  Routes the call through the smart account so msg.sender = smart account address.
+ */
+export declare function executeAgreement(publicClient: PublicClient<Transport, Chain>, smartAccountClient: AzethSmartAccountClient, addresses: AzethContractAddresses, account: `0x${string}`, agreementId: bigint): Promise<`0x${string}`>;
+/** Execute a payment agreement as a third-party keeper.
+ *
+ *  The contract's executeAgreement() is permissionless — any msg.sender can trigger it.
+ *  When the caller is NOT the payer (i.e., it's a keeper or payee), we cannot build a
+ *  UserOp for the payer's smart account (AA24 signature mismatch). Instead:
+ *
+ *  - If the keeper has their own smart account: route via the keeper's SmartAccountClient
+ *    (the keeper's smart account calls the module, which executes on the payer's account)
+ *  - If the keeper has no smart account: call the module directly from the keeper's EOA
+ *    via walletClient.writeContract()
+ */
+export declare function executeAgreementAsKeeper(publicClient: PublicClient<Transport, Chain>, keeperSmartAccountClient: AzethSmartAccountClient | null, walletClient: WalletClient<Transport, Chain, Account>, addresses: AzethContractAddresses, payerAccount: `0x${string}`, agreementId: bigint): Promise<`0x${string}`>;
+/** Cancel an active payment agreement via ERC-4337 UserOperation.
+ *
+ *  Routes the call through the smart account so msg.sender = smart account address.
+ *  Only the payer (agreement creator) can cancel. Immediate effect, no timelock.
+ */
+export declare function cancelAgreement(publicClient: PublicClient<Transport, Chain>, smartAccountClient: AzethSmartAccountClient, addresses: AzethContractAddresses, agreementId: bigint): Promise<`0x${string}`>;
+/** Get the total number of agreements for an account */
+export declare function getAgreementCount(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`): Promise<bigint>;
+/** Check if a payment agreement can be executed right now.
+ *  Returns [executable, reason] — reason explains why if not executable.
+ */
+export declare function canExecutePayment(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`, agreementId: bigint): Promise<{
+    executable: boolean;
+    reason: string;
+}>;
+/** Check if a payment agreement is executable (ignoring interval timing).
+ *  Checks: active, not expired, not maxed, not capped, guardian whitelist,
+ *  guardian limits, and payer balance >= accrued amount. */
+export declare function isAgreementExecutable(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`, agreementId: bigint): Promise<boolean>;
+/** Get comprehensive agreement data in a single RPC call.
+ *  Combines getAgreement + isAgreementExecutable + isAgreementDue +
+ *  getNextExecutionTime + getAgreementCount. */
+export declare function getAgreementData(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`, agreementId: bigint): Promise<{
+    agreement: PaymentAgreement;
+    executable: boolean;
+    reason: string;
+    isDue: boolean;
+    nextExecutionTime: bigint;
+    count: bigint;
+}>;
+/** Get the next execution timestamp for a payment agreement */
+export declare function getNextExecutionTime(publicClient: PublicClient<Transport, Chain>, addresses: AzethContractAddresses, account: `0x${string}`, agreementId: bigint): Promise<bigint>;
+//# sourceMappingURL=agreements.d.ts.map

package/dist/payments/agreements.d.ts.map

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