ppi-sdk 1.0.0

package/ppi-api/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "ppi-sdk",
+  "version": "1.0.0",
+  "description": "Payment Programming Interface - The HTTP of Payments. Build complex financial transactions with simple, human-readable code.",
+  "type": "module",
+  "main": "../src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./primitives": "./src/primitives/index.js"
+  },
+  "scripts": {
+    "test": "node test-ppi-api.js",
+    "start": "node ppi-api-server.js",
+    "dev": "node --watch ppi-api-server.js",
+    "sdk-test": "cd .. && node test-all-primitives.js"
+  },
+  "keywords": [
+    "ppi",
+    "payments",
+    "protocol",
+    "crypto",
+    "dag",
+    "blockchain",
+    "universal-payments",
+    "financial",
+    "transactions",
+    "multi-chain",
+    "payment-language",
+    "financial-protocol",
+    "casha-dag"
+  ],
+  "author": "Casha Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/casha/ppi-universe"
+  },
+  "homepage": "https://casha.com/ppi",
+  "bugs": {
+    "url": "https://github.com/casha/ppi-universe/issues"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "cors": "^2.8.5",
+    "node-fetch": "^3.3.0"
+  },
+  "devDependencies": {
+    "chalk": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/ppi-api/ppi-api-server.js

@@ -0,0 +1,480 @@
+// C:\Casha\ppi-universe\ppi-api\ppi-api-server.js
+import express from 'express';
+import cors from 'cors';
+import * as sdk from '../packages/ppi-sdk/index.js';
+import { PPICompiler } from '../src/compiler/compiler.js';
+import { DAGIntegration } from '../src/integration/dag-integration.js';
+
+// Import PPI Protocol
+import { PPIProtocol } from './ppi-protocol.js';
+
+const app = express();
+const PORT = process.env.PORT || 3001;
+
+// Middleware
+app.use(cors());
+app.use(express.json());
+
+console.log('🚀 PPI Developer API Server Starting...\n');
+
+// PPI API Routes
+app.post('/v1/ppi/send', async (req, res) => {
+  try {
+    const { amount, to, message, target = 'casha-dag' } = req.body;
+    
+    console.log(`📤 PPI_SEND: ${amount} → ${to}`);
+    
+    const operation = sdk.PPI_SEND(amount)
+      .TO(to)
+      .WITH_MESSAGE(message || '');
+    
+    const compiled = PPICompiler.compile(operation, target);
+    
+    res.json({
+      success: true,
+      operation: 'PPI_SEND',
+      compiled,
+      preview: operation.toString(),
+      target,
+      ppi_url: PPIProtocol.generate(operation, target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+app.post('/v1/ppi/escrow', async (req, res) => {
+  try {
+    const { amount, from, to, arbitrator, message, target = 'casha-dag' } = req.body;
+    
+    console.log(`🔒 PPI_ESCROW: ${amount} (${from} → ${to})`);
+    
+    const operation = sdk.PPI_ESCROW(amount)
+      .FROM(from)
+      .TO(to)
+      .WITH_ARBITRATOR(arbitrator)
+      .WITH_MESSAGE(message || '');
+    
+    const compiled = PPICompiler.compile(operation, target);
+    
+    res.json({
+      success: true,
+      operation: 'PPI_ESCROW', 
+      compiled,
+      preview: operation.toString(),
+      target,
+      ppi_url: PPIProtocol.generate(operation, target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+app.post('/v1/ppi/split', async (req, res) => {
+  try {
+    const { amount, among, message, target = 'casha-dag' } = req.body;
+    
+    console.log(`🎁 PPI_SPLIT: ${amount} among ${among.length} recipients`);
+    
+    const operation = sdk.PPI_SPLIT(amount)
+      .AMONG(among)
+      .EQUAL()
+      .WITH_MESSAGE(message || '');
+    
+    const compiled = PPICompiler.compile(operation, target);
+    
+    res.json({
+      success: true,
+      operation: 'PPI_SPLIT',
+      compiled, 
+      preview: operation.toString(),
+      target,
+      ppi_url: PPIProtocol.generate(operation, target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+app.post('/v1/ppi/schedule', async (req, res) => {
+  try {
+    const { amount, to, interval, unit = 'months', message, target = 'casha-dag' } = req.body;
+    
+    console.log(`📅 PPI_SCHEDULE: ${amount} to ${to} every ${interval} ${unit}`);
+    
+    const operation = sdk.PPI_SCHEDULE(amount)
+      .TO(to)
+      .EVERY(interval, unit)
+      .WITH_MESSAGE(message || '');
+    
+    const compiled = PPICompiler.compile(operation, target);
+    
+    res.json({
+      success: true,
+      operation: 'PPI_SCHEDULE',
+      compiled,
+      preview: operation.toString(),
+      target,
+      ppi_url: PPIProtocol.generate(operation, target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+app.post('/v1/ppi/stream', async (req, res) => {
+  try {
+    const { amount, to, duration, interval = 'day', message, target = 'casha-dag' } = req.body;
+    
+    console.log(`🌊 PPI_STREAM: ${amount} to ${to} over ${duration} ${interval}s`);
+    
+    const operation = sdk.PPI_STREAM(amount)
+      .TO(to)
+      .OVER(duration)
+      .PER(interval)
+      .WITH_MESSAGE(message || '');
+    
+    const compiled = PPICompiler.compile(operation, target);
+    
+    res.json({
+      success: true,
+      operation: 'PPI_STREAM',
+      compiled,
+      preview: operation.toString(),
+      target,
+      ppi_url: PPIProtocol.generate(operation, target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+app.post('/v1/ppi/vote', async (req, res) => {
+  try {
+    const { proposal, among, duration = 24, message, target = 'casha-dag' } = req.body;
+    
+    console.log(`🗳️ PPI_VOTE: "${proposal}" among ${among.length} voters`);
+    
+    const operation = sdk.PPI_VOTE(proposal)
+      .AMONG(among)
+      .MAJORITY()
+      .WITH_DURATION(duration, 'hours')
+      .WITH_MESSAGE(message || '');
+    
+    const compiled = PPICompiler.compile(operation, target);
+    
+    res.json({
+      success: true,
+      operation: 'PPI_VOTE',
+      compiled,
+      preview: operation.toString(),
+      target,
+      ppi_url: PPIProtocol.generate(operation, target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+app.post('/v1/ppi/if', async (req, res) => {
+  try {
+    const { condition, then_action, else_action, target = 'casha-dag' } = req.body;
+    
+    console.log(`🤖 PPI_IF: Conditional execution`);
+    
+    // Note: Conditions need proper condition objects
+    const operation = sdk.PPI_IF(condition)
+      .THEN(then_action)
+      .ELSE(else_action);
+    
+    const compiled = PPICompiler.compile(operation, target);
+    
+    res.json({
+      success: true,
+      operation: 'PPI_IF',
+      compiled,
+      preview: operation.toString(),
+      target,
+      ppi_url: PPIProtocol.generate(operation, target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+// PPI Protocol endpoints
+app.post('/v1/protocol/parse', async (req, res) => {
+  try {
+    const { ppi_url } = req.body;
+    
+    console.log(`🔗 Parsing PPI URL: ${ppi_url}`);
+    
+    const parsed = PPIProtocol.parse(ppi_url);
+    
+    // Convert to PPI operation
+    let operation;
+    switch (parsed.primitive) {
+      case 'SEND':
+        operation = sdk.PPI_SEND(parsed.parameters.amount)
+          .TO(parsed.parameters.to)
+          .WITH_MESSAGE(parsed.parameters.message || '');
+        break;
+        
+      case 'ESCROW':
+        operation = sdk.PPI_ESCROW(parsed.parameters.amount)
+          .FROM(parsed.parameters.from)
+          .TO(parsed.parameters.to)
+          .WITH_ARBITRATOR(parsed.parameters.arbitrator || 'platform@casha.com');
+        break;
+        
+      case 'SPLIT':
+        operation = sdk.PPI_SPLIT(parsed.parameters.amount)
+          .AMONG(parsed.parameters.among)
+          .EQUAL();
+        break;
+        
+      case 'SCHEDULE':
+        operation = sdk.PPI_SCHEDULE(parsed.parameters.amount)
+          .TO(parsed.parameters.to)
+          .EVERY(parsed.parameters.interval || 1, parsed.parameters.unit || 'months');
+        break;
+        
+      case 'STREAM':
+        operation = sdk.PPI_STREAM(parsed.parameters.amount)
+          .TO(parsed.parameters.to)
+          .OVER(parsed.parameters.duration || 30)
+          .PER(parsed.parameters.interval || 'day');
+        break;
+        
+      default:
+        throw new Error(`Unsupported primitive: ${parsed.primitive}`);
+    }
+    
+    const compiled = PPICompiler.compile(operation, parsed.target);
+    
+    res.json({
+      success: true,
+      parsed,
+      operation: operation.toString(),
+      compiled,
+      execute_url: `${req.protocol}://${req.get('host')}/v1/execute`,
+      ppi_url: PPIProtocol.generate(operation, parsed.target)
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+app.get('/v1/protocol/examples', (req, res) => {
+  res.json({
+    protocol: 'ppi://',
+    description: 'Universal Financial Protocol URLs',
+    examples: PPIProtocol.getExamples(),
+    usage: 'Use ppi:// URLs for cross-app financial operations',
+    endpoints: {
+      'POST /v1/protocol/parse': 'Parse ppi:// URL into executable operation',
+      'POST /v1/protocol/generate': 'Generate ppi:// URL from operation parameters'
+    }
+  });
+});
+
+app.post('/v1/protocol/generate', async (req, res) => {
+  try {
+    const { operation_type, parameters, target = 'casha-dag' } = req.body;
+    
+    let operation;
+    switch (operation_type.toUpperCase()) {
+      case 'SEND':
+        operation = sdk.PPI_SEND(parameters.amount)
+          .TO(parameters.to)
+          .WITH_MESSAGE(parameters.message || '');
+        break;
+        
+      case 'ESCROW':
+        operation = sdk.PPI_ESCROW(parameters.amount)
+          .FROM(parameters.from)
+          .TO(parameters.to)
+          .WITH_ARBITRATOR(parameters.arbitrator)
+          .WITH_MESSAGE(parameters.message || '');
+        break;
+        
+      case 'SPLIT':
+        operation = sdk.PPI_SPLIT(parameters.amount)
+          .AMONG(parameters.among)
+          .EQUAL()
+          .WITH_MESSAGE(parameters.message || '');
+        break;
+        
+      case 'SCHEDULE':
+        operation = sdk.PPI_SCHEDULE(parameters.amount)
+          .TO(parameters.to)
+          .EVERY(parameters.interval || 1, parameters.unit || 'months')
+          .WITH_MESSAGE(parameters.message || '');
+        break;
+        
+      case 'STREAM':
+        operation = sdk.PPI_STREAM(parameters.amount)
+          .TO(parameters.to)
+          .OVER(parameters.duration || 30)
+          .PER(parameters.interval || 'day')
+          .WITH_MESSAGE(parameters.message || '');
+        break;
+        
+      case 'VOTE':
+        operation = sdk.PPI_VOTE(parameters.proposal)
+          .AMONG(parameters.among)
+          .MAJORITY()
+          .WITH_DURATION(parameters.duration || 24, 'hours')
+          .WITH_MESSAGE(parameters.message || '');
+        break;
+        
+      default:
+        throw new Error(`Unsupported operation type: ${operation_type}`);
+    }
+    
+    const ppiUrl = PPIProtocol.generate(operation, target);
+    
+    res.json({
+      success: true,
+      ppi_url: ppiUrl,
+      operation: operation.toString(),
+      qr_code: `https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=${encodeURIComponent(ppiUrl)}`,
+      shareable: true
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+// Execute compiled operations on live DAG
+app.post('/v1/execute', async (req, res) => {
+  try {
+    const { compiled_operation, user_id } = req.body;
+    
+    console.log(`🌐 Executing on live DAG for user: ${user_id}`);
+    
+    const dag = new DAGIntegration();
+    dag.setCurrentUser(user_id);
+    
+    const result = await dag.executeCompiled(compiled_operation);
+    
+    res.json(result);
+    
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+});
+
+// Quick execute from PPI URL
+app.post('/v1/protocol/execute', async (req, res) => {
+  try {
+    const { ppi_url, user_id } = req.body;
+    
+    console.log(`🚀 Quick execute from PPI URL: ${ppi_url}`);
+    
+    // Parse PPI URL
+    const parsed = PPIProtocol.parse(ppi_url);
+    
+    // Convert to operation
+    let operation;
+    switch (parsed.primitive) {
+      case 'SEND':
+        operation = sdk.PPI_SEND(parsed.parameters.amount)
+          .TO(parsed.parameters.to)
+          .WITH_MESSAGE(parsed.parameters.message || '');
+        break;
+        
+      default:
+        throw new Error(`Quick execute only supports SEND for now. Primitive: ${parsed.primitive}`);
+    }
+    
+    // Execute on DAG
+    const dag = new DAGIntegration();
+    dag.setCurrentUser(user_id);
+    
+    const compiled = PPICompiler.compile(operation, parsed.target);
+    const result = await dag.executeCompiled(compiled);
+    
+    res.json({
+      success: true,
+      ppi_url,
+      operation: operation.toString(),
+      result
+    });
+    
+  } catch (error) {
+    res.status(400).json({ error: error.message });
+  }
+});
+
+// Get supported primitives and targets
+app.get('/v1/info', (req, res) => {
+  res.json({
+    version: '1.0.0',
+    protocol: 'ppi://',
+    primitives: ['send', 'escrow', 'split', 'schedule', 'stream', 'vote', 'if'],
+    targets: ['casha-dag', 'ethereum', 'solana'],
+    description: 'PPI Developer API - HTTP for Blockchains',
+    documentation: 'https://github.com/casha/ppi-universe',
+    endpoints: {
+      'REST API': {
+        'POST /v1/ppi/send': 'Create send operation',
+        'POST /v1/ppi/escrow': 'Create escrow operation',
+        'POST /v1/ppi/split': 'Create split operation',
+        'POST /v1/ppi/schedule': 'Create schedule operation',
+        'POST /v1/ppi/stream': 'Create stream operation',
+        'POST /v1/ppi/vote': 'Create vote operation',
+        'POST /v1/ppi/if': 'Create conditional operation',
+        'POST /v1/execute': 'Execute on live DAG'
+      },
+      'PPI Protocol': {
+        'POST /v1/protocol/parse': 'Parse ppi:// URL',
+        'POST /v1/protocol/generate': 'Generate ppi:// URL',
+        'POST /v1/protocol/execute': 'Quick execute from ppi:// URL',
+        'GET /v1/protocol/examples': 'Protocol examples'
+      }
+    }
+  });
+});
+
+// Health check
+app.get('/health', (req, res) => {
+  res.json({ 
+    status: 'healthy', 
+    service: 'PPI Developer API',
+    timestamp: new Date().toISOString(),
+    version: '1.0.0',
+    protocol: 'ppi://'
+  });
+});
+
+// Start server
+app.listen(PORT, () => {
+  console.log(`🚀 PPI Developer API Server running on port ${PORT}`);
+  console.log(`📚 API Documentation: http://localhost:${PORT}/v1/info`);
+  console.log(`🌍 REST Endpoints:`);
+  console.log(`   POST /v1/ppi/send`);
+  console.log(`   POST /v1/ppi/escrow`);
+  console.log(`   POST /v1/ppi/split`);
+  console.log(`   POST /v1/ppi/schedule`);
+  console.log(`   POST /v1/ppi/stream`);
+  console.log(`   POST /v1/ppi/vote`);
+  console.log(`   POST /v1/ppi/if`);
+  console.log(`   POST /v1/execute`);
+  console.log(`\n🔗 PPI Protocol Endpoints:`);
+  console.log(`   POST /v1/protocol/parse`);
+  console.log(`   POST /v1/protocol/generate`);
+  console.log(`   POST /v1/protocol/execute`);
+  console.log(`   GET  /v1/protocol/examples`);
+  console.log(`\n💡 Developers can now build with PPI REST API and ppi:// protocol!`);
+  console.log(`🔗 Test with: curl http://localhost:${PORT}/v1/info`);
+});

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

@@ -0,0 +1,83 @@
+// C:\Casha\ppi-universe\ppi-api\ppi-protocol-demo.js
+const API_BASE = 'http://localhost:3001/v1';
+
+async function ppiProtocolDemo() {
+  console.log('🚀 PPI Protocol - Complete Demo\n');
+  
+  console.log('1. 📋 PPI Protocol Examples:');
+  console.log('   ppi://send/10/to/user@casha.com@casha-dag');
+  console.log('   ppi://split/100/among/user1,user2,user3@casha-dag');
+  console.log('   ppi://escrow/50/from/buyer/to/seller@casha-dag');
+  console.log('   ppi://schedule/2000/to/employee/every/1/months@casha-dag');
+  
+  console.log('\n2. 🎯 Real-World Use Cases:');
+  
+  // Use Case 1: Salary Payments
+  console.log('   💼 Salary: ppi://schedule/5000/to/employee/every/1/months@casha-dag');
+  
+  // Use Case 2: Team Bonuses
+  console.log('   👥 Team Bonus: ppi://split/10000/among/alice,bob,charlie@casha-dag');
+  
+  // Use Case 3: Content Creator Support
+  console.log('   🎬 Creator Support: ppi://stream/1000/to/creator/over/30/with/interval/day@casha-dag');
+  
+  // Use Case 4: E-commerce Escrow
+  console.log('   🛒 E-commerce: ppi://escrow/500/from/buyer/to/seller/with/arbitrator/platform@casha-dag');
+  
+  console.log('\n3. 🔗 Testing URL Generation...');
+  
+  try {
+    // Generate a send URL
+    const sendResponse = await fetch(`${API_BASE}/protocol/generate`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        operation_type: 'send',
+        parameters: {
+          amount: 50,
+          to: 'community@casha.com',
+          message: 'PPI Protocol Demo'
+        }
+      })
+    });
+    
+    const sendResult = await sendResponse.json();
+    console.log('   ✅ Generated Send URL:', sendResult.ppi_url);
+    
+    // Generate a split URL
+    const splitResponse = await fetch(`${API_BASE}/protocol/generate`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        operation_type: 'split',
+        parameters: {
+          amount: 150,
+          among: ['member1@casha.com', 'member2@casha.com', 'member3@casha.com']
+        }
+      })
+    });
+    
+    const splitResult = await splitResponse.json();
+    console.log('   ✅ Generated Split URL:', splitResult.ppi_url);
+    
+    console.log('\n4. 📱 Mobile & Web Integration:');
+    console.log('   - Mobile apps can register ppi:// protocol handler');
+    console.log('   - Websites can use ppi:// links for payments');
+    console.log('   - QR codes can be scanned by any wallet app');
+    console.log('   - Deep linking between financial apps');
+    
+    console.log('\n5. 🌐 Cross-Platform Compatibility:');
+    console.log('   - Android: Intent filters for ppi://');
+    console.log('   - iOS: URL schemes for ppi://');
+    console.log('   - Web: Navigation to ppi:// URLs');
+    console.log('   - Desktop: Protocol handlers');
+    
+    console.log('\n🎉 PPI Protocol Demo Complete!');
+    console.log('🚀 Your financial protocol standard is ready for the world!');
+    
+  } catch (error) {
+    console.log('❌ Demo error:', error.message);
+  }
+}
+
+ppiProtocolDemo();