@autonomys/auto-utils 0.1.1

package/README.md

@@ -0,0 +1,106 @@
+# Autonomys SDK - TypeScript
+
+Welcome to the Autonomys SDK! This README provides an overview of the SDK's functionalities, including wallet setup, network management, data storage, and cryptographic operations. Each section provides a brief description of the included functions and their usage.
+
+## Table of Contents
+
+1. Wallet Management
+2. Network Management
+3. Data Storage
+4. Cryptographic Functions
+5. API Activation
+6. Constants
+7. Types
+
+## Wallet Management
+
+### setupWallet
+
+Sets up a wallet using a mnemonic or URI.
+
+```typescript
+export const setupWallet = async (input: MnemonicOrURI): Promise<KeyringPair>
+```
+
+- input: The mnemonic or URI used to set up the wallet.
+- Returns a KeyringPair.
+
+#### activateWallet
+
+Activates a wallet for a given network or domain and returns API and accounts.
+
+```typescript
+export const activateWallet = async (input: ActivateWalletInput): Promise<WalletActivated>
+```
+
+- input: Network or domain input along with mnemonic or URI and app name.
+- Returns an object containing api and accounts.
+
+#### mockWallets
+
+Creates mock wallets for a given network or domain.
+
+```typescript
+export const mockWallets = async (network: NetworkInput | DomainInput): Promise<WalletActivated[]>
+```
+
+- network: Network or domain input.
+- Returns an array of WalletActivated objects.
+
+#### getMockWallet
+
+Retrieves a mock wallet by name.
+
+```typescript
+export const getMockWallet = (name: string, wallets: WalletActivated[]): WalletActivated
+```
+
+- name: Name of the mock wallet.
+- wallets: Array of activated wallets.
+- Returns a WalletActivated object.
+
+### Network Management
+
+#### getNetworkDetails
+
+Retrieves details of a specified network.
+
+```typescript
+export const getNetworkDetails = (input?: NetworkInput) => Network
+```
+
+- input: Network input.
+- Returns network details.
+
+#### getNetworkRpcUrls
+
+Retrieves RPC URLs for a specified network.
+
+```typescript
+export const getNetworkRpcUrls = (input?: NetworkInput) => string[]
+```
+
+- input: Network input.
+- Returns an array of RPC URLs.
+
+#### getNetworkDomainDetails
+
+Retrieves details of a specified network domain.
+
+```typescript
+export const getNetworkDomainDetails = (input: DomainInput) => Domain
+```
+
+- input: Domain input.
+- Returns domain details.
+
+#### getNetworkDomainRpcUrls
+
+Retrieves RPC URLs for a specified network domain.
+
+```typescript
+export const getNetworkDomainRpcUrls = (input: DomainInput) => string[]
+```
+
+- input: Domain input.
+- Returns an array of RPC URLs.

package/dist/api.d.ts

@@ -0,0 +1,7 @@
+import { ApiPromise } from '@polkadot/api';
+import type { DomainInput, NetworkInput } from './types/network';
+export declare const activate: (input?: NetworkInput) => Promise<ApiPromise>;
+export declare const activateDomain: (input: DomainInput) => Promise<ApiPromise>;
+export declare const disconnect: () => Promise<void>;
+export declare const disconnectDomain: () => Promise<void>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAc,MAAM,eAAe,CAAA;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAQhE,eAAO,MAAM,QAAQ,WAAkB,YAAY,wBASlD,CAAA;AAED,eAAO,MAAM,cAAc,UAAiB,WAAW,wBAStD,CAAA;AAED,eAAO,MAAM,UAAU,qBAOtB,CAAA;AAED,eAAO,MAAM,gBAAgB,qBAO5B,CAAA"}

package/dist/api.js

