@citrate/sdk 0.2.0

package/dist/contract.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractInstance = exports.ContractManager = void 0;
+const ethers_1 = require("ethers");
+class ContractManager {
+    constructor(rpcClient, config) {
+        this.rpcClient = rpcClient;
+        this.config = config;
+    }
+    /**
+     * Deploy a contract
+     */
+    async deploy(bytecode, abi, constructorArgs, value) {
+        const data = bytecode.startsWith('0x') ? bytecode : `0x${bytecode}`;
+        // If constructor args provided, encode them
+        let deployData = data;
+        if (abi && constructorArgs && constructorArgs.length > 0) {
+            const iface = new ethers_1.ethers.Interface(abi);
+            const constructor = abi.find(item => item.type === 'constructor');
+            if (constructor) {
+                const encoded = iface.encodeDeploy(constructorArgs);
+                deployData = ethers_1.ethers.concat([data, encoded]);
+            }
+        }
+        const response = await this.rpcCall('eth_sendTransaction', [{
+                from: this.config.defaultAccount,
+                data: deployData,
+                value: value || '0x0',
+                gas: `0x${(this.config.gasLimit || 3000000).toString(16)}`,
+                gasPrice: this.config.gasPrice || '0x3b9aca00' // 1 gwei
+            }]);
+        // Wait for transaction receipt
+        const receipt = await this.waitForReceipt(response);
+        if (!receipt.contractAddress) {
+            throw new Error('Contract deployment failed');
+        }
+        return receipt.contractAddress;
+    }
+    /**
+     * Call a contract method (transaction)
+     */
+    async call(address, abi, method, args = [], value) {
+        const iface = new ethers_1.ethers.Interface(abi);
+        const data = iface.encodeFunctionData(method, args);
+        const response = await this.rpcCall('eth_sendTransaction', [{
+                from: this.config.defaultAccount,
+                to: address,
+                data,
+                value: value || '0x0',
+                gas: `0x${(this.config.gasLimit || 100000).toString(16)}`,
+                gasPrice: this.config.gasPrice || '0x3b9aca00'
+            }]);
+        const receipt = await this.waitForReceipt(response);
+        // Decode logs if any
+        const logs = receipt.logs.map((log) => {
+            try {
+                return iface.parseLog({
+                    topics: log.topics,
+                    data: log.data
+                });
+            }
+            catch {
+                return log;
+            }
+        });
+        return { receipt, logs };
+    }
+    /**
+     * Read contract state (call without transaction)
+     */
+    async read(address, abi, method, args = []) {
+        const iface = new ethers_1.ethers.Interface(abi);
+        const data = iface.encodeFunctionData(method, args);
+        const response = await this.rpcCall('eth_call', [{
+                to: address,
+                data
+            }, 'latest']);
+        // Decode the result
+        const result = iface.decodeFunctionResult(method, response);
+        // If single return value, return it directly
+        if (result.length === 1) {
+            return result[0];
+        }
+        return result;
+    }
+    /**
+     * Get contract code
+     */
+    async getCode(address) {
+        return await this.rpcCall('eth_getCode', [address, 'latest']);
+    }
+    /**
+     * Get contract info
+     */
+    async getContractInfo(address) {
+        const code = await this.getCode(address);
+        return {
+            address,
+            bytecode: code,
+            verified: false // Would check verification status
+        };
+    }
+    /**
+     * Verify contract source code
+     */
+    async verify(address, sourceCode, compilerVersion, optimizationEnabled = false) {
+        const response = await this.rpcCall('citrate_verifyContract', [{
+                address,
+                source_code: sourceCode,
+                compiler_version: compilerVersion,
+                optimization_enabled: optimizationEnabled
+            }]);
+        return response.verification_id;
+    }
+    /**
+     * Create contract instance with ABI
+     */
+    createInstance(address, abi) {
+        return new ContractInstance(address, abi, this);
+    }
+    async waitForReceipt(txHash) {
+        let receipt = null;
+        let attempts = 0;
+        while (!receipt && attempts < 30) {
+            attempts++;
+            await new Promise(resolve => setTimeout(resolve, 2000));
+            try {
+                receipt = await this.rpcCall('eth_getTransactionReceipt', [txHash]);
+            }
+            catch {
+                // Not yet mined
+            }
+        }
+        if (!receipt) {
+            throw new Error('Transaction timeout');
+        }
+        if (receipt.status === '0x0') {
+            throw new Error('Transaction failed');
+        }
+        return receipt;
+    }
+    async rpcCall(method, params) {
+        const response = await this.rpcClient.post('', {
+            jsonrpc: '2.0',
+            method,
+            params,
+            id: Date.now()
+        });
+        if (response.data.error) {
+            throw new Error(response.data.error.message);
+        }
+        return response.data.result;
+    }
+}
+exports.ContractManager = ContractManager;
+/**
+ * Contract instance helper class
+ */
+class ContractInstance {
+    constructor(address, abi, manager) {
+        this.address = address;
+        this.abi = abi;
+        this.manager = manager;
+        this.iface = new ethers_1.ethers.Interface(abi);
+    }
+    /**
+     * Call a method (transaction)
+     */
+    async send(method, args = [], value) {
+        return this.manager.call(this.address, this.abi, method, args, value);
+    }
+    /**
+     * Read state (no transaction)
+     */
+    async call(method, args = []) {
+        return this.manager.read(this.address, this.abi, method, args);
+    }
+    /**
+     * Encode method call data
+     */
+    encodeCall(method, args = []) {
+        return this.iface.encodeFunctionData(method, args);
+    }
+    /**
+     * Decode method result
+     */
+    decodeResult(method, data) {
+        return this.iface.decodeFunctionResult(method, data);
+    }
+    /**
+     * Parse event logs
+     */
+    parseLogs(logs) {
+        return logs.map(log => {
+            try {
+                return this.iface.parseLog({
+                    topics: log.topics,
+                    data: log.data
+                });
+            }
+            catch {
+                return log;
+            }
+        });
+    }
+}
+exports.ContractInstance = ContractInstance;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { CitrateSDK } from './sdk';
+export { ModelRegistry } from './model';
+export { ContractManager } from './contract';
+export { AccountManager } from './account';
+export * from './types';

