@flashbacktech/flashbackclient 0.1.39 → 0.1.40

package/dist/stellar/provider.d.ts

@@ -1,10 +0,0 @@
-import { ClientContext } from './client.js';
-import { StorageProvider, StorageUnit } from './models.js';
-declare const get_provider: (context: ClientContext, wallet_address: string, provider_address: string, load_units?: boolean) => Promise<StorageProvider | null>;
-declare const get_provider_units: (context: ClientContext, wallet_address: string, provider_address: string) => Promise<Map<number, StorageUnit>>;
-declare const get_providers: (context: ClientContext, wallet_address: string, skip?: number, take?: number) => Promise<Map<string, StorageProvider>>;
-declare const get_provider_count: (context: ClientContext, wallet_address: string) => Promise<number>;
-declare const register_provider: (context: ClientContext, wallet_address: string, provider_address: string, provider_description: string) => Promise<void>;
-declare const delete_provider: (context: ClientContext, wallet_address: string, provider_address: string) => Promise<void>;
-declare const update_provider: (context: ClientContext, wallet_address: string, provider_address: string, provider_description: string) => Promise<void>;
-export { get_provider, get_provider_units, get_providers, get_provider_count, register_provider, delete_provider, update_provider, };

package/dist/stellar/provider.js

@@ -1,86 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.update_provider = exports.delete_provider = exports.register_provider = exports.get_provider_count = exports.get_providers = exports.get_provider_units = exports.get_provider = void 0;
-const transaction_js_1 = require("./transaction.js");
-const get_provider = async (context, wallet_address, provider_address, load_units = false) => {
-    const [provider, units] = await Promise.all([
-        (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-            method: 'get_provider',
-            args: [{ value: provider_address, type: 'address' }],
-        }),
-        load_units
-            ? get_provider_units(context, wallet_address, provider_address)
-            : new Map(),
-    ]);
-    const typedProviderData = provider.isSuccess ? provider.result : null;
-    if (typedProviderData) {
-        typedProviderData.units = units;
-    }
-    return typedProviderData;
-};
-exports.get_provider = get_provider;
-const get_provider_units = async (context, wallet_address, provider_address) => {
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method: 'get_provider_units',
-        args: [{ value: provider_address, type: 'address' }],
-    });
-    const typedProviderUnits = response.isSuccess
-        ? response.result
-        : new Map();
-    return typedProviderUnits;
-};
-exports.get_provider_units = get_provider_units;
-const get_providers = async (context, wallet_address, skip = 0, take = 10) => {
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method: 'get_providers',
-        args: [
-            { value: skip, type: 'u32' },
-            { value: take, type: 'u32' },
-        ],
-    });
-    if (!response.isSuccess) {
-        return new Map();
-    }
-    const providersObj = response.result;
-    return new Map(Object.entries(providersObj));
-};
-exports.get_providers = get_providers;
-const get_provider_count = async (context, wallet_address) => {
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method: 'get_provider_count',
-    });
-    return response.isSuccess ? response.result : 0;
-};
-exports.get_provider_count = get_provider_count;
-// Helper function to handle write-mode contract calls
-const executeProviderTransaction = async (context, wallet_address, provider_address, method, additionalArgs = []) => {
-    const is_owner = wallet_address !== provider_address;
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method,
-        args: [
-            { value: provider_address, type: 'address' },
-            ...additionalArgs,
-            { value: is_owner, type: 'bool' },
-        ],
-    });
-    if (response.isSuccess && !response.isReadOnly) {
-        const signedTxXDR = await context.signTransaction(response.result);
-        await (0, transaction_js_1.sendTransaction)(context, signedTxXDR);
-    }
-};
-const register_provider = async (context, wallet_address, provider_address, provider_description) => {
-    await executeProviderTransaction(context, wallet_address, provider_address, 'register_provider', [
-        { value: provider_description, type: 'string' },
-    ]);
-};
-exports.register_provider = register_provider;
-const delete_provider = async (context, wallet_address, provider_address) => {
-    await executeProviderTransaction(context, wallet_address, provider_address, 'delete_provider');
-};
-exports.delete_provider = delete_provider;
-const update_provider = async (context, wallet_address, provider_address, provider_description) => {
-    await executeProviderTransaction(context, wallet_address, provider_address, 'update_provider', [
-        { value: provider_description, type: 'string' },
-    ]);
-};
-exports.update_provider = update_provider;