@@ -0,0 +1,57 @@
+"use strict";
+// file: src/api.ts
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disconnectDomain = exports.disconnect = exports.activateDomain = exports.activate = void 0;
+const api_1 = require("@polkadot/api");
+const network_1 = require("./network");
+let provider = null;
+let apiInstance = null;
+let domainProvider = null;
+let apiDomainInstance = null;
+const activate = (input) => __awaiter(void 0, void 0, void 0, function* () {
+    // Get the first rpc urls for the network
+    const rpcUrl = (0, network_1.getNetworkRpcUrls)(input);
+    // Create the provider
+    provider = new api_1.WsProvider(rpcUrl[0]);
+    // Create the API instance
+    apiInstance = yield api_1.ApiPromise.create({ provider });
+    return apiInstance;
+});
+exports.activate = activate;
+const activateDomain = (input) => __awaiter(void 0, void 0, void 0, function* () {
+    // Get the first rpc urls for the network
+    const rpcUrl = (0, network_1.getNetworkDomainRpcUrls)(input);
+    // Create the provider
+    domainProvider = new api_1.WsProvider(rpcUrl[0]);
+    // Create the API instance
+    apiDomainInstance = yield api_1.ApiPromise.create({ provider: domainProvider });
+    return apiDomainInstance;
+});
+exports.activateDomain = activateDomain;
+const disconnect = () => __awaiter(void 0, void 0, void 0, function* () {
+    // Disconnect the API instance and the provider if they exist
+    if (apiInstance) {
+        yield apiInstance.disconnect();
+        apiInstance = null;
+        provider = null;
+    }
+});
+exports.disconnect = disconnect;
+const disconnectDomain = () => __awaiter(void 0, void 0, void 0, function* () {
+    // Disconnect the API instance and the provider if they exist
+    if (apiDomainInstance) {
+        yield apiDomainInstance.disconnect();
+        apiDomainInstance = null;
+        domainProvider = null;
+    }
+});
+exports.disconnectDomain = disconnectDomain;

package/dist/constants/index.d.ts

@@ -0,0 +1,3 @@
+export * from './network';
+export * from './wallet';
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA"}

package/dist/constants/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// file: src/constants/index.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./network"), exports);
+__exportStar(require("./wallet"), exports);

package/dist/constants/network.d.ts

@@ -0,0 +1,4 @@
+import type { Network } from '../types/network';
+export declare const networks: Network[];
+export declare const defaultNetwork: Network;
+//# sourceMappingURL=network.d.ts.map

package/dist/constants/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/constants/network.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,eAAO,MAAM,QAAQ,EAAE,OAAO,EAyD7B,CAAA;AAED,eAAO,MAAM,cAAc,SAAc,CAAA"}

package/dist/constants/network.js

@@ -0,0 +1,63 @@
+"use strict";
+// file: src/constants/network.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultNetwork = exports.networks = void 0;
+exports.networks = [
+    {
+        id: 'autonomys-gemini-3h',
+        name: 'Autonomys Testnet - Gemini 3H',
+        rpcUrls: [
+            'wss://rpc-0.gemini-3h.subspace.network/ws',
+            'wss://rpc-1.gemini-3h.subspace.network/ws',
+        ],
+        explorer: [
+            {
+                name: 'Astral',
+                url: 'https://explorer.subspace.network/gemini-3h/consensus/',
+            },
+            {
+                name: 'Subscan',
+                url: 'https://subspace.subscan.io/',
+            },
+        ],
+        domains: [
+            {
+                id: 'auto-id', // Placeholder
+                name: 'Autonomys - Auto-ID',
+                rpcUrls: ['wss://rpc.auto-id.subspace.network/ws'],
+            },
+            {
+                id: 'auto-evm', // Placeholder
+                name: 'Autonomys - Auto-EVM (Nova)',
+                rpcUrls: ['https://nova-0.gemini-3h.subspace.network/ws'],
+            },
+        ],
+        isTestnet: true,
+    },
+    {
+        id: 'autonomys-localhost',
+        name: 'Autonomys - Localhost',
+        rpcUrls: ['ws://127.0.0.1:9944/ws'],
+        explorer: [
+            {
+                name: 'Astral',
+                url: 'https://explorer.subspace.network/localhost/consensus/',
+            },
+        ],
+        domains: [
+            {
+                id: 'auto-id', // Placeholder
+                name: 'Autonomys - Auto-ID',
+                rpcUrls: ['ws://127.0.0.1:9945/ws'],
+            },
+            {
+                id: 'auto-evm', // Placeholder
+                name: 'Autonomys - Auto-EVM (Nova)',
+                rpcUrls: ['https:///127.0.0.1:9946/ws'],
+            },
+        ],
+        isTestnet: true,
+        isLocalhost: true,
+    },
+];
+exports.defaultNetwork = exports.networks[0];

package/dist/constants/wallet.d.ts

@@ -0,0 +1,2 @@
+export declare const mockURIs: string[];
+//# sourceMappingURL=wallet.d.ts.map

package/dist/constants/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/constants/wallet.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,UAWpB,CAAA"}

package/dist/constants/wallet.js

