@flashbacktech/flashbackclient 0.1.33 → 0.1.35

package/dist/stellarv2/client/index.d.ts

@@ -0,0 +1,134 @@
+import { StellarNetwork } from '../wallet/transaction';
+import { ConsumerOps } from './consumer';
+import { ProviderOps } from './provider';
+import { BucketOps } from './bucket';
+import { DealOps } from './deal';
+import { FundingOps } from './funding';
+/**
+ * Configuration interface for the FlashOnStellar V2 client
+ */
+export interface FlashOnStellarClientConfigV2 {
+    /** Stellar contract address for the FlashOnStellar V2 system */
+    contractAddress: string;
+    /**
+     * Optional callback function to sign non-read Stellar transactions
+     * @param xdrToSign - The XDR-encoded transaction to sign
+     * @returns Promise resolving to the signed XDR string
+     */
+    signTransaction?: (xdrToSign: string) => Promise<string>;
+    /** Network configuration for Stellar (testnet/public) */
+    network: StellarNetwork;
+}
+export type ClientContext = FlashOnStellarClientConfigV2;
+/**
+ * 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.
+ */
+export declare class FlashOnStellarClientV2 {
+    private readonly signTransaction?;
+    private readonly contractAddress;
+    private readonly network;
+    readonly consumers: ConsumerOps;
+    readonly providers: ProviderOps;
+    readonly buckets: BucketOps;
+    readonly deals: DealOps;
+    readonly funding: FundingOps;
+    protected getContext(): ClientContext;
+    /**
+     * Creates a new instance of the FlashOnStellarClient
+     * @param config - Configuration options for the client
+     */
+    constructor(config: FlashOnStellarClientConfigV2);
+    /**
+     * Gets the contract address
+     * @returns The contract address
+     */
+    getContractAddress(): string;
+    /**
+     * Gets the network configuration
+     * @returns The network configuration
+     */
+    getNetwork(): StellarNetwork;
+    /**
+     * Gets the version of the contract
+     * @returns Promise resolving to the contract version
+     */
+    getVersion(): Promise<number>;
+    /**
+     * Gets the owner address of the contract
+     * @returns Promise resolving to the owner address
+     */
+    getOwnerAddress(): Promise<string>;
+    /**
+     * Gets the stable asset address from the contract
+     * @returns Promise resolving to the stable asset address
+     */
+    getStableAssetAddress(): Promise<string>;
+    /**
+     * Gets the current ledger sequence
+     * @returns Promise resolving to the ledger sequence number
+     */
+    getLedgerSequence(): Promise<number>;
+    /**
+     * Updates the owner address (owner only)
+     * @param new_owner - New owner address
+     * @returns Promise resolving to the update result
+     */
+    updateOwner(new_owner: string): Promise<boolean>;
+    /**
+     * Sets the stable asset address (owner only)
+     * @param stable_asset_address - New stable asset address
+     * @returns Promise resolving to the update result
+     */
+    setStableAssetAddress(stable_asset_address: string): Promise<boolean>;
+    /**
+     * Upgrades the contract (owner only)
+     * @param new_wasm_hash - Hash of the new WASM bytecode
+     * @returns Promise resolving to the upgrade result
+     */
+    upgrade(new_wasm_hash: string): Promise<boolean>;
+    /**
+     * Gets system statistics
+     * @returns Promise resolving to system statistics
+     */
+    getSystemStats(): Promise<{
+        consumerCount: number;
+        providerCount: number;
+        bucketCount: number;
+        dealCount: number;
+        activeDealCount: number;
+    }>;
+    /**
+     * 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
+     */
+    getProviderInfo(provider_id: string): Promise<{
+        provider: any;
+        buckets: any[];
+        deals: any[];
+        activeDeals: any[];
+    } | null>;
+    /**
+     * Gets comprehensive information about a consumer including their deals
+     * @param consumer_id - Address of the consumer
+     * @returns Promise resolving to comprehensive consumer information
+     */
+    getConsumerInfo(consumer_id: string): Promise<{
+        consumer: any;
+        deals: any[];
+        activeDeals: any[];
+    } | 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
+     */
+    getBucketInfo(provider_id: string, bucket_id: number): Promise<{
+        bucket: any;
+        provider: any;
+        activeDeals: any[];
+    } | null>;
+}

package/dist/stellarv2/client/index.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/client/provider.d.ts

