@orbinum/sdk 1.1.0 → 1.1.1

package/dist/index.d.mts

@@ -4819,6 +4819,15 @@ interface NoteBackupEntry {
     encryptedMemo: string;
     /** Merkle leaf index, when known. Informational — spends re-fetch the proof. */
     leafIndex?: number;
+    /**
+     * Whether the note was already spent when exported. A local status flag (not
+     * a key or secret), carried so a restored vault separates available from spent
+     * without a chain round-trip. A host may still reconcile against the chain
+     * afterward — this is a fast, possibly-stale hint, not the source of truth.
+     */
+    spent?: boolean;
+    /** Local timestamp the note was marked spent, when known. */
+    spentAt?: number | null;
 }
 interface NoteBackup {
     v: typeof NOTE_BACKUP_VERSION;
@@ -4854,6 +4863,10 @@ declare function decodeNoteBackup(json: string | object): NoteBackupEntry[];
  * Ownership is proven by decryption — an entry whose memo does not open under
  * these keys is silently skipped (it is not this user's note). No chain access:
  * only the backup's own memos are tried.
+ *
+ * The decrypted note is reconstructed as unspent; the entry's `spent`/`spentAt`
+ * flags are then applied so a restored vault separates available from spent. A
+ * host may reconcile against the chain afterward if the backup could be stale.
  */
 declare function importNotesFromBackup(entries: NoteBackupEntry[], keys: BackupImportKeys): ZkNote[];
 

package/dist/index.d.ts

@@ -4819,6 +4819,15 @@ interface NoteBackupEntry {
     encryptedMemo: string;
     /** Merkle leaf index, when known. Informational — spends re-fetch the proof. */
     leafIndex?: number;
+    /**
+     * Whether the note was already spent when exported. A local status flag (not
+     * a key or secret), carried so a restored vault separates available from spent
+     * without a chain round-trip. A host may still reconcile against the chain
+     * afterward — this is a fast, possibly-stale hint, not the source of truth.
+     */
+    spent?: boolean;
+    /** Local timestamp the note was marked spent, when known. */
+    spentAt?: number | null;
 }
 interface NoteBackup {
     v: typeof NOTE_BACKUP_VERSION;
@@ -4854,6 +4863,10 @@ declare function decodeNoteBackup(json: string | object): NoteBackupEntry[];
  * Ownership is proven by decryption — an entry whose memo does not open under
  * these keys is silently skipped (it is not this user's note). No chain access:
  * only the backup's own memos are tried.
+ *
+ * The decrypted note is reconstructed as unspent; the entry's `spent`/`spentAt`
+ * flags are then applied so a restored vault separates available from spent. A
+ * host may reconcile against the chain afterward if the backup could be stale.
  */
 declare function importNotesFromBackup(entries: NoteBackupEntry[], keys: BackupImportKeys): ZkNote[];
 

package/dist/index.js

@@ -6336,7 +6336,9 @@ function noteToBackupEntry(note) {
   return {
     commitmentHex: note.commitmentHex,
     encryptedMemo: toHex(Uint8Array.from(note.memo)),
-    ...note.leafIndex !== void 0 ? { leafIndex: note.leafIndex } : {}
+    ...note.leafIndex !== void 0 ? { leafIndex: note.leafIndex } : {},
+    spent: note.spent,
+    spentAt: note.spentAt
   };
 }
 function encodeNoteBackup(notes, options = {}) {
@@ -6381,7 +6383,13 @@ function importNotesFromBackup(entries, keys) {
       keys.spendingKey,
       keys.ownerPk
     );
-    if (note) out.push(note);
+    if (note) {
+      out.push({
+        ...note,
+        spent: entry.spent ?? false,
+        spentAt: entry.spentAt ?? null
+      });
+    }
   }
   return out;
 }

package/dist/index.mjs

@@ -5232,7 +5232,9 @@ function noteToBackupEntry(note) {
   return {
     commitmentHex: note.commitmentHex,
     encryptedMemo: toHex(Uint8Array.from(note.memo)),
-    ...note.leafIndex !== void 0 ? { leafIndex: note.leafIndex } : {}
+    ...note.leafIndex !== void 0 ? { leafIndex: note.leafIndex } : {},
+    spent: note.spent,
+    spentAt: note.spentAt
   };
 }
 function encodeNoteBackup(notes, options = {}) {
@@ -5277,7 +5279,13 @@ function importNotesFromBackup(entries, keys) {
       keys.spendingKey,
       keys.ownerPk
     );
-    if (note) out.push(note);
+    if (note) {
+      out.push({
+        ...note,
+        spent: entry.spent ?? false,
+        spentAt: entry.spentAt ?? null
+      });
+    }
   }
   return out;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbinum/sdk",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Official TypeScript SDK for Orbinum.",
   "author": "Orbinum",
   "license": "MIT",