@@ -0,0 +1,16 @@
+"use strict";
+// file: src/constants/wallet.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockURIs = void 0;
+exports.mockURIs = [
+    '//Alice',
+    '//Bob',
+    '//Charlie',
+    '//Dave',
+    '//Eve',
+    '//Frank',
+    '//Grace',
+    '//Harry',
+    '//Ivy',
+    '//Jacob',
+];

package/dist/crypto.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hashes the given data using BLAKE2b-256.
+ *
+ * @param data Uint8Array - The data to be hashed.
+ * @returns string - The BLAKE2b-256 hash of the data as a hex string.
+ */
+export declare function blake2b_256(data: Uint8Array): string;
+/**
+ * Converts a string to a Uint8Array using UTF-8 encoding.
+ *
+ * This function uses the TextEncoder API to convert a plain string into its equivalent byte array
+ * representation in UTF-8 format. It is useful for scenarios where string data needs to be processed
+ * in a binary format, such as hashing or cryptographic operations.
+ *
+ * @param text The string to be converted into a byte array.
+ * @returns Uint8Array - The UTF-8 encoded byte array representation of the input string.
+ *
+ * @example
+ * const text = "Hello, world!";
+ * const byteArray = stringToUint8Array(text);
+ * console.log(byteArray); // Outputs the byte array of the string
+ */
+export declare function stringToUint8Array(text: string): Uint8Array;
+/**
+ * Concatenates two Uint8Array instances into a single Uint8Array.
+ */
+export declare function concatenateUint8Arrays(array1: Uint8Array, array2: Uint8Array): Uint8Array;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAG3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAKzF"}

package/dist/crypto.js

