⚡ Z3US ⚡

This Turborepo monorepo is home to the Z3US browser extension wallet for the Radix DLT network.

Note

• Z3US wallet is in beta and in active development.
• Z3US wallet extension code is unaudited, no audit is planned at this stage.

Extension quick start

Make sure you have **Node V15.5.0 ** installed

nvm install 15
nvm use 15

Clone repo

git clone [email protected]:z3us-dapps/z3us.git

Go to z3us directory run

yarn install --ignore-engines

Now build the extension using

yarn build

You will see a dist folder generated inside apps/extension

Adding extension to Chrome

In Chrome browser, go to chrome://extensions page and switch on developer mode. This enables the ability to locally install a Chrome extension.

Now click on the LOAD UNPACKED and browse to apps/extension/dist/chrome, this will install the Z3US wallet chrome extension.

Adding extension to Firefox

Before adding to firefox some changes to manifest file must be made:

1. Remove all use_dynamic_url keys from all entries in web_accessible_resources

  "web_accessible_resources": [
    {
      "matches": [
        "https://*/*"
      ],
      "resources": [
        "popup-theme-dark.html",
        "popup-theme-light.html",
        "popup-theme-system.html",
        "assets/*"
      ],
-      "use_dynamic_url": false
    },
    {
      "matches": [
        "*://*.z3us.com/*"
      ],
      "resources": [
        "assets/browser-polyfill.js",
        "assets/messanger.js",
        "assets/inpage.js",
        "assets/events.js",
        "assets/content-script.ts.js"
      ],
-      "use_dynamic_url": true
    }
  ]

2. Change service_worker to scripts and wrap value in array paranthesis []

  "background": {
-    "service_worker": "service-worker-loader.js",
+    "scripts": ["service-worker-loader.js"],
    "type": "module"
  },

• Create archive by compresing all the files inside the directory apps/extension/dist.
• In the Firefox browser navigate to about:debugging#/runtime/this-firefox.
• Click the button Load temporary Add-on..., then select an archive file you prepared.

Website quick start

Go to z3us/apps/website directory run

yarn dev

Now visit the website running locally at localhost:4000

Apps

• website: Z3US Next.js website - localhost:4000
• extension: Z3US wallet browser extension - Vite and React - localhost:8003

Packages

• ui: a shared React component library using stitches and radix ui
  • yarn storybook: storybook - localhost:6006
• config: eslint configurations (includes eslint-config-next and eslint-config-prettier)
• tsconfig: tsconfig.json used throughout the monorepo

Build

To build all apps and packages, run the following command:

yarn build

📜 License

Copyright (c) Z3US.