@vleap/warps-wallet-privy 1.0.0-beta.0

package/README.md

@@ -0,0 +1,152 @@
+# @vleap/warps-wallet-privy
+
+Privy wallet provider for Warps SDK. This package enables you to use Privy wallets with the Warps SDK across multiple blockchain networks. **Designed for Node.js environments** - no React dependencies required.
+
+## Installation
+
+```bash
+npm install @vleap/warps-wallet-privy
+```
+
+## Prerequisites
+
+- `@vleap/warps` core package installed
+- Privy SDK installed and configured (`@privy-io/server-sdk` for Node.js)
+
+## Usage
+
+### Node.js Usage
+
+Use Privy's server SDK to create a client:
+
+```typescript
+import { PrivyClient } from '@privy-io/server-sdk'
+import { PrivyWalletProvider } from '@vleap/warps-wallet-privy'
+import { WarpClient } from '@vleap/warps'
+import { getEvmAdapter } from '@vleap/warps-adapter-evm'
+
+const privyServerClient = new PrivyClient(process.env.PRIVY_APP_ID, process.env.PRIVY_APP_SECRET)
+
+const privyClient = {
+  getAddress: async () => {
+    const user = await privyServerClient.getUser(userId)
+    return user.wallet?.address || null
+  },
+  signTransaction: async (tx: any) => {
+    return await privyServerClient.signTransaction(userId, tx)
+  },
+  signMessage: async (message: string) => {
+    return await privyServerClient.signMessage(userId, message)
+  },
+}
+
+const config = {
+  env: 'mainnet',
+  walletProviders: {
+    ethereum: () => new PrivyWalletProvider({ privyClient }),
+  },
+}
+
+const client = new WarpClient(config, [getEvmAdapter(config)])
+
+// Use the client as normal
+const wallet = client.getWallet('ethereum')
+const address = await wallet.getAddress()
+```
+
+### Browser/React Usage (Optional)
+
+If you're using Privy in a React application, you can create a client adapter:
+
+```typescript
+import { PrivyWalletProvider } from '@vleap/warps-wallet-privy'
+import { WarpClient } from '@vleap/warps'
+import { getEvmAdapter } from '@vleap/warps-adapter-evm'
+
+// Create a Privy client adapter from your React Privy instance
+const privyClient = {
+  getAddress: async () => {
+    // Get address from your Privy instance
+    return privyInstance.user?.wallet?.address || null
+  },
+  signTransaction: async (tx: any) => {
+    // Sign transaction using your Privy instance
+    return await privyInstance.user?.wallet?.signTransaction(tx)
+  },
+  signMessage: async (message: string) => {
+    // Sign message using your Privy instance
+    return await privyInstance.user?.wallet?.signMessage(message)
+  },
+}
+
+const config = {
+  env: 'mainnet',
+  walletProviders: {
+    ethereum: () => new PrivyWalletProvider({ privyClient }),
+  },
+}
+
+const client = new WarpClient(config, [getEvmAdapter(config)])
+```
+
+### With Multiple Chains
+
+The Privy wallet provider supports multiple chains. You can configure it for different chains:
+
+```typescript
+const privyClient = {
+  getAddress: async () => /* ... */,
+  signTransaction: async (tx: any) => /* ... */,
+  signMessage: async (message: string) => /* ... */,
+}
+
+const config = {
+  env: 'mainnet',
+  walletProviders: {
+    ethereum: () => new PrivyWalletProvider({ privyClient }),
+    solana: () => new PrivyWalletProvider({ privyClient }),
+  },
+}
+
+const client = new WarpClient(config, [
+  getEvmAdapter(config),
+  getSolanaAdapter(config),
+])
+```
+
+## API
+
+Implements the `WalletProvider` interface from `@vleap/warps`.
+
+**Constructor:**
+```typescript
+new PrivyWalletProvider(config: PrivyWalletProviderConfig)
+```
+
+**Parameters:**
+- `config.privyClient`: The Privy client interface
+  - `getAddress(): Promise<string | null>` - Get the wallet address
+  - `signTransaction(tx: any): Promise<string>` - Sign a transaction
+  - `signMessage(message: string): Promise<string>` - Sign a message
+- `config.address` (optional): Fallback address if client doesn't provide one
+
+**Methods:**
+- `getAddress(): Promise<string | null>` - Get the wallet address
+- `getPublicKey(): Promise<string | null>` - Get the public key (returns null for Privy)
+- `signTransaction(tx: any): Promise<any>` - Sign a transaction
+- `signMessage(message: string): Promise<string>` - Sign a message
+
+## Supported Chains
+
+The Privy wallet provider works with any chain that Privy supports, including:
+- Ethereum and EVM-compatible chains
+- Solana
+- And other chains supported by Privy
+
+## Notes
+
+- **Node.js-first design**: This package has no React dependencies and is designed to work in Node.js environments
+- You need to provide a Privy client adapter that implements the `PrivyClient` interface
+- Public key is not available through Privy, so `getPublicKey()` always returns `null`
+- The client adapter should handle authentication and wallet availability checks
+- For React applications, create a client adapter that wraps your Privy React hooks

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import { WalletProvider } from '@vleap/warps';
+
+interface PrivyClient {
+    getAddress(): Promise<string | null>;
+    signTransaction(tx: any): Promise<string>;
+    signMessage(message: string): Promise<string>;
+}
+interface PrivyWalletProviderConfig {
+    privyClient: PrivyClient;
+    address?: string;
+}
+declare class PrivyWalletProvider implements WalletProvider {
+    private config;
+    constructor(config: PrivyWalletProviderConfig);
+    getAddress(): Promise<string | null>;
+    getPublicKey(): Promise<string | null>;
+    signTransaction(tx: any): Promise<any>;
+    signMessage(message: string): Promise<string>;
+}
+
+export { type PrivyClient, PrivyWalletProvider, type PrivyWalletProviderConfig };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { WalletProvider } from '@vleap/warps';
+
+interface PrivyClient {
+    getAddress(): Promise<string | null>;
+    signTransaction(tx: any): Promise<string>;
+    signMessage(message: string): Promise<string>;
+}
+interface PrivyWalletProviderConfig {
+    privyClient: PrivyClient;
+    address?: string;
+}
+declare class PrivyWalletProvider implements WalletProvider {
+    private config;
+    constructor(config: PrivyWalletProviderConfig);
+    getAddress(): Promise<string | null>;
+    getPublicKey(): Promise<string | null>;
+    signTransaction(tx: any): Promise<any>;
+    signMessage(message: string): Promise<string>;
+}
+
+export { type PrivyClient, PrivyWalletProvider, type PrivyWalletProviderConfig };

