@upcoming/bee-js 0.1.0 → 0.3.0

package/dist/mjs/bee.js

@@ -1,5 +1,6 @@
-import { Objects, System } from 'cafe-utility';
-import { downloadSingleOwnerChunk, uploadSingleOwnerChunkData } from "./chunk/soc.js";
+import { Binary, Objects, System } from 'cafe-utility';
+import { makeContentAddressedChunk } from "./chunk/cac.js";
+import { downloadSingleOwnerChunk, makeSOCAddress, makeSingleOwnerChunk, uploadSingleOwnerChunkData } from "./chunk/soc.js";
 import { makeFeedReader, makeFeedWriter } from "./feed/index.js";
 import { areAllSequentialFeedsUpdateRetrievable } from "./feed/retrievable.js";
 import * as bytes from "./modules/bytes.js";
@@ -17,6 +18,7 @@ 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 gsoc from "./modules/gsoc.js";
 import * as pinning from "./modules/pinning.js";
 import * as pss from "./modules/pss.js";
 import * as status from "./modules/status.js";
@@ -30,8 +32,8 @@ import { makeCollectionFromFS } from "./utils/collection.node.js";
 import { prepareWebsocketData } from "./utils/data.js";
 import { BeeArgumentError, BeeError } from "./utils/error.js";
 import { fileArrayBuffer, isFile } from "./utils/file.js";
-import { asNumberString, assertAllTagsOptions, assertCashoutOptions, assertCollectionUploadOptions, assertData, assertFileData, assertFileUploadOptions, assertNonNegativeInteger, assertPostageBatchOptions, assertPssMessageHandler, assertRequestOptions, assertTransactionOptions, assertUploadOptions, isReadable, makeTagUid } from "./utils/type.js";
-import { BatchId, EthAddress, PeerAddress, PrivateKey, PublicKey, Reference, Span, Topic, TransactionId } from "./utils/typed-bytes.js";
+import { asNumberString, assertAllTagsOptions, assertCashoutOptions, assertCollectionUploadOptions, assertData, assertFileData, assertFileUploadOptions, assertGsocMessageHandler, assertNonNegativeInteger, assertPostageBatchOptions, assertPssMessageHandler, assertRequestOptions, assertTransactionOptions, assertUploadOptions, makeTagUid } from "./utils/type.js";
+import { BatchId, EthAddress, Identifier, PeerAddress, PrivateKey, PublicKey, Reference, Span, Topic, TransactionId } from "./utils/typed-bytes.js";
 import { assertBeeUrl, stripLastSlash } from "./utils/url.js";
 /**
  * The main component that abstracts operations available on the main Bee API.
@@ -212,9 +214,6 @@ export class Bee {
   /**
    * Upload single file to a Bee node.
    *
-   * **To make sure that you won't lose critical data it is highly recommended to also
-   * locally pin the data with `options.pin = true`**
-   *
    * @param postageBatchId Postage BatchId to be used to upload the data with
    * @param data    Data or file to be uploaded
    * @param name    Optional name of the uploaded file
@@ -244,11 +243,6 @@ export class Bee {
         ...options
       };
       return bzz.uploadFile(this.getRequestOptionsForCall(requestOptions), fileData, postageBatchId, fileName, fileOptions);
-    } else if (isReadable(data) && options?.tag && !options.size) {
-      // TODO: Needed until https://github.com/ethersphere/bee/issues/2317 is resolved
-      const result = await bzz.uploadFile(this.getRequestOptionsForCall(requestOptions), data, postageBatchId, name, options);
-      await this.updateTag(options.tag, result.reference);
-      return result;
     } else {
       return bzz.uploadFile(this.getRequestOptionsForCall(requestOptions), data, postageBatchId, name, options);
     }
@@ -695,6 +689,62 @@ export class Bee {
       }
     });
   }
+  gsocMine(targetOverlay, identifier, proximity = 16) {
+    targetOverlay = new PeerAddress(targetOverlay);
+    identifier = new Identifier(identifier);
+    const start = 0xb33n;
+    for (let i = 0n; i < 0xffffn; i++) {
+      const signer = new PrivateKey(Binary.numberToUint256(start + i, 'BE'));
+      const socAddress = makeSOCAddress(identifier, signer.publicKey().address());
+      const actualProximity = 256 - Binary.proximity(socAddress.toUint8Array(), targetOverlay.toUint8Array(), 256);
+      if (actualProximity <= 256 - proximity) {
+        return signer;
+      }
+    }
+    throw Error('Could not mine a valid signer');
+  }
+  async gsocSend(postageBatchId, signer, identifier, data, options, requestOptions) {
+    postageBatchId = new BatchId(postageBatchId);
+    signer = new PrivateKey(signer);
+    identifier = new Identifier(identifier);
+    const cac = makeContentAddressedChunk(data);
+    const soc = makeSingleOwnerChunk(cac, identifier, signer);
+    return gsoc.send(this.getRequestOptionsForCall(requestOptions), soc, postageBatchId, options);
+  }
+  gsocSubscribe(address, identifier, handler) {
+    address = new EthAddress(address);
+    identifier = new Identifier(identifier);
+    assertGsocMessageHandler(handler);
+    const socAddress = makeSOCAddress(identifier, address);
+    const ws = gsoc.subscribe(this.url, socAddress, this.requestOptions.headers);
+    let cancelled = false;
+    const cancel = () => {
+      if (cancelled === false) {
+        cancelled = true;
+        if (ws.terminate) {
+          ws.terminate();
+        } else {
+          ws.close();
+        }
+      }
+    };
+    const subscription = {
+      address,
+      cancel
+    };
+    ws.onmessage = async event => {
+      const data = await prepareWebsocketData(event.data);
+      if (data.length) {
+        handler.onMessage(new Bytes(data), subscription);
+      }
+    };
+    ws.onerror = event => {
+      if (!cancelled) {
+        handler.onError(new BeeError(event.message), subscription);
+      }
+    };
+    return subscription;
+  }
   /**
    * Create feed manifest chunk and return the reference to it.
    *

package/dist/mjs/chunk/soc.js

@@ -58,7 +58,7 @@ export function makeSOCAddress(identifier, address) {
  * @param identifier  The identifier of the chunk
  * @param signer      The signer interface for signing the chunk
  */