package/dist/stellar/reservation.d.ts

@@ -1,8 +0,0 @@
-import { ClientContext } from './client.js';
-import { DeletionStatus, StorageReservation } from './models.js';
-declare const get_reservation: (context: ClientContext, wallet_address: string, reservation_id: number) => Promise<StorageReservation | null>;
-declare const create_reservation: (context: ClientContext, wallet_address: string, consumer_address: string, unit_id: number, reserved_gb: number) => Promise<boolean>;
-declare const delete_reservation: (context: ClientContext, wallet_address: string, consumer_address: string, reservation_id: number) => Promise<DeletionStatus>;
-declare const update_inuse_bytes_consumer: (context: ClientContext, wallet_address: string, consumer_address: string, reservation_id: number, inuse_bytes: number) => Promise<boolean>;
-declare const update_inuse_bytes_provider: (context: ClientContext, wallet_address: string, provider_address: string, reservation_id: number, inuse_bytes: number) => Promise<boolean>;
-export { get_reservation, create_reservation, delete_reservation, update_inuse_bytes_consumer, update_inuse_bytes_provider, };

package/dist/stellar/reservation.js

@@ -1,61 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.update_inuse_bytes_provider = exports.update_inuse_bytes_consumer = exports.delete_reservation = exports.create_reservation = exports.get_reservation = void 0;
-const transaction_js_1 = require("./transaction.js");
-const get_reservation = async (context, wallet_address, reservation_id) => {
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method: 'get_reservation',
-        args: [{ value: reservation_id, type: 'u32' }],
-    });
-    return response.isSuccess ? response.result : null;
-};
-exports.get_reservation = get_reservation;
-const executeReservationTransaction = async (context, wallet_address, method, additionalArgs = [], defaultValue) => {
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method,
-        args: additionalArgs,
-    });
-    if (response.isSuccess && !response.isReadOnly) {
-        const signedTxXDR = await context.signTransaction(response.result);
-        return (0, transaction_js_1.sendTransaction)(context, signedTxXDR);
-    }
-    return defaultValue;
-};
-const create_reservation = async (context, wallet_address, consumer_address, unit_id, reserved_gb) => {
-    const is_owner = wallet_address !== consumer_address;
-    return executeReservationTransaction(context, wallet_address, 'create_reservation', [
-        { value: consumer_address, type: 'address' },
-        { value: unit_id, type: 'u32' },
-        { value: reserved_gb, type: 'u32' },
-        { value: is_owner, type: 'bool' },
-    ]);
-};
-exports.create_reservation = create_reservation;
-const delete_reservation = async (context, wallet_address, consumer_address, reservation_id) => {
-    const is_owner = wallet_address !== consumer_address;
-    return (executeReservationTransaction(context, wallet_address, 'delete_reservation', [
-        { value: reservation_id, type: 'u32' },
-        { value: is_owner, type: 'bool' },
-    ]) || 'NotFound');
-};
-exports.delete_reservation = delete_reservation;
-const update_inuse_bytes_consumer = async (context, wallet_address, consumer_address, reservation_id, inuse_bytes) => {
-    const is_owner = wallet_address !== consumer_address;
-    return executeReservationTransaction(context, wallet_address, 'update_inuse_bytes_consumer', [
-        { value: reservation_id, type: 'u32' },
-        { value: consumer_address, type: 'address' },
-        { value: inuse_bytes, type: 'u64' },
-        { value: is_owner, type: 'bool' },
-    ]);
-};
-exports.update_inuse_bytes_consumer = update_inuse_bytes_consumer;
-const update_inuse_bytes_provider = async (context, wallet_address, provider_address, reservation_id, inuse_bytes) => {
-    const is_owner = wallet_address !== provider_address;
-    return executeReservationTransaction(context, wallet_address, 'update_inuse_bytes_consumer', [
-        { value: reservation_id, type: 'u32' },
-        { value: provider_address, type: 'address' },
-        { value: inuse_bytes, type: 'u64' },
-        { value: is_owner, type: 'bool' },
-    ]);
-};
-exports.update_inuse_bytes_provider = update_inuse_bytes_provider;

