@upcoming/bee-js 10.1.2 → 12.0.0

package/README.md

@@ -200,7 +200,7 @@ The `toString` method uses `toHex`.
 | `pssSend`                            | `POST /pss/send/:topic/:target` [🔗](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1send~1%7Btopic%7D~1%7Btargets%7D/post)     | ❌✅✅   |
 | `pssSubscribe` _Websocket_           | `GET /pss/subscribe/:topic` [🔗](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1%7Btopic%7D/get)                    | ❌❌✅   |
 | `pssReceive`                         | `GET /pss/subscribe/:topic` [🔗](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1%7Btopic%7D/get)                    | ❌❌✅   |
-| `getAllPostageBatch`                 | `GET /stamps` [🔗](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps/get)                                                                 | ❌✅✅   |
+| `getPostageBatches`                  | `GET /stamps` [🔗](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps/get)                                                                 | ❌✅✅   |
 | `getGlobalPostageBatches`            | `GET /batches` [🔗](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1batches/get)                                                               | ❌✅✅   |
 | `getPostageBatch`                    | `GET /stamps/:batchId` [🔗](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1%7Bbatch_id%7D/get)                                        | ❌✅✅   |
 | `getPostageBatchBuckets`             | `GET /stamps/:batchId/buckets` [🔗](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1%7Bbatch_id%7D~1buckets/get)                       | ❌✅✅   |
