@varity-labs/sdk 2.0.0-alpha.1

package/dist/modules/contracts/ContractsModule.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Varity SDK - Contracts Module
+ *
+ * Universal L3 smart contract interaction layer.
+ * Works across all templates (ISO, Healthcare, Retail, etc.)
+ */
+import { ethers } from 'ethers';
+import type { VaritySDK } from '../../core/VaritySDK';
+import type { TransactionReceipt } from '../../core/types';
+export interface TxOptions {
+    gasLimit?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    value?: bigint;
+    nonce?: number;
+}
+export interface ContractCall {
+    contractName: string;
+    method: string;
+    args: any[];
+}
+export interface MultiCall {
+    method: string;
+    args: any[];
+}
+export interface ContractConfig {
+    constructorArgs: any[];
+    options?: TxOptions;
+}
+export interface EventCallback {
+    (...args: any[]): void;
+}
+/**
+ * ContractsModule - Universal smart contract interaction
+ *
+ * @example
+ * ```typescript
+ * // Read from contract
+ * const merchant = await sdk.contracts.call(
+ *   'MerchantRegistry',
+ *   'getMerchant',
+ *   [merchantId]
+ * )
+ *
+ * // Write to contract
+ * const receipt = await sdk.contracts.send(
+ *   'MerchantRegistry',
+ *   'registerMerchant',
+ *   [businessName, owner, repId]
+ * )
+ *
+ * // Listen to events
+ * await sdk.contracts.listen('MerchantRegistry', 'MerchantRegistered', (event) => {
+ *   console.log('New merchant:', event.merchantId)
+ * })
+ * ```
+ */
+export declare class ContractsModule {
+    private sdk;
+    private contracts;
+    private eventListeners;
+    private static readonly ABI_REGISTRY;
+    constructor(sdk: VaritySDK);
+    /**
+     * Get or create contract instance
+     */
+    private getContractInstance;
+    /**
+     * Call contract method (read-only)
+     *
+     * @param contractName - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Method return value
+     */
+    call(contractName: string, method: string, args?: any[]): Promise<any>;
+    /**
+     * Send contract transaction (write)
+     *
+     * @param contractName - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @param options - Transaction options
+     * @returns Transaction receipt
+     */
+    send(contractName: string, method: string, args?: any[], options?: TxOptions): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas for transaction
+     *
+     * @param contractName - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Estimated gas
+     */
+    estimateGas(contractName: string, method: string, args?: any[]): Promise<bigint>;
+    /**
+     * Deploy new sovereign contract instance
+     *
+     * @param template - Template type (e.g., 'iso', 'healthcare')
+     * @param config - Deployment configuration
+     * @returns Deployed contract address
+     */
+    deploySovereignContract(template: string, config: ContractConfig): Promise<string>;
+    /**
+     * Get contract address by name
+     *
+     * @param contractName - Contract name
+     * @returns Contract address
+     */
+    getContractAddress(contractName: string): Promise<string>;
+    /**
+     * Get contract instance
+     *
+     * @param contractName - Contract name
+     * @returns Contract instance
+     */
+    getContract(contractName: string): Promise<ethers.Contract>;
+    /**
+     * Listen to contract events
+     *
+     * @param contractName - Contract name
+     * @param eventName - Event name
+     * @param callback - Event callback
+     */
+    listen(contractName: string, eventName: string, callback: EventCallback): Promise<void>;
+    /**
+     * Stop listening to contract events
+     *
+     * @param contractName - Contract name
+     * @param eventName - Event name
+     */
+    stopListening(contractName: string, eventName: string): Promise<void>;
+    /**
+     * Batch call multiple read-only methods
+     *
+     * @param calls - Array of contract calls
+     * @returns Array of results
+     */
+    batchCall(calls: ContractCall[]): Promise<any[]>;
+    /**
+     * Multicall on single contract
+     *
+     * @param contractName - Contract name
+     * @param calls - Array of method calls
+     * @returns Array of results
+     */
+    multicall(contractName: string, calls: MultiCall[]): Promise<any[]>;
+    /**
+     * Register custom contract ABI
+     *
+     * @param contractName - Contract name
+     * @param abi - Contract ABI
+     */
+    registerABI(contractName: string, abi: any): void;
+    /**
+     * Clear cached contract instances
+     */
+    clearCache(): void;
+    /**
+     * Remove all event listeners
+     */
+    removeAllListeners(): Promise<void>;
+}
+//# sourceMappingURL=ContractsModule.d.ts.map

