Elements code tutorial

Other language examples

Our aim for each language example is to make simple calls to elementsd using RPC. The examples are very basic but provide a way to get to get a functioning setup which you can use as a building block for further development.


You can check if Ruby is installed on your operating system, and install it if not, by following the steps here.

Create a new file named ‘elementsrpcruby.rb’ and paste the code below into it:

require 'net/http'
require 'uri'
require 'json'

class ElementsRPC
  def initialize(service_url)
    @uri = URI.parse(service_url)

  def method_missing(name, *args)
    post_body = { 'method' => name, 'params' => args, 'id' => 'jsonrpc' }.to_json
    resp = JSON.parse( http_post_request(post_body) )
    raise JSONRPCError, resp['error'] if resp['error']

  def http_post_request(post_body)
    http    = Net::HTTP.new(@uri.host, @uri.port)
    request = Net::HTTP::Post.new(@uri.request_uri)
    request.basic_auth @uri.user, @uri.password
    request.content_type = 'application/json'
    request.body = post_body

  class JSONRPCError < RuntimeError; end

if $0 == __FILE__
  elements = ElementsRPC.new('http://user1:password1@')
  p elements.getblockcount

Execute the code from the command line:

ruby elementsrpcruby.rb

The output will show the current block count.


The example code doesn’t require any external dependencies, but you do need the Java compiler (javac) as well as the Java runtime environment itself. These can be installed on Ubuntu using the command:

sudo apt install default-jdk

Create a new file named ‘elementsrpcjava.java’ and paste the code below into it:

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.Authenticator;
import java.net.PasswordAuthentication;

public class elementsrpcjava {
	public static void main (String []args) throws IOException{
		URL url = new URL ("");
		String rpcuser ="user1";
		String rpcpassword ="password1";
		Authenticator.setDefault(new Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication (rpcuser, rpcpassword.toCharArray());
		HttpURLConnection conn = (HttpURLConnection)url.openConnection();
		conn.setRequestProperty("Content-Type", "application/json; utf-8");
		conn.setRequestProperty("Accept", "application/json");
		String json = "{\"method\": \"getwalletinfo\", \"jsonrpc\": \"2.0\"}";
		try(OutputStream os = conn.getOutputStream()){
			byte[] input = json.getBytes("utf-8");
			os.write(input, 0, input.length);			
		try(BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "utf-8"))){
			StringBuilder sb = new StringBuilder();
			String line = null;
			while ((line = br.readLine()) != null) {

Compile and run the code from the command line:

javac elementsrpcjava.java
java elementsrpcjava

The output will show wallet information.


Create a project directory for the Node.js example and move into it:

mkdir elementsrpcnodejs
cd elementsrpcnodejs

Generate package.json and install the request package:

npm init --yes
npm install request --save

Create a new file named ‘elementsrpcnode.js’ and paste the code below into it:

const request = require('request');

let username = "user1";
let password = "password1";

let options = {
    url: "http://localhost:18884",
    method: "post",
     "content-type": "text/plain"
    auth: {
        user: username,
        pass: password
    body: JSON.stringify( {"jsonrpc": "2.0", "id": "rpctest", "method": "getwalletinfo", "params": [] })

request(options, (error, response, body) => {
    if (error) {
        console.error('An error occurred: ', error);
    } else {
        json = JSON.parse(body);

Run the code from the command line:

node elementsrpcnode.js

The output will show the bitcoin balance returned by getwalletinfo.


To install Go: https://golang.org. Note the importance of setting the PATH environment variable.

Create a directory src/elements inside your Go workspace directory (probably %HOME/go) so that the full path is: $HOME/go/src/elements

With that directory create a file named ‘elementsrpcgo.go’ and past the following into it:

package main

import (

func main() {
    url := "http://user1:password1@localhost:18884"
    var jsonStr = []byte(`{"jsonrpc":"1.0","method":"getblockcount","params":[]}`)

    request, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonStr))
    request.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    response, err := client.Do(request)
    if err != nil {
    defer response.Body.Close()
    body, _ := ioutil.ReadAll(response.Body)
    //Use as JSON...
    var dat map[string]interface{}
    if err := json.Unmarshal(body, &dat); err != nil {
    blocks := dat["result"].(float64)

Compile and run the code:

go build

The code prints out the current block count.


Perl can be installed from https://www.perl.org and comes pre-installed on Ubuntu.

We will be using the JSON::RPC::Client Perl implementation of a JSON-RPC client which will make the rpc calls and results handling simpler.

To install JSON::RPC::Client open the CPAN tool:

perl -MCPAN -e shell

And from within the cpan console, install the RPC Client:

install JSON::RPC::Client

And then exit the cpan tool:


You must close the terminal window so that when we run the code below it will pick up the new environment variables written.

Create a new file named ‘elementsrpcperl.pl’ and paste the code below into it:

use JSON::RPC::Client;
use Data::Dumper;

my $client = new JSON::RPC::Client;

    'localhost:18884', 'jsonrpc', 'user1' => 'password1'

my $uri = 'http://localhost:18884/';
my $obj = {
    method  => 'getwalletinfo',
    params  => [],

my $res = $client->call( $uri, $obj );

if ($res){
    if ($res->is_error) { print "Error : ", $res->error_message; }
    else { print Dumper($res->result); }
} else {
    print $client->status_line;

Run the code from the command line (remember that this must be a new terminal window from the one we used before to install the RPC Client):

perl elementsrpcperl.pl

The output will show wallet information.

Next: An easy way to run the main tutorial code