react-native-nitro-ark/lib/module/index.js

Pure C++ Nitro Modules for Ark client

"use strict";

import { NitroModules } from 'react-native-nitro-modules';
// Create the hybrid object instance
export const NitroArkHybridObject = NitroModules.createHybridObject('NitroArk');

// --- Management ---

/**
 * Creates a new BIP39 mnemonic phrase.
 * @returns A promise resolving to the mnemonic string.
 */
export function createMnemonic() {
  return NitroArkHybridObject.createMnemonic();
}

/**
 * Creates a new wallet at the specified directory.
 * @param datadir Path to the data directory.
 * @param opts The options for wallet creation.
 * @returns A promise that resolves on success or rejects on error.
 */
export function createWallet(datadir, opts) {
  return NitroArkHybridObject.createWallet(datadir, opts);
}

/**
 * Loads an existing wallet or creates a new one at the specified directory.
 * Once loaded, the wallet state is managed internally.
 * @param datadir Path to the data directory.
 * @param mnemonic The BIP39 mnemonic phrase for the wallet.
 * @returns A promise that resolves on success or rejects on error.
 */
export function loadWallet(datadir, mnemonic) {
  return NitroArkHybridObject.loadWallet(datadir, mnemonic);
}

/**
 * Closes the currently loaded wallet, clearing its state from memory.
 * @returns A promise that resolves on success or rejects on error.
 */
export function closeWallet() {
  return NitroArkHybridObject.closeWallet();
}

/**
 * Checks if a wallet is currently loaded.
 * @returns A promise resolving to true if a wallet is loaded, false otherwise.
 */
export function isWalletLoaded() {
  return NitroArkHybridObject.isWalletLoaded();
}

/**
 * Persists wallet configuration.
 * @param opts The configuration options to persist.
 * @returns A promise that resolves on success or rejects on error.
 */
export function persistConfig(opts) {
  return NitroArkHybridObject.persistConfig(opts);
}

/**
 * Runs wallet maintenance tasks.
 * @returns A promise that resolves on success.
 */
export function maintenance() {
  return NitroArkHybridObject.maintenance();
}

/**
 * Synchronizes the wallet with the blockchain.
 * @returns A promise that resolves on success.
 */
export function sync() {
  return NitroArkHybridObject.sync();
}

/**
 * Synchronizes the Ark-specific exits.
 * @returns A promise that resolves on success.
 */
export function syncExits() {
  return NitroArkHybridObject.syncExits();
}

/**
 * Synchronizes the rounds of the wallet.
 * @returns A promise that resolves on success.
 */
export function syncRounds() {
  return NitroArkHybridObject.syncRounds();
}

// --- Wallet Info ---

/**
 * Gets the Ark-specific information.
 * @returns A promise resolving to the BarkArkInfo object.
 */
export function getArkInfo() {
  return NitroArkHybridObject.getArkInfo();
}

/**
 * Gets the offchain balance for the loaded wallet.
 * @returns A promise resolving to the OffchainBalanceResult object.
 */
export function offchainBalance() {
  return NitroArkHybridObject.offchainBalance();
}

/**
 * Derives the next keypair for the store.
 * @returns A promise resolving to the KeyPairResult object.
 */
export function deriveStoreNextKeypair() {
  return NitroArkHybridObject.deriveStoreNextKeypair();
}

/**
 * Gets the wallet's VTXO public key (hex string).
 * @param index Index of the VTXO pubkey to retrieve.
 * @returns A promise resolving to the KeyPairResult object.
 */
export function peakKeyPair(index) {
  return NitroArkHybridObject.peakKeyPair(index);
}

/**
 * Gets the wallet's Address.
 * @returns A promise resolving to NewAddressResult object.
 */
export function newAddress() {
  return NitroArkHybridObject.newAddress();
}

/**
 * Signs a message with the private key at the specified index.
 * @param message The message to sign.
 * @param index The index of the keypair to use for signing.
 * @returns A promise resolving to the signature string.
 */
export function signMessage(message, index) {
  return NitroArkHybridObject.signMessage(message, index);
}

/**
 * Verifies a signed message.
 * @param message The original message.
 * @param signature The signature to verify.
 * @param publicKey The public key corresponding to the private key used for signing.
 * @returns A promise resolving to true if the signature is valid, false otherwise.
 */
export function verifyMessage(message, signature, publicKey) {
  return NitroArkHybridObject.verifyMessage(message, signature, publicKey);
}

/**
 * Gets the list of VTXOs as a JSON string for the loaded wallet.
 * @param no_sync If true, skips synchronization with the blockchain. Defaults to false.
 * @returns A promise resolving BarkVtxo[] array.
 */
export function getVtxos() {
  return NitroArkHybridObject.getVtxos();
}

// --- Onchain Operations ---

/**
 * Gets the onchain balance for the loaded wallet.
 * @returns A promise resolving to the OnchainBalanceResult object.
 */
export function onchainBalance() {
  return NitroArkHybridObject.onchainBalance();
}

/**
 * Synchronizes the onchain state of the wallet.
 * @returns A promise that resolves on success.
 */
export function onchainSync() {
  return NitroArkHybridObject.onchainSync();
}