package/dist/index.esm.js

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountManager = exports.ContractManager = exports.ModelRegistry = exports.CitrateSDK = void 0;
+const tslib_1 = require("tslib");
+var sdk_1 = require("./sdk");
+Object.defineProperty(exports, "CitrateSDK", { enumerable: true, get: function () { return sdk_1.CitrateSDK; } });
+var model_1 = require("./model");
+Object.defineProperty(exports, "ModelRegistry", { enumerable: true, get: function () { return model_1.ModelRegistry; } });
+var contract_1 = require("./contract");
+Object.defineProperty(exports, "ContractManager", { enumerable: true, get: function () { return contract_1.ContractManager; } });
+var account_1 = require("./account");
+Object.defineProperty(exports, "AccountManager", { enumerable: true, get: function () { return account_1.AccountManager; } });
+tslib_1.__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":["export { CitrateSDK } from './sdk';\nexport { ModelRegistry } from './model';\nexport { ContractManager } from './contract';\nexport { AccountManager } from './account';\nexport * from './types';"],"names":[],"mappings":";;;AAAA,IAAA,KAAA,GAAA,OAAA,CAAA,OAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,YAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,KAAA,CAAA,UAAU,CAAA,CAAA,CAAA,EAAA,CAAA;AACnB,IAAA,OAAA,GAAA,OAAA,CAAA,SAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,eAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,OAAA,CAAA,aAAa,CAAA,CAAA,CAAA,EAAA,CAAA;AACtB,IAAA,UAAA,GAAA,OAAA,CAAA,YAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,iBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,UAAA,CAAA,eAAe,CAAA,CAAA,CAAA,EAAA,CAAA;AACxB,IAAA,SAAA,GAAA,OAAA,CAAA,WAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,gBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,SAAA,CAAA,cAAc,CAAA,CAAA,CAAA,EAAA,CAAA;AACvB,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,SAAA,CAAA,EAAA,OAAA,CAAA"}

package/dist/index.js

