@ethersphere/bee-js 9.8.0 → 10.0.0

package/dist/types/bee.d.ts

@@ -2,7 +2,7 @@
 import { Readable } from 'stream';
 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 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, RedundancyLevel, 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';
@@ -11,80 +11,121 @@ import { BZZ, DAI } 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.
+ * The main component that abstracts operations available on the Bee API.
  *
- * Not all methods are always available as it depends in what mode is Bee node launched in.
- * For example gateway mode and light node mode has only limited set of endpoints enabled.
+ * Instantiate with `new Bee(url, options)` where `url` is the Bee node URL and `options` are optional parameters.
+ *
+ * @example
+ * const bee = new Bee('http://localhost:1633')
  */
 export declare class Bee {
     /**
-     * URL on which is the main API of Bee node exposed
+     * Bee node API URL.
+     *
+     * @example
+     * `http://localhost:1633`
      */
     readonly url: string;
     /**
-     * Default Signer object used for signing operations, mainly Feeds.
+     * Default signer (a private key) used for signing.
+     *
+     * Mainly used in single-owner chunk (SOC) related operations, and consequently in feeds.
+     *
+     * If not provided, methods such as `makeFeedWriter` and `makeSOCWriter`
+     * must be provided with a private key in their respective function calls.
      */
     readonly signer?: PrivateKey;
     /**
-     * Network on which the Bee node is running
+     * Network on which the Bee node is running.
+     *
+     * This is currently used to determine block time for postage batch time-to-live (TTL) calculations.
+     * The block time for `gnosis` is `5` seconds, and for `sepolia` it is `15` seconds.
+     *
+     * @default 'gnosis'
      */
     readonly network: 'gnosis' | 'sepolia';
     /**
-     * Options for making requests
-     * @private
+     * Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
     private readonly requestOptions;
     /**
      * @param url URL on which is the main API of Bee node exposed
      * @param options
+     *
+     * @example
+     * const bee = new Bee('http://localhost:1633')
      */
     constructor(url: string, options?: BeeOptions);
     /**
-     * Upload data to a Bee node
+     * Uploads raw data to the network (as opposed to uploading chunks or files).
      *
-     * @param postageBatchId Postage BatchId to be used to upload the data with
-     * @param data    Data to be uploaded
-     * @param options Additional options like tag, encryption, pinning, content-type and request options
+     * Data uploaded with this method should be retrieved with the {@link downloadData} method.
+     *
+     * @param postageBatchId Usable Postage Batch ID with sufficient capacity to upload the data.
+     * @param data           A `string` (text data) or `Uint8Array` (raw data) to be uploaded.
+     * @param options        Additional options like tag, encryption, pinning, content-type and request options.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @returns reference is a content hash of the data
-     * @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)
+     * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      */
     uploadData(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array, options?: RedundantUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
-     * Requests content length for a `/bytes` reference
+     * Fetches content length for a `/bytes` reference.
+     *
+     * @param reference
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
-     * @see [Bee API reference - `HEAD /bytes/`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1%7Breference%7D/head)
+     * @see [Bee API reference - `HEAD /bytes/{reference}`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1%7Breference%7D/head)
      */
-    probeData(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<ReferenceInformation>;
+    probeData(reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<ReferenceInformation>;
     /**
-     * Download data as a byte array
+     * Downloads raw data through the `GET /bytes/{reference}` endpoint.
+     *
+     * This method may be used to download data that was uploaded with the {@link uploadData} method.
+     *
+     * For downloading files or using the `GET /bzz/{reference}/` endpoint, use the {@link downloadFile} method instead.
+     * For downloading chunks or using the `GET /chunks/{reference} endpoint, use the `downloadChunk` method instead.
      *
-     * @param resource Swarm reference, Swarm CID, or ENS domain
+     * @param resource Swarm reference, Swarm CID, or ENS domain.
      * @param options Options that affects the request behavior
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
      * @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(resource: Reference | string | Uint8Array, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<Bytes>;
     /**
-     * Download data as a Readable stream
+     * Download raw data through the `GET /bytes/{reference}` endpoint.
+     *
+     * This method may be used to download data that was uploaded with the {@link uploadData} method.
+     *
+     * Only tested in Node.js environment.
+     *
+     * @param resource Swarm reference, Swarm CID, or ENS domain.
+     * @param options Options that affects the request behavior.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
+     * @returns ReadableStream of Uint8Array
      *
-     * @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(resource: Reference | Uint8Array | string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<ReadableStream<Uint8Array>>;
     /**
-     * Upload chunk to a Bee node
+     * Uploads a chunk to the network.
+     *
+     * Chunks uploaded with this method should be retrieved with the {@link downloadChunk} method.
      *
-     * @param postageBatchId Postage BatchId to be used to upload the chunk with
+     * @param stamp Postage Batch ID or an Envelope created with the {@link createEnvelope} method.
      * @param data    Raw chunk to be uploaded
      * @param options Additional options like tag, encryption, pinning, content-type and request options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @returns reference is a content hash of the data
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
@@ -92,12 +133,17 @@ export declare class Bee {
      */
     uploadChunk(stamp: EnvelopeWithBatchId | BatchId | Uint8Array | string, data: Uint8Array | Chunk, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
-     * Download chunk as a byte array
+     * Downloads a chunk as a `Uint8Array`.
+     *
+     * May be used to download chunks uploaded with the {@link uploadChunk} method.
+     *
+     * Use {@link downloadData} method to download raw data uploaded with the {@link uploadData} method.
+     * Use {@link downloadFile} method to download files uploaded with the {@link uploadFile} method.
      *
      * @param reference Bee chunk reference in hex string (either 64 or 128 chars long) 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
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
      * @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)
      */
@@ -105,7 +151,7 @@ export declare class Bee {
     /**
      * Create a grantees list from the given array of public keys.
      *
-     * The grantees list can be obtained with the `getGrantees` method.
+     * The grantees list can be obtained with the {@link getGrantees} method.
      *
      * @param postageBatchId - The ID of the postage batch.
      * @param grantees - An array of public keys representing the grantees.
@@ -128,7 +174,7 @@ export declare class Bee {
      * @param history - The history.
      * @param postageBatchId - The ID of the postage batch.
      * @param grantees - The grantees.
-     * @param requestOptions - Optional request options.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      * @returns A Promise that resolves to to a `GranteesResult` object.
      */
     patchGrantees(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, history: Reference | Uint8Array | string, grantees: {
@@ -136,12 +182,18 @@ export declare class Bee {
         revoke?: PublicKey[] | Uint8Array[] | string[];
     }, requestOptions?: BeeRequestOptions): Promise<GranteesResult>;
     /**
-     * Upload single file to a Bee node.
+     * Uploads a single file to a Bee node.
+     *
+     * To download the file, use the {@link downloadFile} method.
+     *
+     * Use {@link uploadData} method to upload raw data that can be downloaded with the {@link downloadData} method.
+     * Use {@link uploadChunk} method to upload chunks that can be downloaded with the {@link downloadChunk} method.
      *
      * @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
      * @param options Additional options like tag, encryption, pinning, content-type and request options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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 docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
@@ -150,14 +202,13 @@ export declare class Bee {
      */
     uploadFile(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array | Readable | File, name?: string, options?: FileUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
-     * Download single file.
+     * Downloads a single file.
      *
-     * @param resource Swarm reference, Swarm CID, or ENS domain
+     * @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
-     * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
-     * @see Data
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
      * @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)
      */
@@ -168,8 +219,7 @@ export declare class Bee {
      * @param reference Bee file reference in hex string (either 64 or 128 chars long), ENS domain or Swarm CID.
      * @param path If reference points to manifest / collections, 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
-     * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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)
@@ -186,14 +236,59 @@ export declare class Bee {
      * @param postageBatchId Postage BatchId to be used to upload the data with
      * @param fileList list of files to be uploaded
      * @param options Additional options like tag, encryption, pinning and request options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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 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: BatchId | Uint8Array | string, fileList: FileList | File[], options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    /**
+     * Hashes a directory locally and returns the root hash (Swarm reference).
+     *
+     * The actual Swarm reference may be different as there is no canonical hashing of directories.
+     * For example, metadata may have different casing, or the order of metadata may differ.
+     * Such small differences will result in different Swarm references.
+     *
+     * Different implementations of the Mantaray structure may also result in different Swarm references.
+     *
+     * @param dir
+     * @returns
+     */
     hashDirectory(dir: string): Promise<Reference>;
+    /**
+     * Uploads a directory to the network. The difference between this method and {@link uploadFilesFromDirectory} is that
+     * this method streams the directory contents directly to the Bee node, which supports arbitrary directory sizes,
+     * but may be slower due to uploading chunks one by one.
+     *
+     * Options such as encryption, erasure coding and ACT are not yet available for this method.
+     *
+     * Only intended for the Node.js environment.
+     *
+     * @param postageBatchId
+     * @param dir
+     * @param onUploadProgress
+     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     */
     streamDirectory(postageBatchId: BatchId | Uint8Array | string, dir: string, onUploadProgress?: (progress: UploadProgress) => void, options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    /**
+     * Uploads a collection of files to the network. The difference between this method and {@link uploadFiles} is that
+     * this method streams the files to the Bee node, which supports arbitrary sizes,
+     * but may be slower due to uploading chunks one by one.
+     *
+     * Options such as encryption, erasure coding and ACT are not yet available for this method.
+     *
+     * Only intended for the browser environment.
+     *
+     * @param postageBatchId
+     * @param files
+     * @param onUploadProgress
+     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     */
     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.
@@ -224,50 +319,47 @@ export declare class Bee {
      */
     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.
+     * Creates a new Tag which is meant for tracking upload and synchronization progress.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
-     * @param options Options that affects the request behavior
      * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
      * @see [Bee API reference - `POST /tags`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags/post)
      */
-    createTag(options?: BeeRequestOptions): Promise<Tag>;
+    createTag(requestOptions?: BeeRequestOptions): Promise<Tag>;
     /**
-     * Fetches all tags.
+     * Fetches all tags in a paginated manner.
      *
      * The listing is limited by options.limit. So you have to iterate using options.offset to get all tags.
      *
-     * @param options Options that affects the request behavior
-     * @throws TypeError if limit or offset are not numbers or undefined
-     * @throws BeeArgumentError if limit or offset have invalid options
+     * @param options Specify `limit` and `offset` to paginate through the tags.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
      * @see [Bee API reference - `GET /tags`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags/get)
      */
     getAllTags(options?: AllTagsOptions, requestOptions?: BeeRequestOptions): Promise<Tag[]>;
     /**
-     * Retrieve tag information from Bee node
+     * Retrieves tag information from Bee node.
      *
      * @param tagUid UID or tag object to be retrieved
-     * @param options Options that affects the request behavior
-     * @throws TypeError if tagUid is in not correct format
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Tag/paths/~1tags~1{uid}/get)
      *
      */
-    retrieveTag(tagUid: number | Tag, options?: BeeRequestOptions): Promise<Tag>;
+    retrieveTag(tagUid: number | Tag, requestOptions?: BeeRequestOptions): Promise<Tag>;
     /**
-     * Delete Tag
+     * Deletes Tag.
      *
      * @param tagUid UID or tag object to be retrieved
-     * @param options Options that affects the request behavior
-     * @throws TypeError if tagUid is in not correct format
-     * @throws BeeResponse error if something went wrong on the Bee node side while deleting the tag.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
      * @see [Bee API reference - `DELETE /tags/{uid}`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags~1{uid}/delete)
      */
-    deleteTag(tagUid: number | Tag, options?: BeeRequestOptions): Promise<void>;
+    deleteTag(tagUid: number | Tag, requestOptions?: BeeRequestOptions): Promise<void>;
     /**
      * Update tag's total chunks count.
      *
@@ -276,77 +368,68 @@ export declare class Bee {
      *
      * @param tagUid UID or tag object to be retrieved
      * @param reference The root reference that contains all the chunks to be counted
-     * @param options Options that affects the request behavior
-     * @throws TypeError if tagUid is in not correct format
-     * @throws BeeResponse error if something went wrong on the Bee node side while deleting the tag.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
      * @see [Bee API reference - `PATCH /tags/{uid}`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags~1{uid}/patch)
      */
-    updateTag(tagUid: number | Tag, reference: Reference | string, options?: BeeRequestOptions): Promise<void>;
+    updateTag(tagUid: number | Tag, reference: Reference | string, requestOptions?: BeeRequestOptions): Promise<void>;
     /**
-     * Pin local data with given reference
+     * Pins local data with given reference.
      *
      * @param reference Data reference
-     * @param options Options that affects the request behavior
-     * @throws TypeError if reference is in not correct format
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
      */
-    pin(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<void>;
+    pin(reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<void>;
     /**
-     * Unpin local data with given reference
+     * Unpins local data with given reference.
      *
      * @param reference Data reference
-     * @param options Options that affects the request behavior
-     * @throws TypeError if reference is in not correct format
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
      */
-    unpin(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<void>;
+    unpin(reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<void>;
     /**
-     * Get list of all locally pinned references
+     * Gets list of all locally pinned references.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
-     * @param options Options that affects the request behavior
      * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
      */
-    getAllPins(options?: BeeRequestOptions): Promise<Reference[]>;
+    getAllPins(requestOptions?: BeeRequestOptions): Promise<Reference[]>;
     /**
      * Get pinning status of chunk with given reference
      *
      * @param reference Bee data reference in hex string (either 64 or 128 chars long) 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
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
      */
-    getPin(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<Pin>;
+    getPin(reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<Pin>;
     /**
      * Instructs the Bee node to reupload a locally pinned data into the network.
      *
+     * @param postageBatchId Postage Batch ID that will be used to re-upload the data.
      * @param reference Bee data reference to be re-uploaded in hex string (either 64 or 128 chars long) or ENS domain.
-     * @param options Options that affects the request behavior
-     * @throws BeeArgumentError if the reference is not locally pinned
-     * @throws TypeError if some of the input parameters is not expected type
-     * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee API reference - `PUT /stewardship`](https://docs.ethswarm.org/api/#tag/Stewardship/paths/~1stewardship~1{reference}/put)
      */
-    reuploadPinnedData(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<void>;
+    reuploadPinnedData(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<void>;
     /**
      * Checks if content specified by reference is retrievable from the network.
      *
      * @param reference Bee data reference to be checked in hex string (either 64 or 128 chars long) 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
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee API reference - `GET /stewardship`](https://docs.ethswarm.org/api/#tag/Stewardship/paths/~1stewardship~1{reference}/get)
      */
-    isReferenceRetrievable(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<boolean>;
+    isReferenceRetrievable(reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<boolean>;
     /**
-     * Functions that validates if feed is retrievable in the network.
+     * Functions that validate if feed is retrievable in the network.
      *
      * If no index is passed then it check for "latest" update, which is a weaker guarantee as nobody can be really
      * sure what is the "latest" update.
@@ -359,6 +442,7 @@ export declare class Bee {
      * @param topic
      * @param index
      * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
     isFeedRetrievable(owner: EthAddress | Uint8Array | string, topic: Topic | Uint8Array | string, index?: FeedIndex, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<boolean>;
     /**
@@ -369,26 +453,23 @@ export declare class Bee {
      * most likely for setting up an encrypted communication
      * channel by sending an one-off message.
      *
-     * **Warning! If the recipient Bee node is a light node, then he will never receive the message!**
-     * This is because light nodes does not fully participate in the data exchange in Swarm network and hence the message won't arrive to them.
+     * **Warning! Only full nodes can accept PSS messages.**
      *
      * @param postageBatchId Postage BatchId that will be assigned to sent message
      * @param topic Topic name
      * @param target Target message address prefix. Has a limit on length. Recommend to use `Utils.Pss.makeMaxTarget()` to get the most specific target that Bee node will accept.
      * @param data Message to be sent
      * @param recipient Recipient public key
-     * @param options Options that affects the request behavior
-     * @throws TypeError if `data`, `batchId`, `target` or `recipient` are in invalid format
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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: BatchId | Uint8Array | string, topic: Topic, target: string, 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, requestOptions?: BeeRequestOptions): Promise<void>;
     /**
-     * Subscribe to messages for given topic with Postal Service for Swarm
+     * Subscribes to messages for given topic with the Postal Service for Swarm.
      *
-     * **Warning! If connected Bee node is a light node, then he will never receive any message!**
-     * This is because light nodes does not fully participate in the data exchange in Swarm network and hence the message won't arrive to them.
+     * **Warning! Only full nodes can accept PSS messages.**
      *
      * @param topic Topic name
      * @param handler Message handler interface
@@ -400,20 +481,14 @@ export declare class Bee {
      */
     pssSubscribe(topic: Topic, handler: PssMessageHandler): PssSubscription;
     /**
-     * Receive message with Postal Service for Swarm
-     *
-     * Because sending a PSS message is slow and CPU intensive,
-     * it is not supposed to be used for general messaging but
-     * most likely for setting up an encrypted communication
-     * channel by sending an one-off message.
+     * Receives message using the Postal Service for Swarm.
      *
      * This is a helper function to wait for exactly one message to
      * arrive and then cancel the subscription. Additionally a
      * timeout can be provided for the message to arrive or else
      * an error will be thrown.
      *
-     * **Warning! If connected Bee node is a light node, then he will never receive any message!**
-     * This is because light nodes does not fully participate in the data exchange in Swarm network and hence the message won't arrive to them.
+     * **Warning! Only full nodes can accept PSS messages.**
      *
      * @param topic Topic name
      * @param timeoutMsec Timeout in milliseconds
@@ -424,412 +499,789 @@ export declare class Bee {
      * @see [Bee API reference - `GET /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1{topic}/get)
      */
     pssReceive(topic: Topic, timeoutMsec?: number): Promise<Bytes>;
+    /**
+     * Mines the signer (a private key) to be used to send GSOC messages to the specific target overlay address.
+     *
+     * Use {@link gsocSend} to send GSOC messages with the mined signer.
+     *
+     * Use {@link gsocSubscribe} to subscribe to GSOC messages for the specified owner (of the signer) and identifier.
+     *
+     * See {@link gsocSend} or {@link gsocSubscribe} for concrete examples of usage.
+     *
+     * **Warning! Only full nodes can accept GSOC messages.**
+     *
+     * @param targetOverlay
+     * @param identifier
+     * @param proximity
+     * @returns
+     */
     gsocMine(targetOverlay: PeerAddress | Uint8Array | string, identifier: Identifier | Uint8Array | string, proximity?: number): PrivateKey;
+    /**
+     * Sends a GSOC message with the specified signer and identifier.
+     *
+     * Use {@link gsocMine} to mine a signer for the target overlay address.
+     *
+     * Use {@link gsocSubscribe} to subscribe to GSOC messages for the specified owner (of the signer) and identifier.
+     *
+     * **Warning! Only full nodes can accept GSOC messages.**
+     *
+     * @param postageBatchId
+     * @param signer
+     * @param identifier
+     * @param data
+     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     *
+     * @example
+     * const identifier = NULL_IDENTIFIER
+     * const overlay = '0x1234567890123456789012345678901234567890'
+     * const signer = bee.gsocMine(overlay, identifier)
+     * await bee.gsocSend(postageBatchId, signer, identifier, 'GSOC!')
+     */
     gsocSend(postageBatchId: BatchId | Uint8Array | string, signer: PrivateKey | Uint8Array | string, identifier: Identifier | Uint8Array | string, data: string | Uint8Array, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    /**
+     * Subscribes to GSOC messages for the specified owner (of the signer) and identifier.
+     *
+     * Use {@link gsocMine} to mine a signer for the target overlay address.
+     *
+     * Use {@link gsocSend} to send GSOC messages with the mined signer.
+     *
+     * **Warning! Only full nodes can accept GSOC messages.**
+     *
+     * @param address
+     * @param identifier
+     * @param handler
+     * @returns
+     *
+     * @example
+     * const identifier = NULL_IDENTIFIER
+     * const { overlay } = await bee.getNodeAddresses()
+     * const signer = bee.gsocMine(overlay, identifier)
+     *
+     * const subscription = bee.gsocSubscribe(signer.publicKey().address(), identifier, {
+     *   onMessage(message) {
+     *     // handle
+     *   },
+     *   onError(error) {
+     *     // handle
+     *   },
+     *   onClose() {
+     *     // handle
+     *   }
+     * })
+     */
     gsocSubscribe(address: EthAddress | Uint8Array | string, identifier: Identifier | Uint8Array | string, handler: GsocMessageHandler): GsocSubscription;
     /**
-     * Create feed manifest chunk and return the reference to it.
+     * Creates a feed manifest chunk and returns the reference to it.
      *
-     * Feed manifest chunk allows for a feed to be able to be resolved through `/bzz` endpoint.
+     * Feed manifest chunks allow 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 topic           Topic in hex or bytes
      * @param owner           Owner's ethereum address in hex or bytes
      * @param options Options that affects the request behavior
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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(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.
+     * Makes a new feed reader for downloading feed updates.
      *
      * @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
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
      */
-    makeFeedReader(topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, options?: BeeRequestOptions): FeedReader;
+    makeFeedReader(topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, requestOptions?: BeeRequestOptions): FeedReader;
     /**
-     * Make a new feed writer for updating feeds
+     * Makes a new feed writer for updating feeds
      *
      * @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
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
      */
-    makeFeedWriter(topic: Topic | Uint8Array | string, signer?: PrivateKey | Uint8Array | string, options?: BeeRequestOptions): FeedWriter;
+    makeFeedWriter(topic: Topic | Uint8Array | string, signer?: PrivateKey | Uint8Array | string, requestOptions?: BeeRequestOptions): FeedWriter;
     fetchLatestFeedUpdate(topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<FeedPayloadResult>;
     /**
      * Returns an object for reading single owner chunks
      *
      * @param ownerAddress The ethereum address of the owner
-     * @param options Options that affects the request behavior
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      * @see [Bee docs - Chunk Types](https://docs.ethswarm.org/docs/develop/tools-and-features/chunk-types#single-owner-chunks)
      */
-    makeSOCReader(ownerAddress: EthAddress | Uint8Array | string, options?: BeeRequestOptions): SOCReader;
+    makeSOCReader(ownerAddress: EthAddress | Uint8Array | string, requestOptions?: BeeRequestOptions): SOCReader;
     /**
      * Returns an object for reading and writing single owner chunks
      *
      * @param signer The signer's private key or a Signer instance that can sign data
-     * @param options Options that affects the request behavior
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      * @see [Bee docs - Chunk Types](https://docs.ethswarm.org/docs/develop/tools-and-features/chunk-types#single-owner-chunks)
      */
-    makeSOCWriter(signer?: PrivateKey | Uint8Array | string, options?: BeeRequestOptions): SOCWriter;
-    createEnvelope(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<EnvelopeWithBatchId>;
+    makeSOCWriter(signer?: PrivateKey | Uint8Array | string, requestOptions?: BeeRequestOptions): SOCWriter;
     /**
-     * Get reserve commitment hash duration seconds
+     * Creates the postage batch signature for a specific chunk address.
+     *
+     * This is for advanced usage, where a pre-signed chunk can be uploaded
+     * through a different Bee node.
+     *
+     * @param postageBatchId
+     * @param reference
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
+     * @example
+     * const envelope = await bee.createEnvelope(batchId, chunk.address)
+     * await bee.uploadChunk(envelope, chunk)
+     *
+     * @returns
      */
-    rchash(depth: number, anchor1: string, anchor2: string, options?: BeeRequestOptions): Promise<number>;
+    createEnvelope(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<EnvelopeWithBatchId>;
     /**
-     * Ping the Bee node to see if there is a live Bee node on the given URL.
+     * Gets reserve commitment hash duration seconds.
      *
-     * @param options Options that affects the request behavior
+     * To be able to participe in the storage incentives and not get frozen, this should
+     * ideally run under 5 minutes.
+     *
+     * This is a CPU intensice operation, as roughly 2^22 chunks are hashed in the process.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
+     * @example
+     * const addresses = await bee.getNodeAddresses()
+     * const topology = await bee.getTopology()
+     * const result = await bee.rchash(topology.depth, addresses.overlay.toHex(), addresses.overlay.toHex())
+     * // result is a number of seconds
+     */
+    rchash(depth: number, anchor1: string, anchor2: string, requestOptions?: BeeRequestOptions): Promise<number>;
+    /**
+     * Pings the Bee node to see if there is a live Bee node on the given URL.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      * @throws If connection was not successful throw error
      */
-    checkConnection(options?: BeeRequestOptions): Promise<void> | never;
+    checkConnection(requestOptions?: BeeRequestOptions): Promise<void> | never;
     /**
-     * Ping the Bee node to see if there is a live Bee node on the given URL.
+     * Pings the Bee node to see if there is a live Bee node on the given URL.
      *
-     * @param options Options that affects the request behavior
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      * @returns true if successful, false on error
      */
-    isConnected(options?: BeeRequestOptions): Promise<boolean>;
+    isConnected(requestOptions?: BeeRequestOptions): Promise<boolean>;
     /**
      * Checks the `/gateway` endpoint to see if the remote API is a gateway.
      *
      * Do note that this is not a standard way to check for gateway nodes,
      * but some of the gateway tooling expose this endpoint.
      *
-     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    isGateway(options?: BeeRequestOptions): Promise<boolean>;
-    getNodeAddresses(options?: BeeRequestOptions): Promise<NodeAddresses>;
-    getBlocklist(options?: BeeRequestOptions): Promise<Peer[]>;
+    isGateway(requestOptions?: BeeRequestOptions): Promise<boolean>;
     /**
-     * Get list of peers for this node
+     * Fetches the overlay, underlay, Ethereum, and other addresses of the Bee node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     */
+    getNodeAddresses(requestOptions?: BeeRequestOptions): Promise<NodeAddresses>;
+    /**
+     * Fetches the list of blocked peers for this node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     */
+    getBlocklist(requestOptions?: BeeRequestOptions): Promise<Peer[]>;
+    /**
+     * Gets list of peers for this node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     */
+    getPeers(requestOptions?: BeeRequestOptions): Promise<Peer[]>;
+    /**
+     * Disconnects from a specific peer.
+     *
+     * @param peer Overlay address of the peer to be removed.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     */
+    removePeer(peer: PeerAddress | string, requestOptions?: BeeRequestOptions): Promise<RemovePeerResponse>;
+    /**
+     * Fetches topology and connectivity information of the Bee node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
      */
-    getPeers(options?: BeeRequestOptions): Promise<Peer[]>;
-    removePeer(peer: PeerAddress | string, options?: BeeRequestOptions): Promise<RemovePeerResponse>;
-    getTopology(options?: BeeRequestOptions): Promise<Topology>;
-    pingPeer(peer: PeerAddress | string, options?: BeeRequestOptions): Promise<PingResponse>;
+    getTopology(requestOptions?: BeeRequestOptions): Promise<Topology>;
     /**
-     * Get the balances with all known peers including prepaid services
+     * Pings a specific peer to check its availability.
+     *
+     * @param peer Overlay address of the peer to be pinged.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
      */
-    getAllBalances(options?: BeeRequestOptions): Promise<BalanceResponse>;
+    pingPeer(peer: PeerAddress | string, requestOptions?: BeeRequestOptions): Promise<PingResponse>;
     /**
-     * Get the balances with a specific peer including prepaid services
+     * Gets the SWAP balances with all known peers including prepaid services.
+     *
+     * This is related to the bandwidth incentives and the chequebook.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     */
+    getAllBalances(requestOptions?: BeeRequestOptions): Promise<BalanceResponse>;
+    /**
+     * Gets the SWAP balances for a specific peer including prepaid services.
      *
      * @param address Swarm address of peer
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getPeerBalance(address: PeerAddress | string, options?: BeeRequestOptions): Promise<PeerBalance>;
+    getPeerBalance(address: PeerAddress | string, requestOptions?: BeeRequestOptions): Promise<PeerBalance>;
     /**
-     * Get the past due consumption balances with all known peers
+     * Gets the past due consumption balances for all known peers.
+     *
+     * This is related to the bandwidth incentives and the chequebook.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getPastDueConsumptionBalances(options?: BeeRequestOptions): Promise<BalanceResponse>;
+    getPastDueConsumptionBalances(requestOptions?: BeeRequestOptions): Promise<BalanceResponse>;
     /**
-     * Get the past due consumption balance with a specific peer
+     * Gets the past due consumption balance for a specific peer.
+     *
+     * This is related to the bandwidth incentives and the chequebook.
      *
      * @param address Swarm address of peer
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getPastDueConsumptionPeerBalance(address: PeerAddress | string, options?: BeeRequestOptions): Promise<PeerBalance>;
+    getPastDueConsumptionPeerBalance(address: PeerAddress | string, requestOptions?: BeeRequestOptions): Promise<PeerBalance>;
     /**
-     * Get the address of the chequebook contract used.
+     * Gets the address of the deloyed chequebook.
      *
-     * **Warning:** The address is returned with 0x prefix unlike all other calls.
-     * https://github.com/ethersphere/bee/issues/1443
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getChequebookAddress(options?: BeeRequestOptions): Promise<ChequebookAddressResponse>;
+    getChequebookAddress(requestOptions?: BeeRequestOptions): Promise<ChequebookAddressResponse>;
     /**
-     * Get the balance of the chequebook
+     * Gets the balance of the chequebook.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getChequebookBalance(options?: BeeRequestOptions): Promise<ChequebookBalanceResponse>;
+    getChequebookBalance(requestOptions?: BeeRequestOptions): Promise<ChequebookBalanceResponse>;
     /**
-     * Get last cheques for all peers
+     * Gets the last cheques for all peers.
+     *
+     * This is related to the bandwidth incentives and the chequebook.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getLastCheques(options?: BeeRequestOptions): Promise<LastChequesResponse>;
+    getLastCheques(requestOptions?: BeeRequestOptions): Promise<LastChequesResponse>;
     /**
-     * Get last cheques for the peer
+     * Gets the last cheques for a specific peer.
      *
-     * @param address  Swarm address of peer
+     * This is related to the bandwidth incentives and the chequebook.
+     *
+     * @param address Overlay address of peer.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getLastChequesForPeer(address: PeerAddress | string, options?: BeeRequestOptions): Promise<LastChequesForPeerResponse>;
+    getLastChequesForPeer(address: PeerAddress | string, requestOptions?: BeeRequestOptions): Promise<LastChequesForPeerResponse>;
     /**
-     * Get last cashout action for the peer
+     * Gets the last cashout action for a specific peer.
      *
-     * @param address  Swarm address of peer
+     * This is related to the bandwidth incentives and the chequebook.
+     *
+     * @param address Overlay address of peer.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getLastCashoutAction(address: PeerAddress | string, options?: BeeRequestOptions): Promise<LastCashoutActionResponse>;
+    getLastCashoutAction(address: PeerAddress | string, requestOptions?: BeeRequestOptions): Promise<LastCashoutActionResponse>;
     /**
-     * Cashout the last cheque for the peer
+     * Cashes out the last cheque for a specific peer.
+     *
+     * This is related to the bandwidth incentives and the chequebook.
      *
      * @param address  Swarm address of peer
      * @param options
      * @param options.gasPrice Gas price for the cashout transaction in WEI
      * @param options.gasLimit Gas limit for the cashout transaction in WEI
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
     cashoutLastCheque(address: PeerAddress | string, options?: TransactionOptions, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Deposit tokens from node wallet into chequebook
+     * Deposits tokens from the node wallet into the chequebook.
      *
      * @param amount  Amount of tokens to deposit (must be positive integer)
      * @param gasPrice Gas Price in WEI for the transaction call
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
      * @return string  Hash of the transaction
      * @deprecated Use `depositBZZToChequebook` instead.
      */
-    depositTokens(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
+    depositTokens(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Deposit tokens from node wallet into chequebook
+     * Deposits tokens from the node wallet into the chequebook.
      *
      * @param amount  Amount of tokens to deposit (must be positive integer)
      * @param gasPrice Gas Price in WEI for the transaction call
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
      * @return string  Hash of the transaction
      */
-    depositBZZToChequebook(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
+    depositBZZToChequebook(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Withdraw tokens from the chequebook to the node wallet
+     * Withdraws tokens from the chequebook to the node wallet.
      *
      * @param amount  Amount of tokens to withdraw (must be positive integer)
      * @param gasPrice Gas Price in WEI for the transaction call
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
      * @return string  Hash of the transaction
      * @deprecated Use `withdrawBZZFromChequebook` instead.
      */
-    withdrawTokens(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
+    withdrawTokens(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Withdraw tokens from the chequebook to the node wallet
+     * Withdraws tokens from the chequebook to the node wallet.
      *
-     * @param amount  Amount of tokens to withdraw (must be positive integer)
-     * @param gasPrice Gas Price in WEI for the transaction call
-     * @return string  Hash of the transaction
+     * @param amount Amount of BZZ tokens to withdraw. If not providing a `BZZ` instance, the amount is denoted in PLUR.
+     * @param gasPrice Gas Price in WEI for the transaction call.
+     * @return Transaction ID
+     */
+    withdrawBZZFromChequebook(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
+    /**
+     * Withdraws BZZ from the node wallet (not chequebook) to a whitelisted external wallet address.
+     *
+     * @param amount Amount of BZZ tokens to withdraw. If not providing a `BZZ` instance, the amount is denoted in PLUR.
+     * @param address
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @return Transaction ID
+     */
+    withdrawBZZToExternalWallet(amount: BZZ | NumberString | string | bigint, address: EthAddress | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
+    /**
+     * Withdraws DAI from the node wallet (not chequebook) to a whitelisted external wallet address.
+     *
+     * @param amount Amount of DAI tokens to withdraw. If not providing a `DAI` instance, the amount is denoted in wei.
+     * @param address
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @return Transaction ID
      */
-    withdrawBZZFromChequebook(amount: BZZ | NumberString | string | bigint, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
-    withdrawBZZToExternalWallet(amount: BZZ | NumberString | string | bigint, address: EthAddress | Uint8Array | string, options?: BeeRequestOptions): Promise<TransactionId>;
-    withdrawDAIToExternalWallet(amount: DAI | NumberString | string | bigint, address: EthAddress | Uint8Array | string, options?: BeeRequestOptions): Promise<TransactionId>;
+    withdrawDAIToExternalWallet(amount: DAI | NumberString | string | bigint, address: EthAddress | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Get amount of sent and received from settlements with a peer
+     * Gets the amount of sent and received micropayments from settlements with a peer.
+     *
+     * This is related to the bandwidth incentives and the chequebook.
      *
      * @param address  Swarm address of peer
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getSettlements(address: PeerAddress | string, options?: BeeRequestOptions): Promise<Settlements>;
+    getSettlements(address: PeerAddress | string, requestOptions?: BeeRequestOptions): Promise<Settlements>;
     /**
-     * Get settlements with all known peers and total amount sent or received
+     * Gets settlements with all known peers and total amount sent or received.
+     *
+     * This is related to the bandwidth incentives and the chequebook.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getAllSettlements(options?: BeeRequestOptions): Promise<AllSettlements>;
+    getAllSettlements(requestOptions?: BeeRequestOptions): Promise<AllSettlements>;
     /**
-     * Get status of node
+     * Gets the general status of the node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getStatus(options?: BeeRequestOptions): Promise<DebugStatus>;
+    getStatus(requestOptions?: BeeRequestOptions): Promise<DebugStatus>;
     /**
-     * Get health of node
+     * Gets the health of the node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getHealth(options?: BeeRequestOptions): Promise<Health>;
+    getHealth(requestOptions?: BeeRequestOptions): Promise<Health>;
     /**
-     * Get readiness of node
+     * Gets the readiness status of the node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getReadiness(options?: BeeRequestOptions): Promise<Readiness>;
+    getReadiness(requestOptions?: BeeRequestOptions): Promise<Readiness>;
     /**
-     * Get mode information of node
+     * Get mode information of node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getNodeInfo(options?: BeeRequestOptions): Promise<NodeInfo>;
+    getNodeInfo(requestOptions?: BeeRequestOptions): Promise<NodeInfo>;
     /**
      * Connects to a node and checks if its version matches with the one that bee-js supports.
      *
-     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    isSupportedExactVersion(options?: BeeRequestOptions): Promise<boolean> | never;
+    isSupportedExactVersion(requestOptions?: BeeRequestOptions): Promise<boolean> | never;
     /**
      *
      * Connects to a node and checks if its Main API version matches with the one that bee-js supports.
      *
      * This should be the main way how to check compatibility for your app and Bee node.
      *
-     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    isSupportedApiVersion(options?: BeeRequestOptions): Promise<boolean> | never;
+    isSupportedApiVersion(requestOptions?: BeeRequestOptions): Promise<boolean> | never;
     /**
      * Returns object with all versions specified by the connected Bee node (properties prefixed with `bee*`)
      * and versions that bee-js supports (properties prefixed with `supported*`).
      *
-     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getVersions(options?: BeeRequestOptions): Promise<BeeVersions> | never;
+    getVersions(requestOptions?: BeeRequestOptions): Promise<BeeVersions> | never;
     /**
-     * Get reserve state
+     * Get reserve state.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getReserveState(options?: BeeRequestOptions): Promise<ReserveState>;
+    getReserveState(requestOptions?: BeeRequestOptions): Promise<ReserveState>;
     /**
-     * Get chain state
+     * Gets chain state.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getChainState(options?: BeeRequestOptions): Promise<ChainState>;
+    getChainState(requestOptions?: BeeRequestOptions): Promise<ChainState>;
     /**
-     * Get wallet balances for DAI and BZZ of the Bee node
+     * Gets DAI and BZZ balances of the Bee node wallet.
      *
-     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getWalletBalance(options?: BeeRequestOptions): Promise<WalletBalance>;
+    getWalletBalance(requestOptions?: BeeRequestOptions): Promise<WalletBalance>;
     /**
-     * Creates new postage batch from the funds that the node has available in its Ethereum account.
+     * Creates a new postage batch, spending BZZ tokens from the node wallet.
      *
-     * 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).
+     * Use {@link buyStorage} for a more convenient way to create postage batch.
      *
-     * **WARNING: THIS CREATES TRANSACTIONS THAT SPENDS MONEY**
+     * For better understanding what each parameter means and what the optimal values are, see
+     * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction#keep-your-data-alive).
      *
-     * @param amount Amount that represents the value per chunk, has to be greater or equal zero.
-     * @param depth Logarithm of the number of chunks that can be stamped with the batch.
+     * @param amount TTL parameter - 1 day at the minimum of 24,000 storage price requires an amount of 414,720,000.
+     * @param depth Capacity parameter - 17..255 - depth 17 provides 512MB of theoretical capacity, 18 provides 1GB, 19 provides 2GB, etc.
      * @param options Options for creation of postage batch
-     * @throws BeeArgumentError when negative amount or depth is specified
-     * @throws TypeError if non-integer value is passed to amount or depth
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Postage-Stamps/paths/~1stamps~1{amount}~1{depth}/post)
      */
     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.
+     * A more convenient method to create a postage batch, which is analogous
+     * to buying storage for a certain size and duration on the Swarm network.
+     *
+     * Use {@link getStorageCost} to calculate the cost of creating a postage batch.
+     *
+     * For the low level API, use {@link createPostageBatch}.
+     *
+     * @example const batchId = await bee.buyStorage(Size.fromGigabytes(8), Duration.fromDays(31))
+  
+     * @param size
+     * @param duration
+     * @param options
+     * @param requestOptions
+     * @param encryption
+     * @param erasureCodeLevel
+     * @returns
+     */
+    buyStorage(size: Size, duration: Duration, options?: PostageBatchOptions, requestOptions?: BeeRequestOptions, encryption?: boolean, erasureCodeLevel?: RedundancyLevel): Promise<BatchId>;
+    /**
+     * Calculates the estimated BZZ cost for creating a postage batch for the given size and duration.
+     *
+     * Use {@link buyStorage} to create a postage batch with the calculated cost.
+     *
+     * @example const bzz = await bee.getStorageCost(Size.fromGigabytes(1), Duration.fromDays(30))
+     *
+     * @param size Size of the data to be stored.
+     * @param duration Duration for which the data should be stored.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @param encryption Assume the future uploaded data is encrypted, which skews the capacity of the postage batch.
+     * @param erasureCodeLevel Assume the future uploaded data is erasure coded, which skews the capacity of the postage batch.
+     * @returns
+     */
+    getStorageCost(size: Size, duration: Duration, requestOptions?: BeeRequestOptions, encryption?: boolean, erasureCodeLevel?: RedundancyLevel): Promise<BZZ>;
+    /**
+     * Extends the storage of a postage batch by either increasing its size, duration or both.
+     *
+     * The size is ABSOLUTE, while the duration is RELATIVE to the current duration of the postage batch.
+     *
+     * Use {@link getExtensionCost} to calculate the cost of extending the storage.
+     *
+     * @example
+     * // Increases the size to 8GB (unless it is already at 8GB or higher)
+     * // and extends the duration by 30 days (regardless of the current duration).
+     * await bee.extendStorage(batchId, Size.fromGigabytes(8), Duration.fromDays(30))
+     *
+     * @example
+     * // To increase the duration to a desired date, pass a second parameter to `Duration.fromEndDate`.
+     * // With the second parameter, the duration is set to the difference between the current end date and the desired end date.
+     * const oneMonth = new Date(Date.now() + Dates.days(31))
+     * const batch = await bee.getPostageBatch(batchId)
+     * await bee.extendStorage(batchId, Size.fromGigabytes(8), Duration.fromEndDate(oneMonth, batch.duration.toEndDate()))
+     *
+     * @param postageBatchId Batch ID of the postage batch to extend.
+     * @param size Absolute size to extend the postage batch to.
+     * @param duration Relative duration to extend the postage batch by.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @param encryption Assume the future uploaded data is encrypted, which skews the capacity of the postage batch.
+     * @param erasureCodeLevel Assume the future uploaded data is erasure coded, which skews the capacity of the postage batch.
+     * @returns
+     */
+    extendStorage(postageBatchId: BatchId | Uint8Array | string, size: Size, duration: Duration, requestOptions?: BeeRequestOptions, encryption?: boolean, erasureCodeLevel?: RedundancyLevel): Promise<BatchId>;
+    /**
+     * Extends the storage size of a postage batch by increasing its depth.
+     *
+     * Use {@link getSizeExtensionCost} to calculate the cost of extending the size.
+     * Use {@link extendStorage} to extend both size and duration.
+     *
+     * @param postageBatchId
+     * @param size Absolute size to extend the postage batch to.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @param encryption Assume the future uploaded data is encrypted, which skews the capacity of the postage batch.
+     * @param erasureCodeLevel Assume the future uploaded data is erasure coded, which skews the capacity of the postage batch.
+     * @returns
+     */
+    extendStorageSize(postageBatchId: BatchId | Uint8Array | string, size: Size, requestOptions?: BeeRequestOptions, encryption?: boolean, erasureCodeLevel?: RedundancyLevel): Promise<BatchId>;
+    /**
+     * Extends the duration of a postage batch.
+     *
+     * Use {@link getDurationExtensionCost} to calculate the cost of extending the duration.
+     * Use {@link extendStorage} to extend both size and duration.
+     *
+     * @param postageBatchId
+     * @param duration Relative duration to extend the postage batch by.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     */
+    extendStorageDuration(postageBatchId: BatchId | Uint8Array | string, duration: Duration, requestOptions?: BeeRequestOptions): Promise<BatchId>;
+    /**
+     * Calculates the cost of extending both the duration and the capacity of a postage batch.
+     *
+     * The size is ABSOLUTE, while the duration is RELATIVE to the current duration of the postage batch.
+     *
+     * Use {@link extendStorage} to extend the the duration and capacity of a postage batch.
+     *
+     * @param postageBatchId
+     * @param size Absolute size to extend the postage batch to.
+     * @param duration Relative duration to extend the postage batch by.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @param encryption Assume the future uploaded data is encrypted, which skews the capacity of the postage batch.
+     * @param erasureCodeLevel Assume the future uploaded data is erasure coded, which skews the capacity of the postage batch.
+     * @returns
+     */
+    getExtensionCost(postageBatchId: BatchId | Uint8Array | string, size: Size, duration: Duration, requestOptions?: BeeRequestOptions, encryption?: boolean, erasureCodeLevel?: RedundancyLevel): Promise<BZZ>;
+    /**
+     * Calculates the cost of extending the size of a postage batch.
+     *
+     * The size is ABSOLUTE, so if the postage batch already equals or is greater than the given size,
+     * the cost will be zero.
+     *
+     * Use {@link extendStorageSize} to extend the size of a postage batch.
+     *
+     * Use {@link getExtensionCost} to get the cost of extending both size and duration.
+     * Use {@link getDurationExtensionCost} to get the cost of extending only the duration.
+     *
+     * @param postageBatchId
+     * @param size
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @param encryption Assume the future uploaded data is encrypted, which skews the capacity of the postage batch.
+     * @param erasureCodeLevel Assume the future uploaded data is erasure coded, which skews the capacity of the postage batch.
+     * @returns
+     */
+    getSizeExtensionCost(postageBatchId: BatchId | Uint8Array | string, size: Size, requestOptions?: BeeRequestOptions, encryption?: boolean, erasureCodeLevel?: RedundancyLevel): Promise<BZZ>;
+    /**
+     * Calculates the cost of extending the duration of a postage batch.
+     *
+     * The duration is RELATIVE to the current duration of the postage batch,
+     * e.g. specifying `Duration.fromDays(30)` will extend the current duration by 30 days,
+     * regardless of the current duration.
+     *
+     * Use {@link extendStorageDuration} to extend the duration of a postage batch.
+     *
+     * Use {@link getExtensionCost} to get the cost of extending both size and duration.
+     * Use {@link getSizeExtensionCost} to get the cost of extending only the size.
+     *
+     * @param postageBatchId
+     * @param duration
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns
+     */
+    getDurationExtensionCost(postageBatchId: BatchId | Uint8Array | string, duration: Duration, requestOptions?: BeeRequestOptions): Promise<BZZ>;
+    /**
+     * Increases the duration of a postage batch by increasing its amount.
+     *
+     * For a more convenient way to extend the postage batch, refer to the methods below.
+     *
+     * Use {@link getDurationExtensionCost}, {@link getSizeExtensionCost} or {@link getExtensionCost}
+     * to calculate the costs of extending the postage batch properties.
+     *
+     * Use {@link extendStorageDuration}, {@link extendStorageSize} or {@link extendStorage}
+     * to extend the postage batch properties.
      *
      * 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).
      *
      * @param postageBatchId Batch ID
      * @param amount Amount to be added to the batch
-     * @param options Request options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Postage-Stamps/paths/~1stamps~1topup~1{batch_id}~1{amount}/patch)
      */
-    topUpBatch(postageBatchId: BatchId | Uint8Array | string, amount: NumberString | string | bigint, options?: BeeRequestOptions): Promise<BatchId>;
+    topUpBatch(postageBatchId: BatchId | Uint8Array | string, amount: NumberString | string | bigint, requestOptions?: 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.
+     * Dilutes a postage batch to extend its capacity by increasing its depth.
+     *
+     * This is a free operation, as for every depth increase, the capacity is doubled,
+     * but the amount (duration) is halved.
+     *
+     * To increase the capacity of the postage batch while retaining the same amount (duration),
+     * you need to top up the postage batch first using {@link topUpBatch}.
+     *
+     * For a more convenient way to extend the postage batch, refer to the methods below.
+     *
+     * Use {@link getDurationExtensionCost}, {@link getSizeExtensionCost} or {@link getExtensionCost}
+     * to calculate the costs of extending the postage batch properties.
+     *
+     * Use {@link extendStorageDuration}, {@link extendStorageSize} or {@link extendStorage}
+     * to extend the postage batch properties.
      *
      * 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).
      *
      * @param postageBatchId Batch ID
      * @param depth Amount to be added to the batch
-     * @param options Request options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Postage-Stamps/paths/~1stamps~1dilute~1%7Bbatch_id%7D~1%7Bdepth%7D/patch)
      */
-    diluteBatch(postageBatchId: BatchId | Uint8Array | string, depth: number, options?: BeeRequestOptions): Promise<BatchId>;
+    diluteBatch(postageBatchId: BatchId | Uint8Array | string, depth: number, requestOptions?: BeeRequestOptions): Promise<BatchId>;
     /**
-     * Return details for specific postage batch.
+     * Returns details for specific postage batch.
      *
      * @param postageBatchId Batch ID
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Postage-Stamps/paths/~1stamps~1%7Bbatch_id%7D/get)
      */
-    getPostageBatch(postageBatchId: BatchId | Uint8Array | string, options?: BeeRequestOptions): Promise<PostageBatch>;
+    getPostageBatch(postageBatchId: BatchId | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<PostageBatch>;
     /**
      * Return detailed information related to buckets for specific postage batch.
      *
      * @param postageBatchId Batch ID
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Postage-Stamps/paths/~1stamps~1%7Bbatch_id%7D~1buckets/get)
      */
-    getPostageBatchBuckets(postageBatchId: BatchId | Uint8Array | string, options?: BeeRequestOptions): Promise<PostageBatchBuckets>;
+    getPostageBatchBuckets(postageBatchId: BatchId | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<PostageBatchBuckets>;
     /**
-     * Return all postage batches that has the node available.
+     * Returns all postage batches that belongs to the node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Postage-Stamps/paths/~1stamps/get)
      * @deprecated Use `getPostageBatches` instead
      */
-    getAllPostageBatch(options?: BeeRequestOptions): Promise<PostageBatch[]>;
+    getAllPostageBatch(requestOptions?: BeeRequestOptions): Promise<PostageBatch[]>;
     /**
-     * Return all globally available postage batches.
+     * Returns all postage batches that are globally available on the Swarm network.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     *
      * @deprecated Use `getGlobalPostageBatches` instead
      */
-    getAllGlobalPostageBatch(options?: BeeRequestOptions): Promise<GlobalPostageBatch[]>;
+    getAllGlobalPostageBatch(requestOptions?: BeeRequestOptions): Promise<GlobalPostageBatch[]>;
     /**
-     * Return all postage batches that belong to the node.
+     * Returns all postage batches that belong to the node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
      * @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/api/#tag/Postage-Stamps/paths/~1stamps/get)
      */
-    getPostageBatches(options?: BeeRequestOptions): Promise<PostageBatch[]>;
+    getPostageBatches(requestOptions?: BeeRequestOptions): Promise<PostageBatch[]>;
     /**
-     * Return all globally available postage batches.
+     * Returns all globally available postage batches.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getGlobalPostageBatches(options?: BeeRequestOptions): Promise<GlobalPostageBatch[]>;
+    getGlobalPostageBatches(requestOptions?: BeeRequestOptions): Promise<GlobalPostageBatch[]>;
     /**
-     * Return lists of all current pending transactions that the Bee made
+     * Fetches the list of all current pending transactions for the Bee node.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getAllPendingTransactions(options?: BeeRequestOptions): Promise<TransactionInfo[]>;
+    getAllPendingTransactions(requestOptions?: BeeRequestOptions): Promise<TransactionInfo[]>;
     /**
-     * Return transaction information for specific transaction
+     * Fetches the transaction information for a specific transaction.
+     *
      * @param transactionHash
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getPendingTransaction(transactionHash: TransactionId | Uint8Array | string, options?: BeeRequestOptions): Promise<TransactionInfo>;
+    getPendingTransaction(transactionHash: TransactionId | Uint8Array | string, requestOptions?: 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.
+     * Rebroadcasts already created transaction.
+     *
+     * This is mainly needed when the transaction falls off mempool or is not incorporated into any block.
      *
      * @param transactionHash
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    rebroadcastPendingTransaction(transactionHash: TransactionId | Uint8Array | string, options?: BeeRequestOptions): Promise<TransactionId>;
+    rebroadcastPendingTransaction(transactionHash: TransactionId | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Cancels a currently pending transaction
+     * Cancels a currently pending transaction.
+     *
      * @param transactionHash
      * @param gasPrice
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    cancelPendingTransaction(transactionHash: TransactionId | Uint8Array | string, gasPrice?: NumberString | string | bigint, options?: BeeRequestOptions): Promise<TransactionId>;
+    cancelPendingTransaction(transactionHash: TransactionId | Uint8Array | string, gasPrice?: NumberString | string | bigint, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Gets the amount of staked BZZ
+     * Gets the amount of staked BZZ.
      *
-     * @param options HTTP request options, such as `headers` or `timeout`
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getStake(options?: BeeRequestOptions): Promise<BZZ>;
+    getStake(requestOptions?: BeeRequestOptions): Promise<BZZ>;
     /**
      * Gets the amount of withdrawable staked BZZ.
      *
-     * @param options HTTP request options, such as `headers` or `timeout`
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    getWithdrawableStake(options?: BeeRequestOptions): Promise<BZZ>;
+    getWithdrawableStake(requestOptions?: BeeRequestOptions): Promise<BZZ>;
     /**
-     * Withdraws ALL surplus staked BZZ to the node wallet.
+     * Withdraws all surplus staked BZZ to the node wallet.
      *
-     * Use the `getWithdrawableStake` method to check how much surplus stake is available.
+     * Use the {@link getWithdrawableStake} method to check how much surplus stake is available.
      *
-     * @param options HTTP request options, such as `headers` or `timeout`
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    withdrawSurplusStake(options?: BeeRequestOptions): Promise<TransactionId>;
+    withdrawSurplusStake(requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Withdraws all staked BZZ to the node wallet.
      *
      * **Only available when the staking contract is paused and is in the process of being migrated to a new contract!**
      *
-     * @param options HTTP request options, such as `headers` or `timeout`
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
-    migrateStake(options?: BeeRequestOptions): Promise<TransactionId>;
+    migrateStake(requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Stakes the given amount of BZZ. Initial deposit must be at least 10 BZZ.
      *
      * Be aware that staked BZZ tokens can **not** be withdrawn.
      *
      * @param amount Amount of BZZ tokens to be staked. If not providing a `BZZ` instance, the amount is denoted in PLUR.
-     * @param options HTTP request options, such as `headers` or `timeout`
+     * @param options
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      */
     depositStake(amount: BZZ | NumberString | string | bigint, options?: TransactionOptions, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
-     * Gets current status of node in redistribution game
+     * Gets current status of node in redistribution game.
+     *
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      *
-     * @param options HTTP request options, such as `headers` or `timeout`
+     * @see [Bee API reference - `GET /redistributionstate`](https://docs.ethswarm.org/api/#tag/RedistributionState/paths/~1redistributionstate/get)
      */
-    getRedistributionState(options?: BeeRequestOptions): Promise<RedistributionState>;
+    getRedistributionState(requestOptions?: BeeRequestOptions): Promise<RedistributionState>;
     private waitForUsablePostageStamp;
-    protected getRequestOptionsForCall(options?: BeeRequestOptions): BeeRequestOptions;
+    protected getRequestOptionsForCall(requestOptions?: BeeRequestOptions): BeeRequestOptions;
 }