@kynesyslabs/demosdk 2.3.27 → 2.4.0

package/build/contracts/ContractDeployer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Contract deployment functionality for Demos SDK
+ */
+import { Demos } from '../websdk/demosclass';
+import { ContractDeploymentResult, ContractDeployOptions } from './types/ContractABI';
+import { ContractInstance } from './ContractInstance';
+export declare class ContractDeployer {
+    private demos;
+    constructor(demos: Demos);
+    /**
+     * Deploy a new smart contract
+     * @param source TypeScript source code of the contract
+     * @param constructorArgs Arguments for the contract constructor
+     * @param options Deployment options
+     * @returns Deployment result with contract address
+     */
+    deploy(source: string, constructorArgs?: any[], options?: ContractDeployOptions): Promise<ContractDeploymentResult>;
+    /**
+     * Deploy a contract and return an instance wrapper
+     */
+    deployAndWrap<T = any>(source: string, constructorArgs?: any[], options?: ContractDeployOptions): Promise<ContractInstance<T>>;
+    /**
+     * Validate contract source code
+     */
+    private validateSourceCode;
+    /**
+     * Build deployment transaction
+     */
+    private buildDeployTransaction;
+    /**
+     * Wait for contract deployment confirmation
+     */
+    private waitForDeployment;
+}

package/build/contracts/ContractDeployer.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * Contract deployment 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.ContractDeployer = void 0;
+const ContractInstance_1 = require("./ContractInstance");
+const unifiedCrypto_1 = require("../encryption/unifiedCrypto");
+const skeletons = __importStar(require("../websdk/utils/skeletons"));
+class ContractDeployer {
+    constructor(demos) {
+        this.demos = demos;
+    }
+    /**
+     * Deploy a new smart contract
+     * @param source TypeScript source code of the contract
+     * @param constructorArgs Arguments for the contract constructor
+     * @param options Deployment options
+     * @returns Deployment result with contract address
+     */
+    async deploy(source, constructorArgs = [], options = {}) {
+        try {
+            // Validate wallet connection
+            if (!this.demos.walletConnected) {
+                throw new Error('Wallet not connected. Please connect a wallet first.');
+            }
+            // Validate source code
+            if (options.validateSource !== false) {
+                this.validateSourceCode(source);
+            }
+            // Prepare deployment payload
+            const deployPayload = {
+                source,
+                constructorArgs,
+                metadata: options.metadata
+            };
+            // Build the deployment transaction
+            const tx = await this.buildDeployTransaction(deployPayload, options);
+            // Send the transaction
+            const rpcResult = await this.demos.rpcCall({
+                method: 'sendTransaction',
+                params: [tx]
+            });
+            if (rpcResult.result !== 200) {
+                return {
+                    success: false,
+                    error: rpcResult.response?.error || 'Deployment failed'
+                };
+            }
+            // Wait for confirmation if requested
+            if (options.waitForConfirmation !== false) {
+                const confirmation = await this.waitForDeployment(rpcResult.response.transactionHash, options.confirmations || 1);
+                if (!confirmation.success) {
+                    return {
+                        success: false,
+                        error: confirmation.error
+                    };
+                }
+                return {
+                    success: true,
+                    contractAddress: confirmation.contractAddress,
+                    deploymentTx: rpcResult.response.transactionHash,
+                    gasUsed: confirmation.gasUsed,
+                    blockHeight: confirmation.blockHeight
+                };
+            }
+            return {
+                success: true,
+                deploymentTx: rpcResult.response.transactionHash,
+                contractAddress: rpcResult.response.contractAddress
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message || 'Contract deployment failed'
+            };
+        }
+    }
+    /**
+     * Deploy a contract and return an instance wrapper
+     */
+    async deployAndWrap(source, constructorArgs = [], options = {}) {
+        const result = await this.deploy(source, constructorArgs, options);
+        if (!result.success || !result.contractAddress) {
+            throw new Error(result.error || 'Deployment failed');
+        }
+        return new ContractInstance_1.ContractInstance(this.demos, result.contractAddress, options.metadata?.abi);
+    }
+    /**
+     * Validate contract source code
+     */
+    validateSourceCode(source) {
+        // Check for basic contract structure
+        if (!source.includes('DemosContract')) {
+            throw new Error('Contract must extend DemosContract');
+        }
+        // Check for banned APIs
+        const bannedAPIs = [
+            'eval', 'Function', 'setTimeout', 'setInterval',
+            'XMLHttpRequest', 'fetch', 'WebSocket', 'Worker'
+        ];
+        for (const api of bannedAPIs) {
+            if (source.includes(api)) {
+                throw new Error(`Banned API detected: ${api}`);
+            }
+        }
+        // Check size limit (256KB)
+        const sizeInBytes = new TextEncoder().encode(source).length;
+        if (sizeInBytes > 256 * 1024) {
+            throw new Error(`Contract too large: ${sizeInBytes} bytes (max 256KB)`);
+        }
+    }
+    /**
+     * Build deployment transaction
+     */
+    async buildDeployTransaction(payload, options) {
+        const { publicKey } = await this.demos.crypto.getIdentity('ed25519');
+        const publicKeyHex = (0, unifiedCrypto_1.uint8ArrayToHex)(publicKey);
+        const nonce = await this.demos.getAddressNonce(publicKeyHex);
+        const tx = structuredClone(skeletons.transaction);
+        tx.content.type = 'contractDeploy';
+        tx.content.data = ['contractDeploy', payload];
+        tx.content.nonce = options.nonce || nonce;
+        tx.content.from = publicKeyHex;
+        tx.content.timestamp = Date.now();
+        tx.content.amount = Number(options.value || 0);
+        // Sign the transaction
+        return await this.demos.sign(tx);
+    }
+    /**
+     * Wait for contract deployment confirmation
+     */
+    async waitForDeployment(txHash, confirmations) {
+        const maxAttempts = 30; // 30 seconds timeout
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+            const result = await this.demos.rpcCall({
+                method: 'getTransactionReceipt',
+                params: [txHash]
+            });
+            if (result.result === 200 && result.response) {
+                const receipt = result.response;
+                if (receipt.confirmations >= confirmations) {
+                    return {
+                        success: true,
+                        contractAddress: receipt.contractAddress,
+                        gasUsed: receipt.gasUsed,
+                        blockHeight: receipt.blockHeight
+                    };
+                }
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            attempts++;
+        }
+        return {
+            success: false,
+            error: 'Deployment confirmation timeout'
+        };
+    }
+}
+exports.ContractDeployer = ContractDeployer;
+//# sourceMappingURL=ContractDeployer.js.map

