@flashbacktech/flashbackclient 0.1.30 → 0.1.32

package/dist/stellarv2/client.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlashOnStellarClientV2 = void 0;
+const consumer_1 = require("./consumer");
+const provider_1 = require("./provider");
+const bucket_1 = require("./bucket");
+const deal_1 = require("./deal");
+const funding_1 = require("./funding");
+/**
+ * Main client class for interacting with the FlashOnStellar V2 system
+ * This client provides methods for managing providers, consumers, buckets, and deals
+ * on the Stellar blockchain through organized operation classes.
+ */
+class FlashOnStellarClientV2 {
+    getContext() {
+        return {
+            network: this.network,
+            signTransaction: this.signTransaction,
+            contractAddress: this.contractAddress,
+        };
+    }
+    /**
+     * Creates a new instance of the FlashOnStellarClient
+     * @param config - Configuration options for the client
+     */
+    constructor(config) {
+        this.signTransaction = config.signTransaction;
+        this.contractAddress = config.contractAddress;
+        this.network = config.network;
+        // Initialize operation classes
+        const context = this.getContext();
+        this.consumers = new consumer_1.ConsumerOps(context);
+        this.providers = new provider_1.ProviderOps(context);
+        this.buckets = new bucket_1.BucketOps(context);
+        this.deals = new deal_1.DealOps(context);
+        this.funding = new funding_1.FundingOps(context);
+    }
+    /**
+     * Gets the contract address
+     * @returns The contract address
+     */
+    getContractAddress() {
+        return this.contractAddress;
+    }
+    /**
+     * Gets the network configuration
+     * @returns The network configuration
+     */
+    getNetwork() {
+        return this.network;
+    }
+    /**
+     * Gets the version of the contract
+     * @returns Promise resolving to the contract version
+     */
+    async getVersion() {
+        // This would call the version() method on the contract
+        // Implementation depends on the transaction layer
+        throw new Error('getVersion not implemented - requires transaction layer implementation');
+    }
+    /**
+     * Gets the owner address of the contract
+     * @returns Promise resolving to the owner address
+     */
+    async getOwnerAddress() {
+        // This would call the get_owner_address() method on the contract
+        // Implementation depends on the transaction layer
+        throw new Error('getOwnerAddress not implemented - requires transaction layer implementation');
+    }
+    /**
+     * Gets the stable asset address from the contract
+     * @returns Promise resolving to the stable asset address
+     */
+    async getStableAssetAddress() {
+        // This would call the get_stable_asset_address() method on the contract
+        // Implementation depends on the transaction layer
+        throw new Error('getStableAssetAddress not implemented - requires transaction layer implementation');
+    }
+    /**
+     * Gets the current ledger sequence
+     * @returns Promise resolving to the ledger sequence number
+     */
+    async getLedgerSequence() {
+        // This would call the get_ledger_sequence() method on the contract
+        // Implementation depends on the transaction layer
+        throw new Error('getLedgerSequence not implemented - requires transaction layer implementation');
+    }
+    /**
+     * Updates the owner address (owner only)
+     * @param new_owner - New owner address
+     * @returns Promise resolving to the update result
+     */
+    async updateOwner(new_owner) {
+        // This would call the update_owner() method on the contract
+        // Implementation depends on the transaction layer
+        throw new Error('updateOwner not implemented - requires transaction layer implementation');
+    }
+    /**
+     * Sets the stable asset address (owner only)
+     * @param stable_asset_address - New stable asset address
+     * @returns Promise resolving to the update result
+     */
+    async setStableAssetAddress(stable_asset_address) {
+        // This would call the set_stable_asset_address() method on the contract
+        // Implementation depends on the transaction layer
+        throw new Error('setStableAssetAddress not implemented - requires transaction layer implementation');
+    }
+    /**
+     * Upgrades the contract (owner only)
+     * @param new_wasm_hash - Hash of the new WASM bytecode
+     * @returns Promise resolving to the upgrade result
+     */
+    async upgrade(new_wasm_hash) {
+        // This would call the upgrade() method on the contract
+        // Implementation depends on the transaction layer
+        throw new Error('upgrade not implemented - requires transaction layer implementation');
+    }
+    /**
+     * Gets system statistics
+     * @returns Promise resolving to system statistics
+     */
+    async getSystemStats() {
+        try {
+            const [consumerCount, providerCount, bucketCount, dealCount] = await Promise.all([
+                this.consumers.getConsumerCount(),
+                this.providers.getProviderCount(),
+                this.buckets.getBucketCount(),
+                this.deals.getDealCount()
+            ]);
+            // Get active deals count
+            const activeDeals = await this.deals.getActiveDeals(0, 1000); // Get all active deals
+            const activeDealCount = activeDeals.length;
+            return {
+                consumerCount,
+                providerCount,
+                bucketCount,
+                dealCount,
+                activeDealCount
+            };
+        }
+        catch (error) {
+            console.error('Error getting system stats:', error);
+            return {
+                consumerCount: 0,
+                providerCount: 0,
+                bucketCount: 0,
+                dealCount: 0,
+                activeDealCount: 0
+            };
+        }
+    }
+    /**
+     * Gets comprehensive information about a provider including their buckets and deals
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to comprehensive provider information
+     */
+    async getProviderInfo(provider_id) {
+        try {
+            const [provider, buckets, deals, activeDeals] = await Promise.all([
+                this.providers.getProvider(provider_id),
+                this.buckets.getBucketsByProvider(provider_id),
+                this.deals.getDealsByProvider(provider_id),
+                this.deals.getActiveDeals(0, 1000) // Get all active deals and filter by provider
+            ]);
+            if (!provider) {
+                return null;
+            }
+            // Filter active deals for this provider
+            const providerActiveDeals = activeDeals.filter(deal => deal.provider_id === provider_id);
+            return {
+                provider,
+                buckets,
+                deals,
+                activeDeals: providerActiveDeals
+            };
+        }
+        catch (error) {
+            console.error('Error getting provider info:', error);
+            return null;
+        }
+    }
+    /**
+     * Gets comprehensive information about a consumer including their deals
+     * @param consumer_id - Address of the consumer
+     * @returns Promise resolving to comprehensive consumer information
+     */
+    async getConsumerInfo(consumer_id) {
+        try {
+            const [consumer, deals, activeDeals] = await Promise.all([
+                this.consumers.getConsumer(consumer_id),
+                this.deals.getDealsByConsumer(consumer_id),
+                this.deals.getActiveDeals(0, 1000) // Get all active deals and filter by consumer
+            ]);
+            if (!consumer) {
+                return null;
+            }
+            // Filter active deals for this consumer
+            const consumerActiveDeals = activeDeals.filter(deal => deal.consumer_id === consumer_id);
+            return {
+                consumer,
+                deals,
+                activeDeals: consumerActiveDeals
+            };
+        }
+        catch (error) {
+            console.error('Error getting consumer info:', error);
+            return null;
+        }
+    }
+    /**
+     * Gets comprehensive information about a bucket including its provider and any active deals
+     * @param provider_id - Address of the provider
+     * @param bucket_id - ID of the bucket
+     * @returns Promise resolving to comprehensive bucket information
+     */
+    async getBucketInfo(provider_id, bucket_id) {
+        try {
+            const [bucket, provider, activeDeals] = await Promise.all([
+                this.buckets.getBucket(provider_id, bucket_id),
+                this.providers.getProvider(provider_id),
+                this.deals.getActiveDeals(0, 1000) // Get all active deals and filter by bucket
+            ]);
+            if (!bucket) {
+                return null;
+            }
+            // Filter active deals for this bucket
+            const bucketActiveDeals = activeDeals.filter(deal => deal.bucket_id === bucket_id);
+            return {
+                bucket,
+                provider,
+                activeDeals: bucketActiveDeals
+            };
+        }
+        catch (error) {
+            console.error('Error getting bucket info:', error);
+            return null;
+        }
+    }
+}
+exports.FlashOnStellarClientV2 = FlashOnStellarClientV2;

