@ultraos/wallet-sdk 0.0.3 → 0.0.5

package/src/lib/interfaces/wallet-provider.interface.ts

@@ -1,55 +0,0 @@
-import { BlockchainTransaction } from './blockchain-transaction.interface';
-import { ConnectParams } from './connect-params.interface';
-import { PurchaseItemType } from './purchase-item.interface';
-import {
-  ConnectResult,
-  DisconnectResponse,
-  PurchaseItemResult,
-  SignMessageResult,
-  SignTransactionResult,
-  UltraResponse,
-} from './wallet-provider-response.interface';
-
-/**
- * Defines the minimal interface that a wallet provider must implement for the Ultra Wallet SDK.
- */
-export interface UltraWalletProvider {
-  /**
-   * Prompt the user for permission to share his wallet info with the 3rd party application.
-   * Once permission is established the first time, the 3rd party application will be whitelisted for future requests.
-   * @param params.onlyIfTrusted - Do not prompt the user for permissions. Share current account info if Dapp is already trusted,
-   *                               otherwise rejects the request.
-   */
-  connect(params?: ConnectParams): Promise<UltraResponse<ConnectResult>>;
-
-  /**
-   * Remove permission to interact with the 3rd party application
-   */
-  disconnect(): Promise<UltraResponse<DisconnectResponse>>;
-
-  /**
-   * Open a popup to sign a message
-   * @param message - The message to sign. The message should be prefixed with "0x:, UOSx:, or message:"
-   */
-  signMessage(message: string): Promise<UltraResponse<SignMessageResult>>;
-
-  /**
-   * Open a popup to sign a transaction
-   * @param transaction - The transaction to sign
-   */
-  signTransaction(
-    transaction: BlockchainTransaction | BlockchainTransaction[],
-  ): Promise<UltraResponse<SignTransactionResult>>;
-
-  /**
-   * Get current chain id
-   */
-  getChainId(): Promise<UltraResponse<string>>;
-
-  /**
-   * Open a popup to purchase an item
-   * @param {PurchaseItemType} itemType - The type of item to purchase
-   * @param {string} itemId - The id of the item to purchase
-   */
-  purchaseItem(itemType: PurchaseItemType, itemId: string): Promise<UltraResponse<PurchaseItemResult>>;
-}

package/src/lib/providers/extension-provider/extension.provider.spec.ts

