@ultraos/wallet-sdk 0.0.4 → 0.0.6

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@ultraos/wallet-sdk",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "homepage": "https://developers.ultra.io",
   "dependencies": {
+    "json-rpc-2.0": "^1.7.0",
     "tslib": "^2.3.0"
   },
-  "type": "commonjs",
+  "type": "module",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "module": "./src/index.js"
 }

package/LICENSE

@@ -1,165 +0,0 @@
-                   GNU LESSER GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
-
-Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
-Everyone is permitted to copy and distribute verbatim copies
-of this license document, but changing it is not allowed.
-
-
-This version of the GNU Lesser General Public License incorporates
-the terms and conditions of version 3 of the GNU General Public
-License, supplemented by the additional permissions listed below.
-
-0. Additional Definitions.
-
-As used herein, "this License" refers to version 3 of the GNU Lesser
-General Public License, and the "GNU GPL" refers to version 3 of the GNU
-General Public License.
-
-"The Library" refers to a covered work governed by this License,
-other than an Application or a Combined Work as defined below.
-
-An "Application" is any work that makes use of an interface provided
-by the Library, but which is not otherwise based on the Library.
-Defining a subclass of a class defined by the Library is deemed a mode
-of using an interface provided by the Library.
-
-A "Combined Work" is a work produced by combining or linking an
-Application with the Library.  The particular version of the Library
-with which the Combined Work was made is also called the "Linked
-Version".
-
-The "Minimal Corresponding Source" for a Combined Work means the
-Corresponding Source for the Combined Work, excluding any source code
-for portions of the Combined Work that, considered in isolation, are
-based on the Application, and not on the Linked Version.
-
-The "Corresponding Application Code" for a Combined Work means the
-object code and/or source code for the Application, including any data
-and utility programs needed for reproducing the Combined Work from the
-Application, but excluding the System Libraries of the Combined Work.
-
-1. Exception to Section 3 of the GNU GPL.
-
-You may convey a covered work under sections 3 and 4 of this License
-without being bound by section 3 of the GNU GPL.
-
-2. Conveying Modified Versions.
-
-If you modify a copy of the Library, and, in your modifications, a
-facility refers to a function or data to be supplied by an Application
-that uses the facility (other than as an argument passed when the
-facility is invoked), then you may convey a copy of the modified
-version:
-
-a) under this License, provided that you make a good faith effort to
-ensure that, in the event an Application does not supply the
-function or data, the facility still operates, and performs
-whatever part of its purpose remains meaningful, or
-
-b) under the GNU GPL, with none of the additional permissions of
-this License applicable to that copy.
-
-3. Object Code Incorporating Material from Library Header Files.
-
-The object code form of an Application may incorporate material from
-a header file that is part of the Library.  You may convey such object
-code under terms of your choice, provided that, if the incorporated
-material is not limited to numerical parameters, data structure
-layouts and accessors, or small macros, inline functions and templates
-(ten or fewer lines in length), you do both of the following:
-
-a) Give prominent notice with each copy of the object code that the
-Library is used in it and that the Library and its use are
-covered by this License.
-
-b) Accompany the object code with a copy of the GNU GPL and this license
-document.
-
-4. Combined Works.
-
-You may convey a Combined Work under terms of your choice that,
-taken together, effectively do not restrict modification of the
-portions of the Library contained in the Combined Work and reverse
-engineering for debugging such modifications, if you also do each of
-the following:
-
-a) Give prominent notice with each copy of the Combined Work that
-the Library is used in it and that the Library and its use are
-covered by this License.
-
-b) Accompany the Combined Work with a copy of the GNU GPL and this license
-document.
-
-c) For a Combined Work that displays copyright notices during
-execution, include the copyright notice for the Library among
-these notices, as well as a reference directing the user to the
-copies of the GNU GPL and this license document.
-
-d) Do one of the following:
-
-       0) Convey the Minimal Corresponding Source under the terms of this
-       License, and the Corresponding Application Code in a form
-       suitable for, and under terms that permit, the user to
-       recombine or relink the Application with a modified version of
-       the Linked Version to produce a modified Combined Work, in the
-       manner specified by section 6 of the GNU GPL for conveying
-       Corresponding Source.
-
-       1) Use a suitable shared library mechanism for linking with the
-       Library.  A suitable mechanism is one that (a) uses at run time
-       a copy of the Library already present on the user's computer
-       system, and (b) will operate properly with a modified version
-       of the Library that is interface-compatible with the Linked
-       Version.
-
-e) Provide Installation Information, but only if you would otherwise
-be required to provide such information under section 6 of the
-GNU GPL, and only to the extent that such information is
-necessary to install and execute a modified version of the
-Combined Work produced by recombining or relinking the
-Application with a modified version of the Linked Version. (If
-you use option 4d0, the Installation Information must accompany
-the Minimal Corresponding Source and Corresponding Application
-Code. If you use option 4d1, you must provide the Installation
-Information in the manner specified by section 6 of the GNU GPL
-for conveying Corresponding Source.)
-
-5. Combined Libraries.
-
-You may place library facilities that are a work based on the
-Library side by side in a single library together with other library
-facilities that are not Applications and are not covered by this
-License, and convey such a combined library under terms of your
-choice, if you do both of the following:
-
-a) Accompany the combined library with a copy of the same work based
-on the Library, uncombined with any other library facilities,
-conveyed under the terms of this License.
-
-b) Give prominent notice with the combined library that part of it
-is a work based on the Library, and explaining where to find the
-accompanying uncombined form of the same work.
-
-6. Revised Versions of the GNU Lesser General Public License.
-
-The Free Software Foundation may publish revised and/or new versions
-of the GNU Lesser General Public License from time to time. Such new
-versions will be similar in spirit to the present version, but may
-differ in detail to address new problems or concerns.
-
-Each version is given a distinguishing version number. If the
-Library as you received it specifies that a certain numbered version
-of the GNU Lesser General Public License "or any later version"
-applies to it, you have the option of following the terms and
-conditions either of that published version or of any later version
-published by the Free Software Foundation. If the Library as you
-received it does not specify a version number of the GNU Lesser
-General Public License, you may choose any version of the GNU Lesser
-General Public License ever published by the Free Software Foundation.
-
-If the Library as you received it specifies that a proxy can decide
-whether future versions of the GNU Lesser General Public License shall
-apply, that proxy's public statement of acceptance of any version is
-permanent authorization for you to choose that version for the
-Library.

