{"record":{"id":"976af27d560cb859","repo":"linera-io/linera-protocol","slug":"no-wallet-found-at-please-initialize-a-wallet","errorCode":null,"errorMessage":"No wallet found at {}. Please initialize a wallet first, e.g. `linera wallet init --faucet <FAUCET_URL>` or `linera wallet init --genesis <PATH>`.","messagePattern":"No wallet found at (.+?)\\. Please initialize a wallet first, e\\.g\\. `linera wallet init --faucet <FAUCET_URL>` or `linera wallet init --genesis <PATH>`\\.","errorType":"validation","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"linera-service/src/cli/main.rs","lineNumber":2502,"sourceCode":"                    start_time.elapsed().as_millis()\n                );\n                Ok(0)\n            }\n            ProjectCommand::Test { path } => {\n                let start_time = Instant::now();\n                let path = path.clone().unwrap_or_else(|| env::current_dir().unwrap());\n                let project = Project::from_existing_project(&path)?;\n                project.test()?;\n                info!(\n                    \"Test project created in {} ms\",\n                    start_time.elapsed().as_millis()\n                );\n                Ok(0)\n            }\n            ProjectCommand::PublishAndCreate { .. } => {\n                let start_time = Instant::now();\n                let wallet_path = options.wallet_path()?;\n                ensure!(\n                    wallet_path.exists(),\n                    \"No wallet found at {}. \\\n                     Please initialize a wallet first, e.g. \\\n                     `linera wallet init --faucet <FAUCET_URL>` or \\\n                     `linera wallet init --genesis <PATH>`.\",\n                    wallet_path.display()\n                );\n                options.run_with_storage(Job(options.clone())).await??;\n                info!(\n                    \"Project published and created in {} ms\",\n                    start_time.elapsed().as_millis()\n                );\n                Ok(0)\n            }\n        },\n\n        ClientCommand::Keygen => {\n            let start_time = Instant::now();","sourceCodeStart":2484,"sourceCodeEnd":2520,"githubUrl":"https://github.com/linera-io/linera-protocol/blob/6c226ddcb332ef55118dc8d0aafbd093d5420899/linera-service/src/cli/main.rs#L2484-L2520","documentation":"`linera project publish-and-create` needs an existing wallet to know which chain to publish to. It resolves options.wallet_path() and fails with this message when that file does not exist, directing you to create a wallet first from a faucet or a genesis configuration.","triggerScenarios":"Running `linera project publish-and-create` on a machine with no wallet file at the resolved path (the default wallet location or a custom --wallet-path).","commonSituations":"Fresh machine or container; wrong --wallet-path (typo, or a relative path resolved from a different cwd); CI job missing the wallet-init step; LINERA_WALLET_HOME pointing elsewhere.","solutions":["Run `linera wallet init --faucet <FAUCET_URL>` or `linera wallet init --genesis <PATH>` first","Check you passed the right --wallet-path / LINERA_WALLET_HOME and that the file exists at that exact path","In CI, add wallet creation as a preceding step before publish-and-create"],"exampleFix":"# before\n$ linera project publish-and-create .\nerror: No wallet found at /home/me/.config/linera/wallet.json ...\n\n# after\n$ linera wallet init --faucet https://faucet.devnet.linera.net\n$ linera project publish-and-create .","handlingStrategy":"validation","validationCode":"let wallet_path = options.wallet_path()?;\nif !wallet_path.exists() {\n    eprintln!(\"No wallet at {} -- run: linera wallet init --faucet <URL>\", wallet_path.display());\n    std::process::exit(1);\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Standardize on an explicit --wallet-path in scripts","Make wallet initialization part of environment setup and CI","Confirm LINERA_WALLET_HOME before running publish commands"],"tags":["cli","wallet","project","publish","setup"],"backgroundTag":"wallet-not-initialized","analyzedSha":"6c226ddcb332ef55118dc8d0aafbd093d5420899","analyzedAt":"2026-08-22T22:49:09.787Z","schemaVersion":2},"datasetVersion":"2026-08-23T01:17:44.959Z"}