ppi-sdk 1.0.0

package/ppi-api/ppi-protocol.js

@@ -0,0 +1,114 @@
+// C:\Casha\ppi-universe\ppi-api\ppi-protocol.js
+class PPIProtocol {
+  static parse(ppiUrl) {
+    try {
+      // Remove ppi:// prefix and parse
+      const urlWithoutProtocol = ppiUrl.replace('ppi://', 'http://ppi/');
+      const parsed = new URL(urlWithoutProtocol);
+      
+      const pathParts = parsed.pathname.split('/').filter(Boolean);
+      const primitive = pathParts[0];
+      const params = this.parsePathParams(pathParts.slice(1));
+      const queryParams = Object.fromEntries(parsed.searchParams);
+      
+      return {
+        primitive: primitive.toUpperCase(),
+        parameters: { ...params, ...queryParams },
+        target: parsed.hostname || 'casha-dag',
+        rawUrl: ppiUrl
+      };
+    } catch (error) {
+      throw new Error(`Invalid PPI URL: ${ppiUrl}`);
+    }
+  }
+  
+  static parsePathParams(pathParts) {
+    const params = {};
+    
+    for (let i = 0; i < pathParts.length; i++) {
+      const part = pathParts[i];
+      
+      if (!isNaN(part)) {
+        params.amount = parseFloat(part);
+      } else if (part === 'to' && pathParts[i + 1]) {
+        params.to = decodeURIComponent(pathParts[++i]);
+      } else if (part === 'from' && pathParts[i + 1]) {
+        params.from = decodeURIComponent(pathParts[++i]);
+      } else if (part === 'among' && pathParts[i + 1]) {
+        params.among = decodeURIComponent(pathParts[++i]).split(',');
+      } else if (part === 'with' && pathParts[i + 1]) {
+        const key = pathParts[++i];
+        if (pathParts[i + 1]) {
+          params[key] = decodeURIComponent(pathParts[++i]);
+        }
+      } else if (part === 'every' && pathParts[i + 1]) {
+        params.interval = pathParts[++i];
+        if (pathParts[i + 1] && !['to', 'from', 'with'].includes(pathParts[i + 1])) {
+          params.unit = pathParts[++i];
+        }
+      } else if (part === 'over' && pathParts[i + 1]) {
+        params.duration = pathParts[++i];
+      }
+    }
+    
+    return params;
+  }
+  
+  static generate(operation, target = 'casha-dag') {
+    const state = operation.getState();
+    const primitive = state.operation.toLowerCase().replace('ppi_', '');
+    
+    let url = `ppi://${primitive}`;
+    
+    switch (primitive) {
+      case 'send':
+        url += `/${state.amount}/to/${encodeURIComponent(state.to_user)}`;
+        if (state.message) url += `?message=${encodeURIComponent(state.message)}`;
+        break;
+        
+      case 'escrow':
+        url += `/${state.amount}/from/${encodeURIComponent(state.from_user)}/to/${encodeURIComponent(state.to_user)}`;
+        if (state.arbitrator) url += `/with/arbitrator/${encodeURIComponent(state.arbitrator)}`;
+        break;
+        
+      case 'split':
+        url += `/${state.amount}/among/${state.recipients.map(encodeURIComponent).join(',')}`;
+        break;
+        
+      case 'schedule':
+        url += `/${state.amount}/to/${encodeURIComponent(state.to_user)}/every/${state.interval.value || 1}`;
+        if (state.interval.unit) url += `/${state.interval.unit}`;
+        break;
+        
+      case 'stream':
+        url += `/${state.amount}/to/${encodeURIComponent(state.to_user)}/over/${state.duration}`;
+        if (state.interval) url += `/with/interval/${state.interval}`;
+        break;
+        
+      case 'vote':
+        url += `/${encodeURIComponent(state.proposal)}/among/${state.voters.map(encodeURIComponent).join(',')}`;
+        break;
+        
+      default:
+        url += `/${state.amount}`;
+    }
+    
+    // Add target
+    url += `@${target}`;
+    
+    return url;
+  }
+  
+  static getExamples() {
+    return {
+      send: 'ppi://send/10/to/user@casha.com?message=Hello',
+      escrow: 'ppi://escrow/50/from/buyer@casha.com/to/seller@casha.com/with/arbitrator/platform@casha.com',
+      split: 'ppi://split/100/among/user1@casha.com,user2@casha.com,user3@casha.com',
+      schedule: 'ppi://schedule/2000/to/employee@company.com/every/1/months',
+      stream: 'ppi://stream/500/to/creator@platform.com/over/30/with/interval/day',
+      vote: 'ppi://vote/Release%20Q1%20Budget/among/ceo@casha.com,cfo@casha.com,cto@casha.com'
+    };
+  }
+}
+
+export { PPIProtocol };

package/ppi-api/ppi-url-client.js

