@mybucks.online/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mybucks.online
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @mybucks.online/core
+
+This is a core part of mybucks.online crypto wallet, involving hashing and private key generation.
+
+## mybucks.online
+
+Mybucks.online is a **password-only, self-custodial and browser-based cryptocurrency wallet** built with Javascript. It generates a private key from your password and passcode using an industry-standard, verified **one-way hash function**. Your private key forms your account, allowing you to transfer, receive, and hold your crypto assets permanently.
+
+## Quick start
+
+### 1. Install
+
+```bash
+npm install @mybucks.online/core
+```
+
+### 2. Generate hash and private-key
+
+```javascript
+import { getEvmPrivateKey, generateHash } from "@mybucks.online/core";
+
+const showProgress = (p) => {
+  console.log(`progress: ${p * 100}%`);
+};
+
+const hash = await generateHash(password, passcode, showProgress);
+const privateKey = getEvmPrivateKey(hash);
+
+console.log("Private key: ", privateKey);
+```
+
+## Docs
+
+Find the docs [here](https://docs.mybucks.online).
+
+## Live example
+
+- https://github.com/mybucks.online/app
+- https://app.mybucks.online

package/index.js

@@ -0,0 +1,62 @@
+const { Buffer } = require("buffer");
+const { ethers } = require("ethers");
+const { scrypt } = require("scrypt-js");
+
+const abi = new ethers.AbiCoder();
+
+/**
+ * [CRITICAL] DON'T CHANGE FOREVER!!!
+ * Reference:
+ *    https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html#scrypt
+ */
+const HASH_OPTIONS = {
+  N: 32768, // CPU/memory cost parameter, 2^15
+  r: 8, // block size parameter
+  p: 5, // parallelization parameter
+  keyLen: 64,
+};
+
+/**
+ * This function computes the scrypt hash using provided password and passcode inputs.
+ *
+ * @param {*} password
+ * @param {*} passcode
+ * @param {*} cb a callback function designed to receive the progress updates during the scrypt hashing process.
+ * @returns hash result as string format
+ */
+async function generateHash(password, passcode, cb = () => {}) {
+  if (!password || !passcode) {
+    return "";
+  }
+
+  const salt = `${password.slice(-4)}${passcode}`;
+
+  const passwordBuffer = Buffer.from(password);
+  const saltBuffer = Buffer.from(salt);
+
+  const hashBuffer = await scrypt(
+    passwordBuffer,
+    saltBuffer,
+    HASH_OPTIONS.N,
+    HASH_OPTIONS.r,
+    HASH_OPTIONS.p,
+    HASH_OPTIONS.keyLen,
+    cb
+  );
+
+  return Buffer.from(hashBuffer).toString("hex");
+}
+
+/**
+ * This function derives the EVM private key from the result of the scrypt hash.
+ * @param {*} hash
+ * @returns private key as string format
+ */
+function getEvmPrivateKey(hash) {
+  return ethers.keccak256(abi.encode(["string"], [hash]));
+}
+
+module.exports = {
+  generateHash,
+  getEvmPrivateKey,
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@mybucks.online/core",
+  "version": "1.0.0",
+  "description": "Core module for mybucks.online crypto wallet",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mybucks-online/core.git"
+  },
+  "keywords": [
+    "wallet",
+    "crypto",
+    "password-only",
+    "multi-chain",
+    "self-custodial",
+    "browser-based",
+    "ethereum",
+    "tron",
+    "open-source"
+  ],
+  "author": "koko37",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/mybucks-online/core/issues"
+  },
+  "homepage": "https://github.com/mybucks-online/core#readme",
+  "dependencies": {
+    "buffer": "^6.0.3",
+    "ethers": "^6.13.5",
+    "scrypt-js": "^3.0.1"
+  }
+}