clightningrpc

Crates.ioclightningrpc
lib.rsclightningrpc
version0.3.0-beta.8
sourcesrc
created_at2018-09-05 15:01:01.699739
updated_at2023-08-24 23:29:41.917653
descriptionCrate that provides a strong typed RPC binding from rust code to the core lightning daemon
homepagehttps://github.com/laanwj/rust-clightning-rpc
repositoryhttps://github.com/laanwj/rust-clightning-rpc.git
max_upload_size
id83066
size60,708
Vincenzo Palazzo (vincenzopalazzo)

documentation

README

Rust c-lightning client

This crate provides an interface from rust to the c-lightning daemon through RPC.

Project Homepage

GitHub Workflow Status (branch) Crates.io docs.rs

This crate provides an interface from rust to the c-lightning daemon through RPC.

extern crate clightningrpc;
use std::env;
use clightningrpc::LightningRPC;

fn main() {
    let sock = env::home_dir().unwrap().join(".lightning/lightning-rpc");
    let mut client = LightningRPC::new(&sock);

    println!("getinfo result: {:?}", client.getinfo().unwrap());
}

See examples directory for more usage examples. To build and run an example do cargo run --example ex_1. API documentation for the lastest version can be found on docs.rs.

Currently implemented (this covers all non-dev commands as of c-lightning v0.6.1rc1):

  • getinfo
  • feerates
  • listnodes
  • listchannels
  • help
  • getlog
  • listconfigs
  • listpeers
  • listinvoices
  • invoice
  • delinvoice
  • delexpiredinvoice
  • autocleaninvoice
  • waitanyinvoice
  • waitinvoice
  • pay
  • sendpay
  • waitsendpay
  • listpayments
  • decodepay
  • getroute
  • connect
  • disconnect
  • fundchannel
  • close
  • ping
  • listfunds
  • withdraw
  • newaddr
  • stop

Be aware that the API (of rust-clighting-rpc, but also that of c-lightning itself) is not finalized. This means that it may change from version to version and break your compile, sorry!

N.B: A good solution if you have some missing compatibility between core lightning and the rust library, considering to use the common crate.

Contributing guidelines

  • Four spaces
  • Call make fmt before committing
  • If you can, GPG-sign at least your top commit when filing a PR

Supports

If you want support this library consider to donate with the following methods

Credits

This library is based on Andrew Poelstra's rust-jsonrpc.

Commit count: 282

cargo fmt