Skip to main content

5. 马赛克

本章介绍 Mosaic 设置及其生成方式。 在 Symbol 中,令牌被称为马赛克。

根据维基百科的描述,令牌(Token)是“各种形状的泥制品,直径约为1厘米,出土于公元前8000年至公元前3000年的美索不达米亚层。”另一方面,马赛克(Mosaic)是“一种装饰艺术技巧,通过将小块材料组装嵌入以形成图像或图案。石材、陶瓷(马赛克瓷砖)、有色和无色玻璃、贝壳和木材用于装饰建筑或工艺品的地面和墙壁。” 在 Symbol 中,马赛克可以被认为是代表 Symbol 区块链创建的生态系统各个方面的各种组件。

5.1 马赛克生成

对于马赛克生成,定义要创建的马赛克。

supplyMutable = true; //Availability of supply changes
transferable = false; //Transferability to third parties
restrictable = true; //Availability of restriction settings
revokable = true; //Revocability from the issuer
//Mosaic definition
nonce = sym.MosaicNonce.createRandom();
mosaicDefTx = sym.MosaicDefinitionTransaction.create(
undefined,
nonce,
sym.MosaicId.createFromNonce(nonce, alice.address), //Mosaic ID
sym.MosaicFlags.create(supplyMutable, transferable, restrictable, revokable),
2, //Divisibility:Divisibility
sym.UInt64.fromUint(0), //Duration:Effective date
networkType,
);

马赛克标志如下。

MosaicFlags {
supplyMutable: false, transferable: false, restrictable: false, revokable: false
}

可以指定供应变更的许可、向第三方的可转让性、Mosaic 全球限制的应用和发行人的可撤销性。 一旦设置这些属性,以后就不能更改。

可分割性

可被整除性(Divisibility)决定了可以测量数量的小数位数。数据以整数值保存。

divisibility:0 = 1
divisibility:1 = 1.0
divisibility:2 = 1.00

持续时间

如果指定为 0,则不能再细分为更小的单元。 如果设置了马赛克有效期,有效期过后数据不会消失。 请注意,每个帐户最多可以拥有 1,000 个马赛克。

接下来,更改数量。

//Mosaic change
mosaicChangeTx = sym.MosaicSupplyChangeTransaction.create(
undefined,
mosaicDefTx.mosaicId,
sym.MosaicSupplyChangeAction.Increase,
sym.UInt64.fromUint(1000000),
networkType,
);

如果supplyMutable:false,只有当整个马赛克的供应量在发行者的账户中时,数量才能被更改。 如果整除率 > 0,则将其定义为最小单位为 1 的整数值。 (如果要创建 1.00 可整除性,请指定 100:2)

马赛克供应量更改操作如下所示。

{0: 'Decrease', 1: 'Increase'}

如果要增加它,请指定增加。 将上面的两个事务合并成一个聚合事务。

aggregateTx = sym.AggregateTransaction.createComplete(
sym.Deadline.create(epochAdjustment),
[
mosaicDefTx.toAggregate(alice.publicAccount),
mosaicChangeTx.toAggregate(alice.publicAccount),
],
networkType,
[],
).setMaxFeeForAggregate(100, 0);
signedTx = alice.sign(aggregateTx, generationHash);
await txRepo.announce(signedTx).toPromise();

请注意,聚合交易的一个特点是它会尝试更改尚不存在的马赛克的数量。 排列时,如果没有不一致,则可以在单个块内毫无问题的处理它们。

确认

确认创建马赛克的账户持有的马赛克信息。

