ERC1155

简介: 从外网找的博客,自己翻译了一下,记录一下

/**

@title ERC-1155 Multi Token Standard

@dev 参见 https://eips.ethereum.org/EIPS/eip-1155

注意:此接口的 ERC-165 标识符为 0xd9b67a26。

/

interface ERC1155 / is ERC165 / {

/*

@dev 无论是 TransferSingle 还是 TransferBatch 都必须在代币转移时发出,包括零值转移以及铸造或燃烧(参见“安全转移规则”部分标准)。

_operator 参数必须是被批准进行转账的账户/合约的地址(应该是 msg.sender)。

_from 参数必须是余额减少的持有者的地址。

_to 参数必须是余额增加的收件人的地址。

_id 参数必须是被传输的令牌类型。

_value 参数必须是持有者余额减少的代币数量,并与接收者余额增加的数量相匹配。

在铸造/创建令牌时,_from 参数必须设置为 0x0(即零地址)。

当销毁/销毁令牌时,_to 参数必须设置为 0x0(即零地址)。

*/

event TransferSingle(address indexed _operator, address indexed _from, address indexed _to, uint256 _id, uint256 _value);


/**

   @dev `TransferSingle` 或 `TransferBatch` 必须在代币传输时发出,包括零值传输以及铸造或燃烧(参见标准的“安全传输规则”部分)。      

   `_operator` 参数必须是被批准进行转账的账户/合约的地址(应该是 msg.sender)。

`_from` 参数必须是余额减少的持有者的地址。
    `_to` 参数必须是余额增加的收件人的地址。
    `_ids` 参数必须是正在传输的令牌列表。
    `_values` 参数必须是代币数量列表(与 _ids 中指定的代币列表和顺序匹配),持有者余额减少并匹配接收者余额增加的数量。
    在铸造/创建令牌时,`_from` 参数必须设置为 `0x0`(即零地址)。
    当销毁/销毁令牌时,`_to` 参数必须设置为 `0x0`(即零地址)。                
*/
event TransferBatch(address indexed _operator, address indexed _from, address indexed _to, uint256[] _ids, uint256[] _values);


/**

@dev 必须在允许或禁用第二方/运营商地址管理所有者地址的所有令牌时发出(没有事件假定已禁用)。

*/

event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);


/**

@dev 必须在为令牌 ID 更新 URI 时发出。

URI 在 RFC 3986 中定义。URI

必须指向符合“ERC-1155 元数据 URI JSON 模式”的 JSON 文件。

*/

event URI(string _value, uint256 indexed _id);


/** 
    @notice 从 `_from` 地址转移 `_value` 数量的 `_id` 到指定的 `_to` 地址(带安全调用)。
    @dev Caller 必须获得批准才能管理从 `_from` 帐户转出的代币(请参阅标准的“批准”部分)。
    如果 `_to` 是零地址,则必须恢复。
    如果代币“_id”的持有者余额低于发送的“_value”,则必须恢复。
    必须在任何其他错误时恢复。
    必须发出 `TransferSingle` 事件以反映余额变化(参见标准的“安全转移规则”部分)。
    满足上述条件后,该函数必须检查 `_to` 是否为智能合约(例如代码大小 > 0)。如果是这样,它必须在 `_to` 上调用 `onERC1155Received` 并采取适当的行动(参见标准的“安全传输规则”部分)。        
    @param _from 源地址
    @param _to 目标地址
    @param _id 令牌类型的 ID 
    @param _value 传输量 @param _data
    没有指定格式的附加数据,必须在调用 `_to` 上的 `onERC1155Received` 时不变地发送
*/
function safeTransferFrom(address _from, address _to, uint256 _id, uint256 _value, bytes calldata _data) external;


