@ethersphere/bee-js 8.0.2 → 8.2.0

package/dist/mjs/bee.js

@@ -20,6 +20,7 @@ import * as states from "./modules/debug/states.js";
 import * as debugStatus from "./modules/debug/status.js";
 import * as debugTag from "./modules/debug/tag.js";
 import * as transactions from "./modules/debug/transactions.js";
+import { postEnvelope } from "./modules/envelope.js";
 import { createFeedManifest } from "./modules/feed.js";
 import * as grantee from "./modules/grantee.js";
 import * as pinning from "./modules/pinning.js";
@@ -78,9 +79,22 @@ export class Bee {
   async uploadData(postageBatchId, data, options, requestOptions) {
     assertBatchId(postageBatchId);
     assertData(data);
-    if (options) assertUploadOptions(options);
+    assertRequestOptions(requestOptions);
+    if (options) {
+      assertUploadOptions(options);
+    }
     return bytes.upload(this.getRequestOptionsForCall(requestOptions), data, postageBatchId, options);
   }
+  /**
+   * 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)
+   */
+  async probeData(reference, options) {
+    assertRequestOptions(options);
+    assertReferenceOrEns(reference);
+    return bytes.head(this.getRequestOptionsForCall(options), reference);
+  }
   /**
    * Download data as a byte array
    *
@@ -122,8 +136,8 @@ export 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)
    */
-  async uploadChunk(postageBatchId, data, options, requestOptions) {
-    assertBatchId(postageBatchId);
+  async uploadChunk(stamp, data, options, requestOptions) {
+    assertRequestOptions(requestOptions);
     if (!(data instanceof Uint8Array)) {
       throw new TypeError('Data has to be Uint8Array instance!');
     }
@@ -133,8 +147,10 @@ export class Bee {
     if (data.length > CHUNK_SIZE + SPAN_SIZE) {
       throw new BeeArgumentError(`Chunk has to have size of at most ${CHUNK_SIZE}.`, data);
     }
-    if (options) assertUploadOptions(options);
-    return chunk.upload(this.getRequestOptionsForCall(requestOptions), data, postageBatchId, options);
+    if (options) {
+      assertUploadOptions(options);
+    }
+    return chunk.upload(this.getRequestOptionsForCall(requestOptions), data, stamp, options);
   }
   /**
    * Download chunk as a byte array
@@ -162,6 +178,7 @@ export class Bee {
    * @returns A promise that resolves to a `GranteesResult` object.
    */
   async createGrantees(postageBatchId, grantees, requestOptions) {
+    assertRequestOptions(requestOptions);
     assertBatchId(postageBatchId);
     return grantee.createGrantees(this.getRequestOptionsForCall(requestOptions), postageBatchId, grantees);
   }
@@ -173,6 +190,7 @@ export class Bee {
    * @returns A promise that resolves to a `GetGranteesResult` object.
    */
   async getGrantees(reference, requestOptions) {
+    assertRequestOptions(requestOptions);
     return grantee.getGrantees(reference, this.getRequestOptionsForCall(requestOptions));
   }
   /**
@@ -186,6 +204,7 @@ export class Bee {
    * @returns A Promise that resolves to to a `GranteesResult` object.
    */
   async patchGrantees(postageBatchId, reference, history, grantees, requestOptions) {
+    assertRequestOptions(requestOptions);
     assertBatchId(postageBatchId);
     return grantee.patchGrantees(postageBatchId, reference, history, {
       add: grantees.add || [],
@@ -209,9 +228,12 @@ export class Bee {
    * @returns reference is a content hash of the file
    */
   async uploadFile(postageBatchId, data, name, options, requestOptions) {
+    assertRequestOptions(requestOptions);
     assertBatchId(postageBatchId);
     assertFileData(data);
-    if (options) assertFileUploadOptions(options);
+    if (options) {
+      assertFileUploadOptions(options);
+    }
     if (name && typeof name !== 'string') {
       throw new TypeError('name has to be string or undefined!');
     }
@@ -284,8 +306,11 @@ export class Bee {
    * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz/post)
    */
   async uploadFiles(postageBatchId, fileList, options, requestOptions) {
+    assertRequestOptions(requestOptions);
     assertBatchId(postageBatchId);
-    if (options) assertCollectionUploadOptions(options);
+    if (options) {
+      assertCollectionUploadOptions(options);
+    }
     const data = await makeCollectionFromFileList(fileList);
     return addCidConversionFunction(await bzz.uploadCollection(this.getRequestOptionsForCall(requestOptions), data, postageBatchId, options), ReferenceType.MANIFEST);
   }
@@ -299,11 +324,12 @@ export class Bee {
    * @param collection
    * @param options Collections and request options
    */
-  async uploadCollection(postageBatchId, collection, options) {
+  async uploadCollection(postageBatchId, collection, options, requestOptions) {
+    assertRequestOptions(requestOptions);
     assertBatchId(postageBatchId);
     assertCollection(collection);
     if (options) assertCollectionUploadOptions(options);
-    return addCidConversionFunction(await bzz.uploadCollection(this.requestOptions, collection, postageBatchId, options), ReferenceType.MANIFEST);
+    return addCidConversionFunction(await bzz.uploadCollection(this.getRequestOptionsForCall(this.requestOptions), collection, postageBatchId, options), ReferenceType.MANIFEST);
   }
   /**
    * Upload collection of files.
@@ -323,6 +349,7 @@ export class Bee {
    */
   async uploadFilesFromDirectory(postageBatchId, dir, options, requestOptions) {
     assertBatchId(postageBatchId);
+    assertRequestOptions(requestOptions);
     if (options) assertCollectionUploadOptions(options);
     const data = await makeCollectionFromFS(dir);
     return addCidConversionFunction(await bzz.uploadCollection(this.getRequestOptionsForCall(requestOptions), data, postageBatchId, options), ReferenceType.MANIFEST);
@@ -350,10 +377,10 @@ export class Bee {
    * @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)
    */
-  async getAllTags(options) {
-    assertRequestOptions(options);
+  async getAllTags(options, requestOptions) {
+    assertRequestOptions(requestOptions);
     assertAllTagsOptions(options);
-    return tag.getAllTags(this.getRequestOptionsForCall(options), options?.offset, options?.limit);
+    return tag.getAllTags(this.getRequestOptionsForCall(requestOptions), options?.offset, options?.limit);
   }
   /**
    * Retrieve tag information from Bee node
@@ -515,7 +542,7 @@ export class Bee {
         await this.makeFeedReader(type, canonicalTopic, canonicalOwner).download();
         return true;
       } catch (e) {
-        if (e?.response?.status === 404) {
+        if (e?.status === 404 || e?.status === 500) {
           return false;
         }
         throw e;
@@ -681,13 +708,12 @@ export 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)
    */
-  async createFeedManifest(postageBatchId, type, topic, owner, options) {
+  async createFeedManifest(stamp, type, topic, owner, options) {
     assertRequestOptions(options);
     assertFeedType(type);
-    assertBatchId(postageBatchId);
     const canonicalTopic = makeTopic(topic);
     const canonicalOwner = makeHexEthAddress(owner);
-    const reference = await createFeedManifest(this.getRequestOptionsForCall(options), canonicalOwner, canonicalTopic, postageBatchId);
+    const reference = await createFeedManifest(this.getRequestOptionsForCall(options), canonicalOwner, canonicalTopic, stamp);
     return addCidConversionFunction({
       reference
     }, ReferenceType.FEED);
@@ -745,7 +771,7 @@ export class Bee {
    * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
    */
   async setJsonFeed(postageBatchId, topic, data, options, requestOptions) {
-    assertRequestOptions(options, 'JsonFeedOptions');
+    assertRequestOptions(requestOptions, 'JsonFeedOptions');
     assertBatchId(postageBatchId);
     const hashedTopic = this.makeFeedTopic(topic);
     const feedType = options?.type ?? DEFAULT_FEED_TYPE;
@@ -771,8 +797,8 @@ export class Bee {
    *
    * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
    */
-  async getJsonFeed(topic, options) {
-    assertRequestOptions(options, 'JsonFeedOptions');
+  async getJsonFeed(topic, options, requestOptions) {
+    assertRequestOptions(requestOptions);
     const hashedTopic = this.makeFeedTopic(topic);
     const feedType = options?.type ?? DEFAULT_FEED_TYPE;
     if (options?.signer && options?.address) {
@@ -792,7 +818,7 @@ export class Bee {
         }
       }
     }
-    const reader = this.makeFeedReader(feedType, hashedTopic, address, options);
+    const reader = this.makeFeedReader(feedType, hashedTopic, address, requestOptions);
     return getJsonData(this, reader);
   }
   /**
@@ -836,6 +862,10 @@ export class Bee {
       upload: uploadSingleOwnerChunkData.bind(null, this.getRequestOptionsForCall(options), canonicalSigner)
     };
   }
+  async createEnvelope(postageBatchId, reference, options) {
+    assertRequestOptions(options);
+    return postEnvelope(this.getRequestOptionsForCall(options), postageBatchId, reference);
+  }
   /**
    * Ping the Bee node to see if there is a live Bee node on the given URL.
    *
@@ -1007,6 +1037,7 @@ export class Bee {
   async cashoutLastCheque(address, options, requestOptions) {
     assertCashoutOptions(options);
     assertAddress(address);
+    assertRequestOptions(requestOptions);
     return chequebook.cashoutLastCheque(this.getRequestOptionsForCall(requestOptions), address, options);
   }
   /**
@@ -1189,6 +1220,7 @@ export class Bee {
     assertPostageBatchOptions(options);
     assertPositiveInteger(amount);
     assertNonNegativeInteger(depth);
+    assertRequestOptions(requestOptions);
     if (depth < STAMPS_DEPTH_MIN) {
       throw new BeeArgumentError(`Depth has to be at least ${STAMPS_DEPTH_MIN}`, depth);
     }
@@ -1348,8 +1380,8 @@ export class Bee {
    * @param options
    */
   async depositStake(amount, options, requestOptions) {
-    assertRequestOptions(options);
     assertTransactionOptions(options);
+    assertRequestOptions(requestOptions);
     await stake.stake(this.getRequestOptionsForCall(requestOptions), amount, options);
   }
   /**
@@ -1386,7 +1418,7 @@ export class Bee {
     if (this.signer) {
       return this.signer;
     }
-    throw new BeeError('You have to pass Signer as property to either the method call or constructor! Non found.');
+    throw new TypeError('You have to pass Signer as property to either the method call or constructor! Non found.');
   }
   getRequestOptionsForCall(options) {
     return options ? Objects.deepMerge2(this.requestOptions, options) : this.requestOptions;

package/dist/mjs/chunk/soc.js

@@ -5,7 +5,6 @@ import { bytesAtOffset, bytesEqual, flexBytesAtOffset } from "../utils/bytes.js"
 import { BeeError } from "../utils/error.js";
 import { keccak256Hash } from "../utils/hash.js";
 import { bytesToHex } from "../utils/hex.js";
-import { assertAddress } from "../utils/type.js";
 import { bmtHash } from "./bmt.js";
 import { MAX_PAYLOAD_SIZE, MIN_PAYLOAD_SIZE, assertValidChunkData, makeContentAddressedChunk } from "./cac.js";
 import { recoverAddress, sign } from "./signer.js";
@@ -90,12 +89,12 @@ export async function makeSingleOwnerChunk(chunk, identifier, signer) {
  * @param postageBatchId  Postage BatchId that will be assigned to uploaded data
  * @param options         Upload options
  */
-export async function uploadSingleOwnerChunk(requestOptions, chunk, postageBatchId, options) {
+export async function uploadSingleOwnerChunk(requestOptions, chunk, stamp, options) {
   const owner = bytesToHex(chunk.owner());
   const identifier = bytesToHex(chunk.identifier());
   const signature = bytesToHex(chunk.signature());
   const data = Binary.concatBytes(chunk.span(), chunk.payload());
-  return socAPI.upload(requestOptions, owner, identifier, signature, data, postageBatchId, options);
+  return socAPI.upload(requestOptions, owner, identifier, signature, data, stamp, options);
 }
 /**
  * Helper function to create and upload SOC.
@@ -107,11 +106,10 @@ export async function uploadSingleOwnerChunk(requestOptions, chunk, postageBatch
  * @param data            The chunk data
  * @param options
  */
-export async function uploadSingleOwnerChunkData(requestOptions, signer, postageBatchId, identifier, data, options) {
-  assertAddress(postageBatchId);
+export async function uploadSingleOwnerChunkData(requestOptions, signer, stamp, identifier, data, options) {
   const cac = makeContentAddressedChunk(data);
   const soc = await makeSingleOwnerChunk(cac, identifier, signer);
-  return uploadSingleOwnerChunk(requestOptions, soc, postageBatchId, options);
+  return uploadSingleOwnerChunk(requestOptions, soc, stamp, options);
 }
 /**
  * Helper function to download SOC.

package/dist/mjs/feed/json.js

@@ -20,5 +20,7 @@ export async function setJsonData(bee, writer, postageBatchId, data, options, re
   const {
     reference
   } = await bee.uploadData(postageBatchId, serializedData, options, requestOptions);
-  return writer.upload(postageBatchId, reference);
+  return writer.upload(postageBatchId, reference, {
+    pin: options?.pin
+  });
 }

package/dist/mjs/feed/retrievable.js

@@ -26,7 +26,7 @@ async function isChunkRetrievable(bee, ref, requestOptions) {
     await bee.downloadChunk(ref, requestOptions);
     return true;
   } catch (e) {
-    if (e?.response?.status === 404) {
+    if (e?.status === 404 || e?.status === 500) {
       return false;
     }
     throw e;

package/dist/mjs/modules/bytes.js

@@ -28,6 +28,22 @@ export async function upload(requestOptions, data, postageBatchId, options) {
     historyAddress: response.headers['swarm-act-history-address'] || ''
   };
 }
+/**
+ * Requests content length for a reference
+ *
+ * @param requestOptions Options for making requests
+ * @param hash Bee content reference
+ */
+export async function head(requestOptions, hash) {
+  const response = await http(requestOptions, {
+    url: `${endpoint}/${hash}`,
+    method: 'head',
+    responseType: 'json'
+  });
+  return {
+    contentLength: parseInt(response.headers['content-length'])
+  };
+}
 /**
  * Download data as a byte array
  *

package/dist/mjs/modules/chunk.js

@@ -11,18 +11,18 @@ const endpoint = 'chunks';
  * Upload expects the chuck data to be set accordingly.
  *
  * @param requestOptions Options for making requests
- * @param data    Chunk data to be uploaded
- * @param postageBatchId  Postage BatchId that will be assigned to uploaded data
+ * @param data Chunk data to be uploaded
+ * @param stamp BatchId or marshaled stamp to be used for the upload
  * @param options Additional options like tag, encryption, pinning
  */
-export async function upload(requestOptions, data, postageBatchId, options) {
+export async function upload(requestOptions, data, stamp, options) {
   const response = await http(requestOptions, {
     method: 'post',
     url: `${endpoint}`,
     data,
     headers: {
       'content-type': 'application/octet-stream',
-      ...extractUploadHeaders(postageBatchId, options)
+      ...extractUploadHeaders(stamp, options)
     },
     responseType: 'json'
   });

package/dist/mjs/modules/debug/status.js

@@ -1,9 +1,8 @@
 import getMajorSemver from 'semver/functions/major.js';
 import { http } from "../../utils/http.js"; // Following lines bellow are automatically updated with GitHub Action when Bee version is updated
 // so if you are changing anything about them change the `update_bee` action accordingly!
-export const SUPPORTED_BEE_VERSION_EXACT = '1.18.2-759f56f';
-export const SUPPORTED_API_VERSION = '4.0.0';
-export const SUPPORTED_DEBUG_API_VERSION = '4.0.0';
+export const SUPPORTED_BEE_VERSION_EXACT = '2.2.0-06a0aca7';
+export const SUPPORTED_API_VERSION = '7.1.0';
 export const SUPPORTED_BEE_VERSION = SUPPORTED_BEE_VERSION_EXACT.split('-')[0];
 const NODE_INFO_URL = 'node';
 const STATUS_URL = 'status';

package/dist/mjs/modules/envelope.js

@@ -0,0 +1,33 @@
+import { Binary, Types } from 'cafe-utility';
+import { http } from "../utils/http.js";
+const ENVELOPE_ENDPOINT = 'envelope';
+export async function postEnvelope(requestOptions, postageBatchId, reference) {
+  const {
+    data
+  } = await http(requestOptions, {
+    method: 'post',
+    responseType: 'json',
+    url: `${ENVELOPE_ENDPOINT}/${reference}`,
+    headers: {
+      'swarm-postage-batch-id': postageBatchId
+    }
+  });
+  return {
+    issuer: Binary.hexToUint8Array(Types.asHexString(data.issuer, {
+      name: 'issuer',
+      byteLength: 20
+    })),
+    index: Binary.hexToUint8Array(Types.asHexString(data.index, {
+      name: 'index',
+      byteLength: 8
+    })),
+    timestamp: Binary.hexToUint8Array(Types.asHexString(data.timestamp, {
+      name: 'timestamp',
+      byteLength: 8
+    })),
+    signature: Binary.hexToUint8Array(Types.asHexString(data.signature, {
+      name: 'signature',
+      byteLength: 65
+    }))
+  };
+}

package/dist/mjs/modules/feed.js

@@ -11,12 +11,12 @@ const feedEndpoint = 'feeds';
  * @param postageBatchId  Postage BatchId to be used to create the Feed Manifest
  * @param options         Additional options, like type (default: 'sequence')
  */
-export async function createFeedManifest(requestOptions, owner, topic, postageBatchId) {
+export async function createFeedManifest(requestOptions, owner, topic, stamp) {
   const response = await http(requestOptions, {
     method: 'post',
     responseType: 'json',
     url: `${feedEndpoint}/${owner}/${topic}`,
-    headers: extractUploadHeaders(postageBatchId)
+    headers: extractUploadHeaders(stamp)
   });
   return response.data.reference;
 }

package/dist/mjs/modules/pinning.js

@@ -52,5 +52,5 @@ export async function getAllPins(requestOptions) {
     responseType: 'json',
     url: `${PINNING_ENDPOINT}`
   });
-  return response.data.references;
+  return response.data.references || [];
 }

package/dist/mjs/modules/soc.js

@@ -13,14 +13,14 @@ const socEndpoint = 'soc';
  * @param postageBatchId  Postage BatchId that will be assigned to uploaded data
  * @param options         Additional options like tag, encryption, pinning
  */
-export async function upload(requestOptions, owner, identifier, signature, data, postageBatchId, options) {
+export async function upload(requestOptions, owner, identifier, signature, data, stamp, options) {
   const response = await http(requestOptions, {
     method: 'post',
     url: `${socEndpoint}/${owner}/${identifier}`,
     data,
     headers: {
       'content-type': 'application/octet-stream',
-      ...extractUploadHeaders(postageBatchId, options)
+      ...extractUploadHeaders(stamp, options)
     },
     responseType: 'json',
     params: {

package/dist/mjs/utils/error.js

@@ -10,8 +10,11 @@ export class BeeArgumentError extends BeeError {
   }
 }
 export class BeeResponseError extends BeeError {
-  constructor(message, status, statusText) {
+  constructor(method, url, message, responseBody, status, statusText) {
     super(message);
+    this.method = method;
+    this.url = url;
+    this.responseBody = responseBody;
     this.status = status;
     this.statusText = statusText;
   }

package/dist/mjs/utils/expose.js

@@ -6,4 +6,6 @@ export { capitalizeAddressERC55, ethToSwarmAddress, fromLittleEndian, isHexEthAd
 export { keccak256Hash } from "./hash.js";
 export { makeMaxTarget } from "./pss.js";
 export { getAmountForTtl, getDepthForCapacity, getStampCostInBzz, getStampCostInPlur, getStampEffectiveBytes, getStampMaximumCapacityBytes, getStampTtlSeconds, getStampUsage } from "./stamps.js";
-export { approximateOverheadForRedundancyLevel, getRedundancyStat, getRedundancyStats } from "./redundancy.js";
+export { approximateOverheadForRedundancyLevel, getRedundancyStat, getRedundancyStats } from "./redundancy.js";
+export const NULL_STAMP = '0000000000000000000000000000000000000000000000000000000000000000';
+export const NULL_TOPIC = '0000000000000000000000000000000000000000000000000000000000000000';

package/dist/mjs/utils/file.js

@@ -5,8 +5,8 @@
  */
 export function isFile(file) {
   // browser
-  if (typeof File === 'function') {
-    return file instanceof File;
+  if (typeof File === 'function' && file instanceof File) {
+    return true;
   }
   // node.js
   const f = file;

package/dist/mjs/utils/headers.js

@@ -1,3 +1,4 @@
+import { Binary } from 'cafe-utility';
 import { BeeError } from "./error.js";
 /**
  * Read the filename from the content-disposition header
@@ -35,13 +36,16 @@ export function readFileHeaders(headers) {
     contentType
   };
 }
-export function extractUploadHeaders(postageBatchId, options) {
-  if (!postageBatchId) {
-    throw new BeeError('Postage BatchID has to be specified!');
+export function extractUploadHeaders(stamp, options) {
+  if (!stamp) {
+    throw new BeeError('Stamp has to be specified!');
+  }
+  const headers = {};
+  if (stamp instanceof Uint8Array) {
+    headers['swarm-postage-stamp'] = Binary.uint8ArrayToHex(stamp);
+  } else {
+    headers['swarm-postage-batch-id'] = stamp;
   }
-  const headers = {
-    'swarm-postage-batch-id': postageBatchId
-  };
   if (options?.act) {
     headers['swarm-act'] = String(options.act);
   }

package/dist/mjs/utils/http.js

@@ -32,7 +32,7 @@ export async function http(options, config) {
     return response;
   } catch (e) {
     if (e instanceof AxiosError) {
-      throw new BeeResponseError(e.message, e.status, e.code);
+      throw new BeeResponseError(config.method || 'get', config.url || '<unknown>', e.message, e.response?.data, e.response?.status, e.code);
     }
     throw e;
   }

package/dist/mjs/utils/stamps.js

@@ -1,3 +1,4 @@
+import { Binary } from 'cafe-utility';
 /**
  * Utility function that calculates usage of postage batch based on its utilization, depth and bucket depth.
  *
@@ -100,4 +101,22 @@ export function getAmountForTtl(days) {
  */
 export function getDepthForCapacity(gigabytes) {
   return gigabytes <= 1 ? 18 : Math.ceil(Math.log2(Math.ceil(gigabytes)) + 18);
+}
+export function convertEnvelopeToMarshaledStamp(batchID, envelope) {
+  return marshalStamp(envelope.signature, Binary.hexToUint8Array(batchID), envelope.timestamp, envelope.index);
+}
+export function marshalStamp(signature, batchID, timestamp, index) {
+  if (signature.length !== 65) {
+    throw Error('invalid signature length');
+  }
+  if (batchID.length !== 32) {
+    throw Error('invalid batch ID length');
+  }
+  if (timestamp.length !== 8) {
+    throw Error('invalid timestamp length');
+  }
+  if (index.length !== 8) {
+    throw Error('invalid index length');
+  }
+  return Binary.concatBytes(batchID, index, timestamp, signature);
 }

package/dist/mjs/utils/type.js

@@ -7,9 +7,6 @@ import { assertHexString, assertPrefixedHexString, isHexString } from "./hex.js"
 export function isReadable(obj) {
   return typeof Readable !== 'undefined' && obj instanceof Readable;
 }
-export function isUint8Array(obj) {
-  return obj instanceof Uint8Array;
-}
 export function isInteger(value) {
   return typeof value === 'string' && /^-?(0|[1-9][0-9]*)$/g.test(value) || typeof value === 'number' && value > Number.MIN_SAFE_INTEGER && value < Number.MAX_SAFE_INTEGER && Number.isInteger(value);
 }
@@ -151,9 +148,6 @@ export function assertRequestOptions(value, name = 'RequestOptions') {
     throw new TypeError(`${name} has to be an object!`);
   }
   const options = value;
-  if (options.retry) {
-    assertNonNegativeInteger(options.retry, `${name}.retry`);
-  }
   if (options.timeout) {
     assertNonNegativeInteger(options.timeout, `${name}.timeout`);
   }

package/dist/types/bee.d.ts

@@ -2,7 +2,7 @@
 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, 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, RemovePeerResponse, ReserveState, SOCReader, SOCWriter, Settlements, Signer, Tag, Topic, Topology, TransactionHash, TransactionInfo, UploadOptions, UploadRedundancyOptions, UploadResultWithCid, WalletBalance } from './types';
+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';
 /**
@@ -42,6 +42,12 @@ export declare class Bee {
      * @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>;
+    /**
+     * 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>;
     /**
      * Download data as a byte array
      *
@@ -75,7 +81,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(postageBatchId: string | BatchId, data: Uint8Array, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadChunk(stamp: BatchId | Uint8Array | string, data: Uint8Array, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Download chunk as a byte array
      *
@@ -190,7 +196,7 @@ export declare class Bee {
      * @param collection
      * @param options Collections and request options
      */
-    uploadCollection(postageBatchId: string | BatchId, collection: Collection, options?: CollectionUploadOptions & UploadRedundancyOptions): Promise<UploadResultWithCid>;
+    uploadCollection(postageBatchId: string | BatchId, collection: Collection, options?: CollectionUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResultWithCid>;
     /**
      * Upload collection of files.
      *
@@ -228,7 +234,7 @@ export declare class Bee {
      * @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): Promise<Tag[]>;
+    getAllTags(options?: AllTagsOptions, requestOptions?: BeeRequestOptions): Promise<Tag[]>;
     /**
      * Retrieve tag information from Bee node
      *
@@ -423,7 +429,7 @@ 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(postageBatchId: string | BatchId, type: FeedType, topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, options?: BeeRequestOptions): Promise<FeedManifestResult>;
+    createFeedManifest(stamp: BatchId | Uint8Array | string, type: FeedType, topic: Topic | Uint8Array | string, owner: EthAddress | Uint8Array | string, options?: BeeRequestOptions): Promise<FeedManifestResult>;
     /**
      * Make a new feed reader for downloading feed updates.
      *
@@ -464,7 +470,7 @@ export declare class Bee {
      *
      * @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, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    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().
@@ -484,7 +490,7 @@ export declare class Bee {
      *
      * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
      */
-    getJsonFeed<T extends AnyJson>(topic: string, options?: JsonFeedOptions): Promise<T>;
+    getJsonFeed<T extends AnyJson>(topic: string, options?: JsonFeedOptions, requestOptions?: BeeRequestOptions): Promise<T>;
     /**
      * Make a new feed topic from a string
      *
@@ -510,6 +516,7 @@ export declare class Bee {
      * @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>;
     /**
      * Ping the Bee node to see if there is a live Bee node on the given URL.
      *