@ethersphere/bee-js 8.3.1 → 9.0.2

package/dist/types/bee.d.ts

@@ -1,10 +1,15 @@
 /// <reference types="node" />
 import { Readable } from 'stream';
-import { Index, IndexBytes } from './feed';
-import { FeedType } from './feed/type';
-import type { Address, AddressPrefix, AllSettlements, AnyJson, BalanceResponse, BatchId, BeeOptions, BeeRequestOptions, BeeVersions, ChainState, ChequebookAddressResponse, ChequebookBalanceResponse, CollectionUploadOptions, Data, DebugStatus, Envelope, ExtendedTag, FeedReader, FeedWriter, FileData, FileUploadOptions, GetGranteesResult, GranteesResult, Health, JsonFeedOptions, LastCashoutActionResponse, LastChequesForPeerResponse, LastChequesResponse, NodeAddresses, NodeInfo, NumberString, Peer, PeerBalance, Pin, PingResponse, PostageBatch, PostageBatchBuckets, PssMessageHandler, PssSubscription, PublicKey, RedistributionState, Reference, ReferenceInformation, RemovePeerResponse, ReserveState, SOCReader, SOCWriter, Settlements, Signer, Tag, Topic, Topology, TransactionHash, TransactionInfo, UploadOptions, UploadRedundancyOptions, UploadResultWithCid, WalletBalance } from './types';
-import { AllTagsOptions, CashoutOptions, Collection, FeedManifestResult, PostageBatchOptions, ReferenceCidOrEns, ReferenceOrEns, TransactionOptions, UploadResult } from './types';
-import { EthAddress } from './utils/eth';
+import { Chunk } from './chunk/cac';
+import { FeedPayloadResult } from './modules/feed';
+import type { AllSettlements, BalanceResponse, BeeOptions, BeeRequestOptions, BeeVersions, ChainState, ChequebookAddressResponse, ChequebookBalanceResponse, CollectionUploadOptions, DebugStatus, DownloadOptions, EnvelopeWithBatchId, FeedReader, FeedWriter, FileData, FileUploadOptions, GetGranteesResult, GlobalPostageBatch, GranteesResult, GsocMessageHandler, GsocSubscription, Health, LastCashoutActionResponse, LastChequesForPeerResponse, LastChequesResponse, NodeAddresses, NodeInfo, NumberString, Peer, PeerBalance, Pin, PingResponse, PostageBatch, PostageBatchBuckets, PssMessageHandler, PssSubscription, Readiness, RedistributionState, RedundantUploadOptions, ReferenceInformation, RemovePeerResponse, ReserveState, SOCReader, SOCWriter, Settlements, Tag, Topology, TransactionInfo, UploadOptions, WalletBalance } from './types';
+import { AllTagsOptions, Collection, PostageBatchOptions, TransactionOptions, UploadResult } from './types';
+import { Bytes } from './utils/bytes';
+import { Duration } from './utils/duration';
+import { Size } from './utils/size';
+import { BZZ } from './utils/tokens';
+import { BatchId, EthAddress, FeedIndex, Identifier, PeerAddress, PrivateKey, PublicKey, Reference, Topic, TransactionId } from './utils/typed-bytes';
+import { UploadProgress } from './utils/upload-progress';
 /**
  * The main component that abstracts operations available on the main Bee API.
  *
@@ -19,7 +24,7 @@ export declare class Bee {
     /**
      * Default Signer object used for signing operations, mainly Feeds.
      */
-    readonly signer?: Signer;
+    readonly signer?: PrivateKey;
     /**
      * Options for making requests
      * @private
@@ -41,35 +46,35 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `POST /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes/post)
      */