@@ -0,0 +1,72 @@
+import { ClientContext } from '.';
+import { Provider } from '../models';
+/**
+ * Provider operations client for FlashOnStellar V2
+ * Implements all provider-related contract methods
+ */
+export declare class ProviderOps {
+    private context;
+    constructor(context: ClientContext);
+    /**
+     * Registers a new provider in the system
+     * @param provider_id - Address of the provider to register
+     * @param description - Description of the provider
+     * @returns Promise resolving to the registration result
+     */
+    registerProvider: (provider_id: string, description: string) => Promise<void>;
+    /**
+     * Updates an existing provider's information
+     * @param provider_id - Address of the provider to update
+     * @param description - New description for the provider
+     * @returns Promise resolving to the update result
+     */
+    updateProvider: (provider_id: string, description: string) => Promise<void>;
+    /**
+     * Deletes a provider from the system
+     * @param provider_id - Address of the provider to delete
+     * @returns Promise resolving to the deletion result
+     */
+    deleteProvider: (provider_id: string) => Promise<void>;
+    /**
+     * Retrieves provider information
+     * @param provider_id - Address of the provider to retrieve
+     * @returns Promise resolving to Provider object or null if not found
+     */
+    getProvider(provider_id: string): Promise<Provider | null>;
+    /**
+     * Gets the total count of providers in the system
+     * @returns Promise resolving to the total number of providers
+     */
+    getProviderCount(): Promise<number>;
+    /**
+     * Retrieves a paginated list of providers
+     * @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 provider addresses to Provider objects
+     */
+    getProviders(skip?: number, take?: number): Promise<Map<string, Provider>>;
+    /**
+     * Gets all buckets associated with a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to an array of bucket IDs
+     */
+    getProviderBuckets(provider_id: string): Promise<string[]>;
+    /**
+     * Gets all deals associated with a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to an array of deal IDs
+     */
+    getProviderDeals(provider_id: string): Promise<string[]>;
+    /**
+     * Gets all active deals associated with a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to an array of active deal IDs
+     */
+    getProviderActiveDeals(provider_id: string): Promise<string[]>;
+    /**
+     * Gets the total number of units (buckets) owned by a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to the total number of units
+     */
+    getProviderUnitsCount(provider_id: string): Promise<number>;
+}

package/dist/stellarv2/client/provider.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderOps = void 0;
+const transaction_1 = require("../wallet/transaction");
+const decorator_1 = require("../utils/decorator");
+/**
+ * Provider operations client for FlashOnStellar V2
+ * Implements all provider-related contract methods
+ */
+class ProviderOps {
+    constructor(context) {
+        /**
+         * Registers a new provider in the system
+         * @param provider_id - Address of the provider to register
+         * @param description - Description of the provider
+         * @returns Promise resolving to the registration result
+         */
+        this.registerProvider = (0, decorator_1.withSignature)(async (provider_id, description) => {
+            await (0, transaction_1.executeWalletTransaction)(this.context, provider_id, "register_provider", [
+                { value: provider_id, type: 'address' },
+                { value: description, type: 'string' }
+            ]);
+        });
+        /**
+         * Updates an existing provider's information
+         * @param provider_id - Address of the provider to update
+         * @param description - New description for the provider
+         * @returns Promise resolving to the update result
+         */
+        this.updateProvider = (0, decorator_1.withSignature)(async (provider_id, description) => {
+            await (0, transaction_1.executeWalletTransaction)(this.context, provider_id, "update_provider", [
+                { value: provider_id, type: 'address' },
+                { value: description, type: 'string' }
+            ]);
+        });
+        /**
+         * Deletes a provider from the system
+         * @param provider_id - Address of the provider to delete
+         * @returns Promise resolving to the deletion result
+         */
+        this.deleteProvider = (0, decorator_1.withSignature)(async (provider_id) => {
+            await (0, transaction_1.executeWalletTransaction)(this.context, provider_id, "delete_provider", [
+                { value: provider_id, type: 'address' }
+            ]);
+        });
+        this.context = context;
+    }
+    /**
+     * Retrieves provider information
+     * @param provider_id - Address of the provider to retrieve
+     * @returns Promise resolving to Provider object or null if not found
+     */
+    async getProvider(provider_id) {
+        const response = await (0, transaction_1.prepareTransaction)(this.context, provider_id, {
+            method: 'get_provider',
+            args: [
+                { value: provider_id, type: 'address' }
+            ]
+        });
+        if (!response.isSuccess) {
+            return null;
+        }
+        const result = response.result;
+        if (result && typeof result === 'object') {
+            return result;
+        }
+        return null;
+    }
+    /**
+     * Gets the total count of providers in the system
+     * @returns Promise resolving to the total number of providers
+     */
+    async getProviderCount() {
+        const response = await (0, transaction_1.prepareTransaction)(this.context, '', {
+            method: 'get_provider_count',
+            args: []
+        });
+        if (!response.isSuccess) {
+            return 0;
+        }
+        const result = response.result;
+        if (typeof result === 'number') {
+            return result;
+        }
+        return 0;
+    }
+    /**
+     * Retrieves a paginated list of providers
+     * @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 provider addresses to Provider objects
+     */
+    async getProviders(skip = 0, take = 10) {
+        const response = await (0, transaction_1.prepareTransaction)(this.context, '', {
+            method: 'get_providers',
+            args: [
+                { value: skip, type: 'u32' },
+                { value: take, type: 'u32' }
+            ]
+        });
+        if (!response.isSuccess) {
+            return new Map();
+        }
+        const result = response.result;
+        if (result && typeof result === 'object') {
+            // Convert the result to a Map<string, Provider>
+            const providerMap = new Map();
+            // Note: The actual conversion depends on how the contract returns the data
+            // This is a placeholder implementation
+            return providerMap;
+        }
+        return new Map();
+    }
+    /**
+     * Gets all buckets associated with a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to an array of bucket IDs
+     */
+    async getProviderBuckets(provider_id) {
+        const provider = await this.getProvider(provider_id);
+        if (!provider) {
+            return [];
+        }
+        // Extract bucket IDs from the provider's buckets map
+        const bucketIds = [];
+        provider.buckets.forEach((_, bucketId) => {
+            bucketIds.push(bucketId);
+        });
+        return bucketIds;
+    }
+    /**
+     * Gets all deals associated with a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to an array of deal IDs
+     */
+    async getProviderDeals(provider_id) {
+        const provider = await this.getProvider(provider_id);
+        if (!provider) {
+            return [];
+        }
+        // Extract deal IDs from the provider's deals map
+        const dealIds = [];
+        provider.deals.forEach((_, dealId) => {
+            dealIds.push(dealId);
+        });
+        return dealIds;
+    }
+    /**
+     * Gets all active deals associated with a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to an array of active deal IDs
+     */
+    async getProviderActiveDeals(provider_id) {
+        const provider = await this.getProvider(provider_id);
+        if (!provider) {
+            return [];
+        }
+        // Extract active deal IDs from the provider's active_deals map
+        const activeDealIds = [];
+        provider.active_deals.forEach((_, dealId) => {
+            activeDealIds.push(dealId);
+        });
+        return activeDealIds;
+    }
+    /**
+     * Gets the total number of units (buckets) owned by a provider
+     * @param provider_id - Address of the provider
+     * @returns Promise resolving to the total number of units
+     */
+    async getProviderUnitsCount(provider_id) {
+        const provider = await this.getProvider(provider_id);
+        if (!provider) {
+            return 0;
+        }
+        return provider.units_count;
+    }
+}
+exports.ProviderOps = ProviderOps;

