Repository files navigation

OISY is a new browser-based, network-custodial and multi-chain wallet powered by Internet Computer'schain fusion technology.

The OISY wallet provides a convenient user experience known from custodial wallets but without their strong trust assumptions. In contrast, OISY provides trust assumptions based on network custody, and comparable to self-custody. Different from self-custody wallets though, OISY requires no browser extensions or additional mobile app, a standard off-the-shelf web browser is sufficient. In conclusion, OISY provides an attractive user experience with a low entry barrier, yet requires no strong trust assumptions.

Building on ICP, OISY achieves a unique set of features:

• Browser-based: no matter your browser and operating system preferences, OISY allows you to receive, hold, and send native ICP, ICRC-1, ETH, ERC20 (and in the near future BTC).

• Cross-device: due to the use of Internet Identity, OISY can easily be used across all devices you have linked to your Internet Identity.

• Network custody: the key controlling your multi-chain assets is not controlled by a single entity nor has it ever existed as such. The key was generated using advanced cryptography that distributed key-shares among dedicated ICP replica nodes and signatures are created usingthreshold ECDSA.

• Fully on-chain: not only the keys but the entire wallet application is stored on-chain and served directly to your browser. The entire wallet is secured by a decentralized trust model, which guarantees that neither the front-end, nor the back-end have been tampered with.

• Interoperable: OISY integrates with theWalletConnect protocol allowing you to use it as a wallet for many established web3 services, such as Uniswap. The OISY team is actively working on integrating OISY withICP's signer standards allowing OISY to interact withICP's rich dapp ecosystem.

• Free to use and develop: OISY is open-source software and licensed underApache 2.0. Feel free to fork it or propose improvements.

What are the unique ICP technical building blocks enabling the creation of OISY?

• Chain-key signatures: the world's best threshold ECDSA signatureprotocol suite (only available on ICP) enables smart contracts to perform cryptographic signatures without a single entity having full access to the private key. Read more aboutchain-key cryptography or start building based onchain-key signature sample code.

• Internet Identity (II): based on ICP's threshold BLS signature schemes and WebAuthn, Internet Identity (II) is an authentication and key management system with strong privacy and security guarantees. UsingWebAuthn, users can conveniently create secure sessions with their fingerprint or other biometric identifiers. Read more aboutInternet Identity technology orstart integrating II into your canister smart contract.

• Web applications served from chain: ICP is not only designed to runbackends, such as ledgers, on chain, its low storage cost and low latency allow it to servefrontends, such as HTML files and images, from chain, too. Read more aboutsmart contracts serving web applications or directly startbuilding your first decentralized web frontend.

• (Upcoming)HTTP outcalls: for now, OISY calls centralized Ethereum endpoints, such as Infura or Alchemy, from the frontend. In the future, OISY might be improved to useHTTP outcalls to call these endpoints in a decentralized fashion. Check out theHTTP outcalls sample code to explore how to use Web 2.0 services on ICP.

To file a request to have your dApp listed in the dApps explorer of OISY Wallet, please submit thisdApp Submission Request.

The platform, its software and all content found on it are provided on an “as is” and “as available” basis.OISY Wallet does not give any warranties, whether express or implied, as to the suitability or usability of the application, its software or any of its content.

• Install theIC SDK.

Open a new terminal windowin the project directory, and run the following command to start the local replica. The replica will not start unlessdfx.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 thefrontend URL to access the OISY Wallet that is running locally.

SeeHACKING

The backend is written in Rust and you can find it under thebackend folder. It uses thetECDSA API provided by IC. To find out more about tECDSA, you can read theEurocrypt 2022 paper.

If you want to locally deploy the backend only, you use the following command

dfx deploy backend

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

Some Iconly icons are used in the project,not included. You must obtain a license separately.
The license for this project is bought and owned by the DFINITY Foundation, please see terms and conditionshere.