@@ -0,0 +1,45 @@
+"use strict";
+// file: src/crypto.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.concatenateUint8Arrays = exports.stringToUint8Array = exports.blake2b_256 = void 0;
+const util_crypto_1 = require("@polkadot/util-crypto");
+/**
+ * Hashes the given data using BLAKE2b-256.
+ *
+ * @param data Uint8Array - The data to be hashed.
+ * @returns string - The BLAKE2b-256 hash of the data as a hex string.
+ */
+function blake2b_256(data) {
+    return (0, util_crypto_1.blake2AsHex)(data, 256);
+}
+exports.blake2b_256 = blake2b_256;
+/**
+ * Converts a string to a Uint8Array using UTF-8 encoding.
+ *
+ * This function uses the TextEncoder API to convert a plain string into its equivalent byte array
+ * representation in UTF-8 format. It is useful for scenarios where string data needs to be processed
+ * in a binary format, such as hashing or cryptographic operations.
+ *
+ * @param text The string to be converted into a byte array.
+ * @returns Uint8Array - The UTF-8 encoded byte array representation of the input string.
+ *
+ * @example
+ * const text = "Hello, world!";
+ * const byteArray = stringToUint8Array(text);
+ * console.log(byteArray); // Outputs the byte array of the string
+ */
+function stringToUint8Array(text) {
+    const encoder = new TextEncoder(); // Create a new TextEncoder instance
+    return encoder.encode(text); // Encode the string to a Uint8Array using UTF-8 encoding
+}
+exports.stringToUint8Array = stringToUint8Array;
+/**
+ * Concatenates two Uint8Array instances into a single Uint8Array.
+ */
+function concatenateUint8Arrays(array1, array2) {
+    const combined = new Uint8Array(array1.length + array2.length);
+    combined.set(array1);
+    combined.set(array2, array1.length);
+    return combined;
+}
+exports.concatenateUint8Arrays = concatenateUint8Arrays;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './api';
+export * from './crypto';
+export * from './network';
+export * from './read';
+export * from './save';
+export * from './wallet';
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AAExB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+// file: src/index.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./api"), exports);
+__exportStar(require("./crypto"), exports);
+__exportStar(require("./network"), exports);
+__exportStar(require("./read"), exports);
+__exportStar(require("./save"), exports);
+__exportStar(require("./wallet"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);

package/dist/network.d.ts

@@ -0,0 +1,6 @@
+import type { DomainInput, NetworkInput } from './types/network';
+export declare const getNetworkDetails: (input?: NetworkInput) => import("./types/network").Network;
+export declare const getNetworkRpcUrls: (input?: NetworkInput) => string[];
+export declare const getNetworkDomainDetails: (input: DomainInput) => import("./types/network").Domain;
+export declare const getNetworkDomainRpcUrls: (input: DomainInput) => string[];
+//# sourceMappingURL=network.d.ts.map

package/dist/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhE,eAAO,MAAM,iBAAiB,WAAY,YAAY,sCAWrD,CAAA;AAED,eAAO,MAAM,iBAAiB,WAAY,YAAY,aAOrD,CAAA;AAED,eAAO,MAAM,uBAAuB,UAAW,WAAW,qCAYzD,CAAA;AAED,eAAO,MAAM,uBAAuB,UAAW,WAAW,aAMzD,CAAA"}

package/dist/network.js

@@ -0,0 +1,46 @@
+"use strict";
+// file: src/network.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNetworkDomainRpcUrls = exports.getNetworkDomainDetails = exports.getNetworkRpcUrls = exports.getNetworkDetails = void 0;
+const network_1 = require("./constants/network");
+const getNetworkDetails = (input) => {
+    // If no id is provided, return the default network
+    if (!input || !input.networkId)
+        return network_1.defaultNetwork;
+    const { networkId } = input;
+    // Find the network with the provided id
+    const network = network_1.networks.find((network) => network.id === networkId);
+    if (!network)
+        throw new Error(`Network with id ${networkId} not found`);
+    return network;
+};
+exports.getNetworkDetails = getNetworkDetails;
+const getNetworkRpcUrls = (input) => {
+    // Get the network details
+    const network = (0, exports.getNetworkDetails)(input);
+    if (!network.rpcUrls || network.rpcUrls.length === 0)
+        throw new Error(`Network has no rpcUrls`);
+    return network.rpcUrls;
+};
+exports.getNetworkRpcUrls = getNetworkRpcUrls;
+const getNetworkDomainDetails = (input) => {
+    const { networkId, domainId } = input;
+    // Find the network with the provided id
+    const network = (0, exports.getNetworkDetails)({ networkId });
+    if (!network)
+        throw new Error(`Network with id ${networkId} not found`);
+    // Find the domain with the provided id
+    const domain = network.domains.find((domain) => domain.id === domainId);
+    if (!domain)
+        throw new Error(`Domain with id ${domainId} not found`);
+    return domain;
+};
+exports.getNetworkDomainDetails = getNetworkDomainDetails;
+const getNetworkDomainRpcUrls = (input) => {
+    // Get the network details
+    const domain = (0, exports.getNetworkDomainDetails)(input);
+    if (!domain.rpcUrls || domain.rpcUrls.length === 0)
+        throw new Error(`Domain has no rpcUrls`);
+    return domain.rpcUrls;
+};
+exports.getNetworkDomainRpcUrls = getNetworkDomainRpcUrls;

package/dist/read.d.ts

@@ -0,0 +1,4 @@
+export declare const read: (key: string) => Promise<any>;
+export declare const readFromLocalStorage: (key: string) => Promise<any>;
+export declare const readFromFileSystem: (key: string) => Promise<any>;
+//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,QAAe,MAAM,iBAIrC,CAAA;AAED,eAAO,MAAM,oBAAoB,QAAe,MAAM,iBAUrD,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAe,MAAM,iBAWnD,CAAA"}

package/dist/read.js

@@ -0,0 +1,75 @@
+"use strict";
+// file: src/read.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFromFileSystem = exports.readFromLocalStorage = exports.read = void 0;
+const read = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    // detect if we are in the browser or in node
+    if (typeof window !== 'undefined')
+        return (0, exports.readFromLocalStorage)(key);
+    else
+        return (0, exports.readFromFileSystem)(key);
+});
+exports.read = read;
+const readFromLocalStorage = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof window !== 'undefined') {
+        // read from local storage
+        const value = localStorage.getItem(key);
+        try {
+            return value ? JSON.parse(value) : null;
+        }
+        catch (error) {
+            throw new Error('Failed to parse data from localStorage: ' + error);
+        }
+    }
+    else
+        throw new Error('This function can only be used in the browser');
+});
+exports.readFromLocalStorage = readFromLocalStorage;
+const readFromFileSystem = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof window === 'undefined') {
+        // read from file system
+        const fs = yield Promise.resolve().then(() => __importStar(require('fs/promises')));
+        try {
+            const data = yield fs.readFile(key, { encoding: 'utf-8' });
+            return JSON.parse(data);
+        }
+        catch (error) {
+            throw new Error('Failed to read or parse file: ' + error);
+        }
+    }
+    else
+        throw new Error('This function can only be used in node');
+});
+exports.readFromFileSystem = readFromFileSystem;

