@miden-sdk/miden-wallet-adapter-base 0.13.1 → 0.13.3

package/__tests__/adapter.test.ts

@@ -0,0 +1,82 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import {
+  WalletReadyState,
+  BaseWalletAdapter,
+  scopePollingDetectionStrategy,
+} from '../adapter';
+
+describe('WalletReadyState enum', () => {
+  it('has correct values', () => {
+    expect(WalletReadyState.Installed).toBe('Installed');
+    expect(WalletReadyState.NotDetected).toBe('NotDetected');
+    expect(WalletReadyState.Loadable).toBe('Loadable');
+    expect(WalletReadyState.Unsupported).toBe('Unsupported');
+  });
+});
+
+describe('BaseWalletAdapter', () => {
+  // Concrete subclass for testing
+  class TestAdapter extends BaseWalletAdapter {
+    name = 'Test' as any;
+    url = 'https://test.com';
+    icon = 'icon';
+    readyState = WalletReadyState.Installed;
+    address: string | null = null;
+    publicKey: Uint8Array | null = null;
+    connecting = false;
+    supportedTransactionVersions = null;
+
+    async connect() {}
+    async disconnect() {}
+  }
+
+  it('connected returns true when address is set', () => {
+    const adapter = new TestAdapter();
+    adapter.address = '0xabc';
+    expect(adapter.connected).toBe(true);
+  });
+
+  it('connected returns false when address is null', () => {
+    const adapter = new TestAdapter();
+    expect(adapter.connected).toBe(false);
+  });
+});
+
+describe('scopePollingDetectionStrategy', () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it('calls detect immediately and cleans up on detection', () => {
+    const detect = vi.fn().mockReturnValue(true);
+    scopePollingDetectionStrategy(detect);
+    expect(detect).toHaveBeenCalled();
+  });
+
+  it('sets up polling interval when not immediately detected', () => {
+    let callCount = 0;
+    const detect = vi.fn(() => {
+      callCount++;
+      return callCount >= 3;
+    });
+
+    scopePollingDetectionStrategy(detect);
+    // First call is immediate (returns false)
+    expect(detect).toHaveBeenCalledTimes(1);
+
+    // Advance timer to trigger interval
+    vi.advanceTimersByTime(1000);
+    expect(detect).toHaveBeenCalledTimes(2);
+
+    vi.advanceTimersByTime(1000);
+    expect(detect).toHaveBeenCalledTimes(3);
+
+    // After detection (callCount >= 3), interval should be cleared
+    vi.advanceTimersByTime(1000);
+    expect(detect).toHaveBeenCalledTimes(3);
+  });
+});

package/__tests__/errors.test.ts

@@ -0,0 +1,100 @@
+import { describe, it, expect } from 'vitest';
+import {
+  WalletError,
+  WalletNotReadyError,
+  WalletLoadError,
+  WalletConfigError,
+  WalletConnectionError,
+  WalletNotSelectedError,
+  WalletDisconnectedError,
+  WalletDisconnectionError,
+  WalletAccountError,
+  WalletAddressError,
+  WalletKeypairError,
+  WalletNotConnectedError,
+  WalletSendTransactionError,
+  WalletSignMessageError,
+  WalletSignTransactionError,
+  WalletTimeoutError,
+  WalletWindowBlockedError,
+  WalletWindowClosedError,
+  WalletDecryptionNotAllowedError,
+  WalletPrivateDataPermissionError,
+  WalletDecryptionError,
+  WalletRecordsError,
+  WalletTransactionError,
+} from '../errors';
+
+const errorClasses = [
+  { Class: WalletNotReadyError, name: 'WalletNotReadyError' },
+  { Class: WalletLoadError, name: 'WalletLoadError' },
+  { Class: WalletConfigError, name: 'WalletConfigError' },
+  { Class: WalletConnectionError, name: 'WalletConnectionError' },
+  { Class: WalletNotSelectedError, name: 'WalletNotSelectedError' },
+  { Class: WalletDisconnectedError, name: 'WalletDisconnectedError' },
+  { Class: WalletDisconnectionError, name: 'WalletDisconnectionError' },
+  { Class: WalletAccountError, name: 'WalletAccountError' },
+  { Class: WalletAddressError, name: 'WalletAddressError' },
+  { Class: WalletKeypairError, name: 'WalletKeypairError' },
+  { Class: WalletNotConnectedError, name: 'WalletNotConnectedError' },
+  { Class: WalletSendTransactionError, name: 'WalletSendTransactionError' },
+  { Class: WalletSignMessageError, name: 'WalletSignMessageError' },
+  { Class: WalletSignTransactionError, name: 'WalletSignTransactionError' },
+  { Class: WalletTimeoutError, name: 'WalletTimeoutError' },
+  { Class: WalletWindowBlockedError, name: 'WalletWindowBlockedError' },
+  { Class: WalletWindowClosedError, name: 'WalletWindowClosedError' },
+  {
+    Class: WalletDecryptionNotAllowedError,
+    name: 'WalletDecryptionNotAllowedError',
+  },
+  {
+    Class: WalletPrivateDataPermissionError,
+    name: 'WalletPrivateDataPermissionError',
+  },
+  { Class: WalletDecryptionError, name: 'WalletDecryptionError' },
+  { Class: WalletRecordsError, name: 'WalletRecordsError' },
+  { Class: WalletTransactionError, name: 'WalletTransactionError' },
+] as const;
+
+describe('WalletError', () => {
+  it('extends Error', () => {
+    const err = new WalletError('test message');
+    expect(err).toBeInstanceOf(Error);
+    expect(err).toBeInstanceOf(WalletError);
+  });
+
+  it('sets message property', () => {
+    const err = new WalletError('my message');
+    expect(err.message).toBe('my message');
+  });
+
+  it('stores inner error', () => {
+    const inner = new Error('inner');
+    const err = new WalletError('outer', inner);
+    expect(err.error).toBe(inner);
+  });
+});
+
+describe('error subclasses', () => {
+  for (const { Class, name } of errorClasses) {
+    describe(name, () => {
+      it('extends WalletError and Error', () => {
+        const err = new Class();
+        expect(err).toBeInstanceOf(WalletError);
+        expect(err).toBeInstanceOf(Error);
+      });
+
+      it('has correct name property', () => {
+        const err = new Class();
+        expect(err.name).toBe(name);
+      });
+
+      it('stores inner error', () => {
+        const inner = new Error('cause');
+        const err = new Class('msg', inner);
+        expect(err.error).toBe(inner);
+        expect(err.message).toBe('msg');
+      });
+    });
+  }
+});

