xtz.node

Tezos Node Package

Supports node, baker and vdf mode

Setup

1. If not already installed, install ami:

wget -q https://raw.githubusercontent.com/alis-is/ami/master/install.sh -O /tmp/install.sh && sh /tmp/install.sh

2. Create a directory for your application. It should not be part of user home folder structure. For example, you can use /mns/xtz1.
3. Create app.json or app.hjson with the configuration you prefer, based on the mode you want to use: node, baker, or vdf. Here are examples for each:

Node:

{
    id: node
	type: xtz.node
    configuration: {
        "CONFIG_FILE": { 
            "p2p": {
                "bootstrap-peers": [ "boot.tzbeta.net", "116.202.172.21", "95.216.45.62" ],
                "listen-addr": "[::]:9732" 
            }
        }
    }
	user: xtznode
}

Baker:

{
    id: baker
	type: xtz.node
    configuration: {
        NODE_TYPE: baker
    }
	user: xtzbaker
}

VDF:

{
    id: vdf
	type: xtz.node
    configuration: {
        NODE_TYPE: vdf
    }
	user: xtzvdf
}

The above examples are for different node types. Depending on the mode, you'll need to adjust the NODE_TYPE fields accordingly. CONFIG_FILE is content of node configuration and is respected in all modes.

4. Run ami --path=<your app path> setup, for example, ami --path=/mns/xtz1 setup.
   • run ami --path=<your app path> --help to see available commands.
5. Start your node with ami --path=<your app path> start.
6. Check the node's info with ami --path=<your app path> info.

Configuration Change

1. Stop the app: ami --path=<your app path> stop.
2. Change app.json or app.hjson as required.
3. Reconfigure the setup: ami --path=<your app path> setup --configure.
4. Restart the app: ami --path=<your app path> start.

Removing the App

1. Stop the app: ami --path=<your app path> stop.
2. Remove the app: ami --path=<your app path> remove --all.

Reset node

1. Stop the app: ami --path=<your app path> stop.
2. Remove the app: ami --path=<your app path> remove --chain.
3. (optional) bootstrap the app with ami --path=<your app path> bootstrap <url> <block hash>
4. Restart the app: ami --path=<your app path> start.

Troubleshooting

To enable trace level printout, run ami with -ll=trace. For example: ami --path=/mns/xtz1 -ll=trace setup.

Remember to adjust the path according to your app's location.

Updating sources

Sources can be updated with: eli src/__xtz/update-sources.lua https://gitlab.com/tezos/tezos/-/packages/25835249 Proxford PtParisB