You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/smart-accounts/1-overview.mdx
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,7 +37,7 @@ The workflow for Flare Smart Accounts is comprised of the following steps.
37
37
## 1. Instructions on XRPL
38
38
39
39
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.
41
41
The payment must transfer sufficient funds, as specified by the operator, and must include the proper payment receipt in the memo field.
42
42
43
43
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
50
50
51
51
The first, instruction code, byte is further subdivided into two half-bytes.
52
52
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`).
54
54
The second nibble is the instruction command; the available commands are different for each instruction type.
55
55
56
56
<details>
@@ -76,7 +76,7 @@ Instructions for interacting with the `FXRP` token.
76
76
<td> collateralReservation</td>
77
77
<td>
78
78
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`
80
80
contract.
81
81
</td>
82
82
</tr>
@@ -98,7 +98,7 @@ Instructions for interacting with the `FXRP` token.
98
98
99
99
### Firelight
100
100
101
-
Instructions for interacting with a Firelighttype vault.
101
+
Instructions for interacting with a Firelight-type vault.
102
102
103
103
**Type ID:**`01`.
104
104
@@ -115,9 +115,9 @@ Instructions for interacting with a Firelight type vault.
115
115
<td> collateralReservationAndDeposit</td>
116
116
<td>
117
117
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`
119
119
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
121
121
`MasterAccountController` contract. Equivalent to sending a
122
122
`collateralReservation` instruction and a Firelight `deposit` instruction.
123
123
</td>
@@ -128,7 +128,7 @@ Instructions for interacting with a Firelight type vault.
128
128
<td> deposit</td>
129
129
<td>
130
130
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`
132
132
contract.
133
133
</td>
134
134
</tr>
@@ -137,7 +137,7 @@ Instructions for interacting with a Firelight type vault.
137
137
<td> redeem</td>
138
138
<td>
139
139
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
141
141
`MasterAccountController` contract.
142
142
</td>
143
143
</tr>
@@ -146,7 +146,7 @@ Instructions for interacting with a Firelight type vault.
146
146
<td> claimWithdraw</td>
147
147
<td>
148
148
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
150
150
`MasterAccountController` contract.
151
151
</td>
152
152
</tr>
@@ -156,7 +156,7 @@ Instructions for interacting with a Firelight type vault.
156
156
157
157
### Upshift
158
158
159
-
Instructions for interacting with an upshift type vault.
159
+
Instructions for interacting with an Upshift-type vault.
160
160
161
161
**Type ID:**`02`.
162
162
@@ -173,9 +173,9 @@ Instructions for interacting with an upshift type vault.
173
173
<td> collateralReservationAndDeposit</td>
174
174
<td>
175
175
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`
177
177
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
179
179
`MasterAccountController` contract. Equivalent to sending a
180
180
`collateralReservation` instruction and a Upshift `deposit` instruction.
181
181
</td>
@@ -186,7 +186,7 @@ Instructions for interacting with an upshift type vault.
186
186
<td> deposit</td>
187
187
<td>
188
188
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`
190
190
contract.
191
191
</td>
192
192
</tr>
@@ -195,7 +195,7 @@ Instructions for interacting with an upshift type vault.
195
195
<td> requestRedeem</td>
196
196
<td>
197
197
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
199
199
`MasterAccountController` contract.
200
200
</td>
201
201
</tr>
@@ -204,7 +204,7 @@ Instructions for interacting with an upshift type vault.
204
204
<td> claim</td>
205
205
<td>
206
206
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
Copy file name to clipboardExpand all lines: docs/smart-accounts/2-fasset-instructions.mdx
+38-34Lines changed: 38 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,9 +31,9 @@ Thus, they eradicate completely the need for XRPL users to hold any non-XRPL ass
31
31
32
32
You can learn more about the FAssets in the [dedicated section](/fassets/overview/).
33
33
34
-
The instructions fall under three types: `FXRP`, `Firelight` and `Upshift`.
34
+
The instructions fall under three types: `FXRP`, `Firelight`, and `Upshift`.
35
35
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.
37
37
38
38
{/* TODO:(Nik) explain walletId */}
39
39
@@ -72,7 +72,7 @@ A collateral reservation payment reference is a 32-byte value:
72
72
}}
73
73
>
74
74
<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."
76
76
style={{ width: "100%" }}
77
77
sources={{
78
78
light: useBaseUrl(
@@ -90,7 +90,7 @@ A collateral reservation payment reference is a 32-byte value:
90
90
Transfer `value` of drops of FXRP to the `recipientAddress`.
91
91
The FXRP is sent from the personal account that belongs to the XRPL address that sent the instruction, if the FXRP balance is sufficient.
92
92
93
-
A transfer payment reference is 32-byte value:
93
+
A transfer payment reference is a 32-byte value:
94
94
95
95
- byte representation of the instruction ID in the first byte:
96
96
- type ID `00` in the first nibble,
@@ -108,7 +108,7 @@ A transfer payment reference is 32-byte value:
108
108
}}
109
109
>
110
110
<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."
112
112
style={{ width: "100%" }}
113
113
sources={{
114
114
light: useBaseUrl(
@@ -146,7 +146,7 @@ A redeem payment reference is the 32-byte value:
146
146
}}
147
147
>
148
148
<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."
@@ -157,13 +157,15 @@ A redeem payment reference is the 32-byte value:
157
157
158
158
## `01` Firelight
159
159
160
+
The commands of the `Firelight` type allow interaction with Firelight-type vaults.
161
+
160
162
### `01` Collateral reservation and deposit
161
163
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 Firelighttype 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`.
164
166
Essentially, this allows an XRPL user to signal intent for two actions at once;
165
167
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.
167
169
168
170
A collateral reservation and deposit instruction payment reference is the 32-byte value:
169
171
@@ -185,7 +187,7 @@ A collateral reservation and deposit instruction payment reference is the 32-byt
185
187
}}
186
188
>
187
189
<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."
189
191
style={{ width: "100%" }}
190
192
sources={{
191
193
light: useBaseUrl(
@@ -200,7 +202,7 @@ A collateral reservation and deposit instruction payment reference is the 32-byt
200
202
201
203
### `02` Deposit
202
204
203
-
Deposit `value` lots of FXRP into a Firelighttype 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`.
204
206
205
207
A deposit instruction payment reference is the 32-byte value:
206
208
@@ -222,7 +224,7 @@ A deposit instruction payment reference is the 32-byte value:
222
224
}}
223
225
>
224
226
<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."
226
228
style={{ width: "100%" }}
227
229
sources={{
228
230
light: useBaseUrl(
@@ -239,7 +241,7 @@ A deposit instruction payment reference is the 32-byte value:
239
241
240
242
The first part of the withdrawal process from a Firelight vault.
241
243
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`.
243
245
244
246
A redeem instruction payment reference is the 32-byte value:
245
247
@@ -261,7 +263,7 @@ A redeem instruction payment reference is the 32-byte value:
261
263
}}
262
264
>
263
265
<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."
265
267
style={{ width: "100%" }}
266
268
sources={{
267
269
light: useBaseUrl(
@@ -277,7 +279,7 @@ A redeem instruction payment reference is the 32-byte value:
277
279
### `04` Claim withdraw
278
280
279
281
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`.
281
283
The assets are transferred to the user's smart account.
282
284
The action can only be performed after one full period has passed.
283
285
@@ -303,7 +305,7 @@ A claim withdrawal payment reference is a 32-byte value:
303
305
}}
304
306
>
305
307
<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."
307
309
style={{ width: "100%" }}
308
310
sources={{
309
311
light: useBaseUrl(
@@ -318,13 +320,15 @@ A claim withdrawal payment reference is a 32-byte value:
318
320
319
321
## `02` Upshift
320
322
323
+
The commands of the `Upshift` type allow interaction with Upshift-type vaults.
324
+
321
325
### `01` Collateral reservation and deposit
322
326
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 Upshifttype 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`.
325
329
Essentially, this allows an XRPL user to signal intent for two actions at once;
326
330
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.
328
332
329
333
A collateral reservation and deposit instruction payment reference is the 32-byte value:
330
334
@@ -346,22 +350,22 @@ A collateral reservation and deposit instruction payment reference is the 32-byt
346
350
}}
347
351
>
348
352
<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."
@@ -400,7 +404,7 @@ A deposit instruction payment reference is the 32-byte value:
400
404
401
405
The first part of the withdrawal process from an Upshift vault.
402
406
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`.
404
408
405
409
A request redeem instruction payment reference is the 32-byte value:
406
410
@@ -422,14 +426,14 @@ A request redeem instruction payment reference is the 32-byte value:
422
426
}}
423
427
>
424
428
<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."
@@ -438,12 +442,12 @@ A request redeem instruction payment reference is the 32-byte value:
438
442
### `04` Claim
439
443
440
444
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`.
442
446
The assets are transferred to the user's smart account.
443
447
The action can only be performed after one full period has passed.
444
448
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.
447
451
448
452
A claim payment reference is a 32-byte value:
449
453
@@ -465,7 +469,7 @@ A claim payment reference is a 32-byte value:
465
469
}}
466
470
>
467
471
<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."
0 commit comments