fix: update lockup period from 10 to 30 days

Author: ZenGround0

docs/src/content/docs/guides/rails-settlement.mdx

@@ -17,7 +17,7 @@ Rails ensure reliable payments through a simple lockup mechanism:
 
 When you create a data set (storage), the system calculates how much balance you need to maintain:
 
-- **Formula**: `lockup = paymentRate × lockupPeriod` (e.g., 10 days worth of payments)
+- **Formula**: `lockup = paymentRate × lockupPeriod` (e.g., 30 days worth of payments)
 - **Example**: Storing 1 GiB costs ~0.0000565 USDFC/epoch, requiring ~1.63 USDFC minimum balance
 - **Purpose**: This protects the service provider by ensuring you always have enough for the next payment period
 

packages/synapse-sdk/src/test/warm-storage-service.test.ts

@@ -1328,8 +1328,8 @@ describe('WarmStorageService', () => {
         assert.exists(check.depositAmountNeeded)
         assert.isTrue(check.depositAmountNeeded > 0n)
 
-        // depositAmountNeeded should equal 10 days of costs (default lockup)
-        const expectedDeposit = check.costs.perEpoch * BigInt(10) * BigInt(TIME_CONSTANTS.EPOCHS_PER_DAY)
+        // depositAmountNeeded should equal 30 days of costs (default lockup)
+        const expectedDeposit = check.costs.perEpoch * TIME_CONSTANTS.DEFAULT_LOCKUP_DAYS * TIME_CONSTANTS.EPOCHS_PER_DAY
         assert.equal(check.depositAmountNeeded.toString(), expectedDeposit.toString())
       })
 
@@ -1373,27 +1373,27 @@ describe('WarmStorageService', () => {
           return `0x${'0'.repeat(64)}`
         }
 
-        // Test with custom lockup period of 20 days
-        const customLockupDays = 20
+        // Test with custom lockup period of 60 days
+        const customLockupDays = TIME_CONSTANTS.DEFAULT_LOCKUP_DAYS * 2n
         const check = await warmStorageService.checkAllowanceForStorage(
           Number(SIZE_CONSTANTS.GiB), // 1 GiB
           false,
           mockPaymentsService,
-          customLockupDays
+          Number(customLockupDays)
         )
 
         // Verify depositAmountNeeded uses custom lockup period
-        const expectedDeposit = check.costs.perEpoch * BigInt(customLockupDays) * BigInt(TIME_CONSTANTS.EPOCHS_PER_DAY)
+        const expectedDeposit = check.costs.perEpoch * customLockupDays * TIME_CONSTANTS.EPOCHS_PER_DAY
         assert.equal(check.depositAmountNeeded.toString(), expectedDeposit.toString())
 
-        // Compare with default (10 days) to ensure they're different
+        // Compare with default (30 days) to ensure they're different
         const defaultCheck = await warmStorageService.checkAllowanceForStorage(
           Number(SIZE_CONSTANTS.GiB), // 1 GiB
           false,
           mockPaymentsService
         )
 
-        // Custom should be exactly 2x default (20 days vs 10 days)
+        // Custom should be exactly 2x default (60 days vs 30 days)
         assert.equal(check.depositAmountNeeded.toString(), (defaultCheck.depositAmountNeeded * 2n).toString())
       })
     })

packages/synapse-sdk/src/utils/constants.ts

@@ -115,7 +115,7 @@ export const TIME_CONSTANTS = {
   /**
    * Default lockup period in days
    */
-  DEFAULT_LOCKUP_DAYS: 10n,
+  DEFAULT_LOCKUP_DAYS: 30n,
 } as const
 
 /**

utils/README.md

@@ -192,7 +192,7 @@ Comprehensive demonstration of the enhanced payment APIs in the Synapse SDK.
 
 - **Balance**: USDFC deposited in the Payments contract for storage costs
 - **Rate Allowance**: Maximum per-epoch payment rate a service can set
-- **Lockup Allowance**: Security deposit (10 days of storage) locked during rail creation
+- **Lockup Allowance**: Security deposit (30 days of storage) locked during rail creation
 
 ## Development Notes