@elizaos/plugin-wallet-ui 2.0.3-beta.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+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

@@ -0,0 +1,62 @@
+# @elizaos/plugin-wallet-ui
+
+Non-custodial wallet inventory UI for elizaOS agents. Adds a full wallet surface — token balances, NFTs, market overview, trading analytics, and a compact chat-sidebar widget — to any agent shell that loads this plugin.
+
+## What it does
+
+- Displays EVM (Ethereum, Base, BNB Chain, Avalanche, Arbitrum, Optimism, Polygon) and Solana token balances and NFTs.
+- Shows portfolio value, per-chain allocation, P&L chart, recent swaps, and top movers from the agent's trading profile.
+- Renders a market overview (spot prices, top movers, prediction market data) when the wallet has no balance history yet.
+- Provides a compact wallet-status sidebar widget in the chat rail with live balance totals and one-click address copy.
+- Serves the inventory in three view types: standard (web/desktop), XR, and TUI (terminal).
+
+## Capabilities added
+
+| Surface | Description |
+|---|---|
+| Shell page `/inventory` | Full wallet inventory page registered in the agent shell nav |
+| Standalone view `/wallet` | Bundled `InventoryView` (standard and XR) loadable by the view manager |
+| TUI view `/wallet/tui` | Terminal-friendly `InventoryTuiView` |
+| Chat sidebar widget | `wallet.status` — compact balance summary with chain badges and address copy |
+
+No new elizaOS actions, providers, or server-side services are added. All data is fetched from `@elizaos/plugin-wallet` through the shared `client` API.
+
+## Requirements
+
+- `@elizaos/plugin-wallet` must be loaded — this plugin reads wallet data via the wallet API.
+- `@elizaos/app-core` peer dep for shell page and widget registration.
+- React 18 or later.
+
+## Enabling the plugin
+
+Import the side-effect module once at app boot so shell pages and widgets are registered before the shell mounts:
+
+```ts
+import "@elizaos/plugin-wallet-ui/ui";
+// or import the walletAppPlugin descriptor for custom registration:
+import { walletAppPlugin } from "@elizaos/plugin-wallet-ui";
+```
+
+Pass `walletAppPlugin` to your elizaOS plugin loader if your shell uses the plugin registry.
+
+## Supported chains
+
+**Primary inventory chains** (per-user filter toggles):
+- Ethereum, Base, BNB Chain (BSC), Avalanche (AVAX), Solana
+
+**Additional chains** (URL/config helpers only, no filter toggle):
+- Arbitrum, Optimism, Polygon
+
+## Configuration
+
+No environment variables are required. Wallet RPC provider selection (Eliza Cloud, Alchemy, QuickNode, Helius/Birdeye, or Custom) is managed by `@elizaos/plugin-wallet` and surfaced via the in-app RPC settings button.
+
+User preferences (hidden tokens, sidebar width) are stored in `localStorage` with `eliza:wallet:*` key prefixes.
+
+## Building
+
+```bash
+bun run --cwd plugins/plugin-wallet-ui build
+```
+
+This runs three steps: `tsup` for the plugin entry, `vite` for the standalone views bundle (`dist/views/bundle.js`), and `tsc` for type declarations. Both the tsup and vite outputs must be present for a complete distribution.

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@elizaos/plugin-wallet-ui",
+  "version": "2.0.3-beta.5",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "bun": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "dependencies": {
+    "@elizaos/core": "2.0.3-beta.5",
+    "@elizaos/shared": "2.0.3-beta.5",
+    "@elizaos/ui": "2.0.3-beta.5",
+    "lucide-react": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@elizaos/app-core": "2.0.3-beta.5",
+    "@elizaos/plugin-wallet": "2.0.3-beta.5",
+    "react": ">=18.0.0"
+  },
+  "elizaos": {
+    "app": {
+      "heroImage": "assets/hero.png"
+    },
+    "appRegister": "register"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
+    "build:js": "tsup --config ../tsup.plugin-packages.shared.ts",
+    "build:views": "bunx --bun vite build --config vite.config.views.ts",
+    "build:types": "tsc --noCheck -p tsconfig.build.json",
+    "typecheck": "tsgo --noEmit -p tsconfig.build.json",
+    "test": "bunx vitest run --config ./vitest.config.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^29.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.5.1",
+    "vite": "^8.0.0",
+    "vitest": "^4.0.17"
+  },
+  "gitHead": "ff6157011c9459670021cc28a6797592a78b8817"
+}