{"_id":"@deloraprotocol/widget-wallet-management","name":"@deloraprotocol/widget-wallet-management","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@deloraprotocol/widget-wallet-management","version":"0.1.0","description":"Optional host wallet adapters for @deloraprotocol/widget.","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"},"./wagmi":{"import":"./dist/useWagmiManagedWallet.js","types":"./dist/useWagmiManagedWallet.d.ts"},"./solana":{"import":"./dist/useSolanaWalletAdapterManagedWallet.js","types":"./dist/useSolanaWalletAdapterManagedWallet.d.ts"},"./provider":{"import":"./dist/DeloraWalletManagementProvider.js","types":"./dist/DeloraWalletManagementProvider.d.ts"},"./auto":{"import":"./dist/DeloraAutoWalletManagementProvider.js","types":"./dist/DeloraAutoWalletManagementProvider.d.ts"},"./composite":{"import":"./dist/useCompositeManagedWallet.js","types":"./dist/useCompositeManagedWallet.d.ts"}},"sideEffects":false,"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc --noEmit"},"peerDependencies":{"@deloraprotocol/widget":">=1.0.22","@solana/wallet-adapter-react":">=0.15.35","react":">=18.0.0","wagmi":">=2.0.0"},"peerDependenciesMeta":{"@solana/wallet-adapter-react":{"optional":true},"wagmi":{"optional":true}},"devDependencies":{"@types/react":"^18.2.0","typescript":"^5.3.0"},"_id":"@deloraprotocol/widget-wallet-management@0.1.0","gitHead":"a5b5be22e2a2f8d8bfa040abceec62943904f58a","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-0aYni2w8r22VpRzWUyGSwgpEwXUzQwUD7MlSFhEK//aSy2s47WqjDh4MyfWvR+DN8X2+FgcFPa7KtIHnCApkig==","shasum":"8c1f6638afc81a65338c83a76d36255109998c69","tarball":"https://registry.npmjs.org/@deloraprotocol/widget-wallet-management/-/widget-wallet-management-0.1.0.tgz","fileCount":38,"unpackedSize":125711,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCLLxcUv+96bzTb77ih64w0hiiIdYDny3llYydFkTecrAIgSYpu+hGxFkqgTgHwjeAd9fnjulXy2i00CiSoQ1j02o8="}]},"_npmUser":{"name":"delora","email":"deloraprotocol@gmail.com"},"directories":{},"maintainers":[{"name":"delora","email":"deloraprotocol@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/widget-wallet-management_0.1.0_1777932189120_0.8367386611445629"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-04T22:03:09.045Z","0.1.0":"2026-05-04T22:03:09.261Z","modified":"2026-05-04T22:03:09.451Z"},"maintainers":[{"name":"delora","email":"deloraprotocol@gmail.com"}],"description":"Optional host wallet adapters for @deloraprotocol/widget.","readme":"# @deloraprotocol/widget-wallet-management\r\n\r\nOptional wallet adapters for `@deloraprotocol/widget`.\r\n\r\n## Auto-detect provider\r\n\r\nUse this LI.FI-style provider when the app already has `WagmiProvider` and/or\r\n`WalletProvider` from Solana Wallet Adapter above the widget. It auto-detects\r\nthose contexts and wires Delora to them. If only one namespace is externally\r\nmanaged, Delora falls back to the core built-in wallet flow for the other\r\nnamespace by default.\r\n\r\n```tsx\r\nimport { TradeWidget } from \"@deloraprotocol/widget\";\r\nimport {\r\n  DeloraAutoWalletManagementProvider,\r\n} from \"@deloraprotocol/widget-wallet-management/auto\";\r\n\r\nfunction WidgetWithAutoWallets() {\r\n  return (\r\n    <DeloraAutoWalletManagementProvider\r\n      evm={{\r\n        walletOptions: [],\r\n        openConnectModal: () => {\r\n          // Open RainbowKit, Dynamic, Reown, or another host wallet UI here.\r\n        },\r\n      }}\r\n      solana={{\r\n        walletOptions: [],\r\n        openConnectModal: () => {\r\n          // Open Solana Wallet Adapter UI here.\r\n        },\r\n      }}\r\n      usePartialWalletManagement\r\n    >\r\n      <TradeWidget config={{ apiUrl: \"https://api.delora.build\" }} />\r\n    </DeloraAutoWalletManagementProvider>\r\n  );\r\n}\r\n```\r\n\r\nSet `forceInternalWalletManagement` to bypass detected contexts. Set\r\n`usePartialWalletManagement={false}` if the host wants full responsibility for\r\nall wallet namespaces and does not want Delora to fall back to built-in wallets.\r\n\r\n## Manual provider\r\n\r\n```tsx\r\nimport { TradeWidget } from \"@deloraprotocol/widget\";\r\nimport {\r\n  DeloraWalletManagementProvider,\r\n} from \"@deloraprotocol/widget-wallet-management/provider\";\r\nimport {\r\n  useCompositeManagedWallet,\r\n} from \"@deloraprotocol/widget-wallet-management/composite\";\r\nimport {\r\n  useSolanaWalletAdapterManagedWallet,\r\n} from \"@deloraprotocol/widget-wallet-management/solana\";\r\nimport {\r\n  useWagmiManagedWallet,\r\n} from \"@deloraprotocol/widget-wallet-management/wagmi\";\r\n\r\nfunction WidgetWithHostWallets() {\r\n  const evm = useWagmiManagedWallet({\r\n    walletOptions: [],\r\n    openConnectModal: () => {\r\n      // Open RainbowKit, Dynamic, Reown, or another host wallet UI here.\r\n    },\r\n  });\r\n  const solana = useSolanaWalletAdapterManagedWallet({\r\n    walletOptions: [],\r\n    openConnectModal: () => {\r\n      // Open Solana Wallet Adapter UI here.\r\n    },\r\n  });\r\n  const wallet = useCompositeManagedWallet({ evm, solana });\r\n\r\n  return (\r\n    <DeloraWalletManagementProvider wallet={wallet}>\r\n      <TradeWidget config={{ apiUrl: \"https://api.delora.build\" }} />\r\n    </DeloraWalletManagementProvider>\r\n  );\r\n}\r\n```\r\n\r\nUse subpath imports when installing only one wallet stack. The root package also\r\nre-exports every adapter for apps that install both `wagmi` and\r\n`@solana/wallet-adapter-react`.\r\n\r\n## Modes\r\n\r\n- Host modal: pass `walletOptions: []` and `openConnectModal`. Delora's connect\r\n  button opens your app's wallet UI and waits until the host wallet state\r\n  changes.\r\n- Widget picker: omit `walletOptions: []`. Delora renders curated wallet rows\r\n  and delegates the selected row to Wagmi or Solana Wallet Adapter.\r\n- Partial wallet management: pass only the namespace adapters the host owns.\r\n  Delora core keeps built-in wallet management for the remaining namespaces.\r\n\r\nThe Wagmi adapter hides unknown/service connectors such as Safe or Base Account\r\nfrom the widget picker by default. Pass `walletOptionIds` for an explicit\r\nallow-list, or `includeUnknownWalletOptions: true` if your app wants to expose\r\ncustom connectors.\r\n\r\nThe Solana adapter hides undetected adapters by default. Pass\r\n`includeUndetectedWallets: true` if your app wants installable Solana rows.\r\n","readmeFilename":"README.md","_rev":"1-ab0223e0b84484d55cbf4d59ec3299a6"}