package/__tests__/helpers.test.ts

@@ -0,0 +1,39 @@
+import { describe, it, expect } from 'vitest';
+import { u8ToB64, b64ToU8 } from '../helpers';
+
+describe('u8ToB64', () => {
+  it('encodes a known value correctly', () => {
+    const bytes = new Uint8Array([72, 101, 108, 108, 111]); // "Hello"
+    expect(u8ToB64(bytes)).toBe('SGVsbG8=');
+  });
+
+  it('encodes an empty array', () => {
+    expect(u8ToB64(new Uint8Array([]))).toBe('');
+  });
+});
+
+describe('b64ToU8', () => {
+  it('decodes a known value correctly', () => {
+    const result = b64ToU8('SGVsbG8=');
+    expect(result).toEqual(new Uint8Array([72, 101, 108, 108, 111]));
+  });
+
+  it('decodes an empty string', () => {
+    expect(b64ToU8('')).toEqual(new Uint8Array([]));
+  });
+});
+
+describe('roundtrip', () => {
+  it('encode then decode returns original bytes', () => {
+    const original = new Uint8Array([0, 1, 127, 128, 255]);
+    const decoded = b64ToU8(u8ToB64(original));
+    expect(decoded).toEqual(original);
+  });
+
+  it('handles a large array (256 bytes)', () => {
+    const original = new Uint8Array(256);
+    for (let i = 0; i < 256; i++) original[i] = i;
+    const decoded = b64ToU8(u8ToB64(original));
+    expect(decoded).toEqual(original);
+  });
+});

package/__tests__/transaction.test.ts