-    uploadData(postageBatchId: string | BatchId, data: string | Uint8Array, options?: UploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadData(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array, options?: RedundantUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Requests content length for a `/bytes` reference
      *
      * @see [Bee API reference - `HEAD /bytes/`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1%7Breference%7D/head)
      */
-    probeData(reference: ReferenceOrEns | string, options?: BeeRequestOptions): Promise<ReferenceInformation>;
+    probeData(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<ReferenceInformation>;
     /**
      * Download data as a byte array
      *
-     * @param reference Bee data reference in hex string (either 64 or 128 chars long) or ENS domain.
+     * @param resource Swarm reference, Swarm CID, or ENS domain
      * @param options Options that affects the request behavior
      * @throws TypeError if some of the input parameters is not expected type
      * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1{reference}/get)
      */
-    downloadData(reference: ReferenceOrEns | string, options?: BeeRequestOptions): Promise<Data>;
+    downloadData(resource: Reference | string | Uint8Array, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<Bytes>;
     /**
      * Download data as a Readable stream
      *
-     * @param reference Bee data reference in hex string (either 64 or 128 chars long) or ENS domain.
+     * @param resource Swarm reference, Swarm CID, or ENS domain
      * @param options Options that affects the request behavior
      * @throws TypeError if some of the input parameters is not expected type
      * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1{reference}/get)
      */
-    downloadReadableData(reference: ReferenceOrEns | string, options?: BeeRequestOptions): Promise<ReadableStream<Uint8Array>>;
+    downloadReadableData(resource: Reference | Uint8Array | string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<ReadableStream<Uint8Array>>;
     /**
      * Upload chunk to a Bee node
      *
@@ -81,7 +86,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `POST /chunks`](https://docs.ethswarm.org/api/#tag/Chunk/paths/~1chunks/post)
      */
-    uploadChunk(stamp: BatchId | Uint8Array | string, data: Uint8Array, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadChunk(stamp: EnvelopeWithBatchId | BatchId | Uint8Array | string, data: Uint8Array | Chunk, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Download chunk as a byte array
      *
@@ -92,7 +97,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /chunks`](https://docs.ethswarm.org/api/#tag/Chunk/paths/~1chunks~1{address}/get)
      */
-    downloadChunk(reference: ReferenceOrEns | string, options?: BeeRequestOptions): Promise<Data>;
+    downloadChunk(reference: Reference | Uint8Array | string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<Uint8Array>;
     /**
      * Create a grantees list from the given array of public keys.
      *
@@ -103,7 +108,7 @@ export declare class Bee {
      * @param requestOptions - Optional request options.
      * @returns A promise that resolves to a `GranteesResult` object.
      */
-    createGrantees(postageBatchId: string | BatchId, grantees: string[], requestOptions?: BeeRequestOptions): Promise<GranteesResult>;
+    createGrantees(postageBatchId: BatchId | Uint8Array | string, grantees: PublicKey[] | Uint8Array[] | string[], requestOptions?: BeeRequestOptions): Promise<GranteesResult>;
     /**
      * Retrieves the grantees for a given reference.
      *
@@ -111,7 +116,7 @@ export declare class Bee {
      * @param requestOptions - Optional request options.
      * @returns A promise that resolves to a `GetGranteesResult` object.
      */
-    getGrantees(reference: ReferenceOrEns | string, requestOptions?: BeeRequestOptions): Promise<GetGranteesResult>;
+    getGrantees(reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<GetGranteesResult>;
     /**
      * Updates the grantees of a specific reference and history.
      *
@@ -122,16 +127,13 @@ export declare class Bee {
      * @param requestOptions - Optional request options.
      * @returns A Promise that resolves to to a `GranteesResult` object.
      */
-    patchGrantees(postageBatchId: string | BatchId, reference: Reference | string, history: Reference | string, grantees: {
-        add?: string[];
-        revoke?: string[];
+    patchGrantees(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, history: Reference | Uint8Array | string, grantees: {
+        add?: PublicKey[] | Uint8Array[] | string[];
+        revoke?: PublicKey[] | Uint8Array[] | string[];
     }, requestOptions?: BeeRequestOptions): Promise<GranteesResult>;
     /**
      * Upload single file to a Bee node.
      *
-     * **To make sure that you won't lose critical data it is highly recommended to also
-     * locally pin the data with `options.pin = true`**
-     *
      * @param postageBatchId Postage BatchId to be used to upload the data with
      * @param data    Data or file to be uploaded
      * @param name    Optional name of the uploaded file
@@ -142,11 +144,11 @@ export declare class Bee {
      * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz/post)
      * @returns reference is a content hash of the file
      */
-    uploadFile(postageBatchId: string | BatchId, data: string | Uint8Array | Readable | File, name?: string, options?: FileUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResultWithCid>;
+    uploadFile(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array | Readable | File, name?: string, options?: FileUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Download single file.
      *
-     * @param reference Bee file reference in hex string (either 64 or 128 chars long), ENS domain or Swarm CID.
+     * @param resource Swarm reference, Swarm CID, or ENS domain
      * @param path If reference points to manifest, then this parameter defines path to the file
      * @param options Options that affects the request behavior
      * @throws TypeError if some of the input parameters is not expected type
@@ -155,7 +157,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz~1%7Breference%7D~1%7Bpath%7D/get)
      */
-    downloadFile(reference: ReferenceCidOrEns | string, path?: string, options?: BeeRequestOptions): Promise<FileData<Data>>;
+    downloadFile(resource: Reference | Uint8Array | string, path?: string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<FileData<Bytes>>;
     /**
      * Download single file as a readable stream
      *
@@ -168,7 +170,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz~1%7Breference%7D~1%7Bpath%7D/get)
      */
-    downloadReadableFile(reference: ReferenceCidOrEns | string, path?: string, options?: BeeRequestOptions): Promise<FileData<ReadableStream<Uint8Array>>>;
+    downloadReadableFile(reference: Reference | Uint8Array | string, path?: string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<FileData<ReadableStream<Uint8Array>>>;
     /**
      * Upload collection of files to a Bee node
      *
@@ -185,7 +187,10 @@ export declare class Bee {
      * @see [Bee docs - Upload directory](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download#upload-a-directory)
      * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz/post)
      */
-    uploadFiles(postageBatchId: string | BatchId, fileList: FileList | File[], options?: CollectionUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResultWithCid>;
+    uploadFiles(postageBatchId: BatchId | Uint8Array | string, fileList: FileList | File[], options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    hashDirectory(dir: string): Promise<Reference>;
+    streamDirectory(postageBatchId: BatchId | Uint8Array | string, dir: string, onUploadProgress?: (progress: UploadProgress) => void, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    streamFiles(postageBatchId: BatchId | Uint8Array | string, files: File[] | FileList, onUploadProgress?: (progress: UploadProgress) => void, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Upload Collection that you can assembly yourself.
      *
@@ -196,7 +201,7 @@ export declare class Bee {
      * @param collection
      * @param options Collections and request options
      */
-    uploadCollection(postageBatchId: string | BatchId, collection: Collection, options?: CollectionUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResultWithCid>;
+    uploadCollection(postageBatchId: BatchId | Uint8Array | string, collection: Collection, options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Upload collection of files.
      *
@@ -213,7 +218,7 @@ export declare class Bee {
      * @see [Bee docs - Upload directory](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download#upload-a-directory)
      * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz/post)
      */
-    uploadFilesFromDirectory(postageBatchId: string | BatchId, dir: string, options?: CollectionUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResultWithCid>;
+    uploadFilesFromDirectory(postageBatchId: BatchId | Uint8Array | string, dir: string, options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Create a new Tag which is meant for tracking progres of syncing data across network.
      *
@@ -284,7 +289,7 @@ export declare class Bee {
      *
      * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
      */
-    pin(reference: Reference | string, options?: BeeRequestOptions): Promise<void>;
+    pin(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<void>;
     /**
      * Unpin local data with given reference
      *
@@ -294,7 +299,7 @@ export declare class Bee {
      *
      * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
      */
-    unpin(reference: Reference | string, options?: BeeRequestOptions): Promise<void>;
+    unpin(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<void>;
     /**
      * Get list of all locally pinned references
      *
@@ -312,7 +317,7 @@ export declare class Bee {
      *
      * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
      */
-    getPin(reference: Reference | string, options?: BeeRequestOptions): Promise<Pin>;
+    getPin(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<Pin>;
     /**
      * Instructs the Bee node to reupload a locally pinned data into the network.
      *
@@ -324,7 +329,7 @@ export declare class Bee {
      *
      * @see [Bee API reference - `PUT /stewardship`](https://docs.ethswarm.org/api/#tag/Stewardship/paths/~1stewardship~1{reference}/put)
      */
-    reuploadPinnedData(reference: ReferenceOrEns | string, options?: BeeRequestOptions): Promise<void>;
+    reuploadPinnedData(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<void>;
     /**
      * Checks if content specified by reference is retrievable from the network.
      *
@@ -335,7 +340,7 @@ export declare class Bee {
      *
      * @see [Bee API reference - `GET /stewardship`](https://docs.ethswarm.org/api/#tag/Stewardship/paths/~1stewardship~1{reference}/get)
      */
-    isReferenceRetrievable(reference: ReferenceOrEns | string, options?: BeeRequestOptions): Promise<boolean>;
+    isReferenceRetrievable(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<boolean>;
     /**
      * Functions that validates if feed is retrievable in the network.
      *
@@ -351,7 +356,7 @@ export declare class Bee {
      * @param index
      * @param options
      */
-    isFeedRetrievable(type: FeedType, owner: EthAddress | Uint8Array | string, topic: Topic | Uint8Array | string, index?: Index | number | IndexBytes | string, options?: BeeRequestOptions): Promise<boolean>;
+    isFeedRetrievable(owner: EthAddress | Uint8Array | string, topic: Topic | Uint8Array | string, index?: FeedIndex, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<boolean>;
     /**
      * Send data to recipient or target with Postal Service for Swarm.
      *
@@ -374,7 +379,7 @@ export declare class Bee {
      * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
      * @see [Bee API reference - `POST /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1send~1{topic}~1{targets}/post)
      */
-    pssSend(postageBatchId: string | BatchId, topic: string, target: AddressPrefix, data: string | Uint8Array, recipient?: string | PublicKey, options?: BeeRequestOptions): Promise<void>;
+    pssSend(postageBatchId: BatchId | Uint8Array | string, topic: Topic, target: string, data: string | Uint8Array, recipient?: string | PublicKey, options?: BeeRequestOptions): Promise<void>;
     /**
      * Subscribe to messages for given topic with Postal Service for Swarm
      *
@@ -389,7 +394,7 @@ export declare class Bee {
      * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
      * @see [Bee API reference - `GET /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1{topic}/get)
      */
-    pssSubscribe(topic: string, handler: PssMessageHandler): PssSubscription;
+    pssSubscribe(topic: Topic, handler: PssMessageHandler): PssSubscription;
     /**
      * Receive message with Postal Service for Swarm
      *
@@ -414,14 +419,16 @@ export declare class Bee {
      * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
      * @see [Bee API reference - `GET /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1{topic}/get)
      */
-    pssReceive(topic: string, timeoutMsec?: number): Promise<Data>;
+    pssReceive(topic: Topic, timeoutMsec?: number): Promise<Bytes>;
+    gsocMine(targetOverlay: PeerAddress | Uint8Array | string, identifier: Identifier | Uint8Array | string, proximity?: number): PrivateKey;
+    gsocSend(postageBatchId: BatchId | Uint8Array | string, signer: PrivateKey | Uint8Array | string, identifier: Identifier | Uint8Array | string, data: string | Uint8Array, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    gsocSubscribe(address: EthAddress | Uint8Array | string, identifier: Identifier | Uint8Array | string, handler: GsocMessageHandler): GsocSubscription;
     /**
      * Create feed manifest chunk and return the reference to it.
      *
      * Feed manifest chunk allows for a feed to be able to be resolved through `/bzz` endpoint.
      *
      * @param postageBatchId  Postage BatchId to be used to create the Feed Manifest
-     * @param type            The type of the feed, can be 'epoch' or 'sequence'
      * @param topic           Topic in hex or bytes
      * @param owner           Owner's ethereum address in hex or bytes
      * @param options Options that affects the request behavior
@@ -429,77 +436,28 @@ export declare class Bee {
      * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
      * @see [Bee API reference - `POST /feeds`](https://docs.ethswarm.org/api/#tag/Feed/paths/~1feeds~1{owner}~1{topic}/post)
      */
-    createFeedManifest(stamp: BatchId | Uint8Array | string, type: FeedType, topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, options?: BeeRequestOptions): Promise<FeedManifestResult>;
+    createFeedManifest(postageBatchId: BatchId | Uint8Array | string, topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<Reference>;
     /**
      * Make a new feed reader for downloading feed updates.
      *
-     * @param type    The type of the feed, can be 'epoch' or 'sequence'
      * @param topic   Topic in hex or bytes
      * @param owner   Owner's ethereum address in hex or bytes
      * @param options Options that affects the request behavior
      *
      * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
      */
-    makeFeedReader(type: FeedType, topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, options?: BeeRequestOptions): FeedReader;
+    makeFeedReader(topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, options?: BeeRequestOptions): FeedReader;
     /**
      * Make a new feed writer for updating feeds
      *
-     * @param type    The type of the feed, can be 'epoch' or 'sequence'
      * @param topic   Topic in hex or bytes
      * @param signer  The signer's private key or a Signer instance that can sign data
      * @param options Options that affects the request behavior
      *
      * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
      */
-    makeFeedWriter(type: FeedType, topic: Topic | Uint8Array | string, signer?: Signer | Uint8Array | string, options?: BeeRequestOptions): FeedWriter;
-    /**
-     * High-level function that allows you to easily set JSON data to feed.
-     * JSON-like data types are supported.
-     *
-     * The default Signer of Bee instance is used if `options.signer` is not specified.
-     * If none of those two is set error is thrown.
-     *
-     * @param postageBatchId Postage BatchId to be used to upload the data with
-     * @param topic Human readable string, that is internally hashed so there are no constrains there.
-     * @param data JSON compatible data
-     * @param options
-     * @param options.signer Custom instance of Signer or string with private key.
-     * @param options.type Type of Feed
-     *
-     * @throws BeeError if `options.signer` is not specified nor the default Signer on Bee's instance is specified.
-     *
-     * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
-     */
-    setJsonFeed<T extends AnyJson>(postageBatchId: string | BatchId, topic: string, data: T, options?: JsonFeedOptions & UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
-    /**
-     * High-level function that allows you to easily get data from feed.
-     * Returned data are parsed using JSON.parse().
-     *
-     * This method also supports specification of `signer` object passed to constructor. The order of evaluation is:
-     *  - `options.address`
-     *  - `options.signer`
-     *  - `this.signer`
-     *
-     * At least one of these has to be specified!
-     *
-     * @param topic Human readable string, that is internally hashed so there are no constrains there.
-     * @param options
-     * @param options.signer Custom instance of Signer or string with private key. This option is exclusive with `address` option.
-     * @param options.address Ethereum address of owner of the feed that signed it. This option is exclusive with `signer` option.
-     * @param options.type Type of Feed
-     *
-     * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
-     */
-    getJsonFeed<T extends AnyJson>(topic: string, options?: JsonFeedOptions, requestOptions?: BeeRequestOptions): Promise<T>;
-    /**
-     * Make a new feed topic from a string
-     *
-     * Because the topic has to be 32 bytes long this function
-     * hashes the input string to create a topic string of arbitrary length.
-     *
-     * @param topic The input string
-     */
-    makeFeedTopic(topic: string): Topic;
+    makeFeedWriter(topic: Topic | Uint8Array | string, signer?: PrivateKey | Uint8Array | string, options?: BeeRequestOptions): FeedWriter;
+    fetchLatestFeedUpdate(topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<FeedPayloadResult>;
     /**
      * Returns an object for reading single owner chunks
      *
@@ -515,8 +473,8 @@ export declare class Bee {
      * @param options Options that affects the request behavior
      * @see [Bee docs - Chunk Types](https://docs.ethswarm.org/docs/develop/tools-and-features/chunk-types#single-owner-chunks)
      */
-    makeSOCWriter(signer?: Signer | Uint8Array | string, options?: BeeRequestOptions): SOCWriter;
-    createEnvelope(postageBatchId: BatchId, reference: Reference, options?: BeeRequestOptions): Promise<Envelope>;
+    makeSOCWriter(signer?: PrivateKey | Uint8Array | string, options?: BeeRequestOptions): SOCWriter;
+    createEnvelope(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<EnvelopeWithBatchId>;
     /**
      * Ping the Bee node to see if there is a live Bee node on the given URL.
      *
@@ -533,24 +491,13 @@ export declare class Bee {
     isConnected(options?: BeeRequestOptions): Promise<boolean>;
     getNodeAddresses(options?: BeeRequestOptions): Promise<NodeAddresses>;
     getBlocklist(options?: BeeRequestOptions): Promise<Peer[]>;
-    /**
-     * Retrieve tag extended information from Bee node
-     *
-     * @param tagUid UID or tag object to be retrieved
-     * @throws TypeError if tagUid is in not correct format
-     *
-     * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
-     * @see [Bee API reference - `GET /tags/{uid}`](https://docs.ethswarm.org/debug-api/#tag/Tag)
-     *
-     */
-    retrieveExtendedTag(tagUid: number | Tag, options?: BeeRequestOptions): Promise<ExtendedTag>;
     /**
      * Get list of peers for this node
      */
     getPeers(options?: BeeRequestOptions): Promise<Peer[]>;
-    removePeer(peer: string | Address, options?: BeeRequestOptions): Promise<RemovePeerResponse>;
+    removePeer(peer: PeerAddress | string, options?: BeeRequestOptions): Promise<RemovePeerResponse>;
     getTopology(options?: BeeRequestOptions): Promise<Topology>;
-    pingPeer(peer: string | Address, options?: BeeRequestOptions): Promise<PingResponse>;
+    pingPeer(peer: PeerAddress | string, options?: BeeRequestOptions): Promise<PingResponse>;
     /**
      * Get the balances with all known peers including prepaid services
      */
@@ -560,7 +507,7 @@ export declare class Bee {
      *
      * @param address Swarm address of peer
      */
-    getPeerBalance(address: Address | string, options?: BeeRequestOptions): Promise<PeerBalance>;
+    getPeerBalance(address: PeerAddress | string, options?: BeeRequestOptions): Promise<PeerBalance>;
     /**
      * Get the past due consumption balances with all known peers
      */
@@ -570,7 +517,7 @@ export declare class Bee {
      *
      * @param address Swarm address of peer
      */
-    getPastDueConsumptionPeerBalance(address: Address | string, options?: BeeRequestOptions): Promise<PeerBalance>;
+    getPastDueConsumptionPeerBalance(address: PeerAddress | string, options?: BeeRequestOptions): Promise<PeerBalance>;
     /**
      * Get the address of the chequebook contract used.
      *
@@ -591,13 +538,13 @@ export declare class Bee {
      *
      * @param address  Swarm address of peer
      */
-    getLastChequesForPeer(address: Address | string, options?: BeeRequestOptions): Promise<LastChequesForPeerResponse>;
+    getLastChequesForPeer(address: PeerAddress | string, options?: BeeRequestOptions): Promise<LastChequesForPeerResponse>;
     /**
      * Get last cashout action for the peer
      *
      * @param address  Swarm address of peer
      */
-    getLastCashoutAction(address: Address | string, options?: BeeRequestOptions): Promise<LastCashoutActionResponse>;
+    getLastCashoutAction(address: PeerAddress | string, options?: BeeRequestOptions): Promise<LastCashoutActionResponse>;
     /**
      * Cashout the last cheque for the peer
      *
@@ -606,7 +553,7 @@ export declare class Bee {
      * @param options.gasPrice Gas price for the cashout transaction in WEI
      * @param options.gasLimit Gas limit for the cashout transaction in WEI
      */
-    cashoutLastCheque(address: string | Address, options?: CashoutOptions, requestOptions?: BeeRequestOptions): Promise<string>;
+    cashoutLastCheque(address: PeerAddress | string, options?: TransactionOptions, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Deposit tokens from overlay address into chequebook
      *
@@ -614,7 +561,7 @@ export declare class Bee {
      * @param gasPrice Gas Price in WEI for the transaction call
      * @return string  Hash of the transaction
      */
-    depositTokens(amount: number | NumberString, gasPrice?: NumberString, options?: BeeRequestOptions): Promise<string>;
+    depositTokens(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Withdraw tokens from the chequebook to the overlay address
      *
@@ -622,13 +569,13 @@ export declare class Bee {
      * @param gasPrice Gas Price in WEI for the transaction call
      * @return string  Hash of the transaction
      */
-    withdrawTokens(amount: number | NumberString, gasPrice?: NumberString, options?: BeeRequestOptions): Promise<string>;
+    withdrawTokens(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Get amount of sent and received from settlements with a peer
      *
      * @param address  Swarm address of peer
      */
-    getSettlements(address: Address | string, options?: BeeRequestOptions): Promise<Settlements>;
+    getSettlements(address: PeerAddress | string, options?: BeeRequestOptions): Promise<Settlements>;
     /**
      * Get settlements with all known peers and total amount sent or received
      */
@@ -644,38 +591,17 @@ export declare class Bee {
     /**
      * Get readiness of node
      */
-    getReadiness(options?: BeeRequestOptions): Promise<boolean>;
+    getReadiness(options?: BeeRequestOptions): Promise<Readiness>;
     /**
      * Get mode information of node
      */
     getNodeInfo(options?: BeeRequestOptions): Promise<NodeInfo>;
-    /**
-     * Connnects to a node and checks if it is a supported Bee version by the bee-js
-     *
-     * @returns true if the Bee node version is supported
-     * @deprecated Use `BeeDebug.isSupportedExactVersion()` instead
-     */
-    isSupportedVersion(options?: BeeRequestOptions): Promise<boolean> | never;
     /**
      * Connects to a node and checks if its version matches with the one that bee-js supports.
      *
-     * Be aware that this is the most strict version check and most probably
-     * you will want to use more relaxed API-versions based checks like
-     * `BeeDebug.isSupportedApiVersion()`, `BeeDebug.isSupportedMainApiVersion()` or `BeeDebug.isSupportedDebugApiVersion()`
-     * based on your use-case.
-     *
      * @param options
      */
     isSupportedExactVersion(options?: BeeRequestOptions): Promise<boolean> | never;
-    /**
-     * Connects to a node and checks if its main's API version matches with the one that bee-js supports.
-     *
-     * This is useful if you are not using `BeeDebug` class (for anything else then this check)
-     * and want to make sure about compatibility.
-     *
-     * @param options
-     */
-    isSupportedMainApiVersion(options?: BeeRequestOptions): Promise<boolean> | never;
     /**
      *
      * Connects to a node and checks if its Main API version matches with the one that bee-js supports.
@@ -721,25 +647,30 @@ export declare class Bee {
      * @throws TypeError if non-integer value is passed to amount or depth
      *
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
-     * @see [Bee Debug API reference - `POST /stamps`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1{amount}~1{depth}/post)
+     * @see [Bee Debug API reference - `POST /stamps`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1{amount}~1{depth}/post)
      */
-    createPostageBatch(amount: NumberString, depth: number, options?: PostageBatchOptions, requestOptions?: BeeRequestOptions): Promise<BatchId>;
+    createPostageBatch(amount: NumberString | string | bigint, depth: number, options?: PostageBatchOptions, requestOptions?: BeeRequestOptions): Promise<BatchId>;
+    buyStorage(size: Size, duration: Duration, options?: PostageBatchOptions, requestOptions?: BeeRequestOptions): Promise<BatchId>;
+    getStorageCost(size: Size, duration: Duration, options?: BeeRequestOptions): Promise<BZZ>;
+    extendStorageSize(postageBatchId: BatchId | Uint8Array | string, size: Size, options?: BeeRequestOptions): Promise<BatchId>;
+    extendStorageDuration(postageBatchId: BatchId | Uint8Array | string, duration: Duration, options?: BeeRequestOptions): Promise<BatchId>;
+    getExtensionCost(postageBatchId: BatchId | Uint8Array | string, size: Size, duration: Duration, options?: BeeRequestOptions): Promise<BZZ>;
+    getSizeExtensionCost(postageBatchId: BatchId | Uint8Array | string, size: Size, options?: BeeRequestOptions): Promise<BZZ>;
+    getDurationExtensionCost(postageBatchId: BatchId | Uint8Array | string, duration: Duration, options?: BeeRequestOptions): Promise<BZZ>;
     /**
      * Topup a fresh amount of BZZ to given Postage Batch.
      *
      * For better understanding what each parameter means and what are the optimal values please see
      * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive).
      *
-     * **WARNING: THIS CREATES TRANSACTIONS THAT SPENDS MONEY**
-     *
      * @param postageBatchId Batch ID
      * @param amount Amount to be added to the batch
      * @param options Request options
      *
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
-     * @see [Bee Debug API reference - `PATCH /stamps/topup/${id}/${amount}`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1topup~1{id}~1{amount}/patch)
+     * @see [Bee Debug API reference - `PATCH /stamps/topup/${id}/${amount}`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1topup~1{batch_id}~1{amount}/patch)
      */
-    topUpBatch(postageBatchId: BatchId | string, amount: NumberString, options?: BeeRequestOptions): Promise<void>;
+    topUpBatch(postageBatchId: BatchId | Uint8Array | string, amount: NumberString | string | bigint, options?: BeeRequestOptions): Promise<BatchId>;
     /**
      * Dilute given Postage Batch with new depth (that has to be bigger then the original depth), which allows
      * the Postage Batch to be used for more chunks.
@@ -747,45 +678,43 @@ export declare class Bee {
      * For better understanding what each parameter means and what are the optimal values please see
      * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive).
      *
-     * **WARNING: THIS CREATES TRANSACTIONS THAT SPENDS MONEY**
-     *
      * @param postageBatchId Batch ID
      * @param depth Amount to be added to the batch
      * @param options Request options
      *
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
-     * @see [Bee Debug API reference - `PATCH /stamps/topup/${id}/${amount}`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1topup~1{id}~1{amount}/patch)
+     * @see [Bee Debug API reference - `PATCH /stamps/topup/${id}/${amount}`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1dilute~1%7Bbatch_id%7D~1%7Bdepth%7D/patch)
      */
-    diluteBatch(postageBatchId: BatchId | string, depth: number, options?: BeeRequestOptions): Promise<void>;
+    diluteBatch(postageBatchId: BatchId | Uint8Array | string, depth: number, options?: BeeRequestOptions): Promise<BatchId>;
     /**
      * Return details for specific postage batch.
      *
      * @param postageBatchId Batch ID
      *
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
-     * @see [Bee Debug API reference - `GET /stamps/${id}`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1{id}/get)
+     * @see [Bee Debug API reference - `GET /stamps/${id}`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1%7Bbatch_id%7D/get)
      */
-    getPostageBatch(postageBatchId: BatchId | string, options?: BeeRequestOptions): Promise<PostageBatch>;
+    getPostageBatch(postageBatchId: BatchId | Uint8Array | string, options?: BeeRequestOptions): Promise<PostageBatch>;
     /**
      * Return detailed information related to buckets for specific postage batch.
      *
      * @param postageBatchId Batch ID
      *
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
-     * @see [Bee Debug API reference - `GET /stamps/${id}/buckets`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1{id}~1buckets/get)
+     * @see [Bee Debug API reference - `GET /stamps/${id}/buckets`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1%7Bbatch_id%7D~1buckets/get)
      */
-    getPostageBatchBuckets(postageBatchId: BatchId | string, options?: BeeRequestOptions): Promise<PostageBatchBuckets>;
+    getPostageBatchBuckets(postageBatchId: BatchId | Uint8Array | string, options?: BeeRequestOptions): Promise<PostageBatchBuckets>;
     /**
      * Return all postage batches that has the node available.
      *
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
-     * @see [Bee Debug API reference - `GET /stamps`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps/get)
+     * @see [Bee Debug API reference - `GET /stamps`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps/get)
      */
     getAllPostageBatch(options?: BeeRequestOptions): Promise<PostageBatch[]>;
     /**
      * Return all globally available postage batches.
      */
-    getAllGlobalPostageBatch(options?: BeeRequestOptions): Promise<PostageBatch[]>;
+    getAllGlobalPostageBatch(options?: BeeRequestOptions): Promise<GlobalPostageBatch[]>;
     /**
      * Return lists of all current pending transactions that the Bee made
      */
@@ -794,26 +723,26 @@ export declare class Bee {
      * Return transaction information for specific transaction
      * @param transactionHash
      */
-    getPendingTransaction(transactionHash: TransactionHash | string, options?: BeeRequestOptions): Promise<TransactionInfo>;
+    getPendingTransaction(transactionHash: TransactionId | Uint8Array | string, options?: BeeRequestOptions): Promise<TransactionInfo>;
     /**
      * Rebroadcast already created transaction.
      * This is mainly needed when your transaction fall off mempool from other reason is not incorporated into block.
      *
      * @param transactionHash
      */
-    rebroadcastPendingTransaction(transactionHash: TransactionHash | string, options?: BeeRequestOptions): Promise<TransactionHash>;
+    rebroadcastPendingTransaction(transactionHash: TransactionId | Uint8Array | string, options?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Cancel currently pending transaction
      * @param transactionHash
      * @param gasPrice
      */
-    cancelPendingTransaction(transactionHash: TransactionHash | string, gasPrice?: NumberString, options?: BeeRequestOptions): Promise<TransactionHash>;
+    cancelPendingTransaction(transactionHash: TransactionId | Uint8Array | string, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Gets the staked amount of BZZ (in PLUR unit) as number string.
      *
      * @param options
      */
-    getStake(options?: BeeRequestOptions): Promise<NumberString>;
+    getStake(options?: BeeRequestOptions): Promise<BZZ>;
     /**
      * Deposits given amount of BZZ token (in PLUR unit).
      *
@@ -822,7 +751,7 @@ export declare class Bee {
      * @param amount Amount of BZZ token (in PLUR unit) to be staked. Minimum is 100_000_000_000_000_000 PLUR (10 BZZ).
      * @param options
      */
-    depositStake(amount: NumberString, options?: TransactionOptions, requestOptions?: BeeRequestOptions): Promise<void>;
+    depositStake(amount: BZZ | NumberString | string | bigint, options?: TransactionOptions, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Get current status of node in redistribution game
      *
@@ -830,11 +759,5 @@ export declare class Bee {
      */
     getRedistributionState(options?: BeeRequestOptions): Promise<RedistributionState>;
     private waitForUsablePostageStamp;
-    /**
-     * @param signer
-     * @private
-     * @throws BeeError if either no Signer was passed or no default Signer was specified for the instance
-     */
-    private resolveSigner;
-    private getRequestOptionsForCall;
+    protected getRequestOptionsForCall(options?: BeeRequestOptions): BeeRequestOptions;
 }