Skip to content

Commit 5aa6ace

Browse files
authored
feat: bee-js 1.2.1 api reference (#73)
1 parent 6976944 commit 5aa6ace

File tree

143 files changed

+863
-308
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

143 files changed

+863
-308
lines changed

docs/api/classes/bee.md

Lines changed: 43 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ For example gateway mode and light node mode has only limited set of endpoints e
2626

2727
#### Defined in
2828

29-
[bee-js/src/bee.ts:85](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L85)
29+
[bee-js/src/bee.ts:86](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L86)
3030

3131
## Properties
3232

@@ -38,7 +38,7 @@ Default Signer object used for signing operations, mainly Feeds.
3838

3939
#### Defined in
4040

41-
[bee-js/src/bee.ts:85](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L85)
41+
[bee-js/src/bee.ts:86](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L86)
4242

4343
___
4444

@@ -50,7 +50,7 @@ URL on which is the main API of Bee node exposed
5050

5151
#### Defined in
5252

53-
[bee-js/src/bee.ts:80](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L80)
53+
[bee-js/src/bee.ts:81](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L81)
5454

5555
## Methods
5656

@@ -68,7 +68,7 @@ Ping the Bee node to see if there is a live Bee node on the given URL.
6868

6969
#### Defined in
7070

71-
[bee-js/src/bee.ts:902](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L902)
71+
[bee-js/src/bee.ts:906](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L906)
7272

7373
___
7474

@@ -99,7 +99,7 @@ Feed manifest chunk allows for a feed to be able to be resolved through `/bzz` e
9999

100100
#### Defined in
101101

102-
[bee-js/src/bee.ts:644](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L644)
102+
[bee-js/src/bee.ts:645](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L645)
103103

104104
___
105105

@@ -123,6 +123,8 @@ For better understanding what each parameter means and what are the optimal valu
123123

124124
**`see`** [Bee API reference - `POST /stamps`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1{amount}~1{depth}/post)
125125

126+
**`deprecated`** Use DebugBee for postage batch management
127+
126128
#### Parameters
127129

128130
| Name | Type | Description |
@@ -137,7 +139,7 @@ For better understanding what each parameter means and what are the optimal valu
137139

138140
#### Defined in
139141

140-
[bee-js/src/bee.ts:846](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L846)
142+
[bee-js/src/bee.ts:848](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L848)
141143

142144
___
143145

@@ -159,7 +161,7 @@ Create a new Tag which is meant for tracking progres of syncing data across netw
159161

160162
#### Defined in
161163

162-
[bee-js/src/bee.ts:296](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L296)
164+
[bee-js/src/bee.ts:297](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L297)
163165

164166
___
165167

@@ -191,7 +193,7 @@ Delete Tag
191193

192194
#### Defined in
193195

194-
[bee-js/src/bee.ts:350](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L350)
196+
[bee-js/src/bee.ts:351](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L351)
195197

196198
___
197199

@@ -217,7 +219,7 @@ Download data as a byte array
217219

218220
#### Defined in
219221

220-
[bee-js/src/bee.ts:135](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L135)
222+
[bee-js/src/bee.ts:136](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L136)
221223

222224
___
223225

@@ -246,7 +248,7 @@ Download single file.
246248

247249
#### Defined in
248250

249-
[bee-js/src/bee.ts:214](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L214)
251+
[bee-js/src/bee.ts:215](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L215)
250252

251253
___
252254

@@ -273,7 +275,7 @@ Download data as a Readable stream
273275

274276
#### Defined in
275277

276-
[bee-js/src/bee.ts:149](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L149)
278+
[bee-js/src/bee.ts:150](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L150)
277279

278280
___
279281

@@ -300,7 +302,7 @@ Download single file as a readable stream
300302

301303
#### Defined in
302304

303-
[bee-js/src/bee.ts:229](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L229)
305+
[bee-js/src/bee.ts:230](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L230)
304306

305307
___
306308

@@ -320,7 +322,7 @@ Get list of all locally pinned references
320322

321323
#### Defined in
322324

323-
[bee-js/src/bee.ts:418](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L418)
325+
[bee-js/src/bee.ts:419](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L419)
324326

325327
___
326328

@@ -336,13 +338,15 @@ Return all postage batches that has the node available.
336338

337339
**`see`** [Bee API reference - `GET /stamps`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps/get)
338340

341+
**`deprecated`** Use DebugBee for postage batch management
342+
339343
#### Returns
340344

341345
`Promise`<[`PostageBatch`](../interfaces/postagebatch.md)[]\>
342346

343347
#### Defined in
344348

345-
[bee-js/src/bee.ts:893](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L893)
349+
[bee-js/src/bee.ts:897](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L897)
346350

347351
___
348352

@@ -376,7 +380,7 @@ The listing is limited by options.limit. So you have to iterate using options.of
376380

377381
#### Defined in
378382

379-
[bee-js/src/bee.ts:314](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L314)
383+
[bee-js/src/bee.ts:315](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L315)
380384

381385
___
382386

@@ -415,7 +419,7 @@ At least one of these has to be specified!
415419

416420
#### Defined in
417421

418-
[bee-js/src/bee.ts:755](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L755)
422+
[bee-js/src/bee.ts:756](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L756)
419423

420424
___
421425

@@ -443,7 +447,7 @@ Get pinning status of chunk with given reference
443447

444448
#### Defined in
445449

446-
[bee-js/src/bee.ts:432](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L432)
450+
[bee-js/src/bee.ts:433](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L433)
447451

448452
___
449453

@@ -459,6 +463,8 @@ Return details for specific postage batch.
459463

460464
**`see`** [Bee API reference - `GET /stamps/${id}`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps~1{id}/get)
461465

466+
**`deprecated`** Use DebugBee for postage batch management
467+
462468
#### Parameters
463469

464470
| Name | Type | Description |
@@ -471,7 +477,7 @@ Return details for specific postage batch.
471477

472478
#### Defined in
473479

474-
[bee-js/src/bee.ts:879](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L879)
480+
[bee-js/src/bee.ts:882](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L882)
475481

476482
___
477483

@@ -489,7 +495,7 @@ true if successful, false on error
489495

490496
#### Defined in
491497

492-
[bee-js/src/bee.ts:911](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L911)
498+
[bee-js/src/bee.ts:915](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L915)
493499

494500
___
495501

@@ -515,7 +521,7 @@ Make a new feed reader for downloading feed updates.
515521

516522
#### Defined in
517523

518-
[bee-js/src/bee.ts:668](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L668)
524+
[bee-js/src/bee.ts:669](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L669)
519525

520526
___
521527

@@ -540,7 +546,7 @@ hashes the input string to create a topic string of arbitrary length.
540546

541547
#### Defined in
542548

543-
[bee-js/src/bee.ts:792](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L792)
549+
[bee-js/src/bee.ts:793](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L793)
544550

545551
___
546552

@@ -566,7 +572,7 @@ Make a new feed writer for updating feeds
566572

567573
#### Defined in
568574

569-
[bee-js/src/bee.ts:690](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L690)
575+
[bee-js/src/bee.ts:691](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L691)
570576

571577
___
572578

@@ -590,7 +596,7 @@ Returns an object for reading single owner chunks
590596

591597
#### Defined in
592598

593-
[bee-js/src/bee.ts:803](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L803)
599+
[bee-js/src/bee.ts:804](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L804)
594600

595601
___
596602

@@ -614,7 +620,7 @@ Returns an object for reading and writing single owner chunks
614620

615621
#### Defined in
616622

617-
[bee-js/src/bee.ts:818](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L818)
623+
[bee-js/src/bee.ts:819](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L819)
618624

619625
___
620626

@@ -642,7 +648,7 @@ Pin local data with given reference
642648

643649
#### Defined in
644650

645-
[bee-js/src/bee.ts:389](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L389)
651+
[bee-js/src/bee.ts:390](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L390)
646652

647653
___
648654

@@ -686,7 +692,7 @@ Message in byte array
686692

687693
#### Defined in
688694

689-
[bee-js/src/bee.ts:596](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L596)
695+
[bee-js/src/bee.ts:597](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L597)
690696

691697
___
692698

@@ -728,7 +734,7 @@ This is because light nodes does not fully participate in the data exchange in S
728734

729735
#### Defined in
730736

731-
[bee-js/src/bee.ts:485](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L485)
737+
[bee-js/src/bee.ts:486](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L486)
732738

733739
___
734740

@@ -762,7 +768,7 @@ Subscription to a given topic
762768

763769
#### Defined in
764770

765-
[bee-js/src/bee.ts:525](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L525)
771+
[bee-js/src/bee.ts:526](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L526)
766772

767773
___
768774

@@ -792,7 +798,7 @@ Retrieve tag information from Bee node
792798

793799
#### Defined in
794800

795-
[bee-js/src/bee.ts:332](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L332)
801+
[bee-js/src/bee.ts:333](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L333)
796802

797803
___
798804

@@ -819,7 +825,7 @@ Instructs the Bee node to reupload a locally pinned data into the network.
819825

820826
#### Defined in
821827

822-
[bee-js/src/bee.ts:446](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L446)
828+
[bee-js/src/bee.ts:447](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L447)
823829

824830
___
825831

@@ -858,7 +864,7 @@ If none of those two is set error is thrown.
858864

859865
#### Defined in
860866

861-
[bee-js/src/bee.ts:721](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L721)
867+
[bee-js/src/bee.ts:722](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L722)
862868

863869
___
864870

@@ -886,7 +892,7 @@ Unpin local data with given reference
886892

887893
#### Defined in
888894

889-
[bee-js/src/bee.ts:405](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L405)
895+
[bee-js/src/bee.ts:406](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L406)
890896

891897
___
892898

@@ -922,7 +928,7 @@ you can use this method to update the total chunks count for the tag.
922928

923929
#### Defined in
924930

925-
[bee-js/src/bee.ts:372](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L372)
931+
[bee-js/src/bee.ts:373](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L373)
926932

927933
___
928934

@@ -952,7 +958,7 @@ reference is a content hash of the data
952958

953959
#### Defined in
954960

955-
[bee-js/src/bee.ts:115](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L115)
961+
[bee-js/src/bee.ts:116](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L116)
956962

957963
___
958964

@@ -988,7 +994,7 @@ reference is a content hash of the file
988994

989995
#### Defined in
990996

991-
[bee-js/src/bee.ts:171](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L171)
997+
[bee-js/src/bee.ts:172](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L172)
992998

993999
___
9941000

@@ -1020,7 +1026,7 @@ Uses the FileList API from the browser.
10201026

10211027
#### Defined in
10221028

1023-
[bee-js/src/bee.ts:248](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L248)
1029+
[bee-js/src/bee.ts:249](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L249)
10241030

10251031
___
10261032

@@ -1052,4 +1058,4 @@ Available only in Node.js as it uses the `fs` module.
10521058

10531059
#### Defined in
10541060

1055-
[bee-js/src/bee.ts:275](https://github.com/ethersphere/bee-js/blob/6f227e1/src/bee.ts#L275)
1061+
[bee-js/src/bee.ts:276](https://github.com/ethersphere/bee-js/blob/74056cb/src/bee.ts#L276)

docs/api/classes/beeargumenterror.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ custom_edit_url: null
3131

3232
#### Defined in
3333

34-
[bee-js/src/utils/error.ts:7](https://github.com/ethersphere/bee-js/blob/6f227e1/src/utils/error.ts#L7)
34+
[bee-js/src/utils/error.ts:7](https://github.com/ethersphere/bee-js/blob/74056cb/src/utils/error.ts#L7)
3535

3636
## Properties
3737

0 commit comments

Comments
 (0)