此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
一些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值。