@ultraos/wallet-sdk 0.0.3 → 0.0.5

package/jest.config.ts

@@ -1,11 +0,0 @@
-/* eslint-disable */
-export default {
-  displayName: 'wallet-sdk',
-  preset: '../../jest.preset.js',
-  testEnvironment: 'jsdom',
-  transform: {
-    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
-  },
-  moduleFileExtensions: ['ts', 'js', 'html'],
-  coverageDirectory: '../../coverage/libs/wallet-sdk',
-};

package/karma.conf.js

@@ -1,16 +0,0 @@
-// Karma configuration file, see link for more information
-// https://karma-runner.github.io/6.4/config/configuration-file.html
-
-const { join } = require('path');
-const getBaseKarmaConfig = require('../../karma.conf');
-
-module.exports = function (config) {
-  const baseConfig = getBaseKarmaConfig();
-  config.set({
-    ...baseConfig,
-    coverageReporter: {
-      ...baseConfig.coverageReporter,
-      dir: join(__dirname, '../../coverage/libs/wallet-sdk'),
-    },
-  });
-};

package/project.json

@@ -1,33 +0,0 @@
-{
-  "name": "wallet-sdk",
-  "$schema": "../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "libs/wallet-sdk/src",
-  "projectType": "library",
-  "targets": {
-    "build": {
-      "executor": "@nx/js:tsc",
-      "outputs": ["{options.outputPath}"],
-      "options": {
-        "outputPath": "dist/libs/wallet-sdk",
-        "main": "libs/wallet-sdk/src/index.ts",
-        "tsConfig": "libs/wallet-sdk/tsconfig.lib.json",
-        "assets": ["libs/wallet-sdk/*.md"]
-      }
-    },
-    "publish": {
-      "command": "node tools/scripts/publish.mjs wallet-sdk {args.ver} {args.tag}",
-      "dependsOn": ["build"]
-    },
-    "lint": {
-      "executor": "@nx/eslint:lint"
-    },
-    "test": {
-      "executor": "@nx/jest:jest",
-      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
-      "options": {
-        "jestConfig": "libs/wallet-sdk/jest.config.ts"
-      }
-    }
-  },
-  "tags": ["type:lib", "type:sdk"]
-}

package/src/lib/common/client-error.ts

@@ -1,14 +0,0 @@
-import { SDK_ERROR_MESSAGE, SdkErrorCode } from '../interfaces';
-
-export class ClientError extends Error {
-  override message: string;
-
-  constructor(
-    public code: SdkErrorCode,
-    public data?,
-  ) {
-    super();
-    this.message = SDK_ERROR_MESSAGE[code];
-    this.name = this.constructor.name;
-  }
-}

package/src/lib/common/client-messenger.spec.ts

