Tonkeeper Web Monorepo

Tonkeeper Web is a non-custodial crypto wallet and gateway to blockchain dApps.

Tonkeeper Extension supports Firefox 109.0 or higher version, Google Chrome, and Chromium-based browsers. We recommend using the latest available browser version.

Building locally

# Install `Node.js` version v20.7.0
nvm use

# Install `Yarn` version 4.0.2
corepack enable

Build web script

# Install dependencies
yarn

# Build web app
yarn build:web

Compressed build could be found in /apps/web/dist once they're built.

Build extension script

# Install dependencies
yarn

# Build extension apps
yarn build:extension

Compressed builds could be found in /apps/extension/dist/chrome and /apps/extension/dist/firefox once they're built.

Build desktop script

# Install dependencies
yarn

# Build desktop for current OS
yarn build:desktop

Application for your platform could be found in /apps/desktop/out once they're built.

Mac Environment variables:

You can generate an App Store Connect API key to authenticate notarytool by going to the App Store Connect access page and using the "Keys" tab. This API key will look something like AuthKey_ABCD123456.p8 and can only be downloaded once.

Env variable	Description
APPLE_API_KEY	Filesystem path string to your API key file.
APPLE_API_KEY_ID	10-character alphanumeric ID string. In the previous AuthKey_ABCD123456.p8 example, this would be ABCD123456.
APPLE_API_ISSUER	UUID that identifies the API key issuer. You will find this ID in the "Keys" tab where you generated your API key.

Keychain - Certificate Type - Developer ID Application

Regenerating API clients

packages/core ships auto-generated TypeScript clients for several Tonkeeper backends. Some of the swagger specs live in private GitHub repositories, so regeneration requires a GitHub Personal Access Token (never commit it):

1. Create a fine-grained PAT at github.com/settings/personal-access-tokens with Contents: Read access to the backend repo(s) you need:

   • tonkeeper/tonendpoint_backend — generate:tonkeeperApi
   • tonkeeper/tonkeeper_2fa_backend — generate:2faApi
   • tonkeeper/custodial-battery — generate:batteryApi
   • tonkeeper/pro_backend — generate:pro
   • tonkeeper/tonconsole_backend — generate:tonConsoleApi
   • (generate:sdkV2 targets a public repo and needs no token.)

2. Export the token in your shell:

   export GITHUB_TOKEN=<your-token>
   

3. Run the generator from the repo root:

   yarn workspace @tonkeeper/core generate:tonkeeperApi
   

The yarn scripts fail fast with a helpful message if GITHUB_TOKEN is unset.

License

(c) Copyright 2025 Ton APPS UK Limited Released under the Apache License, Version 2.0.