feat: add IsInDebt

Author: richardschneider

src/CoreApi/BitswapLedger.cs

@@ -56,6 +56,8 @@ public class BitswapLedger
         /// </summary>
         /// <value>
         ///   <see cref="DataSent"/> divided by <see cref="DataReceived"/>.
+        ///   A value less than 1 indicates that we are in debt to the 
+        ///   <see cref="Peer"/>.
         /// </value>
         public float DebtRatio
         {
@@ -65,5 +67,13 @@ public float DebtRatio
             }
         }
 
+        /// <summary>
+        ///   Determines if we owe the <see cref="Peer"/> some blocks.
+        /// </summary>
+        /// <value>
+        ///   <b>true</b> if we owe data to the peer; otherwise, <b>false</b>.
+        /// </value>
+        public bool IsInDebt => DebtRatio < 1;
+
     }
 }

test/CoreApi/BitswapLedgerTest.cs

@@ -19,20 +19,23 @@ public void Defaults()
             Assert.AreEqual(0ul, ledger.DataReceived);
             Assert.AreEqual(0ul, ledger.DataSent);
             Assert.AreEqual(0f, ledger.DebtRatio);
+            Assert.IsTrue(ledger.IsInDebt);
         }
 
         [TestMethod]
         public void DebtRatio_Positive()
         {
             var ledger = new BitswapLedger { DataSent = 1024 * 1024 };
             Assert.IsTrue(ledger.DebtRatio >= 1);
+            Assert.IsFalse(ledger.IsInDebt);
         }
 
         [TestMethod]
         public void DebtRatio_Negative()
         {
             var ledger = new BitswapLedger { DataReceived = 1024 * 1024 };
             Assert.IsTrue(ledger.DebtRatio < 1);
+            Assert.IsTrue(ledger.IsInDebt);
         }
     }
 }