actor

Last updated: 2025-10-30 01:15:00.849822 File source: link on GitLab

Nunet Actor System CLI

The Nunet Actor System CLI provides a set of commands for interacting with the Nunet actor system, enabling you to send messages to actors, invoke behaviors, and broadcast messages across the network.

Basic Commands

nunet actor msg: Constructs a message for an actor.
nunet actor send: Sends a constructed message to an actor.
nunet actor invoke: Invokes a behavior in an actor and returns the result.
nunet actor broadcast: Broadcasts a message to a topic, potentially reaching multiple actors.
nunet actor cmd: Invokes a predefined public behavior on an actor.

`nunet actor msg`

This command is used to create a message that can be sent to an actor. It encapsulates the behavior to be invoked and the associated payload data.

Usage

nunet actor msg <behavior> <payload> [flags]

Arguments

<behavior>: The specific behavior you want the actor to perform upon receiving the message
<payload>: The data accompanying the message, providing context or input for the behavior

Flags

-b, --broadcast string: Designates the topic for broadcasting the message.
-c, --context string: Specifies the capability context name
-d, --dest string: Identifies the destination handle for the message.
-e, --expiry time: Sets an expiration time for the message.
-h, --help: Displays help information for the msg command.
-i, --invoke: Marks the message as an invocation, requesting a response from the actor.
-t, --timeout duration: Sets a timeout for awaiting a response after invoking a behavior.

`nunet actor send`

This command delivers a previously constructed message to an actor.

Usage

nunet actor send <msg> [flags]

Arguments

<msg>: The message, created using the nunet actor msg command, to be sent.

Flags

-h, --help: Displays help information for the send command.

`nunet actor invoke`

This command directly invokes a specific behavior on an actor and expects a response.

Usage

nunet actor invoke <msg> [flags]

Arguments

<msg>: The message, crafted with nunet actor msg, containing the behavior and payload

Flags

-h, --help: Displays help information for the invoke command

`nunet actor broadcast`

This command disseminates a message to a designated topic, potentially reaching multiple actors who have subscribed to that topic.

Usage

nunet actor broadcast <msg> [flags]

Arguments

<msg>: The message to be broadcasted

Flags

-h, --help: Displays help information for the broadcast command.

Please let me know if you have any other questions.

`nunet actor cmd`

This command invokes a behavior on an actor.

Usage

nunet actor cmd [flags]
nunet actor cmd [command]

Available Commands

/broadcast/hello: Invoke /broadcast/hello behavior on an actor.
/dms/node/onboarding/offboard: Invoke /dms/node/onboarding/offboard behavior on an actor.
/dms/node/onboarding/onboard: Invoke /dms/node/onboarding/onboard behavior on an actor.
/dms/node/onboarding/resource: Invoke /dms/node/onboarding/resource behavior on an actor.
/dms/node/onboarding/status: Invoke /dms/node/onboarding/status behavior on an actor.
/dms/node/peers/connect: Invoke /dms/node/peers/connect behavior on an actor.
/dms/node/peers/dht: Invoke /dms/node/peers/dht behavior on an actor.
/dms/node/peers/list: Invoke /dms/node/peers/list behavior on an actor.
/dms/node/peers/ping: Invoke /dms/node/peers/ping behavior on an actor.
/dms/node/peers/score: Invoke /dms/node/peers/score behavior on an actor.
/dms/node/peers/self: Invoke /dms/node/peers/self behavior on an actor.
/dms/node/vm/list: Invoke /dms/node/vm/list behavior on an actor.
/dms/node/vm/start/custom: Invoke /dms/node/vm/start/custom behavior on an actor.
/dms/node/vm/stop: Invoke /dms/node/vm/stop behavior on an actor.
/public/hello: Invoke /public/hello behavior on an actor
/public/status: Invoke /public/status behavior on an actor

Flags

-c, --context string: Capability context name.
-d, --dest string: Destination DMS DID, peer ID or handle.
-e, --expiry time: Expiration time.
-h, --help: Help for the cmd command.
-t, --timeout duration: Timeout duration.

Broadcast Commands

