@ethersphere/bee-js 3.3.4 → 4.1.0

package/README.md

@@ -1,7 +1,6 @@
 # Bee-js
 
 [![Tests](https://github.com/ethersphere/bee-js/actions/workflows/tests.yaml/badge.svg)](https://github.com/ethersphere/bee-js/actions/workflows/tests.yaml)
-[![Dependency Status](https://david-dm.org/ethersphere/bee-js.svg?style=flat-square)](https://david-dm.org/ethersphere/bee-js)
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fethersphere%2Fbee-js.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fethersphere%2Fbee-js?ref=badge_shield)
 [![](https://img.shields.io/badge/made%20by-Swarm-blue.svg?style=flat-square)](https://swarm.ethereum.org/)
 [![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
@@ -90,14 +89,6 @@ console.log(data.text()) // prints 'Bee is awesome!'
 
 You can find the full documentation [here](https://bee-js.ethswarm.org/docs). The API reference documentation can be found [here](https://bee-js.ethswarm.org/docs/api).
 
-You can generate API docs locally with:
-
-```sh
-npm run docs
-```
-
-The generated docs can be viewed in browser by opening `./docs/index.html`
-
 ## Contribute
 
 There are some ways you can make this module better:
@@ -118,25 +109,15 @@ npm i
 
 The tests run in both context: node and dom with Jest.
 
-To run the integration tests, you need to use our [`bee-factory`](https://github.com/ethersphere/bee-factory/) project. Clone the repo, you can use our prebuilt Docker images with setting env. variables like:
-
-```bash
-export BEE_VERSION="1.0.0-2572fa48"
-export BLOCKCHAIN_VERSION="1.2.0"
-export BEE_ENV_PREFIX="swarm-test"
-export BEE_IMAGE_PREFIX="docker.pkg.github.com/ethersphere/bee-factory"
-```
-
-Customize these values based on which Bee version you want to run. After the env. variables are set use the `./scripts/environment.sh` script with `start` parameter.
+To run the integration tests, you need to spin up local Bee cluster using our [`bee-factory`](https://github.com/ethersphere/bee-factory/) project.
+In order to do that you have to have locally Docker running on your machine, but afterwards you can just simply run `npm run bee`, which spins up the
+cluster and display Queen's logs. If you want to exit hit `CTRL+C`.
 
 If you want to skip creation of postage stamps every run of integration tests you can create stamps for both nodes and set them under env. variables `BEE_POSTAGE` and `BEE_PEER_POSTAGE`.
 
 By default, for integration tests two bee nodes are expected to run on localhost on addresses `http://localhost:1633` and `http://localhost:11633`. These are the default values for the `bee-factory` script.
 If you want to use custom setup, you can change the behavior of tests to different addresses using environment variables `BEE_API_URL`, `BEE_DEBUG_API_URL`, `BEE_PEER_DEBUG_API_URL` and `BEE_PEER_API_URL`.
 
-In Visual Studio environment, the tests have been set up to run against your local bee node on `http://localhost:1633`
-To run Jest tests, choose the `vscode-jest-tests` CI job under the Run tab.
-
 There are also browser tests by Puppeteer, which also provide integrity testing.
 ```sh
 npm run test:browser

package/dist/cjs/{bee-debug.js → src/bee-debug.js}

@@ -43,6 +43,7 @@ const types_1 = require("./types");
 const tag = __importStar(require("./modules/debug/tag"));
 const stamps = __importStar(require("./modules/debug/stamps"));
 const http_1 = require("./utils/http");
+const utils_1 = require("../test/utils");
 class BeeDebug {
     constructor(url, options) {
         var _a;
@@ -431,6 +432,17 @@ class BeeDebug {
             return states.getChainState(this.getKy(options));
         });
     }
+    /**
+     * Get wallet balances for xDai and BZZ of the Bee node
+     *
+     * @param options
+     */
+    getWalletBalance(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, type_1.assertRequestOptions)(options);
+            return states.getWalletBalance(this.getKy(options));
+        });
+    }
     /**
      * Creates new postage batch from the funds that the node has available in its Ethereum account.
      *
@@ -450,8 +462,8 @@ class BeeDebug {
      */
     createPostageBatch(amount, depth, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            (0, type_1.assertRequestOptions)(options);
-            (0, type_1.assertNonNegativeInteger)(amount);
+            (0, type_1.assertPostageBatchOptions)(options);
+            (0, type_1.assertPositiveInteger)(amount);
             (0, type_1.assertNonNegativeInteger)(depth);
             if (depth < types_1.STAMPS_DEPTH_MIN) {
                 throw new error_1.BeeArgumentError(`Depth has to be at least ${types_1.STAMPS_DEPTH_MIN}`, depth);
@@ -459,13 +471,11 @@ class BeeDebug {
             if (depth > types_1.STAMPS_DEPTH_MAX) {
                 throw new error_1.BeeArgumentError(`Depth has to be at most ${types_1.STAMPS_DEPTH_MAX}`, depth);
             }
-            if (options === null || options === void 0 ? void 0 : options.gasPrice) {
-                (0, type_1.assertNonNegativeInteger)(options.gasPrice);
+            const stamp = yield stamps.createPostageBatch(this.getKy(options), amount, depth, options);
+            if (options === null || options === void 0 ? void 0 : options.waitForUsable) {
+                yield this.waitForUsablePostageStamp(stamp, options === null || options === void 0 ? void 0 : options.waitForUsableTimeout);
             }
-            if ((options === null || options === void 0 ? void 0 : options.immutableFlag) !== undefined) {
-                (0, type_1.assertBoolean)(options.immutableFlag);
-            }
-            return stamps.createPostageBatch(this.getKy(options), amount, depth, options);
+            return stamp;
         });
     }
     /**
@@ -605,6 +615,19 @@ class BeeDebug {
             return transactions.cancelTransaction(this.getKy(options), transactionHash, gasPrice);
         });
     }
+    waitForUsablePostageStamp(id, timeout = 120000) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const TIME_STEP = 1500;
+            for (let time = 0; time < timeout; time += TIME_STEP) {
+                const stamp = yield this.getPostageBatch(id);
+                if (stamp.usable) {
+                    return;
+                }
+                yield (0, utils_1.sleep)(TIME_STEP);
+            }
+            throw new error_1.BeeError('Timeout on waiting for postage stamp to become usable');
+        });
+    }
     getKy(options) {
         if (!options) {
             return this.ky;

package/dist/cjs/{bee.js → src/bee.js}

@@ -56,6 +56,8 @@ const collection_node_1 = require("./utils/collection.node");
 const types_1 = require("./types");
 const http_1 = require("./utils/http");
 const stream_1 = require("./utils/stream");
+const retrievable_1 = require("./feed/retrievable");
+const swarm_cid_1 = require("@ethersphere/swarm-cid");
 /**
  * The main component that abstracts operations available on the main Bee API.
  *
@@ -121,30 +123,34 @@ class Bee {
     /**
      * Download data as a byte array
      *
-     * @param reference Bee data 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
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1{reference}/get)
      */
     downloadData(reference, options) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, type_2.assertRequestOptions)(options);
-            (0, type_2.assertReference)(reference);
+            (0, type_2.assertReferenceOrEns)(reference);
             return bytes.download(this.getKy(options), reference);
         });
     }
     /**
      * Download data as a Readable stream
      *
-     * @param reference Bee data 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
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1{reference}/get)
      */
     downloadReadableData(reference, options) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, type_2.assertRequestOptions)(options);
-            (0, type_2.assertReference)(reference);
+            (0, type_2.assertReferenceOrEns)(reference);
             return bytes.downloadReadable(this.getKy(options), reference);
         });
     }
@@ -179,15 +185,17 @@ class Bee {
     /**
      * Download chunk as a byte array
      *
-     * @param reference Bee chunk reference
+     * @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
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /chunks`](https://docs.ethswarm.org/api/#tag/Chunk/paths/~1chunks~1{reference}/get)
      */
     downloadChunk(reference, options) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, type_2.assertRequestOptions)(options);
-            (0, type_2.assertReference)(reference);
+            (0, type_2.assertReferenceOrEns)(reference);
             return chunk.download(this.getKy(options), reference);
         });
     }
@@ -221,26 +229,27 @@ class Bee {
                 const fileName = name !== null && name !== void 0 ? name : data.name;
                 const contentType = data.type;
                 const fileOptions = Object.assign({ contentType }, options);
-                return bzz.uploadFile(this.getKy(options), fileData, postageBatchId, fileName, fileOptions);
+                return (0, type_2.addCidConversionFunction)(yield bzz.uploadFile(this.getKy(options), fileData, postageBatchId, fileName, fileOptions), swarm_cid_1.ReferenceType.MANIFEST);
             }
             else if ((0, stream_1.isReadable)(data) && (options === null || options === void 0 ? void 0 : options.tag) && !options.size) {
                 // TODO: Needed until https://github.com/ethersphere/bee/issues/2317 is resolved
                 const result = yield bzz.uploadFile(this.getKy(options), data, postageBatchId, name, options);
                 yield this.updateTag(options.tag, result.reference);
-                return result;
+                return (0, type_2.addCidConversionFunction)(result, swarm_cid_1.ReferenceType.MANIFEST);
             }
             else {
-                return bzz.uploadFile(this.getKy(options), data, postageBatchId, name, options);
+                return (0, type_2.addCidConversionFunction)(yield bzz.uploadFile(this.getKy(options), data, postageBatchId, name, options), swarm_cid_1.ReferenceType.MANIFEST);
             }
         });
     }
     /**
      * Download single file.
      *
-     * @param reference Bee file reference
+     * @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, 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
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/Collection/paths/~1bzz~1{reference}~1{path}/get)
@@ -248,16 +257,18 @@ class Bee {
     downloadFile(reference, path = '', options) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, type_2.assertRequestOptions)(options);
-            (0, type_2.assertReference)(reference);
+            reference = (0, type_2.makeReferenceOrEns)(reference, swarm_cid_1.ReferenceType.MANIFEST);
             return bzz.downloadFile(this.getKy(options), reference, path);
         });
     }
     /**
      * Download single file as a readable stream
      *
-     * @param reference Hash reference to file
+     * @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
      *
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/Collection/paths/~1bzz~1{reference}~1{path}/get)
@@ -265,7 +276,7 @@ class Bee {
     downloadReadableFile(reference, path = '', options) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, type_2.assertRequestOptions)(options);
-            (0, type_2.assertReference)(reference);
+            reference = (0, type_2.makeReferenceOrEns)(reference, swarm_cid_1.ReferenceType.MANIFEST);
             return bzz.downloadFileReadable(this.getKy(options), reference, path);
         });
     }
@@ -291,7 +302,7 @@ class Bee {
             if (options)
                 (0, type_2.assertCollectionUploadOptions)(options);
             const data = yield (0, collection_1.makeCollectionFromFileList)(fileList);
-            return bzz.uploadCollection(this.getKy(options), data, postageBatchId, options);
+            return (0, type_2.addCidConversionFunction)(yield bzz.uploadCollection(this.getKy(options), data, postageBatchId, options), swarm_cid_1.ReferenceType.MANIFEST);
         });
     }
     /**
@@ -310,7 +321,7 @@ class Bee {
             (0, collection_1.assertCollection)(collection);
             if (options)
                 (0, type_2.assertCollectionUploadOptions)(options);
-            return bzz.uploadCollection(this.ky, collection, postageBatchId, options);
+            return (0, type_2.addCidConversionFunction)(yield bzz.uploadCollection(this.ky, collection, postageBatchId, options), swarm_cid_1.ReferenceType.MANIFEST);
         });
     }
     /**
@@ -335,7 +346,7 @@ class Bee {
             if (options)
                 (0, type_2.assertCollectionUploadOptions)(options);
             const data = yield (0, collection_node_1.makeCollectionFromFS)(dir);
-            return bzz.uploadCollection(this.getKy(options), data, postageBatchId, options);
+            return (0, type_2.addCidConversionFunction)(yield bzz.uploadCollection(this.getKy(options), data, postageBatchId, options), swarm_cid_1.ReferenceType.MANIFEST);
         });
     }
     /**
@@ -494,9 +505,10 @@ class Bee {
      *
      * **Warning! Not allowed when node is in Gateway mode!**
      *
-     * @param reference Bee data 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 reference is in not correct format
+     * @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 - Pinning](https://docs.ethswarm.org/docs/access-the-swarm/pinning)
      */
@@ -510,35 +522,77 @@ class Bee {
     /**
      * Instructs the Bee node to reupload a locally pinned data into the network.
      *
-     * @param reference
+     * @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 reference is in not correct format
+     * @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 API reference - `PUT /stewardship`](https://docs.ethswarm.org/api/#tag/Stewardship/paths/~1stewardship~1{reference}/put)
      */
     reuploadPinnedData(reference, options) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, type_2.assertRequestOptions)(options);
-            (0, type_2.assertReference)(reference);
+            (0, type_2.assertReferenceOrEns)(reference);
             yield stewardship.reupload(this.getKy(options), reference);
         });
     }
     /**
      * Checks if content specified by reference is retrievable from the network.
      *
-     * @param reference The checked content
+     * @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
      *
      * @see [Bee API reference - `GET /stewardship`](https://docs.ethswarm.org/api/#tag/Stewardship/paths/~1stewardship~1{reference}/get)
      */
     isReferenceRetrievable(reference, options) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, type_2.assertRequestOptions)(options);
