@exodus/available-assets 8.6.0 → 8.8.0

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.8.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/available-assets@8.6.0...@exodus/available-assets@8.8.0) (2025-08-22)
+
+### Features
+
+- feat: memoize available asset names atom selector (#10829)
+
+- feat: use atoms v9 (#9651)
+
+### License
+
+- license: re-license under MIT license (#10580)
+
+## [8.7.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/available-assets@8.6.0...@exodus/available-assets@8.7.0) (2024-11-25)
+
+### Features
+
+- feat: use atoms v9 (#9651)
+
+### License
+
+- license: re-license under MIT license (#10580)
+
 ## [8.6.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/available-assets@8.5.0...@exodus/available-assets@8.5.1) (2024-09-30)
 
 ### Refactor

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2024 Exodus Movement, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # @exodus/available-assets
 
-Tracks supported/available assets, i.e. assets that the user can potentially enable via the UI.
+This Exodus SDK feature tracks available assets, i.e. assets that the user can potentially enable via the UI.
 
 ## Install
 
@@ -10,27 +10,31 @@ yarn add @exodus/available-assets
 
 ## Usage
 
+This feature is designed to be used together with `@exodus/headless`. See [using the sdk](../../docs/development/using-the-sdk.md).
+
+### Play with it
+
+1. Open the playground https://exodus-hydra.pages.dev/features/available-assets
+2. Run `exodus.availableAssets.get()` in the Dev Tools Console.
+3. Run `selectors.availableAssets.all(store.getState())` in the Dev Tools Console.
+4. Run `selectors.availableAssets.get(store.getState())('bitcoin')` in the Dev Tools Console.
+5. Try out some other selectors from `selectors.availableAssets`. See example usage in [tests](./redux/__tests__/selectors/).
+
+### API Side
+
+See [using the sdk](../../docs/development/using-the-sdk.md#setup-the-api-side) for more details on how features plug into the SDK and the API interface in the [type declaration](./api/index.d.ts).
+
+If you're building a feature that requires knowing available assets, add a dependency on the `availableAssetNamesAtom`.
+
+### UI Side
+
+See [using the sdk](../../docs/development/using-the-sdk.md#events) for more details on basic UI-side setup.
+
 ```js
-// see https://github.com/ExodusMovement/exodus-hydra/blob/c5632b131fd3cd210f658fb45113528c0e227beb/sdks/headless/__tests__/available-assets.test.js#L40
-import createExodus from '@exodus/headless'
-import availableAssets from '@exodus/available-assets'
-
-const container = createExodus({
-  port,
-  adapters,
-  config: {
-    // ...,
-    // TODO: support configuring via feature config:
-    // `container.use(availableAssets({ defaultAvailableAssetNames: ['bitcoin', 'ethereum']}))`
-    availableAssetsAtom: {
-      defaultAvailableAssetNames: ['bitcoin', 'ethereum'],
-    },
-  },
-})
-
-container.use(availableAssets())
-
-const exodus = container.resolve()
-
-const availableAssetNames = await exodus.availableAssets.get() // ['bitcoin', 'ethereum']
+import selectors from '~/ui/flux/selectors'
+
+const MyComponent = () => {
+  const bitcoin = useSelector((state) => selectors.availableAssets.get(state)('bitcoin'))
+  if (!bitcoin) return <div>Bitcoin is not supported</div>
+}
 ```

package/atoms/{available-asset-names.js → available-asset-names/factory.js}

@@ -1,9 +1,14 @@
 import { compute } from '@exodus/atoms'
+import selector from './selector.js'
+import memoizeOne from 'memoize-one'
+import lodash from 'lodash'
+
+const { isEqual } = lodash
 
 const createAvailableAssetNamesAtom = ({ availableAssetsAtom }) =>
   compute({
     atom: availableAssetsAtom,
-    selector: (availableAssets) => availableAssets.map((a) => a.assetName),
+    selector: memoizeOne(selector, isEqual),
   })
 
 export default createAvailableAssetNamesAtom

package/atoms/available-asset-names/selector.js

@@ -0,0 +1,3 @@
+const selector = (availableAssets) => availableAssets.map((a) => a.assetName)
+
+export default selector

package/atoms/index.js

@@ -1,5 +1,5 @@
 import createAvailableAssetNamesWithoutParentCombinedAtom from './available-asset-names-without-parent-combined.js'
-import createAvailableAssetNamesAtom from './available-asset-names.js'
+import createAvailableAssetNamesAtom from './available-asset-names/factory.js'
 import createAvailableAssetAtom from './available-assets.js'
 
 export const availableAssetNamesAtomDefinition = {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@exodus/available-assets",
-  "version": "8.6.0",
-  "description": "Tracks supported/available assets, i.e. assets that the user can potentially enable via the UI",
-  "license": "UNLICENSED",
+  "version": "8.8.0",
+  "description": "This Exodus SDK feature tracks available assets, i.e. assets that the user can potentially enable via the UI.",
+  "license": "MIT",
   "author": "Exodus Movement, Inc.",
   "scripts": {
     "test": "run -T exodus-test --jest",
@@ -31,24 +31,27 @@
     "url": "git+https://github.com/ExodusMovement/exodus-hydra.git"
   },
   "dependencies": {
-    "@exodus/atoms": "^8.1.0",
+    "@exodus/atoms": "^9.0.0",
     "@exodus/basic-utils": "^3.0.1",
-    "@exodus/core-selectors": "^3.0.0",
-    "@exodus/trezor-meta": "^3.3.6",
+    "@exodus/core-selectors": "^4.0.0",
     "lodash": "^4.17.21",
     "make-concurrent": "^5.3.0",
+    "memoize-one": "^5.2.1",
     "reselect": "^3.0.1"
   },
   "devDependencies": {
     "@exodus/assets": "^11.0.0",
     "@exodus/assets-base": "^10.0.0",
-    "@exodus/assets-feature": "^5.12.0",
+    "@exodus/assets-feature": "^8.4.0",
     "@exodus/combined-assets-meta": "^3.0.0",
-    "@exodus/enabled-assets": "^10.7.1",
-    "@exodus/models": "^12.0.1",
-    "@exodus/redux-dependency-injection": "^4.0.3",
+    "@exodus/enabled-assets": "^10.10.3",
+    "@exodus/models": "^12.16.0",
+    "@exodus/redux-dependency-injection": "^4.1.2",
     "jest-when": "^3.6.0",
     "redux": "^4.2.1"
   },
-  "gitHead": "8353eb9f3712dcb5ba6808a8604f677de08980ed"
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "089fd1aa6a27487f0dd0de41b5235676545a9bdc"
 }