Skip to content

Commit

Permalink
add MIP
Browse files Browse the repository at this point in the history
  • Loading branch information
apenzk committed Jan 13, 2025
1 parent fcd37fa commit 4f91a19
Showing 1 changed file with 43 additions and 0 deletions.
43 changes: 43 additions & 0 deletions MIP/mip-x/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# MIP-\<number\>: Simplified Rate Limiter for the Lock/Mint Bridge

- **Description**: A simplified design for the rate limiter of the Lock/Mint bridge.
- **Authors**: Andreas Penzkofer, Primata
- **Desiderata**: [MD-74](https://github.com/movementlabsxyz/MIP/pull/74/files/MD/md-74/README.md)

## Abstract

The design in [MIP-74](https://github.com/movementlabsxyz/MIP/pull/74) considers that the insurance fund differs between the L1 and the L2. This MIP proposes a simplified design where the Insurance Fund is guaranteed to be the same on both sides.

## Motivation

In the design in [MIP-74](https://github.com/movementlabsxyz/MIP/pull/74) the rate limit is determined by the Insurance Fund on the target chain. The Governance Operator must ensure that the rate limit on the source chains is also set correctly. This means the Governance Operator is already active on both chain.

Moreover, we may assume that the inflow to and outflow from \$MOVE tokens is the same on average.

## Specification

_The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174._

The Insurance Fund MUST hold the same balance on L1 and L2. If so the rate limit on the source chain can be determined by the same method as on the target chain. This has the advantage, that the Governance Operator does not have to set the rate limint on the source chain, as requested in [MIP-74](https://github.com/movementlabsxyz/MIP/pull/74).

We define

- **incoming** as the direction for which funds are released / minted. I.e., the considered chain is a target chain for the given direction.
- **outgoing** as the direction for which funds are locked / burned. I.e., the considered chain is a source chain for the given direction.

The Insurance Fund on a given chain thus MUST be used to

- one half for the rate limit for incoming direction
- one half for the rate limit for outgoing direction

Moreover, if we reset the budget on a daily basis, for security reasons, we MUST only utilize one half of each direction's Insurance fund budget per day.

## Reference Implementation

## Verification

## Appendix

## Copyright

Copyright and related rights waived via [CC0](../LICENSE.md).

0 comments on commit 4f91a19

Please sign in to comment.