DApp(APLink) - Scatter协议

参考案例

参考详情

Scatter拥有的方法

---

• getIdentity - 用于获取身份（登录）

• forgetIdentity - 用于忘记身份（登出）

• authenticate - 用于证明身份的所有权。

• SuggestNetwork - 这是一个帮助方法，用于请求添加网站正在使用的 EOS 网络。

• amax - 用于获取amaxjs使用 Scatter 作为signProvider.

• requireVersion - 用于要求 scatter 的最低特定版本。

获取Scatter

---

有了scatter对像，才能操作scatter。

如果非页面初始化就要使用scatter，比如按钮点击事件调用等，就可以直接获取window.scatter全使用。

注意：scatter挂载需要在scatter插件初始化完成后，完成后才会document.dispatchEvent(new CustomEvent("scatterLoaded"));。

document.addEventListener("scatterLoaded", scatterExtension => { // Scatter will now be available from the window scope. // At this stage the connection to Scatter from the application is // already encrypted. const scatter = window.scatter;

// It is good practice to take this off the window once you have 
// a reference to it.
window.scatter = null;

// If you want to require a specific version of Scatter
scatter.requireVersion(3.0);

//...

})

获取身份（登录）

---

会现弹框，让你选择一个身份。如果已经登录，则不必在调用getIdentity，如果再次调用，则会报错。除非调用forgetIdentity登出，才能再次登录。

// You can require certain fields
scatter.getIdentity().then(identity => {
    //...
}).catch(error => {
    //...
});

当然也可以直接从scatter.identity获取身份，但这必须在身份选择后才能获取到。

identity信息如下：

{
    "hash": "8ed9aaf4d0ec98b510fcde1616d63c198ac5b40fa5588e1a1748f13b80f5bc32",
    "publicKey": "AM6cAE3pnY7peSdzv1DPdj15dHeoiu9hmwm41JzCe9sHmYZnrdCp",
    "name": "RandomRobin6658351",
    "kyc": false,
    "accounts": [
        {
            "name": "mk",
            "authority": "active",
            "blockchain": "amax"
        }
    ]
}

一般只使用accounts中信息，其它信息暂时无用（预留它用）。

忘记身份（登出）

---

一但调用forgetIdentity操作，scatter.identity中身份将被移除。

scatter.forgetIdentity().then(() => {
    //...
});

向用户推荐网络

---

如果您不使用通用网络，您可以建议用户将网络添加到他们的 Scatter。 相当于用户添加了一个网络。

scatter.suggestNetwork(network);

任意签名

---

您可以请求 Scatter 对您希望的任何类型的数据进行任意签名。 如果您需要对sha256哈希进行签名，请务必设置isHash为true，因为它使用不同的签名方法。否则总是让它为假。

scatter.getArbitrarySignature(
    publicKey, 
    data, 
    whatfor = "Login Authentication", 
    isHash = false
)

实例化一个AMAX对象

---

返回一个AMAX的代理对象，用这个对象可以进行链上的所有操作。

import Amax from "@amax/amaxjs";
const client = scatter.amax(
    network,
    Amax,
    {
        ...options,
        authorization: [`${account.name}@${account.authority}`],
    },
    network.protocol,
);