package/dist/modules/contracts/ContractsModule.d.ts.map

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

package/dist/modules/contracts/ContractsModule.js

@@ -0,0 +1,242 @@
+/**
+ * Varity SDK - Contracts Module
+ *
+ * Universal L3 smart contract interaction layer.
+ * Works across all templates (ISO, Healthcare, Retail, etc.)
+ */
+import { ethers } from 'ethers';
+// Import all contract ABIs
+import MerchantRegistryABI from '../../contracts/abis/iso/MerchantRegistry.json';
+import TransactionVaultABI from '../../contracts/abis/iso/TransactionVault.json';
+import RepPerformanceABI from '../../contracts/abis/iso/RepPerformance.json';
+import ResidualCalculatorABI from '../../contracts/abis/iso/ResidualCalculator.json';
+import AccessControlRegistryABI from '../../contracts/abis/iso/AccessControlRegistry.json';
+import DataProofRegistryABI from '../../contracts/abis/iso/DataProofRegistry.json';
+import VarityWalletFactoryABI from '../../contracts/abis/iso/VarityWalletFactory.json';
+/**
+ * ContractsModule - Universal smart contract interaction
+ *
+ * @example
+ * ```typescript
+ * // Read from contract
+ * const merchant = await sdk.contracts.call(
+ *   'MerchantRegistry',
+ *   'getMerchant',
+ *   [merchantId]
+ * )
+ *
+ * // Write to contract
+ * const receipt = await sdk.contracts.send(
+ *   'MerchantRegistry',
+ *   'registerMerchant',
+ *   [businessName, owner, repId]
+ * )
+ *
+ * // Listen to events
+ * await sdk.contracts.listen('MerchantRegistry', 'MerchantRegistered', (event) => {
+ *   console.log('New merchant:', event.merchantId)
+ * })
+ * ```
+ */
+export class ContractsModule {
+    constructor(sdk) {
+        this.contracts = new Map();
+        this.eventListeners = new Map();
+        this.sdk = sdk;
+    }
+    /**
+     * Get or create contract instance
+     */
+    getContractInstance(contractName, withSigner = false) {
+        const cacheKey = `${contractName}:${withSigner}`;
+        if (this.contracts.has(cacheKey)) {
+            return this.contracts.get(cacheKey);
+        }
+        const abi = ContractsModule.ABI_REGISTRY[contractName];
+        if (!abi) {
+            throw new Error(`Contract ABI not found for "${contractName}". ` +
+                `Available contracts: ${Object.keys(ContractsModule.ABI_REGISTRY).join(', ')}`);
+        }
+        const address = this.sdk.getContractAddress(contractName);
+        const provider = this.sdk.getProvider();
+        const contract = new ethers.Contract(address, abi, withSigner ? this.sdk.getSigner() : provider);
+        this.contracts.set(cacheKey, contract);
+        return contract;
+    }
+    /**
+     * Call contract method (read-only)
+     *
+     * @param contractName - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Method return value
+     */
+    async call(contractName, method, args = []) {
+        const contract = this.getContractInstance(contractName, false);
+        if (!contract[method]) {
+            throw new Error(`Method "${method}" not found on contract "${contractName}"`);
+        }
+        return await contract[method](...args);
+    }
+    /**
+     * Send contract transaction (write)
+     *
+     * @param contractName - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @param options - Transaction options
+     * @returns Transaction receipt
+     */
+    async send(contractName, method, args = [], options) {
+        const contract = this.getContractInstance(contractName, true);
+        if (!contract[method]) {
+            throw new Error(`Method "${method}" not found on contract "${contractName}"`);
+        }
+        const tx = await contract[method](...args, options || {});
+        const receipt = await tx.wait();
+        return {
+            hash: receipt.hash,
+            blockNumber: receipt.blockNumber,
+            gasUsed: receipt.gasUsed,
+            status: receipt.status,
+            logs: receipt.logs
+        };
+    }
+    /**
+     * Estimate gas for transaction
+     *
+     * @param contractName - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Estimated gas
+     */
+    async estimateGas(contractName, method, args = []) {
+        const contract = this.getContractInstance(contractName, true);
+        if (!contract[method]) {
+            throw new Error(`Method "${method}" not found on contract "${contractName}"`);
+        }
+        return await contract[method].estimateGas(...args);
+    }
+    /**
+     * Deploy new sovereign contract instance
+     *
+     * @param template - Template type (e.g., 'iso', 'healthcare')
+     * @param config - Deployment configuration
+     * @returns Deployed contract address
+     */
+    async deploySovereignContract(template, config) {
+        // This would deploy a new instance of template contracts
+        // For example, a company deploying their own MerchantRegistry
+        throw new Error('Sovereign contract deployment not yet implemented');
+    }
+    /**
+     * Get contract address by name
+     *
+     * @param contractName - Contract name
+     * @returns Contract address
+     */
+    async getContractAddress(contractName) {
+        return this.sdk.getContractAddress(contractName);
+    }
+    /**
+     * Get contract instance
+     *
+     * @param contractName - Contract name
+     * @returns Contract instance
+     */
+    async getContract(contractName) {
+        return this.getContractInstance(contractName, false);
+    }
+    /**
+     * Listen to contract events
+     *
+     * @param contractName - Contract name
+     * @param eventName - Event name
+     * @param callback - Event callback
+     */
+    async listen(contractName, eventName, callback) {
+        const contract = this.getContractInstance(contractName, false);
+        const listenerId = `${contractName}:${eventName}`;
+        // Remove existing listener if any
+        if (this.eventListeners.has(listenerId)) {
+            await this.stopListening(contractName, eventName);
+        }
+        contract.on(eventName, callback);
+        this.eventListeners.set(listenerId, { contract, eventName, callback });
+        console.log(`✅ Listening to ${contractName}.${eventName}`);
+    }
+    /**
+     * Stop listening to contract events
+     *
+     * @param contractName - Contract name
+     * @param eventName - Event name
+     */
+    async stopListening(contractName, eventName) {
+        const listenerId = `${contractName}:${eventName}`;
+        const listener = this.eventListeners.get(listenerId);
+        if (listener) {
+            listener.contract.off(eventName, listener.callback);
+            this.eventListeners.delete(listenerId);
+            console.log(`✅ Stopped listening to ${contractName}.${eventName}`);
+        }
+    }
+    /**
+     * Batch call multiple read-only methods
+     *
+     * @param calls - Array of contract calls
+     * @returns Array of results
+     */
+    async batchCall(calls) {
+        const promises = calls.map(call => this.call(call.contractName, call.method, call.args));
+        return await Promise.all(promises);
+    }
+    /**
+     * Multicall on single contract
+     *
+     * @param contractName - Contract name
+     * @param calls - Array of method calls
+     * @returns Array of results
+     */
+    async multicall(contractName, calls) {
+        const contract = this.getContractInstance(contractName, false);
+        const promises = calls.map(call => contract[call.method](...call.args));
+        return await Promise.all(promises);
+    }
+    /**
+     * Register custom contract ABI
+     *
+     * @param contractName - Contract name
+     * @param abi - Contract ABI
+     */
+    registerABI(contractName, abi) {
+        ContractsModule.ABI_REGISTRY[contractName] = abi;
+        console.log(`✅ Registered ABI for ${contractName}`);
+    }
+    /**
+     * Clear cached contract instances
+     */
+    clearCache() {
+        this.contracts.clear();
+        console.log('✅ Contract cache cleared');
+    }
+    /**
+     * Remove all event listeners
+     */
+    async removeAllListeners() {
+        for (const [listenerId, listener] of this.eventListeners.entries()) {
+            listener.contract.off(listener.eventName, listener.callback);
+        }
+        this.eventListeners.clear();
+        console.log('✅ All event listeners removed');
+    }
+}
+// Contract ABI registry
+ContractsModule.ABI_REGISTRY = {
+    MerchantRegistry: MerchantRegistryABI.abi,
+    TransactionVault: TransactionVaultABI.abi,
+    RepPerformance: RepPerformanceABI.abi,
+    ResidualCalculator: ResidualCalculatorABI.abi,
+    AccessControlRegistry: AccessControlRegistryABI.abi,
+    DataProofRegistry: DataProofRegistryABI.abi,
+    VarityWalletFactory: VarityWalletFactoryABI.abi
+};

package/dist/modules/contracts/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Contracts Module - Exports
+ */
+export { ContractsModule } from './ContractsModule';
+export type { TxOptions, ContractCall, MultiCall, ContractConfig, EventCallback } from './ContractsModule';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/contracts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAA"}

package/dist/modules/contracts/index.js

@@ -0,0 +1,4 @@
+/**
+ * Contracts Module - Exports
+ */
+export { ContractsModule } from './ContractsModule';