@elisym/sdk 0.2.1 → 0.3.0

package/dist/index.d.cts

@@ -182,7 +182,7 @@ declare class MediaService {
 }
 
 /**
- * Ping/pong and NIP-17 DM service.
+ * Ephemeral ping/pong service (kinds 20200/20201).
  *
  * Uses a session identity (random keypair) for ping operations to avoid
  * relay rate-limiting. The session identity persists for the lifetime of
@@ -190,7 +190,7 @@ declare class MediaService {
  *
  * Requires `globalThis.crypto` (Node 20+, Bun, browsers).
  */
-declare class MessagingService {
+declare class PingService {
     private pool;
     private static readonly PING_CACHE_MAX;
     private sessionIdentity;
@@ -213,17 +213,6 @@ declare class MessagingService {
     subscribeToPings(identity: ElisymIdentity, onPing: (senderPubkey: string, nonce: string) => void): SubCloser;
     /** Send an ephemeral pong response to ALL relays. */
     sendPong(identity: ElisymIdentity, recipientPubkey: string, nonce: string): Promise<void>;
-    /** Send a NIP-17 DM. */
-    sendMessage(identity: ElisymIdentity, recipientPubkey: string, content: string): Promise<void>;
-    /** Fetch historical NIP-17 DMs from relays. Returns decrypted messages sorted by time. */
-    fetchMessageHistory(identity: ElisymIdentity, since: number): Promise<{
-        senderPubkey: string;
-        content: string;
-        createdAt: number;
-        rumorId: string;
-    }[]>;
-    /** Subscribe to incoming NIP-17 DMs. */
-    subscribeToMessages(identity: ElisymIdentity, onMessage: (senderPubkey: string, content: string, createdAt: number, rumorId: string) => void, since?: number): SubCloser;
 }
 
 interface ElisymClientFullConfig extends ElisymClientConfig {
@@ -235,7 +224,7 @@ declare class ElisymClient {
     readonly pool: NostrPool;
     readonly discovery: DiscoveryService;
     readonly marketplace: MarketplaceService;
-    readonly messaging: MessagingService;
+    readonly ping: PingService;
     readonly media: MediaService;
     readonly payment: PaymentStrategy;
     constructor(config?: ElisymClientFullConfig);
@@ -308,7 +297,6 @@ declare const KIND_JOB_REQUEST_BASE = 5000;
 declare const KIND_JOB_RESULT_BASE = 6000;
 declare const KIND_JOB_FEEDBACK = 7000;
 declare const DEFAULT_KIND_OFFSET = 100;
-declare const KIND_GIFT_WRAP = 1059;
 /** Default job request kind (5000 + 100). */
 declare const KIND_JOB_REQUEST: number;
 /** Default job result kind (6000 + 100). */
@@ -351,8 +339,7 @@ declare const LIMITS: {
     readonly MAX_CAPABILITIES: 20;
     readonly MAX_DESCRIPTION_LENGTH: 500;
     readonly MAX_AGENT_NAME_LENGTH: 64;
-    readonly MAX_MESSAGE_LENGTH: 10000;
     readonly MAX_CAPABILITY_LENGTH: 64;
 };
 
-export { Agent, AgentConfig, BoundedSet, CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, Job, JobSubscriptionOptions, KIND_APP_HANDLER, KIND_GIFT_WRAP, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, MessagingService, Network, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_TREASURY, PaymentRequestData, type PaymentStrategy, PaymentValidationError, PingResult, RELAYS, SolanaPaymentStrategy, SubCloser, SubmitJobOptions, VerifyOptions, VerifyResult, assertExpiry, assertLamports, calculateProtocolFee, formatSol, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
+export { Agent, AgentConfig, BoundedSet, CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, Job, JobSubscriptionOptions, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, Network, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_TREASURY, PaymentRequestData, type PaymentStrategy, PaymentValidationError, PingResult, PingService, RELAYS, SolanaPaymentStrategy, SubCloser, SubmitJobOptions, VerifyOptions, VerifyResult, assertExpiry, assertLamports, calculateProtocolFee, formatSol, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };

package/dist/index.d.ts

@@ -182,7 +182,7 @@ declare class MediaService {
 }
 
 /**
- * Ping/pong and NIP-17 DM service.
+ * Ephemeral ping/pong service (kinds 20200/20201).
  *
  * Uses a session identity (random keypair) for ping operations to avoid
  * relay rate-limiting. The session identity persists for the lifetime of
@@ -190,7 +190,7 @@ declare class MediaService {
  *
  * Requires `globalThis.crypto` (Node 20+, Bun, browsers).
  */
-declare class MessagingService {
+declare class PingService {
     private pool;
     private static readonly PING_CACHE_MAX;
     private sessionIdentity;
@@ -213,17 +213,6 @@ declare class MessagingService {
     subscribeToPings(identity: ElisymIdentity, onPing: (senderPubkey: string, nonce: string) => void): SubCloser;
     /** Send an ephemeral pong response to ALL relays. */
     sendPong(identity: ElisymIdentity, recipientPubkey: string, nonce: string): Promise<void>;
-    /** Send a NIP-17 DM. */
-    sendMessage(identity: ElisymIdentity, recipientPubkey: string, content: string): Promise<void>;
-    /** Fetch historical NIP-17 DMs from relays. Returns decrypted messages sorted by time. */
-    fetchMessageHistory(identity: ElisymIdentity, since: number): Promise<{
-        senderPubkey: string;
-        content: string;
-        createdAt: number;
-        rumorId: string;
-    }[]>;
-    /** Subscribe to incoming NIP-17 DMs. */
-    subscribeToMessages(identity: ElisymIdentity, onMessage: (senderPubkey: string, content: string, createdAt: number, rumorId: string) => void, since?: number): SubCloser;
 }
 
 interface ElisymClientFullConfig extends ElisymClientConfig {
@@ -235,7 +224,7 @@ declare class ElisymClient {
     readonly pool: NostrPool;
     readonly discovery: DiscoveryService;
     readonly marketplace: MarketplaceService;
-    readonly messaging: MessagingService;
+    readonly ping: PingService;
     readonly media: MediaService;
     readonly payment: PaymentStrategy;
     constructor(config?: ElisymClientFullConfig);
@@ -308,7 +297,6 @@ declare const KIND_JOB_REQUEST_BASE = 5000;
 declare const KIND_JOB_RESULT_BASE = 6000;
 declare const KIND_JOB_FEEDBACK = 7000;
 declare const DEFAULT_KIND_OFFSET = 100;
-declare const KIND_GIFT_WRAP = 1059;
 /** Default job request kind (5000 + 100). */
 declare const KIND_JOB_REQUEST: number;
 /** Default job result kind (6000 + 100). */
@@ -351,8 +339,7 @@ declare const LIMITS: {
     readonly MAX_CAPABILITIES: 20;
     readonly MAX_DESCRIPTION_LENGTH: 500;
     readonly MAX_AGENT_NAME_LENGTH: 64;
-    readonly MAX_MESSAGE_LENGTH: 10000;
     readonly MAX_CAPABILITY_LENGTH: 64;
 };
 
-export { Agent, AgentConfig, BoundedSet, CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, Job, JobSubscriptionOptions, KIND_APP_HANDLER, KIND_GIFT_WRAP, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, MessagingService, Network, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_TREASURY, PaymentRequestData, type PaymentStrategy, PaymentValidationError, PingResult, RELAYS, SolanaPaymentStrategy, SubCloser, SubmitJobOptions, VerifyOptions, VerifyResult, assertExpiry, assertLamports, calculateProtocolFee, formatSol, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
+export { Agent, AgentConfig, BoundedSet, CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, Job, JobSubscriptionOptions, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, Network, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_TREASURY, PaymentRequestData, type PaymentStrategy, PaymentValidationError, PingResult, PingService, RELAYS, SolanaPaymentStrategy, SubCloser, SubmitJobOptions, VerifyOptions, VerifyResult, assertExpiry, assertLamports, calculateProtocolFee, formatSol, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };

package/dist/index.js

@@ -2,8 +2,6 @@ import { PublicKey, Keypair, SystemProgram, Transaction } from '@solana/web3.js'
 import Decimal2 from 'decimal.js-light';
 import { verifyEvent, finalizeEvent, getPublicKey, nip19, generateSecretKey, SimplePool } from 'nostr-tools';
 import * as nip44 from 'nostr-tools/nip44';
-import * as nip17 from 'nostr-tools/nip17';
-import * as nip59 from 'nostr-tools/nip59';
 
 // src/constants.ts
 var RELAYS = [
@@ -18,7 +16,6 @@ var KIND_JOB_REQUEST_BASE = 5e3;
 var KIND_JOB_RESULT_BASE = 6e3;
 var KIND_JOB_FEEDBACK = 7e3;
 var DEFAULT_KIND_OFFSET = 100;
-var KIND_GIFT_WRAP = 1059;
 var KIND_JOB_REQUEST = KIND_JOB_REQUEST_BASE + DEFAULT_KIND_OFFSET;
 var KIND_JOB_RESULT = KIND_JOB_RESULT_BASE + DEFAULT_KIND_OFFSET;
 function jobRequestKind(offset) {
@@ -62,7 +59,6 @@ var LIMITS = {
   MAX_CAPABILITIES: 20,
   MAX_DESCRIPTION_LENGTH: 500,
   MAX_AGENT_NAME_LENGTH: 64,
-  MAX_MESSAGE_LENGTH: 1e4,
   MAX_CAPABILITY_LENGTH: 64
 };
 function assertLamports(value, field) {
@@ -1529,38 +1525,6 @@ var MediaService = class {
     }
   }
 };
-
-// src/primitives/bounded-set.ts
-var BoundedSet = class {
-  constructor(maxSize) {
-    this.maxSize = maxSize;
-    if (maxSize <= 0) {
-      throw new Error("BoundedSet maxSize must be positive.");
-    }
-    this.items = new Array(maxSize);
-  }
-  items;
-  set = /* @__PURE__ */ new Set();
-  head = 0;
-  count = 0;
-  has(item) {
-    return this.set.has(item);
-  }
-  add(item) {
-    if (this.set.has(item)) {
-      return;
-    }
-    if (this.count >= this.maxSize) {
-      const evicted = this.items[this.head];
-      this.set.delete(evicted);
-    } else {
-      this.count++;
-    }
-    this.items[this.head] = item;
-    this.head = (this.head + 1) % this.maxSize;
-    this.set.add(item);
-  }
-};
 var ElisymIdentity = class _ElisymIdentity {
   _secretKey;
   publicKey;
@@ -1601,8 +1565,8 @@ var ElisymIdentity = class _ElisymIdentity {
   }
 };
 
-// src/services/messaging.ts
-var MessagingService = class _MessagingService {
+// src/services/ping.ts
+var PingService = class _PingService {
   // dedup in-flight pings
   constructor(pool) {
     this.pool = pool;
@@ -1627,7 +1591,7 @@ var MessagingService = class _MessagingService {
       }
       this.pingCache.delete(agentPubkey);
     }
-    if (this.pingCache.size > _MessagingService.PING_CACHE_MAX / 2) {
+    if (this.pingCache.size > _PingService.PING_CACHE_MAX / 2) {
       const now = Date.now();
       for (const [key, ts] of this.pingCache) {
         if (now - ts >= DEFAULTS.PING_CACHE_TTL_MS) {
@@ -1639,7 +1603,7 @@ var MessagingService = class _MessagingService {
     if (pending) {
       return pending;
     }
-    if (this.pendingPings.size >= _MessagingService.PING_CACHE_MAX) {
+    if (this.pendingPings.size >= _PingService.PING_CACHE_MAX) {
       return { online: false, identity: null };
     }
     const promise = this._doPingWithRetry(agentPubkey, timeoutMs, retries, signal);
@@ -1688,7 +1652,7 @@ var MessagingService = class _MessagingService {
       if (online) {
         this.pingCache.delete(agentPubkey);
         this.pingCache.set(agentPubkey, Date.now());
-        if (this.pingCache.size > _MessagingService.PING_CACHE_MAX) {
+        if (this.pingCache.size > _PingService.PING_CACHE_MAX) {
           const oldest = this.pingCache.keys().next().value;
           if (oldest !== void 0) {
             this.pingCache.delete(oldest);
@@ -1772,75 +1736,41 @@ var MessagingService = class _MessagingService {
     );
     await this.pool.publishAll(pongEvent);
   }
-  /** Send a NIP-17 DM. */
-  async sendMessage(identity, recipientPubkey, content) {
-    if (!/^[0-9a-f]{64}$/.test(recipientPubkey)) {
-      throw new Error("Invalid recipient pubkey: expected 64 hex characters.");
-    }
-    if (content.length > LIMITS.MAX_MESSAGE_LENGTH) {
-      throw new Error(
-        `Message too long: ${content.length} chars (max ${LIMITS.MAX_MESSAGE_LENGTH}).`
-      );
+};
+
+// src/primitives/bounded-set.ts
+var BoundedSet = class {
+  constructor(maxSize) {
+    this.maxSize = maxSize;
+    if (maxSize <= 0) {
+      throw new Error("BoundedSet maxSize must be positive.");
     }
-    const wrap = nip17.wrapEvent(identity.secretKey, { publicKey: recipientPubkey }, content);
-    await this.pool.publish(wrap);
+    this.items = new Array(maxSize);
   }
-  /** Fetch historical NIP-17 DMs from relays. Returns decrypted messages sorted by time. */
-  async fetchMessageHistory(identity, since) {
-    const events = await this.pool.querySync({
-      kinds: [KIND_GIFT_WRAP],
-      "#p": [identity.publicKey],
-      since
-    });
-    const seen = new BoundedSet(1e4);
-    const messages = [];
-    for (const ev of events) {
-      try {
-        const rumor = nip59.unwrapEvent(ev, identity.secretKey);
-        if (rumor.kind !== 14) {
-          continue;
-        }
-        if (seen.has(rumor.id)) {
-          continue;
-        }
-        seen.add(rumor.id);
-        messages.push({
-          senderPubkey: rumor.pubkey,
-          content: rumor.content,
-          createdAt: rumor.created_at,
-          rumorId: rumor.id
-        });
-      } catch {
-      }
-    }
-    return messages.sort((a, b) => a.createdAt - b.createdAt);
+  items;
+  set = /* @__PURE__ */ new Set();
+  head = 0;
+  count = 0;
+  has(item) {
+    return this.set.has(item);
   }
-  /** Subscribe to incoming NIP-17 DMs. */
-  subscribeToMessages(identity, onMessage, since) {
-    const seen = new BoundedSet(1e4);
-    const filter = {
-      kinds: [KIND_GIFT_WRAP],
-      "#p": [identity.publicKey]
-    };
-    if (since !== void 0) {
-      filter.since = since;
+  add(item) {
+    if (this.set.has(item)) {
+      return;
     }
-    return this.pool.subscribe(filter, (ev) => {
-      try {
-        const rumor = nip59.unwrapEvent(ev, identity.secretKey);
-        if (rumor.kind !== 14) {
-          return;
-        }
-        if (seen.has(rumor.id)) {
-          return;
-        }
-        seen.add(rumor.id);
-        onMessage(rumor.pubkey, rumor.content, rumor.created_at, rumor.id);
-      } catch {
-      }
-    });
+    if (this.count >= this.maxSize) {
+      const evicted = this.items[this.head];
+      this.set.delete(evicted);
+    } else {
+      this.count++;
+    }
+    this.items[this.head] = item;
+    this.head = (this.head + 1) % this.maxSize;
+    this.set.add(item);
   }
 };
+
+// src/transport/pool.ts
 var NostrPool = class {
   pool;
   relays;
@@ -2087,14 +2017,14 @@ var ElisymClient = class {
   pool;
   discovery;
   marketplace;
-  messaging;
+  ping;
   media;
   payment;
   constructor(config = {}) {
     this.pool = new NostrPool(config.relays ?? RELAYS);
     this.discovery = new DiscoveryService(this.pool);
     this.marketplace = new MarketplaceService(this.pool);
-    this.messaging = new MessagingService(this.pool);
+    this.ping = new PingService(this.pool);
     this.media = new MediaService(config.uploadUrl);
     this.payment = config.payment ?? new SolanaPaymentStrategy();
   }
@@ -2161,6 +2091,6 @@ function serializeConfig(config) {
   return JSON.stringify(config, null, 2) + "\n";
 }
 
-export { BoundedSet, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymIdentity, KIND_APP_HANDLER, KIND_GIFT_WRAP, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, MessagingService, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_TREASURY, RELAYS, SolanaPaymentStrategy, assertExpiry, assertLamports, calculateProtocolFee, formatSol, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
+export { BoundedSet, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymIdentity, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_TREASURY, PingService, RELAYS, SolanaPaymentStrategy, assertExpiry, assertLamports, calculateProtocolFee, formatSol, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map