@@ -0,0 +1,166 @@
+import { describe, it, expect, vi } from 'vitest';
+import {
+  SendTransaction,
+  ConsumeTransaction,
+  CustomTransaction,
+  Transaction,
+  TransactionType,
+} from '../transaction';
+import { u8ToB64 } from '../helpers';
+
+describe('TransactionType enum', () => {
+  it('has correct values', () => {
+    expect(TransactionType.Send).toBe('send');
+    expect(TransactionType.Consume).toBe('consume');
+    expect(TransactionType.Custom).toBe('custom');
+  });
+});
+
+describe('SendTransaction', () => {
+  it('sets all fields correctly', () => {
+    const tx = new SendTransaction(
+      'sender-addr',
+      'recipient-addr',
+      'faucet-123',
+      'public',
+      1000
+    );
+    expect(tx.senderAddress).toBe('sender-addr');
+    expect(tx.recipientAddress).toBe('recipient-addr');
+    expect(tx.faucetId).toBe('faucet-123');
+    expect(tx.noteType).toBe('public');
+    expect(tx.amount).toBe(1000);
+    expect(tx.recallBlocks).toBeUndefined();
+  });
+
+  it('sets optional recallBlocks', () => {
+    const tx = new SendTransaction(
+      'sender',
+      'recipient',
+      'faucet',
+      'private',
+      500,
+      10
+    );
+    expect(tx.recallBlocks).toBe(10);
+  });
+});
+
+describe('ConsumeTransaction', () => {
+  it('sets fields correctly', () => {
+    const tx = new ConsumeTransaction('faucet-1', 'note-1', 'public', 100);
+    expect(tx.faucetId).toBe('faucet-1');
+    expect(tx.noteId).toBe('note-1');
+    expect(tx.noteType).toBe('public');
+    expect(tx.amount).toBe(100);
+    expect(tx.noteBytes).toBeUndefined();
+  });
+
+  it('converts noteBytes Uint8Array to base64', () => {
+    const bytes = new Uint8Array([1, 2, 3]);
+    const tx = new ConsumeTransaction('faucet', 'note', 'private', 50, bytes);
+    expect(tx.noteBytes).toBe(u8ToB64(bytes));
+  });
+
+  it('leaves noteBytes undefined when not provided', () => {
+    const tx = new ConsumeTransaction('faucet', 'note', 'public', 50);
+    expect(tx.noteBytes).toBeUndefined();
+  });
+});
+
+describe('CustomTransaction', () => {
+  it('serializes transactionRequest to base64', () => {
+    const mockBytes = new Uint8Array([10, 20, 30]);
+    const mockRequest = {
+      serialize: vi.fn().mockReturnValue(mockBytes),
+    } as any;
+
+    const tx = new CustomTransaction('addr', 'recipient', mockRequest);
+    expect(mockRequest.serialize).toHaveBeenCalled();
+    expect(tx.transactionRequest).toBe(u8ToB64(mockBytes));
+    expect(tx.address).toBe('addr');
+    expect(tx.recipientAddress).toBe('recipient');
+  });
+
+  it('sets optional inputNoteIds', () => {
+    const mockRequest = {
+      serialize: vi.fn().mockReturnValue(new Uint8Array([1])),
+    } as any;
+    const tx = new CustomTransaction('addr', 'recipient', mockRequest, [
+      'id1',
+      'id2',
+    ]);
+    expect(tx.inputNoteIds).toEqual(['id1', 'id2']);
+  });
+
+  it('converts importNotes from Uint8Array[] to base64 strings', () => {
+    const mockRequest = {
+      serialize: vi.fn().mockReturnValue(new Uint8Array([1])),
+    } as any;
+    const noteBytes = [new Uint8Array([4, 5]), new Uint8Array([6, 7])];
+    const tx = new CustomTransaction(
+      'addr',
+      'recipient',
+      mockRequest,
+      ['id1'],
+      noteBytes
+    );
+    expect(tx.importNotes).toEqual([
+      u8ToB64(noteBytes[0]),
+      u8ToB64(noteBytes[1]),
+    ]);
+  });
+
+  it('leaves optional fields undefined when not provided', () => {
+    const mockRequest = {
+      serialize: vi.fn().mockReturnValue(new Uint8Array([1])),
+    } as any;
+    const tx = new CustomTransaction('addr', 'recipient', mockRequest);
+    expect(tx.inputNoteIds).toBeUndefined();
+    expect(tx.importNotes).toBeUndefined();
+  });
+});
+
+describe('Transaction factory', () => {
+  it('createSendTransaction returns correct type and payload', () => {
+    const tx = Transaction.createSendTransaction(
+      'sender',
+      'recipient',
+      'faucet',
+      'public',
+      100
+    );
+    expect(tx.type).toBe(TransactionType.Send);
+    expect(tx.payload).toBeInstanceOf(SendTransaction);
+    const payload = tx.payload as SendTransaction;
+    expect(payload.senderAddress).toBe('sender');
+    expect(payload.amount).toBe(100);
+  });
+
+  it('createConsumeTransaction returns correct type and payload', () => {
+    const tx = Transaction.createConsumeTransaction(
+      'faucet',
+      'note-id',
+      'private',
+      200
+    );
+    expect(tx.type).toBe(TransactionType.Consume);
+    expect(tx.payload).toBeInstanceOf(ConsumeTransaction);
+    const payload = tx.payload as ConsumeTransaction;
+    expect(payload.faucetId).toBe('faucet');
+    expect(payload.noteId).toBe('note-id');
+  });
+
+  it('createCustomTransaction returns correct type and payload', () => {
+    const mockRequest = {
+      serialize: vi.fn().mockReturnValue(new Uint8Array([1, 2])),
+    } as any;
+    const tx = Transaction.createCustomTransaction(
+      'addr',
+      'recipient',
+      mockRequest
+    );
+    expect(tx.type).toBe(TransactionType.Custom);
+    expect(tx.payload).toBeInstanceOf(CustomTransaction);
+  });
+});

