x402storage 1.0.1 → 1.1.0

package/dist/config.d.ts

@@ -1,13 +1,26 @@
 /**
- * Environment validation and configuration for x402store CLI
+ * Wallet configuration for x402storage CLI
+ *
+ * Priority order:
+ * 1. X402_PRIVATE_KEY environment variable (if set)
+ * 2. Stored wallet in ~/.x402storage/wallet.json
+ * 3. Auto-generate new wallet (first use)
  */
 /**
- * Validates that required environment variables are set.
- * Exits with code 1 and helpful error message if X402_PRIVATE_KEY is missing.
+ * Gets the private key, with priority:
+ * 1. X402_PRIVATE_KEY env var
+ * 2. Stored wallet
+ * 3. Auto-generate new wallet
+ *
+ * Returns the private key and shows helpful messages for new wallets.
  */
-export declare function validateEnvironment(): void;
+export declare function getPrivateKey(): `0x${string}`;
 /**
- * Gets the private key from environment.
- * Should only be called after validateEnvironment().
+ * Get the current wallet address (for display purposes)
  */
-export declare function getPrivateKey(): `0x${string}`;
+export declare function getWalletAddress(): `0x${string}` | null;
+/**
+ * Validate environment - now just a no-op since we auto-create wallets
+ * Kept for backwards compatibility
+ */
+export declare function validateEnvironment(): void;

package/dist/config.js

@@ -1,23 +1,125 @@
 /**
- * Environment validation and configuration for x402store CLI
+ * Wallet configuration for x402storage CLI
+ *
+ * Priority order:
+ * 1. X402_PRIVATE_KEY environment variable (if set)
+ * 2. Stored wallet in ~/.x402storage/wallet.json
+ * 3. Auto-generate new wallet (first use)
  */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
+const CONFIG_DIR = join(homedir(), '.x402storage');
+const WALLET_FILE = join(CONFIG_DIR, 'wallet.json');
 /**
- * Validates that required environment variables are set.
- * Exits with code 1 and helpful error message if X402_PRIVATE_KEY is missing.
+ * Ensure the config directory exists
  */
