@venusprotocol/liquidity-hub 2.1.0-dev.6 → 2.1.0-dev.8

package/contracts/interfaces/IMigrator.sol

@@ -7,8 +7,10 @@ pragma solidity 0.8.25;
  * @notice One-click migration from an existing Venus Core position into a Liquidity Hub. In a
  *         single atomic transaction the Migrator pulls a user's Core vToken, redeems it to the
  *         underlying, and deposits that into the matching Hub, minting share tokens to `receiver`.
- * @dev A single immutable, permissionless deployment serves every Hub — the target is chosen per
- *      call via the `hub` argument. Two paths exist because Venus splits its markets by asset type:
+ * @dev A single immutable, permissionless deployment serves every registered Hub — the target is
+ *      chosen per call via the `hub` argument and must be present in the HubRegistry, so a migration
+ *      can only ever land in a governance-registered Hub. Two paths exist because Venus splits its
+ *      markets by asset type:
  *      ERC-20-backed markets (vUSDT, vUSDC, ...) go through {migrateFromCore}; the native market
  *      (vBNB) redeems raw BNB and so has the dedicated {migrateFromCoreBNB} path that wraps to WBNB
  *      before depositing into the WBNB Hub.
@@ -36,6 +38,8 @@ interface IMigrator {
     error ZeroAddress();
     /// @notice A required amount argument was zero.
     error ZeroAmount();
+    /// @notice The target `hub` is not a governance-registered Hub in the HubRegistry.
+    error HubNotRegistered(address hub);
     /// @notice The vToken's underlying does not match the Hub's asset.
     error AssetMismatch(address vTokenUnderlying, address hubAsset);
     /// @notice The Core market returned a non-zero (failure) error code on redeem.
@@ -44,8 +48,6 @@ interface IMigrator {
     error NothingReceived();
     /// @notice The minted shares were below the caller's `minShares` floor.
     error InsufficientShares(uint256 shares, uint256 minShares);
-    /// @notice The native (vBNB → WBNB) path is unavailable: this deployment has no WBNB/vBNB wired.
-    error BNBMigrationUnsupported();
     /// @notice Native value was received from an address other than the configured vBNB market.
     error OnlyVBNB();
 
@@ -95,8 +97,8 @@ interface IMigrator {
     /**
      * @notice Migrate a native vBNB position into the WBNB Hub.
      * @dev Caller must first `approve` this Migrator to transfer `vBNBAmount` of the configured
-     *      vBNB market. The redeemed BNB is wrapped to WBNB before deposit. Reverts unless this
-     *      deployment has WBNB/vBNB wired, `IHub(hub).asset() == WBNB`, and `shares >= minShares`.
+     *      vBNB market. The redeemed BNB is wrapped to WBNB before deposit. Reverts unless `hub` is a
+     *      registered WBNB Hub (`IHub(hub).asset() == WBNB`) and `shares >= minShares`.
      *      This is the no-consent path — use {migrateFromCoreBNBWithConsent} to record consent.
      * @param vBNBAmount vBNB receipts to pull and redeem.
      * @param hub The WBNB Hub to deposit into.

package/contracts/interfaces/INavGuard.sol

@@ -9,8 +9,9 @@ pragma solidity 0.8.25;
  * @dev The band vouches for a value: the last counterparty figure we accepted, grown at the
  *      expected rate, plus whatever we have moved in or out since. Valuation is held a gap either
  *      side of that, `min(max(observed, floor), cap)`, and never reverts. The gaps are a percentage
- *      of the counterparty's part only, so our own moves never widen them. Take everything out and
- *      the band closes; a deposit or governance reopens it.
+ *      of `anchor`. Our own moves shift only `centre`, so they do not widen the gaps until the next
+ *      re-anchor, which adopts the whole position as the new `anchor`. Take everything out and the
+ *      band closes; a deposit or governance reopens it.
  *
  *      It bounds value, not price: a position marked as `quantity x price` can be inflated
  *      through either factor. Value is the product plus whatever has no price at all, so one band
@@ -46,9 +47,9 @@ interface INavGuard {
      *      `anchor` and `centre` are stored as of `driftFrom`, and each grows at `driftBps` from
      *      there when read. A closed band has both at zero: every armed side then values the
      *      position at nothing, and only a deposit or {setNavGuardSnapshot} reopens it.
-     * @param anchor The counterparty's part of the position: the value accepted at the last
-     *        re-anchor, or forced by governance, less what withdrawals have since taken past our own
-     *        deposits. Never above `centre`. Both gaps are sized to it.
+     * @param anchor The whole position value accepted at the last re-anchor, or forced by
+     *        governance, less what withdrawals have since taken past our own deposits. Never above
+     *        `centre`. Both gaps are sized to it.
      * @param centre `anchor` plus our own deposits since. What valuation is held around.
      * @param anchoredAt When `anchor` was last set. `interval` is measured from here, and only a
      *        re-anchor moves it, so our own flows can never delay or bring one forward.
@@ -124,10 +125,10 @@ interface INavGuard {
 
     /**
      * @notice We moved value into or out of a resource, and its centre moved by exactly that. The
-     *         clock is untouched, and the anchor moves only when a withdrawal reaches into the
-     *         counterparty's part.
+     *         clock is untouched, and the anchor moves only when a withdrawal takes more than our
+     *         own deposits since the last re-anchor.
      * @param resource Resource whose centre moved.
-     * @param anchor The counterparty's part after the move. Zero right after a deposit means the
+     * @param anchor The anchor after the move. Zero right after a deposit means the
      *        deposit opened the band, and the band has no width until its first re-anchor.
      * @param centre New stored centre, before drift.
      */

package/contracts/interfaces/IResourceAdapter.sol

@@ -103,6 +103,16 @@ interface IResourceAdapter {
      */
     function totalAssets(address resource, address holder) external view returns (uint256 value);
 
+    /**
+     * @notice Underlying value of `shares` receipt tokens of `resource`, priced exactly as
+     *         {totalAssets} prices a holder's balance. Lets the YieldGroup value the receipts it
+     *         minted itself rather than everything its wallet happens to hold.
+     * @param resource Underlying yield protocol address.
+     * @param shares Receipt-token amount to price, in the resource's own units.
+     * @return value Underlying units `shares` are worth.
+     */
+    function receiptValue(address resource, uint256 shares) external view returns (uint256 value);
+
     /**
      * @notice Spare deposit headroom on `resource` right now (capacity remaining before the
      *         resource rejects mint via its own caps or pause).
@@ -137,9 +147,8 @@ interface IResourceAdapter {
     /**
      * @notice Raw receipt-token balance `holder` owns via `resource` (vToken / fToken / FRV
      *         shares), in receipt-token units — NOT underlying value.
-     * @dev Used by `YieldGroup.removeResource` as a share-based emptiness gate. A value-based
-     *      check (`totalAssets`) rounds a small-but-non-zero receipt balance down to 0, which
-     *      would let removal orphan those receipt tokens; reading the raw balance closes that gap.
+     * @dev In share units so a sub-unit residual still reads as non-zero where a value read would
+     *      round it to 0.
      * @param resource Underlying yield protocol address.
      * @param holder Address whose receipt balance to read (the YieldGroup).
      * @return shares Receipt-token units `holder` holds in this resource.

package/contracts/interfaces/IYieldGroupBase.sol

@@ -138,6 +138,16 @@ interface IYieldGroupBase {
      */
     event Swept(address indexed token, address indexed to, uint256 amount);
 
+    /**
+     * @notice Governance synced the tracked receipt balance of `resource` with what it holds, so
+     *         receipt tokens that arrived outside the deposit path now count toward the Hub's share
+     *         price, up to the cap the sync was given.
+     * @param resource Resource whose tracked balance was synced.
+     * @param oldShares Tracked receipt balance before the sync.
+     * @param newShares Tracked receipt balance after the sync.
+     */
+    event ReceiptSynced(address indexed resource, uint256 oldShares, uint256 newShares);
+
     // -------------------------------- Errors ----------------------------------
 
     /// @notice Caller of an `onlyHub` function was not the registered Hub.
@@ -188,9 +198,10 @@ interface IYieldGroupBase {
     error ResourceNotRegistered(address resource);
 
     /**
-     * @notice `removeResource()` called while the resource still holds a non-zero balance.
+     * @notice `removeResource()` called while the YieldGroup still accounts for receipts of the
+     *         resource (the tracked ledger for a tracking family, the wallet balance otherwise).
      * @param resource Resource attempted to be removed.
-     * @param balance Current resource balance preventing removal.
+     * @param balance Accounted receipt balance preventing removal, in the resource's share units.
      */
     error ResourceHasBalance(address resource, uint256 balance);
 
@@ -246,8 +257,8 @@ interface IYieldGroupBase {
     error InvalidQueue();
 
     /**
-     * @notice Withdraw queue omits a resource still holding receipt tokens, which the cascade would
-     *         then not visit.
+     * @notice Withdraw queue omits a resource whose accounted receipts are non-zero (the tracked
+     *         ledger for a tracking family, the wallet otherwise), which the cascade would then not visit.
      * @param resource The funded resource missing from the queue.
      */
     error WithdrawQueueOmitsFundedResource(address resource);
@@ -266,6 +277,10 @@ interface IYieldGroupBase {
     ///         `totalAssets` and must never be sweepable.
     error SweepProtectedAsset();
 
+    /// @notice `syncReceipt` was called on a family that values positions by holder, not by tracked
+    ///         receipts (Centrifuge), where the sync would write a slot nothing reads.
+    error ReceiptTrackingOff();
+
     /**
      * @notice `sweep()` targeted a registered resource. In every family the resource address is the
      *         receipt token backing `totalAssets`, so sweeping it would drain the YieldGroup.
@@ -361,7 +376,9 @@ interface IYieldGroupBase {
     function addResource(address resource, address adapter) external;
 
     /**
-     * @notice Remove a registered resource. Requires zero balance held in that resource.
+     * @notice Remove a registered resource. Requires the YieldGroup to account for no receipts of it:
+     *         the tracked ledger for a tracking family, the wallet balance otherwise. Receipts that
+     *         arrived outside the deposit path do not block removal and are sweepable afterwards.
      * @dev ACM role `"removeResource(address)"` (VIP). Also removes the resource from both
      *      inner queues via swap-and-pop. Emits {ResourceRemoved}.
      * @param resource Resource to remove.
@@ -433,6 +450,27 @@ interface IYieldGroupBase {
      */
     function sweep(address token, address to) external;
 
+    /**
+     * @notice Set the tracked receipt balance of `resource` to what it holds, adding at most
+     *         `maxAdded`. This admits receipt tokens that arrived outside the deposit path (a
+     *         donation, a mistransfer) into the Hub's share price; until then they sit on the
+     *         YieldGroup uncounted.
+     * @dev ACM role `"syncReceipt(address,uint256)"` (VIP). Emits {ReceiptSynced}. Reverts
+     *      {ReceiptTrackingOff} on a family that does not track receipts.
+     *
+     *      `maxAdded` caps the sync at the amount governance reviewed. A VIP executes days after it
+     *      is proposed, and anything sent in meanwhile, including over-priced receipts from a market
+     *      carrying bad debt, stays uncounted above the cap. It is a cap rather than an exact match,
+     *      so a single extra wei sent in before execution cannot make the sync revert.
+     *
+     *      `type(uint256).max` syncs the whole wallet. The upgrade that introduced tracking needs it:
+     *      every tracked balance starts at 0 there, and the wallet at execution cannot be known when
+     *      the VIP is proposed. The old code already priced the whole wallet, so it admits nothing new.
+     * @param resource Registered resource to sync.
+     * @param maxAdded Most receipts this sync may add to the tracked balance.
+     */
+    function syncReceipt(address resource, uint256 maxAdded) external;
+
     // ---------------------------------- Views --------------------------------
 
     /**
@@ -442,9 +480,11 @@ interface IYieldGroupBase {
     function asset() external view returns (address underlying);
 
     /**
-     * @notice Sum of `asset` held across all of this YieldGroup's underlying vaults.
+     * @notice Underlying value of the receipts this YieldGroup accounts for across its resources,
+     *         plus its idle `asset` balance. A tracking family prices only the receipts its own
+     *         deposits minted; Centrifuge prices its whole wallet.
      * @dev Hub sums `totalAssets()` over its registered YieldGroups to compute its own totalAssets().
-     * @return total Asset units currently held by the YieldGroup.
+     * @return total Asset units the YieldGroup accounts for.
      */
     function totalAssets() external view returns (uint256 total);
 
@@ -502,6 +542,15 @@ interface IYieldGroupBase {
      */
     function resourceConfig(address resource) external view returns (bool registered, bool paused, address adapter);
 
+    /**
+     * @notice Receipt tokens of `resource` that count toward `totalAssets()`: those this YieldGroup
+     *         minted through its own deposits, net of what it redeemed. Always 0 for a family that
+     *         does not track receipts (Centrifuge), which prices its wallet instead.
+     * @param resource Resource to look up.
+     * @return shares Tracked receipt balance, in the resource's own share units.
+     */
+    function trackedReceipt(address resource) external view returns (uint256 shares);
+
     /// @notice Current inner deposit-routing order.
     /// @return queue Storage copy of the inner deposit queue.
     function innerDepositQueue() external view returns (address[] memory queue);

package/contracts/interfaces/external/IVToken.sol

@@ -104,6 +104,15 @@ interface IVToken {
      */
     function getCash() external view returns (uint256 cash);
 
+    /**
+     * @notice Protocol reserves held inside `getCash()`.
+     * @dev `accrueInterest` sends them out of cash to the ProtocolShareReserve once
+     *      `reduceReservesBlockDelta` blocks have elapsed, so a redeem can only count on
+     *      `getCash() - totalReserves()`.
+     * @return reserves Underlying units reserved for the protocol.
+     */
+    function totalReserves() external view returns (uint256 reserves);
+
     /**
      * @notice The ERC-20 underlying token. Reverts for vBNB (which has no `underlying`
      *         accessor); the Core Yield Group v1 uses this revert as a guard against vBNB

package/contracts/migrator/Migrator.sol

@@ -6,6 +6,7 @@ import { SafeERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.s
 import { ReentrancyGuard } from "@openzeppelin/contracts/security/ReentrancyGuard.sol";
 
 import { IHub } from "../interfaces/IHub.sol";
+import { IHubRegistry } from "../interfaces/IHubRegistry.sol";
 import { IMigrator } from "../interfaces/IMigrator.sol";
 import { IVBep20 } from "../interfaces/external/IVBep20.sol";
 import { IWBNB } from "../interfaces/external/IWBNB.sol";
@@ -14,12 +15,16 @@ import { IWBNB } from "../interfaces/external/IWBNB.sol";
  * @title Migrator
  * @author Venus
  * @notice One-click migration from a Venus Core position into a Liquidity Hub. A single immutable,
- *         permissionless deployment serves every Hub; the target Hub is supplied per call.
+ *         permissionless deployment serves every registered Hub; the target Hub is supplied per call
+ *         and must be present in the HubRegistry.
  * @dev Stateless by design — no proxy, no admin, no funds held between calls. Each migration is
  *      atomic: pull the user's vToken, redeem it to the underlying, deposit that into the Hub, and
  *      mint shares straight to the receiver. If any leg fails the whole call reverts and the user
  *      keeps their vToken.
  *
+ *      The target `hub` is checked against the immutable {HUB_REGISTRY} before any funds move, so a
+ *      migration can only land in a Hub governance has registered.
+ *
  *      Accounting is done by balance delta, never by a self-reported amount: Core `redeem` returns
  *      a Compound error code (not the redeemed amount) and silently nets out any Comptroller
  *      treasury fee, so the Migrator measures what actually arrived and deposits exactly that. The
@@ -34,16 +39,24 @@ import { IWBNB } from "../interfaces/external/IWBNB.sol";
 contract Migrator is IMigrator, ReentrancyGuard {
     using SafeERC20 for IERC20;
 
-    /// @notice Canonical wrapped-native token; `address(0)` disables the native path.
+    /// @notice Governance-curated directory of valid Hubs.
+    IHubRegistry public immutable HUB_REGISTRY;
+    /// @notice Canonical wrapped-native token (WBNB).
     IWBNB public immutable WBNB;
-    /// @notice Canonical Venus native market (vBNB); `address(0)` disables the native path.
+    /// @notice Canonical Venus native market (vBNB).
     IVBep20 public immutable VBNB;
 
     /**
-     * @param wbnb_ Wrapped-native token, or `address(0)` on chains/deployments with no WBNB Hub.
-     * @param vbnb_ Venus native market (vBNB), or `address(0)` to leave the native path disabled.
+     * @param wbnb_ Wrapped-native token (WBNB). Mandatory; the constructor reverts on the zero address.
+     * @param vbnb_ Venus native market (vBNB). Mandatory; the constructor reverts on the zero address.
+     * @param hubRegistry_ The HubRegistry every migration target is validated against. Mandatory;
+     *        the constructor reverts on the zero address, since without it no Hub would be accepted.
      */
-    constructor(IWBNB wbnb_, IVBep20 vbnb_) {
+    constructor(IWBNB wbnb_, IVBep20 vbnb_, IHubRegistry hubRegistry_) {
+        if (address(wbnb_) == address(0) || address(vbnb_) == address(0) || address(hubRegistry_) == address(0)) {
+            revert ZeroAddress();
+        }
+        HUB_REGISTRY = hubRegistry_;
         WBNB = wbnb_;
         VBNB = vbnb_;
     }
@@ -111,6 +124,7 @@ contract Migrator is IMigrator, ReentrancyGuard {
             revert ZeroAddress();
         }
         if (vTokenAmount == 0) revert ZeroAmount();
+        if (!HUB_REGISTRY.isHub(hub)) revert HubNotRegistered(hub);
 
         address asset = IHub(hub).asset();
         address vTokenUnderlying = IVBep20(vToken).underlying();
@@ -135,11 +149,9 @@ contract Migrator is IMigrator, ReentrancyGuard {
         private
         returns (uint256 shares)
     {
-        if (address(WBNB) == address(0) || address(VBNB) == address(0)) {
-            revert BNBMigrationUnsupported();
-        }
         if (hub == address(0) || receiver == address(0)) revert ZeroAddress();
         if (vBNBAmount == 0) revert ZeroAmount();
+        if (!HUB_REGISTRY.isHub(hub)) revert HubNotRegistered(hub);
 
         address asset = IHub(hub).asset();
         if (asset != address(WBNB)) revert AssetMismatch(address(WBNB), asset);

package/deployments/bscmainnet/AdapterCoreV1.json

@@ -1,6 +1,6 @@
 {
-  "address": "0xa061cC2F62BDa2D6bA53Fb98847aD9822DA085dd",
-  "block": 123325056,
+  "address": "0x0f62927d18Fd35712622C2c6C3F730EB8a18b71B",
+  "block": 132740470,
   "chainId": 56,
   "contract": "AdapterCoreV1",
   "abi": [
@@ -158,6 +158,30 @@
       ],
       "stateMutability": "view"
     },
+    {
+      "type": "function",
+      "name": "receiptValue",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "vBal",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
     {
       "type": "function",
       "name": "resourceName",

package/deployments/bscmainnet/AdapterFRV.json

@@ -1,6 +1,6 @@
 {
-  "address": "0x1824caA965Ac05ae5C9C2819e045337e2cF5657c",
-  "block": 123325056,
+  "address": "0x40fDc0fef94D607EE4341230afb09bcDB0B949E2",
+  "block": 132740470,
   "chainId": 56,
   "contract": "AdapterFRV",
   "abi": [
@@ -132,6 +132,30 @@
       ],
       "stateMutability": "view"
     },
+    {
+      "type": "function",
+      "name": "receiptValue",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "shares",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
     {
       "type": "function",
       "name": "resourceName",

package/deployments/bscmainnet/AdapterFlux.json

@@ -1,6 +1,6 @@
 {
-  "address": "0x9a1a7F6aebA4a1A3e85Ae1Dba90a7A2A52803404",
-  "block": 123325056,
+  "address": "0x4Afb747ce8dDef689d5484FFdfB69Ac8bC7cAc8B",
+  "block": 132740470,
   "chainId": 56,
   "contract": "AdapterFlux",
   "abi": [
@@ -151,6 +151,30 @@
       ],
       "stateMutability": "view"
     },
+    {
+      "type": "function",
+      "name": "receiptValue",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "shares",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
     {
       "type": "function",
       "name": "resourceName",

package/deployments/bscmainnet/AdapterSpokeV1.json

@@ -1,6 +1,6 @@
 {
-  "address": "0x231915FfE3e3A6Be09B0E5c73EFA2F1a4FF8Aa69",
-  "block": 127748551,
+  "address": "0xD08596E58325724C824100bA87f2470493Fe342d",
+  "block": 132740470,
   "chainId": 56,
   "contract": "AdapterSpokeV1",
   "abi": [
@@ -158,6 +158,30 @@
       ],
       "stateMutability": "view"
     },
+    {
+      "type": "function",
+      "name": "receiptValue",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "vBal",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
     {
       "type": "function",
       "name": "resourceName",

package/deployments/bscmainnet/Migrator.json

@@ -1,6 +1,6 @@
 {
-  "address": "0xfe6b8BEf1215C19Cd247FbF495ef560932F1Eb9B",
-  "block": 112781054,
+  "address": "0xb0D77DC86d4E6a8282eECF3d4d456B3b94F2a7aD",
+  "block": 115268335,
   "chainId": 56,
   "contract": "Migrator",
   "abi": [
@@ -16,6 +16,11 @@
           "name": "vbnb_",
           "type": "address",
           "internalType": "contract IVBep20"
+        },
+        {
+          "name": "hubRegistry_",
+          "type": "address",
+          "internalType": "contract IHubRegistry"
         }
       ],
       "stateMutability": "nonpayable"
@@ -24,6 +29,19 @@
       "type": "receive",
       "stateMutability": "payable"
     },
+    {
+      "type": "function",
+      "name": "HUB_REGISTRY",
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "",
+          "type": "address",
+          "internalType": "contract IHubRegistry"
+        }
+      ],
+      "stateMutability": "view"
+    },
     {
       "type": "function",
       "name": "VBNB",
@@ -292,8 +310,14 @@
     },
     {
       "type": "error",
-      "name": "BNBMigrationUnsupported",
-      "inputs": []
+      "name": "HubNotRegistered",
+      "inputs": [
+        {
+          "name": "hub",
+          "type": "address",
+          "internalType": "address"
+        }
+      ]
     },
     {
       "type": "error",

package/deployments/bscmainnet/YieldGroupCoreImpl.json

@@ -1,6 +1,6 @@
 {
-  "address": "0x3BccED778CAaf97AE8ff8Bedc16d2165aA15771b",
-  "block": 112779813,
+  "address": "0xedB1c751Eb03274e9D15D0609B4593CC113fB09F",
+  "block": 132740470,
   "chainId": 56,
   "contract": "YieldGroup",
   "abi": [
@@ -460,6 +460,24 @@
       "outputs": [],
       "stateMutability": "nonpayable"
     },
+    {
+      "type": "function",
+      "name": "syncReceipt",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "maxAdded",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
     {
       "type": "function",
       "name": "totalAssets",
@@ -473,6 +491,25 @@
       ],
       "stateMutability": "view"
     },
+    {
+      "type": "function",
+      "name": "trackedReceipt",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
     {
       "type": "function",
       "name": "unpauseResource",
@@ -622,6 +659,31 @@
       ],
       "anonymous": false
     },
+    {
+      "type": "event",
+      "name": "ReceiptSynced",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "indexed": true,
+          "internalType": "address"
+        },
+        {
+          "name": "oldShares",
+          "type": "uint256",
+          "indexed": false,
+          "internalType": "uint256"
+        },
+        {
+          "name": "newShares",
+          "type": "uint256",
+          "indexed": false,
+          "internalType": "uint256"
+        }
+      ],
+      "anonymous": false
+    },
     {
       "type": "event",
       "name": "ResourceAccrualFailed",
@@ -897,6 +959,11 @@
       "name": "OnlySelf",
       "inputs": []
     },
+    {
+      "type": "error",
+      "name": "ReceiptTrackingOff",
+      "inputs": []
+    },
     {
       "type": "error",
       "name": "ResourceAlreadyRegistered",