Kết Nối

Trước khi một ứng dụng có thể tương tác với Backpack, ứng dụng đó cần phải thiết lập kết nối trước. Yêu cầu kết nối này sẽ yêu cầu người dùng xác nhận chia sẻ public key, thể hiện sự đồng ý tiếp tục sử dụng dịch vụ.

Khi người dùng kết nối thành công, Backpack sẽ cung cấp một tham số session (phiên kết nối). Tham số này phải được sử dụng cho tất cả các phương thức tiếp theo.

Vui lòng tham khảo thêm phần Handling Sessions để biết thêm chi tiết.

URL cơ sở

https://backpack.app/ul/v1/connect

Tham số Chuỗi Truy vấn

• app_url (bắt buộc): URL cung cấp metadata của ứng dụng (ví dụ: tiêu đề, icon). URL này phải được mã hóa (URL-encoded).

• dapp_encryption_public_key (bắt buộc): Public key dùng cho mã hóa đầu cuối (end-to-end encryption), nhằm tạo ra shared secret (khóa dùng chung). Xem thêm chi tiết trong phần Encryption để hiểu cách Backpack quản lý shared secret.

• redirect_link (bắt buộc): Địa chỉ URI để Backpack chuyển hướng người dùng sau khi kết nối thành công. Tham khảo thêm phần Specifying Redirects để biết chi tiết. Phải được mã hóa URL.

• cluster (tùy chọn): Chỉ định mạng lưới cho các tương tác sau khi kết nối. Để kết nối Solana mainnet, không cần điền hoặc điền là mainnet-beta. Để kết nối Eclipse, điền tham số:solana:EAQLJCV2mh23BsK2P9oYpV5CHVLDNHTxY.

Kết Quả Trả Về

Chấp Nhận

• wallet_xxx: Một public key mã hóa theo chuẩn Base58 được Backpack sử dụng để tạo khóa bảo mật chung (shared secret) giữa ứng dụng đang kết nối và Backpack.

• nonce: Một nonce được mã hóa theo chuẩn Base58, dùng để mã hóa phản hồi trả về..

• data: Chuỗi JSON đã được mã hóa. Tìm hiểu cách các ứng dụng có thể giải mã dữ liệu bằng cách sử dụng một shared secret trong Encryption. Base58 được sử dụng để mã hóa các byte đã được mã hóa.

  // content of decrypted `data`-parameter
  {
    // base58 encoding of user public key
    "public_key": "3huUrtWW5s5ew98eUFRYz9LPsDUQTujNzzYaB9DBkppQ",
  
    // session token for subsequent signatures and messages
    // apps should send this with any other deeplinks after connect
    "session": "..."
  }

  • public_key: Khóa công khai của người dùng, được biểu diễn dưới dạng chuỗi được mã hóa base58.

  • session: Một chuỗi được mã hóa bằng base58. Ứng dụng kết nối nên coi chuỗi này là opaque, vì nó chỉ cần được truyền cùng với các tham số khác. Các phiên không hết hạn. Để biết thêm thông tin về các phiên, vui lòng tham khảo Handling Sessions.

Từ chối

Một errorCode và errorMessage dưới dạng các tham số truy vấn.

Vui lòng tham khảo Errors để xem danh sách đầy đủ các mã lỗi có thể xảy ra.