package/dist/stellarv2/consumer.d.ts

@@ -0,0 +1,60 @@
+import { ClientContext } from './client';
+import { Consumer } from './models';
+/**
+ * Consumer operations client for FlashOnStellar V2
+ * Implements all consumer-related contract methods
+ */
+export declare class ConsumerOps {
+    private context;
+    constructor(context: ClientContext);
+    /**
+     * Registers a new consumer in the system
+     * @param consumer_id - Address of the consumer to register
+     * @param description - Description of the consumer
+     * @returns Promise resolving to the registration result
+     */
+    registerConsumer(consumer_id: string, description: string): Promise<boolean>;
+    /**
+     * Updates an existing consumer's information
+     * @param consumer_id - Address of the consumer to update
+     * @param description - New description for the consumer
+     * @returns Promise resolving to the update result
+     */
+    updateConsumer(consumer_id: string, description: string): Promise<boolean>;
+    /**
+     * Deletes a consumer from the system
+     * @param consumer_id - Address of the consumer to delete
+     * @returns Promise resolving to the deletion result
+     */
+    deleteConsumer(consumer_id: string): Promise<boolean>;
+    /**
+     * Retrieves consumer information
+     * @param consumer_id - Address of the consumer to retrieve
+     * @returns Promise resolving to Consumer object or null if not found
+     */
+    getConsumer(consumer_id: string): Promise<Consumer | null>;
+    /**
+     * Gets the total count of consumers in the system
+     * @returns Promise resolving to the total number of consumers
+     */
+    getConsumerCount(): Promise<number>;
+    /**
+     * Retrieves a paginated list of consumers
+     * @param skip - Number of items to skip for pagination
+     * @param take - Number of items to take per page
+     * @returns Promise resolving to a map of consumer addresses to Consumer objects
+     */
+    getConsumers(skip?: number, take?: number): Promise<Map<string, Consumer>>;
+    /**
+     * Gets all deals associated with a consumer
+     * @param consumer_id - Address of the consumer
+     * @returns Promise resolving to an array of deal IDs
+     */
+    getConsumerDeals(consumer_id: string): Promise<string[]>;
+    /**
+     * Gets all active deals associated with a consumer
+     * @param consumer_id - Address of the consumer
+     * @returns Promise resolving to an array of active deal IDs
+     */
+    getConsumerActiveDeals(consumer_id: string): Promise<string[]>;
+}

