Merge pull request #16 from VenusProtocol/feat/swapRouter

[VPD-479]: Swap Router

Author: fred-venus

.gitignore

@@ -1,66 +1,73 @@
 node_modules
+node_modules_tmp
 .env
-coverage
-coverage.json
-typechain
-.openzeppelin
-#Hardhat files
+secrets.json
+
+# Hardhat
 cache
 cache-zk
 artifacts
 artifacts-zk
+typechain
+.openzeppelin
 
-#Compound
-allFiredEvents
-.build-temp
+# Coverage
+coverage
+coverage.json
+coverageEnv
+
+# Build
+dist
+docs
 build
 build_
-node_modules
-.env
+.build
+.build-temp
+.tsbuilt
+
+# Certora
 .certora*
 certora_*
-coverage/
-coverage.json
-coverageEnv/
-emv-*/
-formulas/
-outputs/
-Reports/
-scTopics
-test-results.xml
-.tsbuilt
-yarn-error.log
-scenario/build/webpack.js
-.scencache
-.solcache
-.solcachecov
-scenario/.tscache
 script/certora
+
+# Tests
+test-results.xml
+junit.xml
+allFiredEvents
 tests/scenarios/
 tests/Scenarios/
-junit.xml
-.build
-.last_confs
-node_modules_tmp
-.idea
 
-secrets.json
+# Solidity
+.solcache
+.solcachecov
+formulas
+outputs
+Reports
+scTopics
+
+# Scenario
+scenario/build/webpack.js
+scenario/.tscache
+.scencache
+emv-*/
 
-# yarn
+# Yarn
+yarn-error.log
 .yarn/*
 !.yarn/patches
 !.yarn/releases
 !.yarn/plugins
 !.yarn/sdks
 !.yarn/versions
 
-# Build
-dist
-docs
-
+# Generated/External
 contracts/oracle/*
 contracts/generated
 deployments/localhost
 
+# IDE
+.idea
+.last_confs
+
 # OSX
 .DS_Store

audits/165_SwapRouter_Pashov_20260118.pdf

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: BSD-3-Clause
+pragma solidity ^0.8.25;
+
+import { IVToken } from "./Interfaces/IVToken.sol";
+import { IComptroller } from "./Interfaces/IComptroller.sol";
+import { IVBNB } from "./Interfaces/IVBNB.sol";
+import { IWBNB } from "./Interfaces/IWBNB.sol";
+import { IFlashLoanReceiver } from "./Interfaces/IFlashLoanReceiver.sol";
+import { IProtocolShareReserve } from "./Interfaces/IProtocolShareReserve.sol";

audits/166_SwapRouter_Cyfrin_20260120.pdf

@@ -4,6 +4,8 @@ pragma solidity ^0.8.25;
 import { IVToken } from "../Interfaces/IVToken.sol";
 
 interface IVBNB is IVToken {
+    function mint() external payable;
+
     function repayBorrowBehalf(address borrower) external payable;
 
     function liquidateBorrow(address borrower, IVToken vTokenCollateral) external payable;

contracts/Interfaces.sol

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: BSD-3-Clause
+pragma solidity 0.8.28;
+
+/**
+ * @title ISwapRouter
+ * @author Venus Protocol
+ * @notice Interface for the SwapRouter contract implementing swap features
+ */
+interface ISwapRouter {
+    /**
+     * @notice Swaps tokens and supplies the result to a Venus market
+     * @param vToken The vToken market to supply to
+     * @param tokenIn The input token to swap from
+     * @param amountIn The amount of input tokens to swap
+     * @param minAmountOut The minimum amount of output tokens expected
+     * @param swapCallData Array of bytes containing swap instructions
+     * @custom:event Emits SwapAndSupply event
+     */
+    function swapAndSupply(
+        address vToken,
+        address tokenIn,
+        uint256 amountIn,
+        uint256 minAmountOut,
+        bytes calldata swapCallData
+    ) external payable;
+
+    /**
+     * @notice Swaps native tokens (BNB) and supplies to a Venus market
+     * @param vToken The vToken market to supply to
+     * @param minAmountOut The minimum amount of output tokens expected
+     * @param swapCallData Array of bytes containing swap instructions
+     * @custom:event Emits SwapAndSupply event
+     */
+    function swapNativeAndSupply(address vToken, uint256 minAmountOut, bytes calldata swapCallData) external payable;
+
+    /**
+     * @notice Swaps tokens and repays debt to a Venus market
+     * @param vToken The vToken market to repay debt to
+     * @param tokenIn The input token to swap from
+     * @param amountIn The amount of input tokens to swap
+     * @param minAmountOut The minimum amount of output tokens expected
+     * @param swapCallData Array of bytes containing swap instructions
+     * @custom:event Emits SwapAndRepay event
+     */
+    function swapAndRepay(
+        address vToken,
+        address tokenIn,
+        uint256 amountIn,
+        uint256 minAmountOut,
+        bytes calldata swapCallData
+    ) external payable;
+
+    /**
+     * @notice Swaps native tokens and repays debt to a Venus market
+     * @param vToken The vToken market to repay debt to
+     * @param minAmountOut The minimum amount of output tokens expected
+     * @param swapCallData Array of bytes containing swap instructions
+     * @custom:event Emits SwapAndRepay event
+     */
+    function swapNativeAndRepay(address vToken, uint256 minAmountOut, bytes calldata swapCallData) external payable;
+
+    /**
+     * @notice Swaps tokens and repays the full debt for a user
+     * @param vToken The vToken market to repay full debt to
+     * @param tokenIn The input token to swap from
+     * @param maxAmountIn The maximum amount of input tokens to use
+     * @param swapCallData Array of bytes containing swap instructions
+     * @custom:event Emits SwapAndRepay event
+     */
+    function swapAndRepayFull(
+        address vToken,
+        address tokenIn,
+        uint256 maxAmountIn,
+        bytes calldata swapCallData
+    ) external payable;
+
+    /**
+     * @notice Swaps native tokens and repays the full debt for a user
+     * @param vToken The vToken market to repay full debt to
+     * @param swapCallData Array of bytes containing swap instructions
+     * @custom:event Emits SwapAndRepay event
+     */
+    function swapNativeAndRepayFull(address vToken, bytes calldata swapCallData) external payable;
+
+    /**
+     * @notice Sweeps leftover ERC-20 tokens from the contract
+     * @param token The token to sweep
+     * @custom:event Emits SweepToken event
+     */
+    function sweepToken(address token) external;
+
+    /**
+     * @notice Sweeps leftover native tokens from the contract
+     * @custom:event Emits SweepNative event
+     */
+    function sweepNative() external;
+}