@octaflowlabs/onchain-sdk 1.0.0-test15 → 1.0.0-test16

package/dist/cjs/index.d.ts

@@ -4,11 +4,14 @@ export { ERC20_TOKEN_CONTRACT_ABI };
 /** constants exports */
 export { GAS_LIMIT_PER_TX_TYPE } from './constants/constants';
 /** basic blockchain exports */
-export { buildMaxNativeTransferTx, buildUnsignedTransferTx } from './blockchain/buildUnsignedTransferTx';
+export { buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
 export { broadcastTransaction } from './blockchain/broadcastTransaction';
 export { estimateGasLimitFromProvider } from './blockchain/estimateGasLimitFromProvider';
 export { getProvider } from './blockchain/getProvider';
 export { txStatus } from './blockchain/txStatus';
+/** services exports */
+export { EvmWalletService, EvmGeneratedWallet, EvmDerivedWallet, } from './services/evm-wallet-core/evmWalletService';
+export { EntropySource } from './services/evm-wallet-core/entropy';
 /** utils exports */
 export { getShortenTransactionHash } from './utils/getShortenTxHash';
 export { transformBigInt } from './utils/transformBigInt';

package/dist/cjs/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NATIVE_TOKENS = exports.transformBigInt = exports.getShortenTransactionHash = exports.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = exports.GAS_LIMIT_PER_TX_TYPE = exports.ERC20_TOKEN_CONTRACT_ABI = void 0;
+exports.NATIVE_TOKENS = exports.transformBigInt = exports.getShortenTransactionHash = exports.EvmWalletService = exports.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = exports.GAS_LIMIT_PER_TX_TYPE = exports.ERC20_TOKEN_CONTRACT_ABI = void 0;
 /** ABIs exports */
 const ERC20_TOKEN_CONTRACT_ABI_1 = __importDefault(require("./ABIs/ERC20_TOKEN_CONTRACT_ABI"));
 exports.ERC20_TOKEN_CONTRACT_ABI = ERC20_TOKEN_CONTRACT_ABI_1.default;
@@ -22,6 +22,9 @@ var getProvider_1 = require("./blockchain/getProvider");
 Object.defineProperty(exports, "getProvider", { enumerable: true, get: function () { return getProvider_1.getProvider; } });
 var txStatus_1 = require("./blockchain/txStatus");
 Object.defineProperty(exports, "txStatus", { enumerable: true, get: function () { return txStatus_1.txStatus; } });
+/** services exports */
+var evmWalletService_1 = require("./services/evm-wallet-core/evmWalletService");
+Object.defineProperty(exports, "EvmWalletService", { enumerable: true, get: function () { return evmWalletService_1.EvmWalletService; } });
 /** utils exports */
 var getShortenTxHash_1 = require("./utils/getShortenTxHash");
 Object.defineProperty(exports, "getShortenTransactionHash", { enumerable: true, get: function () { return getShortenTxHash_1.getShortenTransactionHash; } });

package/dist/cjs/services/evm-wallet-core/entropy.d.ts

@@ -0,0 +1,3 @@
+export interface EntropySource {
+    randomBytes(length: number): Uint8Array;
+}

package/dist/cjs/services/evm-wallet-core/entropy.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/services/evm-wallet-core/evmWalletService.d.ts

@@ -0,0 +1,27 @@
+/** local imports */
+import { EntropySource } from './entropy';
+export interface EvmGeneratedWallet {
+    address: string;
+    mnemonic: string;
+    privateKey: string;
+    path: string;
+}
+export interface EvmDerivedWallet {
+    address: string;
+    privateKey: string;
+    path: string;
+    publicKey: string;
+}
+export declare class EvmWalletService {
+    private entropy;
+    private readonly DEFAULT_DERIVATION_PATH;
+    constructor(entropy: EntropySource);
+    generateNewWallet(accountIndex?: number, wordCount?: 12 | 15 | 18 | 21 | 24): EvmGeneratedWallet;
+    generateMultipleWallets(mnemonic: string, count: number, startIndex?: number): EvmDerivedWallet[];
+    deriveWalletFromMnemonic(mnemonic: string, accountIndex?: number, customPath?: string): EvmDerivedWallet;
+    importFromPrivateKey(privateKey: string): Omit<EvmDerivedWallet, 'path'>;
+    signMessage(privateKey: string, message: string): Promise<string>;
+    isValidMnemonic(mnemonic: string): boolean;
+    private validateMnemonic;
+    private getEntropyForWordCount;
+}

package/dist/cjs/services/evm-wallet-core/evmWalletService.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvmWalletService = void 0;
+/** npm imports */
+const ethers_1 = require("ethers");
+class EvmWalletService {
+    constructor(entropy) {
+        this.entropy = entropy;
+        this.DEFAULT_DERIVATION_PATH = "m/44'/60'/0'/0";
+    }
+    generateNewWallet(accountIndex = 0, wordCount = 12) {
+        const entropy = this.getEntropyForWordCount(wordCount);
+        const randomBytesArray = this.entropy.randomBytes(entropy);
+        const customMnemonic = ethers_1.Mnemonic.fromEntropy(randomBytesArray);
+        const path = `${this.DEFAULT_DERIVATION_PATH}/${accountIndex}`;
+        const hdNode = ethers_1.HDNodeWallet.fromMnemonic(customMnemonic, path);
+        return {
+            address: hdNode.address,
+            mnemonic: customMnemonic.phrase,
+            privateKey: hdNode.privateKey,
+            path,
+        };
+    }
+    generateMultipleWallets(mnemonic, count, startIndex = 0) {
+        this.validateMnemonic(mnemonic);
+        const wallets = [];
+        const mnemonicObject = ethers_1.Mnemonic.fromPhrase(mnemonic);
+        for (let i = 0; i < count; i++) {
+            const accountIndex = startIndex + i;
+            const path = `${this.DEFAULT_DERIVATION_PATH}/${accountIndex}`;
+            const hdNode = ethers_1.HDNodeWallet.fromMnemonic(mnemonicObject, path);
+            wallets.push({
+                address: hdNode.address,
+                privateKey: hdNode.privateKey,
+                path,
+                publicKey: hdNode.publicKey,
+            });
+        }
+        return wallets;
+    }
+    deriveWalletFromMnemonic(mnemonic, accountIndex = 0, customPath) {
+        this.validateMnemonic(mnemonic);
+        const path = customPath || `${this.DEFAULT_DERIVATION_PATH}/${accountIndex}`;
+        const mnemonicObject = ethers_1.Mnemonic.fromPhrase(mnemonic);
+        const hdNode = ethers_1.HDNodeWallet.fromMnemonic(mnemonicObject, path);
+        return {
+            address: hdNode.address,
+            privateKey: hdNode.privateKey,
+            path,
+            publicKey: hdNode.publicKey,
+        };
+    }
+    importFromPrivateKey(privateKey) {
+        const wallet = new ethers_1.Wallet(privateKey);
+        return {
+            address: wallet.address,
+            privateKey: wallet.privateKey,
+            publicKey: wallet.signingKey.publicKey,
+        };
+    }
+    async signMessage(privateKey, message) {
+        const wallet = new ethers_1.Wallet(privateKey);
+        return await wallet.signMessage(message);
+    }
+    isValidMnemonic(mnemonic) {
+        try {
+            ethers_1.Mnemonic.fromPhrase(mnemonic);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    validateMnemonic(mnemonic) {
+        if (!this.isValidMnemonic(mnemonic)) {
+            throw new Error('Invalid mnemonic phrase');
+        }
+    }
+    getEntropyForWordCount(wordCount) {
+        const entropyMap = {
+            12: 16, // 128 bits
+            15: 20, // 160 bits
+            18: 24, // 192 bits
+            21: 28, // 224 bits
+            24: 32, // 256 bits
+        };
+        return entropyMap[wordCount];
+    }
+}
+exports.EvmWalletService = EvmWalletService;

package/dist/index.d.ts

@@ -4,11 +4,14 @@ export { ERC20_TOKEN_CONTRACT_ABI };
 /** constants exports */
 export { GAS_LIMIT_PER_TX_TYPE } from './constants/constants';
 /** basic blockchain exports */
-export { buildMaxNativeTransferTx, buildUnsignedTransferTx } from './blockchain/buildUnsignedTransferTx';
+export { buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
 export { broadcastTransaction } from './blockchain/broadcastTransaction';
 export { estimateGasLimitFromProvider } from './blockchain/estimateGasLimitFromProvider';
 export { getProvider } from './blockchain/getProvider';
 export { txStatus } from './blockchain/txStatus';
+/** services exports */
+export { EvmWalletService, EvmGeneratedWallet, EvmDerivedWallet, } from './services/evm-wallet-core/evmWalletService';
+export { EntropySource } from './services/evm-wallet-core/entropy';
 /** utils exports */
 export { getShortenTransactionHash } from './utils/getShortenTxHash';
 export { transformBigInt } from './utils/transformBigInt';

package/dist/index.js

@@ -4,11 +4,13 @@ export { ERC20_TOKEN_CONTRACT_ABI };
 /** constants exports */
 export { GAS_LIMIT_PER_TX_TYPE } from './constants/constants';
 /** basic blockchain exports */
-export { buildMaxNativeTransferTx, buildUnsignedTransferTx } from './blockchain/buildUnsignedTransferTx';
+export { buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
 export { broadcastTransaction } from './blockchain/broadcastTransaction';
 export { estimateGasLimitFromProvider } from './blockchain/estimateGasLimitFromProvider';
 export { getProvider } from './blockchain/getProvider';
 export { txStatus } from './blockchain/txStatus';
+/** services exports */
+export { EvmWalletService, } from './services/evm-wallet-core/evmWalletService';
 /** utils exports */
 export { getShortenTransactionHash } from './utils/getShortenTxHash';
 export { transformBigInt } from './utils/transformBigInt';

package/dist/services/evm-wallet-core/entropy.d.ts

@@ -0,0 +1,3 @@
+export interface EntropySource {
+    randomBytes(length: number): Uint8Array;
+}

package/dist/services/evm-wallet-core/entropy.js

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

package/dist/services/evm-wallet-core/evmWalletService.d.ts

@@ -0,0 +1,27 @@
+/** local imports */
+import { EntropySource } from './entropy';
+export interface EvmGeneratedWallet {
+    address: string;
+    mnemonic: string;
+    privateKey: string;
+    path: string;
+}
+export interface EvmDerivedWallet {
+    address: string;
+    privateKey: string;
+    path: string;
+    publicKey: string;
+}
+export declare class EvmWalletService {
+    private entropy;
+    private readonly DEFAULT_DERIVATION_PATH;
+    constructor(entropy: EntropySource);
+    generateNewWallet(accountIndex?: number, wordCount?: 12 | 15 | 18 | 21 | 24): EvmGeneratedWallet;
+    generateMultipleWallets(mnemonic: string, count: number, startIndex?: number): EvmDerivedWallet[];
+    deriveWalletFromMnemonic(mnemonic: string, accountIndex?: number, customPath?: string): EvmDerivedWallet;
+    importFromPrivateKey(privateKey: string): Omit<EvmDerivedWallet, 'path'>;
+    signMessage(privateKey: string, message: string): Promise<string>;
+    isValidMnemonic(mnemonic: string): boolean;
+    private validateMnemonic;
+    private getEntropyForWordCount;
+}

package/dist/services/evm-wallet-core/evmWalletService.js

@@ -0,0 +1,86 @@
+/** npm imports */
+import { Wallet as EthersWallet, HDNodeWallet, Mnemonic } from 'ethers';
+export class EvmWalletService {
+    constructor(entropy) {
+        this.entropy = entropy;
+        this.DEFAULT_DERIVATION_PATH = "m/44'/60'/0'/0";
+    }
+    generateNewWallet(accountIndex = 0, wordCount = 12) {
+        const entropy = this.getEntropyForWordCount(wordCount);
+        const randomBytesArray = this.entropy.randomBytes(entropy);
+        const customMnemonic = Mnemonic.fromEntropy(randomBytesArray);
+        const path = `${this.DEFAULT_DERIVATION_PATH}/${accountIndex}`;
+        const hdNode = HDNodeWallet.fromMnemonic(customMnemonic, path);
+        return {
+            address: hdNode.address,
+            mnemonic: customMnemonic.phrase,
+            privateKey: hdNode.privateKey,
+            path,
+        };
+    }
+    generateMultipleWallets(mnemonic, count, startIndex = 0) {
+        this.validateMnemonic(mnemonic);
+        const wallets = [];
+        const mnemonicObject = Mnemonic.fromPhrase(mnemonic);
+        for (let i = 0; i < count; i++) {
+            const accountIndex = startIndex + i;
+            const path = `${this.DEFAULT_DERIVATION_PATH}/${accountIndex}`;
+            const hdNode = HDNodeWallet.fromMnemonic(mnemonicObject, path);
+            wallets.push({
+                address: hdNode.address,
+                privateKey: hdNode.privateKey,
+                path,
+                publicKey: hdNode.publicKey,
+            });
+        }
+        return wallets;
+    }
+    deriveWalletFromMnemonic(mnemonic, accountIndex = 0, customPath) {
+        this.validateMnemonic(mnemonic);
+        const path = customPath || `${this.DEFAULT_DERIVATION_PATH}/${accountIndex}`;
+        const mnemonicObject = Mnemonic.fromPhrase(mnemonic);
+        const hdNode = HDNodeWallet.fromMnemonic(mnemonicObject, path);
+        return {
+            address: hdNode.address,
+            privateKey: hdNode.privateKey,
+            path,
+            publicKey: hdNode.publicKey,
+        };
+    }
+    importFromPrivateKey(privateKey) {
+        const wallet = new EthersWallet(privateKey);
+        return {
+            address: wallet.address,
+            privateKey: wallet.privateKey,
+            publicKey: wallet.signingKey.publicKey,
+        };
+    }
+    async signMessage(privateKey, message) {
+        const wallet = new EthersWallet(privateKey);
+        return await wallet.signMessage(message);
+    }
+    isValidMnemonic(mnemonic) {
+        try {
+            Mnemonic.fromPhrase(mnemonic);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    validateMnemonic(mnemonic) {
+        if (!this.isValidMnemonic(mnemonic)) {
+            throw new Error('Invalid mnemonic phrase');
+        }
+    }
+    getEntropyForWordCount(wordCount) {
+        const entropyMap = {
+            12: 16, // 128 bits
+            15: 20, // 160 bits
+            18: 24, // 192 bits
+            21: 28, // 224 bits
+            24: 32, // 256 bits
+        };
+        return entropyMap[wordCount];
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octaflowlabs/onchain-sdk",
-  "version": "1.0.0-test15",
+  "version": "1.0.0-test16",
   "description": "onchain methods for web3",
   "repository": "https://github.com/crisramb665/onchain-sdk.git",
   "license": "MIT",