@@ -0,0 +1,15 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountManager = exports.ContractManager = exports.ModelRegistry = exports.CitrateSDK = void 0;
+const tslib_1 = require("tslib");
+var sdk_1 = require("./sdk");
+Object.defineProperty(exports, "CitrateSDK", { enumerable: true, get: function () { return sdk_1.CitrateSDK; } });
+var model_1 = require("./model");
+Object.defineProperty(exports, "ModelRegistry", { enumerable: true, get: function () { return model_1.ModelRegistry; } });
+var contract_1 = require("./contract");
+Object.defineProperty(exports, "ContractManager", { enumerable: true, get: function () { return contract_1.ContractManager; } });
+var account_1 = require("./account");
+Object.defineProperty(exports, "AccountManager", { enumerable: true, get: function () { return account_1.AccountManager; } });
+tslib_1.__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["export { CitrateSDK } from './sdk';\nexport { ModelRegistry } from './model';\nexport { ContractManager } from './contract';\nexport { AccountManager } from './account';\nexport * from './types';"],"names":[],"mappings":";;;;;AAAA,IAAA,KAAA,GAAA,OAAA,CAAA,OAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,YAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,KAAA,CAAA,UAAU,CAAA,CAAA,CAAA,EAAA,CAAA;AACnB,IAAA,OAAA,GAAA,OAAA,CAAA,SAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,eAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,OAAA,CAAA,aAAa,CAAA,CAAA,CAAA,EAAA,CAAA;AACtB,IAAA,UAAA,GAAA,OAAA,CAAA,YAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,iBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,UAAA,CAAA,eAAe,CAAA,CAAA,CAAA,EAAA,CAAA;AACxB,IAAA,SAAA,GAAA,OAAA,CAAA,WAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,gBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,SAAA,CAAA,cAAc,CAAA,CAAA,CAAA,EAAA,CAAA;AACvB,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,SAAA,CAAA,EAAA,OAAA,CAAA;;"}

package/dist/model.d.ts

