Data Sharing

Retrieve the wallet user’s details securely.

Data Sharing Parameters for Mini Apps in Speed Wallet

When a wallet user opens a mini app within the Speed Wallet, the platform automatically appends essential parameters to the app’s URL. These parameters provide valuable context about the user and their account, enabling seamless integration and personalized app experiences.

Below are the parameters that are currently passed in the app’s URL:

1. acct (account id):

   The unique Speed Wallet account ID of the user accessing your mini app. This parameter helps identify the user and manage account-specific interactions within your app.

2. lang ( language ):

   Specifies the language preference of the user within the Speed Wallet application. This enables your app to display content in the user’s preferred language, enhancing the user experience. Example values: en, es, de, hi, etc.

3. bal_btc (account bitcoin balance) :

   Displays the available Bitcoin (BTC) balance in the user’s Speed Wallet account. The balance is provided in Satoshis (SATs), the smallest unit of Bitcoin (1 BTC = 100,000,000 SATs). This parameter is useful for apps involving payments, investments, or transactions in Bitcoin.

4. bal_usdt ( account USDT balance ) :

   Indicates the available USDT (Tether) balance in the user’s Speed Wallet account. The balance is provided in standard USDT units, supporting apps that facilitate stablecoin transactions, trading, or purchases.

5. p_add (account lightning address) :

   Provides the user’s Lightning Network (LN) address associated with their Speed Wallet account. This address is essential for facilitating fast and low-cost transactions over the Lightning Network, particularly for apps offering microtransactions or instant payments.

Example URL with parameters

https://subdomain.yourdomain.com?acct=acct_li8hh2xyRuSBWnE4&lang=en&bal_btc=87636&bal_usdt=1975.29&p_add=abc%40speed.app

In this example:

• Mini App URL: https://subdomain.yourdomain.com

• Account ID: acct_li8hh2xyRuSBWnE4

• Language: en (English)

• Bitcoin Balance: 87,636 SATs

• USDT Balance: 1,975.29 USDT

• Lightning Address: [e-mail]

While creating the mini app, when you click on "Open App" as a developer, Speed sends your account details, including your Speed wallet account ID, balances, and Lightning address as explained above.

However, once your app is listed and used by other Speed wallet users, Speed will send their specific account details in real time which you can use in your mini app.

Security Considerations

The above parameters are securely included in the app’s URL without using encryption. App developers should handle these parameters with care, ensuring they are not exposed or logged in a way that compromises user security or privacy.