@@ -1,121 +0,0 @@
-import {
-  BlockchainTransaction,
-  ConnectParams,
-  ConnectResult,
-  PurchaseItemResult,
-  PurchaseItemType,
-  ResponseStatus,
-  SignMessageResult,
-  SignTransactionResult,
-  UltraResponse,
-} from '../../interfaces';
-import { ExtensionProvider } from './extension.provider';
-import UltraWalletSdkConfig from '../../config/ultra-wallet-sdk.config';
-
-describe('ExtensionProvider', () => {
-  let provider: ExtensionProvider;
-
-  const mockUltra: jest.Mocked<Window['ultra']> = {
-    connect: jest.fn(),
-    disconnect: jest.fn(),
-    signMessage: jest.fn(),
-    signTransaction: jest.fn(),
-    getChainId: jest.fn(),
-    purchaseItem: jest.fn(),
-  };
-
-  beforeEach(() => {
-    (window as any).ultra = mockUltra;
-    provider = new ExtensionProvider();
-  });
-
-  afterEach(() => {
-    delete (window as any).ultra;
-    jest.clearAllMocks();
-  });
-
-  it('calls connect with params', async () => {
-    const params: ConnectParams = {};
-    const expected: UltraResponse<ConnectResult> = {
-      status: ResponseStatus.SUCCESS,
-      data: [{ blockchainid: 'acc', publicKey: 'pk' }],
-    };
-    mockUltra.getChainId.mockResolvedValue({
-      status: ResponseStatus.SUCCESS,
-      data: UltraWalletSdkConfig.networkInfo.mainnet.chainId,
-    });
-    mockUltra.connect.mockResolvedValue(expected);
-
-    const result = await provider.connect(params);
-    expect(mockUltra.connect).toHaveBeenCalledWith(params);
-    expect(result).toEqual(expected);
-  });
-
-  it('throws an error when connect is called with mismatched chainId', async () => {
-    (window as any).ultra = {
-      getChainId: jest.fn().mockResolvedValue({ data: 'wrong-chain' }),
-      connect: jest.fn(),
-    };
-
-    const provider = new ExtensionProvider({ environment: 'testnet' });
-
-    await expect(provider.connect()).rejects.toThrow(
-      'Wallet environment mismatch: expected "testnet" chain, but received "wrong-chain". Please verify the SDK configuration and the connected network.',
-    );
-  });
-
-  it('calls disconnect', async () => {
-    const expected: UltraResponse<boolean> = { status: ResponseStatus.SUCCESS, data: true };
-    mockUltra.disconnect.mockResolvedValue(expected);
-
-    const result = await provider.disconnect();
-    expect(mockUltra.disconnect).toHaveBeenCalled();
-    expect(result).toEqual(expected);
-  });
-
-  it('calls signMessage', async () => {
-    const expected: UltraResponse<SignMessageResult> = {
-      status: ResponseStatus.SUCCESS,
-      data: { signature: '0xabc' },
-    };
-    mockUltra.signMessage.mockResolvedValue(expected);
-
-    const result = await provider.signMessage('hello');
-    expect(mockUltra.signMessage).toHaveBeenCalledWith('hello');
-    expect(result).toEqual(expected);
-  });
-
-  it('calls signTransaction', async () => {
-    const tx: BlockchainTransaction = { to: '0x123', amount: '42' } as any;
-    const expected: UltraResponse<SignTransactionResult> = {
-      status: ResponseStatus.SUCCESS,
-      data: { transactionHash: '0x999' },
-    };
-    mockUltra.signTransaction.mockResolvedValue(expected);
-
-    const result = await provider.signTransaction(tx);
-    expect(mockUltra.signTransaction).toHaveBeenCalledWith(tx);
-    expect(result).toEqual(expected);
-  });
-
-  it('calls getChainId', async () => {
-    const expected: UltraResponse<string> = { status: ResponseStatus.SUCCESS, data: 'ultra-chain' };
-    mockUltra.getChainId.mockResolvedValue(expected);
-
-    const result = await provider.getChainId();
-    expect(mockUltra.getChainId).toHaveBeenCalled();
-    expect(result).toEqual(expected);
-  });
-
-  it('calls purchaseItem', async () => {
-    const expected: UltraResponse<PurchaseItemResult> = {
-      status: ResponseStatus.SUCCESS,
-      data: { orderHash: 'abc123', items: [] },
-    };
-    mockUltra.purchaseItem.mockResolvedValue(expected);
-
-    const result = await provider.purchaseItem(PurchaseItemType.UNIQ_FACTORY, '123');
-    expect(mockUltra.purchaseItem).toHaveBeenCalledWith(PurchaseItemType.UNIQ_FACTORY, '123');
-    expect(result).toEqual(expected);
-  });
-});

package/src/lib/providers/extension-provider/extension.provider.ts

