@unicitylabs/nostr-js-sdk 0.2.0 → 0.2.1

package/README.md

@@ -190,8 +190,28 @@ const event = await TokenTransferProtocol.createTokenTransferEvent(
 
 await client.publishEvent(event);
 
+// Create token transfer in response to a payment request
+const paymentRequestEventId = '...'; // Event ID of the original payment request
+const event = await TokenTransferProtocol.createTokenTransferEvent(
+  keyManager,
+  recipientPubkey,
+  tokenJson,
+  {
+    amount: 100n,
+    symbol: 'UNIT',
+    replyToEventId: paymentRequestEventId  // Links transfer to the payment request
+  }
+);
+
 // Parse received token transfer
 const tokenJson = await TokenTransferProtocol.parseTokenTransfer(event, keyManager);
+
+// Get reply-to event ID (for payment request correlation)
+const replyToId = TokenTransferProtocol.getReplyToEventId(event);
+if (replyToId) {
+  // This transfer is in response to a payment request
+  const originalRequest = pendingRequests.get(replyToId);
+}
 ```
 
 ### Payment Requests
@@ -286,6 +306,7 @@ Token transfers use Nostr event kind 31113 with NIP-04 encryption.
 | `type` | Yes | Always `"token_transfer"` |
 | `amount` | No | Transfer amount (metadata for filtering) |
 | `symbol` | No | Token symbol (metadata for filtering) |
+| `e` | No | Reply-to event ID (for payment request correlation) |
 
 ### Encrypted Content
 
@@ -310,10 +331,11 @@ gz:<base64_ciphertext>?iv=<base64_iv>
 TokenTransferProtocol.isTokenTransfer(event); // boolean
 
 // Get metadata from tags
-TokenTransferProtocol.getAmount(event);    // bigint | undefined
-TokenTransferProtocol.getSymbol(event);    // string | undefined
-TokenTransferProtocol.getRecipient(event); // string | undefined
-TokenTransferProtocol.getSender(event);    // string
+TokenTransferProtocol.getAmount(event);         // bigint | undefined
+TokenTransferProtocol.getSymbol(event);         // string | undefined
+TokenTransferProtocol.getRecipient(event);      // string | undefined
+TokenTransferProtocol.getSender(event);         // string
+TokenTransferProtocol.getReplyToEventId(event); // string | undefined (payment request correlation)
 ```
 
 ## Payment Request Format
@@ -477,13 +499,13 @@ To test payment requests against a real wallet:
 
 ```bash
 # Send a single payment request
-TARGET_NAMETAG=mp-6 npm test -- --testNamePattern="send single payment request"
+TARGET_NAMETAG=mp-9 npm test -- --testNamePattern="send single payment request"
 
 # Send multiple payment requests (for UI testing)
-TARGET_NAMETAG=mp-6 npm test -- --testNamePattern="send multiple payment requests"
+TARGET_NAMETAG=mp-9 npm test -- --testNamePattern="send multiple payment requests"
 
 # Full flow with token transfer verification (requires wallet interaction)
-TARGET_NAMETAG=mp-6 npm test -- --testNamePattern="full payment request flow"
+TARGET_NAMETAG=mp-9 npm test -- --testNamePattern="full payment request flow"
 ```
 
 Environment variables:

package/dist/browser/index.js

@@ -9824,16 +9824,32 @@ const MESSAGE_PREFIX$1 = 'token_transfer:';
  *   - ["type", "token_transfer"] - Event type
  *   - ["amount", "<amount>"] - Optional amount
  *   - ["symbol", "<symbol>"] - Optional token symbol
+ *   - ["e", "<event_id>", "", "reply"] - Optional reply-to event (for payment request correlation)
  * - Content: NIP-04 encrypted "token_transfer:{tokenJson}"
  *
  * @param keyManager Key manager with signing keys
  * @param recipientPubkeyHex Recipient's public key (hex)
  * @param tokenJson Token JSON string
- * @param amount Optional amount for metadata
- * @param symbol Optional token symbol for metadata
+ * @param amountOrOptions Optional amount for metadata, or options object
+ * @param symbol Optional token symbol for metadata (ignored if options object used)
  * @returns Signed event
  */
-async function createTokenTransferEvent(keyManager, recipientPubkeyHex, tokenJson, amount, symbol) {
+async function createTokenTransferEvent(keyManager, recipientPubkeyHex, tokenJson, amountOrOptions, symbol) {
+    // Parse options (support both old and new signatures)
+    let amount;
+    let tokenSymbol;
+    let replyToEventId;
+    if (amountOrOptions !== undefined && typeof amountOrOptions === 'object') {
+        // New options object signature
+        amount = amountOrOptions.amount;
+        tokenSymbol = amountOrOptions.symbol;
+        replyToEventId = amountOrOptions.replyToEventId;
+    }
+    else {
+        // Old positional arguments signature
+        amount = amountOrOptions;
+        tokenSymbol = symbol;
+    }
     // Encrypt the token data
     const message = MESSAGE_PREFIX$1 + tokenJson;
     const encryptedContent = await keyManager.encryptHex(message, recipientPubkeyHex);
@@ -9845,8 +9861,12 @@ async function createTokenTransferEvent(keyManager, recipientPubkeyHex, tokenJso
     if (amount !== undefined) {
         tags.push(['amount', String(amount)]);
     }
-    if (symbol !== undefined) {
-        tags.push(['symbol', symbol]);
+    if (tokenSymbol !== undefined) {
+        tags.push(['symbol', tokenSymbol]);
+    }
+    // Add optional reply-to event reference (for payment request correlation)
+    if (replyToEventId !== undefined && replyToEventId.length > 0) {
+        tags.push(['e', replyToEventId, '', 'reply']);
     }
     const event = Event.create(keyManager, {
         kind: TOKEN_TRANSFER,
@@ -9934,6 +9954,15 @@ function getAmount$1(event) {
 function getSymbol(event) {
     return event.getTagValue('symbol');
 }
+/**
+ * Get the reply-to event ID from a token transfer event.
+ * Used to correlate token transfers with payment requests.
+ * @param event Token transfer event
+ * @returns Referenced event ID, or undefined if not present
+ */
+function getReplyToEventId(event) {
+    return event.getTagValue('e');
+}
 /**
  * Check if an event is a token transfer.
  * @param event Event to check
@@ -9965,6 +9994,7 @@ var TokenTransferProtocol = /*#__PURE__*/Object.freeze({
     createTokenTransferEvent: createTokenTransferEvent,
     getAmount: getAmount$1,
     getRecipient: getRecipient,
+    getReplyToEventId: getReplyToEventId,
     getSender: getSender$1,
     getSymbol: getSymbol,
     isTokenTransfer: isTokenTransfer,