package/dist/save.d.ts

@@ -0,0 +1,4 @@
+export declare const save: (key: string, value: any) => Promise<void>;
+export declare const saveOnLocalStorage: (key: string, value: any) => Promise<void>;
+export declare const saveOnFileSystem: (key: string, value: any) => Promise<void>;
+//# sourceMappingURL=save.d.ts.map

package/dist/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../src/save.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,QAAe,MAAM,SAAS,GAAG,kBAIjD,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAe,MAAM,SAAS,GAAG,kBAK/D,CAAA;AAED,eAAO,MAAM,gBAAgB,QAAe,MAAM,SAAS,GAAG,kBAQ7D,CAAA"}

package/dist/save.js

@@ -0,0 +1,64 @@
+"use strict";
+// file: src/save.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveOnFileSystem = exports.saveOnLocalStorage = exports.save = void 0;
+const save = (key, value) => __awaiter(void 0, void 0, void 0, function* () {
+    // detect if we are in the browser or in node
+    if (typeof window !== 'undefined')
+        yield (0, exports.saveOnLocalStorage)(key, value);
+    else
+        yield (0, exports.saveOnFileSystem)(key, value);
+});
+exports.save = save;
+const saveOnLocalStorage = (key, value) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof window !== 'undefined')
+        // save on local storage
+        localStorage.setItem(key, JSON.stringify(value));
+    else
+        throw new Error('This function can only be used in the browser');
+});
+exports.saveOnLocalStorage = saveOnLocalStorage;
+const saveOnFileSystem = (key, value) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof window === 'undefined') {
+        // save on file system
+        const fs = yield Promise.resolve().then(() => __importStar(require('fs/promises')));
+        // Check if value is already a string to avoid unnecessary JSON string conversion
+        const data = typeof value === 'string' ? value : JSON.stringify(value);
+        yield fs.writeFile(key, JSON.stringify(data));
+    }
+    else
+        throw new Error('This function can only be used in node');
+});
+exports.saveOnFileSystem = saveOnFileSystem;

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './network';
+export * from './wallet';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// file: src/types/index.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./network"), exports);
+__exportStar(require("./wallet"), exports);

package/dist/types/network.d.ts

@@ -0,0 +1,26 @@
+export type Explorer = {
+    name: string;
+    url: string;
+};
+export type Domain = {
+    id: string;
+    name: string;
+    rpcUrls: string[];
+};
+export type Network = {
+    id: string;
+    name: string;
+    rpcUrls: string[];
+    explorer: Explorer[];
+    domains: Domain[];
+    isTestnet?: boolean;
+    isLocalhost?: boolean;
+};
+export type NetworkInput = {
+    networkId?: string;
+} | undefined;
+export type DomainInput = {
+    networkId?: string;
+    domainId: string;
+};
+//# sourceMappingURL=network.d.ts.map

package/dist/types/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/types/network.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,QAAQ,EAAE,CAAA;IACpB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA"}

package/dist/types/network.js

@@ -0,0 +1,3 @@
+"use strict";
+// file: src/types/network.ts
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/wallet.d.ts

@@ -0,0 +1,11 @@
+export type Mnemonic = {
+    mnemonic: string;
+};
+export type URI = {
+    uri: string;
+};
+export type AppName = {
+    appName: string;
+};
+export type MnemonicOrURI = Mnemonic | URI;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/types/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/types/wallet.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,GAAG,GAAG;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,GAAG,CAAA"}

package/dist/types/wallet.js

@@ -0,0 +1,3 @@
+"use strict";
+// file: src/types/wallet.ts
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/wallet.d.ts

