This guide helps users understand how to build Bitcoin Lightning Network applications using the OneKey Lightning Network Provider API.

Building Web Apps Use Cases

  • Accepting Lightning Network payments

  • decentralized identity applications


1. Download OneKey Wallet

Download the OneKey Wallet. Install the OneKey browser extension.

2. API Injection Explanation

  • The OneKey browser extension injects Provider API into visited websites.

  • Two types of APIs are provided: window.webln and window.$onekey.webln.

  • It is recommended to use window.$onekey.webln.

Both APIs have the same functionality, just different names.

Detecting Provider API support

Before you start using WebLN you need to check for browser support by checking if the variable window.webln is defined:

const provider = (window.$onekey && window.$onekey.webln) || window.webln;

if (!provider) {
  alert("No Provider available.");

Connecting to OneKey

Before using the following API, you first need to use the provider.enable method to request the user to access the relevant account.

const provider = (window.$onekey && window.$onekey.webln) || window.webln;


Other APIs can be called only after user authorization.


Clarify Needs: Identify required functionalities, call relevant interfaces

More Interfaces: View Details


  • Key Operations: Such as account switching

  • More Information: View More

Last updated