package/dist/stellar/stats.d.ts

@@ -1,4 +0,0 @@
-import { ClientContext } from './client.js';
-import { ContractStats } from './models.js';
-declare const get_stats: (context: ClientContext, wallet_address: string) => Promise<ContractStats | null>;
-export { get_stats };

package/dist/stellar/stats.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.get_stats = void 0;
-const transaction_js_1 = require("./transaction.js");
-const get_stats = async (context, wallet_address) => {
-    const stats = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method: 'get_stats',
-        args: [],
-    });
-    return stats.isSuccess ? stats.result : null;
-};
-exports.get_stats = get_stats;

package/dist/stellar/transaction.d.ts

@@ -1,24 +0,0 @@
-import { Transaction, Memo, MemoType, Operation, FeeBumpTransaction } from '@stellar/stellar-sdk';
-import { ClientContext } from './client.js';
-interface StellarNetwork {
-    network: string;
-    networkPassphrase: string;
-}
-declare const getNetwork: (network: string) => StellarNetwork;
-declare const getPublicKeyFromPrivateKey: (privateKey: string) => string;
-interface ContractMethodCall {
-    method: string;
-    args?: Array<{
-        value: number | string | bigint | boolean | null | undefined;
-        type: 'u32' | 'i32' | 'u64' | 'i64' | 'string' | 'symbol' | 'address' | 'bool';
-    }>;
-}
-interface ContractMethodResponse {
-    isSuccess: boolean;
-    isReadOnly: boolean;
-    result: string | unknown;
-}
-declare const prepareTransaction: (context: ClientContext, address: string, contractCall: ContractMethodCall) => Promise<ContractMethodResponse>;
-declare const signTransaction: (context: ClientContext, xdrToSign: string, privateKey: string) => Promise<Transaction<Memo<MemoType>, Operation[]> | FeeBumpTransaction>;
-declare const sendTransaction: (context: ClientContext, signedTransactionXDR: string) => Promise<any>;
-export { prepareTransaction, sendTransaction, signTransaction, getNetwork, StellarNetwork, getPublicKeyFromPrivateKey, };

package/dist/stellar/transaction.js

