feat: add total locked token metrics

[pyropy]

Adds a totalFixedLockup and totalStreamingLockup properties to Token subgraph entity and displays "Total locked USDFC" and "Total locked FIL" token metrics on homepage.

Closes #100

[pyropy]

NOTE: This query is broken until we actually deploy new subgraph with totalLocked field.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
filecoin-pay-explorer	Ready	Preview, Comment	Feb 5, 2026 3:52pm

[silent-cipher]

Overall looks good to me!

[silent-cipher]

Why are we only updating totalStreamingLockup for non-terminated rails? Shouldn’t this be updated in both cases?

[pyropy]

If the rail has already been terminated, the lockup period may not be altered and the fixed lockup may only be reduced.

This is from docs for modifyRailLockup method.

[silent-cipher]

But this handler is for 'RailRateModified'.

[pyropy]

True, this shouldn't be called for terminated rails, but there's also other parts in this handler where the check is done

  const isTerminated = rail.state === "TERMINATED";
  if (!isTerminated) {
    updateOperatorRate(operatorApproval, oldRate, newRate);
    updateOperatorTokenRate(operatorToken, oldRate, newRate);

    if (payerToken) {
      payerToken.lockupRate = payerToken.lockupRate.minus(oldRate).plus(newRate);
      payerToken.save();
    }
  }

Should we just clear this handler to return early if rail state is terminated?

[silent-cipher]

I think the handler can still be triggered for terminated rails. modifyRailPayment is allowed for both terminated and non-terminated rails.
The key differences for terminated rails are:

• newRate must be lower than oldRate
• the effective lockup period becomes endEpoch - currentBlockNumber

Because of this, some updates still need to be guarded rather than returning early for terminated rails.

There was also an audit issue related to this behavior of updating terminated rail's rate- more context here

[pyropy]

Okay I see now.. I've mixed modifyRailLockup and modifyRailPayment 😮‍💨

[pyropy]

Fixed in fc4a45b