How to use Grinnode.live

Connect your GRIN-Wallet to Grinnode.live 

There are two options to use grin-wallet with connecting to grinnode.live.

a) First option is to specify that you want to connect grinnode.live with -r flag.

CLI:
           grin-wallet -r "https://grinnode.live:3413" info    

 

b) Second option is to add it into the wallet.toml config file which can be found in wallet directory like below.

grin-wallet.toml :
          check_node_api_http_addr = "https://grinnode.live:3413"

 

Here are some examples to use grin-wallet

Initialize wallet

Following command creates a new folder named orange on your desktop and initialize a wallet for Windows operating system. You can create and use more than one wallet for testing and other purposes by this way. (Don't forget to save your recovery phrase)

grin-wallet -r https://grinnode.live:3413 -t C:\Users\YOUR_WINDOWS_ACCOUNT_NAME\Desktop\orange init

You can get an error for not being able to request and connect to node. This is a known issue, ignore for the time being.

Get info

grin-wallet -r https://grinnode.live:3413 -t C:\Users\YOUR_WINDOWS_ACCOUNT_NAME\Desktop\orange info

Listen for transcation

grin-wallet -r https://grinnode.live:3413 -t C:\Users\YOUR_WINDOWS_ACCOUNT_NAME\Desktop\orange listen

Send grin

Following command sends 2 grin to grin donation wallet. Change the grin address after -d flag to send to the desired address.

grin-wallet -r https://grinnode.live:3413 -t C:\Users\YOUR_WINDOWS_ACCOUNT_NAME\Desktop\orange send -d grin1zxwrf5yaxlyps4mpx3n7j9kp4su3gzgpdhfk2sgv56q0prcdlzls9e6e0y 2

More Grin-Wallet example commands can be found here

When using the Grinnode Wallet API , you are trusting us to run a Grin node. We recommend to use your own node for better privacy.

Use Grinnode.live High-Available Seed-Node

Connect to lot of Grin-Nodes fast using our Seed-Node by editing your grin-server.toml. Or download our example grin-server.toml

#how to seed this server, can be None, List or DNSSeed
seeding_type = "List"
#If the seeding type is List, the list of peers to connect to can #be specified as follows:
seeds = ["mainnet-seed.grinnode.live:3414"]
Connect your GRIN-Node to Grinnode.live 

Edit your Grin-Node grin-server.toml

peers_preferred = ["213.239.215.236:3414"]
#maximum number of inbound peer connections
#maximum number of outbound peer connections
peer_max_inbound_count = 30
#preferred minimum number of outbound peers
peer_min_preferred_outbound_count = 10
#temporarily allowed to exceed peer_max_inbound_count
peer_listener_buffer_count = 5
Public Grinnode.live API examples

Public Grin-API v2 documentation

When running grin with defaults, the v2 API is available

https://grinnode.live/v2/owner for the owner API.

https://grinnode.live/v2/foreign for the foreign API.

API v2 example:
curl -d '{"id":1,"jsonrpc":"2.0","method":"get_status","params":{} }' -o - -X POST https://grinnode.live:3413/v2/owner

answer:
{
"id": "json",
"result": {
"Ok": {
"connections": 121,
"protocol_version": 2,
"sync_status": "no_sync",
"tip": {
"height": 527467,
"last_block_pushed": "000001a81c92da17102079862b927134e7f8210ad56af892f494a072f5b77b92",
"prev_block_to_last": "000024005775cf7e2155d8156e514b6b1f51d98483a7bdc220a22334d2b30749",
"total_difficulty": 1456919673376722
},
"user_agent": "MW/Grin 3.1.0-beta.1"
}
}


Do I need any API secret to use Grinnode API?

No! see FAQ-Site.

GRIN API Documentation

GRIN API v1 is deprecated after grin fork version 4. Documentation Grin-API v2 can be found here. New api is based on JSON-RPC and divided into two sections

Owner API endpoints API calls referred to node

Foreign API endpoints API calls to be consumed by wallet