-export function validateEnvironment() {
-    if (!process.env.X402_PRIVATE_KEY) {
-        console.error('Error: X402_PRIVATE_KEY not set.\n\n' +
-            'Export your Base wallet private key:\n' +
-            '  export X402_PRIVATE_KEY=0x...\n\n' +
-            'Need a wallet? Create one at https://x402.storage');
-        process.exit(1);
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Generate a new wallet
+ */
+function generateWallet() {
+    const privateKey = generatePrivateKey();
+    const account = privateKeyToAccount(privateKey);
+    return {
+        privateKey,
+        address: account.address,
+        createdAt: Date.now(),
+    };
+}
+/**
+ * Save wallet to config file
+ */
+function saveWallet(wallet) {
+    ensureConfigDir();
+    writeFileSync(WALLET_FILE, JSON.stringify(wallet, null, 2), { mode: 0o600 });
+}
+/**
+ * Load wallet from config file
+ */
+function loadWallet() {
+    try {
+        if (!existsSync(WALLET_FILE)) {
+            return null;
+        }
+        const data = readFileSync(WALLET_FILE, 'utf-8');
+        const wallet = JSON.parse(data);
+        // Validate wallet shape
+        if (wallet &&
+            typeof wallet === 'object' &&
+            typeof wallet.privateKey === 'string' &&
+            typeof wallet.address === 'string' &&
+            wallet.privateKey.startsWith('0x') &&
+            wallet.address.startsWith('0x')) {
+            return wallet;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get or create wallet
+ * Returns the wallet and whether it was newly created
+ */
+function getOrCreateWallet() {
+    const existing = loadWallet();
+    if (existing) {
+        return { wallet: existing, isNew: false };
     }
+    const newWallet = generateWallet();
+    saveWallet(newWallet);
+    return { wallet: newWallet, isNew: true };
 }
 /**
- * Gets the private key from environment.
- * Should only be called after validateEnvironment().
+ * Gets the private key, with priority:
+ * 1. X402_PRIVATE_KEY env var
+ * 2. Stored wallet
+ * 3. Auto-generate new wallet
+ *
+ * Returns the private key and shows helpful messages for new wallets.
  */
 export function getPrivateKey() {
-    return process.env.X402_PRIVATE_KEY;
+    // Check env var first (for power users / CI)
+    if (process.env.X402_PRIVATE_KEY) {
+        return process.env.X402_PRIVATE_KEY;
+    }
+    // Get or create wallet
+    const { wallet, isNew } = getOrCreateWallet();
+    if (isNew) {
+        console.log('');
+        console.log('Created new wallet for x402.storage');
+        console.log(`Address: ${wallet.address}`);
+        console.log('');
+        console.log('Fund this wallet with USDC on Base to upload files.');
+        console.log('Visit https://x402.storage to add funds.');
+        console.log('');
+        console.log(`Wallet saved to: ${WALLET_FILE}`);
+        console.log('');
+    }
+    return wallet.privateKey;
+}
+/**
+ * Get the current wallet address (for display purposes)
+ */
+export function getWalletAddress() {
+    if (process.env.X402_PRIVATE_KEY) {
+        const account = privateKeyToAccount(process.env.X402_PRIVATE_KEY);
+        return account.address;
+    }
+    const wallet = loadWallet();
+    return wallet?.address ?? null;
+}
+/**
+ * Validate environment - now just a no-op since we auto-create wallets
+ * Kept for backwards compatibility
+ */
+export function validateEnvironment() {
+    // No-op - we auto-create wallets now
 }

package/dist/index.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import { resolve } from 'node:path';
-import { validateEnvironment, getPrivateKey } from './config.js';
+import { getPrivateKey, getWalletAddress } from './config.js';
 import { uploadFile } from './upload.js';
 import { FileNotFoundError, UploadError } from './errors.js';
-// Validate environment at startup - fail fast with clear error
-validateEnvironment();
 const program = new Command();
 program
     .name('x402storage')
     .description('Upload files to x402.storage with permanent IPFS storage')
-    .version('1.0.0')
+    .version('1.0.0');
+// Default command: upload a file
+program
     .argument('<file>', 'file path to upload')
     .action(async (filePath) => {
     try {
@@ -19,7 +19,7 @@ program
         const privateKey = getPrivateKey();
         const result = await uploadFile(resolvedPath, privateKey);
         console.log('Success! File stored permanently.');
-        console.log(`URL: ${result.gateway}`);
+        console.log(`URL: ${result.url}`);
         console.log(`CID: ${result.cid}`);
         process.exit(0);
     }
@@ -32,6 +32,10 @@ program
             if (error.type === 'insufficient_balance') {
                 console.error('Error: Insufficient balance.\n');
                 console.error('Fund your wallet at https://x402.storage or transfer USDC on Base.');
+                const address = getWalletAddress();
+                if (address) {
+                    console.error(`Your wallet address: ${address}`);
+                }
                 process.exit(1);
             }
             if (error.type === 'network_error') {
@@ -48,4 +52,27 @@ program
         process.exit(1);
     }
 });
+// Wallet command: show wallet info
+program
+    .command('wallet')
+    .description('Show your wallet address')
+    .action(() => {
+    // Check if wallet exists first
+    let address = getWalletAddress();
+    // If no wallet exists, create one (getPrivateKey will show creation message)
+    if (!address) {
+        getPrivateKey();
+        address = getWalletAddress();
+    }
+    else {
+        // Wallet exists, just show info
+        console.log('');
+        console.log('x402.storage wallet');
+        console.log(`Address: ${address}`);
+        console.log('');
+        console.log('Fund this wallet with USDC on Base to upload files.');
+        console.log('Visit https://x402.storage to add funds.');
+        console.log('');
+    }
+});
 program.parse();

package/dist/upload.d.ts

@@ -6,7 +6,7 @@
  */
 interface UploadResponse {
     cid: string;
-    gateway: string;
+    url: string;
 }
 /**
  * Uploads a file to api.x402.storage with automatic payment handling

package/dist/upload.js

@@ -91,6 +91,6 @@ export async function uploadFile(filePath, privateKey) {
     const result = (await response.json());
     return {
         cid: result.cid,
-        gateway: result.gateway,
+        url: result.url,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402storage",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Upload files to x402.storage from the command line",
   "type": "module",
   "license": "MIT",