DCIPs/assets/eip-4987/IERC1155Holder.sol

57 lines
1.4 KiB
Solidity

/*
IERC1155Holder
SPDX-License-Identifier: CC0-1.0
*/
import "@openzeppelin/contracts/interfaces/IERC165.sol";
pragma solidity ^0.8.0;
/**
* @notice the ERC1155 holder standard provides a common interface to query
* token balance information
*/
interface IERC1155Holder is IERC165 {
/**
* @notice emitted when the token is transferred to the contract
* @param owner functional token owner
* @param tokenAddress held token address
* @param tokenId held token ID
* @param tokenAmount held token amount
*/
event Hold(
address indexed owner,
address indexed tokenAddress,
uint256 indexed tokenId,
uint256 tokenAmount
);
/**
* @notice emitted when the token is released back to the user
* @param owner functional token owner
* @param tokenAddress held token address
* @param tokenId held token ID
* @param tokenAmount held token amount
*/
event Release(
address indexed owner,
address indexed tokenAddress,
uint256 indexed tokenId,
uint256 tokenAmount
);
/**
* @notice get the held balance of the token owner
* @param tokenAddress held token address
* @param owner functional token owner
* @param tokenId held token ID
* @return held token balance
*/
function heldBalanceOf(
address tokenAddress,
address owner,
uint256 tokenId
) external view returns (uint256);
}