All pages
Powered by GitBook
1 of 31

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

v1.4.8

Release Date

Nov 17th 2025 06:30 in UTC

Note

  • npm:

  • cdn:

What's improved

  • Bitget Wallet Integration Improvement

    • In the previous version, transactions signed on the mainnet were incorrectly displayed as being on the Kairos (testnet) network.

      This issue has now been fixed, and mainnet signatures will correctly display as “Kaia.”

https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.8
https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.8.js

Release Note

Latest Version (v1.4.8)

  • npm: https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.8

  • cdn: https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.8.js

v1.4.6

Release Date

Oct 15th 2025 06:00 in UTC

Note

  • npm:

  • cdn:

What's improved

  • We added a safeguard that rejects payment requests when the connected wallet's chainId does not match the payment environment (mainnet/testnet).

    • Testnet: chainId: 1001, testMode: true

    • Mainnet: chainId: 8217, testMode: false

v1.4.5

Release Date

Sep 22nd 2025 07:00 in UTC

Note

  • npm:

  • cdn:

What's improved

  • OA Promotion Phase 2 Support

    • To further enhance user circulation within the Mini Dapp ecosystem, we are conducting the second phase of the Dapp Portal OA Popup event. This popup promotes USDT rewards and aims to encourage cross-promotion among various Mini Dapps.

    • Partners interested in joining the promotion cycle are welcome to contact @dappportal_official.

  • Resolved an issue where the screen appeared blank when scrolling during MiniDapp Connect.

v1.4.0

Release Date

July 25th 2025 08:00 in UTC

Note

  • npm:

  • cdn:

What's new

  • cryptoPaymentInfo filed of Webhook has been added when payment status is CONFIRMED

  • Method to retrieve fungible token balance has been added

  • USDT has been added as currencyCode where pgType: CRYPTO

    • Gas fee delegation is supported for USDT payment

If you have not yet completed domain verification for using the Bitget Wallet, please refer to .

We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

v1.4.2 & v1.4.3

Release Date

August 21st 2025 09:00 in UTC

Note

This version is deployed for the purpose of improving Dapp Portal's feature.

  • npm:

  • cdn:

We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

v1.3.4

Release Date

June 12th 2025 06:00 in UTC

Note

This version is deployed for the purpose of improving Dapp Portal's feature.

  • npm:

  • cdn:

We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

v1.4.4

Release Date

Sep 5th 2025 09:30 in UTC

Note

  • npm:

  • cdn:

What's improved

  • Output error logs when not using the latest version of the Mini Dapp SDK (Note: these error logs do not affect the SDK's functionality).

  • Fixed the error occurring during the reconnect process after calling disconnectWallet(). (Bitget Wallet).

We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

v1.3.8

Release Date

July 11th 2025 07:30 in UTC

Note

Fixed minor bug for Kaia Wallet(App).

  • npm:

  • cdn:

If you have not yet completed domain verification for using the Bitget Wallet, please refer to .

We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

v1.3.5

Release Date

June 16th 2025 05:30 in UTC

Note

A feature has been deployed to provide Gas Fee Delegation for the Bitget Wallet.

Additionally, a bug has been fixed where openPaymentHistory() was not functioning correctly during Bitget Wallet connected.

  • npm:

  • cdn:

If you have not yet completed domain verification for using the Bitget Wallet, please refer to .

We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

v1.2.13

Release Date

May 20th 2025 07:00 in UTC

Note

This version has been deployed to improve the Dapp Portal and internal functions.

There is no impact on Client's side.

npm:

cdn:

v1.3.0

Release Date

May 27th 2025 06:00 in UTC

Note

Mini Dapp SDK v1.3.0 provide Bitget Wallet as one of walletType.

Response from getWalletType() is WalletType.BITGET.

npm:

cdn:

  • In order to provide the Bitget Wallet through the Mini Dapp SDK, SDK upgrade is required.

  • No code changes are necessary.

  • Please follow to complete domain verification before upgrading the SDK version, and submit the ProjectId through the Tech Support channel.

v1.2.9

Release Date

March 6th 2025 05:00 in UTC

Note

NPM : https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.9

CDN :

  • Supported gas fee delegation from OKX Wallet

To apply gas fee delegation from OKX Wallet, an SDK version upgrade is mandatory.

v1.4.1

Release Date

August 19th 2025 09:00 in UTC

Note

  • npm:

  • cdn:

Added the Dapp Portal’s OA Popup event to support the user circulation loop across the Mini Dapp ecosystem. The popup promotes USDT rewards and encourages cross-promotion among Mini Dapps.

Partners interested in joining the promotion cycle are welcome to contact @dappportal_official.

v1.3.2

Release Date

May 30th 2025 07:30 in UTC

Note

To enchance the stability of the Mini Dapp SDK.

npm:

cdn:

  • It has no impact on the Mini Dapp.

  • However, we always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

v1.2.8

Mini Dapp SDK v1.2.7 has been released as an internal improvement version.

Release Date

February 27th 2025 08:30 in UTC

Note

v1.3.3

Release Date

June 10th 2025 07:20 in UTC

Note

Bugs that may occur in Mini Dapp SDK v1.3.0 and above have been fixed.

v1.2.10

Release Date

April 7th 2025 10:00 in UTC

Note

NPM :

v1.3.7

Release Date

July 10th 2025 08:00 in UTC

Note

In version 1.3.7, the Mini Dapp SDK has been updated to work properly within the in-app browser of the Kaia Wallet (App).

v1.3.6

Release Date

July 8th 2025 09:00 in UTC

Note

Fixed minor bug of openPaymentHistory() function

v1.2.11

Release Date

April 10th 2025 06:00 in UTC

Note

NPM :

v1.2.2

Release Date

January 21st 2025 15:00 in UTC

Backend

v1.2.4

Release Date

January 23rd 2025 09:30 in UTC

Note

v1.2.5

Release Date

February 4th 2025 07:30 in UTC

Note

v1.2.3

Release Date

January 22nd 2025 01:00 in UTC

Note

v1.2.1

Release Date

January 21st, 2025 06:00 in UTC

Backend

v1.2.6

Release Date

February 12th 2025 05:30 in UTC

Note

  • npm: https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.7

  • cdn: https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.7.js

  • If you have not yet completed domain verification for using the Bitget Wallet, please refer to this guide.

    We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

  • npm: https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.6

  • cdn: https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.6.js

  • If you have not yet completed domain verification for using the Bitget Wallet, please refer to this guide.

    We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

  • Any other combinations will result in a payment error.

  • When a payment error occurs, the SDK automatically detects the issue and throws an exception to the developer’s code. The following messages may appear in the log:

    • The payment is set to test mode, but DappPortalSDK is initialized with mainnet (8217).

    • The payment is set to non-test mode, but DappPortalSDK is initialized with testnet (1001).

  • https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.6
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.6.js
  • Updated all Payment API processes to run as non-cancellable jobs, ensuring more stable and reliable execution.

  • https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.5
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.5.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.3
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.3.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.4
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.4.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.4
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.4.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.8
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.8.js
    this guide
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.5
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.5.js
    this guide
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.13
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.2.13.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.0
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.0.js
    this guide
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.2.9.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.1
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.1.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.2
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.2.js
    CDN : https://static.kaiawallet.io/js/dapp-portal-sdk-1.2.11.js

    The bug has been fixed where requesting kaia_accounts() would show the wallet connection screen when there was no connected wallet, and the Client would respond with [].

    Starting from Mini Dapp SDK v1.2.11, when requesting kaia_accounts() with no connected wallet, the Client can get response with [] without showing the wallet connection screen.

    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.11
  • Fixed intermittent wallet connection failures and Mini Dapp crashes on iOS when calling LIFF Wallet.

  • To resolve this issue, please upgrade Mini Dapp SDK version to v1.2.2. No code changes are required without upgrade.

    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.2
  • Fixed error while connecting and signing from OKX Wallet.

  • Fixed error for 'Buffer is not defined'

  • https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.4
  • Changed the 408 error that occurs during long polling timeout to response as 202.

  • Enhanced it to explicitly trigger an error when requesting kaia_signLegacy with the OKX wallet.

    • (Optional) To receive the changed responses, you need to update the SDK version to v1.2.5.

  • Resumed testMode: true.

    • An SDK version upgrade is not necessary. You just can use the test environment by setting the testMode as 'true' when requesting the payment create API.

  • https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.5
  • Fixed minor bugs

  • https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.3
  • Fixed intermittent iOS Wallet Connection (LIFF) failures and Mini Dapp crashes when attempting Wallet Connect.

  • For STRIPE and CRYPTO payments in a CONFIRMED state where the payment finalize API has not been called, automatically change the status to FINALIZED within 5 minutes (improvement for normal settlement).

    • To prevent issue #1, we strongly recommend upgrading the SDK to version 1.2.1. (No additional code changes are required.)

    • Issue #2 is outside the scope of developer responsibility.

    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.1
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.2.6.js
    • Updated OKX Wallet version to v1.7.4 @okxconnect/ui sdk.

    • Added the flow to return to LINE after completing the OKX request when using LIFF browser.

    • Fixed error whlie initializing OKX Wallet

    Error in WalletProvider request TypeError: Cannot read properties of null (reading 'request') Uncaught (in promise) {code: -32603, message: 'Internal JSON-RPC error.')

    • Improved connection UI of OKX Wallet to Mini Dapp's name and icon

    To apply the above improvements, an SDK version upgrade is mandatory.

    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.6
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.0
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.0.js
    this guide
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.8

    https://static.kaiawallet.io/js/dapp-portal-sdk-1.2.8.js

    • Added kaia_connectAndSign function

    Request

    • data : data to sign

    Response

    • address : address which is signed to data

    • signature

    Error

    When user did cancel connection.

    To request kaia_connectAndSign, an SDK version upgrade is mandatory.

    [data]
    npm: https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.3

    cdn: https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.3.js

    [No issue] When there is sufficient interval between initializing SDK and calling methods

    [Issue] Methods are not executed properly. (It occurs when called immediately after initializing SDK)

    If you are experiencing the above issue, please update Mini Dapp SDK version to v1.3.3.

    We always recommend using the latest version of the Mini Dapp SDK to ensure security and compatibility.

    // index.tsx
    globalSdk = await DappPortalSDK.init()
    
    // login.tsx
    const provider = global.getWalletProvider();
    const accounts = provider.request({method: 'kaia_requestAccounts'})
    const sdk = await DappPortalSdk.init();
    const provider = sdk.getWalletProvider();
    const accounts = provider.request({method: 'kaia_requestAccounts'})
    {
        "paymentId": "",
        "status": "CONFIRMED",
        "cryptoPaymentInfo": { // added when status: CONFIRMED
            "paymentTxHash": "0x.."
        }
    }  
    walletProvider.getErc20TokenBalance(contractAddress, walletAddress)
    [address, signature]
    REQUEST_REJECTED: -32002
    CDN : https://static.kaiawallet.io/js/dapp-portal-sdk-1.2.10.js
    • UX has been improved for Wallet Connect

    We have improved the user experience for Wallet Connect. By providing options for connecting Wallet Connect on a single screen, we have reduced the number of steps and also offer information about the recently used methods.

    Dapp Portal

    No code changes are needed to use this feature, but upgrading the Mini Dapp SDK is essential.

    Upgrade the Mini Dapp SDK and provide the improved experience.

    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.10

    v1.2.12

    Release Date

    April 23rd 2025 07:30 in UTC

    Note

    We strongly recommend upgrading to this version of the Mini Dapp SDK.

    npm:

    cdn:

    Point#1

    Fixed issue where the Mini Dapp SDK failed to detect account changes in the OKX Wallet

    [Before v1.2.12]

    When the user changes the account in the Extension while the OKX Wallet is connected,

    • SDK returns former account when request kaia_accounts() or kaia_requestAccounts()

    • User cannot sign because the connected wallet is different from the wallet address in the signature data

    [After v1.2.12]

    When the user changes the account in the Extension while the OKX Wallet is connected,

    • SDK returns latter account when request kaia_accounts() or kaia_requestAccounts()

    • User can sign

    Point#2 [Action Requried]

    Fixed issue whre OKX Wallet is not properly disconnected when requested walletProvider.disconnectWallet()

    [Before v1.2.12]

    Since there is no way to await for walletProvider.disconnectWallet() to complete, refreshing immediately after requesting disconnectWallet() results in the OKX Wallet connection not being properly disconnected.

    [After v1.2.12]

    Changed walletProvider.disconnectWallet() as async function

    Point#3 [Action Requried]

    Fixed error when requested walletProvider.disconnectWallet()

    [ASIS]

    After requesting walletProvider.disconnectWallet(), the page must be refreshed or the walletProvider needs to be reassigned to a variable in order to be able to select the wallet type again.

    [TOBE]

    After requesting walletProvider.disconnectWallet(), without any additional implementation, it is possible to select the wallet type again when making a subsequent walletProvider.request({method: "kaia_requestAccounts"}) request.

    v1.3.1

    Release Date

    May 27th 2025 06:00 in UTC

    Note

    Minor improvement for Bitget Wallet has been released

    npm:

    cdn:

    • If client has registered ProejctId with SDK, Bitget Wallet is supported

    • Else, Bitget Wallet is not supported. (Exceptionally, if the Bitget Wallet Extension is installed in the PC environment, Bitget is provided; however, if domain verification and ProjectId registration are not completed, an error will occur.)

    v1.2.0

    Green > Mandatory to be applied to Mini Dapp's code

    Blue > Optional to be applied Mini Dapp's code if Mini Dapp need to new function.

    Release Date

    January 20th, 2025

    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.3.1
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.3.1.js
    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.2.12
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.2.12.js
    // ASIS
    walletProvider.disconnectWallet();
    window.location.reload(); // <- Failed to disconnect OKX Wallet
    
    // TOBE
    await walletProvider.disconnectWallet();
    window.location.reload(); // <- Success to disconnect OKX Wallet
    Back End
    • Wallet

      • Improved response so that clients can clearly aware for the cancellation and closing options of the popup.

        • Docs >

    • Payment

      • Added payment status change webhook.

      • Improved parameters of createPayment

        • Disallow whitespace charaters in lockUrl and unlockUrl

    Web

    • Wallet

      • Improved response so that clients can clearly aware for the cancellation and closing options of the popup.

      • Fixed UI bug if Mini Dapp name includes character of '

    Mini Dapp SDK

    • Wallet

      • Improved response so that clients can clearly aware for the cancellation and closing options of the popup.

      • Fixed UI bug if Mini Dapp name includes character of '

      • Fixed z-index onto popup to proceed sign if bocked

        • This z-index set as '9999999'. Please set your z-index for any popup under '9999999' to avoid conflicting between popup's.

      • Improved for connecting Mobile App Wallet

      • Improved response time for some iOS.

    • Payment

      • Added OKX wallet option

      • Improved error codes so that the Mini Dapp can clearly aware the payment cancellation/failure.

    Mobile, Extension

    • Wallet

      • personal_sign() is supported.

    v1.4.7

    Release Date

    Nov 6th 2025 07:00 in UTC

    Note

    • npm:

    • cdn:

    What's improved

    • OA Promotion Phase 3 Support

    OA Promotion Phase 3 Guide

    Please refer to the following guide and proceed with the additional development and information submission.

    Additional Development

    • Event Provider Callback (DappPortalSDK.getEventProvider())

    • Dapp Server REST API Implementation

    Required Information Submission

    • API URL (required)

    • Custom Header (optional)

    DappPortalSDK.getEventProvider()

    Event Provider Callback for Mini Dapp Mission Completion

    • The purpose of this callback method is to verify mission completion on Dapp Portal side and automatically display a success banner when verification is successful.

    Parameters

    Parameter
    Type
    Description

    Responses

    N/A

    • If verification is successful, a banner will be displayed.

    Dapp Server REST API Implementation Guide

    To enable mission completion on the Dapp Portal charts, the Dapp server must provide an API endpoint that allows the Dapp Portal to verify whether a mission has been completed.

    • Information Required

      • API URL (required)

      • Custom Header (optional)

    • API Overview

  • You need to include lockUrl, unlockUrl as null even if you have no data to this field

  • Added validation check for Urls

  • Added paymentStatusChangeCallbackUrl

    • confirmCallbackUrl can be used up to version 1.2.0.

  • only 'false' can be used for testMode

  • Fixed price bug for payment history page

  • Docs >

    Method: GET

  • Scheme: https

  • Read Timeout: 1s

    • If the Dapp Portal server does not receive a response within 1 second, the mission will be treated as failed.

  • Custom Header (optional)

    • You may include a custom header when the API is called.

    • There are no restrictions on header key/value format.

    • Only one custom header can be used, and it is optional.

    • ex) x-dapp-custom-key: gq8g0Ah1MD98

  • URL Format

    • Base URL: Dapp server URL

    • The $identifier as query parameter must be included.

    • $identifier is a placeholder that will be replaced by the user’s wallet address (in lowercase) by the Dapp Portal server.

    • ex) https://example.dapp.io/api/mission/1111?param=zzzz&identifier=$identifier

  • Response Body

    • Content Type: JSON

    • If the Dapp Portal server receives a successful response, the user is considered to have completed the mission.

      • Mission Complete

      • Mission Fail

  • eventId

    string

    The unique identifier provided by Dapp Portal

    subMissionIndex

    string

    The index of the sub-mission. Indexing starts from 0. For example: - Event item purchase Misson -> use subMissionIndex = "0" - Lv4 achievement Misson -> use subMissionIndex = "1"

    https://www.npmjs.com/package/@linenext/dapp-portal-sdk/v/1.4.7
    https://static.kaiawallet.io/js/dapp-portal-sdk-1.4.7.js
    const eventProvider = DappPortalSDK.getEventProvider();
    
    // When the mission is completed
    const eventId: string = "eventId";          // Unique event ID provided by Dapp Portal
    const subMissionIndex: string = "1";        // Sub-mission index, starting from 0
    
    await eventProvider.callback(eventId, subMissionIndex); // If verification is successful, a banner will be displayed automatically.
    HTTP/1.1 200 OK
    {
      "result": true
    }
    HTTP/1.1 200 OK
    {
      "result": false
    }