-            (0, type_2.assertReference)(reference);
+            (0, type_2.assertReferenceOrEns)(reference);
             return stewardship.isRetrievable(this.getKy(options), reference);
         });
     }
+    /**
+     * Functions that validates 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.
+     *
+     * If index is passed then it validates all previous sequence index chunks if they are available as they are required
+     * to correctly resolve the feed upto the given index update.
+     *
+     * @param type
+     * @param owner
+     * @param topic
+     * @param index
+     * @param options
+     */
+    isFeedRetrievable(type, owner, topic, index, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const canonicalOwner = (0, eth_1.makeEthAddress)(owner);
+            const canonicalTopic = (0, topic_1.makeTopic)(topic);
+            if (!index) {
+                try {
+                    yield this.makeFeedReader(type, canonicalTopic, canonicalOwner).download();
+                    return true;
+                }
+                catch (e) {
+                    const err = e;
+                    // Only if the error is "not-found" then we return false otherwise we re-throw the error
+                    if ((err === null || err === void 0 ? void 0 : err.status) === 404) {
+                        return false;
+                    }
+                    throw e;
+                }
+            }
+            if (type !== 'sequence') {
+                throw new error_1.BeeError('Only Sequence type of Feeds is supported at the moment');
+            }
+            return (0, retrievable_1.areAllSequentialFeedsUpdateRetrievable)(this, canonicalOwner, canonicalTopic, index, options);
+        });
+    }
     /**
      * Send data to recipient or target with Postal Service for Swarm.
      *
@@ -707,6 +761,7 @@ class Bee {
      *
      * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/dapps-on-swarm/feeds)
      * @see [Bee API reference - `POST /feeds`](https://docs.ethswarm.org/api/#tag/Feed/paths/~1feeds~1{owner}~1{topic}/post)
+     * TODO: Once breaking add support for Feed CID
      */
     createFeedManifest(postageBatchId, type, topic, owner, options) {
         return __awaiter(this, void 0, void 0, function* () {

package/dist/cjs/src/feed/identifier.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFeedIdentifier = void 0;
+const types_1 = require("../types");
+const hash_1 = require("../utils/hash");
+const hex_1 = require("../utils/hex");
+const uint64_1 = require("../utils/uint64");
+function isEpoch(epoch) {
+    return typeof epoch === 'object' && epoch !== null && 'time' in epoch && 'level' in epoch;
+}
+function hashFeedIdentifier(topic, index) {
+    return (0, hash_1.keccak256Hash)((0, hex_1.hexToBytes)(topic), index);
+}
+function makeSequentialFeedIdentifier(topic, index) {
+    const indexBytes = (0, uint64_1.writeUint64BigEndian)(index);
+    return hashFeedIdentifier(topic, indexBytes);
+}
+function makeFeedIndexBytes(s) {
+    const hex = (0, hex_1.makeHexString)(s, types_1.FEED_INDEX_HEX_LENGTH);
+    return (0, hex_1.hexToBytes)(hex);
+}
+function makeFeedIdentifier(topic, index) {
+    if (typeof index === 'number') {
+        return makeSequentialFeedIdentifier(topic, index);
+    }
+    else if (typeof index === 'string') {
+        const indexBytes = makeFeedIndexBytes(index);
+        return hashFeedIdentifier(topic, indexBytes);
+    }
+    else if (isEpoch(index)) {
+        throw new TypeError('epoch is not yet implemented');
+    }
+    return hashFeedIdentifier(topic, index);
+}
+exports.makeFeedIdentifier = makeFeedIdentifier;

package/dist/cjs/{feed → src/feed}/index.js

@@ -28,11 +28,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeFeedWriter = exports.makeFeedReader = exports.downloadFeedUpdate = exports.verifyChunkReference = exports.updateFeed = exports.findNextIndex = exports.uploadFeedUpdate = exports.makeFeedIdentifier = exports.makeFeedIndexBytes = exports.makeSequentialFeedIdentifier = exports.isEpoch = void 0;
+exports.makeFeedWriter = exports.makeFeedReader = exports.downloadFeedUpdate = exports.getFeedUpdateChunkReference = exports.updateFeed = exports.findNextIndex = void 0;
 const hash_1 = require("../utils/hash");
 const serialize_1 = require("../chunk/serialize");
-const soc_1 = require("../chunk/soc");
 const feed_1 = require("../modules/feed");
+const soc_1 = require("../chunk/soc");
 const types_1 = require("../types");
 const bytes_1 = require("../utils/bytes");
 const error_1 = require("../utils/error");
@@ -41,59 +41,16 @@ const uint64_1 = require("../utils/uint64");
 const chunkAPI = __importStar(require("../modules/chunk"));
 const eth_1 = require("../utils/eth");
 const type_1 = require("../utils/type");
+const identifier_1 = require("./identifier");
+const reference_1 = require("../utils/reference");
 const TIMESTAMP_PAYLOAD_OFFSET = 0;
 const TIMESTAMP_PAYLOAD_SIZE = 8;
 const REFERENCE_PAYLOAD_OFFSET = TIMESTAMP_PAYLOAD_SIZE;
-const REFERENCE_PAYLOAD_MIN_SIZE = 32;
-const REFERENCE_PAYLOAD_MAX_SIZE = 64;
-const INDEX_HEX_LENGTH = 16;
-function isEpoch(epoch) {
-    return typeof epoch === 'object' && epoch !== null && 'time' in epoch && 'level' in epoch;
-}
-exports.isEpoch = isEpoch;
-function hashFeedIdentifier(topic, index) {
-    return (0, hash_1.keccak256Hash)((0, hex_1.hexToBytes)(topic), index);
-}
-function makeSequentialFeedIdentifier(topic, index) {
-    const indexBytes = (0, uint64_1.writeUint64BigEndian)(index);
-    return hashFeedIdentifier(topic, indexBytes);
-}
-exports.makeSequentialFeedIdentifier = makeSequentialFeedIdentifier;
-function makeFeedIndexBytes(s) {
-    const hex = (0, hex_1.makeHexString)(s, INDEX_HEX_LENGTH);
-    return (0, hex_1.hexToBytes)(hex);
-}
-exports.makeFeedIndexBytes = makeFeedIndexBytes;
-function makeFeedIdentifier(topic, index) {
-    if (typeof index === 'number') {
-        return makeSequentialFeedIdentifier(topic, index);
-    }
-    else if (typeof index === 'string') {
-        const indexBytes = makeFeedIndexBytes(index);
-        return hashFeedIdentifier(topic, indexBytes);
-    }
-    else if (isEpoch(index)) {
-        throw new TypeError('epoch is not yet implemented');
-    }
-    return hashFeedIdentifier(topic, index);
-}
-exports.makeFeedIdentifier = makeFeedIdentifier;
-function uploadFeedUpdate(ky, signer, topic, index, reference, postageBatchId, options) {
-    var _a;
-    return __awaiter(this, void 0, void 0, function* () {
-        const identifier = makeFeedIdentifier(topic, index);
-        const at = (_a = options === null || options === void 0 ? void 0 : options.at) !== null && _a !== void 0 ? _a : Date.now() / 1000.0;
-        const timestamp = (0, uint64_1.writeUint64BigEndian)(at);
-        const payloadBytes = (0, serialize_1.serializeBytes)(timestamp, reference);
-        return (0, soc_1.uploadSingleOwnerChunkData)(ky, signer, postageBatchId, identifier, payloadBytes, options);
-    });
-}
-exports.uploadFeedUpdate = uploadFeedUpdate;
 function findNextIndex(ky, owner, topic, options) {
     return __awaiter(this, void 0, void 0, function* () {
         try {
-            const feedUpdate = yield (0, feed_1.fetchFeedUpdate)(ky, owner, topic, options);
-            return (0, hex_1.makeHexString)(feedUpdate.feedIndexNext, INDEX_HEX_LENGTH);
+            const feedUpdate = yield (0, feed_1.fetchLatestFeedUpdate)(ky, owner, topic, options);
+            return (0, hex_1.makeHexString)(feedUpdate.feedIndexNext, types_1.FEED_INDEX_HEX_LENGTH);
         }
         catch (e) {
             if (e instanceof error_1.BeeResponseError && e.status === 404) {
@@ -104,37 +61,34 @@ function findNextIndex(ky, owner, topic, options) {
     });
 }
 exports.findNextIndex = findNextIndex;
-function updateFeed(ky, signer, topic, reference, postageBatchId, options) {
+function updateFeed(ky, signer, topic, reference, postageBatchId, options, index = 'latest') {
+    var _a;
     return __awaiter(this, void 0, void 0, function* () {
         const ownerHex = (0, eth_1.makeHexEthAddress)(signer.address);
-        const nextIndex = yield findNextIndex(ky, ownerHex, topic, options);
-        return uploadFeedUpdate(ky, signer, topic, nextIndex, reference, postageBatchId, options);
+        const nextIndex = index === 'latest' ? yield findNextIndex(ky, ownerHex, topic, options) : index;
+        const identifier = (0, identifier_1.makeFeedIdentifier)(topic, nextIndex);
+        const at = (_a = options === null || options === void 0 ? void 0 : options.at) !== null && _a !== void 0 ? _a : Date.now() / 1000.0;
+        const timestamp = (0, uint64_1.writeUint64BigEndian)(at);
+        const payloadBytes = (0, serialize_1.serializeBytes)(timestamp, reference);
+        return (0, soc_1.uploadSingleOwnerChunkData)(ky, signer, postageBatchId, identifier, payloadBytes, options);
     });
 }
 exports.updateFeed = updateFeed;
-function verifyChunkReferenceAtOffset(offset, data) {
-    try {
-        return (0, bytes_1.bytesAtOffset)(data, offset, REFERENCE_PAYLOAD_MAX_SIZE);
-    }
-    catch (e) {
-        return (0, bytes_1.bytesAtOffset)(data, offset, REFERENCE_PAYLOAD_MIN_SIZE);
-    }
-}
-function verifyChunkReference(data) {
-    return verifyChunkReferenceAtOffset(0, data);
+function getFeedUpdateChunkReference(owner, topic, index) {
+    const identifier = (0, identifier_1.makeFeedIdentifier)(topic, index);
+    return (0, hash_1.keccak256Hash)(identifier, owner);
 }
-exports.verifyChunkReference = verifyChunkReference;
+exports.getFeedUpdateChunkReference = getFeedUpdateChunkReference;
 function downloadFeedUpdate(ky, owner, topic, index) {
     return __awaiter(this, void 0, void 0, function* () {
-        const identifier = makeFeedIdentifier(topic, index);
-        const address = (0, hash_1.keccak256Hash)(identifier, owner);
+        const address = getFeedUpdateChunkReference(owner, topic, index);
         const addressHex = (0, hex_1.bytesToHex)(address);
         const data = yield chunkAPI.download(ky, addressHex);
         const soc = (0, soc_1.makeSingleOwnerChunkFromData)(data, address);
         const payload = soc.payload();
         const timestampBytes = (0, bytes_1.bytesAtOffset)(payload, TIMESTAMP_PAYLOAD_OFFSET, TIMESTAMP_PAYLOAD_SIZE);
         const timestamp = (0, uint64_1.readUint64BigEndian)(timestampBytes);
-        const reference = verifyChunkReferenceAtOffset(REFERENCE_PAYLOAD_OFFSET, payload);
+        const reference = (0, reference_1.makeBytesReference)(payload, REFERENCE_PAYLOAD_OFFSET);
         return {
             timestamp,
             reference,
@@ -143,40 +97,30 @@ function downloadFeedUpdate(ky, owner, topic, index) {
 }
 exports.downloadFeedUpdate = downloadFeedUpdate;
 function makeFeedReader(ky, type, topic, owner) {
-    const download = (options) => __awaiter(this, void 0, void 0, function* () { return (0, feed_1.fetchFeedUpdate)(ky, owner, topic, Object.assign(Object.assign({}, options), { type })); });
     return {
         type,
         owner,
         topic,
-        download,
+        download(options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (!(options === null || options === void 0 ? void 0 : options.index)) {
+                    return (0, feed_1.fetchLatestFeedUpdate)(ky, owner, topic, Object.assign(Object.assign({}, options), { type }));
+                }
+                const update = yield downloadFeedUpdate(ky, (0, hex_1.hexToBytes)(owner), topic, options.index);
+                return {
+                    reference: (0, hex_1.bytesToHex)(update.reference),
+                    feedIndex: options.index,
+                    feedIndexNext: '',
+                };
+            });
+        },
     };
 }
 exports.makeFeedReader = makeFeedReader;
-function makeChunkReference(reference) {
-    if (typeof reference === 'string') {
-        try {
-            // Non-encrypted chunk hex string reference
-            const hexReference = (0, hex_1.makeHexString)(reference, types_1.REFERENCE_HEX_LENGTH);
-            return (0, hex_1.hexToBytes)(hexReference);
-        }
-        catch (e) {
-            if (!(e instanceof TypeError)) {
-                throw e;
-            }
-            // Encrypted chunk hex string reference
-            const hexReference = (0, hex_1.makeHexString)(reference, types_1.ENCRYPTED_REFERENCE_HEX_LENGTH);
-            return (0, hex_1.hexToBytes)(hexReference);
-        }
-    }
-    else if (reference instanceof Uint8Array) {
-        return verifyChunkReference(reference);
-    }
-    throw new TypeError('invalid chunk reference');
-}
 function makeFeedWriter(ky, type, topic, signer) {
     const upload = (postageBatchId, reference, options) => __awaiter(this, void 0, void 0, function* () {
         (0, type_1.assertAddress)(postageBatchId);
-        const canonicalReference = makeChunkReference(reference);
+        const canonicalReference = (0, reference_1.makeBytesReference)(reference);
         return updateFeed(ky, signer, topic, canonicalReference, postageBatchId, Object.assign(Object.assign({}, options), { type }));
     });
     return Object.assign(Object.assign({}, makeFeedReader(ky, type, topic, (0, eth_1.makeHexEthAddress)(signer.address))), { upload });