@@ -1,138 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPublicKeyFromPrivateKey = exports.getNetwork = exports.signTransaction = exports.sendTransaction = exports.prepareTransaction = void 0;
-const timing_js_1 = require("../utils/timing.js");
-// Polyfill for BigInt JSON serialization
-BigInt.prototype.toJSON = function () {
-    return this.toString();
-};
-const stellar_sdk_1 = require("@stellar/stellar-sdk");
-const stellar_sdk_2 = require("@stellar/stellar-sdk");
-const getNetwork = (network) => {
-    let networkPassphrase = '';
-    switch (network) {
-        case 'TESTNET':
-            networkPassphrase = 'Test SDF Network ; September 2015';
-            break;
-        case 'PUBLIC':
-            networkPassphrase = 'Public Global Stellar Network ; September 2015';
-            break;
-    }
-    return { network, networkPassphrase };
-};
-exports.getNetwork = getNetwork;
-const getPublicKeyFromPrivateKey = (privateKey) => {
-    const keypair = stellar_sdk_1.Keypair.fromSecret(privateKey);
-    return keypair.publicKey();
-};
-exports.getPublicKeyFromPrivateKey = getPublicKeyFromPrivateKey;
-const getServer = (network) => {
-    let serverUrl = '';
-    switch (network.network) {
-        case 'TESTNET':
-            serverUrl = 'https://soroban-testnet.stellar.org:443';
-            break;
-        case 'PUBLIC':
-            serverUrl = 'https://rpc.stellar.org:443';
-            break;
-    }
-    console.log(`@@@Creating Stellar RPC server for network: ${network.network}, URL: ${serverUrl}`);
-    const server = new stellar_sdk_2.rpc.Server(serverUrl);
-    return server;
-};
-const TIMEOUT_TRANSACTION = 60;
-const prepareTransaction = async (context, address, contractCall) => {
-    const contractAddress = context.contractAddress;
-    const contract = new stellar_sdk_1.Contract(contractAddress);
-    const server = getServer(context.network);
-    const sourceAccount = await server.getAccount(address);
-    const response = {
-        isSuccess: false,
-        isReadOnly: false,
-        result: '',
-    };
-    // Convert raw values to ScVal
-    const convertedArgs = contractCall.args?.map((arg) => (0, stellar_sdk_1.nativeToScVal)(arg.value, { type: arg.type })) || [];
-    const builtTransaction = new stellar_sdk_1.TransactionBuilder(sourceAccount, {
-        fee: stellar_sdk_1.BASE_FEE,
-        networkPassphrase: context.network.networkPassphrase,
-    })
-        .addOperation(contract.call(contractCall.method, ...convertedArgs))
-        .setTimeout(TIMEOUT_TRANSACTION)
-        .build();
-    const sim = await server.simulateTransaction(builtTransaction);
-    if (stellar_sdk_2.rpc.Api.isSimulationSuccess(sim)) {
-        response.isSuccess = true;
-        //console.log('Simulation success:', JSON.stringify(sim));
-        const result = sim.result && sim.result.retval ? (0, stellar_sdk_1.scValToNative)(sim.result.retval) : undefined;
-        const footprint = sim.transactionData.getFootprint();
-        const isReadOnly = footprint.readOnly().length > 0 && footprint.readWrite().length === 0;
-        if (isReadOnly) {
-            response.isReadOnly = true;
-            response.result = result;
-            return response;
-        }
-        // For write operations, continue with the normal flow of returning the XDR
-        const preparedTransaction = await server.prepareTransaction(builtTransaction);
-        response.result = preparedTransaction.toXDR();
-        return response;
-    }
-    else {
-        if (stellar_sdk_2.rpc.Api.isSimulationError(sim)) {
-            throw new Error(`Tansaction simulation error: ${JSON.stringify(sim.error)}`);
-        }
-        throw new Error('Transaction simulation failed');
-    }
-};
-exports.prepareTransaction = prepareTransaction;
-const signTransaction = async (context, xdrToSign, privateKey) => {
-    const preparedTransaction = stellar_sdk_1.TransactionBuilder.fromXDR(xdrToSign, context.network.networkPassphrase);
-    const sourceKeypair = stellar_sdk_1.Keypair.fromSecret(privateKey);
-    preparedTransaction.sign(sourceKeypair);
-    return preparedTransaction;
-};
-exports.signTransaction = signTransaction;
-const sendTransaction = async (context, signedTransactionXDR) => {
-    const server = getServer(context.network);
-    const signedTransaction = stellar_sdk_1.TransactionBuilder.fromXDR(signedTransactionXDR, context.network.networkPassphrase);
-    // Submit the transaction to the Stellar-RPC server. The RPC server will
-    // then submit the transaction into the network for us. Then we will have to
-    // wait, polling `getTransaction` until the transaction completes.
-    try {
-        const sendResponse = await server.sendTransaction(signedTransaction);
-        if (sendResponse.status === 'PENDING') {
-            let getResponse = await server.getTransaction(sendResponse.hash);
-            // Poll `getTransaction` until the status is not "NOT_FOUND"
-            while (getResponse.status === 'NOT_FOUND') {
-                // See if the transaction is complete
-                getResponse = await server.getTransaction(sendResponse.hash);
-                // Wait one second
-                await (0, timing_js_1.sleep)(1000);
-            }
-            //console.log(`getTransaction response: ${JSON.stringify(getResponse)}`);
-            if (getResponse.status === 'SUCCESS') {
-                // Make sure the transaction's resultMetaXDR is not empty
-                if (!getResponse.resultMetaXdr) {
-                    throw new Error('Empty resultMetaXDR in getTransaction response');
-                }
-                // Find the return value from the contract and return it
-                const transactionMeta = getResponse.resultMetaXdr;
-                const returnValue = transactionMeta.v3().sorobanMeta()?.returnValue();
-                if (returnValue) {
-                    return (0, stellar_sdk_1.scValToNative)(returnValue);
-                }
-            }
-            else {
-                throw new Error(`Transaction failed: ${getResponse.resultXdr}`);
-            }
-        }
-        else {
-            throw new Error(sendResponse.errorResult?.toString() || 'Unknown error');
-        }
-    }
-    catch (err) {
-        // Catch and report any errors we've thrown
-        throw new Error(`Transaction sending error: ${JSON.stringify(err)}`);
-    }
-};
-exports.sendTransaction = sendTransaction;