/**
 * Gets the list of unspent onchain outputs as a JSON string for the loaded wallet.
 * @returns A promise resolving to the JSON string of unspent outputs.
 */
export function onchainListUnspent() {
  return NitroArkHybridObject.onchainListUnspent();
}

/**
 * Gets the list of onchain UTXOs as a JSON string for the loaded wallet.
 * @returns A promise resolving to the JSON string of UTXOs.
 */
export function onchainUtxos() {
  return NitroArkHybridObject.onchainUtxos();
}

/**
 * Gets a fresh onchain address for the loaded wallet.
 * @returns A promise resolving to the Bitcoin address string.
 */
export function onchainAddress() {
  return NitroArkHybridObject.onchainAddress();
}

/**
 * Sends funds using the onchain wallet.
 * @param destination The destination Bitcoin address.
 * @param amountSat The amount to send in satoshis.
 * @returns A promise resolving to the OnchainPaymentResult object
 */
export function onchainSend(destination, amountSat) {
  return NitroArkHybridObject.onchainSend(destination, amountSat);
}

/**
 * Sends all funds from the onchain wallet to a destination address.
 * @param destination The destination Bitcoin address.
 * @returns A promise resolving to the transaction ID string.
 */
export function onchainDrain(destination) {
  return NitroArkHybridObject.onchainDrain(destination);
}

/**
 * Sends funds to multiple recipients using the onchain wallet.
 * @param outputs An array of objects containing destination address and amountSat.
 * @returns A promise resolving to the transaction ID string.
 */
export function onchainSendMany(outputs) {
  return NitroArkHybridObject.onchainSendMany(outputs);
}

// --- Lightning Operations ---

/**
 * Creates a Bolt 11 invoice.
 * @param amountMsat The amount in millisatoshis for the invoice.
 * @returns A promise resolving to the Bolt 11 invoice string.
 */
export function bolt11Invoice(amountMsat) {
  return NitroArkHybridObject.bolt11Invoice(amountMsat);
}

/**
 * Claims a Lightning payment.
 * @param bolt11 The Lightning invoice string to claim.
 * @returns A promise that resolves on success or rejects on error.
 */
export function finishLightningReceive(bolt11) {
  return NitroArkHybridObject.finishLightningReceive(bolt11);
}

/**
 * Sends a Lightning payment.
 * @param destination The Lightning invoice.
 * @param amountSat The amount in satoshis to send. Use 0 for invoice amount.
 * @returns A promise resolving to a LightningPaymentResult object
 */
export function sendLightningPayment(destination, amountSat) {
  return NitroArkHybridObject.sendLightningPayment(destination, amountSat);
}

/**
 * Sends a payment to a Lightning Address.
 * @param addr The Lightning Address.
 * @param amountSat The amount in satoshis to send.
 * @param comment An optional comment.
 * @returns A promise resolving to a LnurlPaymentResult object
 */
export function sendLnaddr(addr, amountSat, comment) {
  return NitroArkHybridObject.sendLnaddr(addr, amountSat, comment);
}

// --- Ark Operations ---

/**
 * Boards a specific amount from the onchain wallet into Ark.
 * @param amountSat The amount in satoshis to board.
 * @returns A promise resolving to a JSON status string.
 */
export function boardAmount(amountSat) {
  return NitroArkHybridObject.boardAmount(amountSat);
}

/**
 * Boards all available funds from the onchain wallet into Ark.
 * @returns A promise resolving to a JSON status string.
 */
export function boardAll() {
  return NitroArkHybridObject.boardAll();
}

/**
 * Sends an Arkoor payment.
 * @param destination The destination Arkoor address.
 * @param amountSat The amount in satoshis to send.
 * @returns A promise resolving to the ArkoorPaymentResult object
 */
export function sendArkoorPayment(destination, amountSat) {
  return NitroArkHybridObject.sendArkoorPayment(destination, amountSat);
}

/**
 * Sends an onchain payment via an Ark round.
 * @param destination The destination Bitcoin address.
 * @param amountSat The amount in satoshis to send.
 * @returns A promise resolving to a JSON status string.
 */
export function sendRoundOnchainPayment(destination, amountSat) {
  return NitroArkHybridObject.sendRoundOnchainPayment(destination, amountSat);
}

// --- Offboarding / Exiting ---

/**
 * Offboards specific VTXOs to a destination address.
 * @param vtxoIds Array of VtxoId strings to offboard.
 * @param destinationAddress Destination Bitcoin address (if empty, sends to internal wallet).
 * @param no_sync If true, skips synchronization with the wallet. Defaults to false.
 * @returns A promise resolving to a JSON result string.
 */
export function offboardSpecific(vtxoIds, destinationAddress) {
  return NitroArkHybridObject.offboardSpecific(vtxoIds, destinationAddress);
}

/**
 * Offboards all VTXOs to a destination address.
 * @param destinationAddress Destination Bitcoin address (if empty, sends to internal wallet).
 * @param no_sync If true, skips synchronization with the wallet. Defaults to false.
 * @returns A promise resolving to a JSON result string.
 */
export function offboardAll(destinationAddress) {
  return NitroArkHybridObject.offboardAll(destinationAddress);
}

// --- Re-export types and enums ---
//# sourceMappingURL=index.js.map