/broadcast/hello
- Description: Invokes the /broadcast/hello behavior on an actor. This sends a "hello" message to a broadcast topic for polite introduction.
- Usage: nunet actor cmd /broadcast/hello [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /broadcast/hello command

DMS Node Commands

/dms/node/onboarding/offboard
- Description: Invokes the /dms/node/onboarding/offboard behavior on an actor. This is used to offboard a node from the DMS (Device Management Service).
- Usage: nunet actor cmd /dms/node/onboarding/offboard [<param> ...]
- Flags:
  - -h, --help: Display help information for the /dms/node/onboarding/offboard command.
/dms/node/onboarding/onboard
- Description: Invokes the /dms/node/onboarding/onboard behavior on an actor. This is used to onboard a node to the DMS, making its resources available for use.
- Usage: nunet actor cmd /dms/node/onboarding/onboard [<param> ...] [flags]
- Flags:
  - -C, --cpu float32: CPU cores to allocate
  - -R, --ram uint: Memory to allocate
  - -D, --disk uint: Disk space to allocate
  - -G, --gpus string: Comma-separated list of GPU Index and VRAM in GB to allocate e.g. "0:4,1:8". The gpu index can be obtained from 'nunet gpu list' command
  - --no-gpu: Do not allocate any GPU
/dms/node/onboarding/status
- Description: Invokes the /dms/node/onboarding/status behavior on an actor. This is used to check the onboarding status of a node.
- Usage: nunet actor cmd /dms/node/onboarding/status [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/onboarding/status command
/dms/node/peers/connect
- Description: Invokes the /dms/node/peers/connect behavior on an actor. This initiates a connection to a specified peer.
- Usage: nunet actor cmd /dms/node/peers/connect [<param> ...] [flags]
- Flags:
  - -a, --address string: The peer address to connect to
  - -h, --help: Display help information for the /dms/node/peers/connect command.
/dms/node/peers/dht
- Description: Invokes the /dms/node/peers/dht behavior on an actor. This interacts with the Distributed Hash Table (DHT) used for peer discovery and content routing
- Usage: nunet actor cmd /dms/node/peers/dht [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/peers/dht command.
/dms/node/peers/list
- Description: Invokes the /dms/node/peers/list behavior on an actor. This retrieves a list of connected peers
- Usage: nunet actor cmd /dms/node/peers/list [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/peers/list command.
/dms/node/peers/ping
- Description: Invokes the /dms/node/peers/ping behavior on an actor. This sends a ping message to a specified host to check its reachability
- Usage: nunet actor cmd /dms/node/peers/ping [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/peers/ping command
  - -H, --host string: The host address to ping
/dms/node/peers/score
- Description: Invokes the /dms/node/peers/score behavior on an actor. This retrieves a snapshot of the peer's gossipsub broadcast score.
- Usage: nunet actor cmd /dms/node/peers/score [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/peers/score command
/dms/node/peers/self
- Description: Invokes the /dms/node/peers/self behavior on an actor. This retrieves information about the node itself, such as its ID or addresses
- Usage: nunet actor cmd /dms/node/peers/self [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/peers/self command.
/dms/node/vm/list
- Description: Invokes the /dms/node/vm/list behavior on an actor. This retrieves a list of virtual machines (VMs) running on the node
- Usage: nunet actor cmd /dms/node/vm/list [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/vm/list command.
/dms/node/vm/start/custom
- Description: Invokes the /dms/node/vm/start/custom behavior on an actor. This starts a new VM with custom configurations.
- Usage: nunet actor cmd /dms/node/vm/start/custom [<param> ...] [flags]
- Flags:
  - -a, --args string: Arguments to pass to the kernel
  - -z, --cpu float32: CPU cores to allocate (default 1)
  - -h, --help: Display help information for the /dms/node/vm/start/custom command.
  - -i, --initrd string: Path to initial ram disk
  - -k, --kernel string: Path to kernel image file.
  - -m, --memory uint: Memory to allocate (default 1024)
  - -r, --rootfs string: Path to root fs image file
/dms/node/vm/stop
- Description: Invokes the /dms/node/vm/stop behavior on an actor. This stops a running VM
- Usage: nunet actor cmd /dms/node/vm/stop [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /dms/node/vm/stop command
  - -i, --id string: Execution id of the VM

Public Commands

/public/hello
- Description: Invokes the /public/hello behavior on an actor. This broadcasts a "hello" for a polite introduction.
- Usage: nunet actor cmd /public/hello [<param> ...] [flags]
- Flags:
  - -h, --help: Display help information for the /public/hello command
/public/status
- Description: Invokes the /public/status behavior on an actor. This retrieves the status or health information of the actor or system
- Flags:
  - -h, --help: Display help information for the /public/status command

Global Flags

These flags can be used with any of the above commands:

-c, --context string: Specifies the capability context name. This is used for authorization or access control.
-d, --dest string: Specifies the destination for the command. This can be a DMS DID (Decentralized Identifier), a peer ID, or a handle.
-e, --expiry time: Sets an expiration time for the message or command.
-t, --timeout duration: Sets a timeout duration for the command. If the command does not complete within the specified duration, it will time out.
-h, --help: Display help information for the commands

Previouscmd Nextcap

Last updated 22 hours ago