1.简介
2.合约操作
3.数据结构
5.更新日志
一款EOSIO区块链上的数字资产标准，适用于不可替代代币（Non-Fungible Tokens，NFTs）、可替代代币(Fungible Tokens，FTs) 和 不可转让代币（Non-Transferable Tokens，NTTs），由CryptoLions开发创建。
Git: https://github.com/CryptoLions/SimpleAssets
Telegram: https://t.me/simpleassets
简介和演示：https://medium.com/\@cryptolions/introducing-simple-assets-b4e17caafaa4
作者的事件接收器示例：https://github.com/CryptoLions/SimpleAssets-EventReceiverExample
警告现在最小基于eosio.cdt v1.6.3版。
通过调用简单资产（Simple Assets）合约来使用Simple Assets。这就像是Dapps的Dapp。
丛林测试网:simpleassets
EOS 主网: simpleassets
WAX 主网： simpleassets
MEETONE 主网: smplassets.m
TELOS 主网: simpleassets
PROTON: simpleassets
简单资产（Simple Assets）是一个独立的合约，其他Dapps可以直接调用它来管理自己的数字资产。这为Dapp用户提供了额外的保证，即资产的所有权由信誉良好的外部机构管理，并且一旦创建，Dapp只能管理资产的mdata部分。 所有与所有权相关的功能都存在于游戏之外。
我们正在创建一个DAC，它将在部署至EOSIO主网后对简单资产（Simple Assets）策划更新。
运用regauthor操作发送自己的NFTs信息至第三方商城。
或者，dapps可以自行部署简单资产（Simple Assets）副本并进行修改以更好地控制其功能。部署前，应修改简单资产（Simple Assets）以防止任何人创建资产。
NFT的RAM使用量取决于idata和mdata字段中存储的数据量。如果它们都为空，则每个NFT占用276个字节。
idata和mdata中的每个符号都是+1字节。
需要可替代代币的Dapps应该在使用标准eosio.token合约和“简单资产（Simple Assets）”合约之间做出决定。 区别如下：
在简单资产中（Simple Assets）
* Scope is Author instead of Symbol
* Stat table includes also additional data about each FT (see [Currency Stats](#currency-stats-fungible-token) below)
* For transfers you need to use ```transferf``` action from SA contract.
* If author sets ```authorcontrol``` flag, the author can transfers/burn/etc user's FTs independent of user's consent.
* The table which tracks FTs includes the author's account name, allowing different dapps to have FTs with the
same name. (Example: https://bloks.io/contract?tab=Tables&table=accounts&account=simpleassets&scope=bohdanbohdan&limit=100)
不可转让代币(NTTs)最可能的的两种用例是
* licenses which can be granted to an account, but not transfered.
* prizes and awards given to a particular account.
使用不可转让代币(NTTs)的原因：
* the NTTs appearing in third party asset explorers.
* some functionality is handled by Simple Assets.
更多有关NTTs的信息: https://medium.com/@cryptolions/introducing-non-transferable-tokens-ntts-2f1a532bf170
可在此处找到每个参数的说明：https://github.com/CryptoLions/SimpleAssets/blob/master/include/SimpleAssets.hpp
authorreg ( name author, string dappinfo, string fieldtypes, string priorityimg )
authorupdate ( name author, string dappinfo, string fieldtypes, string priorityimg )
\# -- For Non-Fungible Tokens （NTFs） ---
create (author, category, owner, idata, mdata, requireсlaim)
update (author, owner, assetid, mdata)
transfer (from, to , [assetid1,..,assetidn], memo)
burn (owner, [assetid1,..,assetidn], memo)
offer (owner, newowner, [assetid1,..,assetidn], memo)
canceloffer (owner, [assetid1,..,assetidn])
claim (claimer, [assetid1,..,assetidn])
delegate (owner, to, [assetid1,..,assetidn], period, memo)
undelegate (owner, from, [assetid1,..,assetidn])
delegatemore (owner, assetid, period)
attach (owner, assetidc, [assetid1,..,assetidn])
detach (owner, assetidc, [assetid1,..,assetidn])
attachf (owner, author, quantity, assetidc)
detachf (owner, author, quantity, assetidc)
mdadd (author, data)
mdupdate (id, author, data)
mdremove (id)
mdaddlog (id, author, data)
\# -- For Fungible Tokens (FTs)---
createf (author, maximum_supply, authorctrl, data)
updatef (author, sym, data)
issuef (to, author, quantity, memo)
transferf (from, to, author, quantity, memo)
burnf (from, author, quantity, memo)
offerf (owner, newowner, author, quantity, memo)
cancelofferf (owner, [ftofferid1,...,ftofferidn])
claimf (claimer, [ftofferid1,...,ftofferidn])
openf (owner, author, symbol, ram_payer)
closef (owner, author, symbol)
\# -- For Non-Transferable Tokens (NTTs) ---
createntt (author, category, owner, idata, mdata, requireсlaim)
updatentt (author, owner, assetid, mdata)
burnntt (owner, [assetid1,..,assetidn], memo)
claimntt (claimer, [assetid1,..,assetidn])
sasset {
uint64_t id; // 用于转移和搜索的资产ID
name owner; // 资产所有者（可变更 — 由所有者决定!!!）
name author; // 资产创建者（游戏合约，不可变更）
name category; // 资产类别，由创建者选择，不可变更
string idata; // 不可变更资产数据。 它可以是字符串化“JSON”或只是字符串“sha256”
string mdata; // 可变资产数据，由创建者在创建或资产更新时添加。 它可以是字符串化“JSON”或只是字符串“sha256”
sasset[] container; // 其它NFTs(可替代和不可替代代币)附加到此资产
account[] containerf; // FTs(可替代代币)附加到此资产
}
//为帮助第三方资产浏览器，我们建议在idata或mdata请包含以下字段：//name（文本）//img (图像的网页链接) //以及 desc（文本描述）的信息。
offers {
uint64_t assetid; // 提供 claim 的资产ID
name owner; // 资产所有者
name offeredto; // 可以 claim 此资产的人
uint64_t cdate; // 创建日期
}
authors {
name author; // 资产创建者，将能够创建和更新资产
string data; // 创建者的数据（json）将被商城用于更好的展示
// 建议：形象徽标（logo），信息，网址;
string stemplate; // 数据（json）模式将告诉第三方市场如何显示每个NFT field。
//key：状态值，其中 key 是 idata 或 mdata 的字段名
//建议格式：
//txt | 默认类型
//url | 显示可点击的网页链接
//img | 链接至img文件
//webgl | 链接至webgl文件
//mp3 | 链接至mp3文件
//video | 链接至视频文件
//hide | 不显示
//imgb | 图片作为二进制字符串
//webglb | webgl二进制
//mp3b | mp3二进制
//videob | 视频二进制
string imgpriority; //指定NFTs类别的主图像字段
//
// 这用于当您想把自己的NFTs主要图像移作他用
// 不仅是一个指向image field中指定的img图片URL链接, 也允许您创建具有不同image field的NFTs类别
//
//数据是分层的json
//value： 来自idata或mdata field, 将用作
//所有类别NFTs的主要图像
}
delegates{
uint64_t assetid; // 提供用于claim的资产ID;
name owner; // 资产所有者;
name delegatedto; // claim该资产者;
uint64_t cdate; // 提供创建日期;
uint64_t period; // 借出资产时间（以秒为单位），借出人不可取消，直到期限到期
// 期限到期，但接收方可随时转回
string memo; // 合约参数备忘录，最长64字节
}
stat {
asset supply; // 提供代币
asset max_supply; // 提供最大量代币
name issuer; // 可替代代币（Fungible token）创建者
uint64_t id; // 此代币的唯一ID
bool authorctrl; // 如果 true（1）允许代币创建者（而不仅仅是所有者）进行烧录和传输
string data; // 字符串化的json。 建议的keys包括： img，name
}
accounts {
uint64_t id; // 代币ID，来自 stat 表
name author; // 代币创建者
asset balance; // 代币余额
}
offerfs {
uint64_t id; // claim 此 offer 的ID（自动递增）
name author; // 可替代代币(fungible token)创建者
name owner; // 可替代代币(fungible token)所有者
asset quantity; // 资产数量
name offeredto; // 可以 claim 此 offer 的帐户
uint64_t cdate; // offer创建日期
}
snttassets {
uint64_t id; // NTT id 用于 claim 或 burn;
name owner; // 资产所有者 (可变 - 基于所有者!!!);
name author; // 资产创建者 (游戏合约, 不可变);
name category; // 资产类别, 有创建者选择, 不可变;
string idata; // 不可变资产数据. 可以是 JSON 字符串化或只是 sha256 字符串;
string mdata; // 可变资产数据, 有创建者创建或更新资产时添加
// 可以是 JSON 字符串化或只是 sha256 字符串;
}
nttoffers {
uint64_t id; // 用于 claim 的 offer id (自动递增)
name author; // ft 创建者
name owner; // ft 所有者
asset quantity; // 数量
name offeredto; // 可以 claim the offer 的账户
uint64_t cdate; // offer 的创建日期
}
moredata{
uint64_t id; // id of the more data
name author; // author of the more data
string data; // more data
}
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
name author = get_self();
name category = "weapon"_n;
name owner = "ownerowner22"_n;
string idata = "{\\"power\\": 10, \\"speed\\": 2.2, \\"name\\": \\"Magic
Sword\\" }";
string mdata = "{\\"color\\": \\"bluegold\\", \\"level\\": 3, \\"stamina\\": 5,
\\"img\\": \\"https://bit.ly/2MYh8EA\\" }";
action createAsset = action(
permission_level{author, "active"_n},
SIMPLEASSETSCONTRACT,
"create"_n,
std::make_tuple( author, category, owner, idata, mdata, 0 )
);
createAsset.send();
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
name author = get_self();
name category = "balls"_n;
name owner = "ownerowner22"_n;
string idata = "{\\"radius\\": 2, \\"weigh\\": 5, \\"material\\": \\"rubber\\",
\\"name\\": \\"Baseball\\" }";
string mdata = "{\\"color\\": \\"white\\", \\"decay\\": 99, \\"img\\":
\\"https://i.imgur.com/QoTcosp.png\\" }";
action createAsset = action(
permission_level{author, "active"_n},
SIMPLEASSETSCONTRACT,
"create"_n,
std::make_tuple( author, category, owner, idata, mdata, 1 )
);
createAsset.send();
- 请添加有关资产结构的hpp文件信息。
TABLE account {
uint64_t id;
name author;
asset balance;
uint64_t primary_key()const {
return id;
}
};
typedef eosio::multi_index\< "accounts"_n, account \> accounts;
TABLE sasset {
uint64_t id;
name owner;
name author;
name category;
string idata;
string mdata;
std::vector\<sasset\> container;
std::vector\<account\> containerf;
auto primary_key() const {
return id;
}
uint64_t by_author() const {
return author.value;
}
};
typedef eosio::multi_index\< "sassets"_n, sasset,
eosio::indexed_by\< "author"_n, eosio::const_mem_fun\<sasset, uint64_t,
&sasset::by_author\> \>
\> sassets;
- 搜索和使用信息
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
name author = get_self();
name owner = "lioninjungle"_n;
uint64_t assetid = 100000000000187
sassets assets(SIMPLEASSETSCONTRACT, owner.value);
auto idx = assets.find(assetid);
check(idx != assets.end(), "Asset not found or not yours");
check (idx-\>author == author, "Asset is not from this author");
auto idata = json::parse(idx-\>idata); // for parsing json here is used nlohmann
lib
auto mdata = json::parse(idx-\>mdata); // https://github.com/nlohmann/json
check(mdata["cd"] \< now(), "Not ready yet for usage");
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
auto mdata = json::parse(idxp-\>mdata);
mdata["cd"] = now() + 84600;
name author = get_self();
name owner = "ownerowner22"_n;
uint64_t assetid = 100000000000187;
action saUpdate = action(
permission_level{author, "active"_n},
SIMPLEASSETSCONTRACT,
"update"_n,
std::make_tuple(author, owner, assetid, mdata.dump())
);
saUpdate.send();
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
name author = get_self();
name from = "lioninjungle"_n;
name to = "ohtigertiger"_n;
std::vector\<uint64_t\> assetids;
assetids.push_back(assetid1);
assetids.push_back(assetid2);
string memo = "Transfer two asset"
action saUpdate = action(
permission_level{author, "active"_n},
SIMPLEASSETSCONTRACT,
"transfer"_n,
std::make_tuple(from, to, assetids, memo)
);
saUpdate.send();
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
asset wood;
wood.amount = 100;
wood.symbol = symbol("WOOD", 0);
name author = get_self();
name to = "lioninjungle"_n;
std::string memo = "WOOD faucet";
action saRes1 = action(
permission_level{author, "active"_n},
SIMPLEASSETSCONTRACT,
"issuef"_n,
std::make_tuple(to, author, wood, memo)
);
saRes1.send();
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
asset wood;
wood.amount = 20;
wood.symbol = symbol("WOOD", 0);
name from = "lioninjungle"_n;
name to = get_self();
name author = get_self();
std::string memo = "best WOOD";
action saRes1 = action(
permission_level{author, "active"_n},
SIMPLEASSETSCONTRACT,
"transferf"_n,
std::make_tuple(from, to, author, wood, memo)
);
saRes1.send();
name SIMPLEASSETSCONTRACT = "simpleassets"_n;
asset wood;
wood.amount = 20;
wood.symbol = symbol("WOOD", 0);
name author = get_self();
name from = "lioninjungle"_n;
std::string memo = "WOOD for oven";
action saRes1 = action(
permission_level{author, "active"_n},
SIMPLEASSETSCONTRACT,
"burnf"_n,
std::make_tuple(from, author, wood, memo)
);
saRes1.send();
- 重新启用事件通知，执行如下操作： saeburn, saeclaim, saetransfer, saechauthor, saecreate.
- 更改了通知的逻辑 如果需要将有关资产范围的变化通知给创建者的合约，请参考例子 https://github.com/CryptoLions/SimpleAssets-EventReceiverExample
- 增加了burnlog, burnflog, burnnttlog
- 增加了对集装器中附加资产的烧录的限制
- 增加了对附加到委托资产的限制
- 代码更新
- SAE通知暂停使用
- 增加了将SimpleAssets.hpp添加或包含至其他项目中的可能性。这有助于技术开发人员轻松地将简单资产(Simple Assets)集成整合至其它合约中
- 增加了技术开发人员功能sa_getnextid，用来轻松获取新创建资产的id
- 增加了更多数据功能(actions mdremove, mdupdate, mdaddlog, mdadd)。这提供了一个简单资产列表，该列表可以存储NFTs的其它或者重复的信息，并且保持最小占用RAM
- 重命名"Author Registration"(创建者注册)中的字段和操作，以提高工作效率 regauthor -> authorreg data -> dappinfo stemplate -> fieldtypes imgpriority -> priorityimg
- 在自述文件中添加了"Author Registration"(创建者注册)文档
- 重新委托资产。（资产的借出人可以允许他们重新借出）
- 在委托动作中添加了新的参数
bool reelegate，它允许资产重新委托 - 在表委托中添加了新的字段
bool reelegate=>在自部署合约的情况下需要迁移！ - 取消删除操作中的参数，已从中删除。 （在委托人表中可以找到借款人的身份）
- 固定转移空资产数组
- 错误消息已改进，更加清晰
- 代码重构
- 使用最新的合约开发工具包（CDT v1.6.3）进行升级（解决了此编译问题
- 次要代码重构
- 不可转让代币（NTTs）-新tables: snttassets 和 nttoffers
- 新 NTT 操作: createntt, createnttlog, claimntt, updatentt, burnntt
- 委托更多修复操作（感谢 cc32d9）
- ricardian 合约更新
- 为NTT添加外部逻辑测试
- ricardian 合约更新
- 可替代代币报价问题修复
- 把
string imgpriority字段添加至sauthor表以及regauthor和authorupdate操作中 - 重要信息：自我部署简单资产可能需要迁移 regauthor 表（如果使用）
- 优化 claim/transfer/burn 功能
- 备注字段已添加至delegates表（这允许出租者/游戏创建不同类别的借入资产-例如高风险/低风险）。在进行delegate操作时，操作参数的备忘录将存储至此新字段。最多64字节
- 为delegate备忘录添加三个新测试单元
- 代码重构
- 修复了为委托和转让的NFTs的分离批量处理功能
- 新合约允许延长借用NFT的委托期限
- 增加了外部（bash）单元测试
createlog操作中的新参数requireclaim，用于create操作历史记录日志
- 阻止所有者向自己提供资产
saeclaim事项的格式已更改：由 map <assetid，from>替换asseti数组
- 添加了
require_recipient（所有者）来执行create操作
轻松找到可替代代币的信息（可替换代币有创建者范围）：
- FT的
account表中的新字段author（更容易找到可替代代币信息）
更多可替代代币信息
- 新领域
data中currency_stats的表-字符串化JSON其中可能包括键img，name（建议最好通过市场显示） - 新参数
data在createf操作中 - updatef改变FT的新举措data
提供/声明可替代的代币
sofferf用于offer/calimFT的新表- 新的操作
ffer，cancelofferf和claimf对closef检查如果没有公开招股（内部）
集装资产
- nft资产结构中用于附加和分离其他NFT或FT的新字段
container和containerf - 新操作
attach，detach - 新操作
attachf，detach
杂项
- 字段重命名
lasted- >lnftid，spare- >defid（内部用法）在表global中 - 字段
providedTo在soffer表中重命名为offersto
- 为操作
offer添加了memo参数 - 为操作
delegate添加了memo参数
- 增加了NFT的内部操作
createlog。由创建操作用于记录资产ID，以便第三方资源管理器可以轻松获取新的资产ID和其他信息。 - 增加了新的单例表
tokenconfigs。它有助于外部合约正确解析操作和表格（对于分散交换，市场和使用多个代币的其他合约有用）。市场，交易所和其他依赖合约将能够使用以下代码查看此信息。
Configs configs("simpleassets"_n, "simpleassets"_n.value);
configs.get("simpleassets"_n);
- 增加了操作
updatever。它为第三方钱包，市场等更新了SimpleAstes部署的版本; - 事件通知的新示例： https://github.com/CryptoLions/SimpleAssets-EventReceiverExample
- 使用延迟事务添加了事件通知。资产作者将收到有关资产创建，转移，索赔或烧录的通知。要收到它，请为您的创建者合约添加以下操作：
ACTION saecreate ( name owner, uint64_t assetid );
ACTION saetransfer ( name from, name to, std::vector\<uint64_t\>& assetids,
std::string memo );
ACTION saeclaim ( name account, std::vector\<uint64_t\>& assetids );
ACTION saeburn ( name account, std::vector\<uint64_t\>& assetids, std::string
memo );
untildate参数更改为period（以秒为单位）的操作delegate和表sdelegates
使用eosio.token合约添加了可替代代币（Fungible Token）表和逻辑，但有一些更改
- 新的操作和逻辑：
createf，issuef，transfer，burnf，openf，closef - 添加了新表
stat(supply, max_supply, issuer, id)和accounts (id, balance) - 统计表的范围（关于可替代代币的信息）已更改为创建者
accountstable的主索引是在create f操作上创建的 uniq id 并存储在 stats 表中。- 添加
createf与 parameter 可替代代币操作authorctrl至stats表。如果为true（1）允许代币创建者（而不仅仅是所有者）使用burnf和transferf。创建后无法更改！ - 李嘉图合约已更新
- 以下有更多用法示例
杂项
- sdelagate 表结构重命名为 sdelegate（typo）
- 创建操作参数重命名：requireClaim - > requireclaim
- assetID操作参数在所有要声明的操作中重命名
借入资产
- sdelegate表 - 添加了新字段：untildate
- 委托操作添加参数untildate。如果参数输入正确（零或将来），操作会进行简单检查。
- undelegate在不公开之前不会工作（这保证了资产贷款的最低期限）。
- 如果被委托，允许转移资产（返还）早于截至时间（借款人可以提前返还）
批量处理
- 声明操作（claim action）：assetid参数已更改为assetsids数组。添加了多个声明逻辑
- 报价操作（offer action）：assetid参数已更改为assetsids数组。添加了多个提供逻辑
- 取消报价操作（canceloffer action）：assetid参数已更改为assetsids数组。添加了多个取消逻辑
- 传输操作（transfer action）：assetid参数已更改为assetsids数组。添加了多个资产转移逻辑。
- 烧录操作（burn action）：assetid参数已更改为assetsids数组。添加了多个刻录逻辑。
- 委托/非委托操作（delegate / undelegated action）：assetid参数已更改为assetsids数组。添加了多个委托/取消授权逻辑。