@contextvm/sdk 0.1.1 → 0.1.3

package/COPYING.LESSER

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -1,3 +1,179 @@
-# ctxvm-sdk
+# @ctxvm/sdk: CTXVM Protocol SDK
 
-`@ctxvm/sdk` is a TypeScript SDK designed to implement the `ctxvm` protocol, providing modular access to core functionalities, relay interactions, and signing operations.
+A JavaScript/TypeScript SDK that implements the Context Vending Machine (CTXVM) Protocol, bridging Nostr and Model Context Protocol (MCP) to enable decentralized access and exposure of computational services.
+
+## Overview
+
+The CTXVM Protocol defines how Nostr and Model Context Machines can be used to expose MCP server capabilities, enabling standardized usage of these resources through a decentralized, cryptographically secure messaging system.
+
+This SDK provides the necessary components to interact with the CTXVM Protocol:
+
+- **Core Module**: Contains fundamental definitions, constants, interfaces, and utilities (e.g., encryption, serialization).
+- **Transports**: Critical for communication, providing `NostrClientTransport` and `NostrServerTransport` implementations for enabling MCP over Nostr.
+- **Proxy**: A client-side MCP server that connects to other servers through Nostr, exposing server capabilities locally. Particularly useful for clients that don't natively support Nostr transport.
+- **Gateway**: Implements Nostr server transport, binding to another MCP server and exposing its capabilities through the Nostr network.
+- **Relay**: Functionality for managing Nostr relays, abstracting relay interactions.
+- **Signer**: Provides cryptographic signing capabilities required for Nostr events.
+
+Both the Proxy and Gateway leverage Nostr transports, allowing existing MCP servers to maintain their conventional transports while gaining Nostr interoperability.
+
+## Installation
+
+This project requires [Bun](https://bun.sh/) (version 1.2.0 or higher).
+
+1.  **Clone the repository:**
+
+    ```bash
+    git clone https://github.com/ContextVM/ts-sdk.git
+    cd ts-sdk
+    ```
+
+2.  **Install dependencies:**
+
+    ```bash
+    bun install
+    ```
+
+3.  **Build the project:**
+    ```bash
+    bun run build
+    ```
+
+## Usage
+
+The SDK provides methods for bridging MCP and Nostr. At its core, the SDK relies on Nostr transports and utilities to facilitate communication.
+
+### Core Building Blocks: Signers and Relay Pools
+
+The SDK provides default implementations: `PrivateKeySigner` implements the `NostrSigner` interface, and `SimpleRelayPool` implements the `RelayHandler` interface. You can extend the SDK's capabilities by creating custom implementations that satisfy these interfaces, allowing you to integrate with different signing mechanisms or relay management logic.ª
+
+### Nostr Transports
+
+The SDK provides specialized transports to send and receive MCP messages over the Nostr network.
+
+#### `NostrClientTransport`
+
+Used by MCP clients to connect to remote MCP servers exposed via Nostr.
+
+```typescript
+import { Client } from '@modelcontextprotocol/sdk/client';
+import { NostrClientTransport } from '@ctxvm/sdk/transport';
+import { EncryptionMode } from '@ctxvm/sdk/core';
+
+// Public key of the target MCP server on Nostr
+const REMOTE_SERVER_PUBKEY = 'remote_server_public_key_here';
+
+const clientNostrTransport = new NostrClientTransport({
+  signer: signer, // Your NostrSigner instance
+  relayHandler: relayPool, // Your RelayHandler instance
+  serverPubkey: REMOTE_SERVER_PUBKEY, // Public key of the target MCP server
+  encryptionMode: EncryptionMode.OPTIONAL, // Optional: REQUIRED, OPTIONAL (default), or DISABLED
+});
+
+const mcpClient = new Client();
+
+// To connect the MCP client:
+await mcpClient.connect(clientNostrTransport);
+// Subsequent MCP calls (e.g., listTools, callTool) would use this transport.
+await mcpClient.listTools();
+// await mcpClient.close();
+```
+
+#### `NostrServerTransport`
+
+Used by MCP servers to expose their capabilities to Nostr clients.
+
+```typescript
+import { McpServer } from '@modelcontextprotocol/sdk/server';
+import { NostrServerTransport } from '@ctxvm/sdk/transport';
+import { EncryptionMode } from '@ctxvm/sdk/core';
+// Assume signer and relayPool are configured as shown above.
+
+const server = new McpServer({
+  name: 'demo-server',
+  version: '1.0.0',
+});
+
+// Before connecting, register your MCP server's capabilities.
+
+const serverNostrTransport = new NostrServerTransport({
+  signer: signer, // Server's NostrSigner instance
+  relayHandler: relayPool, // Server's RelayHandler instance
+  isPublicServer: true, // Optional: set to true to announce server capabilities via Nostr events
+  encryptionMode: EncryptionMode.OPTIONAL, // Optional: REQUIRED, OPTIONAL (default), or DISABLED
+  serverInfo: {
+    // Optional: Information for public announcements
+    name: 'Nostr MCP Example Server',
+    website: 'https://example.com/mcp-server',
+  },
+});
+
+// To connect the MCP server and make it available via Nostr:
+await mcpServer.connect(serverNostrTransport);
+// This will keep the server running and listening for Nostr events.
+// To gracefully shut down: await mcpServer.close();
+```
+
+### Bridging Components: Proxy and Gateway
+
+The SDK also provides higher-level components that leverage these transports to bridge conventional MCP setups with Nostr.
+
+#### `NostrMCPProxy` (Client-Side Bridge)
+
+Allows an MCP client (e.g., a local application communicating via a mcp transport) to communicate with a remote MCP server over Nostr. The proxy acts as a translation layer, using `NostrClientTransport` internally.
+
+```typescript
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/stdio';
+import { NostrMCPProxy } from '@ctxvm/sdk/proxy';
+
+// This transport represents the connection between your local MCP client and the proxy.
+const hostTransport = new StdioServerTransport();
+
+const proxy = new NostrMCPProxy({
+  mcpHostTransport: hostTransport, // Your local client's transport
+  nostrTransportOptions: {
+    signer: signer,
+    relayHandler: relayPool,
+    serverPubkey: REMOTE_SERVER_PUBKEY, // Target the remote MCP server public key via Nostr
+  },
+});
+
+// To start the proxy:
+await proxy.start();
+```
+
+#### `NostrMCPGateway` (Server-Side Bridge)
+
+Allows an existing MCP server (e.g., communicating via a mcp transport) to expose its capabilities through Nostr. The gateway uses `NostrServerTransport` internally.
+
+```typescript
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/stdio';
+import { NostrMCPGateway } from '@ctxvm/sdk/gateway';
+
+// This transport defines how the Gateway connects to your traditional MCP server.
+const serverTransport = new StdioClientTransport({
+  command: 'bun',
+  args: ['path/to/your/mcp-server.ts'],
+});
+
+const gateway = new NostrMCPGateway({
+  mcpServerTransport: serverTransport, // Your existing MCP server's transport
+  nostrTransportOptions: {
+    signer: signer,
+    relayHandler: relayPool,
+    isPublicServer: true, // Set to true to announce server capabilities to Nostr clients for discovery
+  },
+});
+
+// To start the gateway and expose your MCP server to Nostr clients:
+await gateway.start();
+// The gateway will run indefinitely, relaying messages between Nostr and your MCP server.
+```
+
+## Running Tests
+
+To run the test suite, use Bun:
+
+```bash
+bun tests
+```

package/dist/esm/core/constants.d.ts

@@ -0,0 +1,65 @@
+import { AnnouncementMethods } from './interfaces.js';
+/**
+ * CTXVM-specific event kinds.
+ *
+ * All CTXVM messages are ephemeral events.
+ * @see https://github.com/nostr-protocol/nips/blob/master/01.md#kinds
+ */
+export declare const CTXVM_MESSAGES_KIND = 25910;
+/**
+ * Encrypted CTXVM messages using NIP-59 Gift Wrap.
+ * @see https://github.com/nostr-protocol/nips/blob/master/59.md
+ */
+export declare const GIFT_WRAP_KIND = 1059;
+/**
+ * Addressable event for server announcements.
+ */
+export declare const SERVER_ANNOUNCEMENT_KIND = 11316;
+/**
+ * Addressable event for listing available tools.
+ */
+export declare const TOOLS_LIST_KIND = 11317;
+/**
+ * Addressable event for listing available resources.
+ */
+export declare const RESOURCES_LIST_KIND = 11318;
+/**
+ * Addressable event for listing available resources.
+ */
+export declare const RESOURCETEMPLATES_LIST_KIND = 11319;
+/**
+ * Addressable event for listing available prompts.
+ */
+export declare const PROMPTS_LIST_KIND = 11320;
+/**
+ * CTXVM-specific Nostr event tags.
+ */
+export declare const NOSTR_TAGS: {
+    readonly PUBKEY: "p";
+    /**
+     * Event ID for correlating requests and responses.
+     */
+    readonly EVENT_ID: "e";
+    /**
+     * Capability tag for tools, resources, and prompts to provide pricing metadata.
+     */
+    readonly CAPABILITY: "cap";
+    /**
+     * Name tag for server announcements.
+     */
+    readonly NAME: "name";
+    /**
+     * Website tag for server announcements.
+     */
+    readonly WEBSITE: "website";
+    /**
+     * Picture tag for server announcements.
+     */
+    readonly PICTURE: "picture";
+    /**
+     * Support encryption tag for server announcements.
+     */
+    readonly SUPPORT_ENCRYPTION: "support_encryption";
+};
+export declare const announcementMethods: AnnouncementMethods;
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,UAAU;;IAErB;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC;AAEX,eAAO,MAAM,mBAAmB,EAAE,mBAMxB,CAAC"}

package/dist/esm/core/constants.js

@@ -0,0 +1,70 @@
+/**
+ * CTXVM-specific event kinds.
+ *
+ * All CTXVM messages are ephemeral events.
+ * @see https://github.com/nostr-protocol/nips/blob/master/01.md#kinds
+ */
+export const CTXVM_MESSAGES_KIND = 25910;
+/**
+ * Encrypted CTXVM messages using NIP-59 Gift Wrap.
+ * @see https://github.com/nostr-protocol/nips/blob/master/59.md
+ */
+export const GIFT_WRAP_KIND = 1059;
+/**
+ * Addressable event for server announcements.
+ */
+export const SERVER_ANNOUNCEMENT_KIND = 11316;
+/**
+ * Addressable event for listing available tools.
+ */
+export const TOOLS_LIST_KIND = 11317;
+/**
+ * Addressable event for listing available resources.
+ */
+export const RESOURCES_LIST_KIND = 11318;
+/**
+ * Addressable event for listing available resources.
+ */
+export const RESOURCETEMPLATES_LIST_KIND = 11319;
+/**
+ * Addressable event for listing available prompts.
+ */
+export const PROMPTS_LIST_KIND = 11320;
+/**
+ * CTXVM-specific Nostr event tags.
+ */
+export const NOSTR_TAGS = {
+    PUBKEY: 'p',
+    /**
+     * Event ID for correlating requests and responses.
+     */
+    EVENT_ID: 'e',
+    /**
+     * Capability tag for tools, resources, and prompts to provide pricing metadata.
+     */
+    CAPABILITY: 'cap',
+    /**
+     * Name tag for server announcements.
+     */
+    NAME: 'name',
+    /**
+     * Website tag for server announcements.
+     */
+    WEBSITE: 'website',
+    /**
+     * Picture tag for server announcements.
+     */
+    PICTURE: 'picture',
+    /**
+     * Support encryption tag for server announcements.
+     */
+    SUPPORT_ENCRYPTION: 'support_encryption',
+};
+export const announcementMethods = {
+    server: 'initialize',
+    tools: 'tools/list',
+    resources: 'resources/list',
+    resourceTemplates: 'resources/templates/list',
+    prompts: 'prompts/list',
+};
+//# sourceMappingURL=constants.js.map

package/dist/esm/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/constants.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,GAAG;IACX;;OAEG;IACH,QAAQ,EAAE,GAAG;IACb;;OAEG;IACH,UAAU,EAAE,KAAK;IACjB;;OAEG;IACH,IAAI,EAAE,MAAM;IACZ;;OAEG;IACH,OAAO,EAAE,SAAS;IAClB;;OAEG;IACH,OAAO,EAAE,SAAS;IAClB;;OAEG;IACH,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,YAAY;IACnB,SAAS,EAAE,gBAAgB;IAC3B,iBAAiB,EAAE,0BAA0B;IAC7C,OAAO,EAAE,cAAc;CACf,CAAC"}

package/dist/esm/core/encryption.d.ts

@@ -0,0 +1,18 @@
+import { NostrEvent } from 'nostr-tools/pure';
+/**
+ * Encrypts a JSON-RPC message using a simplified NIP-17/NIP-59 gift wrap scheme.
+ * The message is encrypted with NIP-44 and wrapped in a kind 1059 event.
+ * @param message The JSON-RPC message to encrypt.
+ * @param recipientPublicKey The public key of the recipient.
+ * @returns The encrypted gift wrap event.
+ */
+export declare function encryptMessage(message: string, recipientPublicKey: string): NostrEvent;
+/**
+ * Decrypts a gift-wrapped Nostr event.
+ * @param event The gift wrap event (kind 1059).
+ * @param recipientPrivateKey The private key of the recipient.
+ * @returns The decrypted message content.
+ * @throws If the event is not a valid gift wrap or decryption fails.
+ */
+export declare function decryptMessage(event: NostrEvent, recipientPrivateKey: Uint8Array): string;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/esm/core/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../../src/core/encryption.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,UAAU,EACX,MAAM,kBAAkB,CAAC;AAG1B;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,GACzB,UAAU,CAiBZ;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,mBAAmB,EAAE,UAAU,GAC9B,MAAM,CAWR"}

package/dist/esm/core/encryption.js

@@ -0,0 +1,40 @@
+import { nip44 } from 'nostr-tools';
+import { finalizeEvent, generateSecretKey, getPublicKey, } from 'nostr-tools/pure';
+import { GIFT_WRAP_KIND, NOSTR_TAGS } from './constants.js';
+/**
+ * Encrypts a JSON-RPC message using a simplified NIP-17/NIP-59 gift wrap scheme.
+ * The message is encrypted with NIP-44 and wrapped in a kind 1059 event.
+ * @param message The JSON-RPC message to encrypt.
+ * @param recipientPublicKey The public key of the recipient.
+ * @returns The encrypted gift wrap event.
+ */
+export function encryptMessage(message, recipientPublicKey) {
+    const giftWrapPrivateKey = generateSecretKey();
+    const giftWrapPublicKey = getPublicKey(giftWrapPrivateKey);
+    const conversationKey = nip44.v2.utils.getConversationKey(giftWrapPrivateKey, recipientPublicKey);
+    const encryptedContent = nip44.v2.encrypt(message, conversationKey);
+    const giftWrap = {
+        kind: GIFT_WRAP_KIND,
+        content: encryptedContent,
+        tags: [[NOSTR_TAGS.PUBKEY, recipientPublicKey]],
+        created_at: Math.floor(Date.now() / 1000),
+        pubkey: giftWrapPublicKey,
+    };
+    return finalizeEvent(giftWrap, giftWrapPrivateKey);
+}
+/**
+ * Decrypts a gift-wrapped Nostr event.
+ * @param event The gift wrap event (kind 1059).
+ * @param recipientPrivateKey The private key of the recipient.
+ * @returns The decrypted message content.
+ * @throws If the event is not a valid gift wrap or decryption fails.
+ */
+export function decryptMessage(event, recipientPrivateKey) {
+    if (event.kind !== GIFT_WRAP_KIND) {
+        throw new Error('Event is not a gift wrap.');
+    }
+    const conversationKey = nip44.v2.utils.getConversationKey(recipientPrivateKey, event.pubkey);
+    const decryptedMsg = nip44.v2.decrypt(event.content, conversationKey);
+    return decryptedMsg;
+}
+//# sourceMappingURL=encryption.js.map

package/dist/esm/core/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../../src/core/encryption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,GAEb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,kBAA0B;IAE1B,MAAM,kBAAkB,GAAG,iBAAiB,EAAE,CAAC;IAC/C,MAAM,iBAAiB,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,kBAAkB,CACvD,kBAAkB,EAClB,kBAAkB,CACnB,CAAC;IACF,MAAM,gBAAgB,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,gBAAgB;QACzB,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAC/C,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACzC,MAAM,EAAE,iBAAiB;KAC1B,CAAC;IAEF,OAAO,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAiB,EACjB,mBAA+B;IAE/B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,kBAAkB,CACvD,mBAAmB,EACnB,KAAK,CAAC,MAAM,CACb,CAAC;IACF,MAAM,YAAY,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACtE,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/esm/core/index.d.ts

@@ -0,0 +1,5 @@
+export * from './constants.js';
+export * from './interfaces.js';
+export * from './utils/serializers.js';
+export * from './encryption.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC"}

package/dist/esm/core/index.js

@@ -0,0 +1,5 @@
+export * from './constants.js';
+export * from './interfaces.js';
+export * from './utils/serializers.js';
+export * from './encryption.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC"}

package/dist/esm/core/interfaces.d.ts

@@ -0,0 +1,39 @@
+import { InitializeRequest, ListPromptsRequest, ListResourcesRequest, ListResourceTemplatesRequest, ListToolsRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { Filter, NostrEvent } from 'nostr-tools';
+/**
+ * Defines the encryption mode for the transport.
+ * - `optional`: Encrypts messages if the incoming message was encrypted.
+ * - `required`: Enforces encryption for all messages.
+ * - `disabled`: Disables encryption entirely.
+ */
+export declare enum EncryptionMode {
+    OPTIONAL = "optional",
+    REQUIRED = "required",
+    DISABLED = "disabled"
+}
+/**
+ * A generic interface for Nostr signers.
+ */
+export interface NostrSigner {
+    getPublicKey(): Promise<string>;
+    signEvent(event: Omit<NostrEvent, 'sig' | 'id'>): Promise<NostrEvent>;
+    getSecretKey(): Promise<Uint8Array>;
+}
+/**
+ * A generic interface for Nostr relays.
+ */
+export interface RelayHandler {
+    connect(): Promise<void>;
+    disconnect(relayUrls?: string[]): Promise<void>;
+    publish(event: NostrEvent): Promise<void>;
+    subscribe(filters: Filter[], onEvent: (event: NostrEvent) => void, onEose?: () => void): Promise<void>;
+    unsubscribe(): void;
+}
+export interface AnnouncementMethods {
+    server: InitializeRequest['method'];
+    tools: ListToolsRequest['method'];
+    resources: ListResourcesRequest['method'];
+    resourceTemplates: ListResourceTemplatesRequest['method'];
+    prompts: ListPromptsRequest['method'];
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/esm/core/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtE,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,SAAS,CACP,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACpC,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAClC,SAAS,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC1C,iBAAiB,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;CACvC"}

package/dist/esm/core/interfaces.js

@@ -0,0 +1,13 @@
+/**
+ * Defines the encryption mode for the transport.
+ * - `optional`: Encrypts messages if the incoming message was encrypted.
+ * - `required`: Enforces encryption for all messages.
+ * - `disabled`: Disables encryption entirely.
+ */
+export var EncryptionMode;
+(function (EncryptionMode) {
+    EncryptionMode["OPTIONAL"] = "optional";
+    EncryptionMode["REQUIRED"] = "required";
+    EncryptionMode["DISABLED"] = "disabled";
+})(EncryptionMode || (EncryptionMode = {}));
+//# sourceMappingURL=interfaces.js.map

package/dist/esm/core/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/core/interfaces.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,uCAAqB,CAAA;IACrB,uCAAqB,CAAA;AACvB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB"}