@pixeloffice-eu/x402 1.0.2 → 1.0.3

package/README.md

@@ -14,20 +14,28 @@ npm install @pixeloffice-eu/x402
 
 ---
 
-## ⚡ Quickstart (Autonomous Agent Client)
+---
+
+## ⚡ Quickstart (Zero-Config with .env)
+
+Put your agent's Solana key into your `.env`:
+
+```env
+# .env
+SOLANA_PRIVATE_KEY=5K2...your_phantom_or_solana_base58_private_key...
+```
+
+Then in your code:
 
 ```javascript
 import { PixelRouterX402Client } from '@pixeloffice-eu/x402';
 
-// Provide your agent's Solana private key (Base58 or hex)
-const client = new PixelRouterX402Client({
-  baseUrl: 'https://api.pixeloffice.eu/v1',
-  solanaPrivateKey: process.env.SOLANA_AGENT_PRIVATE_KEY
-});
+// Zero-config: Automatically picks up SOLANA_PRIVATE_KEY from process.env
+const client = new PixelRouterX402Client();
 
-// Autonomous LLM invocation with automatic HTTP 402 negotiation
+// Autonomous LLM invocation with automatic 0.24ms Solana HTTP 402 micro-settlement
 const response = await client.createChatCompletion({
-  model: 'blun-auto', // Or 'deepseek-chat', 'claude-3.5-sonnet'
+  model: 'blun-auto', // Or 'deepseek-chat', 'claude-3.5-sonnet', 'ox-alpha'
   messages: [
     { role: 'user', content: 'Execute autonomous codebase refactor.' }
   ]

package/index.js

@@ -79,15 +79,24 @@ class PixelRouterX402Client {
     this.sessionId = options.sessionId || null;
     this.customSigner = options.customSigner || null;
 
+    // Auto-detect private/public key from environment if not explicitly passed
+    const envPrivKey = (typeof process !== 'undefined' && process.env) ?
+      (process.env.SOLANA_AGENT_PRIVATE_KEY || process.env.SOLANA_PRIVATE_KEY || process.env.SOLANA_KEY || null) : null;
+    const resolvedPrivKey = options.solanaPrivateKey || envPrivKey;
+
+    const envPubKey = (typeof process !== 'undefined' && process.env) ?
+      (process.env.SOLANA_AGENT_PUBLIC_KEY || process.env.SOLANA_PUBLIC_KEY || null) : null;
+    const resolvedPubKey = options.solanaPublicKey || envPubKey;
+
     if (options.keypair && options.keypair.privateKey) {
       this.privateKeyObject = options.keypair.privateKey;
       this.publicKeyObject = options.keypair.publicKey;
       const der = this.publicKeyObject.export({ type: 'spki', format: 'der' });
       this.solanaPublicKey = bs58Encode(der.subarray(12));
-    } else if (options.solanaPrivateKey) {
-      this._initFromPrivateKey(options.solanaPrivateKey, options.solanaPublicKey);
+    } else if (resolvedPrivKey) {
+      this._initFromPrivateKey(resolvedPrivKey, resolvedPubKey);
     } else if (options.customSigner) {
-      this.solanaPublicKey = options.solanaPublicKey || 'custom_signer_wallet';
+      this.solanaPublicKey = resolvedPubKey || 'custom_signer_wallet';
     } else {
       // Create fresh ephemeral ed25519 keypair for autonomous agent
       const kp = crypto.generateKeyPairSync('ed25519');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixeloffice-eu/x402",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Agent-Native x402 Micro-Payment Client & Scaffolder for PixelRouter on Solana",
   "main": "index.js",
   "types": "index.d.ts",