hermes

Documentation

Index

• func BackupWalletCmd(cfg *config.Config, id string, opts BackupWalletOptions, u *ui.UI) error
• func CLI(cfg *config.Config, id string, args []string) error
• func Delete(cfg *config.Config, id string, force bool, u *ui.UI) error
• func DeploymentPath(cfg *config.Config, id string) string
• func FindInstancesWithWallets(cfg *config.Config) []string
• func ImageRef() string
• func ImportPrivateKeyWalletCmd(cfg *config.Config, id string, opts ImportPrivateKeyWalletOptions, u *ui.UI) error
• func List(cfg *config.Config, u *ui.UI) error
• func ListWallets(cfg *config.Config, id string, u *ui.UI) error
• func Onboard(cfg *config.Config, opts OnboardOptions, u *ui.UI) error
• func RegenerateToken(cfg *config.Config, id string, u *ui.UI) (string, error)
• func ResolveCLIInvocation(cfg *config.Config, args []string) (string, []string, error)
• func ResolveInstance(cfg *config.Config, args []string) (string, []string, error)
• func ResolveInstanceNamespace(cfg *config.Config) (string, error)
• func ResolveWalletAddress(cfg *config.Config) (string, error)
• func RestoreWalletCmd(cfg *config.Config, id string, opts RestoreWalletOptions, u *ui.UI) error
• func Setup(cfg *config.Config, id string, _ SetupOptions, u *ui.UI) error
• func SetupDefault(cfg *config.Config, u *ui.UI) error
• func Skills(cfg *config.Config, id string, args []string) error
• func Sync(cfg *config.Config, id string, u *ui.UI) error
• func SyncDefaultModels(cfg *config.Config, u *ui.UI) error
• func Token(cfg *config.Config, id string, u *ui.UI) error
• func WriteWalletMetadata(deploymentDir string, wallet *WalletInfo) error
• type BackupWalletOptions
• type DashboardOptions
• type ImportPrivateKeyWalletOptions
• type OnboardOptions
• type RestoreWalletOptions
• type SetupOptions
• type WalletInfo
  • func GenerateWallet(cfg *config.Config, id string, u *ui.UI) (*WalletInfo, error)
  • func ImportWalletFromPrivateKey(cfg *config.Config, id, privateKeyHex string, u *ui.UI) (*WalletInfo, error)
  • func ReadWalletMetadata(deploymentDir string) (*WalletInfo, error)

Functions

func BackupWalletCmd

func BackupWalletCmd(cfg *config.Config, id string, opts BackupWalletOptions, u *ui.UI) error

BackupWalletCmd creates a backup of the Hermes instance's remote-signer wallet. The on-disk format is identical to OpenClaw's, so a Hermes backup can be restored into an OpenClaw instance and vice versa — instance names and namespace scoping are not part of the backup payload.

func CLI

func CLI(cfg *config.Config, id string, args []string) error

func Delete

func Delete(cfg *config.Config, id string, force bool, u *ui.UI) error

func DeploymentPath

func DeploymentPath(cfg *config.Config, id string) string

func FindInstancesWithWallets

func FindInstancesWithWallets(cfg *config.Config) []string

FindInstancesWithWallets returns Hermes instance IDs that have wallet metadata on disk. Used by purge prompts.

func ImageRef

func ImageRef() string

ImageRef returns the upstream Hermes container image ref. Used by stack.devPreloadImages so `obol stack up` pulls the image to the host docker daemon and imports it into the k3d cluster's containerd cache — otherwise the cluster's first Hermes pod stalls waiting for the registry mirror to serve a cold pull, which has caused flow-14 step 32 timeouts in the past.

func ImportPrivateKeyWalletCmd

func ImportPrivateKeyWalletCmd(cfg *config.Config, id string, opts ImportPrivateKeyWalletOptions, u *ui.UI) error

ImportPrivateKeyWalletCmd imports an existing private key as the remote-signer wallet for a Hermes instance. Mirror of the OpenClaw path.

func List

func List(cfg *config.Config, u *ui.UI) error

func ListWallets

func ListWallets(cfg *config.Config, id string, u *ui.UI) error

func Onboard

func Onboard(cfg *config.Config, opts OnboardOptions, u *ui.UI) error

func RegenerateToken

func RegenerateToken(cfg *config.Config, id string, u *ui.UI) (string, error)

func ResolveCLIInvocation

func ResolveCLIInvocation(cfg *config.Config, args []string) (string, []string, error)

func ResolveInstance

func ResolveInstance(cfg *config.Config, args []string) (string, []string, error)

func ResolveInstanceNamespace

func ResolveInstanceNamespace(cfg *config.Config) (string, error)

func ResolveWalletAddress

func ResolveWalletAddress(cfg *config.Config) (string, error)

func RestoreWalletCmd

func RestoreWalletCmd(cfg *config.Config, id string, opts RestoreWalletOptions, u *ui.UI) error

RestoreWalletCmd restores a Hermes wallet from a backup file. Mirrors openclaw.RestoreWalletCmd, sharing the wire format via walletbackup.

func Setup

func Setup(cfg *config.Config, id string, _ SetupOptions, u *ui.UI) error

func SetupDefault

func SetupDefault(cfg *config.Config, u *ui.UI) error

func Skills

func Skills(cfg *config.Config, id string, args []string) error

func Sync

func Sync(cfg *config.Config, id string, u *ui.UI) error

func SyncDefaultModels

func SyncDefaultModels(cfg *config.Config, u *ui.UI) error

func Token

func Token(cfg *config.Config, id string, u *ui.UI) error

func WriteWalletMetadata

func WriteWalletMetadata(deploymentDir string, wallet *WalletInfo) error

Types

type BackupWalletOptions

type BackupWalletOptions struct {
	Output      string
	Passphrase  string
	HasPassFlag bool
}

BackupWalletOptions holds options for `obol agent wallet backup`.

type DashboardOptions

type DashboardOptions struct {
	Port      int
	NoBrowser bool
}

type ImportPrivateKeyWalletOptions

type ImportPrivateKeyWalletOptions struct {
	PrivateKeyFile string
	Force          bool
	ApplyCluster   bool
}

ImportPrivateKeyWalletOptions holds options for importing a raw private key as a Hermes remote-signer wallet.

type OnboardOptions

type OnboardOptions struct {
	ID        string
	Force     bool
	Sync      bool
	IsDefault bool
	AgentMode bool
}

type RestoreWalletOptions

type RestoreWalletOptions struct {
	Input        string
	Passphrase   string
	HasPassFlag  bool
	Force        bool
	ApplyCluster bool
}

RestoreWalletOptions holds options for `obol agent wallet restore`.

type SetupOptions

type SetupOptions struct{}

type WalletInfo

type WalletInfo struct {
	Address      string `json:"address"`
	PublicKey    string `json:"publicKey"`
	KeystoreUUID string `json:"keystore_uuid"`
	KeystorePath string `json:"keystore_path"`
	CreatedAt    string `json:"createdAt"`
	Password     string `json:"-"`
}

func GenerateWallet

func GenerateWallet(cfg *config.Config, id string, u *ui.UI) (*WalletInfo, error)

func ImportWalletFromPrivateKey

func ImportWalletFromPrivateKey(cfg *config.Config, id, privateKeyHex string, u *ui.UI) (*WalletInfo, error)

ImportWalletFromPrivateKey provisions an existing Ethereum private key as the remote-signer wallet for a Hermes instance.

func ReadWalletMetadata

func ReadWalletMetadata(deploymentDir string) (*WalletInfo, error)