@kynesyslabs/demosdk 2.3.28 → 2.4.1

package/build/contracts/templates/TemplateRegistry.js

@@ -0,0 +1,404 @@
+"use strict";
+/**
+ * Template Registry with Parameter Substitution
+ *
+ * Manages contract templates, validates parameters, and performs
+ * parameter substitution to generate deployable contract source code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateRegistry = void 0;
+const TemplateValidator_1 = require("./TemplateValidator");
+class TemplateRegistry {
+    /**
+     * Initialize the template registry with built-in templates
+     */
+    static initialize() {
+        if (this.initialized)
+            return;
+        // Register Token template
+        this.registerTemplate({
+            name: 'Token',
+            schema: {
+                name: 'Token',
+                description: 'Standard token contract with ERC-20-like functionality',
+                version: '1.0.0',
+                author: 'Kynesys Labs',
+                parameters: [
+                    {
+                        name: 'TOKEN_NAME',
+                        type: 'string',
+                        required: true,
+                        default: 'DemosToken',
+                        pattern: /^[A-Za-z0-9\s]{1,32}$/,
+                        description: 'The name of the token (e.g., "My Token")'
+                    },
+                    {
+                        name: 'TOKEN_SYMBOL',
+                        type: 'string',
+                        required: true,
+                        default: 'DTK',
+                        pattern: /^[A-Z]{1,8}$/,
+                        description: 'The symbol of the token (e.g., "MTK")'
+                    },
+                    {
+                        name: 'TOTAL_SUPPLY',
+                        type: 'number',
+                        required: true,
+                        default: 1000000,
+                        min: 1,
+                        max: 1000000000000,
+                        description: 'Initial token supply'
+                    },
+                    {
+                        name: 'DECIMALS',
+                        type: 'number',
+                        required: false,
+                        default: 18,
+                        min: 0,
+                        max: 18,
+                        description: 'Number of decimal places for the token'
+                    }
+                ]
+            },
+            sourceFile: 'Token.ts.template'
+        });
+        // Register Storage template
+        this.registerTemplate({
+            name: 'Storage',
+            schema: {
+                name: 'Storage',
+                description: 'Key-value storage contract with access control',
+                version: '1.0.0',
+                author: 'Kynesys Labs',
+                parameters: [
+                    {
+                        name: 'IS_PUBLIC',
+                        type: 'boolean',
+                        required: false,
+                        default: false,
+                        description: 'Whether the storage allows public read access'
+                    },
+                    {
+                        name: 'MAX_KEYS',
+                        type: 'number',
+                        required: false,
+                        default: 1000,
+                        min: 1,
+                        max: 10000,
+                        description: 'Maximum number of keys that can be stored'
+                    }
+                ]
+            },
+            sourceFile: 'Storage.ts.template'
+        });
+        this.initialized = true;
+    }
+    /**
+     * Register a new template
+     */
+    static registerTemplate(templateInfo) {
+        this.templates.set(templateInfo.name, templateInfo);
+    }
+    /**
+     * Get all available template names
+     */
+    static getAvailableTemplates() {
+        this.initialize();
+        return Array.from(this.templates.keys());
+    }
+    /**
+     * Get template information
+     */
+    static getTemplate(name) {
+        this.initialize();
+        return this.templates.get(name) || null;
+    }
+    /**
+     * Get template schema for validation
+     */
+    static getTemplateSchema(name) {
+        const template = this.getTemplate(name);
+        return template ? template.schema : null;
+    }
+    /**
+     * Load template source code
+     */
+    static loadTemplateSource(template) {
+        if (template.source) {
+            return template.source;
+        }
+        try {
+            // In a real implementation, you'd load from the file system
+            // For now, we'll use the embedded source strings
+            // const templatePath = path.join(__dirname, template.sourceFile)
+            // Since we can't actually read files in this context,
+            // we'll return the source based on template name
+            return this.getEmbeddedTemplateSource(template.name);
+        }
+        catch (error) {
+            throw new Error(`Failed to load template source for ${template.name}: ${error.message}`);
+        }
+    }
+    /**
+     * Get embedded template source (temporary implementation)
+     */
+    static getEmbeddedTemplateSource(templateName) {
+        // In a real implementation, these would be loaded from .contract.ts files
+        const sources = {
+            'Token': `
+class Token extends DemosContract {
+    constructor(
+        name: string = "{{TOKEN_NAME}}",
+        symbol: string = "{{TOKEN_SYMBOL}}", 
+        totalSupply: number = {{TOTAL_SUPPLY}},
+        decimals: number = {{DECIMALS}}
+    ) {
+        super()
+        this.state.set('name', name)
+        this.state.set('symbol', symbol)
+        this.state.set('decimals', decimals)
+        this.state.set('totalSupply', totalSupply)
+        this.state.set('balances', {})
+        this.state.set('allowances', {})
+        const creator = this.sender
+        const balances = this.state.get('balances')
+        balances[creator] = totalSupply
+        this.state.set('balances', balances)
+        this.emit('Transfer', { from: '0x0', to: creator, amount: totalSupply })
+    }
+    
+    name(): string { return this.state.get('name') }
+    symbol(): string { return this.state.get('symbol') }
+    decimals(): number { return this.state.get('decimals') }
+    totalSupply(): number { return this.state.get('totalSupply') }
+    
+    balanceOf(address: string): number {
+        const balances = this.state.get('balances')
+        return balances[address] || 0
+    }
+    
+    transfer(to: string, amount: number): boolean {
+        const from = this.sender
+        return this._transfer(from, to, amount)
+    }
+    
+    private _transfer(from: string, to: string, amount: number): boolean {
+        if (!to || to === '0x0') this.revert('Transfer to zero address')
+        if (amount <= 0) this.revert('Transfer amount must be positive')
+        
+        const balances = this.state.get('balances')
+        const fromBalance = balances[from] || 0
+        if (fromBalance < amount) this.revert('Insufficient balance')
+        
+        balances[from] = fromBalance - amount
+        balances[to] = (balances[to] || 0) + amount
+        this.state.set('balances', balances)
+        
+        this.emit('Transfer', { from, to, amount })
+        return true
+    }
+}`,
+            'Storage': `
+class Storage extends DemosContract {
+    constructor(
+        isPublic: boolean = {{IS_PUBLIC}},
+        maxKeys: number = {{MAX_KEYS}}
+    ) {
+        super()
+        this.state.set('owner', this.sender)
+        this.state.set('isPublic', isPublic)
+        this.state.set('maxKeys', maxKeys)
+        this.state.set('keyCount', 0)
+        this.state.set('data', {})
+        this.state.set('authorizedUsers', {})
+        
+        const authorizedUsers = {}
+        authorizedUsers[this.sender] = true
+        this.state.set('authorizedUsers', authorizedUsers)
+        
+        this.emit('StorageCreated', { owner: this.sender, isPublic, maxKeys })
+    }
+    
+    store(key: string, value: any): boolean {
+        this._requireWriteAccess()
+        this._validateKey(key)
+        
+        const data = this.state.get('data')
+        const isNewKey = !(key in data)
+        
+        if (isNewKey) {
+            const currentKeyCount = this.state.get('keyCount')
+            const maxKeys = this.state.get('maxKeys')
+            if (currentKeyCount >= maxKeys) this.revert('Maximum key limit reached')
+            this.state.set('keyCount', currentKeyCount + 1)
+        }
+        
+        data[key] = { value, timestamp: this.blockHeight, author: this.sender }
+        this.state.set('data', data)
+        this.emit('ValueStored', { key, value, author: this.sender, isNewKey })
+        return true
+    }
+    
+    retrieve(key: string): any {
+        this._requireReadAccess()
+        this._validateKey(key)
+        const data = this.state.get('data')
+        const entry = data[key]
+        if (!entry) return null
+        this.emit('ValueRetrieved', { key, value: entry.value, requester: this.sender })
+        return entry.value
+    }
+    
+    private _requireReadAccess(): void {
+        const isPublic = this.state.get('isPublic')
+        if (isPublic) return
+        const authorizedUsers = this.state.get('authorizedUsers')
+        if (authorizedUsers[this.sender] !== true) this.revert('Read access denied')
+    }
+    
+    private _requireWriteAccess(): void {
+        const authorizedUsers = this.state.get('authorizedUsers')
+        if (authorizedUsers[this.sender] !== true) this.revert('Write access denied')
+    }
+    
+    private _validateKey(key: string): void {
+        if (!key || typeof key !== 'string') this.revert('Invalid key: must be non-empty string')
+        if (key.length > 64) this.revert('Key too long: maximum 64 characters')
+        if (key.startsWith('_') || key.includes('\\0')) this.revert('Invalid key format')
+    }
+}`
+        };
+        return sources[templateName] || '';
+    }
+    /**
+     * Validate template parameters
+     */
+    static validateParameters(templateName, params) {
+        this.initialize();
+        const template = this.getTemplate(templateName);
+        if (!template) {
+            return {
+                valid: false,
+                errors: [`Template '${templateName}' not found`],
+                warnings: [],
+                processedParams: {}
+            };
+        }
+        return TemplateValidator_1.TemplateValidator.validate(template.schema, params);
+    }
+    /**
+     * Generate contract source with parameter substitution
+     */
+    static generateContract(templateName, params = {}) {
+        this.initialize();
+        const template = this.getTemplate(templateName);
+        if (!template) {
+            return {
+                success: false,
+                errors: [`Template '${templateName}' not found`],
+                warnings: []
+            };
+        }
+        // Validate parameters
+        const validation = this.validateParameters(templateName, params);
+        if (!validation.valid) {
+            return {
+                success: false,
+                errors: validation.errors,
+                warnings: validation.warnings
+            };
+        }
+        try {
+            // Load template source
+            const templateSource = this.loadTemplateSource(template);
+            // Perform parameter substitution
+            const substitutedSource = this.substituteParameters(templateSource, validation.processedParams);
+            return {
+                success: true,
+                source: substitutedSource,
+                errors: [],
+                warnings: validation.warnings
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errors: [`Template generation failed: ${error.message}`],
+                warnings: validation.warnings
+            };
+        }
+    }
+    /**
+     * Perform parameter substitution in template source
+     */
+    static substituteParameters(source, params) {
+        let result = source;
+        // Replace each parameter placeholder
+        for (const [key, value] of Object.entries(params)) {
+            const placeholder = `{{${key}}}`;
+            const replacement = this.formatParameterValue(value);
+            // Replace all occurrences
+            result = result.replace(new RegExp(placeholder, 'g'), replacement);
+        }
+        // Check for unreplaced placeholders
+        const unreplacedMatches = result.match(/\{\{[^}]+\}\}/g);
+        if (unreplacedMatches) {
+            throw new Error(`Unreplaced template parameters: ${unreplacedMatches.join(', ')}`);
+        }
+        return result;
+    }
+    /**
+     * Format parameter value for code generation
+     */
+    static formatParameterValue(value) {
+        if (typeof value === 'string') {
+            return `"${value.replace(/"/g, '\\"')}"`; // Escape quotes
+        }
+        else if (typeof value === 'boolean') {
+            return value.toString();
+        }
+        else if (typeof value === 'number') {
+            return value.toString();
+        }
+        else {
+            return JSON.stringify(value);
+        }
+    }
+    /**
+     * Get template usage examples
+     */
+    static getTemplateExample(templateName) {
+        this.initialize();
+        const examples = {
+            'Token': `
+// Deploy a custom token
+const token = await demos.contracts.deployTemplate('Token', {
+    TOKEN_NAME: 'MyToken',
+    TOKEN_SYMBOL: 'MTK',
+    TOTAL_SUPPLY: 1000000,
+    DECIMALS: 18
+})
+
+// Interact with the token
+const balance = await token.balanceOf('address')
+await token.transfer('recipient', 100)
+`,
+            'Storage': `
+// Deploy a private storage contract
+const storage = await demos.contracts.deployTemplate('Storage', {
+    IS_PUBLIC: false,
+    MAX_KEYS: 500
+})
+
+// Use the storage
+await storage.store('myKey', 'myValue')
+const value = await storage.retrieve('myKey')
+`
+        };
+        return examples[templateName] || null;
+    }
+}
+exports.TemplateRegistry = TemplateRegistry;
+TemplateRegistry.templates = new Map();
+TemplateRegistry.initialized = false;
+//# sourceMappingURL=TemplateRegistry.js.map

