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

IAssetManagerEvents

IAssetManagerEvents is an interface that defines the events emitted by the IAssetManager contract.

Sourced from IAssetManagerEvents.sol and IDirectMinting.sol on GitHub.

Event Categories​

The events are organized into the following categories:

  • Minting Events - Events related to the FAssets minting process.
  • Redemption Events - All events related to the FAssets redemption process, including requests, tickets, outcomes, and failures.

Minting Events​

Events related to the FAssets minting process, including collateral reservation, execution, and defaults.

CollateralReserved​

Emitted when a minter has reserved collateral, paid the reservation fee, and is expected to pay the underlying funds. The agent's collateral is reserved at this point.

Parameters:

  • agentVault: Address of the agent vault
  • minter: Address of the minter
  • collateralReservationId: ID of the collateral reservation
  • valueUBA: Value in the underlying base amount
  • feeUBA: Fee in the underlying base amount
  • firstUnderlyingBlock: First block number on the underlying chain
  • lastUnderlyingBlock: Last block number on the underlying chain
  • lastUnderlyingTimestamp: Last timestamp on the underlying chain
  • paymentAddress: Address for payment
  • paymentReference: Reference for payment
  • executor: Address of the executor
  • executorFeeNatWei: Fee for the executor in NAT wei
event CollateralReserved(
    address indexed agentVault,
    address indexed minter,
    uint256 indexed collateralReservationId,
    uint256 valueUBA,
    uint256 feeUBA,
    uint256 firstUnderlyingBlock,
    uint256 lastUnderlyingBlock,
    uint256 lastUnderlyingTimestamp,
    string paymentAddress,
    bytes32 paymentReference,
    address executor,
    uint256 executorFeeNatWei
);

CollateralReservationRejected​

Emitted when an agent rejects the collateral reservation request due to the minter's identity. The reserved collateral is released.

Parameters:

  • agentVault: Address of the agent vault
  • minter: Address of the minter
  • collateralReservationId: ID of the collateral reservation
event CollateralReservationRejected(
    address indexed agentVault,
    address indexed minter,
    uint256 indexed collateralReservationId
);

CollateralReservationCancelled​

Emitted when a minter cancels the collateral reservation request due to agent inactivity. The reserved collateral is released.

Parameters:

  • agentVault: Address of the agent vault
  • minter: Address of the minter
  • collateralReservationId: ID of the collateral reservation
event CollateralReservationCancelled(
    address indexed agentVault,
    address indexed minter,
    uint256 indexed collateralReservationId
);

MintingExecuted​

Emitted when a minter has successfully paid the underlying funds in time and received the FAssets. The agent's collateral is locked at this point.

Parameters:

  • agentVault: Address of the agent vault
  • collateralReservationId: ID of the collateral reservation
  • mintedAmountUBA: Amount of FAssets minted in the underlying base amount
  • agentFeeUBA: Fee paid to the agent in the underlying base amount
  • poolFeeUBA: Fee paid to the pool in the underlying base amount
event MintingExecuted(
    address indexed agentVault,
    uint256 indexed collateralReservationId,
    uint256 mintedAmountUBA,
    uint256 agentFeeUBA,
    uint256 poolFeeUBA
);

DirectMintingExecuted​

Emitted when a direct minting payment is confirmed and FAssets are minted to the target address.

Parameters:

  • transactionId: Identifier of the direct minting transaction
  • targetAddress: Address that receives the minted FAssets
  • executor: Address of the executor that submitted the minting proof
  • mintedAmountUBA: Amount of FAssets minted in the underlying base amount
  • mintingFeeUBA: Minting fee in the underlying base amount
  • executorFeeUBA: Fee paid to the executor in the underlying base amount
event DirectMintingExecuted(
    bytes32 transactionId,
    address targetAddress,
    address executor,
    uint256 mintedAmountUBA,
    uint256 mintingFeeUBA,
    uint256 executorFeeUBA
);

DirectMintingExecutedToSmartAccount​

Emitted when executeDirectMinting finalizes an XRPL payment that does not resolve to a direct recipient through a registered destination tag or a valid DIRECT_MINTING / DIRECT_MINTING_EX memo.

FAssets are minted to the smart account manager instead of a target EVM address. The manager is then notified via handleMintedFAssets so it can route FXRP to the appropriate smart account based on the XRPL sourceAddress and memoData.

When it triggers: In _decodeTarget, the payment has no registered tag recipient and no valid 32-byte or 48-byte direct-minting memo. This includes payments with no memo, an unrecognized memo, or an unregistered destination tag.

Differences from DirectMintingExecuted:

  • FAssets go to the smart account manager, not directly to the minter's wallet.
  • The executor fee is not set by the AssetManager — the smart account manager pays the executor.
  • Optional msg.value on executeDirectMinting is forwarded to the smart account manager (for example, composed redeem flows).
  • mintedAmountUBA = receivedAmount - mintingFeeUBA (no executor fee deducted on-chain by the AssetManager).

See Minting Troubleshooting — smart account path and unrecognized memo routes to smart accounts.

Parameters:

  • transactionId: Identifier of the underlying XRPL payment
  • sourceAddress: XRPL address that sent the payment
  • executor: Address of the executor that submitted the FDC proof
  • mintedAmountUBA: FAssets minted to the smart account manager in underlying base amount (receivedAmount - mintingFee)
  • mintingFeeUBA: Minting fee in underlying base amount
  • memoData: XRPL memo bytes from the payment (empty if the payment had no memo)
event DirectMintingExecutedToSmartAccount(
    bytes32 transactionId,
    string sourceAddress,
    address executor,
    uint256 mintedAmountUBA,
    uint256 mintingFeeUBA,
    bytes memoData);

DirectMintingPaymentTooSmallForFee​

Emitted when executeDirectMinting finalizes an XRPL payment whose receivedAmount is strictly less than getDirectMintingMinimumFeeUBA().

The call does not revert. Execution succeeds, but the full payment is minted as FAssets to the minting fee receiver (getDirectMintingFeeReceiver()). The minter, executor, and smart account manager receive nothing — neither DirectMintingExecuted nor DirectMintingExecutedToSmartAccount is emitted.

This path prevents users from sending very small payments (especially without a direct-minting memo or tag) to avoid the minimum minting fee. The system minting fee takes priority over the executor fee.

Threshold: receivedAmountUBA < minimumMintingFeeUBA, where minimumMintingFeeUBA comes from getDirectMintingMinimumFeeUBA(). Payments equal to the minimum fee do not emit this event.

See Minting Troubleshooting — payment below minimum fee for prevention guidance.

Parameters:

  • transactionId: Identifier of the underlying XRPL payment
  • receivedAmountUBA: Amount received on XRPL in underlying base amount
  • minimumMintingFeeUBA: Minimum direct minting fee at execution time (from getDirectMintingMinimumFeeUBA())
event DirectMintingPaymentTooSmallForFee(
    bytes32 transactionId,
    uint256 receivedAmountUBA,
    uint256 minimumMintingFeeUBA);

DirectMintingDelayed​

Emitted when a direct minting is throttled by the hourly or daily rate limiter and its execution is postponed.

For amounts strictly above getDirectMintingLargeMintingThresholdUBA(), see LargeDirectMintingDelayed instead.

The executor must wait until executionAllowedAt and call executeDirectMinting again with the same FDC proof. The underlying asset remains at the Core Vault until a successful finalization.

Parameters:

  • transactionId: Identifier of the direct minting transaction
  • amount: Amount being minted in the underlying base amount
  • executionAllowedAt: Earliest timestamp at which the minting can be executed
event DirectMintingDelayed(
    bytes32 transactionId,
    uint256 amount,
    uint256 executionAllowedAt
);

LargeDirectMintingDelayed​

Emitted when executeDirectMinting is called for a payment whose underlying amount is strictly greater than getDirectMintingLargeMintingThresholdUBA().

