cmd/loop: add recover command for local backups

Expose the new recovery flow through loop-cli with a dedicated recover
command that calls loopd over the existing RPC connection and optionally
accepts a custom backup file path.

Author: hieblmi

cmd/loop/main.go

@@ -88,7 +88,8 @@ var (
 		monitorCommand, quoteCommand, listAuthCommand, fetchL402Command,
 		listSwapsCommand, swapInfoCommand, getLiquidityParamsCommand,
 		setLiquidityRuleCommand, suggestSwapCommand, setParamsCommand,
-		getInfoCommand, abandonSwapCommand, reservationsCommands,
+		getInfoCommand, abandonSwapCommand, recoverCommand,
+		reservationsCommands,
 		instantOutCommand, listInstantOutsCommand, stopCommand,
 		printManCommand, printMarkdownCommand,
 	}

cmd/loop/recover.go

@@ -0,0 +1,50 @@
+package main
+
+import (
+	"context"
+
+	"github.com/urfave/cli/v3"
+	"google.golang.org/protobuf/types/known/structpb"
+	"google.golang.org/protobuf/types/known/wrapperspb"
+)
+
+var recoverCommand = &cli.Command{
+	Name:  "recover",
+	Usage: "restore static address and L402 state from a local backup file",
+	Description: "Restores the local static-address state and L402 token " +
+		"from an encrypted backup file. If --backup_file is omitted, " +
+		"loopd will use the latest timestamped network-specific backup " +
+		"file.",
+	Flags: []cli.Flag{
+		&cli.StringFlag{
+			Name: "backup_file",
+			Usage: "path to an encrypted backup file; if omitted, " +
+				"loopd uses the latest timestamped backup file path",
+		},
+	},
+	Action: runRecover,
+}
+
+func runRecover(ctx context.Context, cmd *cli.Command) error {
+	if cmd.NArg() > 0 {
+		return showCommandHelp(ctx, cmd)
+	}
+
+	_, conn, cleanup, err := getClientWithConn(cmd)
+	if err != nil {
+		return err
+	}
+	defer cleanup()
+
+	resp := &structpb.Struct{}
+	err = conn.Invoke(
+		ctx, "/looprpc.Recovery/Recover",
+		wrapperspb.String(cmd.String("backup_file")), resp,
+	)
+	if err != nil {
+		return err
+	}
+
+	printJSON(resp.AsMap())
+	return nil
+}