Planetmint Documentation
  • Planetmint
  • Introduction
    • What is Planetmint?
    • Properties of Planetmint
    • Quickstart
  • Using Planetmint
    • Zenroom Smart Contracts & Policies
  • Node Setup
    • Basic AWS Setup
      • Get an AWS Account
    • Run Planetmint with all-in-one Docker
  • Networks & Federations
    • How to Set Up a Planetmint Network
    • Planetmint Networks
    • Kubernetes Deployment Template
Powered by GitBook
On this page
  • The IPDB Testnet - sending transactions
  • Install Planetmint
  • Local Node
  • Cluster of nodes
  • Setup Instructions for Various Cases
  • Develop an App Test
  1. Introduction

Quickstart

Planetmint is a metadata blockchain. This introduction gives an overview about how to attest data to Planetmint. First, simple transaction creation and sending is shown. Thereafter, an introdcution about how to set up a single node or a cluster is given.

The IPDB Testnet - sending transactions

The IPDB foundation hosts a testnet server that is reset every night at 4am UTC.

The following sequence shows a simple asset notarization / attestion on that testnet: Create a file named notarize.py

from planetmint_driver import Planetmint
from planetmint_driver.crypto import generate_keypair
from ipld import marshal, multihash

plntmnt = Planetmint('https://test.ipdb.io')
alice = generate_keypair()
tx = plntmnt.transactions.prepare(
    operation='CREATE',
    signers=alice.public_key,
    assets=[
        {'data': 
            multihash(marshal({'message': 'Blockchain all the things!'}))
            }   
    ]
)
signed_tx = plntmnt.transactions.fulfill(tx, private_keys=alice.private_key)
print(plntmnt.transactions.send_commit(signed_tx))

install dependencies and execute it


$ pip install planetmint-driver>=0.14.0
$ python notarize.py

Install Planetmint

Local Node

Planetmint is a Tendermint application with an attached database. A basic installation setup installs the database, Tendermint and thereafter Planetmint.

Planetmint currently supports Tarantool and MongoDB databases. The installation is as follows:

# Tarantool
$ curl -L https://tarantool.io/release/2/installer.sh | bash 
$ sudo apt-get -y install tarantool
# MongoDB
$ sudo apt install mongodb

Tendermint can be installed and started as follows

$ wget https://github.com/tendermint/tendermint/releases/download/v0.34.15/tendermint_0.34.15_linux_amd64.tar.gz
$ tar zxf tendermint_0.34.15_linux_amd64.tar.gz
$ ./tendermint init
$ ./tendermint node --proxy_app=tcp://localhost:26658

Planetmint installs and starts as described below

$ pip install planetmint
$ planetmint configure
$ planetmint start

Cluster of nodes

Setup Instructions for Various Cases

Quickstart link below

Develop an App Test

To develop an app that talks to a Planetmint network, you'll want a test network to test it against. You have a few options:

PreviousProperties of PlanetmintNextUsing Planetmint

Last updated 2 years ago

Caveat: Tarantool versions before automatically enable and start a demonstration instance that listens on port 3301 by default. Refer to the for more information.

Setting up a cluster of nodes comes down to set up a cluster of tendermint nodes as documented at . In addition to that, the database and Planetmint need to be installed on the servers as described above.

for development, experimenting and testing

The IPDB Test Network (or "Testnet") is a free-to-use, publicly-available test network that you can test against. It is available at .

You could also run a Planetmint node on you local machine. One way is to use this node setup guide with a one-node "network" by using the all-in-one docker solution, or manual installation and configuration of the components. Another way is to use one of the deployment methods listed in the or in the .

2.4.2
Tarantool documentation
Tendermint
Set up a local Planetmint node
Set up and run a Planetmint network
IPDB testnet
network setup guide
the docs about contributing to Planetmint