toncorp-wallet-connect-sdk 0.1.1 → 0.1.2

package/README.md

@@ -8,6 +8,12 @@ Connect TonPass, OneDollar and more wallets from any DApp or website.
 npm install toncorp-wallet-connect-sdk
 ```
 
+Or via CDN:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/toncorp-wallet-connect-sdk@latest/dist/index.umd.js"></script>
+```
+
 ## Usage
 
 ### Specific wallet
@@ -15,25 +21,26 @@ npm install toncorp-wallet-connect-sdk
 ```typescript
 import { TonPassConnect } from 'toncorp-wallet-connect-sdk';
 
-const wallet = new TonPassConnect({
-  appId: 'your_app_id',
-  registryUrl: 'https://api.example.com/connect/wallets',
-});
+const wallet = new TonPassConnect({ appId: 'your_app_id' });
 
 const result = await wallet.connect();
-console.log(result.wallets); // [{ address: '0x...', chain: 'TON' }]
+console.log(result.wallet);  // { address: 'UQ...', chain: 'TON' }
 console.log(result.user);    // { username: 'john', avatar: '...' }
+
+// Access via window global
+window.tonpass.isConnected()  // true
+window.tonpass.getWallet()    // same result
 ```
 
 ```typescript
 import { OneDollarConnect } from 'toncorp-wallet-connect-sdk';
 
-const wallet = new OneDollarConnect({
-  appId: 'your_app_id',
-  registryUrl: 'https://api.example.com/connect/wallets',
-});
-
+const wallet = new OneDollarConnect({ appId: 'your_app_id' });
 const result = await wallet.connect();
+
+// Access via window global
+window.onedollar.isConnected()
+window.onedollar.getWallet()
 ```
 
 ### All wallets (show picker)
@@ -43,7 +50,6 @@ import { BaseWalletConnect } from 'toncorp-wallet-connect-sdk';
 
 const wallet = new BaseWalletConnect({
   appId: 'your_app_id',
-  registryUrl: 'https://api.example.com/connect/wallets',
   // walletId: ['tonpass', 'onedollar'],  // optional filter
 });
 
@@ -53,17 +59,21 @@ const result = await wallet.connect();
 ### Script tag (UMD)
 
 ```html
-<script src="https://unpkg.com/toncorp-wallet-connect-sdk/dist/index.umd.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/toncorp-wallet-connect-sdk@latest/dist/index.umd.js"></script>
 <script>
-  const wallet = new WalletConnectSDK.TonPassConnect({
+  const wallet = new WalletConnectSDK.OneDollarConnect({
     appId: 'your_app_id',
-    registryUrl: 'https://api.example.com/connect/wallets',
   });
 
   document.getElementById('connect-btn').onclick = async () => {
     const result = await wallet.connect();
     console.log(result);
   };
+
+  // Available globally after instantiation
+  // window.onedollar.isConnected()
+  // window.onedollar.getWallet()
+  // window.onedollar.disconnect()
 </script>
 ```
 
@@ -74,7 +84,7 @@ const result = await wallet.connect();
 | Option | Type | Required | Description |
 |--------|------|----------|-------------|
 | `appId` | `string` | Yes | Your registered app ID |
-| `registryUrl` | `string` | Yes | URL to fetch available wallets |
+| `registryUrl` | `string` | No | Override wallet registry URL (defaults to CDN) |
 | `walletId` | `string \| string[]` | No | Filter wallets (only for `BaseWalletConnect`) |
 | `theme` | `'light' \| 'dark'` | No | Modal theme (default: `light`) |
 
@@ -83,76 +93,50 @@ const result = await wallet.connect();
 | Method | Returns | Description |
 |--------|---------|-------------|
 | `connect()` | `Promise<ConnectResult>` | Open modal and wait for user to approve |
-| `disconnect()` | `void` | Disconnect and clear session |
+| `disconnect()` | `void` | Disconnect, clear session and call API |
 | `isConnected()` | `boolean` | Check connection status |
 | `getWallet()` | `ConnectResult \| null` | Get current connection info |
 | `on(event, cb)` | `void` | Listen to events |
 | `off(event, cb)` | `void` | Remove listener |
 
+### ConnectResult
+
+```typescript
+{
+  wallet: {
+    address: string;   // friendly TON address
+    chain: string;     // 'TON'
+  } | null;
+  user: {
+    username?: string;
+    avatar?: string;
+  };
+  session?: {
+    sessionToken: string;
+    walletId: string;
+    apiUrl: string;
+  };
+}
+```
+
 ### Events
 
 | Event | Data | Description |
 |-------|------|-------------|
 | `connect` | `ConnectResult` | Connected successfully |
-| `disconnect` | — | Disconnected |
+| `disconnect` | - | Disconnected |
 | `error` | `string` | Transport error |
-| `session_expired` | — | Session timed out |
-
-## Publish to npm
-
-### Prerequisites
+| `session_expired` | - | Session timed out |
 
-```bash
-# Login to npm (one-time)
-npm login
-
-# If using scoped package (@aspect-wallet), make sure the org exists on npmjs.com
-# Or change the name in package.json to an unscoped name
-```
-
-### Build & Publish
-
-```bash
-# Navigate to SDK folder
-cd src/blockchain/walletconnect/sdk
-
-# Install build dependencies
-npm install
-
-# Build (outputs to dist/)
-npm run build
-
-# Check what will be published
-npm pack --dry-run
-
-# Publish (first time — scoped packages default to private)
-npm publish --access public
+### Window globals
 
-# Publish subsequent versions
-# 1. Bump version first:
-npm version patch   # 0.1.0 → 0.1.1 (bug fixes)
-npm version minor   # 0.1.1 → 0.2.0 (new features)
-npm version major   # 0.2.0 → 1.0.0 (breaking changes)
-# 2. Then publish:
-npm publish --access public
-```
-
-### Verify
-
-```bash
-# Check the published package
-npm info toncorp-wallet-connect-sdk
-
-# Install in another project to test
-npm install toncorp-wallet-connect-sdk
-```
-
-### CDN (auto-available after publish)
+Each wallet instance auto-registers on `window`:
 
-```
-https://unpkg.com/toncorp-wallet-connect-sdk/dist/index.umd.js
-https://cdn.jsdelivr.net/npm/toncorp-wallet-connect-sdk/dist/index.umd.js
-```
+| Class | Window global |
+|-------|--------------|
+| `TonPassConnect` | `window.tonpass` |
+| `OneDollarConnect` | `window.onedollar` |
+| `BaseWalletConnect` | `window.walletconnect` |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toncorp-wallet-connect-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Wallet Connect SDK — connect TonPass, OneDollar and more wallets from any DApp",
   "author": "PlaygroundVina",
   "license": "MIT",