Pippin is a production-ready, high-performance API/developer wallet for Nano and BANANO. Pippin's API is a drop-in replacement for the Nano developer wallet that is built in to the Nano node software.

It is recommended for exchanges, wallets, faucets, and any other application that integrates with the Nano or BANANO networks.

The Nano developer wallet (aka "node wallet") is not recommended for production use. One of the goals of Pippin is to provide a production-ready external key management that can be used to integrate with Nano or BANANO.

Pippin is the first drop-in replacement for the Nano developer wallet. It's incredibly easy to transition to Pippin if you are already using the Nano developer wallet.

• Pippin is independent of the node. You can use Pippin with any public RPC, so you don't have to run your own node
• Pippin is extremely fast and lightweight
• Pippin supports encrypted secret keys
• Pippin natively supports BoomPoW
• Pippin supports multiple database backends (SQLite, PostgreSQL, and MySQL)
• Pippin is scalable and synchronizes state between all instances using Redis

coming soon

Pippin provides an API that mimics the Nano Wallet RPC Protocol

Every wallet-related RPC gets intercepted by Pippin and handled internally. It builds the blocks and signs them using locally-stored keys, it uses a node to publish the blocks.

Every non-wallet related RPC gets proxied to the publishing node. Which means you can make all of your RPC requests directly to Pippin whether they are wallet-related or not.

Pippin has a server and a cli interface. See the appropriate README for more details on each.

• Server
• CLI

The CLI is the main entrypoint for the entire app, including the server.

Pippin comes as a pre-compiled binary for multiple architectures, which can be downloaded on the releases page.

You can start the server with pippin --start-server, or use pippin --help for a full list of available CLI options.

Alternatively, you can run Pippin in a docker container with docker run -v ~/PippinData:/root/PippinData -p 11338:11338 bananocoin/pippin. Be sure to change the host option in the generated config.yaml to 0.0.0.0. Pippin requires Redis to function correctly. See the Configuring Redis section for details.

Pippin is configured through a yaml style configuration for most things, but some things are configured via env variables.

The first step is to determine if you want to change the location where pippin stores its data, by default it will be in the users home directory (~)

Which translates to /home/<username> on Linux, /Users/<username> on MacOS and C:\Users\<username> on Windows

You can override this with the PIPPIN_HOME environment variable.

export PIPPIN_HOME=~

Pippin creates a PippinData directory in your home directory, or $PIPPIN_HOME

Run: pippin --generate-config to generate a sample in ~/PippinData/sample.config.yaml

After editing your parameters in this file, move it to ~/PippinData/config.yaml

By default, Pippin will use a SQLite database that is created in $PIPPIN_HOME/PippinData/pippingo.db

Pippin also supports MySQL and PostgreSQL which is configured in the environment.

You can set these variables the same way that you normally set environment variables, but for convenience pippin will read $PIPPIN_HOME/PippinData/.env

For MySQL

% echo "MYSQL_DB=database_name" >> ~/PippinData/.env
% echo "MYSQL_USER=user_name" >> ~/PippinData/.env
% echo "MYSQL_PASSWORD=mypassword" >> ~/PippinData/.env

You can also override MYSQL_HOST and MYSQL_PORT, which default to localhost and 3306

For Postgres

% echo "POSTGRES_DB=database_name" >> ~/PippinData/.env
% echo "POSTGRES_USER=user_name" >> ~/PippinData/.env
% echo "POSTGRES_PASSWORD=mypassword" >> ~/PippinData/.env

You can also override POSTGRES_HOST and POSTGRES_PORT, which default to localhost and 5432

Redis is a non-optional requirement for Pippin. It allows Pippin to be scalable across multiple instances and handles distributed locking.

You should have a Redis instance running (e.g., on your host machine or in a container) before performing wallet operations. By default it will use localhost:6379 to connect and 0 as the database.

These can be overriden with the environment variables:

• REDIS_HOST
• REDIS_PORT
• REDIS_DB

Want to use BoomPoW?

Pippin will use them automatically for work generation if the key is present in the environment.

For BPoW:

% echo "BPOW_KEY=service:mybpowkey" >> ~/PippinData/.env

The pre-compiled pippin distributions do not support GPU PoW out of the box (only CPU), however Pippin can be compiled that way to enable it with something like:

go build -tags cl -o pippin ./apps/cli

In config.yaml set banano: true

# Settings for the pippin wallet
wallet:
  # Run in banano mode
  # If true, the wallet will operate based on the BANANO protocol
  # Default: false
  banano: true

At the bare minimum, Pippin requires a node for the RPC api. It will default to http://[::1]:7076 for Nano, or http://[::1]:7072 for BANANO. If you want to change it to https://coolnanonode.com/rpc then it would look like this:

server:
  # The RPC URL of the remote node to connect to
  # Non-wallet RPCs will be routed to this node
  # Default: http://[::1]:7076 for nano, https://[::1]:7072 for banano
  node_rpc_url: https://coolnanonode.com/rpc

The node_ws_url corresponds to the URL to use for the Node Websocket API

It is optional but should take the form of ws://[::1]:7078

The websocket is only used to automatically receive transactions for unlocked wallets.

After configuration is complete, simply run pippin --start-server

Send HTTP POST requests to Pippin just like you would a normal node.

% curl -g -d '{"action":"wallet_create"}' localhost:11338
% curl -g -d '{"action":"account_balance", "account": "nano_3jb1fp4diu79wggp7e171jdpxp95auji4moste6gmc55pptwerfjqu48okse"}' localhost:11338

Notice an API that's missing a feature or not behaving the same as nano's APIs?

Open a bug report/feature request on the issues page