@@ -0,0 +1,14 @@
+import type { ApiPromise } from '@polkadot/api';
+import type { InjectedAccountWithMeta } from '@polkadot/extension-inject/types';
+import type { KeyringPair } from '@polkadot/keyring/types';
+import type { AppName, DomainInput, MnemonicOrURI, NetworkInput } from './types';
+export declare const setupWallet: (input: MnemonicOrURI) => Promise<KeyringPair>;
+export type ActivateWalletInput = (NetworkInput | DomainInput) & MnemonicOrURI & AppName;
+export type WalletActivated = {
+    api: ApiPromise;
+    accounts: InjectedAccountWithMeta[] & KeyringPair[];
+};
+export declare const activateWallet: (input: ActivateWalletInput) => Promise<WalletActivated>;
+export declare const mockWallets: (network?: NetworkInput | DomainInput) => Promise<WalletActivated[]>;
+export declare const getMockWallet: (name: string, wallets: WalletActivated[]) => WalletActivated;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAA;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAK1D,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAY,aAAa,EAAE,YAAY,EAAO,MAAM,SAAS,CAAA;AAE/F,eAAO,MAAM,WAAW,UAAiB,aAAa,KAAG,QAAQ,WAAW,CAc3E,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,aAAa,GAAG,OAAO,CAAA;AACxF,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,UAAU,CAAA;IACf,QAAQ,EAAE,uBAAuB,EAAE,GAAG,WAAW,EAAE,CAAA;CACpD,CAAA;AAED,eAAO,MAAM,cAAc,UAAiB,mBAAmB,KAAG,QAAQ,eAAe,CA0BxF,CAAA;AAED,eAAO,MAAM,WAAW,aACb,YAAY,GAAG,WAAW,KAClC,QAAQ,eAAe,EAAE,CAQzB,CAAA;AAEH,eAAO,MAAM,aAAa,SAAU,MAAM,WAAW,eAAe,EAAE,KAAG,eAClB,CAAA"}

package/dist/wallet.js

@@ -0,0 +1,90 @@
+"use strict";
+// file: src/wallet.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMockWallet = exports.mockWallets = exports.activateWallet = exports.setupWallet = void 0;
+const api_1 = require("@polkadot/api");
+const util_crypto_1 = require("@polkadot/util-crypto");
+const api_2 = require("./api");
+const network_1 = require("./constants/network");
+const wallet_1 = require("./constants/wallet");
+const setupWallet = (input) => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, util_crypto_1.cryptoWaitReady)();
+    const keyring = new api_1.Keyring({ type: 'sr25519' });
+    let pair;
+    if (input.uri) {
+        // Treat as uri
+        pair = keyring.addFromUri(input.uri);
+    }
+    else if (input.mnemonic) {
+        // Treat as mnemonic
+        pair = keyring.addFromUri(input.mnemonic);
+    }
+    else
+        throw new Error('Invalid mnemonic or private key');
+    return pair;
+});
+exports.setupWallet = setupWallet;
+const activateWallet = (input) => __awaiter(void 0, void 0, void 0, function* () {
+    // Create the API instance
+    const api = input.domainId === undefined
+        ? yield (0, api_2.activate)(input)
+        : yield (0, api_2.activateDomain)(input);
+    const accounts = [];
+    if (typeof window !== 'undefined') {
+        const { web3Enable, web3Accounts } = yield Promise.resolve().then(() => __importStar(require('@polkadot/extension-dapp')));
+        // Enable Polkadot.js extension in the browser
+        yield web3Enable(input.appName || 'Auto');
+        // Get the list of accounts from the extension
+        const allAccounts = yield web3Accounts();
+        accounts.push(...allAccounts);
+        if (allAccounts.length === 0)
+            console.warn('No accounts found in the Polkadot.js extension');
+    }
+    else if (input.mnemonic || input.uri) {
+        // Attach the wallet in a node environment
+        const account = yield (0, exports.setupWallet)(input);
+        accounts.push(account);
+    }
+    else
+        throw new Error('No wallet provided');
+    return { api, accounts };
+});
+exports.activateWallet = activateWallet;
+const mockWallets = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (network = { networkId: network_1.defaultNetwork.id }) {
+    return yield Promise.all(wallet_1.mockURIs.map((uri) => (0, exports.activateWallet)(Object.assign(Object.assign({}, network), { uri }))));
+});
+exports.mockWallets = mockWallets;
+const getMockWallet = (name, wallets) => wallets[Object.values(wallet_1.mockURIs).indexOf(`//${name}`)];
+exports.getMockWallet = getMockWallet;

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@autonomys/auto-utils",
+  "version": "0.1.1",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "test": "jest"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@polkadot/api": "^11.2.1",
+    "@polkadot/extension-dapp": "^0.47.5",
+    "fs": "^0.0.1-security"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "ts-jest": "^29.1.4",
+    "typescript": "^5.4.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/subspace/auto-sdk"
+  },
+  "author": {
+    "name": "Autonomys",
+    "url": "https://www.autonomys.net"
+  },
+  "browser": {
+    "fs": false
+  },
+  "gitHead": "6de838d2d4b144450cc27d5fc05536904735fcc1"
+}