package/build/contracts/templates/TemplateRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateRegistry.js","sourceRoot":"","sources":["../../../../src/contracts/templates/TemplateRegistry.ts"],"names":[],"mappings":"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"}

package/build/contracts/templates/TemplateValidator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Template parameter validation system
+ *
+ * Validates template parameters before deployment to ensure
+ * safe and correct contract generation.
+ */
+export interface TemplateParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'address';
+    required: boolean;
+    default?: any;
+    min?: number;
+    max?: number;
+    pattern?: RegExp;
+    description: string;
+}
+export interface TemplateSchema {
+    name: string;
+    description: string;
+    parameters: TemplateParameter[];
+    version: string;
+    author?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    processedParams: Record<string, any>;
+}
+export declare class TemplateValidator {
+    /**
+     * Validate parameters against a template schema
+     */
+    static validate(schema: TemplateSchema, params?: Record<string, any>): ValidationResult;
+    /**
+     * Validate parameter type
+     */
+    private static validateType;
+    /**
+     * Validate number range
+     */
+    private static validateNumberRange;
+    /**
+     * Validate string pattern
+     */
+    private static validatePattern;
+    /**
+     * Validate address format
+     */
+    private static validateAddress;
+    /**
+     * Get human-readable validation summary
+     */
+    static getValidationSummary(result: ValidationResult): string;
+}

