Agent documentation index: llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Skip to main content

Operational Parameters

This page lists the current values for the most important parameters of the FAssets system on Songbird Canary-Network and Songbird Testnet Coston. These values are subject to change as the system is further developed and tested.

Asset Manager Operational Parameters​

To get the default agent settings, you need to call the getSettings function on the IAssetManager interface. Read more about the IAssetManager interface here.

Minting and Redeeming​

ParameterXRP
Minting cap 
mintingCapAMG
Total amount of allowed FAssets in circulation. Once reached, no more FAssets can be minted until some are redeemed. This is intended as a security measure. In the final deployment, this cap will be gradually increased and finally removed.		70M XRP
Lot size 
lotSizeAMG
Minimum quantity required for minting FAssets.		10 XRP
Collateral reservation fee (CRF) 
collateralReservationFee
Fee applied when reserving collateral for minting..		0.01%
Redemption fee 
redemptionFee
Fee charged during redemption of FAssets.		0.2%
Redemption default premium 
redemptionDefaultPremium
Premium paid if an agent fails to meet redemption obligations.		5%
Redemption default premium source 

Where does the premium come from when an agent fails to pay the redeemer on time? If the vault CR > 1.1, from the agent's vault. Otherwise, from the agent's vault and the collateral pool.		✅
Maximum redemption tickets 
maxRedeemedTickets
Maximum number of tickets redeemed in a single request.		20
Minimum Redeem Amount 
minimumRedeemAmountUBA
Minimum amount that can be redeemed, in base unit of the underlying asset (UBA).		5 XRP

Payment Times​

ParameterXRP
Underlying blocks for payment 
underlyingBlocksForPayment
The number of underlying blocks during which the minter or agent can pay the underlying value.		225
Underlying seconds for payment 
underlyingSecondsForPayment
The minimum time allowed for an agent to pay for a redemption or a minter to pay for minting.		15 minutes
Average block time 
averageBlockTimeMS
The average time between two successive blocks on the underlying chain.		4 seconds
Time of proof availability 
attestationWindowSeconds
The amount of time that proofs of payment or nonpayment must be available on the Data Connector.		1 day
Amount of extra time per redemption 
redemptionPaymentExtensionSeconds
The extra amount of time per redemption granted to an agent when many redemption requests occur in a short period of time.		45 seconds

Collateral Ratios​

ParameterXRP
Vault Collateral Supported Types 

Types of collateral required in the agent's vault.		USDT
Vault Minimal CR 
getCollateralTypes 
The minimum collateral ratio required to avoid liquidation.		1.2
Vault Collateral Safety CR 
getCollateralTypes 
The collateral ratio required to exit liquidation mode.		1.3
Pool Collateral Supported Types 

Types of collateral required in the collateral pool.		FLR
Pool Collateral Pool Minimal CR 
getCollateralTypes 
The minimum collateral ratio required to avoid liquidation.		1.5
Pool Collateral Safety CR 
getCollateralTypes 
The collateral ratio required to exit liquidation mode.		1.6
Minting pool holdings required 
mintingPoolHoldingsRequired
The minimum amount of pool tokens an agent must hold to be able to mint, as a percentage of the FAssets the agent is currently backing.		50%

Liquidation​

ParameterXRP
Liquidation premium 
liquidationPremium
Increases in steps, as time passes.		Step 1: 4%
Step 2: 8%
Step 3: 12%
Liquidation step time 
liquidationStepTime
Elapsed time before the liquidation premium advances to the next step.		300 seconds
Liquidation source - Liquidated value 

Where do the funds come from to pay for liquidations?		The agent's vault
Liquidation source - Premium 

Where do the funds come from to pay for liquidations?		The collateral's vault

Rewarding​

ParameterXRP
Challenger reward 
paymentChallengeReward
After a successful challenge for an illegal operation, the agent goes into full liquidation and the challenger is paid this reward from the agent's vault.		250 USD converted to vault collateral
Confirmation by others 
confirmationByOthersAfter
If an agent or redeemer becomes unresponsive, anybody can confirm payments and non-payments some time after the request was made, and get a reward from the agent's vault.		-
Minimum time 
confirmationByOthersAfter
6 hours
Reward 
confirmationByOthersReward
5 USD (converted to vault collateral)

Time Locks​

ParameterXRP
Time lock 
withdrawalTimelock
Agent has to announce any collateral withdrawal or vault destruction and then wait this time before executing it.		1 hour
Maximum governance update frequency 
minUpdateRepeatTime
Minimum amount of time between updates of any governance setting.		1 day
Token invalidation time 
tokenInvalidationTime
Time between the moment a token is deprecated by governance and it becomes invalid. Agents still using it as vault collateral get liquidated after this time.		1 day
Agent exit available time lock 
agentExitAvailableTimelock
The time the agent has to wait after announcing exit from the list of publicly available agents and executing the exit.		3 hours
Agent fee change time lock 
agentFeeChangeTimelock
The time the agent has to wait between announcing and changing the agent fee or the pool share.		1 hour
Agent minting CR change time lock 
agentMintingCRChangeTimelock
The time the agent has to wait between announcing and changing the minting CR (vault or pool).		5 minutes
Pool exit and top-up change time lock 
poolExitAndTopupChangeTimelock
The time the agent has to wait between announcing and changing any pool exit and top-up settings.		1 day
Agent time-locked operation window 
agentTimelockedOperationWindow
Once the above time locks expire, agents have this amount of time to execute the requested operation.		2 hours
Collateral pool token time lock 
collateralPoolTokenTimelock
Amount of seconds that a user entering the collateral pool must wait before spending (exit or transfer) the obtained pool tokens.		60 seconds
Minimum diamond-cut time lock 
diamondCutMinTimelockSeconds
Amount of time that must elapse before the system performs a <a href='https://eips.ethereum.org/EIPS/eip-2535' target='_blank'>diamond cut</a>.		1 hour