@@ -266,7 +266,7 @@ async function getOrCreatePostageBatch() {
   const bee = new Bee('http://localhost:1633')
   let batchId
 
-  const batches = await bee.getAllPostageBatch()
+  const batches = await bee.getPostageBatches()
   const usable = batches.find(x => x.usable)
 
   if (usable) {

package/dist/cjs/bee.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Bee = void 0;
 const cafe_utility_1 = require("cafe-utility");
@@ -184,7 +194,7 @@ class Bee {
      * Chunks uploaded with this method should be retrieved with the {@link downloadChunk} method.
      *
      * @param stamp Postage Batch ID or an Envelope created with the {@link createEnvelope} method.
-     * @param data    Raw chunk to be uploaded
+     * @param data    Raw chunk to be uploaded (Content Addressed Chunk or Single Owner Chunk)
      * @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.
      *
@@ -193,6 +203,7 @@ class Bee {
      * @see [Bee API reference - `POST /chunks`](https://docs.ethswarm.org/api/#tag/Chunk/paths/~1chunks/post)
      */
     async uploadChunk(stamp, data, options, requestOptions) {
+        const isSOC = 'identifier' in data && 'signature' in data && 'owner' in data;
         data = data instanceof Uint8Array ? data : data.data;
         if (options) {
             options = (0, type_1.prepareUploadOptions)(options);
@@ -200,8 +211,11 @@ class Bee {
         if (data.length < typed_bytes_1.Span.LENGTH) {
             throw new error_1.BeeArgumentError(`Chunk has to have size of at least ${typed_bytes_1.Span.LENGTH}.`, data);
         }
-        if (data.length > types_1.CHUNK_SIZE + typed_bytes_1.Span.LENGTH) {
-            throw new error_1.BeeArgumentError(`Chunk has to have size of at most ${types_1.CHUNK_SIZE + typed_bytes_1.Span.LENGTH}.`, data);
+        if (!isSOC && data.length > types_1.CHUNK_SIZE + typed_bytes_1.Span.LENGTH) {
+            throw new error_1.BeeArgumentError(`Content Addressed Chunk must not exceed ${types_1.CHUNK_SIZE + typed_bytes_1.Span.LENGTH} bytes.`, data);
+        }
+        if (isSOC && data.length > types_1.CHUNK_SIZE + typed_bytes_1.Span.LENGTH + typed_bytes_1.Signature.LENGTH + typed_bytes_1.Identifier.LENGTH) {
+            throw new error_1.BeeArgumentError(`Single Owner Chunk must not exceed ${types_1.CHUNK_SIZE + typed_bytes_1.Span.LENGTH + typed_bytes_1.Signature.LENGTH + typed_bytes_1.Identifier.LENGTH} bytes.`, data);
         }
         return chunk.upload(this.getRequestOptionsForCall(requestOptions), data, stamp, options);
     }
@@ -837,7 +851,7 @@ class Bee {
         signer = new typed_bytes_1.PrivateKey(signer);
         identifier = new typed_bytes_1.Identifier(identifier);
         const cac = (0, cac_1.makeContentAddressedChunk)(data);
-        const soc = (0, soc_1.makeSingleOwnerChunk)(cac, identifier, signer);
+        const soc = cac.toSingleOwnerChunk(identifier, signer);
         return gsoc.send(this.getRequestOptionsForCall(requestOptions), soc, postageBatchId, options);
     }
     /**
@@ -968,6 +982,67 @@ class Bee {
         owner = new typed_bytes_1.EthAddress(owner);
         return (0, feed_2.fetchLatestFeedUpdate)(this.getRequestOptionsForCall(requestOptions), owner, topic);
     }
+    /**
+     * Creates a Content Addressed Chunk.
+     *
+     * To be uploaded with the {@link uploadChunk} method.
+     *
+     * Payload size must be between 1 and 4096 bytes.
+     *
+     * @param rawPayload Data to be stored in the chunk. If the data is a string, it will be converted to UTF-8 bytes.
+     * @param span       Optional span for the chunk. If not provided, it will be set to the length of the payload.
+     */
+    makeContentAddressedChunk(rawPayload, span) {
+        return (0, cac_1.makeContentAddressedChunk)(rawPayload, span);
+    }
+    /**
+     * Attempts to unmarshal arbitrary data into a Content Addressed Chunk.
+     * Throws an error if the data is not a valid CAC.
+     *
+     * @param data The chunk data (`span` and `payload`)
+     */
+    unmarshalContentAddressedChunk(data) {
+        return (0, cac_1.unmarshalContentAddressedChunk)(data);
+    }
+    /**
+     * Creates a Single Owner Chunk.
+     *
+     * To be uploaded with the {@link uploadChunk} method.
+     *
+     * Identical to chaining `makeContentAddressedChunk` and `toSingleOwnerChunk`.
+     *
+     * Payload size must be between 1 and 4096 bytes.
+     *
+     * @param address     Address of the Content Addressed Chunk
+     * @param span        Span of the Content Addressed Chunk
+     * @param payload     Payload of the Content Addressed Chunk
+     * @param identifier  The identifier of the chunk
+     * @param signer      The signer interface for signing the chunk
+     */
+    makeSingleOwnerChunk(address, span, payload, identifier, signer) {
+        return (0, soc_1.makeSingleOwnerChunk)(address, span, payload, identifier, signer);
+    }
+    /**
+     * Calculates the address of a Single Owner Chunk based on its identifier and owner address.
+     *
+     * @param identifier
+     * @param address
+     */
+    calculateSingleOwnerChunkAddress(identifier, address) {
+        return (0, soc_1.makeSOCAddress)(identifier, address);
+    }
+    /**
+     * Attempts to unmarshal arbitrary data into a Single Owner Chunk.
+     * Throws an error if the data is not a valid SOC.
+     *
+     * @param data    The chunk data
+     * @param address The address of the single owner chunk
+     *
+     * @returns a single owner chunk or throws error
+     */
+    unmarshalSingleOwnerChunk(data, address) {
+        return (0, soc_1.unmarshalSingleOwnerChunk)(data, address);
+    }
     /**
      * Returns an object for reading single owner chunks
      *
@@ -1550,7 +1625,9 @@ class Bee {
         const blockTime = this.network === 'gnosis' ? 5 : 15;
         const additionalAmount = (0, stamps_1.getAmountForDuration)(duration, chainState.currentPrice, blockTime);
         const currentAmount = (0, stamps_1.getAmountForDuration)(batch.duration, chainState.currentPrice, blockTime);
-        const targetAmount = duration.isZero() ? currentAmount * multiplier : currentAmount + additionalAmount * multiplier;
+        const targetAmount = duration.isZero()
+            ? currentAmount * multiplier
+            : (currentAmount + additionalAmount) * multiplier;
         const amountDelta = targetAmount - currentAmount;
         const transactionId = await this.topUpBatch(batch.batchID, amountDelta, requestOptions);
         if (depthDelta > 0) {
@@ -1680,6 +1757,22 @@ class Bee {
         const amount = (0, stamps_1.getAmountForDuration)(duration, chainState.currentPrice, this.network === 'gnosis' ? 5 : 15);
         return (0, stamps_1.getStampCost)(batch.depth, amount);
     }
+    /**
+     * Calculates the `amount` and expected duration extension for topping up a postage batch with a given BZZ value.
+     *
+     * @param postageBatchId
+     * @param bzz The amount of BZZ to spend on the top-up.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns An object with `amount` (to pass to {@link topUpBatch}) and `duration` (the expected TTL extension).
+     */
+    async calculateTopUpForBzz(postageBatchId, bzz, requestOptions) {
+        const batch = await this.getPostageBatch(postageBatchId, requestOptions);
+        const chainState = await this.getChainState(requestOptions);
+        const blockTime = this.network === 'gnosis' ? 5 : 15;
+        const amount = bzz.toPLURBigInt() / 2n ** BigInt(batch.depth);
+        const duration = (0, stamps_1.getStampDuration)(amount, chainState.currentPrice, blockTime);
+        return { amount, duration };
+    }
     /**
      * Increases the duration of a postage batch by increasing its amount.
      *

package/dist/cjs/chunk/bmt.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateChunkAddress = void 0;
+exports.calculateChunkAddress = calculateChunkAddress;
 const cafe_utility_1 = require("cafe-utility");
 const error_1 = require("../utils/error");
 const typed_bytes_1 = require("../utils/typed-bytes");
@@ -27,7 +27,6 @@ function calculateChunkAddress(chunkContent) {
     const chunkHash = cafe_utility_1.Binary.keccak256(cafe_utility_1.Binary.concatBytes(span, rootHash));
     return new typed_bytes_1.Reference(chunkHash);
 }
-exports.calculateChunkAddress = calculateChunkAddress;
 function calculateBmtRootHash(payload) {
     if (payload.length > MAX_CHUNK_PAYLOAD_SIZE) {
         throw new error_1.BeeArgumentError(`payload size ${payload.length} exceeds maximum chunk payload size ${MAX_CHUNK_PAYLOAD_SIZE}`, payload);

package/dist/cjs/chunk/cac.js

@@ -1,46 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.asContentAddressedChunk = exports.makeContentAddressedChunk = exports.MAX_PAYLOAD_SIZE = exports.MIN_PAYLOAD_SIZE = void 0;
+exports.MAX_PAYLOAD_SIZE = exports.MIN_PAYLOAD_SIZE = void 0;
+exports.unmarshalContentAddressedChunk = unmarshalContentAddressedChunk;
+exports.makeContentAddressedChunk = makeContentAddressedChunk;
 const cafe_utility_1 = require("cafe-utility");
 const bytes_1 = require("../utils/bytes");
 const typed_bytes_1 = require("../utils/typed-bytes");
 const bmt_1 = require("./bmt");
+const soc_1 = require("./soc");
 exports.MIN_PAYLOAD_SIZE = 1;
 exports.MAX_PAYLOAD_SIZE = 4096;
-const ENCODER = new TextEncoder();
-/**
- * Creates a content addressed chunk and verifies the payload size.
- *
- * @param payloadBytes the data to be stored in the chunk
- */
-function makeContentAddressedChunk(payloadBytes) {
-    if (!(payloadBytes instanceof Uint8Array)) {
-        payloadBytes = ENCODER.encode(payloadBytes);
-    }
-    if (payloadBytes.length < exports.MIN_PAYLOAD_SIZE || payloadBytes.length > exports.MAX_PAYLOAD_SIZE) {
-        throw new RangeError(`payload size ${payloadBytes.length} exceeds limits [${exports.MIN_PAYLOAD_SIZE}, ${exports.MAX_PAYLOAD_SIZE}]`);
-    }
-    const span = typed_bytes_1.Span.fromBigInt(BigInt(payloadBytes.length));
-    const data = cafe_utility_1.Binary.concatBytes(span.toUint8Array(), payloadBytes);
-    return {
-        data,
-        span,
-        payload: bytes_1.Bytes.fromSlice(data, typed_bytes_1.Span.LENGTH),
-        address: (0, bmt_1.calculateChunkAddress)(data),
-    };
+function unmarshalContentAddressedChunk(data) {
+    data = new bytes_1.Bytes(data);
+    return makeContentAddressedChunk(data.toUint8Array().slice(typed_bytes_1.Span.LENGTH), typed_bytes_1.Span.fromSlice(data.toUint8Array(), 0));
 }
-exports.makeContentAddressedChunk = makeContentAddressedChunk;
-function asContentAddressedChunk(chunkBytes) {
-    if (chunkBytes.length < exports.MIN_PAYLOAD_SIZE + typed_bytes_1.Span.LENGTH || chunkBytes.length > exports.MAX_PAYLOAD_SIZE + typed_bytes_1.Span.LENGTH) {
-        throw new RangeError(`chunk size ${chunkBytes.length} exceeds limits [${exports.MIN_PAYLOAD_SIZE + typed_bytes_1.Span.LENGTH}, ${typed_bytes_1.Span.LENGTH}]`);
+function makeContentAddressedChunk(rawPayload, span) {
+    if (cafe_utility_1.Types.isString(rawPayload)) {
+        rawPayload = bytes_1.Bytes.fromUtf8(rawPayload);
+    }
+    if (rawPayload.length < exports.MIN_PAYLOAD_SIZE || rawPayload.length > exports.MAX_PAYLOAD_SIZE) {
+        throw new RangeError(`payload size ${rawPayload.length} exceeds limits [${exports.MIN_PAYLOAD_SIZE}, ${exports.MAX_PAYLOAD_SIZE}]`);
     }
-    const span = typed_bytes_1.Span.fromSlice(chunkBytes, 0);
-    const data = cafe_utility_1.Binary.concatBytes(span.toUint8Array(), chunkBytes.slice(typed_bytes_1.Span.LENGTH));
+    const typedSpan = span
+        ? typeof span === 'bigint'
+            ? typed_bytes_1.Span.fromBigInt(span)
+            : span
+        : typed_bytes_1.Span.fromBigInt(BigInt(rawPayload.length));
+    const payload = new bytes_1.Bytes(rawPayload);
+    const data = cafe_utility_1.Binary.concatBytes(typedSpan.toUint8Array(), payload.toUint8Array());
+    const address = (0, bmt_1.calculateChunkAddress)(data);
     return {
         data,
-        span,
-        payload: bytes_1.Bytes.fromSlice(data, typed_bytes_1.Span.LENGTH),
-        address: (0, bmt_1.calculateChunkAddress)(data),
+        span: typedSpan,
+        payload,
+        address,
+        toSingleOwnerChunk: (identifier, signer) => {
+            return (0, soc_1.makeSingleOwnerChunk)(address, typedSpan, payload, identifier, signer);
+        },
     };
 }
-exports.asContentAddressedChunk = asContentAddressedChunk;

package/dist/cjs/chunk/soc.js

@@ -15,15 +15,31 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadSingleOwnerChunk = exports.uploadSingleOwnerChunkWithWrappedChunk = exports.uploadSingleOwnerChunkData = exports.uploadSingleOwnerChunk = exports.makeSingleOwnerChunk = exports.makeSOCAddress = exports.makeSingleOwnerChunkFromData = void 0;
+exports.unmarshalSingleOwnerChunk = unmarshalSingleOwnerChunk;
+exports.makeSOCAddress = makeSOCAddress;
+exports.makeSingleOwnerChunk = makeSingleOwnerChunk;
+exports.uploadSingleOwnerChunk = uploadSingleOwnerChunk;
+exports.uploadSingleOwnerChunkData = uploadSingleOwnerChunkData;
+exports.uploadSingleOwnerChunkWithWrappedChunk = uploadSingleOwnerChunkWithWrappedChunk;
+exports.downloadSingleOwnerChunk = downloadSingleOwnerChunk;
 const cafe_utility_1 = require("cafe-utility");
 const chunkAPI = __importStar(require("../modules/chunk"));
 const socAPI = __importStar(require("../modules/soc"));
@@ -33,8 +49,8 @@ const typed_bytes_1 = require("../utils/typed-bytes");
 const bmt_1 = require("./bmt");
 const cac_1 = require("./cac");
 const SOC_SIGNATURE_OFFSET = typed_bytes_1.Identifier.LENGTH;
-const SOC_SPAN_OFFSET = SOC_SIGNATURE_OFFSET + typed_bytes_1.Signature.LENGTH;
-const SOC_PAYLOAD_OFFSET = SOC_SPAN_OFFSET + typed_bytes_1.Span.LENGTH;
+const SOC_SPAN_OFFSET = typed_bytes_1.Identifier.LENGTH + typed_bytes_1.Signature.LENGTH;
+const SOC_PAYLOAD_OFFSET = typed_bytes_1.Identifier.LENGTH + typed_bytes_1.Signature.LENGTH + typed_bytes_1.Span.LENGTH;
 function recoverChunkOwner(data) {
     const cacData = data.slice(SOC_SPAN_OFFSET);
     const chunkAddress = (0, bmt_1.calculateChunkAddress)(cacData);
@@ -45,21 +61,22 @@ function recoverChunkOwner(data) {
     return ownerAddress;
 }
 /**
- * Verifies if the data is a valid single owner chunk
+ * Unmarshals arbitrary data into a Single Owner Chunk.
+ * Throws an error if the data is not a valid SOC.
  *
  * @param data    The chunk data
  * @param address The address of the single owner chunk
  *
  * @returns a single owner chunk or throws error
  */
-function makeSingleOwnerChunkFromData(data, address) {
+function unmarshalSingleOwnerChunk(data, address) {
     data = data instanceof bytes_1.Bytes ? data.toUint8Array() : data;
     address = new typed_bytes_1.Reference(address);
     const ownerAddress = recoverChunkOwner(data);
     const identifier = bytes_1.Bytes.fromSlice(data, 0, typed_bytes_1.Identifier.LENGTH);
     const socAddress = new typed_bytes_1.Reference(cafe_utility_1.Binary.keccak256(cafe_utility_1.Binary.concatBytes(identifier.toUint8Array(), ownerAddress.toUint8Array())));
     if (!cafe_utility_1.Binary.equals(address.toUint8Array(), socAddress.toUint8Array())) {
-        throw new error_1.BeeError('SOC Data does not match given address!');
+        throw new error_1.BeeError('SOC data does not match given address!');
     }
     const signature = typed_bytes_1.Signature.fromSlice(data, SOC_SIGNATURE_OFFSET);
     const span = typed_bytes_1.Span.fromSlice(data, SOC_SPAN_OFFSET);
@@ -74,11 +91,9 @@ function makeSingleOwnerChunkFromData(data, address) {
         owner: ownerAddress,
     };
 }
-exports.makeSingleOwnerChunkFromData = makeSingleOwnerChunkFromData;
 function makeSOCAddress(identifier, address) {
     return new typed_bytes_1.Reference(cafe_utility_1.Binary.keccak256(cafe_utility_1.Binary.concatBytes(identifier.toUint8Array(), address.toUint8Array())));
 }
-exports.makeSOCAddress = makeSOCAddress;
 /**
  * Creates a single owner chunk object
  *
@@ -86,25 +101,22 @@ exports.makeSOCAddress = makeSOCAddress;
  * @param identifier  The identifier of the chunk
  * @param signer      The signer interface for signing the chunk
  */
-function makeSingleOwnerChunk(chunk, identifier, signer) {
+function makeSingleOwnerChunk(address, span, payload, identifier, signer) {
     identifier = new typed_bytes_1.Identifier(identifier);
     signer = new typed_bytes_1.PrivateKey(signer);
-    const address = makeSOCAddress(identifier, signer.publicKey().address());
-    const signature = signer.sign(cafe_utility_1.Binary.concatBytes(identifier.toUint8Array(), chunk.address.toUint8Array()));
-    const data = cafe_utility_1.Binary.concatBytes(identifier.toUint8Array(), signature.toUint8Array(), chunk.data);
-    const span = typed_bytes_1.Span.fromSlice(chunk.data, 0);
-    const payload = bytes_1.Bytes.fromSlice(chunk.data, typed_bytes_1.Span.LENGTH);
+    const socAddress = makeSOCAddress(identifier, signer.publicKey().address());
+    const signature = signer.sign(cafe_utility_1.Binary.concatBytes(identifier.toUint8Array(), address.toUint8Array()));
+    const data = cafe_utility_1.Binary.concatBytes(identifier.toUint8Array(), signature.toUint8Array(), span.toUint8Array(), payload.toUint8Array());
     return {
         data,
         identifier,
         signature,
         span,
         payload,
-        address,
+        address: socAddress,
         owner: signer.publicKey().address(),
     };
 }
-exports.makeSingleOwnerChunk = makeSingleOwnerChunk;
 /**
  * Helper function to upload a chunk.
  *
@@ -119,7 +131,6 @@ async function uploadSingleOwnerChunk(requestOptions, chunk, stamp, options) {
     const data = cafe_utility_1.Binary.concatBytes(chunk.span.toUint8Array(), chunk.payload.toUint8Array());
     return socAPI.upload(requestOptions, chunk.owner, chunk.identifier, chunk.signature, data, stamp, options);
 }
-exports.uploadSingleOwnerChunk = uploadSingleOwnerChunk;
 /**
  * Helper function to create and upload SOC.
  *
@@ -134,17 +145,15 @@ async function uploadSingleOwnerChunkData(requestOptions, signer, stamp, identif
     signer = new typed_bytes_1.PrivateKey(signer);
     identifier = new typed_bytes_1.Identifier(identifier);
     const cac = (0, cac_1.makeContentAddressedChunk)(data);
-    const soc = makeSingleOwnerChunk(cac, identifier, signer);
+    const soc = cac.toSingleOwnerChunk(identifier, signer);
     return uploadSingleOwnerChunk(requestOptions, soc, stamp, options);
 }
-exports.uploadSingleOwnerChunkData = uploadSingleOwnerChunkData;
-async function uploadSingleOwnerChunkWithWrappedChunk(requestOptions, signer, stamp, identifier, rootChunk, options) {
+async function uploadSingleOwnerChunkWithWrappedChunk(requestOptions, signer, stamp, identifier, wrappedChunk, options) {
     signer = new typed_bytes_1.PrivateKey(signer);
     identifier = new typed_bytes_1.Identifier(identifier);
-    const soc = makeSingleOwnerChunk((0, cac_1.asContentAddressedChunk)(rootChunk), identifier, signer);
+    const soc = wrappedChunk.toSingleOwnerChunk(identifier, signer);
     return uploadSingleOwnerChunk(requestOptions, soc, stamp, options);
 }
-exports.uploadSingleOwnerChunkWithWrappedChunk = uploadSingleOwnerChunkWithWrappedChunk;
 /**
  * Helper function to download SOC.
  *
@@ -157,6 +166,5 @@ async function downloadSingleOwnerChunk(requestOptions, ownerAddress, identifier
     ownerAddress = new typed_bytes_1.EthAddress(ownerAddress);
     const address = makeSOCAddress(identifier, ownerAddress);
     const cac = await chunkAPI.download(requestOptions, address.toHex());
-    return makeSingleOwnerChunkFromData(cac, address);
+    return unmarshalSingleOwnerChunk(cac, address);
 }
-exports.downloadSingleOwnerChunk = downloadSingleOwnerChunk;

package/dist/cjs/feed/identifier.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeFeedIdentifier = void 0;
+exports.makeFeedIdentifier = makeFeedIdentifier;
 const cafe_utility_1 = require("cafe-utility");
 const typed_bytes_1 = require("../utils/typed-bytes");
 function makeFeedIdentifier(topic, index) {
     index = typeof index === 'number' ? typed_bytes_1.FeedIndex.fromBigInt(BigInt(index)) : index;
     return new typed_bytes_1.Identifier(cafe_utility_1.Binary.keccak256(cafe_utility_1.Binary.concatBytes(topic.toUint8Array(), index.toUint8Array())));
 }
-exports.makeFeedIdentifier = makeFeedIdentifier;

package/dist/cjs/feed/index.js

@@ -15,15 +15,32 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeFeedWriter = exports.makeFeedReader = exports.downloadFeedUpdateAsCAC = exports.downloadFeedUpdate = exports.getFeedUpdateChunkReference = exports.updateFeedWithPayload = exports.updateFeedWithReference = exports.findNextIndex = void 0;
+exports.findNextIndex = findNextIndex;
+exports.updateFeedWithReference = updateFeedWithReference;
+exports.updateFeedWithPayload = updateFeedWithPayload;
+exports.getFeedUpdateChunkReference = getFeedUpdateChunkReference;
+exports.downloadFeedUpdate = downloadFeedUpdate;
+exports.downloadFeedUpdateAsCAC = downloadFeedUpdateAsCAC;
+exports.makeFeedReader = makeFeedReader;
+exports.makeFeedWriter = makeFeedWriter;
 const cafe_utility_1 = require("cafe-utility");
 const cac_1 = require("../chunk/cac");
 const soc_1 = require("../chunk/soc");
@@ -53,7 +70,6 @@ async function findNextIndex(requestOptions, owner, topic) {
         throw e;
     }
 }
-exports.findNextIndex = findNextIndex;
 async function updateFeedWithReference(requestOptions, signer, topic, reference, postageBatchId, options) {
     reference = new typed_bytes_1.Reference(reference);
     const nextIndex = options?.index ?? (await findNextIndex(requestOptions, signer.publicKey().address(), topic));
@@ -63,28 +79,25 @@ async function updateFeedWithReference(requestOptions, signer, topic, reference,
     const payloadBytes = cafe_utility_1.Binary.concatBytes(timestamp, reference.toUint8Array());
     return (0, soc_1.uploadSingleOwnerChunkData)(requestOptions, signer, postageBatchId, identifier, payloadBytes, options);
 }
-exports.updateFeedWithReference = updateFeedWithReference;
 async function updateFeedWithPayload(requestOptions, signer, topic, data, postageBatchId, options) {
     const nextIndex = options?.index ?? (await findNextIndex(requestOptions, signer.publicKey().address(), topic));
     const identifier = (0, identifier_1.makeFeedIdentifier)(topic, nextIndex);
     if (data.length > 4096) {
         const uploadResult = await bytes.upload(requestOptions, data, postageBatchId, options);
-        const rootChunk = await chunkAPI.download(requestOptions, uploadResult.reference);
+        const rootChunk = (0, cac_1.unmarshalContentAddressedChunk)(await chunkAPI.download(requestOptions, uploadResult.reference));
         return (0, soc_1.uploadSingleOwnerChunkWithWrappedChunk)(requestOptions, signer, postageBatchId, identifier, rootChunk, options);
     }
     return (0, soc_1.uploadSingleOwnerChunkData)(requestOptions, signer, postageBatchId, identifier, cafe_utility_1.Types.isString(data) ? bytes_1.Bytes.fromUtf8(data).toUint8Array() : data, options);
 }
-exports.updateFeedWithPayload = updateFeedWithPayload;
 function getFeedUpdateChunkReference(owner, topic, index) {
     const identifier = (0, identifier_1.makeFeedIdentifier)(topic, index);
     return new typed_bytes_1.Reference(cafe_utility_1.Binary.keccak256(cafe_utility_1.Binary.concatBytes(identifier.toUint8Array(), owner.toUint8Array())));
 }
-exports.getFeedUpdateChunkReference = getFeedUpdateChunkReference;
 async function downloadFeedUpdate(requestOptions, owner, topic, index, hasTimestamp = false) {
     index = typeof index === 'number' ? typed_bytes_1.FeedIndex.fromBigInt(BigInt(index)) : index;
     const address = getFeedUpdateChunkReference(owner, topic, index);
     const data = await chunkAPI.download(requestOptions, address.toHex());
-    const soc = (0, soc_1.makeSingleOwnerChunkFromData)(data, address);
+    const soc = (0, soc_1.unmarshalSingleOwnerChunk)(data, address);
     let timestamp = cafe_utility_1.Optional.empty();
     if (hasTimestamp) {
         const timestampBytes = bytes_1.Bytes.fromSlice(soc.payload.toUint8Array(), TIMESTAMP_PAYLOAD_OFFSET, TIMESTAMP_PAYLOAD_SIZE);
@@ -95,14 +108,13 @@ async function downloadFeedUpdate(requestOptions, owner, topic, index, hasTimest
         payload: new bytes_1.Bytes(soc.payload.offset(hasTimestamp ? REFERENCE_PAYLOAD_OFFSET : 0)),
     };
 }
-exports.downloadFeedUpdate = downloadFeedUpdate;
 async function downloadFeedUpdateAsCAC(requestOptions, owner, topic, index) {
     index = typeof index === 'number' ? typed_bytes_1.FeedIndex.fromBigInt(BigInt(index)) : index;
     const address = getFeedUpdateChunkReference(owner, topic, index);
     const data = await chunkAPI.download(requestOptions, address);
-    return (0, cac_1.asContentAddressedChunk)(data.slice(typed_bytes_1.Identifier.LENGTH + typed_bytes_1.Signature.LENGTH));
+    const soc = (0, soc_1.unmarshalSingleOwnerChunk)(data, address);
+    return (0, cac_1.makeContentAddressedChunk)(soc.payload, soc.span);
 }
-exports.downloadFeedUpdateAsCAC = downloadFeedUpdateAsCAC;
 function makeFeedReader(requestOptions, topic, owner) {
     // TODO: remove after enough time has passed in deprecated version
     const download = async (options) => {
@@ -152,7 +164,6 @@ function makeFeedReader(requestOptions, topic, owner) {
         topic,
     };
 }
-exports.makeFeedReader = makeFeedReader;
 function makeFeedWriter(requestOptions, topic, signer) {
     const upload = async (postageBatchId, reference, options) => {
         return updateFeedWithReference(requestOptions, signer, topic, reference, postageBatchId, options);
@@ -167,4 +178,3 @@ function makeFeedWriter(requestOptions, topic, signer) {
         uploadPayload,
     };
 }
-exports.makeFeedWriter = makeFeedWriter;

package/dist/cjs/feed/retrievable.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.areAllSequentialFeedsUpdateRetrievable = void 0;
+exports.areAllSequentialFeedsUpdateRetrievable = areAllSequentialFeedsUpdateRetrievable;
 const cafe_utility_1 = require("cafe-utility");
 const typed_bytes_1 = require("../utils/typed-bytes");
 const index_1 = require("./index");
@@ -44,4 +44,3 @@ async function areAllSequentialFeedsUpdateRetrievable(bee, owner, topic, index,
     const chunkRetrievablePromises = getAllSequenceUpdateReferences(owner, topic, index).map(async (reference) => isChunkRetrievable(bee, reference, options, requestOptions));
     return (await Promise.all(chunkRetrievablePromises)).every(result => result);
 }
-exports.areAllSequentialFeedsUpdateRetrievable = areAllSequentialFeedsUpdateRetrievable;

package/dist/cjs/index.js

@@ -18,13 +18,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Stamper = exports.BeeDev = exports.Bee = exports.Size = exports.Utils = exports.Duration = exports.Bytes = exports.SUPPORTED_BEE_VERSION_EXACT = exports.SUPPORTED_BEE_VERSION = exports.MantarayNode = exports.MerkleTree = void 0;
 const bee_1 = require("./bee");

package/dist/cjs/manifest/manifest.js

@@ -316,7 +316,17 @@ class MantarayNode {
      */
     async saveRecursively(bee, postageBatchId, options, requestOptions) {
         for (const fork of this.forks.values()) {
-            await fork.node.saveRecursively(bee, postageBatchId, options, requestOptions);
+            const uploadResult = await fork.node.saveRecursively(bee, postageBatchId, options, requestOptions);
+            if (options?.act) {
+                let historyAddress;
+                uploadResult.historyAddress.ifPresent(ref => (historyAddress = ref));
+                if (historyAddress) {
+                    if (!fork.node.metadata) {
+                        fork.node.metadata = {};
+                    }
+                    fork.node.metadata['swarm-act-history-address'] = historyAddress.toHex();
+                }
+            }
         }
         const result = await bee.uploadData(postageBatchId, await this.marshal(), options, requestOptions);
         this.selfAddress = result.reference.toUint8Array();
@@ -330,7 +340,14 @@ class MantarayNode {
             if (!fork.node.selfAddress) {
                 throw Error('MantarayNode#loadRecursively fork.node.selfAddress is not set');
             }
-            const node = await MantarayNode.unmarshal(bee, fork.node.selfAddress, options, requestOptions);
+            let downloadOptions = options;
+            if (fork.node.metadata && fork.node.metadata['swarm-act-history-address']) {
+                downloadOptions = {
+                    ...options,
+                    actHistoryAddress: fork.node.metadata['swarm-act-history-address'],
+                };
+            }
+            const node = await MantarayNode.unmarshal(bee, fork.node.selfAddress, downloadOptions, requestOptions);
             fork.node.targetAddress = node.targetAddress;
             fork.node.forks = node.forks;
             fork.node.path = fork.prefix;