package/build/contracts/ContractDeployer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractDeployer.js","sourceRoot":"","sources":["../../../src/contracts/ContractDeployer.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASH,yDAAqD;AAGrD,+DAA6D;AAC7D,qEAAsD;AAEtD,MAAa,gBAAgB;IACzB,YAAoB,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAEpC;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACR,MAAc,EACd,kBAAyB,EAAE,EAC3B,UAAiC,EAAE;QAEnC,IAAI,CAAC;YACD,6BAA6B;YAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;YAC3E,CAAC;YAED,uBAAuB;YACvB,IAAI,OAAO,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;gBACnC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;YACnC,CAAC;YAED,6BAA6B;YAC7B,MAAM,aAAa,GAA0B;gBACzC,MAAM;gBACN,eAAe;gBACf,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC7B,CAAA;YAED,mCAAmC;YACnC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;YAEpE,uBAAuB;YACvB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBACvC,MAAM,EAAE,iBAAiB;gBACzB,MAAM,EAAE,CAAC,EAAE,CAAC;aACD,CAAC,CAAA;YAEhB,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC3B,OAAO;oBACH,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,KAAK,IAAI,mBAAmB;iBAC1D,CAAA;YACL,CAAC;YAED,qCAAqC;YACrC,IAAI,OAAO,CAAC,mBAAmB,KAAK,KAAK,EAAE,CAAC;gBACxC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAC7C,SAAS,CAAC,QAAQ,CAAC,eAAe,EAClC,OAAO,CAAC,aAAa,IAAI,CAAC,CAC7B,CAAA;gBAED,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;oBACxB,OAAO;wBACH,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,YAAY,CAAC,KAAK;qBAC5B,CAAA;gBACL,CAAC;gBAED,OAAO;oBACH,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,YAAY,CAAC,eAAe;oBAC7C,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC,eAAe;oBAChD,OAAO,EAAE,YAAY,CAAC,OAAO;oBAC7B,WAAW,EAAE,YAAY,CAAC,WAAW;iBACxC,CAAA;YACL,CAAC;YAED,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC,eAAe;gBAChD,eAAe,EAAE,SAAS,CAAC,QAAQ,CAAC,eAAe;aACtD,CAAA;QAEL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO,IAAI,4BAA4B;aAClE,CAAA;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACf,MAAc,EACd,kBAAyB,EAAE,EAC3B,UAAiC,EAAE;QAEnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,CAAA;QAElE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAA;QACxD,CAAC;QAED,OAAO,IAAI,mCAAgB,CACvB,IAAI,CAAC,KAAK,EACV,MAAM,CAAC,eAAe,EACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CACxB,CAAA;IACL,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,MAAc;QACrC,qCAAqC;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACzD,CAAC;QAED,wBAAwB;QACxB,MAAM,UAAU,GAAG;YACf,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa;YAC/C,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ;SACnD,CAAA;QAED,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;YAClD,CAAC;QACL,CAAC;QAED,2BAA2B;QAC3B,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAA;QAC3D,IAAI,WAAW,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,WAAW,oBAAoB,CAAC,CAAA;QAC3E,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,sBAAsB,CAChC,OAA8B,EAC9B,OAA4B;QAE5B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;QACpE,MAAM,YAAY,GAAG,IAAA,+BAAe,EAAC,SAAuB,CAAC,CAAA;QAC7D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,YAAY,CAAC,CAAA;QAE5D,MAAM,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QACjD,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAClC,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;QAC7C,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;QACzC,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;QAC9B,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACjC,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;QAE9C,uBAAuB;QACvB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACpC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC3B,MAAc,EACd,aAAqB;QAErB,MAAM,WAAW,GAAG,EAAE,CAAA,CAAC,qBAAqB;QAC5C,IAAI,QAAQ,GAAG,CAAC,CAAA;QAEhB,OAAO,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBACpC,MAAM,EAAE,uBAAuB;gBAC/B,MAAM,EAAE,CAAC,MAAM,CAAC;aACL,CAAC,CAAA;YAEhB,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAA;gBAC/B,IAAI,OAAO,CAAC,aAAa,IAAI,aAAa,EAAE,CAAC;oBACzC,OAAO;wBACH,OAAO,EAAE,IAAI;wBACb,eAAe,EAAE,OAAO,CAAC,eAAe;wBACxC,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,WAAW,EAAE,OAAO,CAAC,WAAW;qBACnC,CAAA;gBACL,CAAC;YACL,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;YACvD,QAAQ,EAAE,CAAA;QACd,CAAC;QAED,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,iCAAiC;SAC3C,CAAA;IACL,CAAC;CACJ;AAnMD,4CAmMC"}

