✨ Introduce hyli-wallet script to register accounts from node cli (#36)

* ✨ wallet-script

* ✨ Instroduce hyli-wallet script to register accounts from node cli

* update deps

* Update default ports

* prepare script for publish

* print wallet api url

* fix installed script

* fix config example

* fix example

Author: BertrandD

README.md

@@ -40,3 +40,21 @@ from server's Cargo.toml and build the contracts using:
 ```bash
 cargo build -p contracts --features build --features all
 ```
+
+## Scripts
+
+For wallet account registration and management, see the [`script/`](./script/) folder which contains:
+
+- **Wallet Registration Script**: A standalone Node.js script for registering wallet accounts
+- **Examples**: Usage examples and batch registration scripts
+- **Configuration**: Environment-specific configuration templates
+
+### Quick Script Usage
+
+```bash
+cd script
+npm install
+node hyli-wallet.js <username> <password> <inviteCode>
+```
+
+For detailed documentation, see [script/README.md](./script/README.md).

script/.gitignore

@@ -0,0 +1 @@
+node_modules

script/README.md

@@ -0,0 +1,132 @@
+# Hyli Wallet CLI
+
+A standalone command-line tool for managing Hyli wallet accounts.
+
+## 🚀 Quick Start
+
+### Option 1: Install from NPM (Recommended)
+
+```bash
+# Install globally
+npm install -g hyli-wallet-cli
+
+# Use the command
+hyli-wallet --help
+```
+
+### Option 2: Install from Source
+
+```bash
+# Clone just this package
+git clone https://github.com/hyli-org/wallet.git
+cd wallet/script
+
+# Install dependencies
+npm install
+
+# Make it globally available
+npm link
+
+# Use the command
+hyli-wallet --help
+```
+
+## 📖 Usage
+
+```bash
+hyli-wallet <username> <password> <inviteCode> [salt] [enableSessionKey]
+```
+
+### Arguments
+
+- **username** - The username for the account
+- **password** - The password (must be at least 8 characters)
+- **inviteCode** - The invite code to use
+- **salt** - Optional salt (defaults to random string)
+- **enableSessionKey** - Optional: 'true' to enable session key (default: false)
+
+### Environment Variables
+
+- `NODE_BASE_URL` - Node service URL (default: http://localhost:4321)
+- `INDEXER_BASE_URL` - Indexer service URL (default: http://localhost:4322)
+- `WALLET_API_BASE_URL` - Wallet API URL (default: http://localhost:4000)
+
+### Examples
+
+```bash
+# Basic registration
+hyli-wallet myuser mypassword123 INVITE123
+
+# With custom salt
+hyli-wallet myuser mypassword123 INVITE123 mysalt
+
+# With session key enabled
+hyli-wallet myuser mypassword123 INVITE123 mysalt true
+
+# With custom service URLs
+NODE_BASE_URL=http://localhost:4321 \
+INDEXER_BASE_URL=http://localhost:4322 \
+hyli-wallet myuser mypassword123 INVITE123
+```
+
+## 🔧 Configuration
+
+The script automatically detects your environment and uses sensible defaults. You can override these by setting environment variables:
+
+```bash
+export NODE_BASE_URL="http://your-node:4321"
+export INDEXER_BASE_URL="http://your-indexer:4322"
+export WALLET_API_BASE_URL="http://your-wallet-api:4000"
+```
+
+## 📦 What's Included
+
+This standalone package includes:
+
+- ✅ Complete wallet registration functionality
+- ✅ Session key generation
+- ✅ Invite code validation
+- ✅ Blob transaction handling
+- ✅ Proof transaction generation
+
+## 🛠️ Development
+
+### Prerequisites
+
+- Node.js 16.0.0 or higher
+- npm or yarn
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://github.com/hyli/wallet.git
+cd wallet/script
+
+# Install dependencies
+bun install
+
+# Run the script
+bun register myuser mypassword123 INVITE123
+```
+
+### Building for Distribution
+
+```bash
+# Publish to NPM (if you have access)
+bun run pub
+```
+
+## 🐛 Troubleshooting
+
+## 📄 License
+
+MIT License
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see the [contributing guide](https://github.com/hyli-org/hyli/blob/main/CONTRIBUTING.md) for details.
+
+---
+
+**Made with ❤️ by the Hyli Team**

script/bun.lockb

@@ -0,0 +1,88 @@
+// Configuration template for the wallet registration script
+// Copy this file to config.js and update the values
+
+export const CONFIG = {
+    // Hyli Node Service URL
+    NODE_BASE_URL: process.env.NODE_BASE_URL || "http://localhost:4321",
+    
+    // Hyli Indexer Service URL  
+    INDEXER_BASE_URL: process.env.INDEXER_BASE_URL || "http://localhost:4322",
+    
+    // Wallet Contract Name
+    WALLET_CONTRACT_NAME: "wallet",
+    
+    // Default session key duration (24 hours in milliseconds)
+    DEFAULT_SESSION_KEY_DURATION: 24 * 60 * 60 * 1000,
+    
+    // Default whitelist for session keys (empty array means no restrictions)
+    DEFAULT_SESSION_KEY_WHITELIST: [],
+    
+    // Timeout for operations (in milliseconds)
+    OPERATION_TIMEOUT: 60000,
+    
+    // Retry configuration
+    RETRY_CONFIG: {
+        maxRetries: 3,
+        retryDelay: 1000, // 1 second
+        backoffMultiplier: 2
+    },
+    
+    // Logging configuration
+    LOGGING: {
+        level: "info", // debug, info, warn, error
+        enableConsole: true,
+        enableFile: false,
+        logFile: "registration.log"
+    }
+};
+
+// Environment-specific configurations
+export const ENV_CONFIGS = {
+    local: {
+        NODE_BASE_URL: "http://localhost:4321",
+        INDEXER_BASE_URL: "http://localhost:4322",
+        WALLET_API_BASE_URL: "http://localhost:4000",
+        LOGGING: { level: "debug" }
+    },
+    
+    devnet: {
+        NODE_BASE_URL: "https://node.devnet.hyli.org",
+        INDEXER_BASE_URL: "https://indexer.devnet.hyli.org",
+        WALLET_API_BASE_URL: "https://wallet.devnet.hyli.org",
+        LOGGING: { level: "info" }
+    },
+    
+    testnet: {
+        NODE_BASE_URL: "https://node.testnet.hyli.org",
+        INDEXER_BASE_URL: "https://indexer.testnet.hyli.org",
+        WALLET_API_BASE_URL: "https://wallet.testnet.hyli.org",
+        LOGGING: { level: "warn" }
+    }
+};
+
+// Helper function to get configuration based on environment
+export function getConfig(environment = process.env.NODE_ENV || "local") {
+    const envConfig = ENV_CONFIGS[environment] || {};
+    return { ...CONFIG, ...envConfig };
+}
+
+// Helper function to validate configuration
+export function validateConfig(config) {
+    const required = ['NODE_BASE_URL', 'INDEXER_BASE_URL', 'WALLET_CONTRACT_NAME', 'WALLET_API_BASE_URL'];
+    const missing = required.filter(key => !config[key]);
+    
+    if (missing.length > 0) {
+        throw new Error(`Missing required configuration: ${missing.join(', ')}`);
+    }
+    
+    // Validate URLs
+    try {
+        new URL(config.NODE_BASE_URL);
+        new URL(config.INDEXER_BASE_URL);
+        new URL(config.WALLET_API_BASE_URL);
+    } catch (error) {
+        throw new Error(`Invalid URL in configuration: ${error.message}`);
+    }
+    
+    return true;
+}

script/config.example.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+
+import { registerAccount } from './hyli-wallet.js';
+
+// Example of using the registration function programmatically
+async function exampleUsage() {
+    console.log("=== Example: Programmatic Account Registration ===\n");
+    
+    // Configuration
+    const config = {
+        username: "testuser",
+        password: "mypassword123",
+        inviteCode: "INVITE123",
+        salt: "customsalt",
+        enableSessionKey: true
+    };
+    
+    console.log("Configuration:", config);
+    console.log("");
+    
+    try {
+        // Register the account
+        const result = await registerAccount(
+            config.username,
+            config.password,
+            config.inviteCode,
+            config.salt,
+            config.enableSessionKey
+        );
+        
+        if (result.success) {
+            console.log("✅ Registration successful!");
+            console.log("Wallet details:", JSON.stringify(result.wallet, null, 2));
+            
+            // You can now use the wallet object for other operations
+            console.log(`\nAccount address: ${result.wallet.address}`);
+            if (result.wallet.sessionKey) {
+                console.log(`Session key public: ${result.wallet.sessionKey.publicKey}`);
+                console.log(`Session key expires: ${new Date(result.wallet.sessionKey.expiration).toISOString()}`);
+            }
+        } else {
+            console.log("❌ Registration failed:", result.error);
+        }
+        
+    } catch (error) {
+        console.error("Error during registration:", error);
+    }
+}
+
+// Example of batch registration
+async function batchRegistration() {
+    console.log("\n=== Example: Batch Registration ===\n");
+    
+    const users = [
+        { username: "alice", password: "alicepass123", inviteCode: "INVITE001" },
+        { username: "bob", password: "bobpass123", inviteCode: "INVITE002" },
+        { username: "charlie", password: "charliepass123", inviteCode: "INVITE003" }
+    ];
+    
+    for (const user of users) {
+        console.log(`Registering user: ${user.username}`);
+        
+        try {
+            const result = await registerAccount(
+                user.username,
+                user.password,
+                user.inviteCode,
+                undefined, // Use random salt
+                false // No session key
+            );
+            
+            if (result.success) {
+                console.log(`✅ ${user.username} registered successfully`);
+            } else {
+                console.log(`❌ ${user.username} failed: ${result.error}`);
+            }
+            
+        } catch (error) {
+            console.log(`❌ ${user.username} error: ${error.message}`);
+        }
+        
+        console.log("---");
+    }
+}
+
+// Example of error handling
+async function errorHandlingExample() {
+    console.log("\n=== Example: Error Handling ===\n");
+    
+    // Test with invalid password
+    try {
+        const result = await registerAccount(
+            "testuser",
+            "123", // Too short
+            "INVITE123"
+        );
+        
+        console.log("Result:", result);
+        
+    } catch (error) {
+        console.log("Caught error:", error.message);
+    }
+    
+    // Test with missing parameters
+    try {
+        const result = await registerAccount(
+            "testuser",
+            "", // Empty password
+            "INVITE123"
+        );
+        
+        console.log("Result:", result);
+        
+    } catch (error) {
+        console.log("Caught error:", error.message);
+    }
+}
+
+// Run examples
+async function runExamples() {
+    // Set environment variables for the examples
+    process.env.NODE_BASE_URL = "http://localhost:4321";
+    process.env.INDEXER_BASE_URL = "http://localhost:4322";
+    process.env.WALLET_API_BASE_URL = "http://localhost:4000";
+    
+    await exampleUsage();
+    await batchRegistration();
+    await errorHandlingExample();
+    
+    console.log("\n=== Examples completed ===");
+}
+
+// Run if this file is executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runExamples().catch(error => {
+        console.error("Example execution failed:", error);
+        process.exit(1);
+    });
+}
+
+export { exampleUsage, batchRegistration, errorHandlingExample };