@venusprotocol/liquidity-hub 2.0.0 → 2.1.0-dev.2

package/contracts/interfaces/external/ICentrifugeAsyncVault.sol

@@ -0,0 +1,94 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity 0.8.25;
+
+/**
+ * @title ICentrifugeAsyncVault
+ * @author Venus
+ * @notice Minimal ERC-7540 surface: only what `AdapterCentrifuge` calls on a Centrifuge async
+ *         vault (JTRSY / JAAA). Requests are asynchronous — a request escrows value with
+ *         Centrifuge, the fund manager fills it cross-chain, and a later claim collects the result.
+ * @dev Centrifuge's request id is always `0`, so the `requestId` parameters and return values here
+ *      carry no information. Per-position state (the pending and claimable buckets) does not live
+ *      on the vault: read it from `ICentrifugeAsyncRequestManager.investments(vault, controller)`,
+ *      on the manager this vault reports via `baseManager()`.
+ */
+interface ICentrifugeAsyncVault {
+    // ─────────────────────────── Requests ───────────────────────────
+
+    /// @notice Opens a deposit request: pulls `assets` from `owner` into Centrifuge's escrow and
+    ///         books them under `controller`'s `pendingDepositRequest`. The adapter passes the
+    ///         YieldGroup as both controller and owner.
+    function requestDeposit(uint256 assets, address controller, address owner) external returns (uint256 requestId);
+
+    /// @notice Opens a redeem request: escrows `shares` from `owner` and books them under
+    ///         `controller`'s `pendingRedeemRequest`.
+    function requestRedeem(uint256 shares, address controller, address owner) external returns (uint256 requestId);
+
+    // ──────────────────────────── Claims ────────────────────────────
+
+    /// @notice Claims the shares a filled deposit request issued, up to `maxMint`.
+    function mint(uint256 shares, address receiver, address controller) external returns (uint256 assets);
+
+    /// @notice Claims the assets a filled redeem request reserved, up to `maxWithdraw`.
+    function withdraw(uint256 assets, address receiver, address controller) external returns (uint256 shares);
+
+    // ─────────────────────────── Cancels ────────────────────────────
+
+    /// @notice Opens a cancel for the controller's pending deposit request. The returned assets
+    ///         become claimable only once the manager processes the cancel cross-chain.
+    function cancelDepositRequest(uint256 requestId, address controller) external;
+
+    /// @notice Opens a cancel for the controller's pending redeem request.
+    function cancelRedeemRequest(uint256 requestId, address controller) external;
+
+    /// @notice Collects the assets a processed deposit cancel returned
+    ///         (`claimableCancelDepositRequest`).
+    function claimCancelDepositRequest(uint256 requestId, address receiver, address controller)
+        external
+        returns (uint256 assets);
+
+    /// @notice Collects the shares a processed redeem cancel returned
+    ///         (`claimableCancelRedeemRequest`).
+    function claimCancelRedeemRequest(uint256 requestId, address receiver, address controller)
+        external
+        returns (uint256 shares);
+
+    // ──────────────────────────── Views ─────────────────────────────
+
+    /// @notice Underlying asset of the vault; must match the Hub asset at registration.
+    function asset() external view returns (address);
+
+    /// @notice The vault's share token (JTRSY / JAAA) — what the group actually holds. `sweep` does
+    ///         not bar it, because it bars only `asset()` and the vault address itself.
+    function share() external view returns (address);
+
+    /// @notice The vault's `AsyncRequestManager`, where the per-position `AsyncInvestmentState`
+    ///         lives.
+    /// @dev Not the `manager()` alias, which Centrifuge deleted in v3.1.0. Both read the same
+    ///      storage slot, but only this name exists in every release.
+    function baseManager() external view returns (address);
+
+    /// @notice The vault's own conversion of `shares` to assets at the fund's current NAV.
+    /// @dev Not on the valuation path. `AdapterCentrifuge` adds up every share-shaped bucket and
+    ///      marks the total with one {pricePerShare} read, rather than converting each bucket
+    ///      through here. That price is already truncated to the asset's decimals, so the adapter's
+    ///      mark sits at or just below this one: conservative, and intended for a mark nobody can
+    ///      vouch for. Neither read is bounded here — the YieldGroup's NAV band clamps the adapter's
+    ///      total afterwards, so it binds whichever one the adapter used. Validity is unchecked
+    ///      either way — a stale price passes through as-is and an unset one converts everything to
+    ///      0, so this never reverts on provenance.
+    function convertToAssets(uint256 shares) external view returns (uint256 assets);
+
+    /// @notice Price of one whole share in the asset's decimals, derived from the same
+    ///         cross-chain-published prices as {convertToAssets} and equally validity-unchecked:
+    ///         an unset feed reads 0. The adapter probes this before NAV-valuing share buckets so
+    ///         a missing feed halts valuation instead of silently zeroing it.
+    function pricePerShare() external view returns (uint256 price);
+
+    /// @notice Claimable assets from filled redeem requests: the vault's permission-checked reading
+    ///         of `investments().maxWithdraw`, which returns 0 while the controller is frozen. An
+    ///         expired memberlist does not affect it — claiming a redemption checks only the freeze
+    ///         flag — so this view and the claim always agree. Liquidity reads this; valuation reads
+    ///         the raw struct.
+    function maxWithdraw(address controller) external view returns (uint256 assets);
+}

