什么是 CGAS

CGAS 是由 NGD（NEO Global Development）发布的符合 NEP-5 规范的合约资产，CGAS 可由 GAS 一比一地对换，并且支持退回操作。该合约的目的是将 GAS 进行全局资产的合约映射，使全局资产 GAS 可以方便地在合约内部流转，支持由合约调用转账。

为什么要发布 CGAS？

因为在 NEO 上面的众多 DApps项目方都有一个需求，要在合约中使用一种流通性强，价格相对稳定的数字资产。但受限于 NEO 智能合约的限制和安全性考虑，无法在智能合约中对全局资产（如 NEO 或 GAS）进行转账。而项目方自己发行一种 NEP-5 代币又无法拥有广泛的流通性，无论是让社区认可其代币还是让其代币在交易所上流通，对项目方来说都是个成本很高的事情，而且所有项目发均发行自己的NEP-5资产也是一种浪费。所以社区强烈建议由 NGD 来发行一种与 NEO 或 GAS 锚定的 NEP-5 资产，以供社区统一使用，所以 CNEO 和 CGAS 就诞生了。

CGAS 是如何映射全局资产的呢？

在 CGAS 中通过 mintTokens 和 refund 方法进行全局资产的兑换和退回，无需中心化机构的承兑，完全的去中心化。mintTokens 的方式跟众多项目的 Token Sale 的代码类似，在方法内部对全局资产和合约资产进行了 1:1 的兑换。在 refund 方法中，是预先将一个 UTXO 标记为指定的用户可以取回，然后该用户发起转账将该资产转到自己的地址中。更多细节可以参考 GitHub。这个设计理念由 NEL 团队提出并进行了开源的代码实现，对此表示感谢。

CGAS 中的 C 是什么意思？

Contract，合约的意思。

有社区项目已经开发的映射全局资产的合约，为什么 NGD 要开发 CGAS 呢？

据了解，社区的映射全局资产的合约是不开源的，无法解决信任问题。NGD 开发的 CGAS 是开源的，去中心化的，而且没有使用限制，任何项目方都可以使用。

技术介绍

NEP-5 规范中的方法：

方法	参数	返回值	描述
balanceOf	byte[] account	int	获得某个账户 CGAS 的余额，返回结果为真实值 × 10⁸
decimals	—	int	获得 CGAS 精度，返回值为常量 8
name	—	string	获得合约名称，返回值为常量 NEP5 GAS
symbol	—	string	获得合约符号，返回值为常量 CGAS
totalSupply	—	int	获得 CGAS 总发行量，返回结果为真实值 × 10⁸。因为 CGAS 与 GAS 为一比一兑换，所以合约地址中 GAS 的数量等于 CGAS 的总发行量
transfer	byte[] from, byte[] to, int amount	bool	转账方法，将 CGAS 从发送者（from）账户，转到接收者（to）账户，转账金额为 amount；from 与 to 为 Script Hash，amount 为实际转账金额 × 10⁸。该方法同时支持用户调用和合约调用。

该合约为了支持 GAS 与 CGAS 互换，除了满足 NEP-5 规范中的方法其它方法：

方法	参数	返回值	描述
getRefundTarget	byte[] txId	byte[]	获得某个 UTXO 是谁待退回的，参数为 UTXO 中的交易 ID（确定一个 UTXO 由 txId 和 output 索引共同完成，这里 output 索引默认为 0），返回值为这个 UTXO 的退回者，他可以将这个 UTXO 作为交易输入，将 GAS 从 CGAS 地址中取走。
getTxInfo	byte[] txId	TransferInfo	获得某个交易 ID 的详细转账信息，在以下 4 种情况中可记录 TxInfo：mintTokens, Refund, transfer, transferAPP。
mintTokens	—	bool	CGAS 的铸币方法。用户通过发起 InvocationTransaction，将 GAS 转给 CGAS 合约地址，并且调用 mintTokens 完成 GAS 到 CGAS 的转换工作。合约调用成功后，用户资产中将会增加与兑换的 GAS 数额相等的 CGAS。注意事项
refund	byte[] from	bool	用户将 CGAS 提取，变成 GAS 总共分两步。第一步，发起一笔 InvocationTransaction 其中包含一笔从 CGAS 地址到 CGAS 地址的 GAS 转账（转账金额为用户想退回的 GAS 的数量），并调用 refund 方法（参数为退回者的 Script Hash）。合约调用成功后，将自动销毁与退回数量相等的 CGAS，并把该交易的第 0 号 output 标记为所属于该用户。第二步，用户构造一个交易将第一步标记过的 UTXO 作为交易输入，交易输出为用户自己的地址，从而将 GAS 从 CGAS 地址中取走。
supportedStandards	—	string	NEP-10 规范，返回合约所支持的 NEP 标准，返回值为常量，数组格式：{ "NEP-5", "NEP-7", "NEP-10" }

NEP-5 规范中的通知：

通知	参数	描述
transfer	byte[] from, byte[] to, int value	通知中包含转账的 3 个要素，发送者 （from），接收者 （to） ，转账金额 （value）, 转账资产默认为 CGAS

该合约实现的其它通知：

通知	参数	描述
refund	byte[] txid, byte[] who	通知中包含转账的 2 个要素，待退回的 UTXO（txid），退回者的 Script Hash（who）

[注意]

在 mintTokens 的时候请注意，InvocationTransaction 的 Inputs 和 Output 加起来不应该超过60个，否则在执行时所需的手续费会超过 10 GAS 的免费额度。如果有大量 GAS 的 UTXO 需要换成 CGAS，建议先进行一个普通转账，将 UTXO 合并，然后再进行 mintTokens 操作。

版本说明

1.0.3

Script Hash: 0x74f2dc36a68fdc4682034178eb2220729231db76

CGAS Contract Address: AScKxyXmNtEnTLTvbVhNQyTJmgytxhwSnM

Known Issues: not found

1.0.2

Script Hash: 0x505663a29d83663a838eee091249abd167e928f5

CGAS Contract Address: Ae8AD6Rc3cvQapqttJcUTj9ULfLi2tLHmc

Known Issues: transfer method cannot be called by other contract

1.0.1

Script Hash: 0x9121e89e8a0849857262d67c8408601b5e8e0524

CGAS Contract Address: AK4LdT5ZXR9DQZjfk5X6Xy79mE8ad8jKAW

Known Issues: transferAPP method naming not canonical