feat: add rchash method (#1035)

Author: Cafe137

src/bee.ts

@@ -22,6 +22,7 @@ import * as grantee from './modules/grantee'
 import * as gsoc from './modules/gsoc'
 import * as pinning from './modules/pinning'
 import * as pss from './modules/pss'
+import { rchash } from './modules/rchash'
 import * as status from './modules/status'
 import * as stewardship from './modules/stewardship'
 import * as tag from './modules/tag'
@@ -1248,6 +1249,13 @@ export class Bee {
     return postEnvelope(this.getRequestOptionsForCall(options), postageBatchId, reference)
   }
 
+  /**
+   * Get reserve commitment hash duration seconds
+   */
+  async rchash(depth: number, anchor1: string, anchor2: string, options?: BeeRequestOptions): Promise<number> {
+    return rchash(this.getRequestOptionsForCall(options), depth, anchor1, anchor2)
+  }
+
   /**
    * Ping the Bee node to see if there is a live Bee node on the given URL.
    *

src/modules/rchash.ts

@@ -0,0 +1,21 @@
+import { Types } from 'cafe-utility'
+import type { BeeRequestOptions } from '../types'
+import { http } from '../utils/http'
+
+const RCHASH_ENDPOINT = 'rchash'
+
+export async function rchash(
+  requestOptions: BeeRequestOptions,
+  depth: number,
+  anchor1: string,
+  anchor2: string,
+): Promise<number> {
+  const response = await http<unknown>(requestOptions, {
+    responseType: 'json',
+    url: `${RCHASH_ENDPOINT}/${depth}/${anchor1}/${anchor2}`,
+  })
+
+  const body = Types.asObject(response.data, { name: 'response.data' })
+
+  return Types.asNumber(body.durationSeconds, { name: 'durationSeconds' })
+}

test/integration/rchash.spec.ts

@@ -0,0 +1,8 @@
+import { makeBee } from '../utils'
+
+test('GET rchash', async () => {
+  const bee = makeBee()
+  const durationSeconds = await bee.rchash(15, '0bab', '0bab')
+  expect(durationSeconds).toBeGreaterThan(1)
+  expect(durationSeconds).toBeLessThan(60)
+})