feat: Identity creation (#6)

Adds three components:
- icp-identity/, for managing identities
- icp identity import and icp identity new for creating identities
- icp identity default/--identity/icp identity principal, required for useful tests

Plus scaffolding:
- Env for global/cached state
- icp-dirs/ for project-wide agreement on what the dirs are

Author: adamspofford-dfinity

Cargo.lock

@@ -2,6 +2,7 @@
 members = [
     "bin/icp-cli",
     "lib/icp-canister",
+    "lib/icp-dirs",
     "lib/icp-fs",
     "lib/icp-identity",
     "lib/icp-network",
@@ -11,21 +12,52 @@ members = [
 resolver = "3"
 
 [workspace.dependencies]
+bip32 = "0.5.0"
 camino = { version = "1.1.9", features = ["serde1"] }
 candid = "0.10.14"
+clap = { version = "4.5.3", features = ["derive"] }
+dialoguer = "0.11.0"
+directories = "6.0.0"
+ed25519-consensus = "2.1.0"
+elliptic-curve = { version = "0.13.8", features = ["sec1", "std", "pkcs8"] }
 fd-lock = "4.0.4"
 glob = "0.3.2"
 hex = "0.4.3"
 ic-agent = { version = "0.40.1" }
+icp-canister = { path = "lib/icp-canister" }
+icp-dirs = { path = "lib/icp-dirs" }
+icp-fs = { path = "lib/icp-fs" }
+icp-identity = { path = "lib/icp-identity", features = ["clap"] }
+icp-network = { path = "lib/icp-network" }
+icp-project = { path = "lib/icp-project" }
+itertools = "0.14.0"
+k256 = { version = "0.13.4", features = ["pem", "pkcs8", "std"] }
+p256 = { version = "0.13.2", features = ["pem", "pkcs8", "std"] }
+pem = "3.0.5"
+pkcs8 = { version = "0.10.2", features = ["encryption", "std"] }
 pocket-ic = "9.0.0"
+rand = "0.9.1"
 reqwest = { version = "0.12.15", default-features = false, features = [
     "rustls-tls",
 ] }
+sec1 = { version = "0.7.3", features = ["pkcs8"] }
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 serde_yaml = "0.9.34"
 snafu = "0.8.5"
+strum = { version = "0.27", features = ["derive"] }
 tempfile = "3"
 time = "0.3.9"
+tiny-bip39 = "2.0.0"
 tokio = { version = "1.45.0", features = ["macros", "rt-multi-thread"] }
 uuid = { version = "1.16.0", features = ["serde", "v4"] }
+zeroize = "1.8.1"
+
+[workspace.lints.rust]
+missing_debug_implementations = "warn"
+
+[workspace.lints.clippy]
+enum_variant_names = "allow"
+
+[profile.dev.package.scrypt]
+opt-level = 3

Cargo.toml

@@ -9,17 +9,35 @@ name = "icp"
 path = "src/main.rs"
 
 [dependencies]
-camino = { workspace = true }
-clap = { version = "4.5.35", features = ["derive"] }
-icp-canister = { path = "../../lib/icp-canister" }
-icp-fs = { path = "../../lib/icp-fs" }
-icp-network = { path = "../../lib/icp-network" }
-icp-project = { path = "../../lib/icp-project" }
-snafu = { workspace = true }
-tokio = { workspace = true }
+bip32.workspace = true
+camino.workspace = true
+clap.workspace = true
+dialoguer.workspace = true
+elliptic-curve.workspace = true
+hex.workspace = true
+ic-agent.workspace = true
+icp-canister.workspace = true
+icp-dirs.workspace = true
+icp-fs.workspace = true
+icp-identity.workspace = true
+icp-network.workspace = true
+icp-project.workspace = true
+itertools.workspace = true
+k256.workspace = true
+pem.workspace = true
+pkcs8.workspace = true
+sec1.workspace = true
+serde.workspace = true
+serde_json.workspace = true
+snafu.workspace = true
+tiny-bip39.workspace = true
+tokio.workspace = true
 
 [dev-dependencies]
 assert_cmd = "2"
 predicates = "3"
 reqwest = { workspace = true }
 camino-tempfile = "1"
+
+[lints]
+workspace = true

bin/icp-cli/Cargo.toml

@@ -1,26 +1,33 @@
-use crate::commands::{build::BuildCommandError, network::NetworkCommandError};
+use crate::{
+    commands::{build::BuildCommandError, network::NetworkCommandError},
+    env::Env,
+};
 use clap::{Parser, Subcommand};
+use identity::IdentityCommandError;
 use snafu::Snafu;
 
 mod build;
+mod identity;
 mod network;
 
 #[derive(Parser, Debug)]
-pub struct Cli {
+pub struct Cmd {
     #[command(subcommand)]
     subcommand: Subcmd,
 }
 
 #[derive(Subcommand, Debug)]
 pub enum Subcmd {
     Build(build::Cmd),
-    Network(network::Cmd),
+    Identity(identity::IdentityCmd),
+    Network(network::NetworkCmd),
 }
 
-pub async fn dispatch(cli: Cli) -> Result<(), DispatchError> {
+pub async fn dispatch(env: &Env, cli: Cmd) -> Result<(), DispatchError> {
     match cli.subcommand {
         Subcmd::Build(opts) => build::exec(opts).await?,
-        Subcmd::Network(opts) => network::dispatch(opts).await?,
+        Subcmd::Identity(opts) => identity::dispatch(env, opts).await?,
+        Subcmd::Network(opts) => network::dispatch(env, opts).await?,
     }
     Ok(())
 }
@@ -30,6 +37,9 @@ pub enum DispatchError {
     #[snafu(transparent)]
     Build { source: BuildCommandError },
 
+    #[snafu(transparent)]
+    Identity { source: IdentityCommandError },
+
     #[snafu(transparent)]
     Network { source: NetworkCommandError },
 }

bin/icp-cli/src/commands.rs

@@ -0,0 +1,55 @@
+use crate::env::Env;
+use clap::{Parser, Subcommand};
+use snafu::Snafu;
+
+mod default;
+mod import;
+mod list;
+mod new;
+mod principal;
+
+#[derive(Debug, Parser)]
+pub struct IdentityCmd {
+    #[command(subcommand)]
+    subcmd: IdentitySubcmd,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum IdentitySubcmd {
+    Default(default::DefaultCmd),
+    Import(import::ImportCmd),
+    List(list::ListCmd),
+    New(new::NewCmd),
+    Principal(principal::PrincipalCmd),
+}
+
+pub async fn dispatch(env: &Env, cmd: IdentityCmd) -> Result<(), IdentityCommandError> {
+    match cmd.subcmd {
+        IdentitySubcmd::Default(subcmd) => default::exec(env, subcmd)?,
+        IdentitySubcmd::Import(subcmd) => import::exec(env, subcmd)?,
+        IdentitySubcmd::List(subcmd) => list::exec(env, subcmd)?,
+        IdentitySubcmd::New(subcmd) => new::exec(env, subcmd)?,
+        IdentitySubcmd::Principal(subcmd) => principal::exec(env, subcmd)?,
+    }
+    Ok(())
+}
+
+#[derive(Debug, Snafu)]
+pub enum IdentityCommandError {
+    #[snafu(transparent)]
+    Default {
+        source: default::DefaultIdentityError,
+    },
+
+    #[snafu(transparent)]
+    List { source: list::ListKeysError },
+
+    #[snafu(transparent)]
+    Import { source: import::ImportCmdError },
+
+    #[snafu(transparent)]
+    New { source: new::NewIdentityError },
+
+    #[snafu(transparent)]
+    Principal { source: principal::PrincipalError },
+}

bin/icp-cli/src/commands/identity.rs

@@ -0,0 +1,35 @@
+use crate::env::Env;
+use clap::Parser;
+use icp_identity::manifest::{change_default_identity, load_identity_defaults, load_identity_list};
+use snafu::Snafu;
+
+#[derive(Debug, Parser)]
+pub struct DefaultCmd {
+    name: Option<String>,
+}
+
+pub fn exec(env: &Env, cmd: DefaultCmd) -> Result<(), DefaultIdentityError> {
+    let dirs = env.dirs();
+    if let Some(name) = cmd.name {
+        let list = load_identity_list(dirs)?;
+        change_default_identity(dirs, &list, &name)?;
+        println!("Set default identity to {name}");
+    } else {
+        let defaults = load_identity_defaults(dirs)?;
+        println!("{}", defaults.default);
+    }
+    Ok(())
+}
+
+#[derive(Debug, Snafu)]
+pub enum DefaultIdentityError {
+    #[snafu(transparent)]
+    ChangeDefault {
+        source: icp_identity::manifest::ChangeDefaultsError,
+    },
+
+    #[snafu(transparent)]
+    LoadList {
+        source: icp_identity::manifest::LoadIdentityManifestError,
+    },
+}