{"id":21164844,"url":"https://github.com/chiefbiiko/falcon-cli","last_synced_at":"2025-03-14T16:35:31.078Z","repository":{"id":129104055,"uuid":"388486057","full_name":"chiefbiiko/falcon-cli","owner":"chiefbiiko","description":"post-quantum file sigs","archived":false,"fork":false,"pushed_at":"2021-10-02T06:42:34.000Z","size":78,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-21T09:48:55.080Z","etag":null,"topics":["cli","digital-signatures","post-quantum-cryptography"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chiefbiiko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-22T14:12:28.000Z","updated_at":"2024-02-01T05:54:18.000Z","dependencies_parsed_at":"2023-05-20T18:00:44.825Z","dependency_job_id":null,"html_url":"https://github.com/chiefbiiko/falcon-cli","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefbiiko%2Ffalcon-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefbiiko%2Ffalcon-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefbiiko%2Ffalcon-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefbiiko%2Ffalcon-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chiefbiiko","download_url":"https://codeload.github.com/chiefbiiko/falcon-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243611587,"owners_count":20319174,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","digital-signatures","post-quantum-cryptography"],"created_at":"2024-11-20T14:13:44.457Z","updated_at":"2025-03-14T16:35:31.061Z","avatar_url":"https://github.com/chiefbiiko.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# falcon-cli\n\n[![release](https://img.shields.io/github/v/release/chiefbiiko/falcon-cli?include_prereleases)](https://github.com/chiefbiiko/falcon-cli/releases/latest) [![GitHub license](https://img.shields.io/github/license/chiefbiiko/falcon-cli.svg)](https://github.com/chiefbiiko/falcon-cli/blob/main/LICENSE) [![stability-experimental](https://img.shields.io/badge/stability-experimental-orange.svg)](https://github.com/chiefbiiko/falcon-cli)\n\nCLI tool to sign and verify files with the post-quantum signature scheme [FALCON](https://falcon-sign.info/), a round 3 finalist for digital signature algorithms in NIST's post-quantum cryptography standardization competition\n\n## Installation\n\n**With `cargo`**\n\n``` bash\ncargo install --git https://github.com/chiefbiiko/falcon-cli#0.1.2\n```\n\nThe tool will come available on your command line as `falcon`\n\nTo install and compile successfully make sure you are at least using `rustc 1.55.0`\n\n**Or `curl`**\n\n``` bash\nrelease_url=https://github.com/chiefbiiko/falcon-cli/releases/download/v0.1.2/falcon-cli-v0.1.2-x86_64-unknown-linux-gnu.gz\n\ncurl -fsSL $release_url | gunzip \u003e /usr/local/bin/falcon\nchmod u+x /usr/local/bin/falcon\n```\n\nFind current prebuilds for Linux, and macOS ~~, Windows~~ on the [releases page](https://github.com/chiefbiiko/falcon-cli/releases/latest)\n\n## Usage\n\nIf not havin' generated a key pair yet (default location `~/.falcon-cli`) do it now\n\n```bash\nfalcon --keygen\n```\n\nA test file to roundtrip\n\n```bash\necho \"msg 2 sign safely post quantum\" \u003e ./file.txt\n```\n\nSignin' and openin' - here explcititely referencin' secret and public key with the `-s` and `-p` options respectively\n\n```bash\nfalcon -S -o ./signed.txt -s ~/.falcon-cli/secret.key ./file.txt\nfalcon -O -o ./opened.txt -p ~/.falcon-cli/public.key ./signed.txt\n```\n\nOutcome\n\n```bash\ncmp ./opened.txt ./file.txt\ncat ./opened.txt ./file.txt\n# msg 2 sign safely post quantum\n# msg 2 sign safely post quantum\n```\n\n## Docs\n\n```\nfalcon-cli 0.1.2\n\nchiefbiiko \u003chello@nugget.digital\u003e\n\nSign and verify files with the post-quantum signature scheme FALCON\n\nUSAGE:\n    falcon [FLAGS] [OPTIONS] [FILE]\n\nARGS:\n    \u003cFILE\u003e    Input file\n\nFLAGS:\n    -F, --force      Overwrites possibly existing key files\n    -h, --help       Print help information\n    -K, --keygen     Generates a fresh FALCON keypair\n    -O, --open       Verifies a file\n    -S, --sign       Signs a file\n    -V, --version    Print version information\n\nOPTIONS:\n    -d \u003cdegree\u003e                 512 or 1024; default 1024\n    -f \u003cfile\u003e                   Input file\n    -k \u003cpublic-key\u003e             Base64 public key\n    -o \u003coutput\u003e                 Output file\n    -p \u003cpublic-key-file\u003e        Public key file; default: ~/.falcon-cli/public.key\n    -s \u003csecret-key-file\u003e        Secret key file; default: ~/.falcon-cli/secret.key\n\nIf no input/output file(s) are given stdin/stdout are used for IO\n```\n\n## License\n\n[MIT](./LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchiefbiiko%2Ffalcon-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchiefbiiko%2Ffalcon-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchiefbiiko%2Ffalcon-cli/lists"}