Skip to content

Commit a61c2dd

Browse files
authored
Merge branch 'main' into general-fixes-5
2 parents dd48f9c + 0fb4708 commit a61c2dd

File tree

13 files changed

+1973
-296
lines changed

13 files changed

+1973
-296
lines changed

docs/fassets/developer-guides.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,12 @@ Guides for [redeeming FAssets](/fassets/redemption) back to underlying assets.
8787
href: "/fassets/developer-guides/fassets-redemption-queue",
8888
docId: "fassets/developer-guides/fassets-redemption-queue",
8989
},
90+
{
91+
type: "link",
92+
label: "FAsset Auto-Redemption",
93+
href: "/fassets/developer-guides/fassets-autoredeem",
94+
docId: "fassets/developer-guides/fassets-autoredeem",
95+
},
9096
]}
9197
/>
9298

docs/fassets/developer-guides/12-fassets-autoredeem.mdx

Lines changed: 585 additions & 0 deletions
Large diffs are not rendered by default.

docs/smart-accounts/1-overview.mdx

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ The workflow for Flare Smart Accounts is comprised of the following steps.
3737
## 1. Instructions on XRPL
3838

3939
The Flare Smart Accounts allow XRPL users to perform actions on the Flare chain through instructions on the XRPL.
40-
This is done through a `Payment` to an XRPL address, designated by the operator - a backend monitoring incoming transactions and interacting with the Flare chain.
40+
This is done through a `Payment` to an XRPL address, designated by the operator, a backend monitoring incoming transactions and interacting with the Flare chain.
4141
The payment must transfer sufficient funds, as specified by the operator, and must include the proper payment receipt in the memo field.
4242

4343
The payment receipt is a `bytes32` value.
@@ -50,7 +50,7 @@ In practice, the payment receipt should be prepared by a backend, through a web
5050

5151
The first, instruction code, byte is further subdivided into two half-bytes.
5252
The first nibble is the instruction type;
53-
this is either `FXRP`, `Firelight` or `Upshift` (with corresponding type IDS `0`, `1` and `2`).
53+
this is either `FXRP`, `Firelight`, or `Upshift` (with corresponding type IDS `0`, `1`, and `2`).
5454
The second nibble is the instruction command; the available commands are different for each instruction type.
5555

5656
<details>
@@ -76,7 +76,7 @@ Instructions for interacting with the `FXRP` token.
7676
<td>&nbsp;collateralReservation</td>
7777
<td>
7878
&nbsp;Reserve a `value` of lots of collateral in the agent vault,
79-
registered under the `agentVaultId` with the `MasterAccountController`
79+
registered with the `agentVaultId` with the `MasterAccountController`
8080
contract.
8181
</td>
8282
</tr>
@@ -98,7 +98,7 @@ Instructions for interacting with the `FXRP` token.
9898

9999
### Firelight
100100

101-
Instructions for interacting with a Firelight type vault.
101+
Instructions for interacting with a Firelight-type vault.
102102

103103
**Type ID:** `01`.
104104

