APItoshi is presented as a solution to the frictional problem when developing a lightning application. Currently, there are not many options for the end-user to implement advanced tailored lightning solutions. Users create a lightning application by connecting their node to their app. However, this results in a great effort task since users have to do node balance and channel management, liquidity operations or routing mechanisms to optimize their payments success.

Alternatively, APItoshi´s motivation comes as a challenge to overcome the most complex operations such as integrating smart contracts in lightning to create an interoperability layer from lightning to other chain services to perform smart contract requests.


SegWit & HD

SegWit supported with P2SH-compatibility mode and Bech32 Native mode. Segwit was a massive upgrade to the Bitcoin Protocol released in 2017. You will find all wallets with SegWit enabled by default. Bech32 is a new bitcoin address format specified by BIP 0173.

The amount of bech32 addresses on the blockchain is tracked on this website:

The Hierarchical Deterministic (HD) key creation and transfer protocol (BIP32) is also implemented, which allows creating child keys from parent keys in a hierarchy. The HD Wallets will generate different public keys for each transaction.


APItoshi provides an information management tool that visually tracks, analyzes and displays APItoshis data. It includes a user-friendly interface for key management services to integrate APItoshi modules into your app(s), track statistics about the operations, monitoring the account balance, as well as the smart bound capacities.

Full encryption

Data is encrypted using the AES 256-bit algorithm and an encryption key given to) the user. APItoshi uses the 256-bit to do symmetric encryption(s) and integrity checks, and RSA is not used any further for that connection. AES or Advanced Encryption Standard is commonly used as a bulk cypher with SSL/TLS. Bulk cyphers are the symmetric cryptosystems that actually handle the security of the communication happening during an encrypted HTTPS connection.

No Custodial

APItoshi is a modular product that allows users running the no(n)-custodial module to self-govern their keys. This is a more advanced feature for experimental users that already have experience with lightning node management. When using LND (Lightning Network Daemon), the user can run the experimental non-custodial module by giving APItoshi access to the invoice macaroon or the read-only macaroon together with the grpc endpoint and TLS certificate. With these files, APItoshi can establish a non-custodial connection to your lightning node and perform a lightning operation to either ask for payment requests or read invoices. However, APItoshi has no access to manage your funds or perform withdrawal operations from your node.


SDKs Different system development kits bring to APItoshi from game development frameworks to e-commerce platforms seamlessly using a simple key. APItoshi SDK provides an array of tools in a unique and standardized interface to enable end-users to implement modules into different e-commerce platforms and gaming development frameworks such as:

  • WooCommerce (experimental private beta)
  • Prestashop (wok-in-progress)
  • Opencart (wok-in-progress)
  • Unity (experimental private beta)
  • Unreal Engine (wok-in-progress)
  • Godot Engine (wok-in-progress)

What it does

APItoshi is a lightning-stack development framework that allows users to implement lightning technical operations into their lightning app. As part of a modular architecture, there are modules installed on top of APItoshi.


Key Manager

Users can interact with different modules through the means of API keys. These keys have different privileges that provide users with security and access.


code2flow_aqPJSL APItoshi comes with a module that brings a lightning OAuth-based system built with digital signatures and bitcoin public keys. This login system allows the user to avoid using sensitive personal data, e.g. email addresses, during the authentication process and it takes just a few seconds.


A bitcoin payment processor built on top of APItoshi that brings a Point of Sale application ready to integrate on e-commerce platforms. The payment module takes advantage of bitcoin’s newest payment protocol to bring instant transactions and extremely low fees.

Smart Bounds

smart bound

APItoshi Smart Bound brings an inter-operability to connect it with other chain services using Bitcoin as the native fuel for APItoshis modules. Therefore, the user can implement smart contracts on the Lightning Network in a matter of minutes. This brings payment automatizations that only occur under certain conditions, stream payments on predetermined time intervals that trigger other events once a payment is received. Such as bringing NFTs to lightning or automate chain processes through lightning triggers.


I built APItoshi in one month using the following tech stack: apitoshi-stack

What's next for APItoshi

  • I am developing different modules to make APItoshi richer technologically to add support to different lightning operations such as automatic channel rebalance for non-custodial endpoints that use APItoshi or Plausible deniability. It will allow users to define a different password which will decrypt a fake wallet set up. For any situation you are forced to disclose your access or when you do not want to or you cannot show your real apitoshi key.

Built With

Share this project: