Metadata-Version: 2.4
Name: csds-cli
Version: 0.1.0
Summary: Command-line client for CSDS — the Crypto Scam Detection System token risk API
Project-URL: Homepage, https://csds.blockchainrangers.com
Project-URL: Documentation, https://csds.blockchainrangers.com/docs/
Author: Blockchain Rangers
License: MIT License
        
        Copyright (c) 2026 Blockchain Rangers
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: blockchain,bsc,crypto,ethereum,risk,rug-pull,scam-detection,security,solana,token
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Security
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: pyfiglet>=1.0
Requires-Dist: pyperclip>=1.8
Requires-Dist: textual>=0.79
Requires-Dist: tomli-w>=1.0
Requires-Dist: tomli>=2.0; python_version < '3.11'
Provides-Extra: dev
Requires-Dist: anyio[trio]; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: textual-dev>=1.5; extra == 'dev'
Description-Content-Type: text/markdown

# csds — Crypto Scam Detection System CLI

`csds` is the terminal app for **CSDS**, a blockchain token risk-analysis service that scores
tokens for scam / rug-pull indicators across Ethereum, BNB Smart Chain, and Solana.

It's a single, keyboard-driven, transcript-style app. Analysis is a **paid service**: you sign
in with your own API key and each check is billed against your account balance.

```text
  ____ ____  ____  ____
 / ___/ ___||  _ \/ ___|    crypto safety · token risk checks
| |   \___ \| | | \___ \
| |___ ___) | |_| |___) |   signed in ●   balance $7.10  ≈71 quick   ● localhost:5000
 \____|____/|____/|____/

> 0x6982508145…  ethereum · quick
● risk 26 / 100   SAFE
  ⎿ liquidity locked · ownership renounced · no honeypot detected
  ⎿ saved to history · just now   ^y copy   ^e export json
```

## Install

```bash
pip install csds-cli
```

Requires Python 3.10+. Then just run:

```bash
csds
```

## Getting started

1. **Create an API key** in the [dashboard](https://csds.blockchainrangers.com) → **API Keys**,
   and top up your balance (analysis is billed per check).
2. **Launch** `csds`. If you're not signed in, type `:login` and paste your key (or just paste
   the key on its own line).
3. **Check a token:** paste an address at the prompt and press **Enter**.

## Using the app

- **Address prompt** — paste/type a contract address, press **Enter** to analyze.
- **chain / depth** — inline selectors below the prompt. Press **Tab** to move between fields and
  **←/→** to change the value. Defaults are remembered.
- Results append to a scrolling **transcript** (risk score, level, flags, recommendation).

### Keys

| Key | Action |
|-----|--------|
| **Enter** | run the check (or a `:command`) |
| **Tab** | cycle between address / chain / depth |
| **←/→** | change the focused selector |
| **↑/↓** | recall previous addresses |
| **^y** | copy the last result's summary |
| **^e** | export the last result as JSON |
| **^q** | quit |

### Commands

Type these at the prompt:

| Command | Does |
|---------|------|
| `:login [key]` | sign in (prompts for the key if omitted) |
| `:logout` | sign out |
| `:history` | show recent checks |
| `:account` | show email + balance |
| `:export` | export the last result as JSON (to Downloads by default) |
| `:exportdir <path>` | choose where exports are saved |
| `:help` | show help |

> Keys and balance are **per-environment** — a key created on production only works on
> production, and likewise for local.

## Supported chains

Ethereum, BNB Smart Chain (`bsc`), and Solana are live. More are coming.

## Links

- Service & dashboard: https://csds.blockchainrangers.com
- Documentation: https://csds.blockchainrangers.com/docs/

## License

MIT — see [LICENSE](LICENSE).