package/dist/stellarv2/consumer.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsumerOps = void 0;
+const transaction_1 = require("./transaction");
+/**
+ * Consumer operations client for FlashOnStellar V2
+ * Implements all consumer-related contract methods
+ */
+class ConsumerOps {
+    constructor(context) {
+        this.context = context;
+    }
+    /**
+     * Registers a new consumer in the system
+     * @param consumer_id - Address of the consumer to register
+     * @param description - Description of the consumer
+     * @returns Promise resolving to the registration result
+     */
+    async registerConsumer(consumer_id, description) {
+        return (0, transaction_1.callContractMethod)(this.context, consumer_id, {
+            method: 'register_consumer',
+            args: [
+                { value: consumer_id, type: 'address' },
+                { value: description, type: 'string' }
+            ]
+        });
+    }
+    /**
+     * Updates an existing consumer's information
+     * @param consumer_id - Address of the consumer to update
+     * @param description - New description for the consumer
+     * @returns Promise resolving to the update result
+     */
+    async updateConsumer(consumer_id, description) {
+        return (0, transaction_1.callContractMethod)(this.context, consumer_id, {
+            method: 'update_consumer',
+            args: [
+                { value: consumer_id, type: 'address' },
+                { value: description, type: 'string' }
+            ]
+        });
+    }
+    /**
+     * Deletes a consumer from the system
+     * @param consumer_id - Address of the consumer to delete
+     * @returns Promise resolving to the deletion result
+     */
+    async deleteConsumer(consumer_id) {
+        return (0, transaction_1.callContractMethod)(this.context, consumer_id, {
+            method: 'delete_consumer',
+            args: [
+                { value: consumer_id, type: 'address' }
+            ]
+        });
+    }
+    /**
+     * Retrieves consumer information
+     * @param consumer_id - Address of the consumer to retrieve
+     * @returns Promise resolving to Consumer object or null if not found
+     */
+    async getConsumer(consumer_id) {
+        const result = await (0, transaction_1.callContractMethod)(this.context, consumer_id, {
+            method: 'get_consumer',
+            args: [
+                { value: consumer_id, type: 'address' }
+            ]
+        });
+        if (result && typeof result === 'object') {
+            return result;
+        }
+        return null;
+    }
+    /**
+     * Gets the total count of consumers in the system
+     * @returns Promise resolving to the total number of consumers
+     */
+    async getConsumerCount() {
+        const result = await (0, transaction_1.callContractMethod)(this.context, '', {
+            method: 'get_consumer_count',
+            args: []
+        });
+        if (typeof result === 'number') {
+            return result;
+        }
+        return 0;
+    }
+    /**
+     * Retrieves a paginated list of consumers
+     * @param skip - Number of items to skip for pagination
+     * @param take - Number of items to take per page
+     * @returns Promise resolving to a map of consumer addresses to Consumer objects
+     */
+    async getConsumers(skip = 0, take = 10) {
+        const result = await (0, transaction_1.callContractMethod)(this.context, '', {
+            method: 'get_consumers',
+            args: [
+                { value: skip, type: 'u32' },
+                { value: take, type: 'u32' }
+            ]
+        });
+        if (result && typeof result === 'object') {
+            // Convert the result to a Map<string, Consumer>
+            const consumerMap = new Map();
+            // Note: The actual conversion depends on how the contract returns the data
+            // This is a placeholder implementation
+            return consumerMap;
+        }
+        return new Map();
+    }
+    /**
+     * Gets all deals associated with a consumer
+     * @param consumer_id - Address of the consumer
+     * @returns Promise resolving to an array of deal IDs
+     */
+    async getConsumerDeals(consumer_id) {
+        const consumer = await this.getConsumer(consumer_id);
+        if (!consumer) {
+            return [];
+        }
+        // Extract deal IDs from the consumer's deals map
+        const dealIds = [];
+        consumer.deals.forEach((_, dealId) => {
+            dealIds.push(dealId);
+        });
+        return dealIds;
+    }
+    /**
+     * Gets all active deals associated with a consumer
+     * @param consumer_id - Address of the consumer
+     * @returns Promise resolving to an array of active deal IDs
+     */
+    async getConsumerActiveDeals(consumer_id) {
+        const consumer = await this.getConsumer(consumer_id);
+        if (!consumer) {
+            return [];
+        }
+        // Extract active deal IDs from the consumer's active_deals map
+        const activeDealIds = [];
+        consumer.active_deals.forEach((_, dealId) => {
+            activeDealIds.push(dealId);
+        });
+        return activeDealIds;
+    }
+}
+exports.ConsumerOps = ConsumerOps;