package/dist/stellar/unit.d.ts

@@ -1,12 +0,0 @@
-import { ClientContext } from './client.js';
-import { DeletionStatus, StorageReservation, StorageUnit } from './models.js';
-type RegisterUnitResponse = [unitId: number, unit: StorageUnit];
-declare const get_unit: (context: ClientContext, wallet_address: string, unit_id: number, load_reservations?: boolean) => Promise<StorageUnit | null>;
-declare const get_unit_reservations: (context: ClientContext, wallet_address: string, unit_id: number) => Promise<Map<number, StorageReservation>>;
-declare const register_unit: (context: ClientContext, wallet_address: string, provider_address: string, capacity: number, endpoint: string) => Promise<RegisterUnitResponse | null>;
-declare const delete_unit: (context: ClientContext, wallet_address: string, provider_address: string, unit_id: number) => Promise<DeletionStatus | null>;
-declare const enter_maintenance: (context: ClientContext, wallet_address: string, provider_address: string, unit_id: number, maintenanceStart: Date, maintenanceEnd: Date) => Promise<boolean | null>;
-declare const exit_maintenance: (context: ClientContext, wallet_address: string, provider_address: string, unit_id: number) => Promise<boolean | null>;
-declare const enter_decommissioning: (context: ClientContext, wallet_address: string, provider_address: string, unit_id: number) => Promise<boolean | null>;
-declare const exit_decommissioning: (context: ClientContext, wallet_address: string, provider_address: string, unit_id: number) => Promise<boolean | null>;
-export { get_unit, get_unit_reservations, register_unit, delete_unit, enter_maintenance, exit_maintenance, enter_decommissioning, exit_decommissioning, };

package/dist/stellar/unit.js