Unlike DirectMintingDelayed, the hold is a fixed duration from getDirectMintingLargeMintingDelaySeconds(), independent of how far the hourly or daily windows are exceeded. Large mints are not counted toward those rate-limiter windows.

The executor must wait until executionAllowedAt and call executeDirectMinting again with the same FDC proof. This delay is not bypassed by governance unblockDirectMintingsUntil.

See Large minting delay and Minting Troubleshooting — delays.

Parameters:

  • transactionId: Identifier of the direct minting transaction
  • amount: Amount being minted in the underlying base amount
  • executionAllowedAt: Earliest timestamp at which the minting can be executed (block.timestamp + directMintingLargeMintingDelaySeconds on the first attempt)
event LargeDirectMintingDelayed(
    bytes32 transactionId,
    uint256 amount,
    uint256 executionAllowedAt
);

DirectMintingsUnblocked​

Emitted when governance calls unblockDirectMintingsUntil to temporarily bypass the hourly and daily direct-minting rate limiter.

The parameter startedUntilTimestamp is the timestamp passed to unblockDirectMintingsUntil (it must be in the past). Delayed mintings that started — that is, emitted DirectMintingDelayed — before this timestamp can execute without waiting for their original executionAllowedAt.

While block.timestamp < getDirectMintingsUnblockUntilTimestamp(), the hourly and daily caps are not enforced. This bypass does not apply to LargeDirectMintingDelayed mintings.

After unblocking, integrators can call markUnblockedDirectMintingAllowed(transactionId) to reset a preferred executor's exclusive window from the unblock time.

See Minting Troubleshooting — delays.

Parameters:

  • startedUntilTimestamp: Cutoff timestamp — mintings delayed before this time are eligible for immediate execution
event DirectMintingsUnblocked(
    uint256 startedUntilTimestamp
);

MintingPaymentDefault​

Emitted when a minter fails to pay the underlying funds in time. The collateral reservation fee is paid to the agent, and the reserved collateral is released.

Parameters:

  • agentVault: Address of the agent vault
  • minter: Address of the minter
  • collateralReservationId: ID of the collateral reservation
  • reservedAmountUBA: Amount that was reserved in the underlying base amount
event MintingPaymentDefault(
    address indexed agentVault,
    address indexed minter,
    uint256 indexed collateralReservationId,
    uint256 reservedAmountUBA
);

CollateralReservationDeleted​

Emitted when both the minter and agent fail to present any proof within the attestation time window, and the agent calls unstickMinting to release the reserved collateral.

Parameters:

  • agentVault: Address of the agent vault
  • minter: Address of the minter
  • collateralReservationId: ID of the collateral reservation
  • reservedAmountUBA: Amount that was reserved in the underlying base amount
event CollateralReservationDeleted(
    address indexed agentVault,
    address indexed minter,
    uint256 indexed collateralReservationId,
    uint256 reservedAmountUBA
);

Redemption Events​

All events related to the FAssets redemption process, including redemption requests, ticket management, successful redemptions, failures, defaults, and fee distributions.

RedemptionRequested​

An event is emitted when the redeemer starts the redemption process.

Parameters:

  • agentVault: Address of the agent vault.
  • redeemer: Address of the redeemer.
  • requestId: Unique identifier for the redemption request.
  • paymentAddress: Address to which the agent must transfer the redeemed amount on the underlying chain.
  • valueUBA: Amount of FAssets to redeem.
  • feeUBA: Fee for the redemption.
  • firstUnderlyingBlock: First underlying block to submit payment.
  • lastUnderlyingBlock: Last underlying block to submit payment.
  • lastUnderlyingTimestamp: Deadline on the underlying chain for submitting the redemption payment.
  • paymentReference: Reference for payment that will be used to track the redemption payment.
  • executor: Address of the executor that is allowed to execute the redemption default.
  • executorFeeNatWei: Fee for the executor in NAT wei.