package/build/contracts/ContractFactory.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Factory for creating contract instances
+ */
+import { Demos } from '../websdk/demosclass';
+import { ContractDeployer } from './ContractDeployer';
+import { ContractInteractor } from './ContractInteractor';
+import { ContractInstance } from './ContractInstance';
+import { ContractABI, ContractDeployOptions } from './types/ContractABI';
+export declare class ContractFactory {
+    private demos;
+    private deployer;
+    private interactor;
+    constructor(demos: Demos);
+    /**
+     * Deploy a new contract
+     */
+    deploy(source: string, constructorArgs?: any[], options?: ContractDeployOptions): Promise<ContractInstance>;
+    /**
+     * Get an instance of an existing contract
+     */
+    at<T = any>(address: string, abi?: ContractABI): Promise<ContractInstance<T>>;
+    /**
+     * Create a batch operation builder
+     */
+    batch(): BatchBuilder;
+    /**
+     * Estimate gas for a contract call
+     */
+    estimateGas(contractAddress: string, method: string, args?: any[]): Promise<bigint>;
+}
+/**
+ * Batch operation builder
+ */
+export declare class BatchBuilder {
+    private demos;
+    private deployer;
+    private interactor;
+    private operations;
+    constructor(demos: Demos, deployer: ContractDeployer, interactor: ContractInteractor);
+    /**
+     * Add a deployment to the batch
+     */
+    deploy(source: string, constructorArgs?: any[], options?: ContractDeployOptions): BatchBuilder;
+    /**
+     * Add a contract call to the batch
+     */
+    call(contractAddress: string, method: string, args?: any[]): BatchBuilder;
+    /**
+     * Execute all operations in the batch
+     */
+    execute(): Promise<any[]>;
+}

