@exodus/headless 2.0.0 → 2.2.0

package/CHANGELOG.md

@@ -3,6 +3,29 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.2.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/headless@2.1.0...@exodus/headless@2.2.0) (2024-01-09)
+
+### Features
+
+- add `autoEnableAssetsPlugin` to enabled-assets ([#5272](https://github.com/ExodusMovement/exodus-hydra/issues/5272)) ([92896c4](https://github.com/ExodusMovement/exodus-hydra/commit/92896c47e445c101ed10121614cea43b5b4350b3))
+- **address-provider:** debug node ([#5126](https://github.com/ExodusMovement/exodus-hydra/issues/5126)) ([4ac0312](https://github.com/ExodusMovement/exodus-hydra/commit/4ac0312c7e5a3022a2b0be27f6621e26509fcf08))
+- **nfts:** store nfts and txs in atoms ([#5227](https://github.com/ExodusMovement/exodus-hydra/issues/5227)) ([b94cf12](https://github.com/ExodusMovement/exodus-hydra/commit/b94cf12f2d980afa70f242b863964f0864a2b89e))
+
+### Bug Fixes
+
+- **headless:** missed private function ([#5266](https://github.com/ExodusMovement/exodus-hydra/issues/5266)) ([c44abcb](https://github.com/ExodusMovement/exodus-hydra/commit/c44abcbd3f0fc2e9bffd86484246c891535b66d4))
+- run preprocessors on all nodes ([#5154](https://github.com/ExodusMovement/exodus-hydra/issues/5154)) ([b36b481](https://github.com/ExodusMovement/exodus-hydra/commit/b36b4810af04233acf33911dd6013f7be17ac7b8))
+
+## [2.1.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/headless@2.0.0...@exodus/headless@2.1.0) (2023-12-18)
+
+### Features
+
+- add geolocation debug api ([#5000](https://github.com/ExodusMovement/exodus-hydra/issues/5000)) ([63f7420](https://github.com/ExodusMovement/exodus-hydra/commit/63f7420ac9f2dee98702691d382e6561310f31cc))
+- **debug:** add clear and restart methods ([#5109](https://github.com/ExodusMovement/exodus-hydra/issues/5109)) ([77170cf](https://github.com/ExodusMovement/exodus-hydra/commit/77170cf42c261f18269f0d2de3091f7db752af2e))
+- filesystem feature ([#5058](https://github.com/ExodusMovement/exodus-hydra/issues/5058)) ([1d3d85d](https://github.com/ExodusMovement/exodus-hydra/commit/1d3d85dc2e200954230305a0a6c0e36f35c79db2))
+- **headless:** pass debug flag instead of using env build ([#5087](https://github.com/ExodusMovement/exodus-hydra/issues/5087)) ([f5be292](https://github.com/ExodusMovement/exodus-hydra/commit/f5be292047781c808173df377eaa43e590350a2e))
+- **headless:** use debugger preprocessor ([#5088](https://github.com/ExodusMovement/exodus-hydra/issues/5088)) ([7e15717](https://github.com/ExodusMovement/exodus-hydra/commit/7e15717cb18dfa169e668bcdce6cde9a412c321d))
+
 ## [2.0.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/headless@2.0.0-alpha.149...@exodus/headless@2.0.0) (2023-12-15)
 
 **Note:** Version bump only for package @exodus/headless

package/README.md

@@ -195,6 +195,18 @@ An object with additional configuration options for the Exodus instance.
 
 Currently not used.
 
+## Debugging
+
+Some features expose APIs for easy debugging, troubleshooting, and PR testing. You can access these APIs under exodus.debug. To enable them, simply pass debug: true to the headless factory function:
+
+```js
+import createExodus from '@exodus/headless'
+
+const exodusContainer = createExodus({ port, adapters, config, debug: true })
+
+exodusContainer.debug.geolocation.merge({ countryCode: 'US' })
+```
+
 ## Headless API
 
 ### wallet

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/headless",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "The platform-agnostic Exodus wallet SDK",
   "author": "Exodus Movement Inc.",
   "main": "src/index.js",
@@ -29,18 +29,18 @@
     "@exodus/address-provider": "^9.0.1",
     "@exodus/assets-feature": "^4.0.1",
     "@exodus/atoms": "^7.0.0",
-    "@exodus/auto-enable-assets-plugin": "^4.4.0",
     "@exodus/available-assets": "^8.0.0",
-    "@exodus/balances": "^12.0.1",
+    "@exodus/balances": "^12.4.0",
     "@exodus/basic-utils": "^2.0.0",
     "@exodus/blockchain-metadata": "^15.0.0",
     "@exodus/dependency-injection": "^2.1.0",
-    "@exodus/dependency-preprocessors": "^4.0.0",
-    "@exodus/enabled-assets": "^9.0.1",
+    "@exodus/dependency-preprocessors": "^5.1.0",
+    "@exodus/enabled-assets": "^9.1.0",
     "@exodus/feature-flags": "^5.1.0",
     "@exodus/fee-data-monitors": "^3.0.0",
     "@exodus/fetch": "^1.2.1",
-    "@exodus/geolocation": "^3.0.0",
+    "@exodus/filesystem": "^1.1.0",
+    "@exodus/geolocation": "^3.1.0",
     "@exodus/hd-key-slip-10": "^2.0.0",
     "@exodus/key-identifier-provider": "^1.4.0",
     "@exodus/keychain": "^4.3.0",
@@ -76,19 +76,19 @@
     "@exodus/ethereum-meta": "^1.0.23",
     "@exodus/exodus-pricing-client": "^1.2.0",
     "@exodus/key-utils": "^3.0.0",
-    "@exodus/kyc": "^4.2.0",
+    "@exodus/kyc": "^4.3.0",
     "@exodus/litecoin-meta": "^1.0.0",
-    "@exodus/market-history": "^7.2.0",
+    "@exodus/market-history": "^7.3.1",
     "@exodus/models": "^10.1.0",
-    "@exodus/nfts": "^7.1.2",
+    "@exodus/nfts": "^7.7.0",
     "@exodus/personal-notes": "^3.6.0",
-    "@exodus/referrals": "^8.0.1",
+    "@exodus/referrals": "^8.1.0",
     "@exodus/solana-lib": "^1.3.11",
     "@exodus/solana-meta": "^1.0.2",
     "@exodus/storage-encrypted": "^1.1.2",
     "@exodus/storage-memory": "^2.1.1",
     "@exodus/top-movers-monitor": "^3.2.0",
-    "@exodus/ui-config": "^3.3.0",
+    "@exodus/ui-config": "^3.4.0",
     "@exodus/wild-emitter": "^1.0.0",
     "buffer-json": "^2.0.0",
     "deepmerge": "^4.2.2",
@@ -100,5 +100,5 @@
     "msw": "^2.0.0",
     "p-defer": "^4.0.0"
   },
-  "gitHead": "a4af3e13c365318d2105d7d9c8ccfbfa2aa089a0"
+  "gitHead": "3ef6c31598f798b40afb25582ee920e080f3e007"
 }

package/src/api/debug.js

@@ -1,13 +1,24 @@
-const createApi = ({ ioc }) => {
-  const { env } = ioc.getByType('adapter')
-
-  if (!env || env.build !== 'development') return {}
+const createApi = ({ ioc, port, debug }) => {
+  if (!debug) return
 
   const apis = ioc.getByType('debug')
 
-  return {
-    debug: Object.assign({}, ...Object.values(apis)),
+  const { unsafeStorage } = ioc.getByType('adapter')
+
+  const { blockchainMetadata } = ioc.getByType('module')
+
+  const restart = async () => {
+    // TODO: clever way to know what to invalidate
+    await blockchainMetadata.clear()
+    port.emit('restart', { reason: 'debug' })
   }
+
+  const clear = async () => {
+    await unsafeStorage.namespace('debug').clear()
+    await restart()
+  }
+
+  return Object.assign({}, ...Object.values(apis), { clear, restart })
 }
 
 export default createApi

package/src/api/index.js

@@ -3,13 +3,47 @@ import { validateMnemonic as isMnemonicValid } from 'bip39'
 import createDebug from './debug'
 import createReporting from './reporting'
 
-const createApi = ({ ioc, port, config }) => {
+const createApi = ({ ioc, port, config, debug }) => {
   const apis = ioc.getByType('api')
 
+  const { application, passphraseCache } = ioc.getByType('module')
+
+  const featureApis = Object.assign({}, ...Object.values(apis))
+
+  const restoreFromCurrentPhrase = async ({ passphrase } = {}) => {
+    if (!passphrase && passphraseCache) passphrase = await passphraseCache.get()
+    const mnemonic = await application.getMnemonic({ passphrase })
+    await application.import({ passphrase, mnemonic })
+  }
+
+  // TODO: Improve api here. exodus.wallet.create makes sense, but it's confusing it calls application
+  featureApis.wallet = {
+    ...featureApis.wallet,
+    start: application.start,
+    stop: application.stop,
+    load: application.load,
+    unload: application.unload,
+    create: application.create,
+    lock: application.lock,
+    unlock: application.unlock,
+    import: application.import,
+    delete: application.delete,
+    getMnemonic: application.getMnemonic,
+    setBackedUp: application.setBackedUp,
+    changePassphrase: application.changePassphrase,
+    changeLockTimer: application.changeLockTimer,
+    restartAutoLockTimer: application.restartAutoLockTimer,
+    restoreFromCurrentPhrase,
+  }
+
+  const debugApi = createDebug({ ioc, port, debug })
+
+  const reportingApi = createReporting({ ioc, config })
+
   return {
-    ...Object.assign({}, ...Object.values(apis)),
-    ...createDebug({ ioc }),
-    ...createReporting({ ioc, config }),
+    ...featureApis,
+    debug: debugApi,
+    reporting: reportingApi,
     isMnemonicValid,
     subscribe: port.subscribe.bind(port),
     unsubscribe: port.unsubscribe.bind(port),

package/src/api/reporting.js

@@ -29,11 +29,7 @@ const createReporting = ({ ioc, config: { exportTimeout = 2000 } }) => {
     return zipObject(namespaces, data)
   }
 
-  return {
-    reporting: {
-      export: getReports,
-    },
-  }
+  return { export: getReports }
 }
 
 export default createReporting

package/src/application.js

@@ -229,7 +229,7 @@ class Application extends ExodusModule {
 
   restore = async () => {
     await this.#storage.set(RESTORE_FLAG, true)
-    await this.restoreIfNeeded()
+    await this.#restoreIfNeeded()
   }
 
   #autoUnlock = async () => {

package/src/index.js

@@ -6,6 +6,7 @@ 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 filesystem from '@exodus/filesystem'
 import geolocation from '@exodus/geolocation'
 import keychain from '@exodus/keychain'
 import locale from '@exodus/locale'
@@ -24,10 +25,10 @@ import createIOC from './ioc'
 import attachMigrations from './migrations/attach'
 import attachPlugins from './plugins/attach'
 
-const createExodus = ({ adapters, config, port }) => {
-  const ioc = createIOC({ adapters, config })
+const createExodus = ({ adapters, config, port, debug = false }) => {
+  const ioc = createIOC({ adapters, config, debug })
 
-  ioc.use(addressProvider({ config: config.addressProvider }))
+  ioc.use(addressProvider({ config: config.addressProvider, debug }))
   ioc.use(assetsFeature())
   ioc.use(availableAssets())
   ioc.use(balances(config.balances))
@@ -35,6 +36,7 @@ const createExodus = ({ adapters, config, port }) => {
   ioc.use(enabledAssets())
   ioc.use(featureFlags())
   ioc.use(fees())
+  ioc.use(filesystem())
   ioc.use(geolocation())
   ioc.use(keychain(config.keychain))
   ioc.use(locale())
@@ -119,7 +121,7 @@ const createExodus = ({ adapters, config, port }) => {
       logger: ioc.get('createLogger')('attachPlugins'),
     })
 
-    return createApi({ ioc, port, config })
+    return createApi({ ioc, port, config, debug })
   }
 
   return { ...ioc, resolve }

package/src/ioc.js

@@ -2,6 +2,7 @@ import createIocContainer from '@exodus/dependency-injection'
 import preprocess from '@exodus/dependency-preprocessors'
 import alias from '@exodus/dependency-preprocessors/src/preprocessors/alias'
 import configPreprocessor from '@exodus/dependency-preprocessors/src/preprocessors/config'
+import debuggerPreprocessor from '@exodus/dependency-preprocessors/src/preprocessors/debugger'
 import devModeAtoms from '@exodus/dependency-preprocessors/src/preprocessors/dev-mode-atoms'
 import logify from '@exodus/dependency-preprocessors/src/preprocessors/logify'
 import namespaceStorage from '@exodus/dependency-preprocessors/src/preprocessors/namespace-storage'
@@ -12,8 +13,8 @@ import assert from 'minimalistic-assert'
 
 import createDependencies from './dependencies'
 
-const createIOC = ({ adapters, config }) => {
-  const { createLogger, performance = {} } = adapters
+const createIOC = ({ adapters, config, debug }) => {
+  const { createLogger, unsafeStorage, performance = {} } = adapters
   const {
     readOnlyAtoms: readOnlyAtomsConfig,
     devModeAtoms: devModeAtomsConfig,
@@ -48,14 +49,17 @@ const createIOC = ({ adapters, config }) => {
     }),
     optional(),
     devModeAtomsConfig && devModeAtoms(devModeAtomsConfig),
+    debuggerPreprocessor({ debug, unsafeStorage }),
   ].filter(Boolean)
 
+  const nodes = createDependencies({ adapters, config })
+
   const registerMultiple = (dependencies) => {
-    ioc.registerMultiple(preprocess({ dependencies, preprocessors }))
+    nodes.push(...dependencies)
   }
 
   const register = (dependency) => {
-    registerMultiple([dependency])
+    nodes.push(dependency)
   }
 
   const use = (feature) => {
@@ -67,9 +71,12 @@ const createIOC = ({ adapters, config }) => {
     registerMultiple(feature.definitions)
   }
 
-  registerMultiple(createDependencies({ adapters, config }))
+  const resolve = () => {
+    ioc.registerMultiple(preprocess({ dependencies: nodes, preprocessors }))
+    ioc.resolve()
+  }
 
-  return { ...ioc, register, registerMultiple, use }
+  return { ...ioc, resolve, register, registerMultiple, use }
 }
 
 export default createIOC

package/src/plugins/index.js

@@ -1,5 +1,3 @@
-import autoEnableAssetsPlugin from '@exodus/auto-enable-assets-plugin'
-
 import logLifecyclePlugin from './log-lifecycle'
 
-export default [logLifecyclePlugin, autoEnableAssetsPlugin]
+export default [logLifecyclePlugin]