mosaicRepo = repo.createMosaicRepository();
accountInfo.mosaics.forEach(async (mosaic) => {
mosaicInfo = await mosaicRepo.getMosaic(mosaic.id).toPromise();
console.log(mosaicInfo);
});
示例演示
> MosaicInfo {version: 1, recordId: '622988B12A6128903FC10496', id: MosaicId, supply: UInt64, startHeight: UInt64,}
> MosaicInfo
divisibility: 2 //Divisibility
duration: UInt64 {lower: 0, higher: 0} //Duration
> flags: MosaicFlags
restrictable: true //Availability of restriction settings
revokable: true //Revocability from the issuer
supplyMutable: true //Availability of supply changes
transferable: false //Transferability to third parties
> id: MosaicId
id: Id {lower: 207493124, higher: 890137608} //MosaicID
ownerAddress: Address {address: 'TBIL6D6RURP45YQRWV6Q7YVWIIPLQGLZQFHWFEQ', networkType: 152} //Issure address
recordId: "62626E3C741381859AFAD4D5"
supply: UInt64 {lower: 1000000, higher: 0} //Total supply

5.2 马赛克转移

传输创建的马赛克。 刚接触区块链的人常常把马赛克传输想像成“将存储在一个客户端的马赛克发送到另一个客户端”,但马赛克信息始终在所有节点之间共享和同步,而不是将马赛克信息传输到目的地。 更准确地说,它是指通过向区块链“发送交易”来重新组合账户之间代币余额的操作。

//Creating a receiving account
bob = sym.Account.generateNewAccount(networkType);
tx = sym.TransferTransaction.create(
sym.Deadline.create(epochAdjustment),
bob.address, //Destination address
// Transfer mosaic list
[
new sym.Mosaic(
new sym.MosaicId("3A8416DB2D53B6C8"), //TestnetXYM
sym.UInt64.fromUint(1000000), //1XYM(divisibility:6)
),
new sym.Mosaic(
mosaicDefTx.mosaicId, // Mosaic created in 5.1.
sym.UInt64.fromUint(1), // Amount:0.01(InCaseDivisibility:2)
),
],
sym.EmptyMessage,
networkType,
).setMaxFee(100);
signedTx = alice.sign(tx, generationHash);
await txRepo.announce(signedTx).toPromise();
传输马赛克列表

可以在单个事务中传输多个马赛克。 要传输 XYM,请指定以下马赛克 ID。

  • 主网:6BED913FA20223F8
  • 测试网:3A8416DB2D53B6C8

帐户

所有小数点也指定为整数。 XYM 可整除 6,因此指定为 1XYM=1000000。

交易确认

txInfo = await txRepo
.getTransaction(signedTx.hash, sym.TransactionGroup.Confirmed)
.toPromise();
console.log(txInfo);
示例演示
> TransferTransaction
deadline: Deadline {adjustedValue: 12776690385}
maxFee: UInt64 {lower: 19200, higher: 0}
message: RawMessage {type: -1, payload: ''}
> mosaics: Array(2)
> 0: Mosaic
amount: UInt64 {lower: 1, higher: 0}
> id: MosaicId
id: Id {lower: 207493124, higher: 890137608}
> 1: Mosaic
amount: UInt64 {lower: 1000000, higher: 0}
> id: MosaicId
id: Id {lower: 760461000, higher: 981735131}
networkType: 152
payloadSize: 192
recipientAddress: Address {address: 'TAR6ERCSTDJJ7KCN4BJNJTK7LBBL5JPPVSHUNGY', networkType: 152}
signature: "7C4E9E80D250C6D09352FB8EC80175719D59787DE67446896A73AABCFE6C420AF7DD707E6D4D2B2987B8BAD775F2989DCB6F738D39C48C1239FC8CC900A6740D"
signer: PublicAccount {publicKey: '0E5C72B0D5946C1EFEE7E5317C5985F106B739BB0BC07E4F9A288417B3CD6D26', address: Address}
> transactionInfo: TransactionInfo
hash: "DE479C001E9736976BDA55E560AB1A5DE526236D9E1BCE24941CF8ED8884289E"
height: UInt64 {lower: 326922, higher: 0}
id: "626270069F1D5202A10AE93E"
index: 0
merkleComponentHash: "DE479C001E9736976BDA55E560AB1A5DE526236D9E1BCE24941CF8ED8884289E"
type: 16724
version: 1