@@ -115,9 +115,9 @@ Instructions for interacting with a Firelight type vault.
115115
<td>&nbsp;collateralReservationAndDeposit</td>
116116
<td>
117117
&nbsp;Reserve a `value` of lots of collateral in the agent vault,
118-
registered under the `agentVaultId` with the `MasterAccountController`
118+
registered with the `agentVaultId` with the `MasterAccountController`
119119
contract. After successful minting, deposit the FXRP into the Firelight
120-
type vault, registered under the `vaultId` with the
120+
type vault, registered with the `vaultId` with the
121121
`MasterAccountController` contract. Equivalent to sending a
122122
`collateralReservation` instruction and a Firelight `deposit` instruction.
123123
</td>
@@ -128,7 +128,7 @@ Instructions for interacting with a Firelight type vault.
128128
<td>&nbsp;deposit</td>
129129
<td>
130130
&nbsp;Deposit a `value` of FXRP into the Firelight type vault,
131-
registered under the `vaultId` with the `MasterAccountController`
131+
registered with the `vaultId` with the `MasterAccountController`
132132
contract.
133133
</td>
134134
</tr>
@@ -137,7 +137,7 @@ Instructions for interacting with a Firelight type vault.
137137
<td>&nbsp;redeem</td>
138138
<td>
139139
&nbsp;Start the withdrawal process for a `value` of FXRP from the
140-
Firelight type vault, registered under the `vaultId` with the
140+
Firelight type vault, registered with the `vaultId`, with the
141141
`MasterAccountController` contract.
142142
</td>
143143
</tr>
@@ -146,7 +146,7 @@ Instructions for interacting with a Firelight type vault.
146146
<td>&nbsp;claimWithdraw</td>
147147
<td>
148148
&nbsp;Withdraw the `FXRP`, requested in the `value` period, from
149-
Firelight type vault, registered under the `vaultId` with the
149+
Firelight type vault, registered with the `vaultId`, with the
150150
`MasterAccountController` contract.
151151
</td>
152152
</tr>
@@ -156,7 +156,7 @@ Instructions for interacting with a Firelight type vault.
156156

157157
### Upshift
158158

159-
Instructions for interacting with an upshift type vault.
159+
Instructions for interacting with an Upshift-type vault.
160160

161161
**Type ID:** `02`.
162162

@@ -173,9 +173,9 @@ Instructions for interacting with an upshift type vault.
173173
<td>&nbsp;collateralReservationAndDeposit</td>
174174
<td>
175175
&nbsp;Reserve a `value` of lots of collateral in the agent vault,
176-
registered under the `agentVaultId` with the `MasterAccountController`
176+
registered with the `agentVaultId` with the `MasterAccountController`
177177
contract. After successful minting, deposit the FXRP into the Upshift
178-
type vault, registered under the `vaultId` with the
178+
type vault, registered with the `vaultId`, with the
179179
`MasterAccountController` contract. Equivalent to sending a
180180
`collateralReservation` instruction and a Upshift `deposit` instruction.
181181
</td>
@@ -186,7 +186,7 @@ Instructions for interacting with an upshift type vault.
186186
<td>&nbsp;deposit</td>
187187
<td>
188188
&nbsp;Deposit a `value` of FXRP into the Upshift type vault,
189-
registered under the `vaultId` with the `MasterAccountController`
189+
registered with the `vaultId` with the `MasterAccountController`
190190
contract.
191191
</td>
192192
</tr>
@@ -195,7 +195,7 @@ Instructions for interacting with an upshift type vault.
195195
<td>&nbsp;requestRedeem</td>
196196
<td>
197197
&nbsp;Start the withdrawal process for a `value` of FXRP from the
198-
Upshift type vault, registered under the `vaultId` with the
198+
Upshift type vault, registered with the `vaultId` with the
199199
`MasterAccountController` contract.
200200
</td>
201201
</tr>
@@ -204,7 +204,7 @@ Instructions for interacting with an upshift type vault.
204204
<td>&nbsp;claim</td>
205205
<td>
206206
&nbsp;Withdraw the `FXRP`, requested in the `value` period, from
207-
Upshift type vault, registered under the `vaultId` with the
207+
Upshift type vault, registered with the `vaultId` with the
208208
`MasterAccountController` contract.
209209
</td>
210210
</tr>

docs/smart-accounts/2-fasset-instructions.mdx

Lines changed: 38 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,9 @@ Thus, they eradicate completely the need for XRPL users to hold any non-XRPL ass
3131

3232
You can learn more about the FAssets in the [dedicated section](/fassets/overview/).
3333

34-
The instructions fall under three types: `FXRP`, `Firelight` and `Upshift`.
34+
The instructions fall under three types: `FXRP`, `Firelight`, and `Upshift`.
3535
Each type supports different instruction commands.
36-
The `FXRP` commands allow the interaction with the base FAssets system, whereas `Firelight` and `Upshift` give access to actions pertaining to the corresponding vault architectures.
36+
The `FXRP` commands allow interaction with the base FAssets system, whereas `Firelight` and `Upshift` give access to actions pertaining to the corresponding vault architectures.
3737