package/build/contracts/ContractFactory.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Factory for creating contract instances
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchBuilder = exports.ContractFactory = void 0;
+const ContractDeployer_1 = require("./ContractDeployer");
+const ContractInteractor_1 = require("./ContractInteractor");
+const ContractInstance_1 = require("./ContractInstance");
+class ContractFactory {
+    constructor(demos) {
+        this.demos = demos;
+        this.deployer = new ContractDeployer_1.ContractDeployer(demos);
+        this.interactor = new ContractInteractor_1.ContractInteractor(demos);
+    }
+    /**
+     * Deploy a new contract
+     */
+    async deploy(source, constructorArgs = [], options = {}) {
+        return await this.deployer.deployAndWrap(source, constructorArgs, options);
+    }
+    /**
+     * Get an instance of an existing contract
+     */
+    async at(address, abi) {
+        return new ContractInstance_1.ContractInstance(this.demos, address, abi);
+    }
+    /**
+     * Create a batch operation builder
+     */
+    batch() {
+        return new BatchBuilder(this.demos, this.deployer, this.interactor);
+    }
+    /**
+     * Estimate gas for a contract call
+     */
+    async estimateGas(contractAddress, method, args = []) {
+        const result = await this.demos.rpcCall({
+            method: 'estimateGas',
+            params: [{
+                    contractAddress,
+                    method,
+                    args
+                }]
+        });
+        if (result.result === 200) {
+            return BigInt(result.response.gasEstimate || 0);
+        }
+        throw new Error('Failed to estimate gas');
+    }
+}
+exports.ContractFactory = ContractFactory;
+/**
+ * Batch operation builder
+ */
+class BatchBuilder {
+    constructor(demos, deployer, interactor) {
+        this.demos = demos;
+        this.deployer = deployer;
+        this.interactor = interactor;
+        this.operations = [];
+    }
+    /**
+     * Add a deployment to the batch
+     */
+    deploy(source, constructorArgs = [], options = {}) {
+        this.operations.push(async () => await this.deployer.deploy(source, constructorArgs, options));
+        return this;
+    }
+    /**
+     * Add a contract call to the batch
+     */
+    call(contractAddress, method, args = []) {
+        this.operations.push(async () => await this.interactor.call(contractAddress, method, args));
+        return this;
+    }
+    /**
+     * Execute all operations in the batch
+     */
+    async execute() {
+        const results = [];
+        for (const operation of this.operations) {
+            try {
+                const result = await operation();
+                results.push(result);
+            }
+            catch (error) {
+                results.push({
+                    success: false,
+                    error: error.message
+                });
+            }
+        }
+        return results;
+    }
+}
+exports.BatchBuilder = BatchBuilder;
+//# sourceMappingURL=ContractFactory.js.map

package/build/contracts/ContractFactory.js.map

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

package/build/contracts/ContractInstance.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Contract instance wrapper for easy interaction
+ */
+import { Demos } from '../websdk/demosclass';
+import { ContractCallResult, ContractCallOptions, ContractABI } from './types/ContractABI';
+import { ContractInstance as IContractInstance } from './types/TypedContract';
+export declare class ContractInstance<T = any> implements IContractInstance<T> {
+    private demos;
+    address: string;
+    abi?: ContractABI;
+    private interactor;
+    methods: T;
+    constructor(demos: Demos, address: string, abi?: ContractABI);
+    /**
+     * Call a contract method
+     */
+    call<R = any>(method: string, args?: any[], options?: ContractCallOptions): Promise<ContractCallResult<R>>;
+    /**
+     * Send DEM with a contract call
+     */
+    callWithValue<R = any>(method: string, args: any[], value: bigint | number, options?: ContractCallOptions): Promise<ContractCallResult<R>>;
+    /**
+     * Get contract state (if accessible)
+     */
+    getState(key?: string): Promise<any>;
+    /**
+     * Get contract metadata
+     */
+    getMetadata(): Promise<any>;
+    /**
+     * Get contract events
+     */
+    getEvents(params?: {
+        eventName?: string;
+        fromBlock?: number;
+        toBlock?: number;
+        limit?: number;
+    }): Promise<any[]>;
+    /**
+     * Setup method proxies based on ABI
+     */
+    private setupMethodProxies;
+    /**
+     * Create a typed instance from ABI
+     */
+    static fromABI<T>(demos: Demos, address: string, abi: ContractABI): ContractInstance<T>;
+    /**
+     * Wait for contract to be deployed at address
+     */
+    static waitForDeployment(demos: Demos, address: string, timeout?: number): Promise<boolean>;
+}

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;
+}