package/dist/index.js

@@ -0,0 +1,63 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PrivyWalletProvider: () => PrivyWalletProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/PrivyWalletProvider.ts
+var PrivyWalletProvider = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async getAddress() {
+    try {
+      const address = await this.config.privyClient.getAddress();
+      return address || this.config.address || null;
+    } catch {
+      return this.config.address || null;
+    }
+  }
+  async getPublicKey() {
+    return null;
+  }
+  async signTransaction(tx) {
+    try {
+      const signature = await this.config.privyClient.signTransaction(tx);
+      return { ...tx, signature };
+    } catch (error) {
+      throw new Error(`Failed to sign transaction: ${error}`);
+    }
+  }
+  async signMessage(message) {
+    try {
+      return await this.config.privyClient.signMessage(message);
+    } catch (error) {
+      throw new Error(`Failed to sign message: ${error}`);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PrivyWalletProvider
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/PrivyWalletProvider.ts"],"sourcesContent":["export * from './PrivyWalletProvider'\n","import { WalletProvider } from '@vleap/warps'\n\nexport interface PrivyClient {\n  getAddress(): Promise<string | null>\n  signTransaction(tx: any): Promise<string>\n  signMessage(message: string): Promise<string>\n}\n\nexport interface PrivyWalletProviderConfig {\n  privyClient: PrivyClient\n  address?: string\n}\n\nexport class PrivyWalletProvider implements WalletProvider {\n  constructor(\n    private config: PrivyWalletProviderConfig\n  ) {}\n\n  async getAddress(): Promise<string | null> {\n    try {\n      const address = await this.config.privyClient.getAddress()\n      return address || this.config.address || null\n    } catch {\n      return this.config.address || null\n    }\n  }\n\n  async getPublicKey(): Promise<string | null> {\n    // Privy doesn't expose public key directly\n    return null\n  }\n\n  async signTransaction(tx: any): Promise<any> {\n    try {\n      const signature = await this.config.privyClient.signTransaction(tx)\n      return { ...tx, signature }\n    } catch (error) {\n      throw new Error(`Failed to sign transaction: ${error}`)\n    }\n  }\n\n  async signMessage(message: string): Promise<string> {\n    try {\n      return await this.config.privyClient.signMessage(message)\n    } catch (error) {\n      throw new Error(`Failed to sign message: ${error}`)\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,IAAM,sBAAN,MAAoD;AAAA,EACzD,YACU,QACR;AADQ;AAAA,EACP;AAAA,EAEH,MAAM,aAAqC;AACzC,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO,YAAY,WAAW;AACzD,aAAO,WAAW,KAAK,OAAO,WAAW;AAAA,IAC3C,QAAQ;AACN,aAAO,KAAK,OAAO,WAAW;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,MAAM,eAAuC;AAE3C,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,gBAAgB,IAAuB;AAC3C,QAAI;AACF,YAAM,YAAY,MAAM,KAAK,OAAO,YAAY,gBAAgB,EAAE;AAClE,aAAO,EAAE,GAAG,IAAI,UAAU;AAAA,IAC5B,SAAS,OAAO;AACd,YAAM,IAAI,MAAM,+BAA+B,KAAK,EAAE;AAAA,IACxD;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,SAAkC;AAClD,QAAI;AACF,aAAO,MAAM,KAAK,OAAO,YAAY,YAAY,OAAO;AAAA,IAC1D,SAAS,OAAO;AACd,YAAM,IAAI,MAAM,2BAA2B,KAAK,EAAE;AAAA,IACpD;AAAA,EACF;AACF;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,36 @@
+// src/PrivyWalletProvider.ts
+var PrivyWalletProvider = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async getAddress() {
+    try {
+      const address = await this.config.privyClient.getAddress();
+      return address || this.config.address || null;
+    } catch {
+      return this.config.address || null;
+    }
+  }
+  async getPublicKey() {
+    return null;
+  }
+  async signTransaction(tx) {
+    try {
+      const signature = await this.config.privyClient.signTransaction(tx);
+      return { ...tx, signature };
+    } catch (error) {
+      throw new Error(`Failed to sign transaction: ${error}`);
+    }
+  }
+  async signMessage(message) {
+    try {
+      return await this.config.privyClient.signMessage(message);
+    } catch (error) {
+      throw new Error(`Failed to sign message: ${error}`);
+    }
+  }
+};
+export {
+  PrivyWalletProvider
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/PrivyWalletProvider.ts"],"sourcesContent":["import { WalletProvider } from '@vleap/warps'\n\nexport interface PrivyClient {\n  getAddress(): Promise<string | null>\n  signTransaction(tx: any): Promise<string>\n  signMessage(message: string): Promise<string>\n}\n\nexport interface PrivyWalletProviderConfig {\n  privyClient: PrivyClient\n  address?: string\n}\n\nexport class PrivyWalletProvider implements WalletProvider {\n  constructor(\n    private config: PrivyWalletProviderConfig\n  ) {}\n\n  async getAddress(): Promise<string | null> {\n    try {\n      const address = await this.config.privyClient.getAddress()\n      return address || this.config.address || null\n    } catch {\n      return this.config.address || null\n    }\n  }\n\n  async getPublicKey(): Promise<string | null> {\n    // Privy doesn't expose public key directly\n    return null\n  }\n\n  async signTransaction(tx: any): Promise<any> {\n    try {\n      const signature = await this.config.privyClient.signTransaction(tx)\n      return { ...tx, signature }\n    } catch (error) {\n      throw new Error(`Failed to sign transaction: ${error}`)\n    }\n  }\n\n  async signMessage(message: string): Promise<string> {\n    try {\n      return await this.config.privyClient.signMessage(message)\n    } catch (error) {\n      throw new Error(`Failed to sign message: ${error}`)\n    }\n  }\n}\n"],"mappings":";AAaO,IAAM,sBAAN,MAAoD;AAAA,EACzD,YACU,QACR;AADQ;AAAA,EACP;AAAA,EAEH,MAAM,aAAqC;AACzC,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO,YAAY,WAAW;AACzD,aAAO,WAAW,KAAK,OAAO,WAAW;AAAA,IAC3C,QAAQ;AACN,aAAO,KAAK,OAAO,WAAW;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,MAAM,eAAuC;AAE3C,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,gBAAgB,IAAuB;AAC3C,QAAI;AACF,YAAM,YAAY,MAAM,KAAK,OAAO,YAAY,gBAAgB,EAAE;AAClE,aAAO,EAAE,GAAG,IAAI,UAAU;AAAA,IAC5B,SAAS,OAAO;AACd,YAAM,IAAI,MAAM,+BAA+B,KAAK,EAAE;AAAA,IACxD;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,SAAkC;AAClD,QAAI;AACF,aAAO,MAAM,KAAK,OAAO,YAAY,YAAY,OAAO;AAAA,IAC1D,SAAS,OAAO;AACd,YAAM,IAAI,MAAM,2BAA2B,KAAK,EAAE;AAAA,IACpD;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@vleap/warps-wallet-privy",
+  "version": "1.0.0-beta.0",
+  "description": "Privy wallet provider for multiple chains - Node.js compatible, no React dependencies",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "jest --config jest.config.mjs",
+    "lint": "tsc --noEmit",
+    "prepare": "npm run build",
+    "preversion": "npm run lint && npm run build"
+  },
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@vleap/warps": "workspace:*"
+  },
+  "peerDependencies": {
+    "@vleap/warps": "^3.0.0-beta.174"
+  }
+}