@@ -1,55 +0,0 @@
-import {
-  BlockchainTransaction,
-  ConnectParams,
-  ConnectResult,
-  PurchaseItemResult,
-  PurchaseItemType,
-  SignMessageResult,
-  SignTransactionResult,
-  UltraResponse,
-  UltraWalletProvider,
-  UltraWalletSdkOptions,
-} from '../../interfaces';
-import { isValidChain } from '../../utils/chain-validator';
-
-declare global {
-  interface Window {
-    ultra: UltraWalletProvider;
-  }
-}
-
-export class ExtensionProvider implements UltraWalletProvider {
-  constructor(private readonly options?: UltraWalletSdkOptions) {}
-
-  async connect(params?: ConnectParams): Promise<UltraResponse<ConnectResult>> {
-    const { data: chainId } = await window.ultra.getChainId();
-    if (!isValidChain(this.options?.environment, chainId)) {
-      throw new Error(
-        `Wallet environment mismatch: expected "${this.options?.environment}" chain, but received "${chainId}". Please verify the SDK configuration and the connected network.`,
-      );
-    }
-    return window.ultra.connect(params);
-  }
-
-  disconnect(): Promise<UltraResponse<boolean>> {
-    return window.ultra.disconnect();
-  }
-
-  signMessage(message: string): Promise<UltraResponse<SignMessageResult>> {
-    return window.ultra.signMessage(message);
-  }
-
-  signTransaction(
-    transaction: BlockchainTransaction | BlockchainTransaction[],
-  ): Promise<UltraResponse<SignTransactionResult>> {
-    return window.ultra.signTransaction(transaction);
-  }
-
-  getChainId(): Promise<UltraResponse<string>> {
-    return window.ultra.getChainId();
-  }
-
-  purchaseItem(itemType: PurchaseItemType, itemId: string): Promise<UltraResponse<PurchaseItemResult>> {
-    return window.ultra.purchaseItem(itemType, itemId);
-  }
-}

package/src/lib/providers/web-provider/web.provider.spec.ts

@@ -1,76 +0,0 @@
-import { WebProvider } from './web.provider';
-import { ClientMessenger } from '../../common/client-messenger';
-import { ResponseStatus, UltraResponse, UltraWalletSdkOptions } from '../../interfaces';
-import { BlockchainTransaction, PurchaseItemType } from '../../interfaces';
-
-jest.mock('../../common/client-messenger');
-
-describe('WebProvider', () => {
-  let provider: WebProvider;
-  let mockMessenger: jest.Mocked<ClientMessenger>;
-  const mockOptions: UltraWalletSdkOptions = { environment: 'mainnet' };
-
-  beforeEach(() => {
-    mockMessenger = new ClientMessenger({} as any) as jest.Mocked<ClientMessenger>;
-    (ClientMessenger as jest.Mock).mockImplementation(() => mockMessenger);
-    provider = new WebProvider(mockOptions);
-  });
-
-  it('should call connect', async () => {
-    const expectedResponse: UltraResponse = { status: ResponseStatus.SUCCESS, data: {} };
-    mockMessenger.sendRequest.mockResolvedValueOnce(expectedResponse);
-
-    const result = await provider.connect();
-    expect(mockMessenger.sendRequest).toHaveBeenCalledWith('connect', {});
-    expect(result).toEqual(expectedResponse);
-  });
-
-  it('should call disconnect', async () => {
-    const expectedResponse: UltraResponse = { status: ResponseStatus.SUCCESS, data: true };
-    mockMessenger.sendRequest.mockResolvedValueOnce(expectedResponse);
-
-    const result = await provider.disconnect();
-    expect(mockMessenger.sendRequest).toHaveBeenCalledWith('disconnect', {});
-    expect(result).toEqual(expectedResponse);
-  });
-
-  it('should call signMessage', async () => {
-    const expectedResponse: UltraResponse = { status: ResponseStatus.SUCCESS, data: { signature: 'abc' } };
-    mockMessenger.sendRequest.mockResolvedValueOnce(expectedResponse);
-
-    const message = 'test message';
-    const result = await provider.signMessage(message);
-    expect(mockMessenger.sendRequest).toHaveBeenCalledWith('signMessage', { message });
-    expect(result).toEqual(expectedResponse);
-  });
-
-  it('should call signTransaction', async () => {
-    const transaction: BlockchainTransaction = { action: 'foo', contract: 'bar', data: {}, authorizations: [] };
-    const expectedResponse = { status: ResponseStatus.SUCCESS, data: { transactionHash: '0x123' } };
-    mockMessenger.sendRequest.mockResolvedValueOnce(expectedResponse);
-
-    const result = await provider.signTransaction(transaction);
-    expect(mockMessenger.sendRequest).toHaveBeenCalledWith('signTransaction', { transaction });
-    expect(result).toEqual(expectedResponse);
-  });
-
-  it('should call getChainId', async () => {
-    const expectedResponse: UltraResponse = { status: ResponseStatus.SUCCESS, data: '1' };
-    mockMessenger.sendRequest.mockResolvedValueOnce(expectedResponse);
-
-    const result = await provider.getChainId();
-    expect(mockMessenger.sendRequest).toHaveBeenCalledWith('getChainId', {});
-    expect(result).toEqual(expectedResponse);
-  });
-
-  it('should call purchaseItem', async () => {
-    const expectedResponse: UltraResponse = { status: ResponseStatus.SUCCESS, data: { orderId: '123' } };
-    mockMessenger.sendRequest.mockResolvedValueOnce(expectedResponse);
-
-    const itemType = 'horse' as PurchaseItemType;
-    const itemId = '123';
-    const result = await provider.purchaseItem(itemType, itemId);
-    expect(mockMessenger.sendRequest).toHaveBeenCalledWith('purchaseItem', { itemType, itemId });
-    expect(result).toEqual(expectedResponse);
-  });
-});