-export async function makeSingleOwnerChunk(chunk, identifier, signer) {
+export function makeSingleOwnerChunk(chunk, identifier, signer) {
   identifier = new Identifier(identifier);
   signer = new PrivateKey(signer);
   const address = makeSOCAddress(identifier, signer.publicKey().address());
@@ -104,7 +104,7 @@ export async function uploadSingleOwnerChunkData(requestOptions, signer, stamp,
   signer = new PrivateKey(signer);
   identifier = new Identifier(identifier);
   const cac = makeContentAddressedChunk(data);
-  const soc = await makeSingleOwnerChunk(cac, identifier, signer);
+  const soc = makeSingleOwnerChunk(cac, identifier, signer);
   return uploadSingleOwnerChunk(requestOptions, soc, stamp, options);
 }
 /**

package/dist/mjs/index.js

@@ -7,5 +7,6 @@ export { Bytes } from "./utils/bytes.js";
 export * from "./utils/constants.js";
 export * from "./utils/error.js";
 export * as Utils from "./utils/expose.js";
+export * from "./utils/tokens.js";
 export * from "./utils/typed-bytes.js";
 export { Bee };

package/dist/mjs/manifest/manifest.js

@@ -28,6 +28,8 @@ export class Fork {
     b.prefix = b.prefix.slice(commonPart.length);
     node.forks.set(newAFork.prefix[0], newAFork);
     node.forks.set(newBFork.prefix[0], newBFork);
+    newAFork.node.parent = node;
+    newBFork.node.parent = node;
     return new Fork(commonPart, node);
   }
   marshal() {
@@ -76,6 +78,7 @@ export class MantarayNode {
     this.metadata = null;
     this.path = new Uint8Array(0);
     this.forks = new Map();
+    this.parent = null;
     if (options?.targetAddress) {
       this.targetAddress = options.targetAddress;
     }
@@ -91,6 +94,15 @@ export class MantarayNode {
     if (options?.path) {
       this.path = options.path;
     }
+    if (options?.parent) {
+      this.parent = options.parent;
+    }
+  }
+  get fullPath() {
+    return Binary.concatBytes(this.parent?.fullPath ?? new Uint8Array(0), this.path);
+  }
+  get fullPathString() {
+    return DECODER.decode(this.fullPath);
   }
   async marshal() {
     for (const fork of this.forks.values()) {
@@ -132,7 +144,9 @@ export class MantarayNode {
     const forkBitmap = reader.read(32);
     for (let i = 0; i < 256; i++) {
       if (Binary.getBit(forkBitmap, i, 'LE')) {
-        node.forks.set(i, Fork.unmarshal(reader));
+        const newFork = Fork.unmarshal(reader);
+        node.forks.set(i, newFork);
+        newFork.node.parent = node;
       }
     }
     return node;
@@ -164,10 +178,12 @@ export class MantarayNode {
       if (existing) {
         const fork = Fork.split(newFork, existing);
         tip.forks.set(remainingPath[0], fork);
+        fork.node.parent = tip;
         tip.selfAddress = null;
         tip = newFork.node;
       } else {
         tip.forks.set(remainingPath[0], newFork);
+        newFork.node.parent = tip;
         tip.selfAddress = null;
         tip = newFork.node;
       }

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

@@ -1,5 +1,6 @@
 import { Types } from 'cafe-utility';
 import { http } from "../../utils/http.js";
+import { BZZ } from "../../utils/tokens.js";
 import { asNumberString } from "../../utils/type.js";
 import { EthAddress, TransactionId } from "../../utils/typed-bytes.js";
 const chequebookEndpoint = 'chequebook';
@@ -36,12 +37,12 @@ export async function getChequebookBalance(requestOptions) {
     name: 'response.data'
   });
   return {
-    availableBalance: asNumberString(body.availableBalance, {
+    availableBalance: BZZ.fromPLUR(asNumberString(body.availableBalance, {
       name: 'availableBalance'
-    }),
-    totalBalance: asNumberString(body.totalBalance, {
+    })),
+    totalBalance: BZZ.fromPLUR(asNumberString(body.totalBalance, {
       name: 'totalBalance'
-    })
+    }))
   };
 }
 /**
@@ -62,9 +63,9 @@ export async function getLastCashoutAction(requestOptions, peer) {
     peer: Types.asString(body.peer, {
       name: 'peer'
     }),
-    uncashedAmount: asNumberString(body.uncashedAmount, {
+    uncashedAmount: BZZ.fromPLUR(asNumberString(body.uncashedAmount, {
       name: 'uncashedAmount'
-    }),
+    })),
     transactionHash: Types.asNullableString(body.transactionHash),
     lastCashedCheque: Types.asNullable(x => asCheque(x), body.lastCashedCheque),
     result: Types.asNullable(x => asCashoutResult(x), body.result)
@@ -159,9 +160,9 @@ function asCheque(x) {
     chequebook: new EthAddress(Types.asString(object.chequebook, {
       name: 'chequebook'
     })),
-    payout: asNumberString(object.payout, {
+    payout: BZZ.fromPLUR(asNumberString(object.payout, {
       name: 'payout'
-    })
+    }))
   };
 }
 function asCashoutResult(x) {
@@ -172,9 +173,9 @@ function asCashoutResult(x) {
     recipient: Types.asString(object.recipient, {
       name: 'recipient'
     }),
-    lastPayout: asNumberString(object.lastPayout, {
+    lastPayout: BZZ.fromPLUR(asNumberString(object.lastPayout, {
       name: 'lastPayout'
-    }),
+    })),
     bounced: Types.asBoolean(object.bounced, {
       name: 'bounced'
     })

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

@@ -1,6 +1,6 @@
 import { Types } from 'cafe-utility';
 import { http } from "../../utils/http.js";
-import { EthAddress, PublicKey } from "../../utils/typed-bytes.js";
+import { EthAddress, PeerAddress, PublicKey } from "../../utils/typed-bytes.js";
 export async function getNodeAddresses(requestOptions) {
   const response = await http(requestOptions, {
     url: 'addresses',
@@ -10,9 +10,9 @@ export async function getNodeAddresses(requestOptions) {
     name: 'response.data'
   });
   return {
-    overlay: Types.asString(body.overlay, {
+    overlay: new PeerAddress(Types.asString(body.overlay, {
       name: 'overlay'
-    }),
+    })),
     underlay: Types.asArray(body.underlay, {
       name: 'underlay'
     }).map(x => Types.asString(x, {

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

@@ -1,5 +1,6 @@
 import { Types } from 'cafe-utility';
 import { http } from "../../utils/http.js";
+import { BZZ } from "../../utils/tokens.js";
 import { asNumberString } from "../../utils/type.js";
 const settlementsEndpoint = 'settlements';
 /**
@@ -20,12 +21,12 @@ export async function getSettlements(requestOptions, peer) {
     peer: Types.asString(body.peer, {
       name: 'peer'
     }),
-    sent: asNumberString(body.sent, {
+    sent: BZZ.fromPLUR(asNumberString(body.sent, {
       name: 'sent'
-    }),
-    received: asNumberString(body.received, {
+    })),
+    received: BZZ.fromPLUR(asNumberString(body.received, {
       name: 'received'
-    })
+    }))
   };
 }
 /**
@@ -41,12 +42,12 @@ export async function getAllSettlements(requestOptions) {
   const body = Types.asObject(response.data, {
     name: 'response.data'
   });
-  const totalSent = asNumberString(body.totalSent, {
+  const totalSent = BZZ.fromPLUR(asNumberString(body.totalSent, {
     name: 'totalSent'
-  });
-  const totalReceived = asNumberString(body.totalReceived, {
+  }));
+  const totalReceived = BZZ.fromPLUR(asNumberString(body.totalReceived, {
     name: 'totalReceived'
-  });
+  }));
   const settlements = Types.asArray(body.settlements, {
     name: 'settlements'
   }).map(x => Types.asObject(x, {
@@ -59,12 +60,12 @@ export async function getAllSettlements(requestOptions) {
       peer: Types.asString(x.peer, {
         name: 'peer'
       }),
-      sent: asNumberString(x.sent, {
+      sent: BZZ.fromPLUR(asNumberString(x.sent, {
         name: 'sent'
-      }),
-      received: asNumberString(x.received, {
+      })),
+      received: BZZ.fromPLUR(asNumberString(x.received, {
         name: 'received'
-      })
+      }))
     }))
   };
 }

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

@@ -1,5 +1,6 @@
 import { Types } from 'cafe-utility';
 import { http } from "../../utils/http.js";
+import { BZZ, DAI } from "../../utils/tokens.js";
 import { asNumberString } from "../../utils/type.js";
 const STAKE_ENDPOINT = 'stake';
 const REDISTRIBUTION_ENDPOINT = 'redistributionstate';
@@ -17,9 +18,9 @@ export async function getStake(requestOptions) {
   const body = Types.asObject(response.data, {
     name: 'response.data'
   });
-  return asNumberString(body.stakedAmount, {
+  return BZZ.fromPLUR(asNumberString(body.stakedAmount, {
     name: 'stakedAmount'
-  });
+  }));
 }
 /**
  * Stake given amount of tokens.
@@ -58,9 +59,9 @@ export async function getRedistributionState(requestOptions) {
     name: 'response.data'
   });
   return {
-    minimumGasFunds: asNumberString(body.minimumGasFunds, {
+    minimumGasFunds: DAI.fromWei(asNumberString(body.minimumGasFunds, {
       name: 'minimumGasFunds'
-    }),
+    })),
     hasSufficientFunds: Types.asBoolean(body.hasSufficientFunds, {
       name: 'hasSufficientFunds'
     }),
@@ -94,12 +95,12 @@ export async function getRedistributionState(requestOptions) {
     block: Types.asNumber(body.block, {
       name: 'block'
     }),
-    reward: asNumberString(body.reward, {
+    reward: BZZ.fromPLUR(asNumberString(body.reward, {
       name: 'reward'
-    }),
-    fees: asNumberString(body.fees, {
+    })),
+    fees: DAI.fromWei(asNumberString(body.fees, {
       name: 'fees'
-    }),
+    })),
     isHealthy: Types.asBoolean(body.isHealthy, {
       name: 'isHealthy'
     })

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

@@ -1,5 +1,6 @@
 import { Types } from 'cafe-utility';
 import { http } from "../../utils/http.js";
+import { BZZ, DAI } from "../../utils/tokens.js";
 import { asNumberString } from "../../utils/type.js";
 const RESERVE_STATE_ENDPOINT = 'reservestate';
 const WALLET_ENDPOINT = 'wallet';
@@ -74,12 +75,12 @@ export async function getWalletBalance(requestOptions) {
     name: 'response.data'
   });
   return {
-    bzzBalance: asNumberString(body.bzzBalance, {
+    bzzBalance: BZZ.fromPLUR(asNumberString(body.bzzBalance, {
       name: 'bzzBalance'
-    }),
-    nativeTokenBalance: asNumberString(body.nativeTokenBalance, {
+    })),
+    nativeTokenBalance: DAI.fromWei(asNumberString(body.nativeTokenBalance, {
       name: 'nativeTokenBalance'
-    }),
+    })),
     chainID: Types.asNumber(body.chainID, {
       name: 'chainID'
     }),

package/dist/mjs/modules/gsoc.js

@@ -0,0 +1,12 @@
+import WebSocket from 'isomorphic-ws';
+import { uploadSingleOwnerChunk } from "../chunk/soc.js";
+const endpoint = 'gsoc';
+export async function send(requestOptions, soc, stamp, options) {
+  return uploadSingleOwnerChunk(requestOptions, soc, stamp, options);
+}
+export function subscribe(url, reference, headers) {
+  const wsUrl = url.replace(/^http/i, 'ws');
+  return new WebSocket(`${wsUrl}/${endpoint}/subscribe/${reference.toHex()}`, {
+    headers
+  });
+}

package/dist/mjs/utils/constants.js

@@ -2,4 +2,5 @@ import { BatchId, Topic } from "./typed-bytes.js";
 export const SWARM_GATEWAY_URL = 'https://api.gateway.ethswarm.org';
 export const NULL_STAMP = new BatchId('0000000000000000000000000000000000000000000000000000000000000000');
 export const NULL_TOPIC = new Topic('0000000000000000000000000000000000000000000000000000000000000000');
-export const NULL_ADDRESS = new Uint8Array(32);
+export const NULL_ADDRESS = new Uint8Array(32);
+export const NULL_IDENTIFIER = new Uint8Array(32);

package/dist/mjs/utils/expose.js

@@ -2,4 +2,4 @@ export { getCollectionSize } from "./collection.js";
 export { getFolderSize } from "./collection.node.js";
 export { makeMaxTarget } from "./pss.js";
 export { approximateOverheadForRedundancyLevel, getRedundancyStat, getRedundancyStats } from "./redundancy.js";
-export { getAmountForTtl, getDepthForCapacity, getStampCostInBzz, getStampCostInPlur, getStampEffectiveBytes, getStampMaximumCapacityBytes, getStampTtlSeconds, getStampUsage } from "./stamps.js";
+export { getAmountForTtl, getDepthForCapacity, getStampCost, getStampEffectiveBytes, getStampMaximumCapacityBytes, getStampTtlSeconds, getStampUsage } from "./stamps.js";

package/dist/mjs/utils/http.js

@@ -18,10 +18,10 @@ export const DEFAULT_HTTP_CONFIG = {
  * @param config Internal settings and/or Bee settings
  */
 export async function http(options, config) {
+  const requestConfig = Objects.deepMerge3(DEFAULT_HTTP_CONFIG, config, options);
   let failedAttempts = 0;
   while (failedAttempts < MAX_FAILED_ATTEMPTS) {
     try {
-      const requestConfig = Objects.deepMerge3(DEFAULT_HTTP_CONFIG, config, options);
       maybeRunOnRequestHook(options, requestConfig);
       const response = await axios(requestConfig);
       return response;

package/dist/mjs/utils/pss.js

@@ -1,5 +1,5 @@
-import { Types } from 'cafe-utility';
 import { PSS_TARGET_HEX_LENGTH_MAX } from "../types/index.js";
+import { PeerAddress } from "./typed-bytes.js";
 /**
  * Utility function that for given strings/reference takes the most specific
  * target that Bee node will except.
@@ -8,6 +8,6 @@ import { PSS_TARGET_HEX_LENGTH_MAX } from "../types/index.js";
  * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
  */
 export function makeMaxTarget(target) {
-  const hexString = Types.asHexString(target);
-  return hexString.slice(0, PSS_TARGET_HEX_LENGTH_MAX);
+  target = new PeerAddress(target);
+  return target.toHex().slice(0, PSS_TARGET_HEX_LENGTH_MAX);
 }

package/dist/mjs/utils/stamps.js

@@ -1,5 +1,6 @@
 import { Binary } from 'cafe-utility';
 import { Bytes } from "./bytes.js";
+import { BZZ } from "./tokens.js";
 import { asNumberString } from "./type.js";
 /**
  * Utility function that calculates usage of postage batch based on its utilization, depth and bucket depth.
@@ -56,23 +57,10 @@ export function getStampEffectiveBytes(depth) {
 }
 /**
  * Utility function that calculates the cost of a postage batch based on its depth and amount.
- *
- * @returns {number} The cost of the postage batch in PLUR (10000000000000000 [1e16] PLUR = 1 BZZ)
- */
-export function getStampCostInPlur(depth, amount) {
-  const amountBigint = BigInt(asNumberString(amount));
-  return 2n ** BigInt(depth) * amountBigint;
-}
-/**
- * Utility function that calculates the cost of a postage batch based on its depth and amount.
- *
- * The returned number is lossy and should be used for display purposes only.
- *
- * @returns {number} The cost of the postage batch in BZZ (1 BZZ = 10000000000000000 [1e16] PLUR)
  */
-export function getStampCostInBzz(depth, amount) {
-  const BZZ_UNIT = 10 ** 16;
-  return Number(getStampCostInPlur(depth, amount)) / BZZ_UNIT;
+export function getStampCost(depth, amount) {
+  const amountBigInt = BigInt(asNumberString(amount));
+  return BZZ.fromPLUR(2n ** BigInt(depth) * amountBigInt);
 }
 /**
  * Utility function that calculates the TTL of a postage batch based on its amount, price per block and block time.
@@ -82,8 +70,8 @@ export function getStampCostInBzz(depth, amount) {
  * @returns {number} The TTL of the postage batch in seconds.
  */
 export function getStampTtlSeconds(amount, pricePerBlock = 24000, blockTime = 5) {
-  const amountBigint = BigInt(asNumberString(amount));
-  return amountBigint * BigInt(blockTime) / BigInt(pricePerBlock);
+  const amountBigInt = BigInt(asNumberString(amount));
+  return amountBigInt * BigInt(blockTime) / BigInt(pricePerBlock);
 }
 /**
  * Utility function that calculates the amount of tokens required to maintain a given Time To Live (TTL) for a postage batch.

package/dist/mjs/utils/tokens.js

@@ -0,0 +1,43 @@
+import { FixedPointNumber } from 'cafe-utility';
+export class BZZ {
+  constructor(state) {
+    this.state = state;
+  }
+  static fromDecimalString(string) {
+    return new BZZ(FixedPointNumber.fromDecimalString(string, BZZ.DIGITS));
+  }
+  static fromPLUR(plur) {
+    return new BZZ(new FixedPointNumber(plur, BZZ.DIGITS));
+  }
+  toPLURString() {
+    return this.state.toString();
+  }
+  toPLURBigInt() {
+    return this.state.value;
+  }
+  toDecimalString() {
+    return this.state.toDecimalString();
+  }
+}
+BZZ.DIGITS = 16;
+export class DAI {
+  constructor(state) {
+    this.state = state;
+  }
+  static fromDecimalString(string) {
+    return new DAI(FixedPointNumber.fromDecimalString(string, DAI.DIGITS));
+  }
+  static fromWei(wei) {
+    return new DAI(new FixedPointNumber(wei, DAI.DIGITS));
+  }
+  toWeiString() {
+    return this.state.toString();
+  }
+  toWeiBigInt() {
+    return this.state.value;
+  }
+  toDecimalString() {
+    return this.state.toDecimalString();
+  }
+}
+DAI.DIGITS = 18;

package/dist/mjs/utils/type.js

@@ -97,16 +97,26 @@ export function isTag(value) {
   return Boolean(value.uid);
 }
 export function assertPssMessageHandler(value) {
-  if (!isStrictlyObject(value)) {
-    throw new TypeError('PssMessageHandler has to be object!');
-  }
-  const handler = value;
-  if (typeof handler.onMessage !== 'function') {
-    throw new TypeError('onMessage property of PssMessageHandler has to be function!');
-  }
-  if (typeof handler.onError !== 'function') {
-    throw new TypeError('onError property of PssMessageHandler has to be function!');
-  }
+  const object = Types.asObject(value, {
+    name: 'PssMessageHandler'
+  });
+  Types.asFunction(object.onMessage, {
+    name: 'onMessage'
+  });
+  Types.asFunction(object.onError, {
+    name: 'onError'
+  });
+}
+export function assertGsocMessageHandler(value) {
+  const object = Types.asObject(value, {
+    name: 'GsocMessageHandler'
+  });
+  Types.asFunction(object.onMessage, {
+    name: 'onMessage'
+  });
+  Types.asFunction(object.onError, {
+    name: 'onError'
+  });
 }
 export function assertPostageBatchOptions(value) {
   if (value === undefined) {

package/dist/types/bee.d.ts

@@ -1,10 +1,11 @@
 /// <reference types="node" />
 import { Readable } from 'stream';
 import { Chunk } from './chunk/cac';
-import type { AllSettlements, BalanceResponse, BeeOptions, BeeRequestOptions, BeeVersions, ChainState, ChequebookAddressResponse, ChequebookBalanceResponse, CollectionUploadOptions, DebugStatus, EnvelopeWithBatchId, FeedReader, FeedWriter, FileData, FileUploadOptions, GetGranteesResult, GlobalPostageBatch, GranteesResult, Health, LastCashoutActionResponse, LastChequesForPeerResponse, LastChequesResponse, NodeAddresses, NodeInfo, NumberString, Peer, PeerBalance, Pin, PingResponse, PostageBatch, PostageBatchBuckets, PssMessageHandler, PssSubscription, Readiness, RedistributionState, ReferenceInformation, RemovePeerResponse, ReserveState, SOCReader, SOCWriter, Settlements, Tag, Topology, TransactionInfo, UploadOptions, UploadRedundancyOptions, WalletBalance } from './types';
+import type { AllSettlements, BalanceResponse, BeeOptions, BeeRequestOptions, BeeVersions, ChainState, ChequebookAddressResponse, ChequebookBalanceResponse, CollectionUploadOptions, DebugStatus, EnvelopeWithBatchId, FeedReader, FeedWriter, FileData, FileUploadOptions, GetGranteesResult, GlobalPostageBatch, GranteesResult, GsocMessageHandler, GsocSubscription, Health, LastCashoutActionResponse, LastChequesForPeerResponse, LastChequesResponse, NodeAddresses, NodeInfo, NumberString, Peer, PeerBalance, Pin, PingResponse, PostageBatch, PostageBatchBuckets, PssMessageHandler, PssSubscription, Readiness, RedistributionState, ReferenceInformation, RemovePeerResponse, ReserveState, SOCReader, SOCWriter, Settlements, Tag, Topology, TransactionInfo, UploadOptions, UploadRedundancyOptions, WalletBalance } from './types';
 import { AllTagsOptions, CashoutOptions, Collection, PostageBatchOptions, TransactionOptions, UploadResult } from './types';
 import { Bytes } from './utils/bytes';
-import { BatchId, EthAddress, FeedIndex, PeerAddress, PrivateKey, PublicKey, Reference, Topic, TransactionId } from './utils/typed-bytes';
+import { BZZ } from './utils/tokens';
+import { BatchId, EthAddress, FeedIndex, Identifier, PeerAddress, PrivateKey, PublicKey, Reference, Topic, TransactionId } from './utils/typed-bytes';
 import { UploadProgress } from './utils/upload-progress';
 /**
  * The main component that abstracts operations available on the main Bee API.
@@ -130,9 +131,6 @@ export declare class Bee {
     /**
      * Upload single file to a Bee node.
      *
-     * **To make sure that you won't lose critical data it is highly recommended to also
-     * locally pin the data with `options.pin = true`**
-     *
      * @param postageBatchId Postage BatchId to be used to upload the data with
      * @param data    Data or file to be uploaded
      * @param name    Optional name of the uploaded file
@@ -419,6 +417,9 @@ export declare class Bee {
      * @see [Bee API reference - `GET /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1{topic}/get)
      */
     pssReceive(topic: Topic, timeoutMsec?: number): Promise<Bytes>;
+    gsocMine(targetOverlay: PeerAddress | Uint8Array | string, identifier: Identifier | Uint8Array | string, proximity?: number): PrivateKey;
+    gsocSend(postageBatchId: BatchId | Uint8Array | string, signer: PrivateKey | Uint8Array | string, identifier: Identifier | Uint8Array | string, data: string | Uint8Array, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    gsocSubscribe(address: EthAddress | Uint8Array | string, identifier: Identifier | Uint8Array | string, handler: GsocMessageHandler): GsocSubscription;
     /**
      * Create feed manifest chunk and return the reference to it.
      *
@@ -734,7 +735,7 @@ export declare class Bee {
      *
      * @param options
      */
-    getStake(options?: BeeRequestOptions): Promise<NumberString>;
+    getStake(options?: BeeRequestOptions): Promise<BZZ>;
     /**
      * Deposits given amount of BZZ token (in PLUR unit).
      *

package/dist/types/chunk/soc.d.ts

@@ -32,7 +32,7 @@ export declare function makeSOCAddress(identifier: Identifier, address: EthAddre
  * @param identifier  The identifier of the chunk
  * @param signer      The signer interface for signing the chunk
  */
-export declare function makeSingleOwnerChunk(chunk: Chunk, identifier: Identifier | Uint8Array | string, signer: PrivateKey | Uint8Array | string): Promise<SingleOwnerChunk>;
+export declare function makeSingleOwnerChunk(chunk: Chunk, identifier: Identifier | Uint8Array | string, signer: PrivateKey | Uint8Array | string): SingleOwnerChunk;
 /**
  * Helper function to upload a chunk.
  *

package/dist/types/index.d.ts

@@ -7,6 +7,7 @@ export { Bytes } from './utils/bytes';
 export * from './utils/constants';
 export * from './utils/error';
 export * as Utils from './utils/expose';
+export * from './utils/tokens';
 export * from './utils/typed-bytes';
 export { Bee };
 declare global {