Metadata-Version: 2.4
Name: metaspn-tokens
Version: 0.1.1
Summary: Token resolution and promise registry core for MetaSPN
Author: MetaSPN Contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/MetaSPN/metaspn-tokens
Project-URL: Repository, https://github.com/MetaSPN/metaspn-tokens
Project-URL: Issues, https://github.com/MetaSPN/metaspn-tokens/issues
Keywords: metaspn,tokens,promises,registry,sqlite
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: metaspn-schemas
Requires-Dist: metaspn-entities
Requires-Dist: metaspn-store
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"

# metaspn-tokens

`metaspn-tokens` provides token entity resolution, promise registration, promise evaluation,
and token health feature extraction backed by SQLite.

## Highlights

- Deterministic promise IDs with duplicate rejection.
- Append-only promise evaluations.
- PromiseRegistry API for registration, retrieval, evaluation, and credibility summaries.
- Built-in token adapters for Solana RPC and Pump.fun style lookups.

## Quickstart

```python
from metaspn_tokens import PromiseRegistry

registry = PromiseRegistry()
registry.self_register_defaults(project_id="proj_towel")
promise = registry.register(
    project_id="proj_towel",
    token_symbol="$TOWEL",
    statement="Reach 10k holders",
    due_at="2026-12-31T00:00:00+00:00",
)
registry.evaluate(promise.promise_id, observed=False)
summary = registry.credibility_summary(project_id="proj_towel")
```