package/src/lib/providers/web-provider/web.provider.ts

@@ -1,59 +0,0 @@
-import { ClientMessenger } from '../../common/client-messenger';
-import { WindowManager } from '../../common/window-manager';
-import UltraWalletSdkConfig from '../../config/ultra-wallet-sdk.config';
-import {
-  BlockchainTransaction,
-  ConnectParams,
-  ConnectResult,
-  PurchaseItemResult,
-  PurchaseItemType,
-  SignMessageResult,
-  SignTransactionResult,
-  UltraResponse,
-  UltraWalletProvider,
-  UltraWalletSdkOptions,
-} from '../../interfaces';
-
-export class WebProvider implements UltraWalletProvider {
-  private readonly windowManager: WindowManager;
-  private readonly clientMessenger: ClientMessenger;
-
-  constructor(private readonly options?: UltraWalletSdkOptions) {
-    this.windowManager = new WindowManager(this.resolveWalletUrl());
-    this.clientMessenger = new ClientMessenger(this.windowManager);
-  }
-
-  connect(_?: ConnectParams): Promise<UltraResponse<ConnectResult>> {
-    return this.clientMessenger.sendRequest<ConnectResult>('connect', {});
-  }
-
-  disconnect(): Promise<UltraResponse<boolean>> {
-    return this.clientMessenger.sendRequest<boolean>('disconnect', {});
-  }
-
-  signMessage(message: string): Promise<UltraResponse<SignMessageResult>> {
-    return this.clientMessenger.sendRequest<SignMessageResult>('signMessage', { message });
-  }
-
-  signTransaction(
-    transaction: BlockchainTransaction | BlockchainTransaction[],
-  ): Promise<UltraResponse<SignTransactionResult>> {
-    return this.clientMessenger.sendRequest<SignTransactionResult>('signTransaction', { transaction });
-  }
-
-  getChainId(): Promise<UltraResponse<string>> {
-    return this.clientMessenger.sendRequest<string>('getChainId', {});
-  }
-
-  purchaseItem(itemType: PurchaseItemType, itemId: string): Promise<UltraResponse<PurchaseItemResult>> {
-    return this.clientMessenger.sendRequest<PurchaseItemResult>('purchaseItem', {
-      itemType,
-      itemId,
-    });
-  }
-
-  private resolveWalletUrl(): string {
-    const env = UltraWalletSdkConfig.walletUrls[this.options?.environment || 'mainnet'];
-    return env || this.options.environment;
-  }
-}

package/src/lib/ultra-wallet-sdk.spec.ts