3838
{/* TODO:(Nik) explain walletId */}
3939

@@ -72,7 +72,7 @@ A collateral reservation payment reference is a 32-byte value:
7272
}}
7373
>
7474
<ThemedImage
75-
alt="Breakdown of bytes in payment reference for the collateral reservation action"
75+
alt="Breakdown of bytes in payment reference for the collateral reservation action."
7676
style={{ width: "100%" }}
7777
sources={{
7878
light: useBaseUrl(
@@ -90,7 +90,7 @@ A collateral reservation payment reference is a 32-byte value:
9090
Transfer `value` of drops of FXRP to the `recipientAddress`.
9191
The FXRP is sent from the personal account that belongs to the XRPL address that sent the instruction, if the FXRP balance is sufficient.
9292

93-
A transfer payment reference is 32-byte value:
93+
A transfer payment reference is a 32-byte value:
9494

9595
- byte representation of the instruction ID in the first byte:
9696
- type ID `00` in the first nibble,
@@ -108,7 +108,7 @@ A transfer payment reference is 32-byte value:
108108
}}
109109
>
110110
<ThemedImage
111-
alt="Breakdown of bytes in payment reference for the transfer action"
111+
alt="Breakdown of bytes in payment reference for the transfer action."
112112
style={{ width: "100%" }}
113113
sources={{
114114
light: useBaseUrl(
@@ -146,7 +146,7 @@ A redeem payment reference is the 32-byte value:
146146
}}
147147
>
148148
<ThemedImage
149-
alt="Breakdown of bytes in payment reference for the redeem action"
149+
alt="Breakdown of bytes in payment reference for the redeem action."
150150
style={{ width: "100%" }}
151151
sources={{
152152
light: useBaseUrl("/img/docs/smart-accounts/bytes-fxrp-redeem-light.png"),
@@ -157,13 +157,15 @@ A redeem payment reference is the 32-byte value:
157157

158158
## `01` Firelight
159159

160+
The commands of the `Firelight` type allow interaction with Firelight-type vaults.
161+
160162
### `01` Collateral reservation and deposit
161163

162-
Reserve the collateral for `value` lots of FXRP with the agent's vault, registered under the `agentVaultId` with the `MasterAccountController` contract.
163-
When minting is completed, deposit `value` lots of FXRP into a Firelight type vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
164+
Reserve the collateral for `value` lots of FXRP with the agent's vault, registered with the `agentVaultId` with the `MasterAccountController` contract.
165+
When minting is completed, deposit `value` lots of FXRP into a Firelight-type vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
164166
Essentially, this allows an XRPL user to signal intent for two actions at once;
165167
it is equivalent to sending a collateral reservation instruction first, and afterwards a deposit instruction.
166-
This cuts the total waiting time in half, and reduces the total number of transactions by one.
168+
This cuts the total waiting time in half and reduces the total number of transactions by one.
167169

168170
A collateral reservation and deposit instruction payment reference is the 32-byte value:
169171

@@ -185,7 +187,7 @@ A collateral reservation and deposit instruction payment reference is the 32-byt
185187
}}
186188
>
187189
<ThemedImage
188-
alt="Breakdown of bytes in payment reference for the collateral reservation and deposit action"
190+
alt="Breakdown of bytes in payment reference for the collateral reservation and deposit action."
189191
style={{ width: "100%" }}
190192
sources={{
191193
light: useBaseUrl(
@@ -200,7 +202,7 @@ A collateral reservation and deposit instruction payment reference is the 32-byt
200202

201203
### `02` Deposit
202204

203-
Deposit `value` lots of FXRP into a Firelight type vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
205+
Deposit `value` lots of FXRP into a Firelight-type vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
204206

205207
A deposit instruction payment reference is the 32-byte value:
206208

@@ -222,7 +224,7 @@ A deposit instruction payment reference is the 32-byte value:
222224
}}
223225
>
224226
<ThemedImage
225-
alt="Breakdown of bytes in payment reference for the deposit action"
227+
alt="Breakdown of bytes in payment reference for the deposit action."
226228
style={{ width: "100%" }}
227229
sources={{
228230
light: useBaseUrl(
@@ -239,7 +241,7 @@ A deposit instruction payment reference is the 32-byte value:
239241

240242
The first part of the withdrawal process from a Firelight vault.
241243

242-
Initiate a withdrawal request of `value` of FXRP from the Firelight vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
244+
Initiate a withdrawal request of `value` of FXRP from the Firelight vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
243245

244246
A redeem instruction payment reference is the 32-byte value:
245247

@@ -261,7 +263,7 @@ A redeem instruction payment reference is the 32-byte value:
261263
}}
262264
>
263265
<ThemedImage
264-
alt="Breakdown of bytes in payment reference for the redeem action"
266+
alt="Breakdown of bytes in payment reference for the redeem action."
265267
style={{ width: "100%" }}
266268
sources={{
267269
light: useBaseUrl(
@@ -277,7 +279,7 @@ A redeem instruction payment reference is the 32-byte value:
277279
### `04` Claim withdraw
278280

279281
The second part of the withdrawal process from a Firelight vault.
280-
Claim the pending withdrawal from the `value` period, from the Firelight vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
282+
Claim the pending withdrawal from the `value` period, from the Firelight vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
281283
The assets are transferred to the user's smart account.
282284
The action can only be performed after one full period has passed.
283285

@@ -303,7 +305,7 @@ A claim withdrawal payment reference is a 32-byte value:
303305
}}
304306
>
305307
<ThemedImage
306-
alt="Breakdown of bytes in payment reference for the claim withdraw action"
308+
alt="Breakdown of bytes in payment reference for the claim withdraw action."
307309
style={{ width: "100%" }}
308310
sources={{
309311
light: useBaseUrl(
@@ -318,13 +320,15 @@ A claim withdrawal payment reference is a 32-byte value:
318320

319321
## `02` Upshift
320322

323+
The commands of the `Upshift` type allow interaction with Upshift-type vaults.
324+
321325
### `01` Collateral reservation and deposit
322326

323-
Reserve the collateral for `value` lots of FXRP with the agent's vault, registered under the `agentVaultId` with the `MasterAccountController` contract.
324-
When minting is completed, deposit `value` lots of FXRP into an Upshift type vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
327+
Reserve the collateral for `value` lots of FXRP with the agent's vault, registered with the `agentVaultId` with the `MasterAccountController` contract.
328+
When minting is completed, deposit `value` lots of FXRP into an Upshift-type vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
325329
Essentially, this allows an XRPL user to signal intent for two actions at once;
326330
it is equivalent to sending a collateral reservation instruction first, and afterwards a deposit instruction.
327-
This cuts the total waiting time in half, and reduces the total number of transactions by one.
331+
This cuts the total waiting time in half and reduces the total number of transactions by one.
328332

329333
A collateral reservation and deposit instruction payment reference is the 32-byte value:
330334

@@ -346,22 +350,22 @@ A collateral reservation and deposit instruction payment reference is the 32-byt
346350
}}
347351
>
348352
<ThemedImage
349-
alt="Breakdown of bytes in payment reference for the collateral reservation and deposit action"
353+
alt="Breakdown of bytes in payment reference for the collateral reservation and deposit action."
350354
style={{ width: "100%" }}
351355
sources={{
352356
light: useBaseUrl(
353-
"/img/docs/smart-accounts/bytes-firelight-collateral-reservation-and-deposit-light.png",
357+
"img/docs/smart-accounts/bytes-upshift-collateral-reservation-and-deposit-light.png",
354358
),
355359
dark: useBaseUrl(
356-
"/img/docs/smart-accounts/bytes-firelight-collateral-reservation-and-deposit-dark.png",
360+
"img/docs/smart-accounts/bytes-upshift-collateral-reservation-and-deposit-dark.png",
357361
),
358362
}}
359363
/>
360364
</div>
361365

362366
### `02` Deposit
363367

364-
Deposit `value` lots of FXRP into an Upshift type vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
368+
Deposit `value` lots of FXRP into an Upshift type vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
365369

366370
A deposit instruction payment reference is the 32-byte value:
367371

@@ -383,14 +387,14 @@ A deposit instruction payment reference is the 32-byte value:
383387
}}
384388
>
385389
<ThemedImage
386-
alt="Breakdown of bytes in payment reference for the deposit action"
390+
alt="Breakdown of bytes in payment reference for the deposit action."
387391
style={{ width: "100%" }}
388392
sources={{
389393
light: useBaseUrl(
390-
"/img/docs/smart-accounts/bytes-firelight-deposit-light.png",
394+
"img/docs/smart-accounts/bytes-upshift-deposit-light.png",
391395
),
392396
dark: useBaseUrl(
393-
"/img/docs/smart-accounts/bytes-firelight-deposit-dark.png",
397+
"img/docs/smart-accounts/bytes-upshift-deposit-dark.png",
394398
),
395399
}}
396400
/>
@@ -400,7 +404,7 @@ A deposit instruction payment reference is the 32-byte value:
400404

401405
The first part of the withdrawal process from an Upshift vault.
402406

403-
Initiate a withdrawal request of `value` of FXRP from the Upshift vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
407+
Initiate a withdrawal request of `value` of FXRP from the Upshift vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
404408

405409
A request redeem instruction payment reference is the 32-byte value:
406410

@@ -422,14 +426,14 @@ A request redeem instruction payment reference is the 32-byte value:
422426
}}
423427
>
424428
<ThemedImage
425-
alt="Breakdown of bytes in payment reference for the request redeem action"
429+
alt="Breakdown of bytes in payment reference for the request redeem action."
426430
style={{ width: "100%" }}
427431
sources={{
428432
light: useBaseUrl(
429-
"/img/docs/smart-accounts/bytes-firelight-request-redeem-light.png",
433+
"img/docs/smart-accounts/bytes-upshift-request-redeem-light.png",
430434
),
431435
dark: useBaseUrl(
432-
"/img/docs/smart-accounts/bytes-firelight-request-redeem-dark.png",
436+
"img/docs/smart-accounts/bytes-upshift-request-redeem-dark.png",
433437
),
434438
}}
435439
/>
@@ -438,12 +442,12 @@ A request redeem instruction payment reference is the 32-byte value:
438442
### `04` Claim
439443

440444
The second part of the withdrawal process from an Upshift vault.
441-
Claim the pending withdrawal from the `value` period, from the Upshift vault at the address, registered with the `MasterAccountController` contract under the `vaultId`.
445+
Claim the pending withdrawal from the `value` period, from the Upshift vault at the address registered with the `MasterAccountController` contract with the `vaultId`.
442446
The assets are transferred to the user's smart account.
443447
The action can only be performed after one full period has passed.
444448

445-
The `value` represents the date, when the redemption was requested.
446-
It is is an 8-digit number `YYYYMMDD`, where `YYYY` is the year, `MM` the month (from `01` to `12`) and `DD` the day (from `01` to `31`, with additional monthly constraints) of the request.
449+
The `value` represents the date when the redemption was requested.
450+
It is an 8-digit number `YYYYMMDD`, where `YYYY` is the year, `MM` the month (from `01` to `12`), and `DD` the day (from `01` to `31`, with additional monthly constraints) of the request.
447451

448452
A claim payment reference is a 32-byte value:
449453

@@ -465,7 +469,7 @@ A claim payment reference is a 32-byte value:
465469
}}
466470
>
467471
<ThemedImage
468-
alt="Breakdown of bytes in payment reference for the claim action"
472+
alt="Breakdown of bytes in payment reference for the claim action."
469473
style={{ width: "100%" }}
470474
sources={{
471475
light: useBaseUrl(

docs/smart-accounts/3-custom-instruction.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ keywords:
1414
flare-network,
1515
account-abstraction,
1616
]
17-
unlisted: false
17+
unlisted: true
1818
---
1919

2020
import ThemedImage from "@theme/ThemedImage";

0 commit comments

Comments
 (0)