package/dist/stellarv2/deal.d.ts

@@ -0,0 +1,160 @@
+import { ClientContext } from './client';
+import { Deal, DealCreateParams, DealConsumptionUpdateParams, DealSLAUpdateParams } from './models';
+/**
+ * Deal operations client for FlashOnStellar V2
+ * Implements all deal-related contract methods
+ */
+export declare class DealOps {
+    private context;
+    constructor(context: ClientContext);
+    /**
+     * Creates a new deal between a consumer and provider
+     * @param consumer_id - Address of the consumer creating the deal
+     * @param provider_id - Address of the provider
+     * @param bucket_id - ID of the bucket for the deal
+     * @param params - Deal creation parameters
+     * @returns Promise resolving to the created deal ID
+     */
+    createDeal(consumer_id: string, provider_id: string, bucket_id: number, params: DealCreateParams): Promise<number>;
+    /**
+     * Sets a deal as accepted by the provider
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider accepting the deal
+     * @param deal_id - ID of the deal to accept
+     * @returns Promise resolving to the acceptance result
+     */
+    setDealAccepted(consumer_id: string, provider_id: string, deal_id: number): Promise<boolean>;
+    /**
+     * Sets a deal as funded by the consumer
+     * @param consumer_id - Address of the consumer funding the deal
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal to fund
+     * @param amount_usd - Amount to fund in USD (scaled by 10^7)
+     * @returns Promise resolving to the funding result
+     */
+    setDealFunded(consumer_id: string, provider_id: string, deal_id: number, amount_usd: bigint): Promise<boolean>;
+    /**
+     * Sets a deal as completed
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal to complete
+     * @returns Promise resolving to the completion result
+     */
+    setDealCompleted(consumer_id: string, provider_id: string, deal_id: number): Promise<boolean>;
+    /**
+     * Sets a deal as cancelled
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal to cancel
+     * @returns Promise resolving to the cancellation result
+     */
+    setDealCancelled(consumer_id: string, provider_id: string, deal_id: number): Promise<boolean>;
+    /**
+     * Marks a deal as breached by the consumer
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal
+     * @returns Promise resolving to the breach marking result
+     */
+    setDealBreachedConsumer(consumer_id: string, provider_id: string, deal_id: number): Promise<boolean>;
+    /**
+     * Marks a deal as breached by the provider
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal
+     * @returns Promise resolving to the breach marking result
+     */
+    setDealBreachedProvider(consumer_id: string, provider_id: string, deal_id: number): Promise<boolean>;
+    /**
+     * Deletes a deal from the system (owner only)
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal to delete
+     * @returns Promise resolving to the deletion result
+     */
+    deleteDeal(consumer_id: string, provider_id: string, deal_id: number): Promise<boolean>;
+    /**
+     * Retrieves deal information
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal to retrieve
+     * @returns Promise resolving to Deal object or null if not found
+     */
+    getDeal(consumer_id: string, provider_id: string, deal_id: number): Promise<Deal | null>;
+    /**
+     * Gets the total count of deals in the system
+     * @returns Promise resolving to the total number of deals
+     */
+    getDealCount(): Promise<number>;
+    /**
+     * Retrieves a paginated list of all deals
+     * @param skip - Number of items to skip for pagination
+     * @param take - Number of items to take per page
+     * @returns Promise resolving to an array of Deal objects
+     */
+    getDeals(skip?: number, take?: number): Promise<Deal[]>;
+    /**
+     * Retrieves all deals for a specific consumer
+     * @param consumer_id - Address of the consumer
+     * @returns Promise resolving to an array of Deal objects
+     */
+    getDealsByConsumer(consumer_id: string): Promise<Deal[]>;
+    /**
+     * Retrieves all deals for a specific provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to an array of Deal objects
+     */
+    getDealsByProvider(provider_id: string): Promise<Deal[]>;
+    /**
+     * Retrieves all active deals
+     * @param skip - Number of items to skip for pagination
+     * @param take - Number of items to take per page
+     * @returns Promise resolving to an array of active Deal objects
+     */
+    getActiveDeals(skip?: number, take?: number): Promise<Deal[]>;
+    /**
+     * Pays for pending consumption in a deal (owner only)
+     * @param provider_id - Address of the provider
+     * @param consumer_id - Address of the consumer
+     * @param deal_id - ID of the deal
+     * @returns Promise resolving to the payment result
+     */
+    payPendingConsumption(provider_id: string, consumer_id: string, deal_id: number): Promise<boolean>;
+    /**
+     * Updates deal consumption metrics (owner only)
+     * @param provider_id - Address of the provider
+     * @param consumer_id - Address of the consumer
+     * @param deal_id - ID of the deal
+     * @param params - Consumption update parameters
+     * @returns Promise resolving to the update result
+     */
+    updateDealConsumption(provider_id: string, consumer_id: string, deal_id: number, params: DealConsumptionUpdateParams): Promise<boolean>;
+    /**
+     * Updates deal SLA metrics (owner only)
+     * @param provider_id - Address of the provider
+     * @param consumer_id - Address of the consumer
+     * @param deal_id - ID of the deal
+     * @param params - SLA update parameters
+     * @returns Promise resolving to the update result
+     */
+    updateDealSLA(provider_id: string, consumer_id: string, deal_id: number, params: DealSLAUpdateParams): Promise<boolean>;
+    /**
+     * Gets deal status information
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal
+     * @returns Promise resolving to deal status or null if deal not found
+     */
+    getDealStatus(consumer_id: string, provider_id: string, deal_id: number): Promise<string | null>;
+    /**
+     * Gets deal balance information
+     * @param consumer_id - Address of the consumer
+     * @param provider_id - Address of the provider
+     * @param deal_id - ID of the deal
+     * @returns Promise resolving to deal balances or null if deal not found
+     */
+    getDealBalances(consumer_id: string, provider_id: string, deal_id: number): Promise<{
+        balance_consumer: bigint;
+        balance_provider: bigint;
+    } | null>;
+}