boltpay_wallet 0.0.1

Boltpay Wallet SDK for Sui Network

Boltpay Wallet SDK for Sui Network

What is BlockBolt Protocol

BlockBolt is a decentralized payment protocol on the multichain. It offers seamless, secure, and efficient transactions for businesses and consumers, encouraging cryptocurrency adoption. BlockBolt provides an open-source SDK, plug-and-play services, and resources for developers to create or integrate payment solutions.

The Boltpay SDK for the Sui wallet app is an advantageous feature that can be seamlessly incorporated. It enables users to conveniently and safely make payments on the Sui chain. With its QR code scanning and payment request interpretation features, users can conveniently confirm their payments directly within their Sui wallet app. The Boltpay SDK manages the transaction on the Sui chain, ensuring that the payment is safely delivered to the merchant's wallet.

Please take a look at the sequence diagram that explains the process of the Boltpay SDK.

The process involves the following steps:

• The user installs the Boltpay SDK using npm.
• The Boltpay SDK confirms that it has been installed.
• The user establishes a connection to the Sui network using the Boltpay SDK.
• The Boltpay SDK connects to the Sui network.
• The Sui network confirms that the connection has been established.
• The Boltpay SDK informs the user that the connection has been established.
• The user creates a transaction using the SDK.
• The user sent a transaction request to the Sui network using the Boltpay SDK.
• The Boltpay SDK receives a transaction response from the Sui network.
• The Boltpay SDK confirms that the transaction has been created.

Boltpay SDK Documentation

As a developer, you can make use of the Boltpay SDK for wallet, a powerful tool that allows seamless integration with the BlockBolt Payment Protocol. In this guide, you will be taken through the steps of setting up and utilizing the Boltpay SDK for transaction creation on the Sui blockchain.

Prerequisites

Before starting, make sure that you have a signer set up on your Sui Wallet mobile application.

To ensure successful transaction execution, it is essential to have a signer. This component is linked to your wallet and possesses the necessary credentials to authorize transactions. By using your own wallet's signer during the execution process, you affirm and authorize transactions, leading to successful completion. It is crucial to keep your signer secure to maintain your wallet's security.

Installation

dependencies:
    boltpay_wallet: ^0.0.1

Establishing a Connection

To get started, the first step is to connect to the Sui network using the BlockBolt Payment Protocol. The Boltpay SDK offers three pre-set connections to choose from: testnet, devnet, and mainnet.

To obtain the essential details from a QR code, all you need to do is scan it with your Sui wallet. This will furnish you with the necessary values to initiate the transaction creation process.

BoltPay boltPay = BoltPay
  (123,
   merchant_name,
   merchant_wallet_address,
   '1', 
   SUI_TYPE_ARG, 
   ENV.testnet, 
   suiClient, 
   suiAccount);

Creating a Transaction

To initiate a transaction, simply use the values obtained from the QR code and pass your wallet signer to the createTransaction field. This action will create the transaction for you.

Here's an example of how you can do this:

BoltPayResponse boltPayResponse = await boltPay.executeTransaction();

IDO Transaction

BoltPayResponse boltPayResponse = await boltPay.executeCreateTXTransaction();

WooCommerce Transaction

BoltPayResponse boltPayResponse = await boltPay.executeWooCommerceTransaction();

Errors & Responses

• PHASE 201 = Transaction Success
• PHASE 202 = Transaction Fail
• PHASE 203 = InsufficientCoinBalance in your wallet
• PHASE 204 = The shared merchant address is not correct
• PHASE 205 = No response or transaction data received

Disclaimer: Please note that the BlockBolt protocol relies solely on blockchain verification for payment confirmation and process.

Do you encounter any issues or require assistance? Kindly send us an email at [e-mail] or submit a support ticket on our Discord server. We are ready to help you out.