package/dist/stellarv2/index.d.ts

@@ -1,9 +1,9 @@
-import { StellarNetwork } from './transaction';
+import { StellarNetwork } from './wallet/transaction';
 import { FlashOnStellarClientV2, FlashOnStellarClientConfigV2 } from './client';
-export { ConsumerOps } from './consumer';
-export { ProviderOps } from './provider';
-export { BucketOps } from './bucket';
-export { DealOps } from './deal';
-export { FundingOps } from './funding';
+export { ConsumerOps } from './client/consumer';
+export { ProviderOps } from './client/provider';
+export { BucketOps } from './client/bucket';
+export { DealOps } from './client/deal';
+export { FundingOps } from './client/funding';
 export * from './models';
 export { StellarNetwork, FlashOnStellarClientV2, FlashOnStellarClientConfigV2 };

package/dist/stellarv2/index.js

@@ -18,15 +18,15 @@ exports.FlashOnStellarClientV2 = exports.FundingOps = exports.DealOps = exports.
 const client_1 = require("./client");
 Object.defineProperty(exports, "FlashOnStellarClientV2", { enumerable: true, get: function () { return client_1.FlashOnStellarClientV2; } });
 // Export operation classes
-var consumer_1 = require("./consumer");
+var consumer_1 = require("./client/consumer");
 Object.defineProperty(exports, "ConsumerOps", { enumerable: true, get: function () { return consumer_1.ConsumerOps; } });
-var provider_1 = require("./provider");
+var provider_1 = require("./client/provider");
 Object.defineProperty(exports, "ProviderOps", { enumerable: true, get: function () { return provider_1.ProviderOps; } });
-var bucket_1 = require("./bucket");
+var bucket_1 = require("./client/bucket");
 Object.defineProperty(exports, "BucketOps", { enumerable: true, get: function () { return bucket_1.BucketOps; } });
-var deal_1 = require("./deal");
+var deal_1 = require("./client/deal");
 Object.defineProperty(exports, "DealOps", { enumerable: true, get: function () { return deal_1.DealOps; } });
-var funding_1 = require("./funding");
+var funding_1 = require("./client/funding");
 Object.defineProperty(exports, "FundingOps", { enumerable: true, get: function () { return funding_1.FundingOps; } });
 // Export models and types
 __exportStar(require("./models"), exports);

package/dist/stellarv2/utils/decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function withSignature<T extends (...args: any[]) => Promise<any>>(method: T): T;
+export declare function withSignatureProperty<T extends (...args: any[]) => Promise<any>>(target: any, propertyKey: string | symbol): void;