Wallets

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.23;

/**
 * @title ILocusSmartWallet
 * @notice Interface for LocusSmartWallet ERC-4337 account
 */
interface ILocusSmartWallet {
    // *****************************************************************************
    // STRUCTS
    // *****************************************************************************

    struct PermissionedKeyData {
        bool isActive;
    }

    // *****************************************************************************
    // EVENTS
    // *****************************************************************************

    event PermissionedKeySet(address indexed oldKey, address indexed newKey);
    event PermissionedKeyRevoked(address indexed key);
    event SubwalletCreated(address indexed subwalletAddress, uint48 disburseBefore);
    event SubwalletReclaimed(address indexed subwalletAddress, uint256 timestamp);
    event SubwalletDisbursed(address indexed subwalletAddress, address indexed to, uint256 timestamp);
    event USDCTransferExecuted(address indexed to, uint256 amount, uint256 timestamp);

    // *****************************************************************************
    // INITIALIZATION
    // *****************************************************************************

    function initialize(
        address owner_,
        address usdcToken_,
        address subwalletImplementation_,
        address initialPermissionedKey_
    ) external payable;

    // *****************************************************************************
    // OWNER FUNCTIONS
    // *****************************************************************************

    function revokePermissionedKey() external;

    // *****************************************************************************
    // PERMISSIONED KEY MANAGEMENT
    // *****************************************************************************

    function setPermissionedKey(address newKey) external;

    // *****************************************************************************
    // SUBWALLET MANAGEMENT
    // *****************************************************************************

    function createAndFundSubwallet(
        address[] calldata tokens,
        uint256[] calldata amounts,
        uint48 disburseBefore
    ) external payable returns (address subwalletAddress);

    function createAndFundSubwalletUSDC(
        uint256 amount,
        uint48 disburseBefore
    ) external returns (address subwalletAddress);

    function reclaimSubwallet(address subwalletAddress, address[] calldata tokens) external;

    function disburseSubwallet(address subwalletAddress, address to, address[] calldata tokens) external;

    // *****************************************************************************
    // LEGACY USDC FUNCTIONS
    // *****************************************************************************

    function transferUSDC(address to, uint256 amount) external;

    // *****************************************************************************
    // VIEW FUNCTIONS
    // *****************************************************************************

    function getPermissionedKey(address key) external view returns (PermissionedKeyData memory);
    function activePermissionedKeyPublic() external view returns (address);
    function activeSessionKeyPublic() external view returns (address);
    function getDeployedSubwallet(uint256 index) external view returns (address);
    function getSubwalletStats() external view returns (
        uint256 totalDeployed,
        uint256 activeCount,
        uint256 inactiveCount,
        uint256 availableSlots
    );
    function getSubwalletBalance(address subwalletAddress, address token) external view returns (uint256);
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.23;

/**
 * @title ISubwallet
 * @notice Interface for Subwallet proxy contract
 */
interface ISubwallet {
    // *****************************************************************************
    // EVENTS
    // *****************************************************************************

    event TokenTransferred(address indexed token, address indexed to, uint256 amount);
    event SubwalletActivated(uint48 disburseBefore);
    event SubwalletDeactivated();

    // *****************************************************************************
    // ERRORS
    // *****************************************************************************

    error Unauthorized();
    error DisbursementDeadlinePassed();
    error InvalidRecipient();
    error TransferFailed();

    // *****************************************************************************
    // EXTERNAL FUNCTIONS
    // *****************************************************************************

    /**
     * @notice Initialize the subwallet (called once per proxy)
     * @param mainWallet_ The main smart wallet address
     * @param owner_ The owner EOA address
     * @param disburseBefore_ Deadline for external disbursements
     */
    function initialize(
        address mainWallet_,
        address owner_,
        uint48 disburseBefore_
    ) external;

    /**
     * @notice Activate/reactivate the subwallet for reuse
     * @param newDisburseBefore New deadline for disbursements
     */
    function activate(uint48 newDisburseBefore) external;

    /**
     * @notice Deactivate the subwallet (returns to reuse pool)
     */
    function deactivate() external;

    /**
     * @notice Transfer tokens from this subwallet with deadline enforcement
     * @param token Token address (address(0) = ETH)
     * @param to Destination address
     * @param amount Amount to transfer
     */
    function transferToken(
        address token,
        address to,
        uint256 amount
    ) external;

    /**
     * @notice Get token balance of this subwallet
     * @param token Token address (address(0) = ETH)
     * @return balance Current balance
     */
    function getTokenBalance(address token) external view returns (uint256 balance);

    // *****************************************************************************
    // STATE VARIABLES (VIEW FUNCTIONS)
    // *****************************************************************************

    function mainWallet() external view returns (address);
    function owner() external view returns (address);
    function disburseBefore() external view returns (uint48);
    function isActive() external view returns (bool);
}