@@ -1,90 +0,0 @@
-import { UltraWalletSDK } from './ultra-wallet-sdk';
-import { ExtensionProvider, WebProvider } from './providers';
-import * as detectionUtils from './utils/detection';
-import { ConnectParams, PurchaseItemType } from './interfaces';
-
-jest.mock('./providers/extension-provider/extension.provider');
-jest.mock('./providers/web-provider/web.provider');
-jest.mock('./utils/detection');
-
-describe('UltraWalletSDK', () => {
-  let sdk: UltraWalletSDK;
-  let connectSpy: jest.Mock;
-  let disconnectSpy: jest.Mock;
-  let signMessageSpy: jest.Mock;
-  let signTransactionSpy: jest.Mock;
-  let getChainIdSpy: jest.Mock;
-  let purchaseItemSpy: jest.Mock;
-
-  beforeEach(() => {
-    connectSpy = jest.fn();
-    disconnectSpy = jest.fn();
-    signMessageSpy = jest.fn();
-    signTransactionSpy = jest.fn();
-    getChainIdSpy = jest.fn();
-    purchaseItemSpy = jest.fn();
-
-    (detectionUtils.isExtensionAvailable as jest.Mock).mockReturnValue(true);
-    (ExtensionProvider as jest.Mock).mockImplementation(() => ({
-      connect: connectSpy,
-      disconnect: disconnectSpy,
-      signMessage: signMessageSpy,
-      signTransaction: signTransactionSpy,
-      getChainId: getChainIdSpy,
-      purchaseItem: purchaseItemSpy,
-    }));
-  });
-
-  it('should use ExtensionProvider when extension is available', () => {
-    sdk = new UltraWalletSDK();
-    expect(sdk).toBeTruthy();
-  });
-
-  it('should use WebProvider when extension is not available', () => {
-    (detectionUtils.isExtensionAvailable as jest.Mock).mockReturnValue(false);
-    (WebProvider as unknown as jest.Mock).mockImplementation(() => ({
-      connect: connectSpy,
-    }));
-
-    sdk = new UltraWalletSDK({ environment: 'testnet' });
-    expect(sdk).toBeTruthy();
-  });
-
-  it('should delegate connect to the provider', async () => {
-    sdk = new UltraWalletSDK();
-    const params: ConnectParams = { onlyIfTrusted: true };
-    await sdk.connect(params);
-    expect(connectSpy).toHaveBeenCalledWith(params);
-  });
-
-  it('should delegate disconnect to the provider', async () => {
-    sdk = new UltraWalletSDK();
-    await sdk.disconnect();
-    expect(disconnectSpy).toHaveBeenCalled();
-  });
-
-  it('should delegate signMessage to the provider', async () => {
-    sdk = new UltraWalletSDK();
-    await sdk.signMessage('hello');
-    expect(signMessageSpy).toHaveBeenCalledWith('hello');
-  });
-
-  it('should delegate signTransaction to the provider', async () => {
-    sdk = new UltraWalletSDK();
-    const transaction = { contract: 'test', action: 'test', data: {}, authorizations: [] };
-    await sdk.signTransaction(transaction);
-    expect(signTransactionSpy).toHaveBeenCalledWith(transaction);
-  });
-
-  it('should delegate getChainId to the provider', async () => {
-    sdk = new UltraWalletSDK();
-    await sdk.getChainId();
-    expect(getChainIdSpy).toHaveBeenCalled();
-  });
-
-  it('should delegate purchaseItem to the provider', async () => {
-    sdk = new UltraWalletSDK();
-    await sdk.purchaseItem(PurchaseItemType.UNIQ_FACTORY, 'item123');
-    expect(purchaseItemSpy).toHaveBeenCalledWith('UniqFactory', 'item123');
-  });
-});

package/src/lib/ultra-wallet-sdk.ts