@@ -1,118 +0,0 @@
-import { ClientMessenger } from './client-messenger';
-import { WindowManager } from './window-manager';
-import { ResponseStatus, SdkErrorCode } from '../interfaces';
-
-jest.mock('./window-manager');
-
-describe('ClientMessenger', () => {
-  let messenger: ClientMessenger;
-  let windowManager: jest.Mocked<WindowManager>;
-  let walletWindow: jest.Mocked<Window>;
-
-  beforeEach(() => {
-    walletWindow = {
-      closed: false,
-      postMessage: jest.fn(),
-      close: jest.fn(),
-    } as unknown as jest.Mocked<Window>;
-
-    windowManager = new WindowManager('https://wallet.ultra.io') as jest.Mocked<WindowManager>;
-    windowManager.getWalletWindow.mockReturnValue(walletWindow);
-    windowManager.openOrReuseWallet.mockImplementation(() => {});
-
-    messenger = new ClientMessenger(windowManager);
-  });
-
-  afterEach(() => {
-    jest.clearAllMocks();
-  });
-
-  function fireWalletReady() {
-    window.dispatchEvent(
-      new MessageEvent('message', {
-        origin: 'https://wallet.ultra.io',
-        data: { jsonrpc: '2.0', method: 'ready' },
-      }),
-    );
-  }
-
-  function fireWalletResponse(id: string, result: any) {
-    window.dispatchEvent(
-      new MessageEvent('message', {
-        origin: 'https://wallet.ultra.io',
-        data: { jsonrpc: '2.0', id, result },
-      }),
-    );
-  }
-
-  it('resolves request after wallet ready and response received', async () => {
-    Object.defineProperty(windowManager, 'walletUrl', { get: () => 'https://wallet.ultra.io' });
-    const requestPromise = messenger.sendRequest('connect', {});
-    fireWalletReady();
-
-    // Wait one event loop tick to allow postMessage to be called
-    await new Promise((resolve) => setTimeout(resolve, 0));
-
-    // Extract the actual ID sent
-    const [[message]] = (walletWindow.postMessage as jest.Mock).mock.calls;
-    const requestId = message.id;
-    fireWalletResponse(requestId, { status: ResponseStatus.SUCCESS, data: { address: 'abc' } });
-
-    await expect(requestPromise).resolves.toEqual({
-      status: ResponseStatus.SUCCESS,
-      data: { address: 'abc' },
-    });
-  });
-
-  it('rejects if window is closed before ready', async () => {
-    Object.defineProperty(walletWindow, 'closed', { get: () => true });
-    const requestPromise = messenger.sendRequest('connect', {});
-    await expect(requestPromise).rejects.toEqual({
-      status: ResponseStatus.ERROR,
-      code: SdkErrorCode.USER_REJECTED_REQUEST,
-      message: expect.any(String),
-    });
-  });
-
-  it('rejects if wallet window is not available', async () => {
-    windowManager.getWalletWindow.mockReturnValue(null);
-    await expect(messenger.sendRequest('connect', {})).rejects.toEqual({
-      status: ResponseStatus.ERROR,
-      code: SdkErrorCode.WALLET_WINDOW_UNAVAILABLE,
-      message: expect.any(String),
-    });
-  });
-
-  it('rejects if wallet does not become ready before timeout', async () => {
-    jest.useFakeTimers();
-    const promise = messenger.sendRequest('connect', {});
-    jest.advanceTimersByTime(10000); // simulate timeout
-    await expect(promise).rejects.toEqual({
-      status: ResponseStatus.ERROR,
-      code: SdkErrorCode.WALLET_HANDSHAKE_TIMEOUT,
-      message: expect.any(String),
-    });
-    jest.useRealTimers();
-  });
-
-  it('rejects on rpcClient.request failure', async () => {
-    Object.defineProperty(windowManager, 'walletUrl', { get: () => 'https://wallet.ultra.io' });
-    const promise = messenger.sendRequest('connect', {});
-    fireWalletReady();
-
-    // Extract the actual ID sent
-    const [[message]] = (walletWindow.postMessage as jest.Mock).mock.calls;
-    const requestId = message.id;
-    fireWalletResponse(requestId, {
-      status: ResponseStatus.ERROR,
-      code: SdkErrorCode.UNKNOWN_ERROR,
-      message: 'error',
-    });
-
-    await expect(promise).rejects.toEqual({
-      status: ResponseStatus.ERROR,
-      code: SdkErrorCode.UNKNOWN_ERROR,
-      message: expect.any(String),
-    });
-  });
-});

package/src/lib/common/client-messenger.ts

