Skip to content

Commit 5769d14

Browse files
committed
Merge branch 'flyover-2.2.0' into flyover-patch-sync
2 parents 41a07c4 + 9c85eeb commit 5769d14

Some content is hidden

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

44 files changed

+2558
-1180
lines changed

docs/Home.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
# Flyover SDK
44
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/rsksmart/flyover-sdk/badge)](https://scorecard.dev/viewer/?uri=github.com/rsksmart/flyover-sdk)
55
[![CodeQL](https://github.com/rsksmart/flyover-sdk/workflows/CodeQL/badge.svg)](https://github.com/rsksmart/flyover-sdk/actions?query=workflow%3ACodeQL)
6+
[![CI](https://github.com/rsksmart/flyover-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/rsksmart/flyover-sdk/actions/workflows/ci.yml)
67

78
Flyover SDK simplifies the integration between client applications and the components of the Flyover Protocol by providing an easy to use interface.
89
## Installation

docs/classes/Flyover.md

Lines changed: 64 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ Class that represents the entrypoint to the Flyover SDK
4545
- [getSelectedLiquidityProvider](Flyover.md#getselectedliquidityprovider)
4646
- [getUserQuotes](Flyover.md#getuserquotes)
4747
- [isConnected](Flyover.md#isconnected)
48+
- [isQuotePaid](Flyover.md#isquotepaid)
4849
- [refundPegout](Flyover.md#refundpegout)
4950
- [registerPegin](Flyover.md#registerpegin)
5051
- [setNetwork](Flyover.md#setnetwork)
@@ -74,7 +75,7 @@ Create a Flyover client instance.
7475

7576
#### Defined in
7677

77-
[src/sdk/flyover.ts:51](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L51)
78+
[src/sdk/flyover.ts:52](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L52)
7879

7980
## Properties
8081

@@ -86,7 +87,7 @@ Object that holds the connection configuration
8687

8788
#### Defined in
8889

89-
[src/sdk/flyover.ts:52](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L52)
90+
[src/sdk/flyover.ts:53](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L53)
9091

9192
___
9293

@@ -96,7 +97,7 @@ ___
9697

9798
#### Defined in
9899

99-
[src/sdk/flyover.ts:42](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L42)
100+
[src/sdk/flyover.ts:43](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L43)
100101

101102
___
102103

@@ -106,7 +107,7 @@ ___
106107

107108
#### Defined in
108109

109-
[src/sdk/flyover.ts:43](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L43)
110+
[src/sdk/flyover.ts:44](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L44)
110111

111112
___
112113

@@ -116,7 +117,7 @@ ___
116117

117118
#### Defined in
118119

119-
[src/sdk/flyover.ts:44](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L44)
120+
[src/sdk/flyover.ts:45](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L45)
120121

121122
___
122123

@@ -126,7 +127,7 @@ ___
126127

127128
#### Defined in
128129

129-
[src/sdk/flyover.ts:40](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L40)
130+
[src/sdk/flyover.ts:41](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L41)
130131

131132
___
132133

@@ -136,7 +137,7 @@ ___
136137

137138
#### Defined in
138139

139-
[src/sdk/flyover.ts:39](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L39)
140+
[src/sdk/flyover.ts:40](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L40)
140141

141142
___
142143

@@ -146,7 +147,7 @@ ___
146147

147148
#### Defined in
148149

149-
[src/sdk/flyover.ts:41](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L41)
150+
[src/sdk/flyover.ts:42](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L42)
150151

151152
## Methods
152153

@@ -186,7 +187,7 @@ await flyover.acceptPegoutQuote(quotes[0])
186187

187188
#### Defined in
188189

189-
[src/sdk/flyover.ts:177](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L177)
190+
[src/sdk/flyover.ts:178](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L178)
190191

191192
___
192193

@@ -226,7 +227,7 @@ await flyover.acceptQuote(quotes[0])
226227

227228
#### Defined in
228229

229-
[src/sdk/flyover.ts:124](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L124)
230+
[src/sdk/flyover.ts:125](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L125)
230231

231232
___
232233

@@ -240,7 +241,7 @@ ___
240241

241242
#### Defined in
242243

243-
[src/sdk/flyover.ts:323](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L323)
244+
[src/sdk/flyover.ts:324](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L324)
244245

245246
___
246247

@@ -254,7 +255,7 @@ ___
254255

255256
#### Defined in
256257

257-
[src/sdk/flyover.ts:315](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L315)
258+
[src/sdk/flyover.ts:316](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L316)
258259

259260
___
260261

@@ -280,7 +281,7 @@ If Flyover already has a connection to the network
280281

281282
#### Defined in
282283

283-
[src/sdk/flyover.ts:250](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L250)
284+
[src/sdk/flyover.ts:251](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L251)
284285

285286
___
286287

@@ -311,7 +312,7 @@ If not connected to RSK
311312

312313
#### Defined in
313314

314-
[src/sdk/flyover.ts:269](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L269)
315+
[src/sdk/flyover.ts:270](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L270)
315316

316317
___
317318

@@ -327,7 +328,7 @@ Disconnects from RSK network, removing BlockchainConnection object from Flyover
327328

328329
#### Defined in
329330

330-
[src/sdk/flyover.ts:309](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L309)
331+
[src/sdk/flyover.ts:310](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L310)
331332

332333
___
333334

@@ -341,7 +342,7 @@ ___
341342

342343
#### Defined in
343344

344-
[src/sdk/flyover.ts:331](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L331)
345+
[src/sdk/flyover.ts:332](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L332)
345346

346347
___
347348

@@ -365,7 +366,7 @@ Generate QR code for given address. The supported networks are Bitcoin and RSK
365366

366367
#### Defined in
367368

368-
[src/sdk/flyover.ts:214](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L214)
369+
[src/sdk/flyover.ts:215](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L215)
369370

370371
___
371372

@@ -386,7 +387,7 @@ If the feature was disabled by the provider
386387

387388
#### Defined in
388389

389-
[src/sdk/flyover.ts:425](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L425)
390+
[src/sdk/flyover.ts:444](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L444)
390391

391392
___
392393

@@ -406,7 +407,7 @@ Providers list
406407

407408
#### Defined in
408409

409-
[src/sdk/flyover.ts:76](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L76)
410+
[src/sdk/flyover.ts:77](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L77)
410411

411412
___
412413

@@ -424,7 +425,7 @@ Bridge.getMetadata
424425

425426
#### Defined in
426427

427-
[src/sdk/flyover.ts:358](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L358)
428+
[src/sdk/flyover.ts:359](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L359)
428429

429430
___
430431

@@ -450,14 +451,16 @@ transactions hashes
450451

451452
If you want to have a simplified version of the state of the quote to display as a status in
452453
a client UI, you can use the getSimpleQuoteStatus function
454+
This function implies trusting the LPS to provide the correct status of the quote and should
455+
be used with caution since is not a reliable source of truth.
453456

454457
**`Throws`**
455458

456459
If quote wasn't accepted or doesn't exist
457460

458461
#### Defined in
459462

460-
[src/sdk/flyover.ts:390](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L390)
463+
[src/sdk/flyover.ts:393](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L393)
461464

462465
___
463466

@@ -496,7 +499,7 @@ await flyover.getPegoutQuotes(quoteRequest)
496499

497500
#### Defined in
498501

499-
[src/sdk/flyover.ts:147](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L147)
502+
[src/sdk/flyover.ts:148](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L148)
500503

501504
___
502505

@@ -521,15 +524,17 @@ transactions hashes
521524
**`Remarks`**
522525

523526
If you want to have a simplified version of the state of the quote to display as a status in
524-
a client UI, you can use the getSimpleQuoteStatus function
527+
a client UI, you can use the getSimpleQuoteStatus function.
528+
This function implies trusting the LPS to provide the correct status of the quote and should
529+
be used with caution since is not a reliable source of truth.
525530

526531
**`Throws`**
527532

528533
If quote wasn't accepted or doesn't exist
529534

530535
#### Defined in
531536

532-
[src/sdk/flyover.ts:411](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L411)
537+
[src/sdk/flyover.ts:430](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L430)
533538

534539
___
535540

@@ -568,7 +573,7 @@ await flyover.getQuotes(quoteRequest)
568573

569574
#### Defined in
570575

571-
[src/sdk/flyover.ts:98](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L98)
576+
[src/sdk/flyover.ts:99](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L99)
572577

573578
___
574579

@@ -582,7 +587,7 @@ ___
582587

583588
#### Defined in
584589

585-
[src/sdk/flyover.ts:371](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L371)
590+
[src/sdk/flyover.ts:372](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L372)
586591

587592
___
588593

@@ -608,7 +613,7 @@ If not connected to RSK
608613

609614
#### Defined in
610615

611-
[src/sdk/flyover.ts:348](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L348)
616+
[src/sdk/flyover.ts:349](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L349)
612617

613618
___
614619

@@ -626,7 +631,30 @@ boolean
626631

627632
#### Defined in
628633

629-
[src/sdk/flyover.ts:239](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L239)
634+
[src/sdk/flyover.ts:240](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L240)
635+
636+
___
637+
638+
### isQuotePaid
639+
640+
**isQuotePaid**(`quoteHash`): `Promise`\<`IsQuotePaidResponse`\>
641+
642+
Checks if a quote has been paid by the LPS. The information is initially provided by the LPS and then
643+
verified in the blockchain.
644+
645+
#### Parameters
646+
647+
| Name | Type | Description |
648+
| :------ | :------ | :------ |
649+
| `quoteHash` | `string` | the has of the quote |
650+
651+
#### Returns
652+
653+
`Promise`\<`IsQuotePaidResponse`\>
654+
655+
#### Defined in
656+
657+
[src/sdk/flyover.ts:407](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L407)
630658

631659
___
632660

@@ -655,7 +683,7 @@ If not connected to RSK
655683

656684
#### Defined in
657685

658-
[src/sdk/flyover.ts:285](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L285)
686+
[src/sdk/flyover.ts:286](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L286)
659687

660688
___
661689

@@ -687,7 +715,7 @@ If there was an error during transaction execution
687715

688716
#### Defined in
689717

690-
[src/sdk/flyover.ts:300](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L300)
718+
[src/sdk/flyover.ts:301](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L301)
691719

692720
___
693721

@@ -709,7 +737,7 @@ Change client network after instantiating it. Useful if plan to switch networks
709737

710738
#### Defined in
711739

712-
[src/sdk/flyover.ts:199](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L199)
740+
[src/sdk/flyover.ts:200](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L200)
713741

714742
___
715743

@@ -734,7 +762,7 @@ Bridge.supportsConversion
734762

735763
#### Defined in
736764

737-
[src/sdk/flyover.ts:354](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L354)
765+
[src/sdk/flyover.ts:355](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L355)
738766

739767
___
740768

@@ -758,7 +786,7 @@ Bridge.supportsNetwork
758786

759787
#### Defined in
760788

761-
[src/sdk/flyover.ts:367](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L367)
789+
[src/sdk/flyover.ts:368](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L368)
762790

763791
___
764792

@@ -780,7 +808,7 @@ Set provider whose LPS will be used to get/accept quotes
780808

781809
#### Defined in
782810

783-
[src/sdk/flyover.ts:188](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L188)
811+
[src/sdk/flyover.ts:189](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L189)
784812

785813
___
786814

@@ -816,7 +844,7 @@ If options.throwError is true and the validation fails
816844

817845
#### Defined in
818846

819-
[src/sdk/flyover.ts:448](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L448)
847+
[src/sdk/flyover.ts:467](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L467)
820848

821849
___
822850

@@ -838,4 +866,4 @@ ___
838866

839867
#### Defined in
840868

841-
[src/sdk/flyover.ts:61](https://github.com/rsksmart/flyover-sdk/blob/18dbf4f19eeffd80a65cc3f468bbc1f72a91f197/src/sdk/flyover.ts#L61)
869+
[src/sdk/flyover.ts:62](https://github.com/rsksmart/flyover-sdk/blob/c4e062545df2cd84086a652b1972659c273d682e/src/sdk/flyover.ts#L62)

0 commit comments

Comments
 (0)