package/build/contracts/templates/TemplateValidator.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Template parameter validation system
+ *
+ * Validates template parameters before deployment to ensure
+ * safe and correct contract generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateValidator = void 0;
+class TemplateValidator {
+    /**
+     * Validate parameters against a template schema
+     */
+    static validate(schema, params = {}) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            processedParams: {}
+        };
+        // Check each parameter in the schema
+        for (const paramDef of schema.parameters) {
+            const value = params[paramDef.name];
+            const hasValue = value !== undefined && value !== null;
+            // Check required parameters
+            if (paramDef.required && !hasValue) {
+                result.errors.push(`Required parameter '${paramDef.name}' is missing`);
+                continue;
+            }
+            // Use default value if not provided
+            const finalValue = hasValue ? value : paramDef.default;
+            // Skip validation if no value and not required
+            if (finalValue === undefined || finalValue === null) {
+                continue;
+            }
+            // Type validation
+            const typeValidation = this.validateType(paramDef, finalValue);
+            if (!typeValidation.valid) {
+                result.errors.push(...typeValidation.errors);
+                continue;
+            }
+            // Range validation for numbers
+            if (paramDef.type === 'number') {
+                const rangeValidation = this.validateNumberRange(paramDef, finalValue);
+                if (!rangeValidation.valid) {
+                    result.errors.push(...rangeValidation.errors);
+                    result.warnings.push(...rangeValidation.warnings);
+                }
+            }
+            // Pattern validation for strings
+            if (paramDef.type === 'string' && paramDef.pattern) {
+                const patternValidation = this.validatePattern(paramDef, finalValue);
+                if (!patternValidation.valid) {
+                    result.errors.push(...patternValidation.errors);
+                }
+            }
+            // Address validation
+            if (paramDef.type === 'address') {
+                const addressValidation = this.validateAddress(paramDef, finalValue);
+                if (!addressValidation.valid) {
+                    result.errors.push(...addressValidation.errors);
+                }
+            }
+            result.processedParams[paramDef.name] = finalValue;
+        }
+        // Check for unknown parameters
+        for (const paramName of Object.keys(params)) {
+            const isDefined = schema.parameters.some(p => p.name === paramName);
+            if (!isDefined) {
+                result.warnings.push(`Unknown parameter '${paramName}' will be ignored`);
+            }
+        }
+        result.valid = result.errors.length === 0;
+        return result;
+    }
+    /**
+     * Validate parameter type
+     */
+    static validateType(paramDef, value) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            processedParams: {}
+        };
+        const actualType = typeof value;
+        switch (paramDef.type) {
+            case 'string':
+                if (actualType !== 'string') {
+                    result.errors.push(`Parameter '${paramDef.name}' must be a string, got ${actualType}`);
+                    result.valid = false;
+                }
+                break;
+            case 'number':
+                if (actualType !== 'number' || isNaN(value)) {
+                    result.errors.push(`Parameter '${paramDef.name}' must be a number, got ${actualType}`);
+                    result.valid = false;
+                }
+                break;
+            case 'boolean':
+                if (actualType !== 'boolean') {
+                    result.errors.push(`Parameter '${paramDef.name}' must be a boolean, got ${actualType}`);
+                    result.valid = false;
+                }
+                break;
+            case 'address':
+                if (actualType !== 'string') {
+                    result.errors.push(`Parameter '${paramDef.name}' must be an address string, got ${actualType}`);
+                    result.valid = false;
+                }
+                break;
+        }
+        return result;
+    }
+    /**
+     * Validate number range
+     */
+    static validateNumberRange(paramDef, value) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            processedParams: {}
+        };
+        if (paramDef.min !== undefined && value < paramDef.min) {
+            result.errors.push(`Parameter '${paramDef.name}' must be at least ${paramDef.min}, got ${value}`);
+            result.valid = false;
+        }
+        if (paramDef.max !== undefined && value > paramDef.max) {
+            result.errors.push(`Parameter '${paramDef.name}' must be at most ${paramDef.max}, got ${value}`);
+            result.valid = false;
+        }
+        // Warnings for edge cases
+        if (paramDef.name.includes('Supply') && value > 1000000000) {
+            result.warnings.push(`Large supply value for '${paramDef.name}': ${value}. Consider decimal precision.`);
+        }
+        return result;
+    }
+    /**
+     * Validate string pattern
+     */
+    static validatePattern(paramDef, value) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            processedParams: {}
+        };
+        if (paramDef.pattern && !paramDef.pattern.test(value)) {
+            result.errors.push(`Parameter '${paramDef.name}' does not match required pattern: ${paramDef.pattern}`);
+            result.valid = false;
+        }
+        return result;
+    }
+    /**
+     * Validate address format
+     */
+    static validateAddress(paramDef, value) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            processedParams: {}
+        };
+        // Basic address validation (adjust for Demos Network format)
+        const addressPattern = /^[a-fA-F0-9]{64}$/;
+        if (!addressPattern.test(value)) {
+            result.errors.push(`Parameter '${paramDef.name}' is not a valid address format`);
+            result.valid = false;
+        }
+        return result;
+    }
+    /**
+     * Get human-readable validation summary
+     */
+    static getValidationSummary(result) {
+        const lines = [];
+        if (result.valid) {
+            lines.push('✅ Validation passed');
+        }
+        else {
+            lines.push('❌ Validation failed');
+        }
+        if (result.errors.length > 0) {
+            lines.push('\nErrors:');
+            result.errors.forEach(error => lines.push(`  • ${error}`));
+        }
+        if (result.warnings.length > 0) {
+            lines.push('\nWarnings:');
+            result.warnings.forEach(warning => lines.push(`  • ${warning}`));
+        }
+        if (Object.keys(result.processedParams).length > 0) {
+            lines.push('\nProcessed parameters:');
+            Object.entries(result.processedParams).forEach(([key, value]) => {
+                lines.push(`  • ${key}: ${JSON.stringify(value)}`);
+            });
+        }
+        return lines.join('\n');
+    }
+}
+exports.TemplateValidator = TemplateValidator;
+//# sourceMappingURL=TemplateValidator.js.map

package/build/contracts/templates/TemplateValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateValidator.js","sourceRoot":"","sources":["../../../../src/contracts/templates/TemplateValidator.ts"],"names":[],"mappings":"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"}