@provablehq/aleo-wallet-adaptor-fox 0.1.1-alpha.0

package/dist/index.mjs

@@ -0,0 +1,314 @@
+// src/FoxWalletAdapter.ts
+import {
+  Network
+} from "@provablehq/aleo-types";
+import {
+  WalletDecryptPermission,
+  WalletReadyState
+} from "@provablehq/aleo-wallet-standard";
+import {
+  BaseAleoWalletAdapter,
+  MethodNotImplementedError,
+  WalletConnectionError,
+  WalletDecryptionError,
+  WalletDecryptionNotAllowedError,
+  WalletDisconnectionError,
+  WalletError,
+  WalletNotConnectedError,
+  WalletSignMessageError,
+  WalletTransactionError
+} from "@provablehq/aleo-wallet-adaptor-core";
+import {
+  LEO_NETWORK_MAP
+} from "@provablehq/aleo-wallet-adaptor-leo";
+var FoxWalletAdapter = class extends BaseAleoWalletAdapter {
+  /**
+   * Create a new Fox wallet adapter
+   * @param config Adapter configuration
+   */
+  constructor(config) {
+    super();
+    /**
+     * The wallet name
+     */
+    this.name = "Fox Wallet";
+    /**
+     * The wallet URL
+     */
+    this.url = "https://foxwallet.com/download";
+    /**
+     * The wallet icon (base64-encoded SVG)
+     */
+    this.icon = "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iOTAwIiBoZWlnaHQ9IjkwMCIgdmlld0JveD0iMCAwIDkwMCA5MDAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxyZWN0IHdpZHRoPSI5MDAiIGhlaWdodD0iOTAwIiByeD0iNDUwIiBmaWxsPSJibGFjayIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTU3Ny4yNDkgMjE1Ljk3NUM1MzkuOTU2IDE5Ni4yMzIgNTExLjY0NiAxNjEuNTQ5IDUwMC40NjggMTE5Ljg2OEM0OTcuMDIxIDEzMi42MTMgNDk1LjI0NSAxNDUuOTg0IDQ5NS4yNDUgMTU5Ljc3NEM0OTUuMjQ1IDE3MC41MzMgNDk2LjM5NCAxODAuOTggNDk4LjQ4MyAxOTEuMTEzQzQ5OC40ODMgMTkxLjExMyA0OTguNDgzIDE5MS4xMTMgNDk4LjQ4MyAxOTEuMjE3QzQ5OC40ODMgMTkxLjMyMiA0OTguNTg4IDE5MS41MzEgNDk4LjU4OCAxOTEuNjM1QzUwMS40MDggMjA1LjIxNiA1MDYuMDA1IDIxOC4wNjUgNTEyLjE2OCAyMjkuOTc0QzQ5OS4wMDYgMjIwLjI1OCA0ODcuMzA2IDIwOC42NjMgNDc3LjQ4NiAxOTUuNjA1QzQ2NC4zMjMgMjk3LjY2NyA1MDEuNDA4IDQwMy45MDcgNTY5LjIwNiA0NzMuODk4QzY1Ny42ODcgNTc2LjkgNTc2LjEgNzUxLjY2OSA0MzguMjA3IDc0Ny4wNzNDMjQzLjA2OCA3NDguNzQ0IDIwOS42MzkgNDYxLjM2MiAzOTYuODM5IDQxNi4yMzRMMzk2LjczNSA0MTUuNzExQzQ0Ni42NjkgMzk5LjUxOSA0NzAuMDY5IDM2Ny4wMzEgNDc0LjE0MyAzMjQuODI3QzQwMi4wNjMgMzgzLjIyMyAyODguMTk2IDMxMC44MjkgMzExLjgwNSAyMjAuMTU0QzQxLjI0MjUgMzUzLjM0NiAxNDEuNzM3IDc4NS40MTEgNDQ4LjQ0NSA3ODAuMDgzQzU4Mi4wNTUgNzgwLjA4MyA2OTUuMDg1IDY5MS43MDYgNzMyLjE3IDU3MC4yMTRDNzc2LjQ2MyA0MjguNTYxIDcwNC44IDI3Ny42MDkgNTc3LjI0OSAyMTUuOTc1WiIgZmlsbD0iIzEyRkU3NCIvPgo8L3N2Zz4K";
+    /**
+     * Current network
+     */
+    this.network = Network.MAINNET;
+    /**
+     * The wallet's decrypt permission
+     */
+    this.decryptPermission = WalletDecryptPermission.NoDecrypt;
+    /**
+     * Public key
+     */
+    this._publicKey = "";
+    this._readyState = typeof window === "undefined" || typeof document === "undefined" ? WalletReadyState.UNSUPPORTED : WalletReadyState.NOT_DETECTED;
+    console.debug("FoxWalletAdapter constructor", config);
+    this.network = Network.MAINNET;
+    this._checkAvailability();
+    this._foxWallet = this._window?.foxwallet?.aleo;
+    if (config?.isMobile) {
+      this.url = `https://app.leo.app/browser?url=${config.mobileWebviewUrl}`;
+    }
+  }
+  /**
+   * Check if Fox wallet is available
+   */
+  _checkAvailability() {
+    if (typeof window === "undefined" || typeof document === "undefined") {
+      this.readyState = WalletReadyState.UNSUPPORTED;
+      return;
+    }
+    this._window = window;
+    if (this._window.foxwallet?.aleo) {
+      this.readyState = WalletReadyState.INSTALLED;
+    } else {
+      const isMobile = /iPhone|iPad|iPod|Android/i.test(navigator.userAgent);
+      if (isMobile) {
+        this.readyState = WalletReadyState.LOADABLE;
+      }
+    }
+  }
+  /**
+   * Connect to Fox wallet
+   * @returns The connected account
+   */
+  async connect(network, decryptPermission, programs) {
+    try {
+      if (this.readyState !== WalletReadyState.INSTALLED) {
+        throw new WalletConnectionError("Fox Wallet is not available");
+      }
+      if (network !== Network.MAINNET) {
+        throw new WalletConnectionError("Fox Wallet only support mainnet");
+      }
+      try {
+        await this._foxWallet?.connect(decryptPermission, LEO_NETWORK_MAP[network], programs);
+        this.network = network;
+      } catch (error) {
+        if (error instanceof Object && "name" in error && (error.name === "InvalidParamsAleoWalletError" || error.name !== "NotGrantedAleoWalletError")) {
+          throw new WalletConnectionError(
+            "Connection failed: Likely due to a difference in configured network and the selected wallet network. Configured network: " + network
+          );
+        }
+        throw new WalletConnectionError(
+          error instanceof Error ? error.message : "Connection failed"
+        );
+      }
+      this._publicKey = this._foxWallet?.publicKey || "";
+      if (!this._publicKey) {
+        throw new WalletConnectionError("No address returned from wallet");
+      }
+      const account = {
+        address: this._publicKey
+      };
+      this.account = account;
+      this.decryptPermission = decryptPermission;
+      this.emit("connect", account);
+      return account;
+    } catch (err) {
+      this.emit("error", err instanceof Error ? err : new Error(String(err)));
+      throw new WalletConnectionError(err instanceof Error ? err.message : "Connection failed");
+    }
+  }
+  /**
+   * Disconnect from Fox wallet
+   */
+  async disconnect() {
+    try {
+      await this._foxWallet?.disconnect();
+      this._publicKey = "";
+      this.account = void 0;
+      this.emit("disconnect");
+    } catch (err) {
+      this.emit("error", err instanceof Error ? err : new Error(String(err)));
+      throw new WalletDisconnectionError(
+        err instanceof Error ? err.message : "Disconnection failed"
+      );
+    }
+  }
+  /**
+   * Sign a transaction with Fox wallet
+   * @param options Transaction options
+   * @returns The signed transaction
+   */
+  async signMessage(message) {
+    if (!this._publicKey || !this.account) {
+      throw new WalletNotConnectedError();
+    }
+    try {
+      const signature = await this._foxWallet?.signMessage(message);
+      if (!signature) {
+        throw new WalletSignMessageError("Failed to sign message");
+      }
+      return signature.signature;
+    } catch (error) {
+      throw new WalletSignMessageError(
+        error instanceof Error ? error.message : "Failed to sign message"
+      );
+    }
+  }
+  async decrypt(cipherText, tpk, programId, functionName, index) {
+    if (!this._foxWallet || !this._publicKey) {
+      throw new WalletNotConnectedError();
+    }
+    switch (this.decryptPermission) {
+      case WalletDecryptPermission.NoDecrypt:
+        throw new WalletDecryptionNotAllowedError();
+      case WalletDecryptPermission.UponRequest:
+      case WalletDecryptPermission.AutoDecrypt:
+      case WalletDecryptPermission.OnChainHistory: {
+        try {
+          const result = await this._foxWallet.decrypt(
+            cipherText,
+            tpk,
+            programId,
+            functionName,
+            index
+          );
+          return result.text;
+        } catch (error) {
+          throw new WalletDecryptionError(
+            error instanceof Error ? error.message : "Failed to decrypt"
+          );
+        }
+      }
+      default:
+        throw new WalletDecryptionError();
+    }
+  }
+  /**
+   * Execute a transaction with Fox wallet
+   * @param options Transaction options
+   * @returns The executed temporary transaction ID
+   */
+  async executeTransaction(options) {
+    if (!this._publicKey || !this.account) {
+      throw new WalletNotConnectedError();
+    }
+    try {
+      const requestData = {
+        address: this._publicKey,
+        chainId: LEO_NETWORK_MAP[this.network],
+        fee: options.fee ? options.fee : 1e-3,
+        feePrivate: options.privateFee ?? false,
+        transitions: [
+          {
+            program: options.program,
+            functionName: options.function,
+            inputs: options.inputs
+          }
+        ]
+      };
+      const result = await this._foxWallet?.requestTransaction(requestData);
+      if (!result?.transactionId) {
+        throw new WalletTransactionError("Could not create transaction");
+      }
+      return {
+        transactionId: result.transactionId
+      };
+    } catch (error) {
+      console.error("Fox Wallet executeTransaction error", error);
+      if (error instanceof WalletError) {
+        throw error;
+      }
+      throw new WalletTransactionError(
+        error instanceof Error ? error.message : "Failed to execute transaction"
+      );
+    }
+  }
+  /**
+   * Get transaction status
+   * @param transactionId The transaction ID
+   * @returns The transaction status
+   */
+  async transactionStatus(transactionId) {
+    if (!this._publicKey || !this.account) {
+      throw new WalletNotConnectedError();
+    }
+    try {
+      const result = await this._foxWallet?.transactionStatus(transactionId);
+      if (!result?.status) {
+        throw new WalletTransactionError("Could not get transaction status");
+      }
+      return {
+        status: result.status
+      };
+    } catch (error) {
+      throw new WalletTransactionError(
+        error instanceof Error ? error.message : "Failed to get transaction status"
+      );
+    }
+  }
+  /**
+   * Request records from Fox wallet
+   * @param program The program to request records from
+   * @param includePlaintext Whether to include plaintext on each record
+   * @returns The records
+   */
+  async requestRecords(program, includePlaintext) {
+    if (!this._publicKey || !this.account) {
+      throw new WalletNotConnectedError();
+    }
+    try {
+      const result = includePlaintext ? await this._foxWallet?.requestRecordPlaintexts(program) : await this._foxWallet?.requestRecords(program);
+      return result?.records || [];
+    } catch (error) {
+      throw new WalletError(error instanceof Error ? error.message : "Failed to request records");
+    }
+  }
+  /**
+   * Switch the network
+   * @param network The network to switch to
+   */
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  async switchNetwork(_network) {
+    console.error("Fox Wallet does not support switching networks");
+    throw new MethodNotImplementedError("switchNetwork");
+  }
+  /**
+   * Execute a deployment
+   * @param deployment The deployment to execute
+   * @returns The executed transaction ID
+   */
+  async executeDeployment(deployment) {
+    try {
+      if (!this._foxWallet || !this._publicKey)
+        throw new WalletNotConnectedError();
+      try {
+        const result = await this._foxWallet?.requestDeploy({
+          address: this._publicKey,
+          chainId: LEO_NETWORK_MAP[this.network],
+          program: deployment.program,
+          fee: deployment.fee,
+          feePrivate: deployment.feePrivate
+        });
+        if (!result?.transactionId) {
+          throw new WalletTransactionError("Could not create deployment");
+        }
+        return {
+          transactionId: result.transactionId
+        };
+      } catch (error) {
+        throw new WalletTransactionError(
+          error instanceof Error ? error.message : "Failed to execute deployment"
+        );
+      }
+    } catch (error) {
+      this.emit("error", error instanceof Error ? error : new Error(String(error)));
+      throw error;
+    }
+  }
+};
+export {
+  FoxWalletAdapter
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@provablehq/aleo-wallet-adaptor-fox",
+  "version": "0.1.1-alpha.0",
+  "description": "Fox wallet adapter for Aleo",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "license": "GPL-3.0-or-later",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@provablehq/aleo-types": "0.1.1-alpha.0",
+    "@provablehq/aleo-wallet-adaptor-core": "0.1.1-alpha.0",
+    "@provablehq/aleo-wallet-adaptor-leo": "0.1.1-alpha.0",
+    "@provablehq/aleo-wallet-standard": "0.1.1-alpha.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ProvableHQ/aleo-dev-toolkit.git",
+    "directory": "packages/aleo-wallet-adaptor/wallets/fox"
+  },
+  "homepage": "https://provable.com/",
+  "keywords": [
+    "aleo",
+    "wallet",
+    "adapter",
+    "fox"
+  ],
+  "author": "Provable Labs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.5",
+    "tsup": "^7.0.0",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch"
+  }
+}