bajetech/astrax

AstraX - Web extension wallet for the DigitalBits Blockchain network.

AstraX

This repo is constructed using yarn workspaces and consists of the following 3 sections:

• the browser extension (/extension)
• the client-facing SDK (/@bajetech/astrax-api)
• some shared files that the above use (/@shared/*)

Prerequisites

You will need

• Node (v14.11.0 or newer): https://nodejs.org/en/download/
• Yarn (v1.22.5 or newer): https://classic.yarnpkg.com/en/docs/install

Build the extension

To simply build a production version of the extension, install the prerequisites then navigate to this root folder in your command line and run these 2 steps:

yarn

followed by

yarn build:extension:production

This will generate the files that make up the extension in extension/build

Starting a dev environment

yarn
yarn start

This will start up multiple watching builds in parallel:

• The @bajetech/astrax-api npm module
• A dev server with the webapp running in the extension, serving on localhost:9000
• The actual built extension, able to be installed in Chrome, in build/

Each of these will build in response to editing their source.

These can be started individually with yarn start:\<workspace name\> where \<workspace name\> is one of:

• astrax-api
• extension

yarn build

This will produce final output for the @bajetech/astrax-api npm module, and the extension.

yarn build:\<workspace name\>, like the equivalent start commands, will build an individual workspace.

Useful URLs:

The popup webapp

The AstraX Documentation website

Importing a workspace

In some cases, you will want to import a workspace into another. For example, in extension we need to import @shared/constants. To do this, simply add @shared/constants to the dependencies list in package.json in extension. Yarn symlinks all the workspaces, so doing so will allow you to import files from the @shared/constants workspace as if it were a published npm package.

Dependencies

Many dev dependencies (such as Typescript, linters, Webpack, etc.) have been moved to the root package.json to allow devs to upgrade these libraries all in one place.

astrax's Issues

In the "account" drop-down menu user can see "stellar" address and "stellar" secret key

Steps to reproduce:

1. Log in to the extension as a valid user.
2. Click on the "account" tab
3. Observe the drop-down menu

Expected result: User should see
"Create a new DigitalBits address"
and
"Import a DigtalBits secret key"

Actual result: User sees
"Create a new Stellar address"
and
"Import a Stellar secret key"

Refactor wallet docs website for AstraX

The docs folder within the repo currently has the documentation for Freighter. We need to refactor this entire folder to update all Stellar/Freighter references to AstraX. Specifically the following needs to be done:

• Rename all @stellar/freighter-api references to @bajetech/astrax-api
• Rename Freighter to AstraX
• In package.json, change @stellar/freighter-api dependency to @bajetech/astrax-api
• In the file https://github.com/BajeTech/AstraX/blob/main/docs/docs/guide/gettingStarted.md, change <script src="https://cdnjs.cloudflare.com/ajax/libs/stellar-freighter-api/{version}/index.min.js"></script> to <script src="https://cdnjs.cloudflare.com/ajax/libs/bajetech-astrax-api/{version}/index.min.js"></script>
• Rename all freighterApi references to astraxApi, and window.freighterApi to window.astraxApi
• Change https://horizon-testnet.stellar.org to https://frontier.testnet.digitalbits.io
• Logo png and svg has to be updated (located within static/images sub-folder)

To make your changes, create a branch off of xdb-refactor, make your changes in your branch and then make a PR back into xdb-refactor.

"Help" link in the main menu leads to "Freighter" FAQ page.

Steps to reproduce:

1. Log in to the extension as a valid user
2. Navigate to main menu
3. Click on the "help" link

Actual result: "Help" link in the main menu leads to "Freighter" FAQ page.

Expected result: "Help" link in the main menu should lead to "AstraX" FAQ page.