LogoLogo
  • 👋Introduction
    • Introduction
    • Why OISY Wallet
    • Internet Identity
  • 🔵Using Oisy Wallet
    • How To's
      • Creating a Wallet
      • Create an Internet Identity
      • Find Your Internet Identity
      • Logging Into OISY
      • Sending Tokens
      • Receiving Tokens
      • Swapping Tokens
      • Saving OISY Web App to Your Device
      • Connecting to dApps
      • Filter & Manage Network
      • Buying Tokens
      • Finding Tokens in Your Wallet
      • Finding & Using dApps
      • Migrating Wallets
      • Generate Referral Link
      • Send a Token Using a dApp
      • Managing & Adding Tokens
      • Raise a Support Ticket
      • Submit Feedback
      • Join the Tester Program
    • FAQ
    • Support
  • Integrate With OISY
    • Listing new dapps in Explorer
    • Listing a Token on OISY
  • Media
    • Logos & Assets
    • Media Kit
    • Press Releases
      • Feb 27, 2025 (OISY v1 Live)
  • For Developers
    • ICP Building Blocks
      • Build and Run Yourself
    • How to "Connect with OISY"
    • GitHub Repo
  • Rewards
    • OISY Sprinkles
      • T&C's
    • OISY Sprinkles – Episodes 1 & 2 (Archived)
      • T&C's
  • Security
    • Best Practices
    • Asset Control, Recovery, and Governance in OISY Wallet
    • Security best practices
Powered by GitBook
On this page
  • Prerequisites
  • Start the local replica
  • Run OISY locally
  • Local development
  • Backend
  • Frontend
  • Dependencies
Export as PDF
  1. For Developers
  2. ICP Building Blocks

Build and Run Yourself

PreviousICP Building BlocksNextHow to "Connect with OISY"

Last updated 4 months ago

Prerequisites

Start the local replica

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 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.

Run OISY locally

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 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.

Local development

Backend

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

dfx deploy backend

Frontend

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

Dependencies

Some Iconly icons are used in the project, not included. You must obtain a license separately.

See

The backend is written in Rust and you can find it under the . It uses the provided by IC. To find out more about tECDSA, you can read the .

The license for this project is bought and owned by the DFINITY Foundation, please see terms and conditions .

IC SDK
dfx.json
.env.example
HACKING
backend folder
tECDSA API
Eurocrypt 2022 paper
Iconly Pro
here