Metadata-Version: 2.4
Name: wraithwall-sdk
Version: 0.1.0
Summary: Official WraithWall HTTP API client SDK (preview) — separate from the wraithwall platform package
Author: WraithWall
License: MIT
Project-URL: Homepage, https://wraithwall.online/developers
Project-URL: Documentation, https://wraithwall.online/developers#/sdks
Project-URL: Repository, https://github.com/niffyhunt/wraithwall
Keywords: security,threat-intelligence,wraithwall,api,sdk
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0

# wraithwall-sdk (Python)

Official **HTTP API client** for [WraithWall](https://wraithwall.online/developers) — preview `0.1.0`.

> **Name note:** PyPI already has the **`wraithwall`** platform package. This client
> will publish as **`wraithwall-sdk`** so it does not collide. Import module:
> `wraithwall_sdk`.

## Install (from monorepo — not published yet)

```bash
pip install -e ./sdks/python
# after publish:
# pip install wraithwall-sdk
```

## Quick start

```python
import os
from wraithwall_sdk import WraithWallClient

client = WraithWallClient(
    api_key=os.environ["WRAITHWALL_API_KEY"],
    api_secret=os.environ["WRAITHWALL_API_SECRET"],
)

print(client.link_status())
print(client.scan_url("https://example.com"))
```

## Features

- `Authorization: Bearer key:secret` helper
- Typed errors (`AuthenticationError`, `RateLimitError`, `PaymentRequiredError`, …)
- Exponential backoff with jitter on `429` / `5xx`
- Offset/limit pagination helper
- Helpers: scan, intel, cowrie stats, webhooks

## Related published packages

| Package | Role | PyPI |
|---------|------|------|
| `wraithwall` | Platform / OSS distribution | [pypi.org/project/wraithwall](https://pypi.org/project/wraithwall/) |
| `ravenscan` | Engineering intelligence CLI (`raven`) | [pypi.org/project/ravenscan](https://pypi.org/project/ravenscan/) |
| `canary-kit` | Supply-chain canary tokens | [pypi.org/project/canary-kit](https://pypi.org/project/canary-kit/) |
| `honeypot-mitre` | Cowrie → MITRE mapping | [pypi.org/project/honeypot-mitre](https://pypi.org/project/honeypot-mitre/) |
| `dml-spec` | Deception Markup Language | **Not published yet** |
| `wraithwall-sdk` | This HTTP API client | **Building — publish later** |

## Status

Preview — keep building; **do not publish** until product is ready.
