@kynesyslabs/demosdk 2.3.28 → 2.4.1

package/build/contracts/ContractInstance.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * Contract instance wrapper for easy interaction
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractInstance = void 0;
+const ContractInteractor_1 = require("./ContractInteractor");
+class ContractInstance {
+    constructor(demos, address, abi) {
+        this.demos = demos;
+        this.address = address;
+        this.abi = abi;
+        this.methods = {};
+        this.interactor = new ContractInteractor_1.ContractInteractor(demos);
+        // Set up method proxies if ABI is provided
+        if (abi && abi.functions) {
+            this.setupMethodProxies();
+        }
+        // Set up general proxy for dynamic method calls
+        return new Proxy(this, {
+            get: (target, prop) => {
+                // Return existing properties
+                if (prop in target) {
+                    return target[prop];
+                }
+                // Create dynamic method caller
+                if (typeof prop === 'string' && !prop.startsWith('_')) {
+                    return (...args) => this.call(prop, args);
+                }
+                return undefined;
+            }
+        });
+    }
+    /**
+     * Call a contract method
+     */
+    async call(method, args = [], options) {
+        return await this.interactor.call(this.address, method, args, options);
+    }
+    /**
+     * Send DEM with a contract call
+     */
+    async callWithValue(method, args, value, options) {
+        return await this.call(method, args, {
+            ...options,
+            value
+        });
+    }
+    /**
+     * Get contract state (if accessible)
+     */
+    async getState(key) {
+        if (key) {
+            return await this.call('getState', [key]);
+        }
+        return await this.call('getState', []);
+    }
+    /**
+     * Get contract metadata
+     */
+    async getMetadata() {
+        const result = await this.demos.rpcCall({
+            method: 'getContractMetadata',
+            params: [this.address]
+        });
+        return result.result === 200 ? result.response : null;
+    }
+    /**
+     * Get contract events
+     */
+    async getEvents(params) {
+        const result = await this.demos.rpcCall({
+            method: 'getContractEvents',
+            params: [{
+                    contractAddress: this.address,
+                    ...params
+                }]
+        });
+        return result.result === 200 ? result.response.events : [];
+    }
+    /**
+     * Setup method proxies based on ABI
+     */
+    setupMethodProxies() {
+        if (!this.abi || !this.abi.functions)
+            return;
+        for (const func of this.abi.functions) {
+            if (func.visibility === 'public') {
+                this.methods[func.name] = async (...args) => {
+                    // Validate argument count
+                    const requiredParams = func.parameters.filter(p => !p.optional).length;
+                    if (args.length < requiredParams) {
+                        throw new Error(`Method ${func.name} expects at least ${requiredParams} arguments, got ${args.length}`);
+                    }
+                    // Determine if this is a view call
+                    const isView = func.mutability === 'view' || func.mutability === 'pure';
+                    const options = {};
+                    if (func.mutability === 'payable' && args.length > func.parameters.length) {
+                        // Last argument might be value
+                        options.value = args.pop();
+                    }
+                    const result = await this.call(func.name, args, options);
+                    if (result.success) {
+                        return result.result;
+                    }
+                    else {
+                        throw new Error(result.error || `Call to ${func.name} failed`);
+                    }
+                };
+            }
+        }
+    }
+    /**
+     * Create a typed instance from ABI
+     */
+    static fromABI(demos, address, abi) {
+        return new ContractInstance(demos, address, abi);
+    }
+    /**
+     * Wait for contract to be deployed at address
+     */
+    static async waitForDeployment(demos, address, timeout = 30000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const result = await demos.rpcCall({
+                method: 'getContract',
+                params: [address]
+            });
+            if (result.result === 200 && result.response) {
+                return true;
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+        }
+        return false;
+    }
+}
+exports.ContractInstance = ContractInstance;
+//# sourceMappingURL=ContractInstance.js.map

package/build/contracts/ContractInstance.js.map

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

package/build/contracts/ContractInteractor.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Contract interaction functionality for Demos SDK
+ */
+import { Demos } from '../websdk/demosclass';
+import { ContractCallResult, ContractCallOptions } from './types/ContractABI';
+export declare class ContractInteractor {
+    private demos;
+    constructor(demos: Demos);
+    /**
+     * Call a smart contract method
+     * @param contractAddress The contract address
+     * @param method The method name to call
+     * @param args Arguments for the method
+     * @param options Call options
+     * @returns Call result
+     */
+    call<T = any>(contractAddress: string, method: string, args?: any[], options?: ContractCallOptions): Promise<ContractCallResult<T>>;
+    /**
+     * Batch multiple contract calls
+     */
+    batchCall(calls: Array<{
+        contractAddress: string;
+        method: string;
+        args: any[];
+        options?: ContractCallOptions;
+    }>): Promise<ContractCallResult[]>;
+    /**
+     * Read-only contract call (no transaction)
+     */
+    private viewCall;
+    /**
+     * State-changing contract call (sends transaction)
+     */
+    private transactionCall;
+    /**
+     * Build contract call transaction
+     */
+    private buildCallTransaction;
+    /**
+     * Check if a call is view/pure (read-only)
+     */
+    private isViewCall;
+    /**
+     * Wait for transaction confirmation
+     */
+    private waitForTransaction;
+    /**
+     * Helper to send RPC requests
+     */
+    private sendRPC;
+    /**
+     * Helper to sign transactions
+     */
+    private signTransaction;
+}