package/dist/__tests__/adapter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/adapter.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { WalletReadyState, BaseWalletAdapter, scopePollingDetectionStrategy, } from '../adapter';
+describe('WalletReadyState enum', () => {
+    it('has correct values', () => {
+        expect(WalletReadyState.Installed).toBe('Installed');
+        expect(WalletReadyState.NotDetected).toBe('NotDetected');
+        expect(WalletReadyState.Loadable).toBe('Loadable');
+        expect(WalletReadyState.Unsupported).toBe('Unsupported');
+    });
+});
+describe('BaseWalletAdapter', () => {
+    // Concrete subclass for testing
+    class TestAdapter extends BaseWalletAdapter {
+        name = 'Test';
+        url = 'https://test.com';
+        icon = 'icon';
+        readyState = WalletReadyState.Installed;
+        address = null;
+        publicKey = null;
+        connecting = false;
+        supportedTransactionVersions = null;
+        async connect() { }
+        async disconnect() { }
+    }
+    it('connected returns true when address is set', () => {
+        const adapter = new TestAdapter();
+        adapter.address = '0xabc';
+        expect(adapter.connected).toBe(true);
+    });
+    it('connected returns false when address is null', () => {
+        const adapter = new TestAdapter();
+        expect(adapter.connected).toBe(false);
+    });
+});
+describe('scopePollingDetectionStrategy', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('calls detect immediately and cleans up on detection', () => {
+        const detect = vi.fn().mockReturnValue(true);
+        scopePollingDetectionStrategy(detect);
+        expect(detect).toHaveBeenCalled();
+    });
+    it('sets up polling interval when not immediately detected', () => {
+        let callCount = 0;
+        const detect = vi.fn(() => {
+            callCount++;
+            return callCount >= 3;
+        });
+        scopePollingDetectionStrategy(detect);
+        // First call is immediate (returns false)
+        expect(detect).toHaveBeenCalledTimes(1);
+        // Advance timer to trigger interval
+        vi.advanceTimersByTime(1000);
+        expect(detect).toHaveBeenCalledTimes(2);
+        vi.advanceTimersByTime(1000);
+        expect(detect).toHaveBeenCalledTimes(3);
+        // After detection (callCount >= 3), interval should be cleared
+        vi.advanceTimersByTime(1000);
+        expect(detect).toHaveBeenCalledTimes(3);
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

package/dist/__tests__/adapter.test.js.map

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

package/dist/__tests__/errors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/errors.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from 'vitest';
+import { WalletError, WalletNotReadyError, WalletLoadError, WalletConfigError, WalletConnectionError, WalletNotSelectedError, WalletDisconnectedError, WalletDisconnectionError, WalletAccountError, WalletAddressError, WalletKeypairError, WalletNotConnectedError, WalletSendTransactionError, WalletSignMessageError, WalletSignTransactionError, WalletTimeoutError, WalletWindowBlockedError, WalletWindowClosedError, WalletDecryptionNotAllowedError, WalletPrivateDataPermissionError, WalletDecryptionError, WalletRecordsError, WalletTransactionError, } from '../errors';
+const errorClasses = [
+    { Class: WalletNotReadyError, name: 'WalletNotReadyError' },
+    { Class: WalletLoadError, name: 'WalletLoadError' },
+    { Class: WalletConfigError, name: 'WalletConfigError' },
+    { Class: WalletConnectionError, name: 'WalletConnectionError' },
+    { Class: WalletNotSelectedError, name: 'WalletNotSelectedError' },
+    { Class: WalletDisconnectedError, name: 'WalletDisconnectedError' },
+    { Class: WalletDisconnectionError, name: 'WalletDisconnectionError' },
+    { Class: WalletAccountError, name: 'WalletAccountError' },
+    { Class: WalletAddressError, name: 'WalletAddressError' },
+    { Class: WalletKeypairError, name: 'WalletKeypairError' },
+    { Class: WalletNotConnectedError, name: 'WalletNotConnectedError' },
+    { Class: WalletSendTransactionError, name: 'WalletSendTransactionError' },
+    { Class: WalletSignMessageError, name: 'WalletSignMessageError' },
+    { Class: WalletSignTransactionError, name: 'WalletSignTransactionError' },
+    { Class: WalletTimeoutError, name: 'WalletTimeoutError' },
+    { Class: WalletWindowBlockedError, name: 'WalletWindowBlockedError' },
+    { Class: WalletWindowClosedError, name: 'WalletWindowClosedError' },
+    {
+        Class: WalletDecryptionNotAllowedError,
+        name: 'WalletDecryptionNotAllowedError',
+    },
+    {
+        Class: WalletPrivateDataPermissionError,
+        name: 'WalletPrivateDataPermissionError',
+    },
+    { Class: WalletDecryptionError, name: 'WalletDecryptionError' },
+    { Class: WalletRecordsError, name: 'WalletRecordsError' },
+    { Class: WalletTransactionError, name: 'WalletTransactionError' },
+];
+describe('WalletError', () => {
+    it('extends Error', () => {
+        const err = new WalletError('test message');
+        expect(err).toBeInstanceOf(Error);
+        expect(err).toBeInstanceOf(WalletError);
+    });
+    it('sets message property', () => {
+        const err = new WalletError('my message');
+        expect(err.message).toBe('my message');
+    });
+    it('stores inner error', () => {
+        const inner = new Error('inner');
+        const err = new WalletError('outer', inner);
+        expect(err.error).toBe(inner);
+    });
+});
+describe('error subclasses', () => {
+    for (const { Class, name } of errorClasses) {
+        describe(name, () => {
+            it('extends WalletError and Error', () => {
+                const err = new Class();
+                expect(err).toBeInstanceOf(WalletError);
+                expect(err).toBeInstanceOf(Error);
+            });
+            it('has correct name property', () => {
+                const err = new Class();
+                expect(err.name).toBe(name);
+            });
+            it('stores inner error', () => {
+                const inner = new Error('cause');
+                const err = new Class('msg', inner);
+                expect(err.error).toBe(inner);
+                expect(err.message).toBe('msg');
+            });
+        });
+    }
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/__tests__/errors.test.js.map

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

package/dist/__tests__/helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/helpers.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { u8ToB64, b64ToU8 } from '../helpers';
+describe('u8ToB64', () => {
+    it('encodes a known value correctly', () => {
+        const bytes = new Uint8Array([72, 101, 108, 108, 111]); // "Hello"
+        expect(u8ToB64(bytes)).toBe('SGVsbG8=');
+    });
+    it('encodes an empty array', () => {
+        expect(u8ToB64(new Uint8Array([]))).toBe('');
+    });
+});
+describe('b64ToU8', () => {
+    it('decodes a known value correctly', () => {
+        const result = b64ToU8('SGVsbG8=');
+        expect(result).toEqual(new Uint8Array([72, 101, 108, 108, 111]));
+    });
+    it('decodes an empty string', () => {
+        expect(b64ToU8('')).toEqual(new Uint8Array([]));
+    });
+});
+describe('roundtrip', () => {
+    it('encode then decode returns original bytes', () => {
+        const original = new Uint8Array([0, 1, 127, 128, 255]);
+        const decoded = b64ToU8(u8ToB64(original));
+        expect(decoded).toEqual(original);
+    });
+    it('handles a large array (256 bytes)', () => {
+        const original = new Uint8Array(256);
+        for (let i = 0; i < 256; i++)
+            original[i] = i;
+        const decoded = b64ToU8(u8ToB64(original));
+        expect(decoded).toEqual(original);
+    });
+});
+//# sourceMappingURL=helpers.test.js.map

package/dist/__tests__/helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.js","sourceRoot":"","sources":["../../__tests__/helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE9C,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU;QAClE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;YAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/transaction.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/transaction.test.js

@@ -0,0 +1,113 @@
+import { describe, it, expect, vi } from 'vitest';
+import { SendTransaction, ConsumeTransaction, CustomTransaction, Transaction, TransactionType, } from '../transaction';
+import { u8ToB64 } from '../helpers';
+describe('TransactionType enum', () => {
+    it('has correct values', () => {
+        expect(TransactionType.Send).toBe('send');
+        expect(TransactionType.Consume).toBe('consume');
+        expect(TransactionType.Custom).toBe('custom');
+    });
+});
+describe('SendTransaction', () => {
+    it('sets all fields correctly', () => {
+        const tx = new SendTransaction('sender-addr', 'recipient-addr', 'faucet-123', 'public', 1000);
+        expect(tx.senderAddress).toBe('sender-addr');
+        expect(tx.recipientAddress).toBe('recipient-addr');
+        expect(tx.faucetId).toBe('faucet-123');
+        expect(tx.noteType).toBe('public');
+        expect(tx.amount).toBe(1000);
+        expect(tx.recallBlocks).toBeUndefined();
+    });
+    it('sets optional recallBlocks', () => {
+        const tx = new SendTransaction('sender', 'recipient', 'faucet', 'private', 500, 10);
+        expect(tx.recallBlocks).toBe(10);
+    });
+});
+describe('ConsumeTransaction', () => {
+    it('sets fields correctly', () => {
+        const tx = new ConsumeTransaction('faucet-1', 'note-1', 'public', 100);
+        expect(tx.faucetId).toBe('faucet-1');
+        expect(tx.noteId).toBe('note-1');
+        expect(tx.noteType).toBe('public');
+        expect(tx.amount).toBe(100);
+        expect(tx.noteBytes).toBeUndefined();
+    });
+    it('converts noteBytes Uint8Array to base64', () => {
+        const bytes = new Uint8Array([1, 2, 3]);
+        const tx = new ConsumeTransaction('faucet', 'note', 'private', 50, bytes);
+        expect(tx.noteBytes).toBe(u8ToB64(bytes));
+    });
+    it('leaves noteBytes undefined when not provided', () => {
+        const tx = new ConsumeTransaction('faucet', 'note', 'public', 50);
+        expect(tx.noteBytes).toBeUndefined();
+    });
+});
+describe('CustomTransaction', () => {
+    it('serializes transactionRequest to base64', () => {
+        const mockBytes = new Uint8Array([10, 20, 30]);
+        const mockRequest = {
+            serialize: vi.fn().mockReturnValue(mockBytes),
+        };
+        const tx = new CustomTransaction('addr', 'recipient', mockRequest);
+        expect(mockRequest.serialize).toHaveBeenCalled();
+        expect(tx.transactionRequest).toBe(u8ToB64(mockBytes));
+        expect(tx.address).toBe('addr');
+        expect(tx.recipientAddress).toBe('recipient');
+    });
+    it('sets optional inputNoteIds', () => {
+        const mockRequest = {
+            serialize: vi.fn().mockReturnValue(new Uint8Array([1])),
+        };
+        const tx = new CustomTransaction('addr', 'recipient', mockRequest, [
+            'id1',
+            'id2',
+        ]);
+        expect(tx.inputNoteIds).toEqual(['id1', 'id2']);
+    });
+    it('converts importNotes from Uint8Array[] to base64 strings', () => {
+        const mockRequest = {
+            serialize: vi.fn().mockReturnValue(new Uint8Array([1])),
+        };
+        const noteBytes = [new Uint8Array([4, 5]), new Uint8Array([6, 7])];
+        const tx = new CustomTransaction('addr', 'recipient', mockRequest, ['id1'], noteBytes);
+        expect(tx.importNotes).toEqual([
+            u8ToB64(noteBytes[0]),
+            u8ToB64(noteBytes[1]),
+        ]);
+    });
+    it('leaves optional fields undefined when not provided', () => {
+        const mockRequest = {
+            serialize: vi.fn().mockReturnValue(new Uint8Array([1])),
+        };
+        const tx = new CustomTransaction('addr', 'recipient', mockRequest);
+        expect(tx.inputNoteIds).toBeUndefined();
+        expect(tx.importNotes).toBeUndefined();
+    });
+});
+describe('Transaction factory', () => {
+    it('createSendTransaction returns correct type and payload', () => {
+        const tx = Transaction.createSendTransaction('sender', 'recipient', 'faucet', 'public', 100);
+        expect(tx.type).toBe(TransactionType.Send);
+        expect(tx.payload).toBeInstanceOf(SendTransaction);
+        const payload = tx.payload;
+        expect(payload.senderAddress).toBe('sender');
+        expect(payload.amount).toBe(100);
+    });
+    it('createConsumeTransaction returns correct type and payload', () => {
+        const tx = Transaction.createConsumeTransaction('faucet', 'note-id', 'private', 200);
+        expect(tx.type).toBe(TransactionType.Consume);
+        expect(tx.payload).toBeInstanceOf(ConsumeTransaction);
+        const payload = tx.payload;
+        expect(payload.faucetId).toBe('faucet');
+        expect(payload.noteId).toBe('note-id');
+    });
+    it('createCustomTransaction returns correct type and payload', () => {
+        const mockRequest = {
+            serialize: vi.fn().mockReturnValue(new Uint8Array([1, 2])),
+        };
+        const tx = Transaction.createCustomTransaction('addr', 'recipient', mockRequest);
+        expect(tx.type).toBe(TransactionType.Custom);
+        expect(tx.payload).toBeInstanceOf(CustomTransaction);
+    });
+});
+//# sourceMappingURL=transaction.test.js.map

package/dist/__tests__/transaction.test.js.map

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

package/dist/signer.d.ts

@@ -2,7 +2,7 @@ import type { NoteFilterTypes } from '@miden-sdk/miden-sdk';
 import type { WalletAdapter, WalletAdapterProps } from './adapter';
 import { BaseWalletAdapter } from './adapter';
 import { MidenConsumeTransaction, MidenSendTransaction, MidenTransaction } from './transaction';
-import { Asset, InputNoteDetails, SignKind, TransactionOutput } from './types';
+import { Asset, CreateAccountParams, InputNoteDetails, SignKind, TransactionOutput } from './types';
 export type Adapter = WalletAdapter | SignerWalletAdapter | MessageSignerWalletAdapter;
 export interface SignerWalletAdapterProps<Name extends string = string> extends WalletAdapterProps<Name> {
 }
@@ -19,6 +19,7 @@ export interface MessageSignerWalletAdapterProps<Name extends string = string> e
     waitForTransaction(txId: string, timeout?: number): Promise<TransactionOutput>;
     requestSend(transaction: MidenSendTransaction): Promise<string>;
     requestConsume(transaction: MidenConsumeTransaction): Promise<string>;
+    createAccount(params?: CreateAccountParams): Promise<string>;
 }
 export type MessageSignerWalletAdapter<Name extends string = string> = WalletAdapter<Name> & MessageSignerWalletAdapterProps<Name>;
 export declare abstract class BaseMessageSignerWalletAdapter<Name extends string = string> extends BaseSignerWalletAdapter<Name> implements MessageSignerWalletAdapter<Name> {
@@ -31,4 +32,5 @@ export declare abstract class BaseMessageSignerWalletAdapter<Name extends string
     abstract importPrivateNote(note: Uint8Array): Promise<string>;
     abstract requestConsumableNotes(): Promise<InputNoteDetails[]>;
     abstract waitForTransaction(txId: string, timeout?: number): Promise<TransactionOutput>;
+    abstract createAccount(params?: CreateAccountParams): Promise<string>;
 }

package/dist/signer.js.map

@@ -1 +1 @@
-{"version":3,"file":"signer.js","sourceRoot":"","sources":["../signer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAmB9C,MAAM,OAAgB,uBACpB,SAAQ,iBAAuB;CACQ;AAwBzC,MAAM,OAAgB,8BAGpB,SAAQ,uBAA6B;CAoBtC"}
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../signer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAmB9C,MAAM,OAAgB,uBACpB,SAAQ,iBAAuB;CACQ;AAyBzC,MAAM,OAAgB,8BAGpB,SAAQ,uBAA6B;CAqBtC"}

package/dist/types.d.ts

@@ -45,3 +45,10 @@ export interface WalletTransactionSuccessOutput {
     outputNotes: string[];
 }
 export type WalletTransactionOutput = WalletTransactionSuccessOutput | IFailedTransactionOutput;
+export type CreateAccountType = 'RegularAccountImmutableCode' | 'RegularAccountUpdatableCode';
+export type CreateAccountStorageMode = 'private' | 'public' | 'network';
+export interface CreateAccountParams {
+    accountType?: CreateAccountType;
+    storageMode?: CreateAccountStorageMode;
+    customComponents?: Uint8Array[];
+}

package/dist/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/vitest.config.js

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+export default defineConfig({
+    test: {
+        environment: 'jsdom',
+        globals: true,
+    },
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,IAAI;KACd;CACF,CAAC,CAAC"}

package/docs/README.md

@@ -53,6 +53,7 @@
 ## Interfaces
 
 - [Asset](interfaces/Asset.md)
+- [CreateAccountParams](interfaces/CreateAccountParams.md)
 - [IFailedTransactionOutput](interfaces/IFailedTransactionOutput.md)
 - [MessageSignerWalletAdapterProps](interfaces/MessageSignerWalletAdapterProps.md)
 - [MidenConsumeTransaction](interfaces/MidenConsumeTransaction.md)
@@ -68,6 +69,8 @@
 ## Type Aliases
 
 - [Adapter](type-aliases/Adapter.md)
+- [CreateAccountStorageMode](type-aliases/CreateAccountStorageMode.md)
+- [CreateAccountType](type-aliases/CreateAccountType.md)
 - [FungibleAssetDetails](type-aliases/FungibleAssetDetails.md)
 - [InputNoteDetails](type-aliases/InputNoteDetails.md)
 - [MessageSignerWalletAdapter](type-aliases/MessageSignerWalletAdapter.md)

package/docs/classes/BaseMessageSignerWalletAdapter.md

@@ -251,6 +251,26 @@ Minimal `EventEmitter` interface that is molded against the Node.js
 
 ***
 
+### createAccount()
+
+> `abstract` **createAccount**(`params?`): `Promise`\<`string`\>
+
+#### Parameters
+
+##### params?
+
+[`CreateAccountParams`](../interfaces/CreateAccountParams.md)
+
+#### Returns
+
+`Promise`\<`string`\>
+
+#### Implementation of
+
+`MessageSignerWalletAdapter.createAccount`
+
+***
+
 ### disconnect()
 
 > `abstract` **disconnect**(): `Promise`\<`void`\>

package/docs/interfaces/CreateAccountParams.md

@@ -0,0 +1,25 @@
+[**@miden-sdk/miden-wallet-adapter-base**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-base](../README.md) / CreateAccountParams
+
+# Interface: CreateAccountParams
+
+## Properties
+
+### accountType?
+
+> `optional` **accountType**: [`CreateAccountType`](../type-aliases/CreateAccountType.md)
+
+***
+
+### customComponents?
+
+> `optional` **customComponents**: `Uint8Array`\<`ArrayBufferLike`\>[]
+
+***
+
+### storageMode?
+
+> `optional` **storageMode**: [`CreateAccountStorageMode`](../type-aliases/CreateAccountStorageMode.md)

package/docs/interfaces/MessageSignerWalletAdapterProps.md

@@ -136,6 +136,22 @@
 
 ***
 
+### createAccount()
+
+> **createAccount**(`params?`): `Promise`\<`string`\>
+
+#### Parameters
+
+##### params?
+
+[`CreateAccountParams`](CreateAccountParams.md)
+
+#### Returns
+
+`Promise`\<`string`\>
+
+***
+
 ### disconnect()
 
 > **disconnect**(): `Promise`\<`void`\>

package/docs/type-aliases/CreateAccountStorageMode.md

@@ -0,0 +1,9 @@
+[**@miden-sdk/miden-wallet-adapter-base**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-base](../README.md) / CreateAccountStorageMode
+
+# Type Alias: CreateAccountStorageMode
+
+> **CreateAccountStorageMode** = `"private"` \| `"public"` \| `"network"`

package/docs/type-aliases/CreateAccountType.md

@@ -0,0 +1,9 @@
+[**@miden-sdk/miden-wallet-adapter-base**](../README.md)
+
+***
+
+[@miden-sdk/miden-wallet-adapter-base](../README.md) / CreateAccountType
+
+# Type Alias: CreateAccountType
+
+> **CreateAccountType** = `"RegularAccountImmutableCode"` \| `"RegularAccountUpdatableCode"`

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@miden-sdk/miden-wallet-adapter-base",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "Core infrastructure for connecting Miden-compatible wallets to your dApp.",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "clean": "rimraf dist/ node_modules/",
-    "doc": "typedoc --disableSources --tsconfig ./tsconfig.json --plugin typedoc-plugin-markdown --entryPoints index.ts"
+    "doc": "typedoc --disableSources --tsconfig ./tsconfig.json --plugin typedoc-plugin-markdown --entryPoints index.ts",
+    "test": "vitest run"
   },
   "repository": {
     "type": "git",
@@ -17,5 +18,9 @@
   "license": "MIT",
   "dependencies": {
     "eventemitter3": "^5.0.1"
+  },
+  "devDependencies": {
+    "jsdom": "^24.0.0",
+    "vitest": "^1.0.0"
   }
 }

package/signer.ts

@@ -6,7 +6,7 @@ import {
   MidenSendTransaction,
   MidenTransaction,
 } from './transaction';
-import { Asset, InputNoteDetails, SignKind, TransactionOutput } from './types';
+import { Asset, CreateAccountParams, InputNoteDetails, SignKind, TransactionOutput } from './types';
 
 export type Adapter =
   | WalletAdapter
@@ -40,6 +40,7 @@ export interface MessageSignerWalletAdapterProps<Name extends string = string>
   ): Promise<TransactionOutput>;
   requestSend(transaction: MidenSendTransaction): Promise<string>;
   requestConsume(transaction: MidenConsumeTransaction): Promise<string>;
+  createAccount(params?: CreateAccountParams): Promise<string>;
 }
 
 export type MessageSignerWalletAdapter<Name extends string = string> =
@@ -68,4 +69,5 @@ export abstract class BaseMessageSignerWalletAdapter<
     txId: string,
     timeout?: number
   ): Promise<TransactionOutput>;
+  abstract createAccount(params?: CreateAccountParams): Promise<string>;
 }

package/types.ts

@@ -66,3 +66,15 @@ export interface WalletTransactionSuccessOutput {
 export type WalletTransactionOutput =
   | WalletTransactionSuccessOutput
   | IFailedTransactionOutput;
+
+export type CreateAccountType =
+  | 'RegularAccountImmutableCode'
+  | 'RegularAccountUpdatableCode';
+
+export type CreateAccountStorageMode = 'private' | 'public' | 'network';
+
+export interface CreateAccountParams {
+  accountType?: CreateAccountType;
+  storageMode?: CreateAccountStorageMode;
+  customComponents?: Uint8Array[];
+}

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'jsdom',
+    globals: true,
+  },
+});