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

package/README.md

@@ -0,0 +1,31 @@
+# @provablehq/aleo-wallet-adaptor-leo
+
+Adapter that maps Leo wallet functionality onto the Aleo wallet adaptor contract.
+
+## When to use it
+
+- Allow users of the Leo wallet to connect, sign, decrypt, and execute transactions in your Aleo app.
+- Pair Leo with other adapters in a single wallet list without branching your app logic.
+- Prototype Leo-specific functionality while keeping the rest of your integration untouched.
+
+## Installation
+
+```bash
+pnpm add @provablehq/aleo-wallet-adaptor-leo
+```
+
+## Usage
+
+```tsx
+import { LeoWalletAdapter } from '@provablehq/aleo-wallet-adaptor-leo';
+
+const wallets = [new LeoWalletAdapter()];
+```
+
+## Related packages
+
+- `@provablehq/aleo-wallet-adaptor-core` – shared adapter base implementation.
+- `@provablehq/aleo-wallet-adaptor-react` – provider that surface Leo in React apps.
+- Other wallet adapters (`-prove-alpha`, `-puzzle`, `-fox`, etc.) that can coexist with Leo.
+
+Live demo: https://aleo-dev-toolkit-react-app.vercel.app/

package/dist/index.d.mts

@@ -0,0 +1,219 @@
+import { Network, Account, TransactionOptions, TransactionStatusResponse } from '@provablehq/aleo-types';
+import { EventEmitter, WalletDecryptPermission, WalletName, WalletReadyState, AleoDeployment as AleoDeployment$1 } from '@provablehq/aleo-wallet-standard';
+import { BaseAleoWalletAdapter } from '@provablehq/aleo-wallet-adaptor-core';
+
+/**
+ * Leo wallet adapter configuration
+ */
+interface LeoWalletAdapterConfig {
+    /**
+     * Application name
+     */
+    appName?: string;
+    /**
+     * Application icon URL
+     */
+    appIconUrl?: string;
+    /**
+     * Application description
+     */
+    appDescription?: string;
+    /**
+     * Program ID permissions by network
+     */
+    programIdPermissions?: Record<string, string[]>;
+    /**
+     * Whether the wallet is mobile
+     */
+    isMobile?: boolean;
+    /**
+     * The mobile webview URL
+     */
+    mobileWebviewUrl?: string;
+}
+interface LeoWalletEvents {
+    connect(...args: unknown[]): unknown;
+    disconnect(...args: unknown[]): unknown;
+    accountChange(...args: unknown[]): unknown;
+}
+type LeoNetwork = 'mainnet' | 'testnetbeta';
+declare const LEO_NETWORK_MAP: Record<Network, LeoNetwork>;
+interface LeoWallet extends EventEmitter<LeoWalletEvents> {
+    publicKey?: string;
+    isAvailable(): Promise<boolean>;
+    signMessage(message: Uint8Array): Promise<{
+        signature: Uint8Array;
+    }>;
+    decrypt(cipherText: string, tpk?: string, programId?: string, functionName?: string, index?: number): Promise<{
+        text: string;
+    }>;
+    requestRecords(program: string): Promise<{
+        records: unknown[];
+    }>;
+    requestTransaction(transaction: AleoTransaction): Promise<{
+        transactionId?: string;
+    }>;
+    requestExecution(transaction: AleoTransaction): Promise<{
+        transactionId?: string;
+    }>;
+    requestBulkTransactions(transactions: AleoTransaction[]): Promise<{
+        transactionIds?: string[];
+    }>;
+    requestDeploy(deployment: AleoDeployment): Promise<{
+        transactionId?: string;
+    }>;
+    transactionStatus(transactionId: string): Promise<{
+        status: string;
+    }>;
+    transitionViewKeys(transactionId: string): Promise<{
+        viewKeys?: string[];
+    }>;
+    getExecution(transactionId: string): Promise<{
+        execution: string;
+    }>;
+    requestRecordPlaintexts(program: string): Promise<{
+        records: unknown[];
+    }>;
+    requestTransactionHistory(program: string): Promise<{
+        transactions: unknown[];
+    }>;
+    connect(decryptPermission: WalletDecryptPermission, network: LeoNetwork, programs?: string[]): Promise<void>;
+    disconnect(): Promise<void>;
+}
+interface LeoWindow extends Window {
+    leoWallet?: LeoWallet;
+    leo?: LeoWallet;
+}
+interface AleoTransaction {
+    address: string;
+    chainId: string;
+    transitions: AleoTransition[];
+    fee: number;
+    feePrivate: boolean;
+}
+interface AleoTransition {
+    program: string;
+    functionName: string;
+    inputs: unknown[];
+}
+declare class Transition implements AleoTransition {
+    program: string;
+    functionName: string;
+    inputs: unknown[];
+    constructor(program: string, functionName: string, inputs: unknown[]);
+}
+interface AleoDeployment {
+    address: string;
+    chainId: string;
+    program: string;
+    fee: number;
+    feePrivate: boolean;
+}
+declare class Deployment implements AleoDeployment {
+    address: string;
+    chainId: string;
+    program: string;
+    fee: number;
+    feePrivate: boolean;
+    constructor(address: string, chainId: string, program: string, fee: number, feePrivate?: boolean);
+}
+
+/**
+ * Leo wallet adapter
+ */
+declare class LeoWalletAdapter extends BaseAleoWalletAdapter {
+    /**
+     * The wallet name
+     */
+    readonly name: WalletName<"Leo Wallet">;
+    /**
+     * The wallet URL
+     */
+    url: string;
+    /**
+     * The wallet icon (base64-encoded SVG)
+     */
+    readonly icon = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFwAAABcCAMAAADUMSJqAAAASFBMVEVjTP////9kTf9GIP/5+P9dRP+ajf9WO//Jwv9fR/9KJv+Ccf9ZP//08/+Xiv9aQf+upf/c2P+Qgf96aP9TNv/Nx/+Fdf+6sv91nL8+AAABCUlEQVRoge2YyQ6EIBBEccVWBHf//09H42FESNRJk+ik3s06vANCQ0oIAAAAf0ps48u8XHKXiYVZsyE5pbxgj8s63RPpTAhZROkZ9QV7nKSRRb7JT0kTyCGHHPInyceAcppyBz0zyQVlDlJzyT1k+XvkZKQ0FEROqmqKoqkU8ctV327fba+45ar7Jp3ilVO/j3pilat2H7WKU06VnVXEKDeNnTWGUX6cioV8izzosgT9ocetuKzKWw5R0OMfdnAtKyPDjVwR9LI48ny5lu6zgm0rztp9EE1cJ9THyDW4fLBNRcghhxxyDvmh+vOxybVdB16p/pzS0sewesz90vJGtfpD3QoAAOCNfADu9hzTpMe3fQAAAABJRU5ErkJggg==";
+    /**
+     * The window object
+     */
+    private _window;
+    /**
+     * Current network
+     */
+    network: Network;
+    /**
+     * The wallet's decrypt permission
+     */
+    decryptPermission: WalletDecryptPermission;
+    /**
+     * Public key
+     */
+    private _publicKey;
+    _readyState: WalletReadyState;
+    /**
+     * Leo wallet instance
+     */
+    private _leoWallet;
+    /**
+     * Create a new Leo wallet adapter
+     * @param config Adapter configuration
+     */
+    constructor(config?: LeoWalletAdapterConfig);
+    /**
+     * Check if Leo wallet is available
+     */
+    private _checkAvailability;
+    /**
+     * Connect to Leo wallet
+     * @returns The connected account
+     */
+    connect(network: Network, decryptPermission: WalletDecryptPermission, programs?: string[]): Promise<Account>;
+    /**
+     * Disconnect from Leo wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Sign a transaction with Leo wallet
+     * @param options Transaction options
+     * @returns The signed transaction
+     */
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+    decrypt(cipherText: string, tpk?: string, programId?: string, functionName?: string, index?: number): Promise<string>;
+    /**
+     * Execute a transaction with Leo wallet
+     * @param options Transaction options
+     * @returns The executed temporary transaction ID
+     */
+    executeTransaction(options: TransactionOptions): Promise<{
+        transactionId: string;
+    }>;
+    /**
+     * Get transaction status
+     * @param transactionId The transaction ID
+     * @returns The transaction status
+     */
+    transactionStatus(transactionId: string): Promise<TransactionStatusResponse>;
+    /**
+     * Request records from Leo wallet
+     * @param program The program to request records from
+     * @param includePlaintext Whether to include plaintext on each record
+     * @returns The records
+     */
+    requestRecords(program: string, includePlaintext: boolean): Promise<unknown[]>;
+    /**
+     * Switch the network
+     * @param network The network to switch to
+     */
+    switchNetwork(_network: Network): Promise<void>;
+    /**
+     * Execute a deployment
+     * @param deployment The deployment to execute
+     * @returns The executed transaction ID
+     */
+    executeDeployment(deployment: AleoDeployment$1): Promise<{
+        transactionId: string;
+    }>;
+}
+
+export { type AleoDeployment, type AleoTransaction, type AleoTransition, Deployment, LEO_NETWORK_MAP, type LeoNetwork, type LeoWallet, LeoWalletAdapter, type LeoWalletAdapterConfig, type LeoWalletEvents, type LeoWindow, Transition };