可以看到在TransferTransaction的马赛克中转了两种类型的马赛克。您还可以在 TransactionInfo 中找到有关已批准区块的信息。

5.3 使用提示

存在证明

上一章解释了交易的存在证明。 一个账户创建的转账指令可以作为不可磨灭的记录留下,这样就可以创建一个绝对一致的账本。 由于为所有账户累积了“绝对的、不可磨灭的交易指令”,因此每个账户可以证明自己拥有的马赛克。 由于为所有账户累积了“不可磨灭的交易指令”,因此每个账户可以证明自己拥有的马赛克。 (在本文档中,拥有被定义为“有能力随意放弃的状态”。稍微离题,但“有能力随意放弃的状态”的意义在于,数字数据的所有权至少在日本尚未得到法律承认,而一旦您知道了这些数据,就无法向他人证明您已经自愿遗忘了它。区块链允许您清楚地指示放弃这些数据,但我将把详细信息留给法律专家。)

NFT (非同质化代币)

通过将代币总供应量限制为 1 并将 supplyMutable 设置为 false,只能发行一个代币,并且永远不会再存在。

马赛克存储有关发出马赛克的帐户地址的信息,并且该数据不能被篡改。因此,来自发出马赛克的账户的交易可以被视为元数据。

请注意,还有一种方法可以将元数据注册到 马赛克,如第 7 章所述,可以通过注册帐户和 马赛克 发布者的多重签名来更新。

创建 NFT 的方法有很多种,下面给出了一个过程示例(执行时请适当设置 nonce 和 flag 信息)。

supplyMutable = false; //Availability of supply changes
//Mosaic definition
mosaicDefTx = sym.MosaicDefinitionTransaction.create(
undefined,
nonce,
mosaicId,
sym.MosaicFlags.create(supplyMutable, transferable, restrictable, revokable),
0, //Divisibility:Divisibility
sym.UInt64.fromUint(0), //Duration:Indefinite
networkType,
);
//Fixed mosaic quantity
mosaicChangeTx = sym.MosaicSupplyChangeTransaction.create(
undefined,
mosaicId,
sym.MosaicSupplyChangeAction.Increase, //Increase
sym.UInt64.fromUint(1), //Amount1
networkType,
);
//NFTdata
nftTx = sym.TransferTransaction.create(
undefined, //Deadline:Duration
alice.address,
[],
sym.PlainMessage.create("Hello Symbol!"), //NFTdata
networkType,
);
//Generating mosaic and aggregating NFT data and registering them in blocks.
aggregateTx = sym.AggregateTransaction.createComplete(
sym.Deadline.create(epochAdjustment),
[
mosaicDefTx.toAggregate(alice.publicAccount),
mosaicChangeTx.toAggregate(alice.publicAccount),
nftTx.toAggregate(alice.publicAccount),
],
networkType,
[],
).setMaxFeeForAggregate(100, 0);

马赛克信息中包含马赛克生成时的区块高度和创建账户,因此通过搜索同一区块内的交易,可以检索到与马赛克关联的NFT数据。 可以检索与同一块中的交易关联的 NFT 数据。

注意事项

如果马赛克的创建者拥有全部数量,则可以更改总供应量。 如果将数据拆分成交易记录,则不可篡改,但可以追加数据。 在管理 NFT 时,请注意妥善管理,例如严格管理或丢弃马赛克创建者的私钥。

可撤销的积分服务操作。

将 transferable 设置为 false 可以限制转售,使得可以定义出更不易受到结算法律或规定影响的积分。 将 revokable 设置为 true 可以启用集中管理的积分服务操作,用户无需管理私钥即可收集使用的金额。

transferable = false; //Transferability to third parties
revokable = true; //Refundability from the issuer