@@ -0,0 +1,38 @@
+import { AxiosInstance } from 'axios';
+import { CitrateConfig, ModelMetadata, ModelInfo, InferenceResult } from './types';
+export declare class ModelRegistry {
+    private rpcClient;
+    private config;
+    constructor(rpcClient: AxiosInstance, config: CitrateConfig);
+    /**
+     * Deploy a model to the network
+     */
+    deploy(modelData: Buffer | Uint8Array, metadata: ModelMetadata): Promise<string>;
+    /**
+     * Run inference on a model
+     */
+    runInference(modelId: string, input: any, options?: {
+        withProof?: boolean;
+        timeout?: number;
+    }): Promise<InferenceResult>;
+    /**
+     * Get model information
+     */
+    getModel(modelId: string): Promise<ModelInfo>;
+    /**
+     * List models
+     */
+    listModels(options?: {
+        owner?: string;
+        type?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ModelInfo[]>;
+    /**
+     * Update model metadata
+     */
+    updateMetadata(modelId: string, metadata: Partial<ModelMetadata>): Promise<void>;
+    grantPermission(): Promise<never>;
+    revokePermission(): Promise<never>;
+    private rpcCall;
+}

package/dist/model.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelRegistry = void 0;
+class ModelRegistry {
+    constructor(rpcClient, config) {
+        this.rpcClient = rpcClient;
+        this.config = config;
+    }
+    /**
+     * Deploy a model to the network
+     */
+    async deploy(modelData, metadata) {
+        const base64Data = Buffer.from(modelData).toString('base64');
+        const response = await this.rpcCall('citrate_deployModel', {
+            from: this.config.defaultAccount,
+            model_data: base64Data,
+            metadata,
+            gas_price: this.config.gasPrice,
+            gas_limit: this.config.gasLimit
+        });
+        return response.model_id;
+    }
+    /**
+     * Run inference on a model
+     */
+    async runInference(modelId, input, options) {
+        const response = await this.rpcCall('citrate_runInference', {
+            model_id: modelId,
+            input,
+            with_proof: options?.withProof || false,
+            timeout: options?.timeout
+        });
+        return {
+            output: response.output,
+            executionTime: response.execution_time_ms,
+            proofId: response.proof,
+            gasUsed: response.gas_used
+        };
+    }
+    /**
+     * Get model information
+     */
+    async getModel(modelId) {
+        const response = await this.rpcCall('citrate_getModel', {
+            model_id: modelId
+        });
+        return response.model;
+    }
+    /**
+     * List models
+     */
+    async listModels(options) {
+        // RPC expects positional params: (owner, limit)
+        const response = await this.rpcCall('citrate_listModels', [
+            options?.owner || null,
+            options?.limit || null,
+        ]);
+        return response.models;
+    }
+    /**
+     * Update model metadata
+     */
+    async updateMetadata(modelId, metadata) {
+        await this.rpcCall('citrate_updateModel', {
+            model_id: modelId,
+            metadata,
+            from: this.config.defaultAccount
+        });
+    }
+    // The following permission endpoints are not yet available on the RPC server.
+    // Keep stubs that throw to avoid silent failures if called.
+    async grantPermission() {
+        throw new Error('Not implemented: model permission RPCs are not available yet');
+    }
+    async revokePermission() {
+        throw new Error('Not implemented: model permission RPCs are not available yet');
+    }
+    async rpcCall(method, params) {
+        const response = await this.rpcClient.post('', {
+            jsonrpc: '2.0',
+            method,
+            params,
+            id: Date.now()
+        });
+        if (response.data.error) {
+            throw new Error(response.data.error.message);
+        }
+        return response.data.result;
+    }
+}
+exports.ModelRegistry = ModelRegistry;

package/dist/sdk.d.ts

@@ -0,0 +1,86 @@
+import { EventEmitter } from 'events';
+import { ModelRegistry } from './model';
+import { ContractManager } from './contract';
+import { AccountManager } from './account';
+import { CitrateConfig, NetworkInfo, BlockInfo, ArtifactProviderStatus, ArtifactPinResult } from './types';
+/**
+ * Main Citrate SDK class
+ */
+export declare class CitrateSDK extends EventEmitter {
+    private rpcClient;
+    private config;
+    models: ModelRegistry;
+    contracts: ContractManager;
+    accounts: AccountManager;
+    constructor(config: CitrateConfig);
+    /**
+     * Deploy a model to the network
+     */
+    deployModel(modelData: Buffer | Uint8Array, metadata: {
+        name: string;
+        version: string;
+        format: string;
+        description?: string;
+    }): Promise<string>;
+    /**
+     * Run inference on a deployed model
+     */
+    runInference(modelId: string, input: any, options?: {
+        withProof?: boolean;
+        timeout?: number;
+    }): Promise<{
+        output: any;
+        executionTime: number;
+        proofId?: string;
+    }>;
+    /**
+     * Get proof for an execution
+     */
+    getProof(executionId: string): Promise<any>;
+    /**
+     * Verify a proof
+     */
+    verifyProof(proof: any, expectedOutput?: string): Promise<boolean>;
+    pinArtifact(cid: string, replicas?: number): Promise<ArtifactPinResult>;
+    getArtifactStatus(cid: string): Promise<ArtifactProviderStatus[]>;
+    listModelArtifacts(modelIdHex: string): Promise<string[]>;
+    /**
+     * Get network information
+     */
+    getNetworkInfo(): Promise<NetworkInfo>;
+    /**
+     * Get block information
+     */
+    getBlock(blockNumber: number | 'latest'): Promise<BlockInfo>;
+    /**
+     * Get DAG statistics
+     */
+    getDagStats(): Promise<{
+        totalBlocks: number;
+        blueBlocks: number;
+        redBlocks: number;
+        tipsCount: number;
+        maxBlueScore: number;
+        currentTips: string[];
+        height: number;
+        ghostdagParams: {
+            k: number;
+            maxParents: number;
+            maxBlueScoreDiff: number;
+            pruningWindow: number;
+            finalityDepth: number;
+        };
+    }>;
+    /**
+     * Subscribe to new blocks
+     */
+    subscribeToBlocks(callback: (block: BlockInfo) => void): () => void;
+    /**
+     * Make an RPC call
+     */
+    rpcCall(method: string, params?: any): Promise<any>;
+    /**
+     * Wait for a transaction to be mined
+     */
+    waitForTransaction(txHash: string, confirmations?: number): Promise<any>;
+}