Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mybucks-online/app
Password-only, self-custodial cryptocurrency wallet. Open your account with your safe password only!
https://github.com/mybucks-online/app
blockchain cryptowallet dapp erc20 ethereum keccak256 password-hashing privatekey-generator react scrypt styled-components web3
Last synced: about 1 month ago
JSON representation
Password-only, self-custodial cryptocurrency wallet. Open your account with your safe password only!
- Host: GitHub
- URL: https://github.com/mybucks-online/app
- Owner: mybucks-online
- License: other
- Created: 2024-08-27T16:50:43.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-09-27T07:51:41.000Z (about 2 months ago)
- Last Synced: 2024-09-28T07:06:51.087Z (about 2 months ago)
- Topics: blockchain, cryptowallet, dapp, erc20, ethereum, keccak256, password-hashing, privatekey-generator, react, scrypt, styled-components, web3
- Language: JavaScript
- Homepage: https://app.mybucks.online
- Size: 2.24 MB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mybucks.online
## Summary
Mybucks.online is a **password-only, self-custodial cryptocurrency wallet** built with [React.js](https://react.dev). It generates a private key from your password 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.
## How to Use
1. Visit `app.mybucks.online`.
2. Input your password, confirmation, and passcode.
3. Click `Open`.
(This process is the same for both initial opening and all subsequent uses.)
## Key Points
### Privacy Protection
- **No Registration Required:** No need for personal information, not even your email address.
- **Absolute Privacy:** Nobody knows who you are; nobody stores your password.
- **Transient Data:** Your account is generated whenever you open it. Closing or refreshing your browser erases all traces/history.
- **Share your wallet address:** its origin remains unknown.
### Security
- **One-Way Hash Function:** Utilizes [**scrypt**](https://en.wikipedia.org/wiki/Scrypt) and [**keccak256**](https://en.wikipedia.org/wiki/SHA-3). Your password determines a unique private key.
- **Resistance to Attacks:** Brute force attacks would take centuries. A strong password ensures asset protection.
### Ease of Use
- **Simple Access:** Only requires a password, no 12-word seed phrases.
- **No KYC Hassles:** No worries about KYC or suspensions.
- **Private Key Portability:** Backup your password/private key. Import into Metamask to use across DeFi products.
### Analogy
Think of it like a public locker at a railway station:
1. Find an empty box.
2. Set up your password anonymously.
3. Place your goods inside and lock.
Return later to access your goods with just your password—no ID checks required.
That's all! 🎉
## Generate the private key
This demonstrates how to generate a private key from your `password` and `passcode` and helps you understand the process.
```javascript
import { Buffer } from "buffer";
import { ethers } from "ethers";
import { scrypt } from "scrypt-js";
const HASH_OPTIONS = {
N: 32768, // CPU/memory cost parameter, 2^15
r: 8, // block size parameter
p: 5, // parallelization parameter
keyLen: 64,
};
// password: at least 12 characters user input, lowercase, uppercase, digits, and special characters
// passcode: at least 6 characters
async function generatePrivateKey(password, passcode) {
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,
(p) => console.log(Math.floor(p * 100))
);
const hashHex = Buffer.from(hashBuffer).toString("hex");
const privateKey = ethers.keccak256(abi.encode(["string"], [hashHex]));
return privateKey;
}
```
## Transfer Ownership
You can transfer all your holdings to family or friends in a few seconds by sharing your password only.
```
mybucks.online / mYpAssword987^5 : 239a8b
```
Send this short note to your friend in a private channel.
# About the Project
This is a fully open-source project built with React, Vite, and related third-party libraries such as:
- **scrypt-js**
Implements the `scrypt` hash function. Please check the npm registry [here](https://www.npmjs.com/package/scrypt-js).
- **ethers**
A standard library for manipulating EVM accounts.
- **@covalenthq/client-sdk**
Provides query functions for massive crypto assets in multiple networks.
- **@sushiswap/default-token-list**
- **styled-components**
## How to Run
Please sign up for [Infura](https://infura.io) and [GoldRush](https://goldrush.dev/), create free API keys, and update the environment variables accordingly.
```bash
yarn install
cp .env.example .env
# Update the .env variables with valid keys
yarn dev
```
## Production Environment
The project uses `Github Pages` and `Github Actions` for deployment and is connected to a custom domain.
You can easily verify releases, deployments, and domain configuration:
- [Actions](https://github.com/koko37/mybucks.online-app/actions)
- [Releases](https://github.com/koko37/mybucks.online-app/releases)
- [.github/workflows/main-pipeline.yml](https://github.com/koko37/mybucks.online-app/blob/master/.github/workflows/main-pipeline.yml)
To check DNS settings:
```bash
nslookup
> app.mybucks.online
Server: 127.0.0.53
Address: 127.0.0.53#53
Non-authoritative answer:
app.mybucks.online canonical name = mybucks-online.github.io.
Name: mybucks-online.github.io
~~~
```
```bash
dig app.mybucks.online
;; ANSWER SECTION:
app.mybucks.online. 5 IN CNAME https://mybucks-online.github.io.
https://mybucks-online.github.io. 5 IN A 185.199.110.153
https://mybucks-online.github.io. 5 IN A 185.199.109.153
https://mybucks-online.github.io. 5 IN A 185.199.108.153
https://mybucks-online.github.io. 5 IN A 185.199.111.153
~~~
```