package/build/contracts/ContractInteractor.js

@@ -0,0 +1,242 @@
+"use strict";
+/**
+ * Contract interaction functionality for Demos SDK
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractInteractor = void 0;
+const unifiedCrypto_1 = require("../encryption/unifiedCrypto");
+const skeletons = __importStar(require("../websdk/utils/skeletons"));
+class ContractInteractor {
+    constructor(demos) {
+        this.demos = demos;
+    }
+    /**
+     * Call a smart contract method
+     * @param contractAddress The contract address
+     * @param method The method name to call
+     * @param args Arguments for the method
+     * @param options Call options
+     * @returns Call result
+     */
+    async call(contractAddress, method, args = [], options = {}) {
+        try {
+            // For view/pure calls, use call RPC (no transaction needed)
+            if (this.isViewCall(method, options)) {
+                return await this.viewCall(contractAddress, method, args);
+            }
+            // For state-changing calls, send a transaction
+            return await this.transactionCall(contractAddress, method, args, options);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message || 'Contract call failed'
+            };
+        }
+    }
+    /**
+     * Batch multiple contract calls
+     */
+    async batchCall(calls) {
+        const results = [];
+        for (const call of calls) {
+            const result = await this.call(call.contractAddress, call.method, call.args, call.options);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Read-only contract call (no transaction)
+     */
+    async viewCall(contractAddress, method, args) {
+        const result = await this.sendRPC({
+            method: 'contractCall',
+            params: [{
+                    contractAddress,
+                    method,
+                    args,
+                    readOnly: true
+                }]
+        });
+        if (result.result !== 200) {
+            return {
+                success: false,
+                error: result.response?.error || 'View call failed'
+            };
+        }
+        return {
+            success: true,
+            result: result.response.returnValue,
+            gasUsed: result.response.gasUsed
+        };
+    }
+    /**
+     * State-changing contract call (sends transaction)
+     */
+    async transactionCall(contractAddress, method, args, options) {
+        // Validate wallet connection
+        if (!this.demos.walletConnected) {
+            throw new Error('Wallet not connected. Please connect a wallet first.');
+        }
+        // Build the call transaction
+        const tx = await this.buildCallTransaction(contractAddress, method, args, options);
+        // Send the transaction
+        const result = await this.sendRPC({
+            method: 'sendTransaction',
+            params: [tx]
+        });
+        if (result.result !== 200) {
+            return {
+                success: false,
+                error: result.response?.error || 'Transaction failed'
+            };
+        }
+        // Wait for confirmation if requested
+        if (options.waitForConfirmation !== false) {
+            const confirmation = await this.waitForTransaction(result.response.transactionHash, options.confirmations || 1);
+            if (!confirmation.success) {
+                return {
+                    success: false,
+                    error: confirmation.error
+                };
+            }
+            return {
+                success: true,
+                result: confirmation.returnValue,
+                gasUsed: confirmation.gasUsed,
+                events: confirmation.events,
+                transactionHash: result.response.transactionHash,
+                blockHeight: confirmation.blockHeight
+            };
+        }
+        return {
+            success: true,
+            transactionHash: result.response.transactionHash
+        };
+    }
+    /**
+     * Build contract call transaction
+     */
+    async buildCallTransaction(contractAddress, method, args, options) {
+        const { publicKey } = await this.demos.crypto.getIdentity('ed25519');
+        const publicKeyHex = (0, unifiedCrypto_1.uint8ArrayToHex)(publicKey);
+        const nonce = options.nonce ?? await this.demos.getAddressNonce(publicKeyHex);
+        const payload = {
+            contractAddress,
+            method,
+            args
+        };
+        const tx = structuredClone(skeletons.transaction);
+        tx.content.type = 'contractCall';
+        tx.content.data = ['contractCall', payload];
+        tx.content.nonce = nonce;
+        tx.content.from = publicKeyHex;
+        tx.content.timestamp = Date.now();
+        tx.content.amount = Number(options.value || 0);
+        // Sign the transaction
+        return await this.signTransaction(tx);
+    }
+    /**
+     * Check if a call is view/pure (read-only)
+     */
+    isViewCall(method, options) {
+        // Check if explicitly marked as view
+        if (options.value && options.value > 0) {
+            return false; // Calls with value are never view
+        }
+        // Common view method patterns
+        const viewPatterns = [
+            /^get/i,
+            /^is/i,
+            /^has/i,
+            /^check/i,
+            /^view/i,
+            /^read/i,
+            /balance/i,
+            /supply/i,
+            /owner/i,
+            /allowance/i
+        ];
+        return viewPatterns.some(pattern => pattern.test(method));
+    }
+    /**
+     * Wait for transaction confirmation
+     */
+    async waitForTransaction(txHash, confirmations) {
+        const maxAttempts = 30; // 30 seconds timeout
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+            const result = await this.sendRPC({
+                method: 'getTransactionReceipt',
+                params: [txHash]
+            });
+            if (result.result === 200 && result.response) {
+                const receipt = result.response;
+                if (receipt.confirmations >= confirmations) {
+                    return {
+                        success: true,
+                        returnValue: receipt.returnValue,
+                        gasUsed: receipt.gasUsed,
+                        events: receipt.events,
+                        blockHeight: receipt.blockHeight
+                    };
+                }
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            attempts++;
+        }
+        return {
+            success: false,
+            error: 'Transaction confirmation timeout'
+        };
+    }
+    /**
+     * Helper to send RPC requests
+     */
+    async sendRPC(request) {
+        // This will be implemented through the main Demos class
+        return await this.demos.rpcCall(request);
+    }
+    /**
+     * Helper to sign transactions
+     */
+    async signTransaction(tx) {
+        // This will be implemented through the main Demos class
+        return await this.demos.sign(tx);
+    }
+}
+exports.ContractInteractor = ContractInteractor;
+//# sourceMappingURL=ContractInteractor.js.map

package/build/contracts/ContractInteractor.js.map

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

package/build/contracts/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Contract module exports
+ */
+export { ContractDeployer } from './ContractDeployer';
+export { ContractInteractor } from './ContractInteractor';
+export { ContractInstance } from './ContractInstance';
+export { ContractFactory, BatchBuilder } from './ContractFactory';
+export type { ContractABI, ContractMetadata, ContractCallResult, ContractDeploymentResult, ContractCallOptions, ContractDeployOptions, ABIFunction, ABIEvent, ABIParameter } from './types/ContractABI';
+export type { TypedContract, ContractInterface, ContractMethodParams, ContractMethodReturn } from './types/TypedContract';

package/build/contracts/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Contract module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchBuilder = exports.ContractFactory = exports.ContractInstance = exports.ContractInteractor = exports.ContractDeployer = void 0;
+var ContractDeployer_1 = require("./ContractDeployer");
+Object.defineProperty(exports, "ContractDeployer", { enumerable: true, get: function () { return ContractDeployer_1.ContractDeployer; } });
+var ContractInteractor_1 = require("./ContractInteractor");
+Object.defineProperty(exports, "ContractInteractor", { enumerable: true, get: function () { return ContractInteractor_1.ContractInteractor; } });
+var ContractInstance_1 = require("./ContractInstance");
+Object.defineProperty(exports, "ContractInstance", { enumerable: true, get: function () { return ContractInstance_1.ContractInstance; } });
+var ContractFactory_1 = require("./ContractFactory");
+Object.defineProperty(exports, "ContractFactory", { enumerable: true, get: function () { return ContractFactory_1.ContractFactory; } });
+Object.defineProperty(exports, "BatchBuilder", { enumerable: true, get: function () { return ContractFactory_1.BatchBuilder; } });
+//# sourceMappingURL=index.js.map

package/build/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AACzB,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAC3B,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AACzB,qDAAiE;AAAxD,kHAAA,eAAe,OAAA;AAAE,+GAAA,YAAY,OAAA"}

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

@@ -0,0 +1,71 @@
+/**
+ * Template Registry with Parameter Substitution
+ *
+ * Manages contract templates, validates parameters, and performs
+ * parameter substitution to generate deployable contract source code.
+ */
+import { TemplateSchema, ValidationResult } from './TemplateValidator';
+export interface TemplateInfo {
+    name: string;
+    schema: TemplateSchema;
+    sourceFile: string;
+    source?: string;
+}
+export interface SubstitutionResult {
+    success: boolean;
+    source?: string;
+    errors: string[];
+    warnings: string[];
+}
+export declare class TemplateRegistry {
+    private static templates;
+    private static initialized;
+    /**
+     * Initialize the template registry with built-in templates
+     */
+    static initialize(): void;
+    /**
+     * Register a new template
+     */
+    static registerTemplate(templateInfo: TemplateInfo): void;
+    /**
+     * Get all available template names
+     */
+    static getAvailableTemplates(): string[];
+    /**
+     * Get template information
+     */
+    static getTemplate(name: string): TemplateInfo | null;
+    /**
+     * Get template schema for validation
+     */
+    static getTemplateSchema(name: string): TemplateSchema | null;
+    /**
+     * Load template source code
+     */
+    private static loadTemplateSource;
+    /**
+     * Get embedded template source (temporary implementation)
+     */
+    private static getEmbeddedTemplateSource;
+    /**
+     * Validate template parameters
+     */
+    static validateParameters(templateName: string, params: Record<string, any>): ValidationResult;
+    /**
+     * Generate contract source with parameter substitution
+     */
+    static generateContract(templateName: string, params?: Record<string, any>): SubstitutionResult;
+    /**
+     * Perform parameter substitution in template source
+     */
+    private static substituteParameters;
+    /**
+     * Format parameter value for code generation
+     */
+    private static formatParameterValue;
+    /**
+     * Get template usage examples
+     */
+    static getTemplateExample(templateName: string): string | null;
+}