Connect(连接)
在应用与 Backpack 交互之前,必须先建立连接。
该连接请求会提示用户分享其公钥,以表示同意继续。
一旦用户连接成功,Backpack 会返回一个 session
参数,后续所有方法都应使用此参数。
基础 URL
https://backpack.app/ul/v1/connect
查询字符串参数(Query String Parameters)
app_url
(必填):用于提供应用元数据(例如标题、图标)的 URL,必须进行 URL 编码。dapp_encryption_public_key
(必填):用于端到端加密的公钥,用于生成共享密钥。有关 Backpack 如何管理共享密钥的详情,请参考Encryption部分。redirect_link
(必填):连接成功后 Backpack 应将用户重定向到的 URI。详情请参阅Specifying Redirects。必须进行 URL 编码。cluster
(可选):指定后续交互所使用的网络。若连接至 Solana 主网,请留空或设置为mainnet-beta
。若连接至 Eclipse,请设置为:solana:EAQLJCV2mh23BsK2P9oYpV5CHVLDNHTxY
返回值
Approve(同意)
wallet_xxx
:Backpack 使用的 base58 编码加密公钥,用于与连接应用构建共享密钥。nonce
:base58 编码的随机数,用于加密响应。data
:已加密的 JSON 字符串。应用可通过共享密钥解密数据,详情见Encryption。加密后的字节使用 base58 编码。
// 解密后的 `data` 参数内容
{
// 用户公钥的 base58 编码
"public_key": "3huUrtWW5s5ew98eUFRYz9LPsDUQTujNzzYaB9DBkppQ",
// 用于后续签名与消息处理的 session token
// 应用在之后的所有 deeplinks 中都应携带该 token
"session": "..."
}
public_key
:用户的公钥,以 base58 编码的字符串形式表示。session
:以 base58 编码的字符串形式表示。连接应用应该将其视为不透明的,仅需与其他参数一起传递即可。会话不会过期。有关会话的更多信息,请参阅 Handling Sessions。
Reject(拒绝)
需要传递errorCode
(错误代码) 和errorMessage
(错误信息) 作为查询参数。
请参阅 Errors 了解所有可能的错误代码。
Last updated