ZBD Logo

Rust Crate for ZBD API

use std::env; use zebedee_rust::{ln_address::*, ZebedeeClient}; #[tokio::main] async fn main() { let apikey: String = env::var("ZBD_API_KEY").unwrap(); let zebedee_client = ZebedeeClient::new().apikey(apikey).build(); // Create a Lightning payment let payment = LnPayment { ln_address: String::from("dannym@zbd.gg"), amount: String::from("10000"), ..Default::default() }; // Initiate the payment let payment_res = zebedee_client.pay_ln_address(&payment).await.unwrap(); // Print the result println!("Internal transfer result: {:?}", payment_res); }

Getting Started

The Rust Crate for ZBD API is available under zebedee-rust. When building tools with ZBD support we encourage you to include zbd in the keywords field in Cargo.toml.

All you have to do to get started is add zebedee-rust as a dependency to your Rust-based project. You can do so using cargo:

cargo add zebedee_rust

Now let's authenticate a specific Wallet with that ZBD Project's API Key.

Authentication

In order to authenticate your Project Wallet with the ZBD API, you will need to provide your ZBD Project's API Key to the zebedee-rust crate. You can find your Project API Key in the ZBD Developer Dashboard.

First you must import the zebedee-rust crate client into your codebase, and then instantiate it with your Project API Key (replace `YOUR_API_KEY_HERE` below with your actual ZBD Project's API Key).

use zebedee_rust::{ZebedeeClient}; let zbd_client = ZebedeeClient::new() .apikey(YOUR_API_KEY_HERE) .build(); let payment = GamertagPayment{...}; let payment_res = zbd_client.pay_gamertag(&payment).await.unwrap();

You're all set. Now let's move some money at the speed of the internet! Check the SDK API Reference below for more information on how to use the zebedee-rust crate.

zebedee-rust

The goal of the project is to create a beautiful and extensible experience for developers using ZBD APIs in a Rust environment. The ZBD community has taken on the challenge and built the Rust SDK themselves. The focus is to provide parity with ZBD REST API, as well as providing further stability for developers.

API Reference

Below is a comprehensive list of the methods and functions available in the zebedee-rust crate. These methods are ONLY available to the ZebedeeClient client instance after it's been properly authenticated with a Project's API Key.

MethodEntityDescription
create_charge
Charge

Creates a new Charge / Payment Request in the Bitcoin Lightning Network, payable by any Bitcoin Lightning wallet.

Struct:

charge: &ChargeThe Charge reference containing the required parameters.


Parameters:

amount

required

The amount for the Charge -> in millisatoshis.
description

required

Note or comment for this Charge (visible to payer).
expires_inTime until charge expiration -> in seconds.
internal_idOpen metadata string property.
callback_urlThe endpoint ZBD will POST Charge updates to.


Resources:

View response payload examples
get_charge
Charge

Retrieves all information relating to a specific Charge / Payment Request.

Parameters:

charge_id: String

required

A String representing the ID of the Charge.


Resources:

View response payload examples
create_withdrawal_request
Withdrawal Request

A Withdrawal Request is a QR code that allows someone to scan and receive Bitcoin (e.g. Withdrawals).

Struct:

withdrawal_request: &WithdrawalRequestThe WithdrawalRequest reference containing the required parameters.


Parameters:

amount

required

The amount for the Withdrawal Request -> in millisatoshis.
expires_inTime until Withdrawal Request expires -> in seconds.
descriptionNote or comment for this Withdrawal Request (visible to payer).
internal_idOpen metadata string property.
callback_url

required

The endpoint ZBD will POST Withdrawal Request updates to.


Resources:

View response payload examples
get_withdrawal_request
Withdrawal Request

Retrieves details about a specific Withdrawal Request.

Parameters:

String: withdrawal_request_id

required

A String representing the ID of the Withdrawal Request.


Resources:

View response payload examples
pay_ln_address
Lightning Address

Send Bitcoin payments directly to a Lightning Address. A Lightning Address is an internet identifier (akin to an email address -- andre@zbd.gg) that anyone can send Bitcoin Lightning Network payments to.

Struct:

payment: &LnPaymentThe LnPayment reference containing the required parameters.


Parameters:

ln_address

required

The Lightning Address of the intended recipient.
amount

required

The amount for the Payment -> in millisatoshis.
commentNote or description of this Payment.


Resources:

View response payload examples
validate_ln_address
Lightning Address

Not all internet identifiers are Lightning Addresses / compatible with the Lightning Address protocol. Use this endpoint in order to validate whether a user's entered Lightning Address is valid.

Parameters:

lightning_address: &LnAddress

required

The LnAddress reference containing the address to be validated.


Resources:

View response payload examples
fetch_charge_ln_address
Lightning Address

Generates a Bitcoin Lightning Charge / Payment Request for a given Lightning Address destination. Depending on your system's configuration or your product's UX, you may need the ability to generate Charges for specific users using a different provider than ZBD.

Struct:

payment: &LnFetchChargeThe LnFetchCharge reference containing the lightning address.


Parameters:

ln_address

required

The Lightning Address of the intended recipient.
amount

required

The amount for the Charge -> in millisatoshis.
descriptionNote or comment of this Charge.


Resources:

View response payload examples
get_wallet_details
Wallet

Retrieves the total balance of a given Project Wallet.



Resources:

View response payload examples
internal_transfer
Wallet

Initiates a transfer of funds between two Project Wallets you own.

Struct:

interal_transfer_payload: &InternalTransferThe InternalTransfer reference containing the payload info for the transfer.


Parameters:

amount

required

The amount to be transferred -> in millisatoshis.
receiver_wallet_id

required

The Wallet ID of the recipient Project.


Resources:

View response payload examples
keysend
Keysend

This endpoint exposes the ability to make payment directly to a Lightning Network node Public Key, without the need for a Payment Request / Charge.

Struct:

keysend_payload: &KeysendThe Keysend reference containing the payload.


Parameters:

amount

required

The amount for the Payment -> in millisatoshis.
pubkey

required

The Public Key for the destination Lightning Node.
callback_urlThe endpoint ZBD will POST updates to.
tlv_recordsTLV data records.


Resources:

View response payload examples
pay_invoice
Payment

Pays a Charge / Payment Request in the Bitcoin Lightning Network.

Struct:

payment: &PaymentThe Payment reference containing the payment information.


Parameters:

invoice

required

Lightning Network Payment Request/Charge.
descriptionNote or comment for this Payment.
internal_idOpen metadata string property.


Resources:

View response payload examples
get_payment
Payment

Retrieves all the information related to a specific Payment.

Parameters:

payment_id: String

required

A String representing the ID of the Payment.


Resources:

View response payload examples
pay_gamertag
ZBD Gamertag

This API endpoint is used to send Bitcoin payments directly to a user's ZBD Gamertag.

Struct:

payment: &GamertagPaymentThe GamertagPayment reference containing the payment information.


Parameters:

amount

required

The amount for the Payment -> in millisatoshis.
gamertag

required

Desination ZBD gamertag.
descriptionNote or comment for this Payment (visible to recipient).


Resources:

View response payload examples
get_gamertag_tx
ZBD Gamertag

Get a given ZBD Gamertag when provided with a ZBD User's ID.

Parameters:

transaction_id: String

required

A String representing the ZBD Gamertag Payment Transaction ID.


Resources:

View response payload examples
get_userid_by_gamertag
ZBD Gamertag

Get a given ZBD User's ID when provided with a ZBD Gamertag.

Parameters:

gamertag: String

required

A String representing the ZBD Gamertag of the ZBD user.


Resources:

View response payload examples
get_gamertag_by_userid
ZBD Gamertag

Invoked when the app first loads. If a plugin reloads, it's invoked again with the existing app.

Parameters:

user_id: String

required

A String representing the specified ZBD User ID.


Resources:

View response payload examples
get_is_supported_region_by_ip
Utility

If you wish to know whether the incoming user request is coming from a region/country where ZBD is supported or not, you can use this simple API endpoint and pass the target IP address as a parameter.

Parameters:

ip: String

required

A String representing the IP Address being checked.


Resources:

View response payload examples
get_prod_ips
Utility

The ZBD API relies on callback URLs for keeping you informed about updates that occur to any Charges, Payments, or Withdrawals you've created. In order to ensure that any incoming callback message is indeed from a trusted ZBD API infrastructure server, we provide this API endpoint for you to know which IP addresses real requests come from.



Resources:

View response payload examples
get_btc_usd
Utility

Get the latest price for Bitcoin in US Dollars. The exchange rate feed is refreshed every 5 seconds and is based upon a combination of industry-leading partner exchange providers's price feeds.



Resources:

View response payload examples

Community Support

Feature Request? Bugfix? Recommendations? We're all ears! Head on over to the zebedee-rust Issues page and submit one. We also welcome Pull Requests and other contributions to the library.