Web应用扫码接入

登录

对于WEB应用，只要遵循SimpleWallet协议，即可通过MYKEY APP扫描二维码登录。

WEB应用通过二维码传递给MYKEY如下的数据，数据格式为json：

// 签名调用数据格式
{
    protocol string     // 协议名，本协议默认 SimpleWallet
    version string      // 协议版本信息，如1.0
    dappName string     // dapp名称
    dappIcon string     // dapp应用图标url
    action string       // 操作类型，为 login
    uuID string         // dapp服务器为本次登录产生的uuid
    loginUrl string     // dapp服务器验证登录的url
    expired number      // 仅Web二维码模式可用，过期时间，unix时间戳
    loginMemo string    // 登录备注信息
    chain string        // 可以是EOS,ETH或者Any(Any默认用EOS账号签名）
}

MYKEY APP通过扫描二维码，请求用户授权登录，并把签名数据提交到WEB应用指定的loginUrl。

WEB应用收到的MYKEY如下的数据，格式为json:

{
    protocol string     // 协议名，本协议默认 SimpleWallet
    version string      // 协议版本信息，如1.0
    timestamp number    // 当前unix时间戳
    sign string         // eos签名信息
    uuID string         // dapp服务器为本次登录产生的uuid
    Account string      // eos账户名
    Ref string          // 钱包名
}

WEB端使用签名账号的Reserved公钥进行验签。Reserved公钥需要通过读取mykey合约获得，见文档。

合约调用

Web扫码调用合约时序图

请传递给MYKEY如下的数据，数据格式为json：

// 合约调用数据格式
{
    protocol    string   // 协议名，本协议默认 SimpleWallet
    version     string   // 协议版本信息，如1.0
    action      string   // 操作类型，为 transaction
    dappName    string   // DApp应用名
    dappIcon    string   // DApp应用图标
    desc        string   // MYKEY显示给用户合约调用语义描述
    callback    string   // MYKEY回调DApp的深度链接，e.g. custom://custom.com/contract
    notifyUrl   string   // 合约调用成功通知DAppServer的回调URL接口
    ContractRequest [  //合约操作数组，包含转账与非转账合约操作
      { //非转账
          account   string // 合约名
          name      string // 合约方法
          info      string // MYKEY显示给用户的语义化描述
          data      object // 根据合约abi定义所传的参数对象 e.g. {key1: value1, key2: value2 }
      },
      { //转账
          account   string // 合约名
          name      string // 合约方法
          info      string // MYKEY显示给用户的语义化描述
          TransferDataRequest {
            from     string // 转账From
            to       string // 转账To
            quantity string // 转账金额和单位，e.g. "1.0000 EOS"
            memo     string // 链上备注
          }
      }
    ]
    expired        number   // 仅Web二维码模式可用，过期时间，unix时间戳
}

签名

Web扫码调用签名时序图

请传递给MYKEY如下的数据，数据格式为json：

// 签名调用数据格式
{
    protocol    string   // 协议名，本协议默认 SimpleWallet
    version     string   // 协议版本信息，如1.0
    action      string   // 操作类型，为 sign
    dappName    string   // DApp应用名
    dappIcon    string   // DApp应用图标
    desc        string   // MYKEY显示给用户签名调用语义描述
    message     string   // 需要签名的内容
    callback    string   // MYKEY回调DApp的深度链接，e.g. custom://custom.com/contract
    notifyUrl   string   // 签名成功通知DAppServer的回调URL接口
    expired     number   // 仅Web二维码模式可用，过期时间，unix时间戳
}