v0.2.x API 行为变更

[cssmagic]

Nasa.call()

返回值

👉 原：

Promise - Fulfilled：字符串。交易流水号。

改为：

Promise - Fulfilled：对象。交易流水号和 txHash（如果有），结构如下：

{
	payId: '...pay...id...',
	txHash: '...tx...hash...',
}

⚠️ 仅在 Chrome 钱包扩展环境下，才有可能返回 txHash。

请留意 txHash 的拼写。

Nasa.query()

返回值

👉 原：

合约调用时抛错被视为 Promise - Rejected，错误消息就是执行时抛出的错误消息。

改为：

合约调用时抛错将视为 Promise - Fulfilled（因为查询动作本身并没有发生错误，而且顺利拿到了合约调用结果），错误消息会放在 Promise 返回值的一个字段中。

👉 原：

Promise - Fulfilled：就是 JSON 反序列化之后的值。

改为：

Promise - Fulfilled：对象。合约调用返回值（如果有）和合约调用时的错误消息（如果有），结构如下：

// 正常调用
{
	execResult: {},  // 👉 合约调用返回值 JSON 反序列化之后的值
	estimateGas: "20490",
}

// 调用过程中抛错
{
	execError: 'my error msg',  // 👉 合约调用过程中抛出的错误消息
	estimateGas: "20490",
}

Nasa.checkTx()

改名

⚠️ 此 API 改名为 Nasa.getTxResult()。

原名仍然可用，但会在 v0.3.0 时删除。

返回值

👉 原：

合约调用时抛错被视为 Promise - Rejected，错误消息为 Nasa.error.CALL_FAILED 或 Nasa.error.TX_FAILED。

改为：

合约调用时抛错将视为 Promise - Fulfilled（因为查询动作本身并没有发生错误，而且顺利拿到了交易状态和结果），错误消息会放在交易详细信息中的一个字段中。

👉 原：

Promise - Fulfilled：把 execute_result 反序列化之后的值存放在 result 字段中。

改为：

Promise - Fulfilled：交易详细信息中提供合约调用返回值（如果有）和合约调用时的错误消息（如果有），示意结构如下：

// 正常调用
{
	"...": "...",  // from、to、gas 等基本信息，不赘述
	"execResult": {}, // 👉 "execute_result" 字段 JSON 反序列化之后的值
}

// 调用过程中抛错
{
	"...": "...",  // from、to、gas 等基本信息，不赘述
	"execError": "my error msg"  // 👉 合约调用过程中抛出的错误消息，不含前缀
}

注意，在交易详细信息中：

• 星云官方 RPC 接口返回的各字段名如果是 “小蛇形拼写”，将一律转换为 “小驼峰拼写”（比如：gas_price → gasPrice）。

• 不再提供 execute_result 和 execute_error 字段，请直接使用 execResult 和 execError 字段。

👉 原：

Promise - Rejected：其中 “查询超时（一分钟内都没有得到交易结果）” 的错误消息为 Nasa.error.REQUEST_TIMEOUT

改为：

这种情况下的错误消息为 Nasa.error.TX_TIMEOUT。

---

（完）

[cssmagic]

⚠️ 注意

execResult 如果 JSON 解析失败，则直接返回原字符串。

[cssmagic]

上述变更已由 PR #19 、PR #20 初步完成。