@exodus/headless 5.0.0-rc.33 → 5.0.0-rc.35

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [5.0.0-rc.35](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/headless@5.0.0-rc.34...@exodus/headless@5.0.0-rc.35) (2024-09-23)
+
+### Features
+
+- add ability to ignore all sunset asset monitors ([#8875](https://github.com/ExodusMovement/exodus-hydra/issues/8875)) ([e7fafa4](https://github.com/ExodusMovement/exodus-hydra/commit/e7fafa437a17edd1aca2f430ce8cecfcd6088a72))
+- allow supplying the wallet sdk as adapter to headless ([#9317](https://github.com/ExodusMovement/exodus-hydra/issues/9317)) ([de4dcca](https://github.com/ExodusMovement/exodus-hydra/commit/de4dccabd0126e28e5de08c946e60056eb9d149a))
+- type dependency injection container ([#9398](https://github.com/ExodusMovement/exodus-hydra/issues/9398)) ([e347bfa](https://github.com/ExodusMovement/exodus-hydra/commit/e347bfaf210751fcfb62600f276402eb7fdce46d))
+
+### Bug Fixes
+
+- **headless:** bump @exodus/application ([#9230](https://github.com/ExodusMovement/exodus-hydra/issues/9230)) ([819597b](https://github.com/ExodusMovement/exodus-hydra/commit/819597b2042c5677651bf81f16d04b806bcfadec))
+
+## [5.0.0-rc.34](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/headless@5.0.0-rc.32...@exodus/headless@5.0.0-rc.34) (2024-09-09)
+
+### Features
+
+- **headless:** move headless-ui plugin alongside others ([#8971](https://github.com/ExodusMovement/exodus-hydra/issues/8971)) ([4a5c72c](https://github.com/ExodusMovement/exodus-hydra/commit/4a5c72cd2271e835080e84be14d3a49364e43f3a))
+- **headless:** clear headless-ui storage ([#8964](https://github.com/ExodusMovement/exodus-hydra/issues/8964)) ([5840128](https://github.com/ExodusMovement/exodus-hydra/commit/5840128c8d626278db51c4d06da33315603f3dc0))
+- implement headless redux IOC ([#8857](https://github.com/ExodusMovement/exodus-hydra/issues/8857)) ([8520a07](https://github.com/ExodusMovement/exodus-hydra/commit/8520a07ba7d83db12051ad713fafbe00ad14ee13))
+
 ## [5.0.0-rc.33](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/headless@5.0.0-rc.32...@exodus/headless@5.0.0-rc.33) (2024-09-09)
 
 ### Features

package/README.md

@@ -62,57 +62,7 @@ The headless wallet instance transitions through different states during his lif
 - Fires hook call: Allows modules to subscribe and halt transition until listener resolves.
 - Fires event call: Emitted after all hooks had been executed and resolved.
 
-Below you can find a state diagram that visualize what hooks are triggered between state transitions:
-
-```mermaid
-stateDiagram-v2
-    direction LR
-    [*] --> Starting
-
-    state Starting {
-        direction LR
-
-        state "Needs clear storage?*" as NeedsClear
-        state "Is importing?" as IsImporting
-
-        NeedsClear --> Clearing : CLEAR
-        Clearing --> IsImporting
-        IsImporting --> Importing : IMPORT
-    }
-
-    Starting --> Started : START
-
-    state Started {
-        direction LR
-
-        state "Has seed?" as HasSeed
-
-        HasSeed --> Empty : No
-        HasSeed --> Locked : Yes
-
-        Empty --> Locked : CREATE \n---or---\nIMPORT
-
-        Locked --> Migrating : MIGRATE
-        Migrating --> Unlocked : UNLOCK
-        Unlocked --> Locked : LOCK
-
-        Unlocked --> Restarting : DELETE
-
-
-    }
-
-    Restarting --> [*] : RESTART
-
-    Started --> Started : LOAD
-
-    classDef conditional fill:#ededed,stroke:#c2c2c2,color:#a6a6a6,stroke-width:2;
-
-    class NeedsClear conditional
-    class IsImporting conditional
-    class HasSeed conditional
-```
-
-\* Wallet needs to clear storage if seed is not present or is restoring a new wallet
+For more information about lifecycle hooks, please refer to the [application feature documentation](../../features/application/README.md#lifecycle-hooks).
 
 ## Port
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/headless",
-  "version": "5.0.0-rc.33",
+  "version": "5.0.0-rc.35",
   "description": "The platform-agnostic Exodus wallet SDK",
   "author": "Exodus Movement, Inc.",
   "main": "src/index.js",
@@ -24,13 +24,15 @@
   "scripts": {
     "lint": "run -T eslint .",
     "lint:fix": "yarn lint --fix",
-    "test": "yarn test:types && NODE_OPTIONS=--max-old-space-size=4096 run -T jest",
+    "test": "yarn test:types && yarn test:single-process && yarn test:multi-process",
+    "test:single-process": "NODE_OPTIONS=--max-old-space-size=4096 run -T jest",
+    "test:multi-process": "MULTI_PROCESS=1 NODE_OPTIONS=--max-old-space-size=4096 run -T jest",
     "test:types": "run -T tsc --noEmit"
   },
   "dependencies": {
     "@exodus/address-provider": "^12.0.1",
-    "@exodus/application": "^1.5.0",
-    "@exodus/argo": "^2.1.0",
+    "@exodus/application": "^2.1.0",
+    "@exodus/argo": "^2.2.0",
     "@exodus/asset-sources": "^1.4.1",
     "@exodus/assets-feature": "^5.11.3",
     "@exodus/atoms": "^8.1.1",
@@ -38,6 +40,7 @@
     "@exodus/balances": "^13.3.1",
     "@exodus/basic-utils": "^3.0.1",
     "@exodus/blockchain-metadata": "^15.3.5",
+    "@exodus/browser-extension-rpc": "^2.1.2",
     "@exodus/dependency-injection": "^2.1.2",
     "@exodus/dependency-preprocessors": "^6.0.5",
     "@exodus/enabled-assets": "^10.5.1",
@@ -51,13 +54,12 @@
     "@exodus/hd-key-slip-10": "^2.0.0",
     "@exodus/key-ids": "^1.2.3",
     "@exodus/key-viewer": "^1.1.2",
-    "@exodus/keychain": "^6.10.0",
+    "@exodus/keychain": "^7.1.0",
     "@exodus/locale": "^2.2.2",
     "@exodus/message-signer": "^1.3.4",
     "@exodus/module": "^1.2.2",
     "@exodus/pricing": "^1.3.2",
     "@exodus/public-key-provider": "^2.4.1",
-    "@exodus/public-key-store": "^1.2.2",
     "@exodus/rates-monitor": "^4.4.1",
     "@exodus/remote-config": "^2.7.2",
     "@exodus/restore-progress-tracker": "^3.5.1",
@@ -78,7 +80,7 @@
     "@exodus/ab-testing": "^7.6.1",
     "@exodus/algorand-lib": "^2.0.1",
     "@exodus/algorand-meta": "^1.1.4",
-    "@exodus/analytics": "^14.4.1",
+    "@exodus/analytics": "^14.4.2",
     "@exodus/announcements": "^3.0.0",
     "@exodus/apy-rates": "^3.5.0",
     "@exodus/assets-feature": "workspace:^",
@@ -86,8 +88,9 @@
     "@exodus/bitcoin-plugin": "^1.0.14",
     "@exodus/connected-origins": "^3.4.0",
     "@exodus/crypto-news-monitor": "^5.0.2",
-    "@exodus/currency": "^5.0.2",
+    "@exodus/currency": "^6.0.0",
     "@exodus/deferring-storage": "^1.0.1",
+    "@exodus/domain-serialization": "^1.3.1",
     "@exodus/ethereum-lib": "^5.0.0",
     "@exodus/ethereum-meta": "^1.1.0",
     "@exodus/exodus-pricing-client": "^1.3.1",
@@ -98,7 +101,7 @@
     "@exodus/litecoin-meta": "^1.0.0",
     "@exodus/market-history": "^9.0.5",
     "@exodus/models": "^12.0.1",
-    "@exodus/nfts": "^9.3.6",
+    "@exodus/nfts": "^9.3.7",
     "@exodus/personal-notes": "^3.6.3",
     "@exodus/referrals": "^8.8.0",
     "@exodus/solana-lib": "^2.0.0",
@@ -106,7 +109,8 @@
     "@exodus/storage-encrypted": "^1.4.1",
     "@exodus/storage-memory": "^2.2.0",
     "@exodus/top-movers-monitor": "^4.2.3",
-    "@exodus/ui-config": "^3.10.1",
+    "@exodus/ui-config": "^3.11.0",
+    "@exodus/wallet-sdk": "^1.0.0",
     "@exodus/wild-emitter": "^1.0.0",
     "buffer-json": "^2.0.0",
     "deepmerge": "^4.2.2",
@@ -116,5 +120,5 @@
     "msw": "^2.0.0",
     "p-defer": "^4.0.0"
   },
-  "gitHead": "d64de7579b06afe91fbded3d1f7eb29950f82e5a"
+  "gitHead": "1ff5cf831e8154730887aaaa3ac3bf0e3020a386"
 }

package/src/api/index.js

@@ -36,8 +36,7 @@ const createApi = ({ ioc, port, config, debug, logger }) => {
     }
   }
 
-  featureApis.wallet = {
-    ...featureApis.wallet,
+  const applicationWalletApi = {
     addSeed: application.addSeed,
     start: deprecated(application.start),
     stop: deprecated(application.stop),
@@ -56,6 +55,17 @@ const createApi = ({ ioc, port, config, debug, logger }) => {
     restoreFromCurrentPhrase: deprecated(application.restoreFromCurrentPhrase),
   }
 
+  // featureApis.wallet is a proxy when the wallet sdk is used from a separate process, do not spread!
+  featureApis.wallet = new Proxy(featureApis.wallet, {
+    get(target, prop) {
+      if (prop in applicationWalletApi) {
+        return applicationWalletApi[prop]
+      }
+
+      return target[prop]
+    },
+  })
+
   const debugApi = createDebug({ ioc, port, debug })
   const reportingApi = createReporting({ ioc, config })
 

package/src/atoms/base-asset-names-to-monitor.js

@@ -13,10 +13,15 @@ const createBaseAssetNamesToMonitorAtom = ({
   enabledAssetsAtom,
   restoreAtom,
   availableAssetNamesAtom,
+  config: { ignoreAssetNames = [] } = Object.create(null),
 }) => {
+  const ignoreAssetNamesSet = new Set(ignoreAssetNames)
+
   const selector = ({ isRestore, enabledAssets, availableAssetNames }) => {
     const assetNames = isRestore ? availableAssetNames : Object.keys(enabledAssets)
-    return getNetworks(assetNames, assetsModule.getAssets())
+    return getNetworks(assetNames, assetsModule.getAssets()).filter(
+      (assetName) => !ignoreAssetNamesSet.has(assetName)
+    )
   }
 
   return dedupe(
@@ -36,6 +41,12 @@ export default {
   id: 'baseAssetNamesToMonitorAtom',
   type: 'atom',
   factory: createBaseAssetNamesToMonitorAtom,
-  dependencies: ['assetsModule', 'availableAssetNamesAtom', 'enabledAssetsAtom', 'restoreAtom'],
+  dependencies: [
+    'assetsModule',
+    'availableAssetNamesAtom',
+    'enabledAssetsAtom',
+    'restoreAtom',
+    'config?',
+  ],
   public: true,
 }

package/src/dependencies/atoms.js

@@ -1,5 +1,10 @@
 import baseAssetNamesToMonitorAtomDefinition from '../atoms/base-asset-names-to-monitor'
 
-const createAtomDependencies = () => [{ definition: baseAssetNamesToMonitorAtomDefinition }]
+const createAtomDependencies = ({ config }) => [
+  {
+    definition: baseAssetNamesToMonitorAtomDefinition,
+    config: { ignoreAssetNames: config.ignoreAssetNamesToMonitor },
+  },
+]
 
 export default createAtomDependencies

package/src/dependencies/index.js

@@ -10,14 +10,7 @@ import createModuleDependencies from './modules'
 import createPluginDependencies from './plugins'
 import { wrapConstant } from './utils'
 
-const adapterKeys = [
-  'createLogger',
-  'legacyPrivToPub',
-  'seedStorage',
-  'unsafeStorage',
-  'fetch',
-  'freeze',
-]
+const adapterKeys = ['createLogger', 'legacyPrivToPub', 'unsafeStorage', 'fetch', 'freeze']
 
 const createDependencies = ({ adapters, config }) => {
   assert(config, 'expected config object')

package/src/dependencies/plugins.js

@@ -1,8 +1,10 @@
 import headlessAnalyticsPluginDefinition from '../plugins/analytics'
+import headlessUiLifecyclePluginDefinition from '../plugins/headless-ui'
 import logLifecyclePluginDefinition from '../plugins/log-lifecycle'
 
 const createPluginDependencies = () => [
   { definition: logLifecyclePluginDefinition },
+  { definition: headlessUiLifecyclePluginDefinition },
   {
     if: { registered: ['analytics'] },
     definition: headlessAnalyticsPluginDefinition,

package/src/features/keychain-rpc/index.js

@@ -0,0 +1,5 @@
+import { createRpcFeature } from '../../utils/ioc'
+
+const keychainRpc = (api) => createRpcFeature('keychain', api)
+
+export default keychainRpc

package/src/features/wallet-rpc/index.js

@@ -0,0 +1,55 @@
+import { createInMemoryAtom } from '@exodus/atoms'
+
+const walletRpc = (api) => {
+  const id = 'wallet'
+
+  const createSeedIngestingProxy = (primarySeedIdAtom) =>
+    new Proxy(api, {
+      get(target, prop) {
+        if (prop === 'unlock') {
+          return async (...args) => {
+            const { primarySeedId } = await target[prop](...args)
+            await primarySeedIdAtom.set(primarySeedId)
+            return primarySeedId
+          }
+        }
+
+        return target[prop]
+      },
+    })
+
+  return {
+    id,
+    definitions: [
+      {
+        definition: {
+          id: 'primarySeedIdAtom',
+          type: 'atom',
+          factory: () => createInMemoryAtom(), // eslint-disable-line @exodus/hydra/in-memory-atom-default-value
+          public: true,
+        },
+      },
+      {
+        definition: {
+          id,
+          type: 'module',
+          public: true,
+          factory: ({ primarySeedIdAtom }) => createSeedIngestingProxy(primarySeedIdAtom),
+          dependencies: ['primarySeedIdAtom'],
+        },
+      },
+      {
+        definition: {
+          id: `${id}Api`,
+          type: 'api',
+          factory: ({ primarySeedIdAtom }) => ({
+            [id]: createSeedIngestingProxy(primarySeedIdAtom),
+          }),
+          dependencies: ['primarySeedIdAtom'],
+        },
+      },
+    ],
+  }
+}
+
+export default walletRpc

package/src/index.d.ts

@@ -1,23 +1,23 @@
-import addressProvider from '@exodus/address-provider'
-import { type Node, Argo, Definition, Feature, InstanceById } from '@exodus/argo'
-import assetSources from '@exodus/asset-sources'
-import assets from '@exodus/assets-feature'
-import availableAssets from '@exodus/available-assets'
-import blockchainMetadata from '@exodus/blockchain-metadata'
-import enabledAssets from '@exodus/enabled-assets'
-import featureFlags from '@exodus/feature-flags'
-import fees from '@exodus/fee-data-monitors'
-import keyViewer from '@exodus/key-viewer'
-import keychain from '@exodus/keychain'
-import locale from '@exodus/locale'
-import messageSigner from '@exodus/message-signer'
-import pricing from '@exodus/pricing'
-import publicKeyProvider from '@exodus/public-key-provider'
-import rates from '@exodus/rates-monitor'
-import remoteConfig from '@exodus/remote-config'
-import txSigner from '@exodus/tx-signer'
-import wallet from '@exodus/wallet'
-import walletAccounts from '@exodus/wallet-accounts'
+import type addressProvider from '@exodus/address-provider'
+import type { type Node, Argo, Definition, Feature, InstanceById } from '@exodus/argo'
+import type assetSources from '@exodus/asset-sources'
+import type assets from '@exodus/assets-feature'
+import type availableAssets from '@exodus/available-assets'
+import type blockchainMetadata from '@exodus/blockchain-metadata'
+import type enabledAssets from '@exodus/enabled-assets'
+import type featureFlags from '@exodus/feature-flags'
+import type fees from '@exodus/fee-data-monitors'
+import type keyViewer from '@exodus/key-viewer'
+import type keychain from '@exodus/keychain'
+import type locale from '@exodus/locale'
+import type messageSigner from '@exodus/message-signer'
+import type pricing from '@exodus/pricing'
+import type publicKeyProvider from '@exodus/public-key-provider'
+import type rates from '@exodus/rates-monitor'
+import type remoteConfig from '@exodus/remote-config'
+import type txSigner from '@exodus/tx-signer'
+import type wallet from '@exodus/wallet'
+import type walletAccounts from '@exodus/wallet-accounts'
 
 type ApiDefinitions<F extends Feature> = Extract<
   F['definitions'][number]['definition'],

package/src/index.js

@@ -18,7 +18,6 @@ import locale from '@exodus/locale'
 import messageSigner from '@exodus/message-signer'
 import pricing from '@exodus/pricing'
 import publicKeyProvider from '@exodus/public-key-provider'
-import publicKeyStore from '@exodus/public-key-store'
 import rates from '@exodus/rates-monitor'
 import remoteConfig from '@exodus/remote-config'
 import restoreProgressTracker from '@exodus/restore-progress-tracker'
@@ -32,7 +31,8 @@ import ms from 'ms'
 
 import createApi from './api'
 import createDependencies from './dependencies'
-import headlessUi from './headless-ui'
+import keychainRpc from './features/keychain-rpc'
+import walletRpc from './features/wallet-rpc'
 import attachMigrations from './migrations/attach'
 import attachPlugins from './plugins/attach'
 import { makeChainable } from './utils/ioc'
@@ -64,22 +64,28 @@ const createExodus = (opts) => {
   ioc.use(fees(config.fees))
   ioc.use(filesystem(config.filesystem))
   ioc.use(geolocation(config.geolocation))
-  ioc.use(keychain(config.keychain))
   ioc.use(keyViewer(config.keyViewer))
   ioc.use(locale(config.locale))
   ioc.use(messageSigner(config.messageSigner))
   ioc.use(pricing(config.pricing))
   ioc.use(publicKeyProvider(config.publicKeyProvider))
-  ioc.use(publicKeyStore(config.publicKeyStore))
   ioc.use(rates(config.rates))
   ioc.use(remoteConfig(config.remoteConfig))
   ioc.use(restoreProgressTracker(config.restoreProgressTracker))
   ioc.use(startupCounter(config.startupCounter))
   ioc.use(transactionSigner(config.transactionSigner))
   ioc.use(txLogMonitors(config.txLogMonitors))
-  ioc.use(wallet(config.wallet))
   ioc.use(walletAccounts(config.walletAccounts))
-  ioc.use(headlessUi())
+
+  const { walletSdk } = adapters
+
+  if (walletSdk) {
+    ioc.use(keychainRpc(walletSdk.keychain))
+    ioc.use(walletRpc(walletSdk.wallet))
+  } else {
+    ioc.use(keychain(config.keychain))
+    ioc.use(wallet(config.wallet))
+  }
 
   ioc.registerMultiple(createDependencies({ adapters, config }))
 

package/src/{headless-ui.js → plugins/headless-ui.js}

@@ -13,8 +13,4 @@ const headlessUiLifecyclePluginDefinition = {
   dependencies: ['storage'],
 }
 
-const headlessUiFeatureDefinition = () => ({
-  definitions: [{ definition: headlessUiLifecyclePluginDefinition }],
-})
-
-export default headlessUiFeatureDefinition
+export default headlessUiLifecyclePluginDefinition

package/src/utils/ioc.js

@@ -15,3 +15,31 @@ export const makeChainable = ({ ioc, methods, resolve }) =>
       return target[prop]
     },
   })
+
+/**
+ * @returns {import('@exodus/dependency-types').Feature}
+ */
+export const createRpcFeature = (id, api) => ({
+  id,
+  definitions: [
+    {
+      // export module to IOC for consumption via dependencies
+      definition: {
+        id,
+        type: 'module',
+        public: true,
+        factory: () => api,
+      },
+    },
+    {
+      // export API to SDK surface
+      definition: {
+        id: `${id}Api`,
+        type: 'api',
+        factory: () => ({
+          [id]: api,
+        }),
+      },
+    },
+  ],
+})