Transaction Hash:
Block:
24551155 at Feb-27-2026 10:08:35 PM +UTC
Transaction Fee:
0.000649762831378731 ETH
$1.35
Gas Used:
599,151 Gas / 1.084472581 Gwei
Emitted Events:
| 406 |
0x335172ffe75dac40953590446bcc285fbbd6f94c.0x69b31548dea9b3b707b4dff357d326e3e9348b24e7a6080a218a6edeeec48f9b( 0x69b31548dea9b3b707b4dff357d326e3e9348b24e7a6080a218a6edeeec48f9b, 000000000000000000000000a9d1e08c7793af67e9d92fe308d5697fb81d3e43, 0000000000000000000000000000000000000000000000000019b6fc7f359c00, 0000000000000000000000000000000000000000000000000000000000000060, 0000000000000000000000000000000000000000000000000000000000000000 )
|
Account State Difference:
| Address | Before | After | State Difference | ||
|---|---|---|---|---|---|
| 0x050A4cf8...04d8CdBEE | 0.00003811951945672 Eth | 0.0000800765 Eth | 0.00004195698054328 | ||
| 0x0510B1a8...a8589CfE7 | 0.00003691723178432 Eth | 0.0000800975 Eth | 0.00004318026821568 | ||
| 0x0B0BDf28...267f875bb |
0 Eth
Nonce: 0
|
0.1313796 Eth
Nonce: 0
| 0.1313796 | ||
| 0x10AF8174...00de2A5CD |
0 Eth
Nonce: 0
|
7.999979 Eth
Nonce: 0
| 7.999979 | ||
| 0x1652078A...179b25aA4 | 0.022489716461793472 Eth | 3.627471496461793472 Eth | 3.60498178 | ||
| 0x1789d0E8...12e03c55B | 0.0000380907652976 Eth | 0.0000800765 Eth | 0.0000419857347024 | ||
| 0x1E981c1D...FE40FeFfc | 0 Eth | 0.01183816 Eth | 0.01183816 | ||
| 0x1Fab670D...604a1f1FF | 0.00003825312829044 Eth | 0.0000800765 Eth | 0.00004182337170956 | ||
| 0x39084678...15Ddc0197 |
0 Eth
Nonce: 0
|
0.00276707 Eth
Nonce: 0
| 0.00276707 | ||
| 0x423572a0...Cff947187 | 0.001000428636901 Eth | 0.475185028636901 Eth | 0.4741846 | ||
|
0x4838B106...B0BAD5f97
Miner
| (Titan Builder) | 20.50143618236953761 Eth | 20.50203533336953761 Eth | 0.000599151 | |
| 0x63E3f430...25b51D673 | 0 Eth | 0.02576777 Eth | 0.02576777 | ||
| 0x67e173ff...947a73d21 | 0.00003326792243764 Eth | 0.0000800765 Eth | 0.00004680857756236 | ||
| 0x768e73A7...9B5E5C8B8 | 0.000078168575333456 Eth | 0.0000800975 Eth | 0.000001928924666544 | ||
| 0x7830c87C...31FA86F43 | (Coinbase: Deposit) |
119.093604471445419482 Eth
Nonce: 3159263
|
119.092954708614040751 Eth
Nonce: 3159264
| 0.000649762831378731 | |
| 0x7fcaA28C...6f4992aE8 |
0 Eth
Nonce: 0
|
0.0000800555 Eth
Nonce: 0
| 0.0000800555 | ||
| 0x841d42D9...78B509d57 |
0 Eth
Nonce: 0
|
0.0073834 Eth
Nonce: 0
| 0.0073834 | ||
| 0x8509caaB...bc49cf91D | 0.001116255018738133 Eth | 0.050082115018738133 Eth | 0.04896586 | ||
| 0x89eF730F...5F7aB63a7 | 0.00003796309192656 Eth | 0.0000800765 Eth | 0.00004211340807344 | ||
| 0x93B6Bb24...5C5084Abd | 0 Eth | 0.04939236 Eth | 0.04939236 | ||
| 0x97B68164...7BE7367CB | 1.63436197 Eth | 1.64666618 Eth | 0.01230421 | ||
| 0x9EB59583...5dD0106f5 | 0.000000560130289 Eth | 0.152260520130289 Eth | 0.15225996 | ||
| 0xa0327E8a...43544DE97 | 13.444824537000978589 Eth | 13.452062607000978589 Eth | 0.00723807 | ||
| 0xA979d712...d41B4Bed7 | 0.00006725448319868 Eth | 0.0000800765 Eth | 0.00001282201680132 | ||
| 0xA9D1e08C...FB81d3E43 | (Coinbase 10) | 3,960.63780757892224711 Eth | 3,947.613169602609959214 Eth | 13.024637976312287896 | |
| 0xAdF26B2b...eE70a94FD | 0.000037954613257008 Eth | 0.0000800555 Eth | 0.000042100886742992 | ||
| 0xaf027E8b...ad47f260a | 0 Eth | 0.01367478 Eth | 0.01367478 | ||
| 0xB4e62441...12c15c80f | 0 Eth | 0.00663837 Eth | 0.00663837 | ||
| 0xB92c0408...cd3fC5678 | 0.10586248 Eth | 0.26904556 Eth | 0.16318308 | ||
| 0xc873ABAe...aEdb2864c | 0.00003790953848472 Eth | 0.0000800555 Eth | 0.00004214596151528 | ||
| 0xd5aeFC55...de796f130 | 0 Eth | 0.0054678 Eth | 0.0054678 | ||
| 0xD64d6699...4996Aa99b |
0 Eth
Nonce: 0
|
0.0000800765 Eth
Nonce: 0
| 0.0000800765 | ||
| 0xdf31D6CE...C19A7cc59 | 0.01294214 Eth | 0.0520137 Eth | 0.03907156 | ||
| 0xdf6f5849...F6fd8BAA5 | 0.00003838950327748 Eth | 0.0000800765 Eth | 0.00004168699672252 | ||
| 0xe8e998e5...336a654a3 | 0.00005083531496748 Eth | 0.0000800765 Eth | 0.00002924118503252 | ||
| 0xeB6cc90D...c8a7f7002 | 0.00000050774052 Eth | 0.02638737774052 Eth | 0.02638687 | ||
| 0xeC23Ca31...D00e18940 |
0 Eth
Nonce: 0
|
0.09885052 Eth
Nonce: 0
| 0.09885052 | ||
| 0xf00089a7...32Db59b0f | 1.01610436 Eth | 1.05314196 Eth | 0.0370376 | ||
| 0xF74A58ba...d7ecf4a04 | 0.02203108 Eth | 0.02695008 Eth | 0.004919 | ||
| 0xf815F1d6...83652a930 | 0 Eth | 0.10037863 Eth | 0.10037863 |
Execution Trace
Coinbase 10.1a1da075( )
- ETH 0.0054678
0xd5aefc557482b41a1a0e65e333779d0de796f130.CALL( ) - ETH 3.60498178
0x1652078a64d5dd367a65c88c845d941179b25aa4.CALL( ) - ETH 0.03907156
0xdf31d6cec3c82ab2bd97d419e32efa9c19a7cc59.CALL( ) - ETH 0.04939236
0x93b6bb24c96d4a123773e46d6c7cbb35c5084abd.CALL( ) - ETH 0.09885052
0xec23ca31497447f72bd707c29118ee5d00e18940.CALL( ) - ETH 0.01367478
0xaf027e8b592b3e9a2aef26efe1a2fcbad47f260a.CALL( ) - ETH 0.1313796
0x0b0bdf2891292dc773d64b38d1276d8267f875bb.CALL( ) - ETH 7.999979
0x10af8174266736c9a006dad97df6b4e00de2a5cd.CALL( ) - ETH 0.04896586
0x8509caabf4efdd70543aa78344d5b60bc49cf91d.CALL( ) - ETH 0.0073834
0x841d42d9b734258060f3e8e44344e6178b509d57.CALL( ) - ETH 0.02576777
0x63e3f43042e834a3155a9efabd62eb325b51d673.CALL( ) - ETH 0.004919
0xf74a58ba28b5bb910007d210c9b81b3d7ecf4a04.CALL( ) - ETH 0.02638687
0xeb6cc90d137c515bcac0898e0f38900c8a7f7002.CALL( ) - ETH 0.01230421
0x97b6816459d82a026d969acf1e9bdfd7be7367cb.CALL( ) - ETH 0.4741846
0x423572a01a1682b070e1ca96d11edf3cff947187.CALL( ) ETH 0.00723807
0x335172ffe75dac40953590446bcc285fbbd6f94c.CALL( )ETH 0.00723807
ForwarderV4.DELEGATECALL( )- ETH 0.00723807
0xa0327e8a880ac7d6ce47c059204fa8843544de97.CALL( )
- ETH 0.00723807
- ETH 0.00276707
0x390846781e970d1fe2aac8b5b52917715ddc0197.CALL( ) - ETH 0.0370376
0xf00089a707b248ed72b4137726553f032db59b0f.CALL( ) - ETH 0.01183816
0x1e981c1dc71b402c3cc8a5fe260bbf6fe40feffc.CALL( ) - ETH 0.15225996
0x9eb59583beebebaa6ba39216c1e2d255dd0106f5.CALL( ) - ETH 0.00663837
0xb4e624412054e088c8b2f600cf1608e12c15c80f.CALL( ) - ETH 0.16318308
0xb92c04083c682368882a578ec48fcc7cd3fc5678.CALL( ) - ETH 0.10037863
0xf815f1d6de43a4edfad65ed4a2f1e6983652a930.CALL( ) - ETH 0.0000800555
0x7fcaa28c116fce9584cfb7bb3d7bd416f4992ae8.CALL( ) - ETH 0.00004214596151528
0xc873abae477d9205cb3c9e0f38537f6aedb2864c.CALL( ) - ETH 0.00002924118503252
0xe8e998e5b2575c83fa2a2cb9fef0716336a654a3.CALL( ) - ETH 0.0000419857347024
0x1789d0e8e14da71b38a935b71b8063012e03c55b.CALL( ) - ETH 0.000001928924666544
0x768e73a7c219f1e8977541b0b15c8519b5e5c8b8.CALL( ) - ETH 0.00004195698054328
0x050a4cf89bfc34636cd01a88063ba7b04d8cdbee.CALL( ) - ETH 0.0000800765
0xd64d66996c53df0d1d0b0251dc028424996aa99b.CALL( ) - ETH 0.00004318026821568
0x0510b1a8b756836e0563358737d445aa8589cfe7.CALL( ) - ETH 0.00001282201680132
0xa979d712bbbc7cc66d194fb2fa19ed6d41b4bed7.CALL( ) - ETH 0.00004211340807344
0x89ef730fb3de93d518a1be27edcc34b5f7ab63a7.CALL( ) - ETH 0.00004680857756236
0x67e173ffd5f761bc480b3323a2619be947a73d21.CALL( ) - ETH 0.00004168699672252
0xdf6f584950145c3bb79a4263749b08ef6fd8baa5.CALL( ) - ETH 0.000042100886742992
0xadf26b2ba79f17939d44d0ee907fa29ee70a94fd.CALL( ) - ETH 0.00004182337170956
0x1fab670d4311afb366e1e725689d4dd604a1f1ff.CALL( )
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/IERC1155.sol)
pragma solidity ^0.8.20;
import {IERC165} from "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC1155 compliant contract, as defined in the
* https://eips.ethereum.org/EIPS/eip-1155[EIP].
*/
interface IERC1155 is IERC165 {
/**
* @dev Emitted when `value` amount of tokens of type `id` are transferred from `from` to `to` by `operator`.
*/
event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
/**
* @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
* transfers.
*/
event TransferBatch(
address indexed operator,
address indexed from,
address indexed to,
uint256[] ids,
uint256[] values
);
/**
* @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
* `approved`.
*/
event ApprovalForAll(address indexed account, address indexed operator, bool approved);
/**
* @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
*
* If an {URI} event was emitted for `id`, the standard
* https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
* returned by {IERC1155MetadataURI-uri}.
*/
event URI(string value, uint256 indexed id);
/**
* @dev Returns the value of tokens of token type `id` owned by `account`.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) external view returns (uint256);
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(
address[] calldata accounts,
uint256[] calldata ids
) external view returns (uint256[] memory);
/**
* @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
*
* Emits an {ApprovalForAll} event.
*
* Requirements:
*
* - `operator` cannot be the caller.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address account, address operator) external view returns (bool);
/**
* @dev Transfers a `value` amount of tokens of type `id` from `from` to `to`.
*
* WARNING: This function can potentially allow a reentrancy attack when transferring tokens
* to an untrusted contract, when invoking {onERC1155Received} on the receiver.
* Ensure to follow the checks-effects-interactions pattern and consider employing
* reentrancy guards when interacting with untrusted contracts.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
* - `from` must have a balance of tokens of type `id` of at least `value` amount.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes calldata data) external;
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
*
*
* WARNING: This function can potentially allow a reentrancy attack when transferring tokens
* to an untrusted contract, when invoking {onERC1155BatchReceived} on the receiver.
* Ensure to follow the checks-effects-interactions pattern and consider employing
* reentrancy guards when interacting with untrusted contracts.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `values` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function safeBatchTransferFrom(
address from,
address to,
uint256[] calldata ids,
uint256[] calldata values,
bytes calldata data
) external;
}
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/IERC1155Receiver.sol)
pragma solidity ^0.8.20;
import {IERC165} from "../../utils/introspection/IERC165.sol";
/**
* @dev Interface that must be implemented by smart contracts in order to receive
* ERC-1155 token transfers.
*/
interface IERC1155Receiver is IERC165 {
/**
* @dev Handles the receipt of a single ERC1155 token type. This function is
* called at the end of a `safeTransferFrom` after the balance has been updated.
*
* NOTE: To accept the transfer, this must return
* `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
* (i.e. 0xf23a6e61, or its own function selector).
*
* @param operator The address which initiated the transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param id The ID of the token being transferred
* @param value The amount of tokens being transferred
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
*/
function onERC1155Received(
address operator,
address from,
uint256 id,
uint256 value,
bytes calldata data
) external returns (bytes4);
/**
* @dev Handles the receipt of a multiple ERC1155 token types. This function
* is called at the end of a `safeBatchTransferFrom` after the balances have
* been updated.
*
* NOTE: To accept the transfer(s), this must return
* `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
* (i.e. 0xbc197c81, or its own function selector).
*
* @param operator The address which initiated the batch transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param ids An array containing ids of each token being transferred (order and length must match values array)
* @param values An array containing amounts of each token being transferred (order and length must match ids array)
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
*/
function onERC1155BatchReceived(
address operator,
address from,
uint256[] calldata ids,
uint256[] calldata values,
bytes calldata data
) external returns (bytes4);
}
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/utils/ERC1155Holder.sol)
pragma solidity ^0.8.20;
import {IERC165, ERC165} from "../../../utils/introspection/ERC165.sol";
import {IERC1155Receiver} from "../IERC1155Receiver.sol";
/**
* @dev Simple implementation of `IERC1155Receiver` that will allow a contract to hold ERC1155 tokens.
*
* IMPORTANT: When inheriting this contract, you must include a way to use the received tokens, otherwise they will be
* stuck.
*/
abstract contract ERC1155Holder is ERC165, IERC1155Receiver {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return interfaceId == type(IERC1155Receiver).interfaceId || super.supportsInterface(interfaceId);
}
function onERC1155Received(
address,
address,
uint256,
uint256,
bytes memory
) public virtual override returns (bytes4) {
return this.onERC1155Received.selector;
}
function onERC1155BatchReceived(
address,
address,
uint256[] memory,
uint256[] memory,
bytes memory
) public virtual override returns (bytes4) {
return this.onERC1155BatchReceived.selector;
}
}
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721.sol)
pragma solidity ^0.8.20;
import {IERC165} from "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC721 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 ERC721 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 ERC721
* 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);
}
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721Receiver.sol)
pragma solidity ^0.8.20;
/**
* @title ERC721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC721 asset contracts.
*/
interface IERC721Receiver {
/**
* @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
* by `operator` from `from`, this function is called.
*
* It must return its Solidity selector to confirm the token transfer.
* If any other value is returned or the interface is not implemented by the recipient, the transfer will be
* reverted.
*
* The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
*/
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
pragma solidity ^0.8.20;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev The ETH balance of the account is not enough to perform the operation.
*/
error AddressInsufficientBalance(address account);
/**
* @dev There's no code at `target` (it is not a contract).
*/
error AddressEmptyCode(address target);
/**
* @dev A call to an address target failed. The target may have reverted.
*/
error FailedInnerCall();
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
if (address(this).balance < amount) {
revert AddressInsufficientBalance(address(this));
}
(bool success, ) = recipient.call{value: amount}("");
if (!success) {
revert FailedInnerCall();
}
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason or custom error, it is bubbled
* up by this function (like regular Solidity function calls). However, if
* the call reverted with no returned reason, this function reverts with a
* {FailedInnerCall} error.
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
if (address(this).balance < value) {
revert AddressInsufficientBalance(address(this));
}
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
* was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an
* unsuccessful call.
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata
) internal view returns (bytes memory) {
if (!success) {
_revert(returndata);
} else {
// only check if target is a contract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
if (returndata.length == 0 && target.code.length == 0) {
revert AddressEmptyCode(target);
}
return returndata;
}
}
/**
* @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
* revert reason or with a default {FailedInnerCall} error.
*/
function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
if (!success) {
_revert(returndata);
} else {
return returndata;
}
}
/**
* @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
*/
function _revert(bytes memory returndata) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert FailedInnerCall();
}
}
}
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)
pragma solidity ^0.8.20;
import {IERC165} from "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* 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[EIP 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);
}
// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.20;
/**
* Contract that exposes the needed erc20 token functions
*/
abstract contract ERC20Interface {
// Send _value amount of tokens to address _to
function transfer(address _to, uint256 _value)
public
virtual
returns (bool success);
// Get the account balance of another account with address _owner
function balanceOf(address _owner)
public
view
virtual
returns (uint256 balance);
}
// SPDX-License-Identifier: Apache-2.0
pragma solidity 0.8.20;
import '@openzeppelin/contracts/token/ERC1155/IERC1155.sol';
import '@openzeppelin/contracts/token/ERC721/IERC721.sol';
import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol';
import '@openzeppelin/contracts/token/ERC1155/utils/ERC1155Holder.sol';
import './ERC20Interface.sol';
import './TransferHelper.sol';
import './IForwarderV4.sol';
/**
* @title ForwarderV4
* @notice This contract will forward any incoming Ether or token to the parent address of the contract
*/
contract ForwarderV4 is IERC721Receiver, ERC1155Holder, IForwarderV4 {
/// @notice Any funds sent to this contract will be forwarded to this address
address public parentAddress;
/// @notice Address which is allowed to call methods on this contract alongwith the parentAddress
address public feeAddress;
bool public autoFlush721 = true;
bool public autoFlush1155 = true;
/**
* @notice Event triggered when a deposit is received in the forwarder
* @param from Address from which the deposit is received
* @param value Amount of Ether received
* @param data Data sent along with the deposit
*/
event ForwarderDeposited(address from, uint256 value, bytes data);
/**
* @notice Modifier that will execute internal code block only if the sender is from the allowed addresses
*/
modifier onlyAllowedAddress() {
require(
msg.sender == parentAddress || msg.sender == feeAddress,
'Address is not allowed'
);
_;
}
/**
* @notice Modifier that will execute internal code block only if the contract has not been initialized yet
*/
modifier onlyUninitialized() {
require(parentAddress == address(0x0), 'Already initialized');
_;
}
/**
* @notice Default function; Gets called when Ether is deposited with no data, and forwards it to the parent address
*/
receive() external payable {
flush();
}
/**
* @notice Default function; Gets called when data is sent but does not match any other function
*/
fallback() external payable {
flush();
}
/**
* @notice Initialize the contract, and sets the destination address to that of the parent address
* @param _parentAddress Address to which the funds should be forwarded
* @param _feeAddress Address which is allowed to call methods on this contract alongwith the parentAddress
* @param _autoFlush721 Whether to automatically flush ERC721 tokens or not
* @param _autoFlush1155 Whether to automatically flush ERC1155 tokens or not
*/
function init(
address _parentAddress,
address _feeAddress,
bool _autoFlush721,
bool _autoFlush1155
) external onlyUninitialized {
require(_parentAddress != address(0x0), 'Invalid parent address');
parentAddress = _parentAddress;
require(_feeAddress != address(0x0), 'Invalid fee address');
feeAddress = _feeAddress;
uint256 value = address(this).balance;
/// @notice set whether we want to automatically flush erc721/erc1155 tokens or not
autoFlush721 = _autoFlush721;
autoFlush1155 = _autoFlush1155;
if (value == 0) {
return;
}
/**
* Since we are forwarding on initialization,
* we don't have the context of the original sender.
* We still emit an event about the forwarding but set
* the sender to the forwarder itself
*/
emit ForwarderDeposited(address(this), value, msg.data);
(bool success, ) = parentAddress.call{ value: value }('');
require(success, 'Flush failed');
}
/**
* @inheritdoc IForwarderV4
*/
function setAutoFlush721(bool autoFlush)
external
virtual
override
onlyAllowedAddress
{
autoFlush721 = autoFlush;
}
/**
* @inheritdoc IForwarderV4
*/
function setAutoFlush1155(bool autoFlush)
external
virtual
override
onlyAllowedAddress
{
autoFlush1155 = autoFlush;
}
/**
* ERC721 standard callback function for when a ERC721 is transfered. The forwarder will send the nft
* to the base wallet once the nft contract invokes this method after transfering the nft.
*
* @param _operator The address which called `safeTransferFrom` function
* @param _from The address of the sender
* @param _tokenId The token id of the nft
* @param data Additional data with no specified format, sent in call to `_to`
*/
function onERC721Received(
address _operator,
address _from,
uint256 _tokenId,
bytes memory data
) external virtual override returns (bytes4) {
if (autoFlush721) {
IERC721 instance = IERC721(msg.sender);
require(
instance.supportsInterface(type(IERC721).interfaceId),
'The caller does not support the ERC721 interface'
);
/// this won't work for ERC721 re-entrancy
instance.safeTransferFrom(address(this), parentAddress, _tokenId, data);
}
return this.onERC721Received.selector;
}
/**
* @notice Method to allow for calls to other contracts. This method can only be called by the parent address
* @param target The target contract address whose method needs to be called
* @param value The amount of Ether to be sent
* @param data The calldata to be sent
*/
function callFromParent(
address target,
uint256 value,
bytes calldata data
) external returns (bytes memory) {
require(msg.sender == parentAddress, 'Only Parent');
(bool success, bytes memory returnedData) = target.call{ value: value }(
data
);
require(success, 'Parent call execution failed');
return returnedData;
}
/**
* @inheritdoc ERC1155Holder
*/
function onERC1155Received(
address _operator,
address _from,
uint256 id,
uint256 value,
bytes memory data
) public virtual override returns (bytes4) {
IERC1155 instance = IERC1155(msg.sender);
require(
instance.supportsInterface(type(IERC1155).interfaceId),
'The caller does not support the IERC1155 interface'
);
if (autoFlush1155) {
instance.safeTransferFrom(address(this), parentAddress, id, value, data);
}
return this.onERC1155Received.selector;
}
/**
* @inheritdoc ERC1155Holder
*/
function onERC1155BatchReceived(
address _operator,
address _from,
uint256[] memory ids,
uint256[] memory values,
bytes memory data
) public virtual override returns (bytes4) {
IERC1155 instance = IERC1155(msg.sender);
require(
instance.supportsInterface(type(IERC1155).interfaceId),
'The caller does not support the IERC1155 interface'
);
if (autoFlush1155) {
instance.safeBatchTransferFrom(
address(this),
parentAddress,
ids,
values,
data
);
}
return this.onERC1155BatchReceived.selector;
}
/**
* @inheritdoc IForwarderV4
*/
function flushTokens(address tokenContractAddress)
external
virtual
override
onlyAllowedAddress
{
ERC20Interface instance = ERC20Interface(tokenContractAddress);
address forwarderAddress = address(this);
uint256 forwarderBalance = instance.balanceOf(forwarderAddress);
if (forwarderBalance == 0) {
return;
}
TransferHelper.safeTransfer(
tokenContractAddress,
parentAddress,
forwarderBalance
);
}
/**
* @inheritdoc IForwarderV4
*/
function flushERC721Token(address tokenContractAddress, uint256 tokenId)
external
virtual
override
onlyAllowedAddress
{
IERC721 instance = IERC721(tokenContractAddress);
require(
instance.supportsInterface(type(IERC721).interfaceId),
'The tokenContractAddress does not support the ERC721 interface'
);
address ownerAddress = instance.ownerOf(tokenId);
instance.transferFrom(ownerAddress, parentAddress, tokenId);
}
/**
* @inheritdoc IForwarderV4
*/
function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
external
virtual
override
onlyAllowedAddress
{
IERC1155 instance = IERC1155(tokenContractAddress);
require(
instance.supportsInterface(type(IERC1155).interfaceId),
'The caller does not support the IERC1155 interface'
);
address forwarderAddress = address(this);
uint256 forwarderBalance = instance.balanceOf(forwarderAddress, tokenId);
instance.safeTransferFrom(
forwarderAddress,
parentAddress,
tokenId,
forwarderBalance,
''
);
}
/**
* @inheritdoc IForwarderV4
*/
function batchFlushERC1155Tokens(
address tokenContractAddress,
uint256[] calldata tokenIds
) external virtual override onlyAllowedAddress {
IERC1155 instance = IERC1155(tokenContractAddress);
require(
instance.supportsInterface(type(IERC1155).interfaceId),
'The caller does not support the IERC1155 interface'
);
address forwarderAddress = address(this);
uint256 length = tokenIds.length;
uint256[] memory amounts = new uint256[](tokenIds.length);
for (uint256 i; i < length; i++) {
amounts[i] = instance.balanceOf(forwarderAddress, tokenIds[i]);
}
instance.safeBatchTransferFrom(
forwarderAddress,
parentAddress,
tokenIds,
amounts,
''
);
}
/**
* @inheritdoc IForwarderV4
*/
function batchFlushERC20Tokens(address[] calldata tokenContractAddresses)
external
virtual
override
onlyAllowedAddress
{
address forwarderAddress = address(this);
uint256 length = tokenContractAddresses.length;
for (uint256 i; i < length; i++) {
ERC20Interface instance = ERC20Interface(tokenContractAddresses[i]);
uint256 forwarderBalance = instance.balanceOf(forwarderAddress);
if (forwarderBalance == 0) {
continue;
}
TransferHelper.safeTransfer(
tokenContractAddresses[i],
parentAddress,
forwarderBalance
);
}
}
/**
* @notice Flush the entire balance of the contract to the parent address.
*/
function flush() public {
uint256 value = address(this).balance;
if (value == 0) {
return;
}
emit ForwarderDeposited(msg.sender, value, msg.data);
(bool success, ) = parentAddress.call{ value: value }('');
require(success, 'Flush failed');
}
/**
* @inheritdoc IERC165
*/
function supportsInterface(bytes4 interfaceId)
public
view
virtual
override(ERC1155Holder, IERC165)
returns (bool)
{
return
interfaceId == type(IForwarderV4).interfaceId ||
super.supportsInterface(interfaceId);
}
}
// SPDX-License-Identifier: Apache-2.0
pragma solidity 0.8.20;
import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
interface IForwarderV4 is IERC165 {
/**
* Sets the autoflush721 parameter.
*
* @param autoFlush whether to autoflush erc721 tokens
*/
function setAutoFlush721(bool autoFlush) external;
/**
* Sets the autoflush1155 parameter.
*
* @param autoFlush whether to autoflush erc1155 tokens
*/
function setAutoFlush1155(bool autoFlush) external;
/**
* Execute a token transfer of the full balance from the forwarder to the parent address
*
* @param tokenContractAddress the address of the erc20 token contract
*/
function flushTokens(address tokenContractAddress) external;
/**
* Execute a nft transfer from the forwarder to the parent address
*
* @param tokenContractAddress the address of the ERC721 NFT contract
* @param tokenId The token id of the nft
*/
function flushERC721Token(address tokenContractAddress, uint256 tokenId)
external;
/**
* Execute a nft transfer from the forwarder to the parent address.
*
* @param tokenContractAddress the address of the ERC1155 NFT contract
* @param tokenId The token id of the nft
*/
function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
external;
/**
* Execute a batch nft transfer from the forwarder to the parent address.
*
* @param tokenContractAddress the address of the ERC1155 NFT contract
* @param tokenIds The token ids of the nfts
*/
function batchFlushERC1155Tokens(
address tokenContractAddress,
uint256[] calldata tokenIds
) external;
/**
* Execute a batch erc20 transfer from the forwarder to the parent address.
*
* @param tokenContractAddresses the addresses of the ERC20 token contracts
*/
function batchFlushERC20Tokens(address[] calldata tokenContractAddresses)
external;
}
// SPDX-License-Identifier: GPL-3.0-or-later
// source: https://github.com/Uniswap/solidity-lib/blob/master/contracts/libraries/TransferHelper.sol
pragma solidity 0.8.20;
import '@openzeppelin/contracts/utils/Address.sol';
// helper methods for interacting with ERC20 tokens and sending ETH that do not consistently return true/false
library TransferHelper {
function safeTransfer(
address token,
address to,
uint256 value
) internal {
// bytes4(keccak256(bytes('transfer(address,uint256)')));
(bool success, bytes memory data) = token.call(
abi.encodeWithSelector(0xa9059cbb, to, value)
);
require(
success && (data.length == 0 || abi.decode(data, (bool))),
'TransferHelper::safeTransfer: transfer failed'
);
}
function safeTransferFrom(
address token,
address from,
address to,
uint256 value
) internal {
// bytes4(keccak256(bytes('transferFrom(address,address,uint256)')));
(bool success, bytes memory returndata) = token.call(
abi.encodeWithSelector(0x23b872dd, from, to, value)
);
Address.verifyCallResult(success, returndata);
}
}