Skip to content

Commit dc43c12

Browse files
feat: updated api docs to bee-js v0.7.0 (#49)
1 parent 058cb3d commit dc43c12

File tree

119 files changed

+2205
-436
lines changed

Some content is hidden

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

119 files changed

+2205
-436
lines changed

bee-js

Submodule bee-js updated 66 files

docs/api/classes/bee.md

Lines changed: 127 additions & 92 deletions
Large diffs are not rendered by default.

docs/api/classes/beeargumenterror.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Name | Type |
3131

3232
Inherited from: [BeeError](beeerror.md)
3333

34-
Defined in: [bee-js/src/utils/error.ts:7](https://github.com/ethersphere/bee-js/blob/7dfd556/src/utils/error.ts#L7)
34+
Defined in: [bee-js/src/utils/error.ts:7](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/utils/error.ts#L7)
3535

3636
## Properties
3737

docs/api/classes/beedebug.md

Lines changed: 110 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,16 @@ Name | Type |
2626

2727
**Returns:** [*BeeDebug*](beedebug.md)
2828

29-
Defined in: [bee-js/src/bee-debug.ts:28](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L28)
29+
Defined in: [bee-js/src/bee-debug.ts:36](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L36)
3030

3131
## Properties
3232

3333
### url
3434

3535
`Readonly` **url**: *string*
3636

37+
Defined in: [bee-js/src/bee-debug.ts:36](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L36)
38+
3739
## Methods
3840

3941
### cashoutLastCheque
@@ -50,25 +52,25 @@ Name | Type | Description |
5052

5153
**Returns:** *Promise*<[*CashoutResponse*](../interfaces/cashoutresponse.md)\>
5254

53-
Defined in: [bee-js/src/bee-debug.ts:134](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L134)
55+
Defined in: [bee-js/src/bee-debug.ts:161](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L161)
5456

5557
___
5658

5759
### depositTokens
5860

59-
**depositTokens**(`amount`: *number*): *Promise*<[*DepositTokensResponse*](../interfaces/deposittokensresponse.md)\>
61+
**depositTokens**(`amount`: *number* \| BigInt): *Promise*<[*DepositTokensResponse*](../interfaces/deposittokensresponse.md)\>
6062

6163
Deposit tokens from overlay address into chequebook
6264

6365
#### Parameters:
6466

6567
Name | Type | Description |
6668
:------ | :------ | :------ |
67-
`amount` | *number* | Amount of tokens to deposit |
69+
`amount` | *number* \| BigInt | Amount of tokens to deposit (must be positive integer) |
6870

6971
**Returns:** *Promise*<[*DepositTokensResponse*](../interfaces/deposittokensresponse.md)\>
7072

71-
Defined in: [bee-js/src/bee-debug.ts:143](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L143)
73+
Defined in: [bee-js/src/bee-debug.ts:170](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L170)
7274

7375
___
7476

@@ -80,7 +82,7 @@ Get the balances with all known peers including prepaid services
8082

8183
**Returns:** *Promise*<[*BalanceResponse*](../interfaces/balanceresponse.md)\>
8284

83-
Defined in: [bee-js/src/bee-debug.ts:57](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L57)
85+
Defined in: [bee-js/src/bee-debug.ts:81](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L81)
8486

8587
___
8688

@@ -92,31 +94,56 @@ Get settlements with all known peers and total amount sent or received
9294

9395
**Returns:** *Promise*<[*AllSettlements*](../interfaces/allsettlements.md)\>
9496

95-
Defined in: [bee-js/src/bee-debug.ts:172](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L172)
97+
Defined in: [bee-js/src/bee-debug.ts:207](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L207)
98+
99+
___
100+
101+
### getBlocklist
102+
103+
**getBlocklist**(): *Promise*<[*Peer*](../interfaces/peer.md)[]\>
104+
105+
**Returns:** *Promise*<[*Peer*](../interfaces/peer.md)[]\>
106+
107+
Defined in: [bee-js/src/bee-debug.ts:51](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L51)
96108

97109
___
98110

99111
### getChequebookAddress
100112

101113
**getChequebookAddress**(): *Promise*<[*ChequebookAddressResponse*](../interfaces/chequebookaddressresponse.md)\>
102114

103-
Get the address of the chequebook contract used
115+
Get the address of the chequebook contract used.
116+
117+
**Warning:** The address is returned with 0x prefix unlike all other calls.
118+
https://github.com/ethersphere/bee/issues/1443
104119

105120
**Returns:** *Promise*<[*ChequebookAddressResponse*](../interfaces/chequebookaddressresponse.md)\>
106121

107-
Defined in: [bee-js/src/bee-debug.ts:93](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L93)
122+
Defined in: [bee-js/src/bee-debug.ts:120](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L120)
108123

109124
___
110125

111-
### getChequeubookBalance
126+
### getChequebookBalance
112127

113-
**getChequeubookBalance**(): *Promise*<[*ChequebookBalanceResponse*](../interfaces/chequebookbalanceresponse.md)\>
128+
**getChequebookBalance**(): *Promise*<[*ChequebookBalanceResponse*](../interfaces/chequebookbalanceresponse.md)\>
114129

115130
Get the balance of the chequebook
116131

117132
**Returns:** *Promise*<[*ChequebookBalanceResponse*](../interfaces/chequebookbalanceresponse.md)\>
118133

119-
Defined in: [bee-js/src/bee-debug.ts:100](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L100)
134+
Defined in: [bee-js/src/bee-debug.ts:127](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L127)
135+
136+
___
137+
138+
### getHealth
139+
140+
**getHealth**(): *Promise*<[*Health*](../interfaces/health.md)\>
141+
142+
Get health of node
143+
144+
**Returns:** *Promise*<[*Health*](../interfaces/health.md)\>
145+
146+
Defined in: [bee-js/src/bee-debug.ts:214](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L214)
120147

121148
___
122149

@@ -134,7 +161,7 @@ Name | Type | Description |
134161

135162
**Returns:** *Promise*<[*LastCashoutActionResponse*](../interfaces/lastcashoutactionresponse.md)\>
136163

137-
Defined in: [bee-js/src/bee-debug.ts:125](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L125)
164+
Defined in: [bee-js/src/bee-debug.ts:152](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L152)
138165

139166
___
140167

@@ -146,7 +173,7 @@ Get last cheques for all peers
146173

147174
**Returns:** *Promise*<[*LastChequesResponse*](../interfaces/lastchequesresponse.md)\>
148175

149-
Defined in: [bee-js/src/bee-debug.ts:107](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L107)
176+
Defined in: [bee-js/src/bee-debug.ts:134](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L134)
150177

151178
___
152179

@@ -164,17 +191,17 @@ Name | Type | Description |
164191

165192
**Returns:** *Promise*<[*LastChequesForPeerResponse*](../interfaces/lastchequesforpeerresponse.md)\>
166193

167-
Defined in: [bee-js/src/bee-debug.ts:116](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L116)
194+
Defined in: [bee-js/src/bee-debug.ts:143](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L143)
168195

169196
___
170197

171-
### getOverlayAddress
198+
### getNodeAddresses
172199

173-
**getOverlayAddress**(): *Promise*<string\>
200+
**getNodeAddresses**(): *Promise*<[*NodeAddresses*](../interfaces/nodeaddresses.md)\>
174201

175-
**Returns:** *Promise*<string\>
202+
**Returns:** *Promise*<[*NodeAddresses*](../interfaces/nodeaddresses.md)\>
176203

177-
Defined in: [bee-js/src/bee-debug.ts:31](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L31)
204+
Defined in: [bee-js/src/bee-debug.ts:47](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L47)
178205

179206
___
180207

@@ -186,7 +213,7 @@ Get the past due consumption balances with all known peers
186213

187214
**Returns:** *Promise*<[*BalanceResponse*](../interfaces/balanceresponse.md)\>
188215

189-
Defined in: [bee-js/src/bee-debug.ts:73](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L73)
216+
Defined in: [bee-js/src/bee-debug.ts:97](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L97)
190217

191218
___
192219

@@ -204,7 +231,7 @@ Name | Type | Description |
204231

205232
**Returns:** *Promise*<[*PeerBalance*](../interfaces/peerbalance.md)\>
206233

207-
Defined in: [bee-js/src/bee-debug.ts:82](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L82)
234+
Defined in: [bee-js/src/bee-debug.ts:106](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L106)
208235

209236
___
210237

@@ -222,7 +249,7 @@ Name | Type | Description |
222249

223250
**Returns:** *Promise*<[*PeerBalance*](../interfaces/peerbalance.md)\>
224251

225-
Defined in: [bee-js/src/bee-debug.ts:66](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L66)
252+
Defined in: [bee-js/src/bee-debug.ts:90](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L90)
226253

227254
___
228255

@@ -234,17 +261,7 @@ Get list of peers for this node
234261

235262
**Returns:** *Promise*<[*Peer*](../interfaces/peer.md)[]\>
236263

237-
Defined in: [bee-js/src/bee-debug.ts:46](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L46)
238-
239-
___
240-
241-
### getPssPublicKey
242-
243-
**getPssPublicKey**(): *Promise*<string\>
244-
245-
**Returns:** *Promise*<string\>
246-
247-
Defined in: [bee-js/src/bee-debug.ts:37](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L37)
264+
Defined in: [bee-js/src/bee-debug.ts:58](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L58)
248265

249266
___
250267

@@ -262,22 +279,78 @@ Name | Type | Description |
262279

263280
**Returns:** *Promise*<[*Settlements*](../interfaces/settlements.md)\>
264281

265-
Defined in: [bee-js/src/bee-debug.ts:165](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L165)
282+
Defined in: [bee-js/src/bee-debug.ts:200](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L200)
283+
284+
___
285+
286+
### getTopology
287+
288+
**getTopology**(): *Promise*<[*Topology*](../interfaces/topology.md)\>
289+
290+
**Returns:** *Promise*<[*Topology*](../interfaces/topology.md)\>
291+
292+
Defined in: [bee-js/src/bee-debug.ts:66](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L66)
293+
294+
___
295+
296+
### isSupportedVersion
297+
298+
**isSupportedVersion**(): *Promise*<boolean\>
299+
300+
Connnects to a node and checks if it is a supported Bee version by the bee-js
301+
302+
**Returns:** *Promise*<boolean\>
303+
304+
true if the Bee node version is supported
305+
306+
Defined in: [bee-js/src/bee-debug.ts:223](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L223)
307+
308+
___
309+
310+
### pingPeer
311+
312+
**pingPeer**(`peer`: *string*): *Promise*<[*PingResponse*](../interfaces/pingresponse.md)\>
313+
314+
#### Parameters:
315+
316+
Name | Type |
317+
:------ | :------ |
318+
`peer` | *string* |
319+
320+
**Returns:** *Promise*<[*PingResponse*](../interfaces/pingresponse.md)\>
321+
322+
Defined in: [bee-js/src/bee-debug.ts:70](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L70)
323+
324+
___
325+
326+
### removePeer
327+
328+
**removePeer**(`peer`: *string*): *Promise*<[*RemovePeerResponse*](../interfaces/removepeerresponse.md)\>
329+
330+
#### Parameters:
331+
332+
Name | Type |
333+
:------ | :------ |
334+
`peer` | *string* |
335+
336+
**Returns:** *Promise*<[*RemovePeerResponse*](../interfaces/removepeerresponse.md)\>
337+
338+
Defined in: [bee-js/src/bee-debug.ts:62](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L62)
266339

267340
___
268341

269342
### withdrawTokens
270343

271-
**withdrawTokens**(`amount`: *number*): *Promise*<[*WithdrawTokensResponse*](../interfaces/withdrawtokensresponse.md)\>
344+
**withdrawTokens**(`amount`: *number* \| BigInt): *Promise*<[*WithdrawTokensResponse*](../interfaces/withdrawtokensresponse.md)\>
272345

273346
Withdraw tokens from the chequebook to the overlay address
274347

275348
#### Parameters:
276349

277350
Name | Type | Description |
278351
:------ | :------ | :------ |
279-
`amount` | *number* | Amount of tokens to withdraw |
352+
`amount` | *number* \| BigInt | Amount of tokens to withdraw (must be positive integer) |
280353

281354
**Returns:** *Promise*<[*WithdrawTokensResponse*](../interfaces/withdrawtokensresponse.md)\>
282355

283-
Defined in: [bee-js/src/bee-debug.ts:152](https://github.com/ethersphere/bee-js/blob/7dfd556/src/bee-debug.ts#L152)
356+
Defined in: [bee-js/src/bee-debug.ts:183](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/bee-debug.ts#L183)

docs/api/classes/beeerror.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Name | Type |
3434

3535
**Returns:** [*BeeError*](beeerror.md)
3636

37-
Defined in: [bee-js/src/utils/error.ts:1](https://github.com/ethersphere/bee-js/blob/7dfd556/src/utils/error.ts#L1)
37+
Defined in: [bee-js/src/utils/error.ts:1](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/utils/error.ts#L1)
3838

3939
## Properties
4040

docs/api/classes/beerequesterror.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Name | Type |
3030

3131
Inherited from: [BeeError](beeerror.md)
3232

33-
Defined in: [bee-js/src/utils/error.ts:13](https://github.com/ethersphere/bee-js/blob/7dfd556/src/utils/error.ts#L13)
33+
Defined in: [bee-js/src/utils/error.ts:13](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/utils/error.ts#L13)
3434

3535
## Properties
3636

docs/api/classes/beeresponseerror.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Name | Type |
3131

3232
Inherited from: [BeeError](beeerror.md)
3333

34-
Defined in: [bee-js/src/utils/error.ts:19](https://github.com/ethersphere/bee-js/blob/7dfd556/src/utils/error.ts#L19)
34+
Defined in: [bee-js/src/utils/error.ts:19](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/utils/error.ts#L19)
3535

3636
## Properties
3737

docs/api/functions/utils.bytes.bytesatoffset.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,4 +30,4 @@ Name | Type | Description |
3030

3131
**Returns:** [*Bytes*](../interfaces/utils.bytes.bytes.md)<Length\>
3232

33-
Defined in: [bee-js/src/utils/bytes.ts:88](https://github.com/ethersphere/bee-js/blob/7dfd556/src/utils/bytes.ts#L88)
33+
Defined in: [bee-js/src/utils/bytes.ts:91](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/utils/bytes.ts#L91)

docs/api/functions/utils.bytes.bytesequal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,4 +23,4 @@ Name | Type | Description |
2323

2424
**Returns:** *boolean*
2525

26-
Defined in: [bee-js/src/utils/bytes.ts:115](https://github.com/ethersphere/bee-js/blob/7dfd556/src/utils/bytes.ts#L115)
26+
Defined in: [bee-js/src/utils/bytes.ts:118](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/utils/bytes.ts#L118)

docs/api/functions/utils.bytes.flexbytesatoffset.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,4 +32,4 @@ Name | Type | Description |
3232

3333
**Returns:** [*FlexBytes*](../interfaces/utils.bytes.flexbytes.md)<Min, Max\>
3434

35-
Defined in: [bee-js/src/utils/bytes.ts:100](https://github.com/ethersphere/bee-js/blob/7dfd556/src/utils/bytes.ts#L100)
35+
Defined in: [bee-js/src/utils/bytes.ts:103](https://github.com/ethersphere/bee-js/blob/0ac3a7d/src/utils/bytes.ts#L103)

0 commit comments

Comments
 (0)