@@ -1,109 +0,0 @@
-import { JSONRPCClient } from 'json-rpc-2.0';
-
-import UltraWalletSdkConfig from '../config/ultra-wallet-sdk.config';
-import { JsonRpcMessage, ResponseStatus, SdkErrorCode, UltraResponse } from '../interfaces';
-
-import { ClientError } from './client-error';
-import { WindowManager } from './window-manager';
-
-export class ClientMessenger {
-  private windowManager: WindowManager;
-  private rpcClient: JSONRPCClient;
-  private pendingRequest = false;
-
-  constructor(windowManager: WindowManager) {
-    this.windowManager = windowManager;
-
-    this.rpcClient = new JSONRPCClient((request) => {
-      const walletWindow = this.windowManager.getWalletWindow();
-      if (!walletWindow) {
-        return Promise.reject(new ClientError(SdkErrorCode.WALLET_WINDOW_UNAVAILABLE));
-      }
-      walletWindow.postMessage(request, this.windowManager.walletUrl);
-      return Promise.resolve();
-    });
-
-    window.addEventListener('message', (event) => {
-      if (event.origin === this.windowManager.walletUrl && event.data?.jsonrpc === '2.0') {
-        this.rpcClient.receive(event.data);
-      }
-    });
-  }
-
-  async sendRequest<T>(requestMethod: string, requestParams: object): Promise<UltraResponse<T>> {
-    if (this.pendingRequest && this.windowManager.getWalletWindow()?.closed === false) {
-      const { code, message } = new ClientError(SdkErrorCode.REQUESTED_RESOURCE_NOT_AVAILABLE);
-      return Promise.reject({ status: ResponseStatus.ERROR, code, message });
-    }
-
-    this.pendingRequest = true;
-
-    this.windowManager.openOrReuseWallet();
-
-    const walletWindow = this.windowManager.getWalletWindow();
-    if (!walletWindow) {
-      const { code, message } = new ClientError(SdkErrorCode.WALLET_WINDOW_UNAVAILABLE);
-      return Promise.reject({ status: ResponseStatus.ERROR, code, message });
-    }
-
-    let ready = false;
-    let cleanupCalled = false;
-
-    return new Promise<UltraResponse<T>>((resolve, reject) => {
-      const cleanup = () => {
-        if (cleanupCalled) return;
-        cleanupCalled = true;
-        this.pendingRequest = false;
-        clearTimeout(timeout);
-        clearInterval(checkWindowClose);
-        window.removeEventListener('message', handleReady);
-        walletWindow.close();
-      };
-
-      const handleReady = (event: MessageEvent) => {
-        if (event.origin !== this.windowManager.walletUrl) return;
-        const msg: JsonRpcMessage = event.data;
-        if (msg?.jsonrpc === '2.0' && msg.method === 'ready') {
-          ready = true;
-          window.removeEventListener('message', handleReady);
-
-          Promise.resolve(this.rpcClient.request(requestMethod, requestParams))
-            .then((result) => {
-              cleanup();
-              if (result.status === ResponseStatus.SUCCESS) {
-                resolve(result);
-              } else {
-                reject(result);
-              }
-            })
-            .catch((error) => {
-              cleanup();
-              const clientError = new ClientError(SdkErrorCode.UNKNOWN_ERROR, error);
-              reject({
-                status: ResponseStatus.ERROR,
-                ...clientError,
-              });
-            });
-        }
-      };
-
-      const timeout = setTimeout(() => {
-        if (!ready) {
-          cleanup();
-          const { code, message } = new ClientError(SdkErrorCode.WALLET_HANDSHAKE_TIMEOUT);
-          reject({ status: ResponseStatus.ERROR, code, message });
-        }
-      }, UltraWalletSdkConfig.handshakeTimeout);
-
-      const checkWindowClose = setInterval(() => {
-        if (walletWindow.closed) {
-          cleanup();
-          const { code, message } = new ClientError(SdkErrorCode.USER_REJECTED_REQUEST);
-          reject({ status: ResponseStatus.ERROR, code, message });
-        }
-      }, UltraWalletSdkConfig.checkWindowInterval);
-
-      window.addEventListener('message', handleReady);
-    });
-  }
-}

package/src/lib/common/window-manager.spec.ts

@@ -1,65 +0,0 @@
-import { WindowManager } from './window-manager';
-import UltraWalletSdkConfig from '../config/ultra-wallet-sdk.config';
-
-describe('WindowManager', () => {
-  let windowManager: WindowManager;
-  const walletUrl = 'https://wallet.example.com';
-
-  let walletWindowMock: Window;
-
-  beforeEach(() => {
-    walletWindowMock = {
-      closed: false,
-      focus: jest.fn(),
-    } as unknown as Window;
-
-    (window as any).open = jest.fn(() => walletWindowMock);
-    Object.defineProperty(window, 'top', { value: 100 });
-    Object.defineProperty(window, 'screenLeft', { value: 200 });
-    Object.defineProperty(window, 'innerWidth', { value: 1200 });
-
-    windowManager = new WindowManager(walletUrl);
-  });
-
-  afterEach(() => {
-    jest.clearAllMocks();
-  });
-
-  it('opens a new wallet window when none exists', () => {
-    windowManager.openOrReuseWallet();
-
-    expect(window.open).toHaveBeenCalledWith(
-      walletUrl,
-      '_blank',
-      expect.stringContaining(`width=${UltraWalletSdkConfig.width}`),
-    );
-    expect(windowManager.getWalletWindow()).toBe(walletWindowMock);
-  });
-
-  it('focuses existing wallet window if already open and not closed', () => {
-    windowManager['walletWindow'] = walletWindowMock;
-    windowManager.openOrReuseWallet();
-
-    expect(walletWindowMock.focus).toHaveBeenCalled();
-    expect(window.open).not.toHaveBeenCalled();
-  });
-
-  it('returns the current wallet window reference', () => {
-    windowManager['walletWindow'] = walletWindowMock;
-    const result = windowManager.getWalletWindow();
-    expect(result).toBe(walletWindowMock);
-  });
-
-  it('opens a new window if previous one was closed', () => {
-    const closedWindowMock = { closed: true } as unknown as Window;
-    windowManager['walletWindow'] = closedWindowMock;
-
-    windowManager.openOrReuseWallet();
-
-    expect(window.open).toHaveBeenCalledWith(
-      walletUrl,
-      '_blank',
-      expect.stringContaining(`width=${UltraWalletSdkConfig.width}`),
-    );
-  });
-});