package/deployments/bscmainnet/AdapterCentrifuge.json

@@ -0,0 +1,421 @@
+{
+  "address": "0x680cE4422264ecDAd3590cB50FE254D4c153f427",
+  "block": 122006956,
+  "chainId": 56,
+  "contract": "AdapterCentrifuge",
+  "abi": [
+    {
+      "type": "constructor",
+      "inputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "accrue",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "asset",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "cancelDepositRequest",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "cancelRedeemRequest",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "claimCancelDeposit",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "assets",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "claimCancelRedeem",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "shares",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "claimDeposit",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "shares",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "claimRedeem",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "assets",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "deposit",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "amount",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "depositRoom",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "holder",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "maxDeposit",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "pure"
+    },
+    {
+      "type": "function",
+      "name": "maxWithdraw",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "holder",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "pricePerShare",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "price",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "receiptBalance",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "holder",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "requestRedeem",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "shares",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "spotAPYBps",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "",
+          "type": "uint64",
+          "internalType": "uint64"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "totalAssets",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "holder",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "value",
+          "type": "uint256",
+          "internalType": "uint256"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "validateRegistration",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "withdraw",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        },
+        {
+          "name": "amount",
+          "type": "uint256",
+          "internalType": "uint256"
+        },
+        {
+          "name": "to",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "error",
+      "name": "NoManager",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ]
+    },
+    {
+      "type": "error",
+      "name": "NoShareToken",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ]
+    },
+    {
+      "type": "error",
+      "name": "NotDelegateCall",
+      "inputs": []
+    },
+    {
+      "type": "error",
+      "name": "ZeroSharePrice",
+      "inputs": [
+        {
+          "name": "resource",
+          "type": "address",
+          "internalType": "address"
+        }
+      ]
+    }
+  ]
+}

package/deployments/bscmainnet/CentrifugeBeacon.json

@@ -0,0 +1,110 @@
+{
+  "address": "0xAe90Cfb3E2Bc97508F58E7e076Acf38f3bfC820f",
+  "block": 122006956,
+  "chainId": 56,
+  "contract": "UpgradeableBeacon",
+  "abi": [
+    {
+      "type": "constructor",
+      "inputs": [
+        {
+          "name": "implementation_",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "implementation",
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "owner",
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "stateMutability": "view"
+    },
+    {
+      "type": "function",
+      "name": "renounceOwnership",
+      "inputs": [],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "transferOwnership",
+      "inputs": [
+        {
+          "name": "newOwner",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "function",
+      "name": "upgradeTo",
+      "inputs": [
+        {
+          "name": "newImplementation",
+          "type": "address",
+          "internalType": "address"
+        }
+      ],
+      "outputs": [],
+      "stateMutability": "nonpayable"
+    },
+    {
+      "type": "event",
+      "name": "OwnershipTransferred",
+      "inputs": [
+        {
+          "name": "previousOwner",
+          "type": "address",
+          "indexed": true,
+          "internalType": "address"
+        },
+        {
+          "name": "newOwner",
+          "type": "address",
+          "indexed": true,
+          "internalType": "address"
+        }
+      ],
+      "anonymous": false
+    },
+    {
+      "type": "event",
+      "name": "Upgraded",
+      "inputs": [
+        {
+          "name": "implementation",
+          "type": "address",
+          "indexed": true,
+          "internalType": "address"
+        }
+      ],
+      "anonymous": false
+    }
+  ]
+}