attester

Run a Task Attester node

Usage

otnode run attester [options] <bootnodes>

Arguments:
  bootnodes                               (required) The multiaddr of the bootnodes you would like to connect to

Examples

Single Aggregator

otnode run attester \
    /ip4/127.0.0.1/tcp/9876/p2p/<BOOTSTRAP_NODE_ID> \
    --avs-webapi http://10.8.0.42 \
    --avs-webapi-port <PORT> \
    --l1-chain holesky \
    --l2-chain amoy

Multiple Aggregators

command: [
    "run",
    "attester",
    "/ip4/{Aggregator_IP1}/tcp/9876/p2p/${OTHENTIC_BOOTSTRAP_ID}, 
    /ip4/{Aggregator_IP2}/tcp/9876/p2p/${OTHENTIC_BOOTSTRAP_ID},
    /ip4/{Aggregator_IP3}/tcp/9876/p2p/${OTHENTIC_BOOTSTRAP_ID}",
    --avs-webapi <HOST>,
    --l1-chain holesky,
    --l2-chain amoy,base-sepolia,
]

BOOTSTRAP_NODE_ID can be saved in the .env file as per the Bootstrap node configuration.

Options

--avs-webapi required

url

Specifies the URL of the HTTP server used for the AVS Web API.

---

--avs-webapi-port required

port

Defines the port on which the AVS Web API HTTP server will run.

---

--json-rpc required

flag

Enables the JSON-RPC API for the node. Disabled by default.

---

--json-rpc.port optional

number

Port number for the JSON-RPC server (default: 8545).

---

--json-rpc.custom-message-enabled optional

flag

Enables custom message support via the p2p communication layer. Useful for advanced messaging scenarios.

---

--p2p.port optional

number

Port used for low-level peer-to-peer (p2p) communication.

---

--p2p.datadir optional

file path

Path to the directory for persistent p2p data storage. If the directory doesn't exist, it will be created automatically using LevelDatastore.

---

--p2p.discovery-interval optional.

number (in ms)

Time interval for the p2p discovery mechanism, specified in milliseconds.

---

--metrics optional

flag

Enables the metrics exporter for the node. Disabled by default.

---

--metrics.port optional

number

Port number for the metrics HTTP server.

---

--metrics.export-url optional

url

URL to export metrics to Prometheus Pushgateway for external monitoring.

---

--status-check-interval optional

milliseconds

Interval for checking operator status (default: 5000 ms).

A throttling mechanism has been added to operator status checks to reduce idle RPC usage. Configure this using the optional --status-check-interval <interval> flag, with a default of 5000 milliseconds.

otnode run attester --status-check-interval 8000

---

--announced-addresses optional

string Comma-separated addresses the node should announce to the network (useful for NAT/firewall setups).

The announce option in libp2p allows nodes to explicitly define which addresses they advertise to peers, overriding any automatically detected addresses. This is particularly useful when running behind a load balancer or NAT, where the external address needs to be manually set. To enable this option in our CLI, users should start their nodes with the --announced-addresses <multi-address> flag, specifying the desired multiaddr. This ensures that peers connect using the correct external address rather than any internally detected ones.

otnode run attester --announced-addresses /dnsaddr/{dns-name}/tcp/{port1}/p2p/{Peer ID},/ip4/{resolved dns ip}/tcp/{port1}/p2p/{Peer ID}

---

--keystore optional

file path

The path to the keystore file used for signing the transaction.

---

--keystore-password optional

file path

The path to the file containing the keystore password.

---

--silent, --s, --no-prompt optional

flag

Run in non-interactive mode using .env and provided arguments, without user prompts.

---

-h, --help optional

flag

Display help information for this command.