package/src/lib/common/window-manager.ts

@@ -1,34 +0,0 @@
-import UltraWalletSdkConfig from '../config/ultra-wallet-sdk.config';
-
-export class WindowManager {
-  private currentWindow: Window;
-  private walletWindow: Window | null = null;
-  public readonly walletUrl: string;
-
-  constructor(walletUrl: string) {
-    this.currentWindow = window;
-    this.walletUrl = walletUrl;
-  }
-
-  openOrReuseWallet() {
-    if (this.walletWindow == null || this.walletWindow.closed) {
-      const height = UltraWalletSdkConfig.height;
-      const width = UltraWalletSdkConfig.width;
-      const top = this.currentWindow.top;
-      const left = this.currentWindow.screenLeft + this.currentWindow.innerWidth - width;
-
-      this.walletWindow = window.open(
-        this.walletUrl,
-        '_blank',
-        `width=${width},height=${height},top=${top},left=${left}`,
-      );
-    } else {
-      this.walletWindow.focus();
-    }
-  }
-
-  // Provides a reference to the wallet window
-  getWalletWindow(): Window | null {
-    return this.walletWindow;
-  }
-}

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

@@ -1,37 +0,0 @@
-interface UltraWalletSdkConfig {
-  width: number;
-  height: number;
-  walletUrls: {
-    mainnet: string;
-    testnet: string;
-  };
-  checkWindowInterval: number;
-  handshakeTimeout: number;
-  networkInfo: Record<
-    'mainnet' | 'testnet',
-    {
-      chainId: string;
-    }
-  >;
-}
-
-const UltraWalletSdkConfig: UltraWalletSdkConfig = Object.freeze({
-  width: 345,
-  height: 610,
-  walletUrls: {
-    mainnet: 'https://web-wallet.ultra.io',
-    testnet: 'https://web-wallet.staging.ultra.io',
-  },
-  networkInfo: {
-    mainnet: {
-      chainId: 'a9c481dfbc7d9506dc7e87e9a137c931b0a9303f64fd7a1d08b8230133920097',
-    },
-    testnet: {
-      chainId: '7fc56be645bb76ab9d747b53089f132dcb7681db06f0852cfa03eaf6f7ac80e9',
-    },
-  },
-  checkWindowInterval: 500,
-  handshakeTimeout: 10_000,
-});
-
-export default UltraWalletSdkConfig;

package/src/lib/interfaces/blockchain-transaction.interface.ts

@@ -1,21 +0,0 @@
-/**
- * Defines the structure of a blockchain transaction request to be signed by the Ultra Wallet.
- */
-export interface BlockchainTransaction {
-  /**
-   * The smart contract address or name to interact with.
-   */
-  contract: string;
-  /**
-   * The action or method to call on the contract.
-   */
-  action: string;
-  /**
-   * The data payload for the contract action.
-   */
-  data: any;
-  /**
-   * List of authorizations (account@permission) required for the transaction.
-   */
-  authorizations?: string[];
-}

package/src/lib/interfaces/connect-params.interface.ts

@@ -1,13 +0,0 @@
-/**
- * Optional parameters for establishing a connection with the Ultra Wallet.
- */
-export interface ConnectParams {
-  /**
-   * If true, do not prompt the user for permissions; share account info only if Dapp is already trusted.
-   */
-  onlyIfTrusted?: boolean;
-  /**
-   * Optional referral code to associate with the connection request.
-   */
-  referralCode?: string;
-}

package/src/lib/interfaces/error-enum.ts

@@ -1,15 +0,0 @@
-export enum SdkErrorCode {
-  USER_REJECTED_REQUEST = 4001,
-  WALLET_HANDSHAKE_TIMEOUT = 4300,
-  WALLET_WINDOW_UNAVAILABLE = 4301,
-  REQUESTED_RESOURCE_NOT_AVAILABLE = 32002,
-  UNKNOWN_ERROR = -32604,
-}
-
-export const SDK_ERROR_MESSAGE: { [key in SdkErrorCode]: string } = {
-  [SdkErrorCode.USER_REJECTED_REQUEST]: 'The user rejected the request.',
-  [SdkErrorCode.WALLET_HANDSHAKE_TIMEOUT]: 'Timeout to connect with the web wallet.',
-  [SdkErrorCode.WALLET_WINDOW_UNAVAILABLE]: 'The Web Wallet is not available.',
-  [SdkErrorCode.REQUESTED_RESOURCE_NOT_AVAILABLE]: 'Requested resource not available.',
-  [SdkErrorCode.UNKNOWN_ERROR]: 'Unknown error occurred.',
-};