@@ -1,67 +0,0 @@
-import {
-  BlockchainTransaction,
-  ConnectParams,
-  ConnectResult,
-  PurchaseItemResult,
-  PurchaseItemType,
-  SignMessageResult,
-  SignTransactionResult,
-  UltraResponse,
-  UltraWalletProvider,
-  UltraWalletSdkOptions,
-} from './interfaces';
-import { ExtensionProvider, WebProvider } from './providers';
-import { isExtensionAvailable } from './utils/detection';
-
-/**
- * UltraWalletClient acts as a Facade for interacting with the Ultra Wallet.
- * It provides a unified API regardless of the underlying provider implementation (Extension or Web).
- */
-export class UltraWalletSDK {
-  private provider: UltraWalletProvider;
-
-  /**
-   * Constructs an UltraWalletClient instance.
-   * If the Ultra Wallet Extension is available (window.ultra), it will be used automatically.
-   * If the Extension is not available, the Web Wallet provider will be initialized using the given network options.
-   *
-   * @param {UltraWalletSdkOptions} [options] - Configuration options for the Web Wallet fallback (environment or custom URL).
-   */
-  constructor(private readonly options?: UltraWalletSdkOptions) {
-    this.provider = this.resolveWalletProvider();
-  }
-
-  connect(params?: ConnectParams): Promise<UltraResponse<ConnectResult>> {
-    return this.provider.connect(params);
-  }
-
-  disconnect(): Promise<UltraResponse<boolean>> {
-    return this.provider.disconnect();
-  }
-
-  signMessage(message: string): Promise<UltraResponse<SignMessageResult>> {
-    return this.provider.signMessage(message);
-  }
-
-  signTransaction(
-    transaction: BlockchainTransaction | BlockchainTransaction[],
-  ): Promise<UltraResponse<SignTransactionResult>> {
-    return this.provider.signTransaction(transaction);
-  }
-
-  getChainId(): Promise<UltraResponse<string>> {
-    return this.provider.getChainId();
-  }
-
-  purchaseItem(itemType: PurchaseItemType, itemId: string): Promise<UltraResponse<PurchaseItemResult>> {
-    return this.provider.purchaseItem(itemType, itemId);
-  }
-
-  private resolveWalletProvider(): UltraWalletProvider {
-    if (isExtensionAvailable()) {
-      return new ExtensionProvider();
-    } else {
-      return new WebProvider(this.options);
-    }
-  }
-}

package/src/lib/utils/chain-validator.ts

@@ -1,6 +0,0 @@
-import UltraWalletSdkConfig from '../config/ultra-wallet-sdk.config';
-
-export function isValidChain(targetNetwork: string, walletChainId: string): boolean {
-  const { chainId } = UltraWalletSdkConfig.networkInfo[targetNetwork] || {};
-  return !chainId || chainId === walletChainId;
-}

package/src/lib/utils/detection.ts

@@ -1,3 +0,0 @@
-export function isExtensionAvailable(): boolean {
-  return typeof window !== 'undefined' && 'ultra' in window;
-}

package/tsconfig.json

@@ -1,28 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "noImplicitOverride": true,
-    "noPropertyAccessFromIndexSignature": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "target": "es2020"
-  },
-  "files": [],
-  "include": [],
-  "references": [
-    {
-      "path": "./tsconfig.lib.json"
-    },
-    {
-      "path": "./tsconfig.spec.json"
-    }
-  ],
-  "angularCompilerOptions": {
-    "enableI18nLegacyMessageIdFormat": false,
-    "strictInjectionParameters": true,
-    "strictInputAccessModifiers": true,
-    "strictTemplates": true
-  }
-}

package/tsconfig.lib.json

@@ -1,12 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "declaration": true,
-    "declarationMap": true,
-    "inlineSources": true,
-    "types": ["chrome"]
-  },
-  "files": ["src/index.ts"],
-  "exclude": ["src/**/*.spec.ts", "jest.config.ts", "src/**/*.test.ts"]
-}

package/tsconfig.lib.prod.json

@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.lib.json",
-  "compilerOptions": {
-    "declarationMap": false
-  },
-  "angularCompilerOptions": {
-    "compilationMode": "partial"
-  }
-}

package/tsconfig.spec.json

@@ -1,8 +0,0 @@
-{
-  "extends": "./tsconfig.lib.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "types": ["jest"]
-  },
-  "include": ["**/*.spec.ts", "**/*.d.ts"]
-}