A novel Ethereum wallet that is hosted on the Internet Computer, is browser-based, fully on-chain and secured by chain-key cryptography and Internet Identity.
The project is still work in progress, see the disclaimer below.
The Oisy Wallet is a technology demonstrator with the goal to develop a novel Ethereum wallet that is secure, simple to use, and makes as few assumptions about the user's operating environment as possible. It is secure because it relies on Threshold ECDSA and introduces the novel concept of networked-custody. It is simple to use because it uses Internet Identity to authenticate the user. It strives to reach the widest possible audience by being browser-based and unencumbered by licensing restriction from the various app stores. It is originally built by DFINITY and licensed under an open source license.
Oisy is designed to run natively on the Internet Computer, while at the same time holding native ETH and ERC-20 tokens and interacting with Ethereum smart contracts. Current features include sending and receiving ETH and a small list of ERC-20 tokens, receiving directly from Metamask and integration with Wallet Connect.
More concretely, Oisy goals are:
-
fully on-chain Internet Computer makes it possible to natively host any n-tiered dApp and gives users strong cryptographic guarantees that the content they load, static or dynamic, has not been tampered with. These guarantees are ideal for wallets, which require end-to-end security guarantees.
-
networked-custody When it comes to wallets, Ethereum users face the following choices, easy-to-use, custodial, browser-based wallets vis-a-vis cumbersome, non-custodial, app-based or browser-plugin-based wallets. Oisy uses Threshold ECDSA to offer networked-custody as a third choice, where you neither have to trust institutions with your private keys, nor are you encumbered by password-based access for personal safeguarding of your private keys. With networked-custody, your private key is split across network nodes offering you ease of use and security.
-
browser-based No matter your browser and operating system preference, you should be able to transact with the Ethereum network as simply as when you use a custodial wallet.
-
free to use and develop Oisy is open-source software and licensed under the INTERNET COMPUTER COMMUNITY SOURCE LICENSE
The project is not ready for production use.
We appreciate your patience until we get there. Until then, we are happy to answer questions if they are raised as issues in this github repo.
- Install the IC SDK.
Open a new terminal window in the project directory, and run the following command to start the local replica. The replica will not start unless dfx.json exists in the current directory.
dfx start --background
When you're done with development, or you're switching to a different dfx project, running
dfx stop
from the project directory will stop the local replica.
Make sure you switch back to the project root directory.
First, install the frontend dependencies by running
npm ci
To build and deploy the project locally, first create a .env.development file by copying the .env.example file. Once you've correctly set the api keys for all the different services that Oisy needs, then run:
npm run deploy
It should output something like the following
...
Deployed canisters.
URLs:
Frontend canister via browser
frontend: http://127.0.0.1:4943/?canisterId=br5f7-7uaaa-aaaaa-qaaca-cai
Backend canister via Candid interface:
backend: http://127.0.0.1:4943/?canisterId=bd3sg-teaaa-aaaaa-qaaba-cai&id=bkyz2-fmaaa-aaaaa-qaaaq-cai
internet_identity: http://127.0.0.1:4943/?canisterId=bd3sg-teaaa-aaaaa-qaaba-cai&id=be2us-64aaa-aaaaa-qaabq-cai
Click on the frontend URL to access the Oisy Wallet that is running locally.
See HACKING
The backend is written in Rust and you can find it under the backend folder. It uses the tECDSA API provided by IC. To find out more about tECDSA, you can read the Eurocrypt 2022 paper.
If you want to locally deploy the backend only, you use the following command
./scripts/deploy.backend.sh
The frontend is written entirely in Svelte. You can serve the frontend in development mode like you normally develop a svelte app using the command
npm run dev