event RedemptionRequested(
    address indexed agentVault,
    address indexed redeemer,
    uint256 indexed requestId,
    string paymentAddress,
    uint256 valueUBA,
    uint256 feeUBA,
    uint256 firstUnderlyingBlock,
    uint256 lastUnderlyingBlock,
    uint256 lastUnderlyingTimestamp,
    bytes32 paymentReference,
    address executor,
    uint256 executorFeeNatWei);

RedemptionWithTagRequested​

Emitted when the redeemer starts redemption with the tag and provides FAssets. The amount corresponding to valueUBA FAssets is burned.

Several RedemptionWithTagRequested events can be emitted in a single redemption call (one per redeemed agent, with multiple tickets for the same agent combined). The agent's collateral remains locked at this stage.

Parameters:

  • agentVault: Address of the agent vault.
  • redeemer: Address of the redeemer.
  • requestId: Unique identifier for the redemption request.
  • paymentAddress: Address on the underlying chain to which the agent must transfer the payment.
  • valueUBA: Amount redeemed in underlying base units.
  • feeUBA: Redemption fee in underlying base units.
  • firstUnderlyingBlock: First underlying block in the valid payment window.
  • lastUnderlyingBlock: Last underlying block in the valid payment window.
  • lastUnderlyingTimestamp: Last underlying timestamp in the valid payment window.
  • paymentReference: Payment reference that must be used in the underlying payment.
  • executor: Address allowed to execute redemption default (besides redeemer and agent).
  • executorFeeNatWei: Fee paid to the executor in NAT wei.
  • destinationTag: Destination tag required for the XRP payment.
event RedemptionWithTagRequested(
    address indexed agentVault,
    address indexed redeemer,
    uint256 indexed requestId,
    string paymentAddress,
    uint256 valueUBA,
    uint256 feeUBA,
    uint256 firstUnderlyingBlock,
    uint256 lastUnderlyingBlock,
    uint256 lastUnderlyingTimestamp,
    bytes32 paymentReference,
    address executor,
    uint256 executorFeeNatWei,
    uint256 destinationTag
);

RedemptionTicketCreated​

This event is emitted when a redemption ticket is created, when a minting transaction is executed.

Parameters:

event RedemptionTicketCreated(
    address indexed agentVault,
    uint256 indexed redemptionTicketId,
    uint256 ticketValueUBA);

RedemptionTicketUpdated​

Event emitted when a redemption ticket value is changed (partially redeemed).

Parameters:

  • agentVault: The address of the agent vault that will redeem the FAssets.
  • redemptionTicketId: The ID of the redemption ticket.
  • ticketValueUBA: The value of the redemption ticket in the underlying chain currency.
event RedemptionTicketUpdated(
    address indexed agentVault,
    uint256 indexed redemptionTicketId,
    uint256 ticketValueUBA);

RedemptionPerformed​

The event is emitted when the agent provides proof of redemption payment, and the agent's collateral is released.

event RedemptionPerformed(
    address indexed agentVault,
    address indexed redeemer,
    uint64 indexed requestId,
    bytes32 transactionHash,
    uint256 redemptionAmountUBA,
    int256 spentUnderlyingUBA);

RedemptionRejected​

Emitted when an agent rejects a redemption request due to an invalid redeemer address.

Parameters:

  • agentVault: Address of the agent vault that rejected the redemption.
  • redeemer: Address of the user attempting to redeem (invalid address).
  • requestId: Unique identifier for the redemption request.
  • redemptionAmountUBA: Amount of FAssets that were requested for redemption.
event RedemptionRejected(
    address indexed agentVault,
    address indexed redeemer,
    uint256 indexed requestId,
    uint256 redemptionAmountUBA
);

RedemptionRequestIncomplete​

Emitted when a redemption request cannot be fully processed due to insufficient tickets or exceeding allowed redemption limits.

Parameters:

  • redeemer: Address of the user who requested the redemption.
  • remainingLots: Number of FAsset lots that could not be redeemed and are returned to the redeemer.