package/README.md

@@ -1,74 +0,0 @@
-# Ultra Wallet SDK
-
-Ultra Wallet SDK provides an easy-to-use client for interacting with the Ultra blockchain wallet, either through the
-browser extension or via a web fallback.
-
-## ✨ Features
-
-- Automatically detects and uses the Ultra Wallet Extension if available.
-- Falls back to a Web Wallet if the extension is not installed.
-- Connect, sign messages, sign transactions, and initiate purchases with a simple API.
-- Environment support: `mainnet`, `testnet`, or custom wallet URLs.
-
-## 📦 Installation
-
-```bash
-npm install @ultraos/wallet-sdk
-```
-
-or
-
-```bash
-yarn add @ultraos/wallet-sdk
-```
-
-## 🚀 Usage
-
-```ts
-import { UltraWalletSDK } from '@ultraos/wallet-sdk';
-
-// Basic initialization (auto-detect extension or fallback to mainnet Web Wallet)
-const ultra = new UltraWalletSDK();
-
-// Optionally initialize with environment configuration
-const ultraTestnet = new UltraWalletSDK({ environment: 'testnet' });
-
-// Connect
-await ultra.connect();
-
-// Sign a message
-const signature = await ultra.signMessage('message: Hello, Ultra!');
-
-// Sign a transaction
-await ultra.signTransaction({
-  contract: 'eosio.token',
-  action: 'transfer',
-  data: { from: 'user', to: 'receiver', quantity: '1.00000000 UOS', memo: '' },
-  authorizations: ['user@active'],
-});
-```
-
-## ⚙️ Configuration
-
-You can pass options during initialization:
-
-```ts
-new UltraWalletSDK({
-  environment: 'testnet', // or 'mainnet', or provide custom URL
-});
-```
-
-## 📚 API
-
-### Methods
-
-- `connect(): Promise<ConnectResult>`
-- `disconnect(): Promise<void>`
-- `signMessage(message: string): Promise<string>`
-- `signTransaction(transaction: BlockchainTransaction | BlockchainTransaction[]): Promise<SignTransactionResult>`
-- `getChainId(): Promise<string>`
-- `purchaseItem(itemType: PurchaseItemType, itemId: string): Promise<PurchaseItemResult>`
-
----
-
-Tests are run with [Jest](https://jestjs.io).

package/dist/libs/wallet-sdk/libs/wallet-sdk/README.md

@@ -1,74 +0,0 @@
-# Ultra Wallet SDK
-
-Ultra Wallet SDK provides an easy-to-use client for interacting with the Ultra blockchain wallet, either through the
-browser extension or via a web fallback.
-
-## ✨ Features
-
-- Automatically detects and uses the Ultra Wallet Extension if available.
-- Falls back to a Web Wallet if the extension is not installed.
-- Connect, sign messages, sign transactions, and initiate purchases with a simple API.
-- Environment support: `mainnet`, `testnet`, or custom wallet URLs.
-
-## 📦 Installation
-
-```bash
-npm install @ultraos/wallet-sdk
-```
-
-or
-
-```bash
-yarn add @ultraos/wallet-sdk
-```
-
-## 🚀 Usage
-
-```ts
-import { UltraWalletSDK } from '@ultraos/wallet-sdk';
-
-// Basic initialization (auto-detect extension or fallback to mainnet Web Wallet)
-const ultra = new UltraWalletSDK();
-
-// Optionally initialize with environment configuration
-const ultraTestnet = new UltraWalletSDK({ environment: 'testnet' });
-
-// Connect
-await ultra.connect();
-
-// Sign a message
-const signature = await ultra.signMessage('message: Hello, Ultra!');
-
-// Sign a transaction
-await ultra.signTransaction({
-  contract: 'eosio.token',
-  action: 'transfer',
-  data: { from: 'user', to: 'receiver', quantity: '1.00000000 UOS', memo: '' },
-  authorizations: ['user@active'],
-});
-```
-
-## ⚙️ Configuration
-
-You can pass options during initialization:
-
-```ts
-new UltraWalletSDK({
-  environment: 'testnet', // or 'mainnet', or provide custom URL
-});
-```
-
-## 📚 API
-
-### Methods
-
-- `connect(): Promise<ConnectResult>`
-- `disconnect(): Promise<void>`
-- `signMessage(message: string): Promise<string>`
-- `signTransaction(transaction: BlockchainTransaction | BlockchainTransaction[]): Promise<SignTransactionResult>`
-- `getChainId(): Promise<string>`
-- `purchaseItem(itemType: PurchaseItemType, itemId: string): Promise<PurchaseItemResult>`
-
----
-
-Tests are run with [Jest](https://jestjs.io).

package/eslint.config.js

@@ -1,5 +0,0 @@
-const eslintrcOverrides = require('../../eslintrc-overrides.config.js');
-
-const baseConfig = require('../../eslint.config.js');
-
-module.exports = [...baseConfig, ...eslintrcOverrides];

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/index.ts

@@ -1,2 +0,0 @@
-export * from './lib/interfaces';
-export * from './lib/ultra-wallet-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);
-    });
-  }
-}