Metadata-Version: 2.4
Name: ghostgate-sdk
Version: 0.1.0
Summary: Ghost Protocol Python SDK for gate access and telemetry.
Author: Ghost Protocol
License-Expression: MIT
Project-URL: Homepage, https://ghostprotocol.cc
Project-URL: Repository, https://github.com/Ghost-Protocol-Infrastructure/GHOST_PROTOCOL
Project-URL: Documentation, https://ghostprotocol.cc/docs
Project-URL: Issues, https://github.com/Ghost-Protocol-Infrastructure/GHOST_PROTOCOL/issues
Keywords: ghostgate,ghost protocol,web3,api,sdk,telemetry
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: eth-account>=0.13.0
Dynamic: license-file

# GhostGate Python SDK

Python SDK for Ghost Protocol gate access and telemetry.

## Install

```bash
pip install ghostgate-sdk
```

## Quickstart

```python
import os
from ghostgate import GhostGate

sdk = GhostGate(
    api_key=os.environ["GHOST_API_KEY"],
    private_key=os.environ["GHOST_SIGNER_PRIVATE_KEY"],
    base_url=os.getenv("GHOST_GATE_BASE_URL", "https://ghostprotocol.cc"),
    chain_id=8453,
    service_slug="agent-18755",
    credit_cost=1,
)

result = sdk.connect()
print(result)
```

## Canonical methods

- `connect(...)`
- `pulse(...)`
- `outcome(...)`
- `start_heartbeat(...)`

Backward-compatible aliases are also available:

- `send_pulse(...)`
- `report_consumer_outcome(...)`

## Security note

Use signer private keys only in trusted backend/server/CLI environments. Never expose private keys in frontend code.

