Tutorials
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)
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
Listen for transcation
Send grin
Following command sends 2 grin to grin donation wallet. Change the grin address after -d flag to send to the desired address.
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
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
#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.
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