@@ -0,0 +1,97 @@
+// C:\Casha\ppi-universe\ppi-api\ppi-url-client.js
+const API_BASE = 'http://localhost:3001/v1';
+
+class PPIURLClient {
+  constructor() {
+    this.baseUrl = API_BASE;
+  }
+
+  async parseAndExecute(ppiUrl, userId) {
+    try {
+      console.log(`🔗 Processing: ${ppiUrl}`);
+      
+      // Parse the PPI URL
+      const parseResponse = await fetch(`${this.baseUrl}/protocol/parse`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ ppi_url: ppiUrl })
+      });
+      
+      const parsed = await parseResponse.json();
+      
+      if (!parsed.success) {
+        throw new Error(`Failed to parse PPI URL: ${parsed.error}`);
+      }
+      
+      console.log(`✅ Parsed: ${parsed.operation}`);
+      
+      // Execute on DAG
+      const executeResponse = await fetch(`${this.baseUrl}/execute`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          compiled_operation: parsed.compiled,
+          user_id: userId
+        })
+      });
+      
+      const result = await executeResponse.json();
+      
+      return {
+        ppi_url: ppiUrl,
+        operation: parsed.operation,
+        result: result
+      };
+      
+    } catch (error) {
+      throw new Error(`PPI URL execution failed: ${error.message}`);
+    }
+  }
+
+  async generateURL(operationType, parameters, target = 'casha-dag') {
+    const response = await fetch(`${this.baseUrl}/protocol/generate`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        operation_type: operationType,
+        parameters: parameters,
+        target: target
+      })
+    });
+    
+    return await response.json();
+  }
+}
+
+// Demo using only PPI URLs
+async function demoPPIURLs() {
+  const client = new PPIURLClient();
+  
+  console.log('🚀 PPI URL Client Demo\n');
+  
+  // Generate some PPI URLs
+  const sendURL = await client.generateURL('send', {
+    amount: 10,
+    to: 'user@casha.com',
+    message: 'PPI URL Demo'
+  });
+  
+  console.log('📤 Generated Send URL:', sendURL.ppi_url);
+  
+  const splitURL = await client.generateURL('split', {
+    amount: 45,
+    among: ['alice@casha.com', 'bob@casha.com', 'charlie@casha.com'],
+    message: 'Team split'
+  });
+  
+  console.log('🎁 Generated Split URL:', splitURL.ppi_url);
+  
+  console.log('\n💡 Developers can now:');
+  console.log('   - Share PPI URLs in messages');
+  console.log('   - Scan PPI QR codes');
+  console.log('   - Deep link between apps');
+  console.log('   - Use ppi:// instead of http:// for financial operations!');
+}
+
+// Run demo
+demoPPIURLs();

package/ppi-api/test-ppi-api.js

@@ -0,0 +1,72 @@
+// C:\Casha\ppi-universe\ppi-api\test-ppi-api.js
+const API_BASE = 'http://localhost:3001/v1';
+
+async function testPPIAPI() {
+  console.log('🧪 Testing PPI Developer API\n');
+  
+  try {
+    // Test API info
+    console.log('1. 📋 Getting API info...');
+    const infoResponse = await fetch(`${API_BASE}/info`);
+    const info = await infoResponse.json();
+    console.log('   API Info:', JSON.stringify(info, null, 2));
+    
+    // Test PPI_SEND
+    console.log('\n2. 📤 Testing PPI_SEND...');
+    const sendResponse = await fetch(`${API_BASE}/ppi/send`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        amount: 10,
+        to: 'developer@casha.com',
+        message: 'API Test Payment',
+        target: 'casha-dag'
+      })
+    });
+    
+    const sendResult = await sendResponse.json();
+    console.log('   PPI_SEND Result:', JSON.stringify(sendResult, null, 2));
+    
+    // Test PPI_SPLIT
+    console.log('\n3. 🎁 Testing PPI_SPLIT...');
+    const splitResponse = await fetch(`${API_BASE}/ppi/split`, {
+      method: 'POST', 
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        amount: 30,
+        among: ['user1@casha.com', 'user2@casha.com', 'user3@casha.com'],
+        message: 'Team payment via API'
+      })
+    });
+    
+    const splitResult = await splitResponse.json();
+    console.log('   PPI_SPLIT Result:', JSON.stringify(splitResult, null, 2));
+    
+    // Test PPI_SCHEDULE
+    console.log('\n4. 📅 Testing PPI_SCHEDULE...');
+    const scheduleResponse = await fetch(`${API_BASE}/ppi/schedule`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        amount: 100,
+        to: 'employee@company.com',
+        interval: 1,
+        unit: 'months',
+        message: 'Monthly salary'
+      })
+    });
+    
+    const scheduleResult = await scheduleResponse.json();
+    console.log('   PPI_SCHEDULE Result:', JSON.stringify(scheduleResult, null, 2));
+    
+    console.log('\n🎉 PPI API Tests Completed Successfully!');
+    console.log('🚀 Developers can now use your financial protocol!');
+    
+  } catch (error) {
+    console.log('❌ API Test Failed:', error.message);
+    console.log('💡 Make sure the API server is running on port 3001');
+  }
+}
+
+// Run the test
+testPPIAPI();

package/ppi-api/test-ppi-protocol.js