package/dist/index.d.ts

@@ -0,0 +1,219 @@
+import { Network, Account, TransactionOptions, TransactionStatusResponse } from '@provablehq/aleo-types';
+import { EventEmitter, WalletDecryptPermission, WalletName, WalletReadyState, AleoDeployment as AleoDeployment$1 } from '@provablehq/aleo-wallet-standard';
+import { BaseAleoWalletAdapter } from '@provablehq/aleo-wallet-adaptor-core';
+
+/**
+ * Leo wallet adapter configuration
+ */
+interface LeoWalletAdapterConfig {
+    /**
+     * Application name
+     */
+    appName?: string;
+    /**
+     * Application icon URL
+     */
+    appIconUrl?: string;
+    /**
+     * Application description
+     */
+    appDescription?: string;
+    /**
+     * Program ID permissions by network
+     */
+    programIdPermissions?: Record<string, string[]>;
+    /**
+     * Whether the wallet is mobile
+     */
+    isMobile?: boolean;
+    /**
+     * The mobile webview URL
+     */
+    mobileWebviewUrl?: string;
+}
+interface LeoWalletEvents {
+    connect(...args: unknown[]): unknown;
+    disconnect(...args: unknown[]): unknown;
+    accountChange(...args: unknown[]): unknown;
+}
+type LeoNetwork = 'mainnet' | 'testnetbeta';
+declare const LEO_NETWORK_MAP: Record<Network, LeoNetwork>;
+interface LeoWallet extends EventEmitter<LeoWalletEvents> {
+    publicKey?: string;
+    isAvailable(): Promise<boolean>;
+    signMessage(message: Uint8Array): Promise<{
+        signature: Uint8Array;
+    }>;
+    decrypt(cipherText: string, tpk?: string, programId?: string, functionName?: string, index?: number): Promise<{
+        text: string;
+    }>;
+    requestRecords(program: string): Promise<{
+        records: unknown[];
+    }>;
+    requestTransaction(transaction: AleoTransaction): Promise<{
+        transactionId?: string;
+    }>;
+    requestExecution(transaction: AleoTransaction): Promise<{
+        transactionId?: string;
+    }>;
+    requestBulkTransactions(transactions: AleoTransaction[]): Promise<{
+        transactionIds?: string[];
+    }>;
+    requestDeploy(deployment: AleoDeployment): Promise<{
+        transactionId?: string;
+    }>;
+    transactionStatus(transactionId: string): Promise<{
+        status: string;
+    }>;
+    transitionViewKeys(transactionId: string): Promise<{
+        viewKeys?: string[];
+    }>;
+    getExecution(transactionId: string): Promise<{
+        execution: string;
+    }>;
+    requestRecordPlaintexts(program: string): Promise<{
+        records: unknown[];
+    }>;
+    requestTransactionHistory(program: string): Promise<{
+        transactions: unknown[];
+    }>;
+    connect(decryptPermission: WalletDecryptPermission, network: LeoNetwork, programs?: string[]): Promise<void>;
+    disconnect(): Promise<void>;
+}
+interface LeoWindow extends Window {
+    leoWallet?: LeoWallet;
+    leo?: LeoWallet;
+}
+interface AleoTransaction {
+    address: string;
+    chainId: string;
+    transitions: AleoTransition[];
+    fee: number;
+    feePrivate: boolean;
+}
+interface AleoTransition {
+    program: string;
+    functionName: string;
+    inputs: unknown[];
+}
+declare class Transition implements AleoTransition {
+    program: string;
+    functionName: string;
+    inputs: unknown[];
+    constructor(program: string, functionName: string, inputs: unknown[]);
+}
+interface AleoDeployment {
+    address: string;
+    chainId: string;
+    program: string;
+    fee: number;
+    feePrivate: boolean;
+}
+declare class Deployment implements AleoDeployment {
+    address: string;
+    chainId: string;
+    program: string;
+    fee: number;
+    feePrivate: boolean;
+    constructor(address: string, chainId: string, program: string, fee: number, feePrivate?: boolean);
+}
+
+/**
+ * Leo wallet adapter
+ */
+declare class LeoWalletAdapter extends BaseAleoWalletAdapter {
+    /**
+     * The wallet name
+     */
+    readonly name: WalletName<"Leo Wallet">;
+    /**
+     * The wallet URL
+     */
+    url: string;
+    /**
+     * The wallet icon (base64-encoded SVG)
+     */
+    readonly icon = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFwAAABcCAMAAADUMSJqAAAASFBMVEVjTP////9kTf9GIP/5+P9dRP+ajf9WO//Jwv9fR/9KJv+Ccf9ZP//08/+Xiv9aQf+upf/c2P+Qgf96aP9TNv/Nx/+Fdf+6sv91nL8+AAABCUlEQVRoge2YyQ6EIBBEccVWBHf//09H42FESNRJk+ik3s06vANCQ0oIAAAAf0ps48u8XHKXiYVZsyE5pbxgj8s63RPpTAhZROkZ9QV7nKSRRb7JT0kTyCGHHPInyceAcppyBz0zyQVlDlJzyT1k+XvkZKQ0FEROqmqKoqkU8ctV327fba+45ar7Jp3ilVO/j3pilat2H7WKU06VnVXEKDeNnTWGUX6cioV8izzosgT9ocetuKzKWw5R0OMfdnAtKyPDjVwR9LI48ny5lu6zgm0rztp9EE1cJ9THyDW4fLBNRcghhxxyDvmh+vOxybVdB16p/pzS0sewesz90vJGtfpD3QoAAOCNfADu9hzTpMe3fQAAAABJRU5ErkJggg==";
+    /**
+     * The window object
+     */
+    private _window;
+    /**
+     * Current network
+     */
+    network: Network;
+    /**
+     * The wallet's decrypt permission
+     */
+    decryptPermission: WalletDecryptPermission;
+    /**
+     * Public key
+     */
+    private _publicKey;
+    _readyState: WalletReadyState;
+    /**
+     * Leo wallet instance
+     */
+    private _leoWallet;
+    /**
+     * Create a new Leo wallet adapter
+     * @param config Adapter configuration
+     */
+    constructor(config?: LeoWalletAdapterConfig);
+    /**
+     * Check if Leo wallet is available
+     */
+    private _checkAvailability;
+    /**
+     * Connect to Leo wallet
+     * @returns The connected account
+     */
+    connect(network: Network, decryptPermission: WalletDecryptPermission, programs?: string[]): Promise<Account>;
+    /**
+     * Disconnect from Leo wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Sign a transaction with Leo wallet
+     * @param options Transaction options
+     * @returns The signed transaction
+     */
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+    decrypt(cipherText: string, tpk?: string, programId?: string, functionName?: string, index?: number): Promise<string>;
+    /**
+     * Execute a transaction with Leo wallet
+     * @param options Transaction options
+     * @returns The executed temporary transaction ID
+     */
+    executeTransaction(options: TransactionOptions): Promise<{
+        transactionId: string;
+    }>;
+    /**
+     * Get transaction status
+     * @param transactionId The transaction ID
+     * @returns The transaction status
+     */
+    transactionStatus(transactionId: string): Promise<TransactionStatusResponse>;
+    /**
+     * Request records from Leo wallet
+     * @param program The program to request records from
+     * @param includePlaintext Whether to include plaintext on each record
+     * @returns The records
+     */
+    requestRecords(program: string, includePlaintext: boolean): Promise<unknown[]>;
+    /**
+     * Switch the network
+     * @param network The network to switch to
+     */
+    switchNetwork(_network: Network): Promise<void>;
+    /**
+     * Execute a deployment
+     * @param deployment The deployment to execute
+     * @returns The executed transaction ID
+     */
+    executeDeployment(deployment: AleoDeployment$1): Promise<{
+        transactionId: string;
+    }>;
+}
+
+export { type AleoDeployment, type AleoTransaction, type AleoTransition, Deployment, LEO_NETWORK_MAP, type LeoNetwork, type LeoWallet, LeoWalletAdapter, type LeoWalletAdapterConfig, type LeoWalletEvents, type LeoWindow, Transition };