/// <reference types="node" />
import { MetadataURIOrObject } from "../core/types";
import FileOrBuffer from "../types/FileOrBuffer";
import { BufferOrStringWithName } from "../types/BufferOrStringWithName";
/**
 * @internal
 */
export interface UploadMetadataBatchResult {
    baseUri: string;
    metadataUris: string[];
}
export interface IStorage {
    /**
     * Uploads a file to the storage.
     *
     * @param data - The data to be uploaded. Can be a file/buffer (which will be loaded), or a string.
     * @param contractAddress - Optional. The contract address the data belongs to.
     * @param signerAddress - Optional. The address of the signer.
     *
     * @returns - The hash of the uploaded data.
     */
    upload(data: string | File | FileOrBuffer | Buffer, contractAddress?: string, signerAddress?: string): Promise<string>;
    /**
     * Uploads a folder to storage.
     *
     * @param path - The path to the folder containing the files to be uploaded.
     * @param contractAddress - Optional. The contract address the data belongs to.
     * @param signerAddress - Optional. The address of the signer.
     * @param uploadFileStartNumber - Optional. The first file file name begins with.
     *
     * @returns - The CID of the uploaded folder.
     */
    uploadBatch(files: Buffer[] | string[] | FileOrBuffer[] | File[] | BufferOrStringWithName[], contractAddress?: string, uploadFileStartNumber?: number): Promise<string>;
    /**
     * Fetches a one-time-use upload token that can used to upload
     * a file to storage.
     *
     * @returns - The one time use token that can be passed to the Pinata API.
     */
    getUploadToken(contractAddress: string): Promise<string>;
    /**
     * Fetches data from storage. This method does not handle any deserialization.
     * Its up to the caller to determine what the type of the data is.
     *
     * @param hash - The Hash of the file to fetch
     * @returns - The data, if found.
     */
    get(hash: string): Promise<string>;
    /**
     * Resolves the full URL of a file for a given gateway.
     *
     * For example, if the hash of a file is `ipfs://bafkreib3u2u6ir2fsl5nkuwixfsb3l4xehri3psjv5yga4inuzsjunk2sy`, then the URL will be:
     * "https://cloudflare-ipfs.com/ipfs/bafkreibnwjhx5s3r2rggdoy3hw7lr7wmgy4bas35oky3ed6eijklk2oyvq"
     * if the gateway is `cloudflare-ipfs.com`.
     *
     * @param hash - The hash of a file.
     */
    resolveFullUrl(hash: string): string;
    /**
     *
     * Uploads metadata to IPFS
     *
     * @param metadata - The metadata to be uploaded.
     * @param contractAddress - Optional. The contract address the data belongs to.
     * @param signerAddress - Optional. The address of the signer.
     */
    uploadMetadata(metadata: MetadataURIOrObject, contractAddress?: string, signerAddress?: string): Promise<string>;
    /**
     *
     * Uploads metadata to IPFS
     *
     * @param metadata - The metadata to be uploaded.
     * @param contractAddress - Optional. The contract address the data belongs to.
     * @param signerAddress - Optional. The address of the signer.
     */
    uploadMetadataBatch(metadatas: MetadataURIOrObject[], contractAddress?: string, fileStartNumber?: number): Promise<UploadMetadataBatchResult>;
    /**
     * Returns true if the URI is resolvable by the current storage interface.
     *
     * For example: If the storage is configured to point to IPFS,
     * passing in ipfs://SOME_HASH will return true in this function
     * because that is a valid IPFS URI.
     */
    canResolve(uri: string): boolean;
}