Emergency Pause​

ParameterXRP
Emergency pause 
maxEmergencyPauseDurationSeconds
The maximum time for a pause triggered by governance or some other entity.		3 days
Emergency pause reset 
emergencyPauseDurationResetAfterSeconds
The amount of time since the last emergency pause. After it has elapsed, the pause duration counter automatically resets.		1 week

Core Vault​

Core Vault Manager​

To get the Core Vault manager operational parameters you need to use the ICoreVaultManager interface. Specific functions added to each parameter.

ParameterXRP
Escrow amount 
_escrowAmount getSettings _escrowAmount
The amount of XRP to escrow (setting to 0 disables escrowing).		250k XRP
Minimal left amount in the multisig 
_minimalAmount getSettings _minimalAmount
The minimal amount that will be left on the multisig after escrowing.		500k XRP
Escrow expiration time 
_escrowEndTimeSeconds getSettings _escrowEndTimeSeconds
The time of day (UTC) when the escrows expire. Exactly one escrow per day will expire.		57600 (16:00 UTC)
Max expected fee 
_fee getSettings _fee
Maximum expected fee charged by the chain for a payment		0.0004 XRP (400 drops)

Core Vault Settings​

To get the Core Vault settings you need to use the IAssetManager interface. Specific functions added to each parameter.

ParameterXRP
Minting left on agent's address 
getCoreVaultMinimumAmountLeftBIPS 
Minimum amount of minting left on agent's address after transfer to core vault. Expressed as percentage of agent's minting capacity (calculated from agent's vault and pool collateral).		15%
Transfer to core vault time 
getCoreVaultTransferTimeExtensionSeconds 
The extra time for an agent's transfer to the core vault, compared to ordinary redemption payment.		2 hours
Transfer fee to Core Vault 
getCoreVaultTransferTimeExtensionSeconds 
Fee (in percentage of transfer amount) paid by agent for transfer to the core vault.		0
Minimum number of lots for direct redemption 
getCoreVaultMinimumRedeemLots 
The minimum number of lots that a direct redemption from core vault can take		1000
Redemption fee 
getCoreVaultRedemptionFeeBIPS 
Fee (in percentage of redemption amount) paid by the redeemer for direct redemptions from the core vault.		0
Core Vault Donation Tag 
getCoreVaultDonationTag 
Destination tag that must be added to core vault donation transactions.		1

Direct Minting​

ParameterXRP
Direct Minting Minimum Fee 
getDirectMintingMinimumFeeUBA 
Minimum fee charged for direct minting, in base unit of the underlying asset (UBA).		0.1 XRP
Direct Minting Fee 
getDirectMintingFeeBIPS 
Direct minting fee as a percentage of the minting amount, in BIPS.		0.1%
Direct Minting Executor Fee 
getDirectMintingExecutorFeeUBA 
Fee paid to the executor of a direct minting request, in base unit of the underlying asset (UBA). This only applies to direct mintings to address, for direct minting to smart account the executor fee is calculated and paid by the smart account manager.		0.2 XRP
Direct Minting Others Can Execute After 
getDirectMintingOthersCanExecuteAfterSeconds 
Time in seconds after which anyone can execute a direct minting request (not just the executor set by the minter).		2 hours
Direct Minting Hourly Limit 
getDirectMintingHourlyLimitUBA 
Maximum amount that can be directly minted per hour, in base unit of the underlying asset (UBA). After that the mintings are delayed.		4M XRP
Direct Minting Daily Limit 
getDirectMintingDailyLimitUBA 
Maximum amount that can be directly minted per day, in base unit of the underlying asset (UBA). After that the mintings are delayed.		40M XRP
Direct Minting Large Minting Threshold 
getDirectMintingLargeMintingThresholdUBA 
Threshold above which a direct minting is considered large, in base unit of the underlying asset (UBA). Large mintings are always delayed.		4M XRP
Direct Minting Large Minting Delay 
getDirectMintingLargeMintingDelaySeconds 
Delay in seconds imposed on large direct mintings before they can be executed.		2 hours
Direct Minting Fee Receiver 
getDirectMintingFeeReceiver 
Address that receives the direct minting fee.		0xF55bcAd5568d1584ab6f013f144e1e433Ee551C7

Minting Tag Manager​

ParameterXRP
Name (NFT) 

NFT collection name used by the minting tag manager.		FXRP Minting Tag
Symbol (NFT) 

NFT collection symbol used by the minting tag manager.		MTFXRP
Reservation Fee 
reservationFee 
Fee charged when reserving a minting tag for the NFT-based manager.		100 FLR
Reservation Fee Recipient 
getDirectMintingFeeReceiver 
Address that receives reservation fees.		0x889A02c0E6d92e77188aDe03e3ce15B73228C197
Reserved Tag Count 
reservedTagCount
Initial minting tag ID offset.		30

Redeem With Tag​

ParameterXRP
Minimum Redeem Amount 
minimumRedeemAmountUBA 
Minimum amount that can be redeemed, in base unit of the underlying asset (UBA).		5 XRP
What's next

Learn more about the different components and processes involved in FAssets - collateral, minting, redemptions, liquidations and Core Vault.

For developer resources, explore our FXRP address, minting, and redemption guides to get started with FAssets integration.