Description:
Proxy contract enabling upgradeable smart contract patterns. Delegates calls to an implementation contract.
Blockchain: Ethereum
Source Code: View Code On The Blockchain
Solidity Source Code:
{{
"language": "Solidity",
"sources": {
"src/Guardian.sol": {
"content": "// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.2;
import "../lib/ERC721x/contracts/interfaces/ILockERC721.sol";
contract Guardian {
struct UserData {
address guardian;
uint256[] lockedAssets;
mapping(uint256 => uint256) assetToIndex;
}
ILockERC721 public immutable LOCKABLE;
mapping(address => address) public pendingGuardians;
mapping(address => mapping(uint256 => address)) public pendingGuardianArray;
mapping(address => uint256) public pendingGuardianUserCount;
mapping(address => address) public guardians;
mapping(address => UserData) public userData;
mapping(address => mapping(uint256 => address)) public guardianToUsers;
mapping(address => mapping(address => uint256)) public guardianToUserIndex;
mapping(address => uint256) public guardianUserCount;
event GuardianSet(address indexed guardian, address indexed user);
event GuardianRenounce(address indexed guardian, address indexed user);
event PendingGuardianSet(address indexed pendingGuardian, address indexed user);
constructor(address _lockable) public {
LOCKABLE = ILockERC721(_lockable);
}
function getPendingProteges(address _guardian) external view returns(address[] memory _proteges) {
uint256 pendingCount = pendingGuardianUserCount[_guardian];
_proteges = new address[](pendingCount);
for (uint256 i = 0; i < pendingCount; i++) {
_proteges[i] = pendingGuardianArray[_guardian][i];
}
}
function proposeGuardian(address _guardian) external {
require(guardians[msg.sender] == address(0), "Guardian set");
require(msg.sender != _guardian, "Guardian must be a different wallet");
pendingGuardians[msg.sender] = _guardian;
pendingGuardianArray[_guardian][pendingGuardianUserCount[_guardian]++] = msg.sender;
emit PendingGuardianSet(_guardian, msg.sender);
}
function acceptGuardianship(address _protege) external {
require(pendingGuardians[_protege] == msg.sender, "Not the pending guardian");
uint256 pendingCount = pendingGuardianUserCount[msg.sender]--;
uint256 pIndex;
for (pIndex; pIndex < pendingCount; pIndex++) {
if (pendingGuardianArray[msg.sender][pIndex] == _protege)
break;
}
if (pIndex != pendingCount - 1)
pendingGuardianArray[msg.sender][pIndex] = pendingGuardianArray[msg.sender][pendingCount - 1];
delete pendingGuardianArray[msg.sender][pendingCount - 1];
pendingGuardians[_protege] = address(0);
guardians[_protege] = msg.sender;
userData[_protege].guardian = msg.sender;
_pushGuardianrray(msg.sender, _protege);
emit GuardianSet(msg.sender, _protege);
}
function renounce(address _protege) external {
require(guardians[_protege] == msg.sender, "!guardian");
guardians[_protege] = address(0);
userData[_protege].guardian = address(0);
_popGuardianrray(msg.sender, _protege);
emit GuardianRenounce(msg.sender, _protege);
}
function lockMany(uint256[] calldata _tokenIds) external {
address owner = LOCKABLE.ownerOf(_tokenIds[0]);
require(guardians[owner] == msg.sender, "!guardian");
UserData storage _userData = userData[owner];
uint256 len = _userData.lockedAssets.length;
for (uint256 i = 0; i < _tokenIds.length; i++) {
require(LOCKABLE.ownerOf(_tokenIds[i]) == owner, "!owner");
LOCKABLE.lockId(_tokenIds[i]);
_pushTokenInArray(_userData, _tokenIds[i], len + i);
}
}
function unlockMany(uint256[] calldata _tokenIds) external {
address owner = LOCKABLE.ownerOf(_tokenIds[0]);
require(guardians[owner] == msg.sender, "!guardian");
UserData storage _userData = userData[owner];
uint256 len = _userData.lockedAssets.length;
for (uint256 i = 0; i < _tokenIds.length; i++) {
require(LOCKABLE.ownerOf(_tokenIds[i]) == owner, "!owner");
LOCKABLE.unlockId(_tokenIds[i]);
_popTokenFromArray(_userData, _tokenIds[i], len--);
}
}
function unlockManyAndTransfer(uint256[] calldata _tokenIds, address _recipient) external {
address owner = LOCKABLE.ownerOf(_tokenIds[0]);
require(guardians[owner] == msg.sender, "!guardian");
UserData storage _userData = userData[owner];
uint256 len = _userData.lockedAssets.length;
for (uint256 i = 0; i < _tokenIds.length; i++) {
require(LOCKABLE.ownerOf(_tokenIds[i]) == owner, "!owner");
LOCKABLE.unlockId(_tokenIds[i]);
LOCKABLE.safeTransferFrom(owner, _recipient, _tokenIds[i]);
_popTokenFromArray(_userData, _tokenIds[i], len--);
}
}
function getLockedAssetsOfUsers(address _user) external view returns(uint256[] memory lockedAssets) {
uint256 len = userData[_user].lockedAssets.length;
lockedAssets = new uint256[](len);
for (uint256 i = 0; i < len; i++) {
lockedAssets[i] = userData[_user].lockedAssets[i];
}
}
function getLockedAssetsOfUsers(address _user, uint256 _startIndex, uint256 _maxLen) external view returns(uint256[] memory lockedAssets) {
uint256 len = userData[_user].lockedAssets.length;
if (len == 0 || _startIndex >= len) {
lockedAssets = new uint256[](0);
}
else {
_maxLen = (len - _startIndex) < _maxLen ? len - _startIndex : _maxLen;
lockedAssets = new uint256[](_maxLen);
for (uint256 i = _startIndex; i < _startIndex + _maxLen; i++) {
lockedAssets[i] = userData[_user].lockedAssets[i];
}
}
}
function getProtegesFromGuardian(address _guardian) external view returns(address[] memory proteges) {
uint256 len = guardianUserCount[_guardian];
proteges = new address[](len);
for (uint256 i = 0; i < len; i++) {
proteges[i] = guardianToUsers[_guardian][i];
}
}
function _pushTokenInArray(UserData storage _userData, uint256 _token, uint256 _index) internal {
_userData.lockedAssets.push(_token);
_userData.assetToIndex[_token] = _index;
}
function _popTokenFromArray(UserData storage _userData, uint256 _token, uint256 _len) internal {
uint256 index = _userData.assetToIndex[_token];
delete _userData.assetToIndex[_token];
uint256 lastId = _userData.lockedAssets[_len - 1];
_userData.assetToIndex[lastId] = index;
_userData.lockedAssets[index] = lastId;
_userData.lockedAssets.pop();
}
function _pushGuardianrray(address _guardian, address _protege) internal {
uint256 count = guardianUserCount[_guardian];
guardianToUsers[_guardian][count] = _protege;
guardianToUserIndex[_guardian][_protege] = count;
guardianUserCount[_guardian]++;
}
function _popGuardianrray(address _guardian, address _protege) internal {
uint256 index = guardianToUserIndex[_guardian][_protege];
delete guardianToUserIndex[_guardian][_protege];
guardianToUsers[_guardian][index] = guardianToUsers[_guardian][guardianUserCount[_guardian] - 1];
delete guardianToUsers[_guardian][guardianUserCount[_guardian] - 1];
guardianUserCount[_guardian]--;
}
}"
},
"lib/ERC721x/contracts/interfaces/ILockERC721.sol": {
"content": "// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.17;
import "../../../openzeppelin-contracts/contracts/token/ERC721/IERC721.sol";
/*
* ,_,
* (',')
* {/"\}
* -"-"-
*/
interface ILockERC721 is IERC721 {
function lockId(uint256 _id) external;
function unlockId(uint256 _id) external;
function freeId(uint256 _id, address _contract) external;
}"
},
"lib/openzeppelin-contracts/contracts/token/ERC721/IERC721.sol": {
"content": "// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC721/IERC721.sol)
pragma solidity >=0.6.2;
import {IERC165} from "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC-721 compliant contract.
*/
interface IERC721 is IERC165 {
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in ``owner``'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon
* a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC-721 protocol to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must have been allowed to move this token by either {approve} or
* {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon
* a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(address from, address to, uint256 tokenId) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC-721
* or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
* understand this adds an external call which potentially creates a reentrancy vulnerability.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 tokenId) external;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the address zero.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
}
"
},
"lib/openzeppelin-contracts/contracts/utils/introspection/IERC165.sol": {
"content": "// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (utils/introspection/IERC165.sol)
pragma solidity >=0.4.16;
/**
* @dev Interface of the ERC-165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[ERC].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[ERC section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}
"
}
},
"settings": {
"remappings": [
"@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/",
"@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/",
"ERC721x/=lib/ERC721x/contracts/",
"erc4626-tests/=lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/",
"forge-std/=lib/forge-std/src/",
"halmos-cheatcodes/=lib/openzeppelin-contracts-upgradeable/lib/halmos-cheatcodes/src/",
"openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/",
"openzeppelin-contracts/=lib/openzeppelin-contracts/",
"openzeppelin-foundry-upgrades/=lib/openzeppelin-foundry-upgrades/src/"
],
"optimizer": {
"enabled": false,
"runs": 200
},
"metadata": {
"useLiteralContent": false,
"bytecodeHash": "ipfs",
"appendCBOR": true
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"evmVersion": "cancun",
"viaIR": false
}
}}
Submitted on: 2025-10-24 14:02:53
Comments
Log in to comment.
No comments yet.