@txnlab/use-wallet-w3wallet 5.0.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TxnLab, Inc.
+
+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/dist/index.d.ts

@@ -0,0 +1,29 @@
+import algosdk from "algosdk";
+import { AdapterConstructorParams, BaseWallet, WalletAccount, WalletMetadata, WalletTransaction } from "@txnlab/use-wallet/adapter";
+import { WalletAdapterConfig } from "@txnlab/use-wallet";
+
+//#region src/adapter.d.ts
+interface W3WalletProvider {
+  isConnected: () => Promise<boolean>;
+  account: () => Promise<WalletAccount>;
+  signTxns: (transactions: WalletTransaction[]) => Promise<(string | null)[]>;
+}
+declare class W3WalletAdapter extends BaseWallet {
+  private client;
+  constructor(params: AdapterConstructorParams);
+  static defaultMetadata: WalletMetadata;
+  private initializeClient;
+  connect: () => Promise<WalletAccount[]>;
+  disconnect: () => Promise<void>;
+  resumeSession: () => Promise<void>;
+  private processTxns;
+  private processEncodedTxns;
+  signTransactions: <T extends algosdk.Transaction[] | Uint8Array[]>(txnGroup: T | T[], indexesToSign?: number[]) => Promise<(Uint8Array | null)[]>;
+}
+//#endregion
+//#region src/index.d.ts
+declare const WALLET_ID: "w3wallet";
+declare function w3wallet(): WalletAdapterConfig;
+//#endregion
+export { W3WalletAdapter, type W3WalletProvider, WALLET_ID, w3wallet };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,141 @@
+import algosdk from "algosdk";
+import { BaseWallet, base64ToByteArray, byteArrayToBase64, flattenTxnGroup, isSignedTxn, isTransactionArray } from "@txnlab/use-wallet/adapter";
+//#endregion
+//#region src/adapter.ts
+const ICON = `data:image/svg+xml;base64,${btoa(`
+<svg width="860" height="860" viewBox="0 0 860 860" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="860" height="860" rx="30" fill="#151923"/>
+  <path d="M766 207L496.627 623.406C463.521 675.336 382.014 652.248 382.014 590.941V432.568L260.638 623.28C227.559 675.255 146 652.186 146 590.854V274.844H234.646V499.761L356.022 309.049C389.101 257.074 470.66 280.143 470.66 341.475V499.978L660.146 207L766 207Z" fill="#4BB7D1"/>
+</svg>
+`)}`;
+var W3WalletAdapter = class extends BaseWallet {
+	client = null;
+	constructor(params) {
+		super(params);
+	}
+	static defaultMetadata = {
+		name: "W3 Wallet",
+		icon: ICON
+	};
+	async initializeClient() {
+		this.logger.info("Initializing client...");
+		if (typeof window === "undefined" || window.w3walletAlgorand === void 0) {
+			this.logger.error("W3 Wallet is not available.");
+			throw new Error("W3 Wallet is not available.");
+		}
+		const client = window.w3walletAlgorand;
+		this.client = client;
+		this.logger.info("Client initialized");
+		return client;
+	}
+	connect = async () => {
+		this.logger.info("Connecting...");
+		const activeAccount = await (this.client || await this.initializeClient()).account();
+		const walletState = {
+			accounts: [activeAccount],
+			activeAccount
+		};
+		this.store.addWallet(walletState);
+		this.logger.info("Connected successfully", walletState);
+		return [activeAccount];
+	};
+	disconnect = async () => {
+		this.logger.info("Disconnecting...");
+		this.onDisconnect();
+		this.logger.info("Disconnected");
+	};
+	resumeSession = async () => {
+		try {
+			if (!this.store.getWalletState()) {
+				this.logger.info("No session to resume");
+				return;
+			}
+			this.logger.info("Resuming session...");
+			if (!await (await this.initializeClient()).isConnected()) {
+				this.logger.error("W3 Wallet is not connected.");
+				throw new Error("W3 Wallet is not connected.");
+			}
+			this.logger.info("Session resumed");
+		} catch (error) {
+			this.logger.error("Error resuming session:", error.message);
+			this.onDisconnect();
+			throw error;
+		}
+	};
+	processTxns(txnGroup, indexesToSign) {
+		const txnsToSign = [];
+		txnGroup.forEach((txn, index) => {
+			const isIndexMatch = !indexesToSign || indexesToSign.includes(index);
+			const signer = txn.sender.toString();
+			const canSignTxn = this.addresses.includes(signer);
+			const txnString = byteArrayToBase64(txn.toByte());
+			if (isIndexMatch && canSignTxn) txnsToSign.push({ txn: txnString });
+			else txnsToSign.push({
+				txn: txnString,
+				signers: []
+			});
+		});
+		return txnsToSign;
+	}
+	processEncodedTxns(txnGroup, indexesToSign) {
+		const txnsToSign = [];
+		txnGroup.forEach((txnBuffer, index) => {
+			const isSigned = isSignedTxn(algosdk.msgpackRawDecode(txnBuffer));
+			const txn = isSigned ? algosdk.decodeSignedTransaction(txnBuffer).txn : algosdk.decodeUnsignedTransaction(txnBuffer);
+			const isIndexMatch = !indexesToSign || indexesToSign.includes(index);
+			const signer = txn.sender.toString();
+			const canSignTxn = !isSigned && this.addresses.includes(signer);
+			const txnString = byteArrayToBase64(txn.toByte());
+			if (isIndexMatch && canSignTxn) txnsToSign.push({ txn: txnString });
+			else txnsToSign.push({
+				txn: txnString,
+				signers: []
+			});
+		});
+		return txnsToSign;
+	}
+	signTransactions = async (txnGroup, indexesToSign) => {
+		try {
+			this.logger.debug("Signing transactions...", {
+				txnGroup,
+				indexesToSign
+			});
+			let txnsToSign = [];
+			if (isTransactionArray(txnGroup)) {
+				const flatTxns = flattenTxnGroup(txnGroup);
+				txnsToSign = this.processTxns(flatTxns, indexesToSign);
+			} else {
+				const flatTxns = flattenTxnGroup(txnGroup);
+				txnsToSign = this.processEncodedTxns(flatTxns, indexesToSign);
+			}
+			const client = this.client || await this.initializeClient();
+			this.logger.debug("Sending processed transactions to wallet...", txnsToSign);
+			const signTxnsResult = await client.signTxns(txnsToSign);
+			this.logger.debug("Received signed transactions from wallet", signTxnsResult);
+			const result = signTxnsResult.map((value) => {
+				if (value === null) return null;
+				return base64ToByteArray(value);
+			});
+			this.logger.debug("Transactions signed successfully", result);
+			return result;
+		} catch (error) {
+			this.logger.error("Error signing transactions:", error.message);
+			throw error;
+		}
+	};
+};
+//#endregion
+//#region src/index.ts
+const WALLET_ID = "w3wallet";
+function w3wallet() {
+	return {
+		id: WALLET_ID,
+		metadata: W3WalletAdapter.defaultMetadata,
+		Adapter: W3WalletAdapter,
+		capabilities: { supportedNetworks: ["mainnet"] }
+	};
+}
+//#endregion
+export { W3WalletAdapter, WALLET_ID, w3wallet };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/icon.ts","../src/adapter.ts","../src/index.ts"],"sourcesContent":["export const icon = `\n<svg width=\"860\" height=\"860\" viewBox=\"0 0 860 860\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n  <rect width=\"860\" height=\"860\" rx=\"30\" fill=\"#151923\"/>\n  <path d=\"M766 207L496.627 623.406C463.521 675.336 382.014 652.248 382.014 590.941V432.568L260.638 623.28C227.559 675.255 146 652.186 146 590.854V274.844H234.646V499.761L356.022 309.049C389.101 257.074 470.66 280.143 470.66 341.475V499.978L660.146 207L766 207Z\" fill=\"#4BB7D1\"/>\n</svg>\n`\n","import algosdk from 'algosdk'\nimport {\n  BaseWallet,\n  base64ToByteArray,\n  byteArrayToBase64,\n  flattenTxnGroup,\n  isSignedTxn,\n  isTransactionArray,\n  type AdapterConstructorParams,\n  type WalletAccount,\n  type WalletMetadata,\n  type WalletState,\n  type WalletTransaction\n} from '@txnlab/use-wallet/adapter'\n\nexport interface W3WalletProvider {\n  isConnected: () => Promise<boolean>\n  account: () => Promise<WalletAccount>\n  signTxns: (transactions: WalletTransaction[]) => Promise<(string | null)[]>\n}\n\ntype WindowExtended = { w3walletAlgorand: W3WalletProvider } & Window & typeof globalThis\n\nimport { icon } from './icon'\n\nconst ICON = `data:image/svg+xml;base64,${btoa(icon)}`\n\nexport class W3WalletAdapter extends BaseWallet {\n  private client: W3WalletProvider | null = null\n\n  constructor(params: AdapterConstructorParams) {\n    super(params)\n  }\n\n  static defaultMetadata: WalletMetadata = {\n    name: 'W3 Wallet',\n    icon: ICON\n  }\n\n  private async initializeClient(): Promise<W3WalletProvider> {\n    this.logger.info('Initializing client...')\n    if (\n      typeof window === 'undefined' ||\n      (window as WindowExtended).w3walletAlgorand === undefined\n    ) {\n      this.logger.error('W3 Wallet is not available.')\n      throw new Error('W3 Wallet is not available.')\n    }\n    const client = (window as WindowExtended).w3walletAlgorand\n    this.client = client\n    this.logger.info('Client initialized')\n    return client\n  }\n\n  public connect = async (): Promise<WalletAccount[]> => {\n    this.logger.info('Connecting...')\n    const client = this.client || (await this.initializeClient())\n\n    const activeAccount = await client.account()\n\n    const walletState: WalletState = {\n      accounts: [activeAccount],\n      activeAccount\n    }\n\n    this.store.addWallet(walletState)\n\n    this.logger.info('Connected successfully', walletState)\n    return [activeAccount]\n  }\n\n  public disconnect = async (): Promise<void> => {\n    this.logger.info('Disconnecting...')\n    this.onDisconnect()\n    this.logger.info('Disconnected')\n  }\n\n  public resumeSession = async (): Promise<void> => {\n    try {\n      const walletState = this.store.getWalletState()\n\n      // No session to resume\n      if (!walletState) {\n        this.logger.info('No session to resume')\n        return\n      }\n\n      this.logger.info('Resuming session...')\n      const client = await this.initializeClient()\n      const isConnected = await client.isConnected()\n\n      if (!isConnected) {\n        this.logger.error('W3 Wallet is not connected.')\n        throw new Error('W3 Wallet is not connected.')\n      }\n      this.logger.info('Session resumed')\n    } catch (error: any) {\n      this.logger.error('Error resuming session:', error.message)\n      this.onDisconnect()\n      throw error\n    }\n  }\n\n  private processTxns(\n    txnGroup: algosdk.Transaction[],\n    indexesToSign?: number[]\n  ): WalletTransaction[] {\n    const txnsToSign: WalletTransaction[] = []\n\n    txnGroup.forEach((txn, index) => {\n      const isIndexMatch = !indexesToSign || indexesToSign.includes(index)\n      const signer = txn.sender.toString()\n      const canSignTxn = this.addresses.includes(signer)\n\n      const txnString = byteArrayToBase64(txn.toByte())\n\n      if (isIndexMatch && canSignTxn) {\n        txnsToSign.push({ txn: txnString })\n      } else {\n        txnsToSign.push({ txn: txnString, signers: [] })\n      }\n    })\n\n    return txnsToSign\n  }\n\n  private processEncodedTxns(\n    txnGroup: Uint8Array[],\n    indexesToSign?: number[]\n  ): WalletTransaction[] {\n    const txnsToSign: WalletTransaction[] = []\n\n    txnGroup.forEach((txnBuffer, index) => {\n      const decodedObj = algosdk.msgpackRawDecode(txnBuffer)\n      const isSigned = isSignedTxn(decodedObj)\n\n      const txn: algosdk.Transaction = isSigned\n        ? algosdk.decodeSignedTransaction(txnBuffer).txn\n        : algosdk.decodeUnsignedTransaction(txnBuffer)\n\n      const isIndexMatch = !indexesToSign || indexesToSign.includes(index)\n      const signer = txn.sender.toString()\n      const canSignTxn = !isSigned && this.addresses.includes(signer)\n\n      const txnString = byteArrayToBase64(txn.toByte())\n\n      if (isIndexMatch && canSignTxn) {\n        txnsToSign.push({ txn: txnString })\n      } else {\n        txnsToSign.push({ txn: txnString, signers: [] })\n      }\n    })\n\n    return txnsToSign\n  }\n\n  public signTransactions = async <T extends algosdk.Transaction[] | Uint8Array[]>(\n    txnGroup: T | T[],\n    indexesToSign?: number[]\n  ): Promise<(Uint8Array | null)[]> => {\n    try {\n      this.logger.debug('Signing transactions...', { txnGroup, indexesToSign })\n      let txnsToSign: WalletTransaction[] = []\n\n      // Determine type and process transactions for signing\n      if (isTransactionArray(txnGroup)) {\n        const flatTxns: algosdk.Transaction[] = flattenTxnGroup(txnGroup)\n        txnsToSign = this.processTxns(flatTxns, indexesToSign)\n      } else {\n        const flatTxns: Uint8Array[] = flattenTxnGroup(txnGroup as Uint8Array[])\n        txnsToSign = this.processEncodedTxns(flatTxns, indexesToSign)\n      }\n\n      const client = this.client || (await this.initializeClient())\n\n      this.logger.debug('Sending processed transactions to wallet...', txnsToSign)\n\n      // Sign transactions\n      const signTxnsResult = await client.signTxns(txnsToSign)\n      this.logger.debug('Received signed transactions from wallet', signTxnsResult)\n\n      // Convert base64 to Uint8Array\n      const result = signTxnsResult.map((value) => {\n        if (value === null) {\n          return null\n        }\n        return base64ToByteArray(value)\n      })\n\n      this.logger.debug('Transactions signed successfully', result)\n      return result\n    } catch (error: any) {\n      this.logger.error('Error signing transactions:', error.message)\n      throw error\n    }\n  }\n}\n","import { W3WalletAdapter } from './adapter'\nimport type { WalletAdapterConfig } from '@txnlab/use-wallet'\n\nexport const WALLET_ID = 'w3wallet' as const\n\nexport function w3wallet(): WalletAdapterConfig {\n  return {\n    id: WALLET_ID,\n    metadata: W3WalletAdapter.defaultMetadata,\n    Adapter: W3WalletAdapter as unknown as WalletAdapterConfig['Adapter'],\n    capabilities: { supportedNetworks: ['mainnet'] }\n  }\n}\n\nexport { W3WalletAdapter }\nexport type { W3WalletProvider } from './adapter'\n"],"mappings":";;;;ACyBA,MAAM,OAAO,6BAA6B,KDzBtB;;;;;ECyBgC;AAEpD,IAAa,kBAAb,cAAqC,WAAW;CAC9C,SAA0C;CAE1C,YAAY,QAAkC;AAC5C,QAAM,OAAO;;CAGf,OAAO,kBAAkC;EACvC,MAAM;EACN,MAAM;EACP;CAED,MAAc,mBAA8C;AAC1D,OAAK,OAAO,KAAK,yBAAyB;AAC1C,MACE,OAAO,WAAW,eACjB,OAA0B,qBAAqB,KAAA,GAChD;AACA,QAAK,OAAO,MAAM,8BAA8B;AAChD,SAAM,IAAI,MAAM,8BAA8B;;EAEhD,MAAM,SAAU,OAA0B;AAC1C,OAAK,SAAS;AACd,OAAK,OAAO,KAAK,qBAAqB;AACtC,SAAO;;CAGT,UAAiB,YAAsC;AACrD,OAAK,OAAO,KAAK,gBAAgB;EAGjC,MAAM,gBAAgB,OAFP,KAAK,UAAW,MAAM,KAAK,kBAAkB,EAEzB,SAAS;EAE5C,MAAM,cAA2B;GAC/B,UAAU,CAAC,cAAc;GACzB;GACD;AAED,OAAK,MAAM,UAAU,YAAY;AAEjC,OAAK,OAAO,KAAK,0BAA0B,YAAY;AACvD,SAAO,CAAC,cAAc;;CAGxB,aAAoB,YAA2B;AAC7C,OAAK,OAAO,KAAK,mBAAmB;AACpC,OAAK,cAAc;AACnB,OAAK,OAAO,KAAK,eAAe;;CAGlC,gBAAuB,YAA2B;AAChD,MAAI;AAIF,OAAI,CAHgB,KAAK,MAAM,gBAAgB,EAG7B;AAChB,SAAK,OAAO,KAAK,uBAAuB;AACxC;;AAGF,QAAK,OAAO,KAAK,sBAAsB;AAIvC,OAAI,CAFgB,OADL,MAAM,KAAK,kBAAkB,EACX,aAAa,EAE5B;AAChB,SAAK,OAAO,MAAM,8BAA8B;AAChD,UAAM,IAAI,MAAM,8BAA8B;;AAEhD,QAAK,OAAO,KAAK,kBAAkB;WAC5B,OAAY;AACnB,QAAK,OAAO,MAAM,2BAA2B,MAAM,QAAQ;AAC3D,QAAK,cAAc;AACnB,SAAM;;;CAIV,YACE,UACA,eACqB;EACrB,MAAM,aAAkC,EAAE;AAE1C,WAAS,SAAS,KAAK,UAAU;GAC/B,MAAM,eAAe,CAAC,iBAAiB,cAAc,SAAS,MAAM;GACpE,MAAM,SAAS,IAAI,OAAO,UAAU;GACpC,MAAM,aAAa,KAAK,UAAU,SAAS,OAAO;GAElD,MAAM,YAAY,kBAAkB,IAAI,QAAQ,CAAC;AAEjD,OAAI,gBAAgB,WAClB,YAAW,KAAK,EAAE,KAAK,WAAW,CAAC;OAEnC,YAAW,KAAK;IAAE,KAAK;IAAW,SAAS,EAAE;IAAE,CAAC;IAElD;AAEF,SAAO;;CAGT,mBACE,UACA,eACqB;EACrB,MAAM,aAAkC,EAAE;AAE1C,WAAS,SAAS,WAAW,UAAU;GAErC,MAAM,WAAW,YADE,QAAQ,iBAAiB,UAAU,CACd;GAExC,MAAM,MAA2B,WAC7B,QAAQ,wBAAwB,UAAU,CAAC,MAC3C,QAAQ,0BAA0B,UAAU;GAEhD,MAAM,eAAe,CAAC,iBAAiB,cAAc,SAAS,MAAM;GACpE,MAAM,SAAS,IAAI,OAAO,UAAU;GACpC,MAAM,aAAa,CAAC,YAAY,KAAK,UAAU,SAAS,OAAO;GAE/D,MAAM,YAAY,kBAAkB,IAAI,QAAQ,CAAC;AAEjD,OAAI,gBAAgB,WAClB,YAAW,KAAK,EAAE,KAAK,WAAW,CAAC;OAEnC,YAAW,KAAK;IAAE,KAAK;IAAW,SAAS,EAAE;IAAE,CAAC;IAElD;AAEF,SAAO;;CAGT,mBAA0B,OACxB,UACA,kBACmC;AACnC,MAAI;AACF,QAAK,OAAO,MAAM,2BAA2B;IAAE;IAAU;IAAe,CAAC;GACzE,IAAI,aAAkC,EAAE;AAGxC,OAAI,mBAAmB,SAAS,EAAE;IAChC,MAAM,WAAkC,gBAAgB,SAAS;AACjE,iBAAa,KAAK,YAAY,UAAU,cAAc;UACjD;IACL,MAAM,WAAyB,gBAAgB,SAAyB;AACxE,iBAAa,KAAK,mBAAmB,UAAU,cAAc;;GAG/D,MAAM,SAAS,KAAK,UAAW,MAAM,KAAK,kBAAkB;AAE5D,QAAK,OAAO,MAAM,+CAA+C,WAAW;GAG5E,MAAM,iBAAiB,MAAM,OAAO,SAAS,WAAW;AACxD,QAAK,OAAO,MAAM,4CAA4C,eAAe;GAG7E,MAAM,SAAS,eAAe,KAAK,UAAU;AAC3C,QAAI,UAAU,KACZ,QAAO;AAET,WAAO,kBAAkB,MAAM;KAC/B;AAEF,QAAK,OAAO,MAAM,oCAAoC,OAAO;AAC7D,UAAO;WACA,OAAY;AACnB,QAAK,OAAO,MAAM,+BAA+B,MAAM,QAAQ;AAC/D,SAAM;;;;;;AC9LZ,MAAa,YAAY;AAEzB,SAAgB,WAAgC;AAC9C,QAAO;EACL,IAAI;EACJ,UAAU,gBAAgB;EAC1B,SAAS;EACT,cAAc,EAAE,mBAAmB,CAAC,UAAU,EAAE;EACjD"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@txnlab/use-wallet-w3wallet",
+  "version": "5.0.0-rc.1",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "description": "W3 Wallet adapter for @txnlab/use-wallet",
+  "author": "Doug Richar <drichar@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/txnlab/use-wallet.git",
+    "directory": "packages/wallets/w3wallet"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@txnlab/use-wallet": "^5.0.0",
+    "algosdk": "^3.0.0"
+  },
+  "devDependencies": {
+    "@txnlab/use-wallet": "5.0.0-rc.1",
+    "algosdk": "3.5.2",
+    "tsdown": "0.21.0",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "start": "tsdown --watch",
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "lint": "eslint \"src/**/*.{js,ts}\"",
+    "typecheck": "tsc --noEmit"
+  }
+}