/**

@notice 将 _values 数量的 _ids 从 _from 地址转移到指定的 _to 地址(带安全调用)。

@dev Caller 必须获得批准才能管理从 _from 帐户转出的代币(请参阅标准的“批准”部分)。

如果 _to 是零地址,则必须恢复。

如果 _ids 的长度与 _values 的长度不同,则必须恢复。

如果 _ids 中代币持有者的任何余额低于发送给接收者的 _values 中的相应金额,则必须恢复。

必须在任何其他错误时恢复。

必须发出 TransferSingle 或 TransferBatch 事件,以便反映所有余额变化(参见标准的“安全转移规则”部分)。

余额变化和事件必须遵循数组的顺序(_ids[0]/_values[0] 在 _ids[1]/_values[1] 之前,等等)。

在批处理中满足上述转移条件后,此函数必须检查_to 是否为智能合约(例如代码大小> 0)。如果是这样,它必须在 _to 上调用相关的 ERC1155TokenReceiver 钩子并采取适当的行动(参见标准的“安全传输规则”部分)。


 

@param _values 每种令牌类型的传输量(顺序和长度必须与 _ids 数组匹配)
    @param _data 没有指定格式的附加数据,必须在调用 `_to` 上的 `ERC1155TokenReceiver` 钩子时保持不变发送
*/
function safeBatchTransferFrom(address _from, address _to, uint256[] calldata _ids, uint256[] calldata _values, bytes calldata _data) external;
  /** 
    @notice 获取账户代币余额。
    @param _owner 代币持有者地址
    @param _id 代币ID 
    @return 请求代币类型的_owner 余额
 */ 
function balanceOf(address _owner, uint256 _id) external view returns (uint256);
/** 
    @notice 获取多个账户/代币对的余额
    @param _owners 代币持有者的地址
    @param _ids 代币的ID 
    @return _owner 所请求代币类型的余额(即每个(owner, id)的余额) pair) 
 */ 
function balanceOfBatch(address[] calldata _owners, uint256[] calldata _ids) external view returns (uint256[] memory);



/**

@notice 启用或禁用第三方(“运营商”)管理所有调用者令牌的批准。

@dev 必须在成功时发出 ApprovalForAll 事件。

@param _operator 添加到授权运营商集合的地址

@param _approved 如果运营商获得批准,则为真,撤销批准为假

*/

function setApprovalForAll(address _operator, bool _approved) external;


/** 
    @notice 查询给定所有者的操作员的批准状态。
    @param _owner 代币的拥有者
    @param _operator 授权运营商的地址
    @return 如果运营商被批准为真,否则为假
*/ 
function isApprovedForAll(address _owner, address _operator) external view returns (bool);



相关文章
|
5月前
|
数据安全/隐私保护
ERC314协议
ERC314协议
38 0
|
JavaScript 前端开发 API
如何通过合约获取所有ERC20转账
通过使用正确的API,可以轻松获取与合约地址相关的ERC20代币的所有转账记录。通过创建账户、编写使用API的脚本并使用getTokenTransfers函数,您可以访问和分析有关ERC20代币的有价值的转账数据。
237 0
|
JavaScript 前端开发 IDE
如何获取某个地址拥有的所有ERC20代币
本文将介绍如何设置Chainbase帐户、编写使用Chainbase API的脚本以及获取ERC20令牌余额的过程。
287 0
|
前端开发 安全 JavaScript
  ERC20 Token智能合约DApp开发
ERC20 Token智能合约DApp开发是指基于以太坊区块链平台和ERC20 Token标准开发的去中心化应用程序,用于数字货币、代币、积分等的发行、交易和管理。
|
测试技术 API 区块链
【Web3探索】NFT 标准的演变:ERC-721 与 ERC-1155
要了解NFT的当前情况,我们必须深入了解它们的发展历史。ERC-20标准在代币领域占据主导地位,为各种项目提供了可替代代币的创建。ERC-1155结合了可替代和不可替代代币,为开发者在代币管理方面提供了更多的灵活性和效率。
159 0
|
区块链
ERC20代币合约开发规则详解(源码示例)
ERC20代币合约是一个遵循ERC20标准的代币合约,它实现了代币转移、代币冻结、代币解锁等功能。作为一个通用的标准,ERC20代币合约可以被广泛应用于各种去中心化交易所、钱包、ICO等场景。
如何创建以太坊ERC20代币
看这篇文章需要对以太坊,智能合约,代币等概念有基本的了解。 什么是ERC20 可以把ERC20简单理解成以太坊上的一个代币协议,所有基于以太坊开发的代币合约都遵守这个协议。
2110 0
ERC20 Short Address Attack
ERC20 Short Address Attack
|
区块链
ERC777剖析
ERC777是一个新的高级代币标准,可以视为ERC20的升级版本,因此它解决了ERC20以及ERC223存在的一些问题,开发者可以根据自己的具体需求进行选型。 1、使用ERC820进行合约注册 有别于ERC20的自由散漫,ERC777利用了新的ERC820标准提供的集中式的智能合约注册表和合约接口实现查询功能,以实现某种程度的内省。
1276 0