@lydianpay/lydianconnect 0.0.0-managed → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lydian
+
+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,83 @@
+# @lydianpay/lydianconnect
+
+Wallet-connection library for Lydian frontends. It connects to a user's wallet
+through the wallet's **native SDK** when one exists (MetaMask, Coinbase) and
+falls back to **WalletConnect** for everything else — behind a single uniform
+API, so your app never branches on which path was used.
+
+## Install
+
+```bash
+npm install @lydianpay/lydianconnect
+```
+
+## Usage
+
+```ts
+import {
+  LydianConnect,
+  WalletConnectConnector,
+  MetaMaskConnector,
+  CoinbaseConnector,
+} from '@lydianpay/lydianconnect';
+
+const lc = new LydianConnect({
+  connectors: [
+    new MetaMaskConnector({ dappMetadata: { name: 'My App', url: location.origin } }),
+    new CoinbaseConnector({ appName: 'My App' }),
+  ],
+  fallback: new WalletConnectConnector({
+    projectId: 'your-walletconnect-project-id',
+    metadata: {
+      name: 'My App',
+      description: 'My App',
+      url: location.origin,
+      icons: ['https://my.app/icon.png'],
+    },
+  }),
+});
+
+// One call — the result is identical whether it routes to a native SDK or
+// to WalletConnect. Your app never branches on the source.
+const conn = await lc.connect({
+  walletId: 'metamask',
+  namespace: {
+    name: 'eip155',
+    value: { chains: ['eip155:1'], methods: ['eth_sendTransaction'], events: [] },
+  },
+});
+
+const txHash = await conn.request({ method: 'eth_sendTransaction', params: [tx] });
+
+lc.on((event) => {
+  // 'connect' | 'disconnect' | 'chainChanged' | 'accountsChanged'
+  // | 'display_uri' | 'wallet_open_failed'
+});
+```
+
+`conn` is the uniform handle: `{ walletId, account, chainId, request, disconnect }`.
+Encoding/signing (ethers, viem, …) stays in your app — this library only moves
+opaque RPC requests.
+
+## Supported wallets
+
+- **Native SDK:** MetaMask, Coinbase
+- **WalletConnect fallback:** every other WalletConnect-compatible wallet, with
+  per-wallet deep-linking generated from the WalletConnect explorer registry
+
+## Development
+
+See [CLAUDE.md](./CLAUDE.md) for architecture, conventions, and the wallet-link
+registry generator (`scripts/build-wallet-links.mjs`).
+
+```bash
+npm install
+npm run build        # ESM + CJS + d.ts
+npm run lint
+npm run typecheck
+npm test
+```
+
+## License
+
+MIT

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@lydianpay/lydianconnect",
-  "version": "0.0.0-managed",
+  "version": "1.0.0",
   "description": "Wallet connection library for Lydian — native wallet SDKs with WalletConnect fallback, behind one uniform API.",
   "type": "module",
+  "license": "MIT",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",