update wip

FIPS/fip-tbd.md

@@ -1,26 +1,27 @@
 ---
 fip: "tbd"
-title: More API between user-programmed actors and built-in miner actor for building decentralized staking protocol 
-author:  @Schwartz10, @jennijuju
-discussions-to: 
+title: Export sector termination method from miner acto
+author:  @jennijuju, @Schwartz10, @anorth
+discussions-to: https://github.com/filecoin-project/FIPs/discussions/1034
 status: Draft
-type: https://github.com/filecoin-project/FIPs/discussions/1034
+type: Technical
 category (*only required for Standard Track): <Core>
 created: 2024-07-12
 ---
 
 
-# FIP-TBD:  More API between user-programmed actors and built-in miner actors for building decentralized staking protocol
+# FIP-TBD:  Export sector termination method from miner actor
 
 ## Simple Summary
 
-Export additional built-in miner actor methods for invocation by user actors, so to enable more decentralized DeFi protocol for Storage Provider (SP) services.
+Adds a new `TerminateSectors2` (method 37) that allow callers define the max amount of sector termination to execute immediately.
+Export additional built-in miner actor methods, including the new `TerminateSectors` method for invocation by user actors, so to enable more decentralized DeFi protocol for Storage Provider (SP) services.
 
 ## Abstract
 
 Upon the FEVM launch, [FIP-0050](https://github.com/filecoin-project/FIPs/blob/master/FIPS/fip-0050.md) was also introduced with a list of the builtin actor methods that are exposed as callables from user actors. Since then,  we’ve seen a number of protocols build lending or leasing applications around Miner Actors collateral & rewards. As common practice in DeFi, protocols often introduce a “liquidation” procedure that liquidates a borrower’s collateral to derisk the liquidity providers from losing lent out funds. In the process of Filecoin leasing applications, a liquidation means termination of a miner’s active sectors, facing a penalty, but recovering pledged collateral to return to liquidity providers.  Economic security of applications being built on the FEVM is important for developing trust and attracting outside capital / liquidity / investors, and understanding precise collateral values for any given miner actor is critical for a DeFi protocol’s economic security. 
 
-This FIP aims to introduce more exported APIs in miner actor for supporting onchain liquidation procedure for decentralized staking protocol.
+This FIP aims to introduce more exported APIs in miner actor for supporting onchain liquidation procedure for decentralized staking protocol. The main one, is a method that allows user actors to terminate sectors.
 
 ## Change Motivation
 
@@ -42,9 +43,16 @@ This FIPs propose builtin actors APIs that can provide information/functionaliti
 
 Following the FIP-0050 specification for exported builin actor methods in, we add a set of additional methods.
 
-### Operation 
+**TerminateSectors2** In Miner Actor
 
-**TerminateSectors** In Miner Actor
+To allow caller (storage providers, stake pools and etc) to have more precised control over the amount of the sectors to be terminated based on their operational needs, this FIP introduces a new `TerminateSector2` method. This method follows most of the behaviour of the existing `TerminateSectors` method, notably:
+- Only a control address of the miner actor can call this method.
+- Terminating sectors that is in the current or the next deadline to prove will fail with `USR_ILLEGAL_ARGUMENT`.
+- The method will always process the sector that is already in the `early_termination` queue before processing newly submitted sectors.
+
+This FIP proposes the following behaviour changes:
+- Currently, `TerminateSectors` allows callers to submit early termination for at most 3000 sectors in one messsage. `TerminateSectors2` will remove this hardcoded  It takes a `max_termination` /...
+- It will not add sectors to the terminatoon queue.
 
 Export the existing TerminateSectors method with the following change:
 
@@ -81,6 +89,8 @@ Update the return value of the method to include sector numbers that are success
 
 This FIP introduces new builtin actor methods, therefore needs a new actors version shipped in a network upgrade. No breaking changes to existing methods, however.
 
+This FIP does not require a state migration.
+
 ## Test Cases
 
 - User actors can call all exported methods
@@ -93,7 +103,7 @@ No new method is being introduced that can be used to attack the network, and bu
 
 ## Product and Incentive Considerations
 
-This FIP enables more trustless and decentralized staking and DeFi protocol for token holders to partipate in. Staking and Defi protocol can drive Filecoin onchain activities, improve FIL utilities and enabling more (1) storage providers to get liquidity to join the network and prvoide storage services & secure the network consensus (2) token holders to put their FIL into use and improve Filecoin GDP. 
+This FIP enables more trustless and decentralized staking and DeFi protocol for token holders to partipate in. Staking and Defi protocol can drive Filecoin onchain activities, improve FIL utilities and enabling more (1) storage providers to get liquidity to join the network and provide storage services & secure the network consensus (2) token holders to put their FIL into use and improve Filecoin GDP. 
 
 
 ## Implementation