package/src/lib/interfaces/json-rpc-message.interface.ts

@@ -1,7 +0,0 @@
-export interface JsonRpcMessage {
-  jsonrpc: '2.0';
-  method: string;
-  params?: any;
-  id?: string;
-  result?: any;
-}

package/src/lib/interfaces/purchase-item.interface.ts

@@ -1,7 +0,0 @@
-/**
- * Enumeration of supported item types that can be purchased via the Ultra Wallet.
- */
-export enum PurchaseItemType {
-  UNIQ_FACTORY = 'UniqFactory',
-  GAME_FACTORY = 'GameFactory',
-}

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

@@ -1,157 +0,0 @@
-/**
- * A generic wrapper for all Ultra Wallet SDK responses.
- * Encapsulates the status, data payload, and optional error messaging or codes.
- *
- * @template T The type of the data payload contained in the response.
- */
-export interface UltraResponse<T = any> {
-  /**
-   * The status of the response, e.g., success, fail, or error.
-   */
-  status: ResponseStatus;
-  /**
-   * The actual response data payload.
-   */
-  data: T;
-  /**
-   * Optional end-user-readable message, explaining what went wrong (if applicable).
-   */
-  message?: string;
-  /**
-   * Optional error or status code.
-   */
-  code?: number;
-}
-
-/**
- * Enumeration of possible response statuses returned by the Ultra Wallet SDK.
- */
-export enum ResponseStatus {
-  SUCCESS = 'success',
-  FAIL = 'fail',
-  ERROR = 'error',
-}
-
-/**
- * Represents the result of a disconnect request.
- * A boolean indicating whether the disconnection was successful.
- */
-export type DisconnectResponse = boolean;
-
-/**
- * Represents the result of a successful connection request, containing the user's account details.
- */
-export type ConnectResult = Array<{
-  /**
-   * The blockchain network identifier.
-   */
-  blockchainid: string;
-  /**
-   * The public key associated with the user's account.
-   */
-  publicKey: string;
-}>;
-
-/**
- * The result structure returned after a successful item purchase using the Ultra Wallet.
- * Contains metadata about the purchased items and the associated blockchain transaction.
- */
-export interface PurchaseItemResult {
-  /**
-   * An ID associated with the purchase order, used for support requests if required.
-   */
-  orderHash: string;
-
-  items: {
-    /**
-     * The ID of the minted Uniq.
-     */
-    artifactId: string;
-    /**
-     * The purchased item ID.
-     */
-    productId: string;
-    /**
-     * The ID of the transaction in the blockchain, useful for tracking the status and details of the transaction.
-     */
-    blockchainTransactionId: string;
-  }[];
-}
-
-/**
- * Represents the result returned after signing a message with the Ultra Wallet.
- */
-export interface SignMessageResult {
-  signature: string;
-}
-
-/**
- * Represents the result returned after signing a blockchain transaction with the Ultra Wallet.
- */
-export interface SignTransactionResult {
-  /**
-   * The hash of the signed blockchain transaction.
-   */
-  transactionHash?: string;
-  processed?: {
-    id: string;
-    block_num: number;
-    block_time: string; // ISO timestamp
-    producer_block_id: string | null;
-    receipt: {
-      status: string;
-      cpu_usage_us: number;
-      net_usage_words: number;
-    };
-    elapsed: number;
-    net_usage: number;
-    scheduled: boolean;
-    action_traces: ActionTrace[];
-    account_ram_delta: any | null;
-    except: any | null;
-    error_code: number | null;
-  };
-}
-
-export interface ActionTrace {
-  action_ordinal: number;
-  creator_action_ordinal: number;
-  closest_unnotified_ancestor_action_ordinal: number;
-  receipt: {
-    receiver: string;
-    act_digest: string;
-    global_sequence: number;
-    recv_sequence: number;
-    auth_sequence: [string, number][];
-    code_sequence: number;
-    abi_sequence: number;
-  };
-  receiver: string;
-  act: {
-    account: string;
-    name: string;
-    authorization: {
-      actor: string;
-      permission: string;
-    }[];
-    data: {
-      from: string;
-      to: string;
-      quantity: string;
-      memo: string;
-    };
-    hex_data: string;
-  };
-  context_free: boolean;
-  elapsed: number;
-  console: string;
-  trx_id: string;
-  block_num: number;
-  block_time: string;
-  producer_block_id: string | null;
-  account_ram_deltas: any[];
-  except: any | null;
-  error_code: number | null;
-  return_value_hex_data: string;
-  inline_traces: ActionTrace[];
-}