Split FlowALPv0 further: extract health math and position resources

cadence/contracts/FlowALPModels.cdc

@@ -2073,6 +2073,49 @@ access(all) contract FlowALPModels {
         }
     }
 
+    /* --- POSITION POOL API --- */
+
+    /// PositionPool defines the subset of Pool functionality required by user-held Position wrappers.
+    /// This interface is intentionally narrow so Position resources can live outside the main ALP contract.
+    access(all) resource interface PositionPool {
+
+        /// Locks a position for mutation.
+        access(EPosition) fun lockPosition(_ pid: UInt64)
+
+        /// Unlocks a position after mutation.
+        access(EPosition) fun unlockPosition(_ pid: UInt64)
+
+        /// Returns details for a position.
+        access(all) fun getPositionDetails(pid: UInt64): PositionDetails
+
+        /// Returns currently available withdrawal capacity for a position/token pair.
+        access(all) fun availableBalance(pid: UInt64, type: Type, pullFromTopUpSource: Bool): UFix64
+
+        /// Returns current position health.
+        access(all) fun positionHealth(pid: UInt64): UFix128
+
+        /// Borrows an authorized internal position reference.
+        access(EPosition) view fun borrowPosition(pid: UInt64): auth(EImplementation) &{InternalPosition}
+
+        /// Deposits funds to a position and optionally pushes excess to draw-down sink.
+        access(EPosition) fun depositAndPush(
+            pid: UInt64,
+            from: @{FungibleToken.Vault},
+            pushToDrawDownSink: Bool
+        )
+
+        /// Withdraws funds from a position and optionally pulls deficit from top-up source.
+        access(EPosition) fun withdrawAndPull(
+            pid: UInt64,
+            type: Type,
+            amount: UFix64,
+            pullFromTopUpSource: Bool
+        ): @{FungibleToken.Vault}
+
+        /// Rebalances the specified position.
+        access(EPosition | ERebalance) fun rebalancePosition(pid: UInt64, force: Bool)
+    }
+
     /// Factory function to create a new InternalPositionImplv1 resource.
     /// Required because Cadence resources can only be created within their containing contract.
     access(all) fun createInternalPosition(): @{InternalPosition} {

cadence/contracts/FlowALPRebalancerPaidv1.cdc

@@ -1,4 +1,5 @@
 import "FlowALPv0"
+import "FlowALPPositionResources"
 import "FlowALPModels"
 import "FlowALPRebalancerv1"
 import "FlowTransactionScheduler"
@@ -34,7 +35,7 @@ access(all) contract FlowALPRebalancerPaidv1 {
     /// Returns a RebalancerPaid resource; the underlying Rebalancer is stored in this contract and
     /// the first run is scheduled. Caller should register the returned uuid with a Supervisor.
     access(all) fun createPaidRebalancer(
-        positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPv0.Position>,
+        positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPPositionResources.Position>,
     ): @RebalancerPaid {
         assert(positionRebalanceCapability.check(), message: "Invalid position rebalance capability")
         let rebalancer <- FlowALPRebalancerv1.createRebalancer(

cadence/contracts/FlowALPRebalancerv1.cdc

@@ -1,5 +1,6 @@
 import "DeFiActions"
 import "FlowALPv0"
+import "FlowALPPositionResources"
 import "FlowALPModels"
 import "FlowToken"
 import "FlowTransactionScheduler"
@@ -131,7 +132,7 @@ access(all) contract FlowALPRebalancerv1 {
         access(all) var recurringConfig: {RecurringConfig}
 
         access(self) var _selfCapability: Capability<auth(FlowTransactionScheduler.Execute) &{FlowTransactionScheduler.TransactionHandler}>?
-        access(self) var _positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPv0.Position>
+        access(self) var _positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPPositionResources.Position>
         /// Scheduled transaction id -> ScheduledTransaction (used to cancel/refund).
         access(self) var scheduledTransactions: @{UInt64: FlowTransactionScheduler.ScheduledTransaction}
 
@@ -142,7 +143,7 @@ access(all) contract FlowALPRebalancerv1 {
 
         init(
             recurringConfig: {RecurringConfig},
-            positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPv0.Position>
+            positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPPositionResources.Position>
         ) {
             self._selfCapability = nil
             self.lastRebalanceTimestamp = getCurrentBlock().timestamp
@@ -328,7 +329,7 @@ access(all) contract FlowALPRebalancerv1 {
     /// call setSelfCapability with that capability, then call fixReschedule() to start the schedule.
     access(all) fun createRebalancer(
         recurringConfig: {RecurringConfig},
-        positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPv0.Position>,
+        positionRebalanceCapability: Capability<auth(FlowALPModels.ERebalance) &FlowALPPositionResources.Position>,
     ): @Rebalancer {
         let rebalancer <- create Rebalancer(
             recurringConfig: recurringConfig,