Connect（连接）

在应用与 Backpack 交互之前，必须先建立连接。

该连接请求会提示用户分享其公钥，以表示同意继续。

一旦用户连接成功，Backpack 会返回一个 session 参数，后续所有方法都应使用此参数。

关于 session 的更多信息，请参阅Handling Sessions。

基础 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 了解所有可能的错误代码。