@@ -0,0 +1,44 @@
+// C:\Casha\ppi-universe\ppi-api\test-ppi-protocol.js
+import { PPIProtocol } from './ppi-protocol.js';
+import * as sdk from '../packages/ppi-sdk/index.js';
+
+console.log('🧪 Testing PPI Protocol (ppi://)\n');
+
+// Test parsing PPI URLs
+const testUrls = [
+  'ppi://send/10/to/user@casha.com?message=Hello',
+  'ppi://escrow/50/from/buyer@casha.com/to/seller@casha.com/with/arbitrator/platform@casha.com',
+  'ppi://split/100/among/user1@casha.com,user2@casha.com,user3@casha.com',
+  'ppi://schedule/2000/to/employee@company.com/every/1/months',
+  'ppi://stream/500/to/creator@platform.com/over/30/with/interval/day'
+];
+
+console.log('1. 🔗 Parsing PPI URLs:');
+testUrls.forEach(url => {
+  try {
+    const parsed = PPIProtocol.parse(url);
+    console.log(`   ✅ ${url}`);
+    console.log(`      → ${JSON.stringify(parsed)}`);
+  } catch (error) {
+    console.log(`   ❌ ${url}: ${error.message}`);
+  }
+});
+
+// Test generating PPI URLs
+console.log('\n2. 🔗 Generating PPI URLs:');
+const sendOp = sdk.PPI_SEND(25).TO('recipient@casha.com').WITH_MESSAGE('Test');
+const sendUrl = PPIProtocol.generate(sendOp);
+console.log(`   ✅ PPI_SEND → ${sendUrl}`);
+
+const splitOp = sdk.PPI_SPLIT(75).AMONG(['user1', 'user2', 'user3']).EQUAL();
+const splitUrl = PPIProtocol.generate(splitOp);
+console.log(`   ✅ PPI_SPLIT → ${splitUrl}`);
+
+console.log('\n3. 📋 Protocol Examples:');
+const examples = PPIProtocol.getExamples();
+Object.entries(examples).forEach(([type, url]) => {
+  console.log(`   ${type.padEnd(8)}: ${url}`);
+});
+
+console.log('\n🎉 PPI Protocol Ready!');
+console.log('🚀 Developers can now use ppi:// URLs for financial operations!');

package/ppi-api/test-protocol-api.js

@@ -0,0 +1,81 @@
+// C:\Casha\ppi-universe\ppi-api\test-protocol-api.js
+const API_BASE = 'http://localhost:3001/v1';
+
+async function testProtocolAPI() {
+  console.log('🧪 Testing PPI Protocol API Endpoints\n');
+  
+  try {
+    // Test 1: Get protocol examples
+    console.log('1. 📋 Getting protocol examples...');
+    const examplesResponse = await fetch(`${API_BASE}/protocol/examples`);
+    const examples = await examplesResponse.json();
+    console.log('   Protocol:', examples.protocol);
+    console.log('   Examples:', Object.keys(examples.examples).join(', '));
+    
+    // Test 2: Parse a PPI URL
+    console.log('\n2. 🔗 Parsing PPI URL...');
+    const parseResponse = await fetch(`${API_BASE}/protocol/parse`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        ppi_url: 'ppi://send/15/to/test@casha.com?message=Protocol%20Test'
+      })
+    });
+    
+    const parseResult = await parseResponse.json();
+    console.log('   Parsed Result:');
+    console.log('   - Operation:', parseResult.operation);
+    console.log('   - PPI URL:', parseResult.ppi_url);
+    
+    // Test 3: Generate a PPI URL
+    console.log('\n3. 🔗 Generating PPI URL...');
+    const generateResponse = await fetch(`${API_BASE}/protocol/generate`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        operation_type: 'send',
+        parameters: {
+          amount: 25,
+          to: 'recipient@casha.com',
+          message: 'Generated via API'
+        },
+        target: 'casha-dag'
+      })
+    });
+    
+    const generateResult = await generateResponse.json();
+    console.log('   Generated Result:');
+    console.log('   - PPI URL:', generateResult.ppi_url);
+    console.log('   - QR Code:', generateResult.qr_code);
+    
+    // Test 4: Quick execute from PPI URL (if server supports it)
+    console.log('\n4. 🚀 Testing quick execute...');
+    try {
+      const executeResponse = await fetch(`${API_BASE}/protocol/execute`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          ppi_url: 'ppi://send/1/to/davy@casha.com?message=Quick%20Execute%20Test',
+          user_id: 'oscar@casha.com'
+        })
+      });
+      
+      if (executeResponse.ok) {
+        const executeResult = await executeResponse.json();
+        console.log('   Quick Execute:', executeResult.success ? '✅ Success' : '❌ Failed');
+      } else {
+        console.log('   Quick Execute: ❌ Endpoint not available yet');
+      }
+    } catch (error) {
+      console.log('   Quick Execute: ❌', error.message);
+    }
+    
+    console.log('\n🎉 PPI Protocol API Tests Completed!');
+    console.log('🚀 Developers can now use ppi:// URLs in their apps!');
+    
+  } catch (error) {
+    console.log('❌ Protocol API Test Failed:', error.message);
+  }
+}
+
+testProtocolAPI();