Skip to content

Commit bf6293b

Browse files
committed
docs(minting): enhance minting process details and introduce executor role
1 parent be49aaa commit bf6293b

File tree

1 file changed

+21
-5
lines changed

1 file changed

+21
-5
lines changed

docs/fassets/3-minting.mdx

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,11 @@ This is the summary of the minting process:
1515
The choice is based on the minting fee or the amount of free collateral, which must be enough to back the amount to be minted.
1616
2. The minter sends to the Asset Manager contract a collateral reservation transaction (CRT). The CRT includes:
1717

18-
- The address of the chosen agent
19-
- The amount to mint, which must be a whole number of [lots](/fassets/minting#lots)
20-
- The [collateral reservation fee (CRF)](#fees) to compensate for the locked collateral
18+
- The address of the chosen agent.
19+
- The amount to mint, which must be a whole number of [lots](/fassets/minting#lots).
20+
- The [collateral reservation fee (CRF)](#fees) to compensate for the locked collateral.
21+
- The executor's address, if the minter is not the executor.
22+
- The executor's fee, if the minter is not the executor.
2123

2224
3. The Asset Manager contract locks the agent's collateral in the amount needed to back the whole minting until the underlying payment is proved or disproved.
2325
The collateral reservation response is an event issued by the contract, which includes:
@@ -27,13 +29,15 @@ This is the summary of the minting process:
2729
- The payment reference, which is a unique 32-byte number the minter must include as a memo in the payment on the underlying chain.
2830
- The last underlying block and the last underlying timestamp to pay.
2931
Valid payments occur either before the last block or before the last timestamp, both inclusive.
32+
- The executor's address, if the minter is not the executor.
33+
- The executor's fee, if the minter is not the executor.
3034

3135
The time to pay is measured both in the underlying chain's block numbers and block times because the underlying chain might halt for a long time.
3236
In this situation, the block numbers do not increment but the block timestamps do.
3337

3438
4. After this event is emitted, the minter must pay the full underlying amount plus the fee to the agent on the underlying chain in a certain amount of time.
35-
5. Using the Data Connector, the minter proves the payment on Flare.
36-
6. After the payment is proved, the minter executes the minting process, which sends FAssets to the minter's account.
39+
5. Using the Data Connector, the minter or executor proves the payment on Flare.
40+
6. After the payment is proved, the minter or executor executes the minting process, which sends FAssets to the minter's account.
3741

3842
When minting is executed, the [minting fee](#fees) is split between the agent and the pool:
3943

@@ -45,6 +49,18 @@ When minting is executed, the [minting fee](#fees) is split between the agent an
4549

4650
After minting is complete, the Asset Manager creates a [redemption ticket](#redemption-tickets-and-the-redemption-queue), which includes the mint amount and the name of the agent backing the minting.
4751

52+
### Executor Role
53+
54+
The execution of the minting process can be performed by an **executor**, an external actor such as a bot or service that monitors pending minting requests.
55+
Executors are incentivized to act quickly and correctly, but they hold no special permissions.
56+
If they fail to execute in time, the request may expire, and the minting must be restarted.
57+
58+
The executor:
59+
60+
- Is nominated by the minter and gets paid by the minter.
61+
- Uses the Flare Data Connector to obtain valid payment proof.
62+
- Executes the minting with a valid payment proof.
63+
4864
## Fees
4965

5066
The following fees are paid to mint FAssets:

0 commit comments

Comments
 (0)