@@ -1,100 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.exit_decommissioning = exports.enter_decommissioning = exports.exit_maintenance = exports.enter_maintenance = exports.delete_unit = exports.register_unit = exports.get_unit_reservations = exports.get_unit = void 0;
-const transaction_js_1 = require("./transaction.js");
-const get_unit = async (context, wallet_address, unit_id, load_reservations = false) => {
-    const [unit, reservations] = await Promise.all([
-        (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-            method: 'get_unit',
-            args: [{ value: unit_id, type: 'u32' }],
-        }),
-        load_reservations
-            ? get_unit_reservations(context, wallet_address, unit_id)
-            : new Map(),
-    ]);
-    const typedUnitData = unit.isSuccess ? unit.result : null;
-    if (typedUnitData) {
-        typedUnitData.reservations = reservations;
-    }
-    return typedUnitData;
-};
-exports.get_unit = get_unit;
-const get_unit_reservations = async (context, wallet_address, unit_id) => {
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method: 'get_unit_reservations',
-        args: [{ value: unit_id, type: 'u32' }],
-    });
-    const typedUnitReservations = response.isSuccess
-        ? response.result
-        : new Map();
-    return typedUnitReservations;
-};
-exports.get_unit_reservations = get_unit_reservations;
-const executeUnitTransaction = async (context, wallet_address, provider_address, method, additionalArgs = []) => {
-    const is_owner = wallet_address !== provider_address;
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method,
-        args: [
-            { value: provider_address, type: 'address' },
-            ...additionalArgs,
-            { value: is_owner, type: 'bool' },
-        ],
-    });
-    if (response.isSuccess && !response.isReadOnly) {
-        const signedTxXDR = await context.signTransaction(response.result);
-        return (0, transaction_js_1.sendTransaction)(context, signedTxXDR);
-    }
-    return null;
-};
-const register_unit = async (context, wallet_address, provider_address, capacity, endpoint) => {
-    return executeUnitTransaction(context, wallet_address, provider_address, 'register_unit', [
-        { value: capacity, type: 'u32' },
-        { value: endpoint, type: 'string' },
-    ]);
-};
-exports.register_unit = register_unit;
-const delete_unit = async (context, wallet_address, provider_address, unit_id) => {
-    return executeUnitTransaction(context, wallet_address, provider_address, 'delete_unit', [{ value: unit_id, type: 'u32' }]);
-};
-exports.delete_unit = delete_unit;
-const change_unit_status = async (context, method, wallet_address, provider_address, unit_id, maintenanceStart, maintenanceEnd) => {
-    const is_owner = wallet_address !== provider_address;
-    const response = await (0, transaction_js_1.prepareTransaction)(context, wallet_address, {
-        method: method,
-        args: [
-            { value: provider_address, type: 'address' },
-            { value: unit_id, type: 'u32' },
-            ...(method === 'enter_maintenance'
-                ? [
-                    { value: Math.floor(maintenanceStart.getTime() / 1000), type: 'u64' },
-                    { value: Math.floor(maintenanceEnd.getTime() / 1000), type: 'u64' },
-                ]
-                : []),
-            { value: is_owner, type: 'bool' },
-        ],
-    });
-    if (response.isSuccess && !response.isReadOnly) {
-        const signedTxXDR = await context.signTransaction(response.result);
-        const responseSend = (await (0, transaction_js_1.sendTransaction)(context, signedTxXDR));
-        return responseSend;
-    }
-    return null;
-};
-const createUnitMaintenanceChanger = (method) => {
-    return async (context, wallet_address, provider_address, unit_id, maintenanceStart, maintenanceEnd) => {
-        return change_unit_status(context, method, wallet_address, provider_address, unit_id, maintenanceStart, maintenanceEnd);
-    };
-};
-const createUnitStatusChanger = (method) => {
-    return async (context, wallet_address, provider_address, unit_id) => {
-        return change_unit_status(context, method, wallet_address, provider_address, unit_id);
-    };
-};
-const enter_maintenance = createUnitMaintenanceChanger('enter_maintenance');
-exports.enter_maintenance = enter_maintenance;
-const exit_maintenance = createUnitStatusChanger('exit_maintenance');
-exports.exit_maintenance = exit_maintenance;
-const enter_decommissioning = createUnitStatusChanger('enter_decommissioning');
-exports.enter_decommissioning = enter_decommissioning;
-const exit_decommissioning = createUnitStatusChanger('exit_decommissioning');
-exports.exit_decommissioning = exit_decommissioning;

package/dist/stellarv2/bucket.d.ts

