开发文档

指定货币金额

此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
一些API方法要求你指定货币金额。指定风格取决于你用网络原生stm货币交易还是用其他货币单元(发行货币)交易。
STM
STM数量可以表示为字符串。(stm精度是64位整数,JSON整数被限制在32位,因而使用JSON有可能出现整数溢出。)STM形式上是以“drops”规定的,每个drop相当于0.000001个STM。因此,在JSON文档中,"1000000"代表1.0stm。
不要把STM指定为对象
单元测试允许提交有小数点的STM值 — 例如,“1.23”意为1.23STM。其他所有情况都应以drops说明,不能有小数点:例如“1230000”意为1.23STM。
非STM
如果你正在规定非STM货币(包括法定货币、贵金属、虚拟货币或其他自定义货币),你必须用货币规范对象来规定它。这是该JSON对象的三个字段:
字段 类型 描述
currency String - Currency Code Arbitrary code for currency to issue. Cannot be STM.
value String Quoted decimal representation of the amount of currency. This can include scientific notation, such as 1.23e11 meaning 123,000,000,000. Both e and E may be used.
issuer String Unique account address of the entity issuing the currency. In other words, the person or business where the currency can be redeemed.
例如,为了表示rR5Am25ArfXFmqgNwjZgnfk59EACMhs2hZc账户发行的153.75美元,你要指定:
{
    "currency": "USD",
    "value": "153.75",
    "issuer": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV"
}
单元测试允许以 "amount/currency/issuer"形式的斜线分割字符串提交非STM货币数量。其他所有情况都要使用上面的JSON对象形式。
指定没有金额的货币
如果你要指定没有数量的非STM货币(特别是为了定义货币交易要约的订货单),你需要像上面一样进行指定,但忽略value字段。 如果你要指定没有数量的STM(也是为了定义订货单),你应当用唯一 "currency"字段把它作为JSON对象。STM永远不要包含issuer字段。 最后,如果支付接收者账户信任发行货币的多个网关,你可以表明以接收者接受的任何发行货币组合进行支付。想要实现这个,在JSON对象中指定接收者账户地址为issuer值。
THE NEXT CONNECTION

下一次连接,从这里开始。

加入 Stream 社区,一起探索价值互联。

联系我们