Bitvora SDK

A Python SDK for the Bitvora API and Webhooks.

Installation

pip install bitvora

Usage

Sending Bitcoin (withdrawal)

from bitvora import BitvoraClient, Withdrawal

client = BitvoraClient(api_key="<API_KEY>", network="signet") # Use 'mainnet', 'testnet', or 'signet'

async def send_bitcoin():
    withdrawal_response = await client.withdraw(
        "[email protected]",  # accepts on-chain, lightning invoice (payment request), lightning address, lnurl
        10.0,                 # amount in your desired currency
        'USD'                 # currency code
    )

    withdrawal = Withdrawal(client, withdrawal_response)

    # Wait until the payment succeeds or fails (optional)
    await withdrawal.is_settled()

    return withdrawal

Creating a Lightning Address

from bitvora import BitvoraClient

client = BitvoraClient(api_key="<API_KEY>", network="signet") # Use 'mainnet', 'testnet', or 'signet'

async def create_lightning_address():
    metadata = {
        'userID': 'your-internal-user-id',
        'email': '[email protected]'
    }  # Optional metadata object to attach

    return await client.create_lightning_address(metadata)  

Create a Lightning Invoice

from bitvora import BitvoraClient, Currency

client = BitvoraClient(api_key="<API_KEY>", network="signet") # Use 'mainnet', 'testnet', or 'signet'

async def create_lightning_invoice():
    metadata = {
        'userID': 'your-internal-user-id',
        'email': '[email protected]'
    }  # Optional metadata object to attach

    invoice = await client.create_lightning_invoice(
        amount=50,  # Amount to charge
        currency=Currency.SATS,  # Currency type (assuming SATS is defined in your types module)
        description='this is from the sdk',
        expiry=3600,  # Expiry time in seconds
        metadata=metadata  # Pass the metadata dictionary
    )

    await invoice.is_settled()  # Wait until the invoice is settled (payment succeeded or failed)

    return invoice

Get Balance

from bitvora import BitvoraClient

client = BitvoraClient(api_key="<API_KEY>", network="signet") # Use 'mainnet', 'testnet', or 'signet'

async def get_balance() -> float:
    balance = await client.get_balance() 
    return balance

Get Transactions

from bitvora import BitvoraClient

client = BitvoraClient(api_key="<API_KEY>", network="signet") # Use 'mainnet', 'testnet', or 'signet'

async def get_transactions() -> dict:
    transactions = await client.get_transactions() 
    return transactions

Get Deposit

from bitvora import BitvoraClient

client = BitvoraClient(api_key="<API_KEY>", network="signet") # Use 'mainnet', 'testnet', or 'signet'

async def get_deposit(deposit_uuid: str) -> dict:
    deposit = await client.get_deposit(deposit_uuid) 
    return deposit

Get Withdrawal

from bitvora import BitvoraClient

client = BitvoraClient(api_key="<API_KEY>", network="signet") # Use 'mainnet', 'testnet', or 'signet'

async def get_withdrawal(withdrawal_uuid: str) -> dict:
    withdrawal = await client.get_withdrawal(withdrawal_uuid) 
    return withdrawal