@@ -1,111 +0,0 @@
-import { ClientContext } from './client';
-import { Bucket, BucketCreateParams, BucketUpdateBasicParams, BucketUpdatePricingParams, BucketUpdateSLAParams } from './models';
-/**
- * Bucket operations client for FlashOnStellar V2
- * Implements all bucket-related contract methods
- */
-export declare class BucketOps {
-    private context;
-    constructor(context: ClientContext);
-    /**
-     * Creates a new bucket for a provider
-     * @param provider_id - Address of the provider creating the bucket
-     * @param params - Bucket creation parameters
-     * @returns Promise resolving to the created bucket ID
-     */
-    createBucket(provider_id: string, params: BucketCreateParams): Promise<number>;
-    /**
-     * Creates a bucket from an existing bucket object
-     * @param bucket - Existing bucket object to clone
-     * @returns Promise resolving to the created bucket ID
-     */
-    /**
-     * Updates basic bucket information (name, region, country)
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to update
-     * @param params - Basic update parameters
-     * @returns Promise resolving to the update result
-     */
-    updateBucketBasic(provider_id: string, bucket_id: number, params: BucketUpdateBasicParams): Promise<boolean>;
-    /**
-     * Updates bucket pricing and capacity information
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to update
-     * @param params - Pricing update parameters
-     * @returns Promise resolving to the update result
-     */
-    updateBucketPricing(provider_id: string, bucket_id: number, params: BucketUpdatePricingParams): Promise<boolean>;
-    /**
-     * Updates bucket SLA information
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to update
-     * @param params - SLA update parameters
-     * @returns Promise resolving to the update result
-     */
-    updateBucketSLA(provider_id: string, bucket_id: number, params: BucketUpdateSLAParams): Promise<boolean>;
-    /**
-     * Locks a bucket to prevent modifications during active deals
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to lock
-     * @returns Promise resolving to the lock result
-     */
-    lockBucket(provider_id: string, bucket_id: number): Promise<boolean>;
-    /**
-     * Unlocks a bucket to allow modifications
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to unlock
-     * @returns Promise resolving to the unlock result
-     */
-    unlockBucket(provider_id: string, bucket_id: number): Promise<boolean>;
-    /**
-     * Deletes a bucket from the system
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to delete
-     * @returns Promise resolving to the deletion result
-     */
-    deleteBucket(provider_id: string, bucket_id: number): Promise<boolean>;
-    /**
-     * Retrieves bucket information
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to retrieve
-     * @returns Promise resolving to Bucket object or null if not found
-     */
-    getBucket(provider_id: string, bucket_id: number): Promise<Bucket | null>;
-    /**
-     * Gets the total count of buckets in the system
-     * @returns Promise resolving to the total number of buckets
-     */
-    getBucketCount(): Promise<number>;
-    /**
-     * Retrieves a paginated list of all buckets
-     * @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 Bucket objects
-     */
-    getBuckets(skip?: number, take?: number): Promise<Bucket[]>;
-    /**
-     * Retrieves all buckets owned by a specific provider
-     * @param provider_id - Address of the provider
-     * @returns Promise resolving to an array of Bucket objects
-     */
-    getBucketsByProvider(provider_id: string): Promise<Bucket[]>;
-    /**
-     * Checks if a bucket is locked
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket to check
-     * @returns Promise resolving to true if the bucket is locked, false otherwise
-     */
-    isBucketLocked(provider_id: string, bucket_id: number): Promise<boolean>;
-    /**
-     * Gets bucket pricing information
-     * @param provider_id - Address of the provider owning the bucket
-     * @param bucket_id - ID of the bucket
-     * @returns Promise resolving to pricing information or null if bucket not found
-     */
-    getBucketPricing(provider_id: string, bucket_id: number): Promise<{
-        price_per_gb_storage: bigint;
-        price_per_gb_egress: bigint;
-        max_storage_gb: number;
-        max_egress_gb: number;
-    } | null>;
-}