event RedemptionRequestIncomplete(
    address indexed redeemer,
    uint256 remainingLots
);

RedemptionAmountIncomplete​

Emitted when only a partial redemption can occur, for instance, if there are insufficient redemption tickets or if fulfilling the entire request would exceed the allowed ticket limit.

Parameters:

  • redeemer: Address of the user who requested redemption.
  • remainingAmountUBA: Amount (UBA) that could not be redeemed and is returned.
event RedemptionAmountIncomplete(
    address indexed redeemer,
    uint256 remainingAmountUBA
);

RedemptionDefault​

Emitted when a redemption payment times out and the redeemer is compensated with collateral instead.

Parameters:

  • agentVault: Address of the agent vault that failed to complete the payment.
  • redeemer: Address of the user who requested the redemption.
  • requestId: Unique identifier for the redemption request.
  • redemptionAmountUBA: Amount of FAssets that were requested for redemption.
  • redeemedVaultCollateralWei: Amount of collateral paid from the agent's vault.
  • redeemedPoolCollateralWei: Amount of collateral paid from the collateral pool.
event RedemptionDefault(
    address indexed agentVault,
    address indexed redeemer,
    uint256 indexed requestId,
    uint256 redemptionAmountUBA,
    uint256 redeemedVaultCollateralWei,
    uint256 redeemedPoolCollateralWei
);

RedemptionPaymentBlocked​

Emitted when a redemption payment fails due to the redeemer's address being blocked or gas limit issues.

Parameters:

  • agentVault: Address of the agent vault that attempted the payment.
  • redeemer: Address of the user who requested the redemption.
  • requestId: Unique identifier for the redemption request.
  • transactionHash: Hash of the failed transaction on the underlying chain.
  • redemptionAmountUBA: Amount of FAssets that were requested for redemption.
  • spentUnderlyingUBA: Amount of underlying currency spent in the failed attempt (negative value).
event RedemptionPaymentBlocked(
    address indexed agentVault,
    address indexed redeemer,
    uint256 indexed requestId,
    bytes32 transactionHash,
    uint256 redemptionAmountUBA,
    int256 spentUnderlyingUBA
);

RedemptionPaymentFailed​

Emitted when a redemption payment fails due to the agent's own error.

Parameters:

  • agentVault: Address of the agent vault that failed the payment.
  • redeemer: Address of the user who requested the redemption.
  • requestId: Unique identifier for the redemption request.
  • transactionHash: Hash of the failed transaction on the underlying chain.
  • spentUnderlyingUBA: Amount of underlying currency spent in the failed attempt (negative value).
  • failureReason: Human-readable description of why the payment failed.
event RedemptionPaymentFailed(
    address indexed agentVault,
    address indexed redeemer,
    uint256 indexed requestId,
    bytes32 transactionHash,
    int256 spentUnderlyingUBA,
    string failureReason
);

RedemptionPoolFeeMinted​

Emitted when part of the redemption fee is re-minted as FAssets and paid to the agent's collateral pool.

Parameters:

  • agentVault: Address of the agent vault that completed the redemption.
  • requestId: Unique identifier for the redemption request.
  • poolFeeUBA: Amount of FAssets re-minted and paid as a fee to the collateral pool.
event RedemptionPoolFeeMinted(
    address indexed agentVault,
    uint256 indexed requestId,
    uint256 poolFeeUBA
);

RedeemedInCollateral​

Emitted when FAssets are redeemed in collateral during a self-close exit process.

Parameters:

  • agentVault: Address of the agent vault that processed the redemption.
  • redeemer: Address of the user who requested the redemption.
  • redemptionAmountUBA: Amount of FAssets that were redeemed.
  • paidVaultCollateralWei: Amount of collateral paid from the agent's vault.
event RedeemedInCollateral(
    address indexed agentVault,
    address indexed redeemer,
    uint256 redemptionAmountUBA,
    uint256 paidVaultCollateralWei
);