{"id":47622415,"url":"https://github.com/bitcoiner-dev/zinc-cli","last_synced_at":"2026-04-01T22:22:20.751Z","repository":{"id":346021518,"uuid":"1188286867","full_name":"bitcoiner-dev/zinc-cli","owner":"bitcoiner-dev","description":"Agent-first Bitcoin + Ordinals CLI wallet with an account model: each account has a taproot ordinals address and a native segwit BTC payment address.","archived":false,"fork":false,"pushed_at":"2026-03-29T21:10:10.000Z","size":411,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-30T00:14:47.138Z","etag":null,"topics":["agent-first","bitcoin","ordinals","wallet"],"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/bitcoiner-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-21T21:43:18.000Z","updated_at":"2026-03-29T21:10:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bitcoiner-dev/zinc-cli","commit_stats":null,"previous_names":["bitcoiner-dev/zinc-cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/bitcoiner-dev/zinc-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoiner-dev%2Fzinc-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoiner-dev%2Fzinc-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoiner-dev%2Fzinc-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoiner-dev%2Fzinc-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitcoiner-dev","download_url":"https://codeload.github.com/bitcoiner-dev/zinc-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoiner-dev%2Fzinc-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["agent-first","bitcoin","ordinals","wallet"],"created_at":"2026-04-01T22:22:19.971Z","updated_at":"2026-04-01T22:22:20.742Z","avatar_url":"https://github.com/bitcoiner-dev.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/zinc-cli-logo.gif\" alt=\"zinc-cli logo\" width=\"260\" /\u003e\n\u003c/p\u003e\n\n# zinc-cli\n\n`zinc-cli` is an agent-first Bitcoin + Ordinals wallet CLI.\n\nIt uses an account-based model where each account has:\n- a taproot address for ordinals\n- a native segwit address for BTC payments\n\nDefault behavior is optimized for automation (`--agent` JSON envelopes).\nOptional interactive dashboard mode is available via `--features ui`.\n\n## Install\n\nCargo (available now):\n\n```bash\ncargo install zinc-wallet-cli\n```\n\nCargo with human dashboard/TUI:\n\n```bash\ncargo install zinc-wallet-cli --features ui\n```\n\nHomebrew (after tap is published):\n\n```bash\nbrew tap bitcoiner-dev/zinc-cli\nbrew install zinc-cli\n```\n\n## Agent Quick Start (60 seconds)\n\n```bash\nexport ZINC_WALLET_PASSWORD='your-wallet-password'\nzinc-cli wallet init --overwrite\nzinc-cli --agent wallet info\nzinc-cli --agent sync chain\nzinc-cli --agent sync ordinals\nzinc-cli --agent balance\n```\n\nExpected agent envelope:\n\n```json\n{\n  \"ok\": true,\n  \"schema_version\": \"1.0\",\n  \"command\": \"wallet info\"\n}\n```\n\n## Human Mode\n\nThe `ui` feature enables a basic terminal dashboard for humans that shows:\n- account balance\n- inscriptions\n- ordinals/payment addresses per account\n\nEven without `ui`, human command output can be tuned with:\n- `--thumb` to force thumbnail rendering on\n- `--no-thumb` to disable thumbnail rendering\n\nRun dashboard:\n\n```bash\nzinc-cli dashboard\n```\n\n## First 5 Minutes Demo\n\n```bash\n./demo/scripts/run_demo.sh\n./demo/scripts/benchmark.sh --runs 5\n```\n\nReports are written to `demo/artifacts/`.\n\n## What You Can Do\n\n- wallet lifecycle: `wallet init|import|info|reveal-mnemonic`\n- sync: `sync chain|ordinals`\n- addresses and balance: `address taproot|payment`, `balance`\n- transfers: `psbt create|analyze|sign|broadcast`\n- advanced offers (hidden from top-level help): `offer create|publish|discover|accept|submit-ord|list-ord`\n- accounts: `account list|use`\n- waits and tx: `wait tx-confirmed|balance`, `tx list`\n- operations: `snapshot save|restore|list`, `lock info|clear`, `doctor`\n\n## Docs\n\n- Usage guide: [USAGE.md](./USAGE.md)\n- Agent workflows: [AGENT_PLAYBOOKS.md](./AGENT_PLAYBOOKS.md)\n- Command contract: [COMMAND_CONTRACT_V1.md](./COMMAND_CONTRACT_V1.md)\n- JSON schemas: [SCHEMAS.md](./SCHEMAS.md)\n- Demo kit: [demo/README.md](./demo/README.md)\n- Reference clients: [examples/agent_client.py](./examples/agent_client.py), [examples/agent_client.ts](./examples/agent_client.ts)\n\n## Security Notes\n\n- Prefer `ZINC_WALLET_PASSWORD` (default password env) or `--password-stdin`.\n- Use `--password-env` only when you need a non-default env var name.\n- In `--agent` mode, mnemonic output is redacted unless `--reveal` is set.\n- See [SECURITY.md](./SECURITY.md).\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitcoiner-dev%2Fzinc-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitcoiner-dev%2Fzinc-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitcoiner-dev%2Fzinc-cli/lists"}