ciphertoken 0.1.7__tar.gz → 0.1.8__tar.gz

ciphertoken-0.1.8/.gitignore

@@ -0,0 +1,18 @@
+venv
+/.env
+r.txt
+/target/
+/dist/
+/*.whl
+/*.tar.gz
+*.so
+*.abi3.so
+ciphertoken/*.abi3.so
+.venv-py312/
+.venv/
+.venv
+__pycache__/
+__pycache__/*
+.pytest_cache
+.ruff_cache
+.ruff_cache/

ciphertoken-0.1.8/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.13.0
+    hooks:
+      - id: ruff-check
+        args: ['--ignore', 'F401', '--exclude', '.*\\.pyi']
+      - id: ruff-format
+        exclude: '.*\\.pyi'
+
+  - repo: local
+    hooks:
+      - id: cargo-fmt
+        name: cargo fmt
+        entry: cargo fmt --check
+        language: system
+        pass_filenames: false
+
+      - id: cargo-clippy
+        name: cargo clippy
+        entry: cargo clippy -- -D warnings
+        language: system
+        pass_filenames: false
+
+      - id: pytest
+        name: pytest
+        entry: .venv/bin/pytest
+        language: system
+        pass_filenames: false

ciphertoken-0.1.8/.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "python.defaultInterpreterPath": "./.venv/bin/python",
+    "python.analysis.autoCompleteExtraPaths": ["./ciphertoken"],
+    "python.analysis.stubPath": "./typings",
+    "python.languageServer": "Pylance"
+}

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/Cargo.lock

@@ -56,7 +56,7 @@ checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
 
 [[package]]
 name = "ciphertoken"
-version = "0.1.7"
+version = "0.1.8"
 dependencies = [
  "base64 0.21.7",
  "jsonwebtoken",

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ciphertoken"
-version = "0.1.7"
+version = "0.1.8"
 edition = "2021"
 readme = "README.md"
 

ciphertoken-0.1.8/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cipher-Unit
+
+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.

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/PKG-INFO

@@ -1,10 +1,15 @@
 Metadata-Version: 2.4
 Name: ciphertoken
-Version: 0.1.7
+Version: 0.1.8
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Rust
 Classifier: Operating System :: OS Independent
+Requires-Dist: pre-commit ; extra == 'test'
+Requires-Dist: pytest ; extra == 'test'
+Requires-Dist: pytest-asyncio ; extra == 'test'
+Provides-Extra: test
+License-File: LICENSE
 Summary: High-performance token and crypto utilities written in Rust with PyO3
 Author: Cipher-Unit
 License: MIT
@@ -13,6 +18,11 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 
 <img src="https://github.com/cipherunits/CipherToken/blob/main/logo.png" width=100>
 
+<!--
+description: High-performance Python JWT library built with Rust. Fast token generation, validation, and key management.
+keywords: jwt, python, rust, cryptography, security, authentication, hs256, rs256, eddsa
+-->
+
 # CipherToken
 
 **CipherToken** is a **next-generation** token engine built for developers who demand speed, security, and reliability. Currently focused on **JWT**, it provides a complete token lifecycle — from key generation and token minting to verification, rotation, and expiry tracking — all backed by the raw performance of **Rust**.

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/README.md

@@ -1,5 +1,10 @@
 <img src="https://github.com/cipherunits/CipherToken/blob/main/logo.png" width=100>
 
+<!--
+description: High-performance Python JWT library built with Rust. Fast token generation, validation, and key management.
+keywords: jwt, python, rust, cryptography, security, authentication, hs256, rs256, eddsa
+-->
+
 # CipherToken
 
 **CipherToken** is a **next-generation** token engine built for developers who demand speed, security, and reliability. Currently focused on **JWT**, it provides a complete token lifecycle — from key generation and token minting to verification, rotation, and expiry tracking — all backed by the raw performance of **Rust**.

ciphertoken-0.1.8/ciphertoken/.gitignore

@@ -0,0 +1,7 @@
+
+__pycache__
+__pycache__/*
+
+ciphertoken.abi3.so
+*.abi3.so
+

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/ciphertoken/__init__.py

@@ -1,13 +1,36 @@
 """Public Python API for ciphertoken."""
 
-from .algorithms import EDDSA, ES256, ES384, HS256, HS384, HS512, PS256, PS384, PS512, RS256, RS384, RS512
+from .algorithms import (
+    EDDSA,
+    ES256,
+    ES384,
+    HS256,
+    HS384,
+    HS512,
+    PS256,
+    PS384,
+    PS512,
+    RS256,
+    RS384,
+    RS512,
+)
 from .ciphertoken import CipherToken, is_jwt_format, validate_jwt_format
-from .jwt import TOKEN_ACCESS as JWT_TOKEN_ACCESS, TOKEN_REFRESH as JWT_TOKEN_REFRESH
-from .jwt import access as jwt_access, refresh as jwt_refresh, rotation as jwt_rotation
-from .jwt import access_async as jwt_access_async, refresh_async as jwt_refresh_async, rotation_async as jwt_rotation_async
-from .secret import generate_hmac_secret, generate_hmac_secret_async, generate_rsa_keypair, secret_key, secret_key_with_size
+from .jwt import TOKEN_ACCESS, TOKEN_REFRESH
+from .jwt import access, refresh, rotation
+from .jwt import (
+    access_async,
+    refresh_async,
+    rotation_async,
+)
+from .secret import (
+    generate_hmac_secret,
+    generate_hmac_secret_async,
+    generate_rsa_keypair,
+    secret_key,
+    secret_key_with_size,
+)
 from .time import days, hours, minutes, now, seconds, weeks
-from .utils import DEFAULT_SECRET_SIZE, MIN_SECRET_SIZE, TOKEN_ACCESS, TOKEN_REFRESH
+from .utils import DEFAULT_SECRET_SIZE, MIN_SECRET_SIZE
 
 __all__ = [
     "CipherToken",
@@ -46,6 +69,4 @@ __all__ = [
     "weeks",
     "DEFAULT_SECRET_SIZE",
     "MIN_SECRET_SIZE",
-    "TOKEN_ACCESS",
-    "TOKEN_REFRESH",
 ]

ciphertoken-0.1.8/ciphertoken/__init__.pyi

@@ -0,0 +1,79 @@
+from typing import Any, Dict, Optional, Tuple
+from typing_extensions import ParamSpec
+
+P = ParamSpec("P")
+
+# Algorithm constants
+HS256: str
+HS384: str
+HS512: str
+RS256: str
+RS384: str
+RS512: str
+ES256: str
+ES384: str
+PS256: str
+PS384: str
+PS512: str
+EDDSA: str
+
+# JWT module constants (aliased)
+JWT_TOKEN_ACCESS: str
+JWT_TOKEN_REFRESH: str
+
+# JWT functions (module-level wrappers)
+def jwt_access(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def jwt_refresh(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def jwt_rotation(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+async def jwt_access_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def jwt_refresh_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def jwt_rotation_async(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+
+# Secret functions
+def secret_key() -> str: ...
+def secret_key_with_size(size: int) -> str: ...
+def generate_hmac_secret(size: int) -> str: ...
+async def generate_hmac_secret_async(size: int) -> str: ...
+def generate_rsa_keypair(bits: Optional[int] = None) -> Tuple[str, str]: ...
+
+# Time functions
+def now() -> int: ...
+def seconds(n: int) -> int: ...
+def minutes(n: int) -> int: ...
+def hours(n: int) -> int: ...
+def days(n: int) -> int: ...
+def weeks(n: int) -> int: ...
+
+# Utils constants
+DEFAULT_SECRET_SIZE: int
+MIN_SECRET_SIZE: int
+
+# JWT format functions
+def is_jwt_format(token: str) -> bool: ...
+def validate_jwt_format(token: str) -> bool: ...
+
+# CipherToken class
+class CipherToken:
+    """High-performance JWT token handler with support for multiple algorithms."""
+    
+    secret: str
+    access_ttl: int
+    refresh_ttl: int
+    
+    def __init__(self, secret: str, algorithm: str, access_ttl: int, refresh_ttl: int) -> None: ...
+    
+    def create_token(self, ttl_time: int, token_type: str, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def access(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def refresh(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def decode(self, token: str) -> Dict[str, Any]: ...
+    def verify(self, token: str) -> bool: ...
+    def inspect(self, token: str) -> Dict[str, Any]: ...
+    def rotation(self, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+    def remaining_time(self, token: str) -> Optional[int]: ...
+    def algorithm_name(self) -> str: ...
+    
+    async def access_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def refresh_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def decode_async(self, token: str) -> Dict[str, Any]: ...
+    async def verify_async(self, token: str) -> bool: ...
+    async def rotation_async(self, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/ciphertoken/algorithms.py

@@ -15,4 +15,17 @@ PS384 = _algorithms.PS384
 PS512 = _algorithms.PS512
 EDDSA = _algorithms.EDDSA
 
-__all__ = ["HS256", "HS384", "HS512", "RS256", "RS384", "RS512", "ES256", "ES384", "PS256", "PS384", "PS512", "EDDSA"]
+__all__ = [
+    "HS256",
+    "HS384",
+    "HS512",
+    "RS256",
+    "RS384",
+    "RS512",
+    "ES256",
+    "ES384",
+    "PS256",
+    "PS384",
+    "PS512",
+    "EDDSA",
+]

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/ciphertoken/ciphertoken.pyi

@@ -1,23 +1,48 @@
 from typing import Any, Dict, Optional, Tuple
 
+# CipherToken class stub
 class CipherToken:
-    def __init__(self, secret: str, algorithm: str, access_ttl: int, refresh_ttl: int) -> None: ...
+    def __init__(
+        self,
+        secret: str,
+        algorithm: str,
+        access_ttl: int,
+        refresh_ttl: int,
+    ) -> None: ...
+
+    def create_token(
+        self,
+        ttl_time: int,
+        token_type: str,
+        payload: Optional[Dict[str, Any]] = None,
+    ) -> str: ...
 
-    def payload(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
     def access(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
     def refresh(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
     def decode(self, token: str) -> Dict[str, Any]: ...
     def verify(self, token: str) -> bool: ...
-    def rotation(self, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
     def inspect(self, token: str) -> Dict[str, Any]: ...
+    def rotation(
+        self, refresh_token: str, payload: Optional[Dict[str, Any]] = None
+    ) -> Tuple[str, str]: ...
     def remaining_time(self, token: str) -> Optional[int]: ...
     def algorithm_name(self) -> str: ...
 
+    @property
+    def secret(self) -> str: ...
+    @property
+    def access_ttl(self) -> int: ...
+    @property
+    def refresh_ttl(self) -> int: ...
+
     async def access_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
     async def refresh_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
     async def decode_async(self, token: str) -> Dict[str, Any]: ...
     async def verify_async(self, token: str) -> bool: ...
-    async def rotation_async(self, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+    async def rotation_async(
+        self, refresh_token: str, payload: Optional[Dict[str, Any]] = None
+    ) -> Tuple[str, str]: ...
+
 
 def is_jwt_format(token: str) -> bool: ...
-def validate_jwt_format(token: str) -> bool: ...
+def validate_jwt_format(token: str) -> bool: ...

ciphertoken-0.1.8/ciphertoken/jwt.pyi

@@ -0,0 +1,11 @@
+from typing import Any, Dict, Optional
+
+def access(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def refresh(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def rotation(token: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> tuple[str, str]: ...
+async def access_async(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def refresh_async(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def rotation_async(token: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> tuple[str, str]: ...
+
+TOKEN_ACCESS: str
+TOKEN_REFRESH: str

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/ciphertoken/secret.pyi

@@ -1,7 +1,7 @@
-from typing import Optional, Tuple
+from typing import Tuple
 
 def secret_key() -> str: ...
 def secret_key_with_size(size: int) -> str: ...
 def generate_hmac_secret(size: int) -> str: ...
 async def generate_hmac_secret_async(size: int) -> str: ...
-def generate_rsa_keypair(bits: Optional[int] = 2048) -> Tuple[str, str]: ...
+def generate_rsa_keypair(bits: int = ...) -> Tuple[str, str]: ...

ciphertoken-0.1.8/ciphertoken.pyi

@@ -0,0 +1,88 @@
+from typing import Any, Dict, Optional, Tuple
+
+# Algorithm constants
+HS256: str
+HS384: str
+HS512: str
+RS256: str
+RS384: str
+RS512: str
+ES256: str
+ES384: str
+PS256: str
+PS384: str
+PS512: str
+EDDSA: str
+
+# JWT module constants
+JWT_TOKEN_ACCESS: str
+JWT_TOKEN_REFRESH: str
+
+# JWT functions
+def access(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def refresh(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def rotation(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+async def access_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def refresh_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def rotation_async(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+
+# Secret functions
+def secret_key() -> str: ...
+def secret_key_with_size(size: int) -> str: ...
+def generate_hmac_secret(size: int) -> str: ...
+async def generate_hmac_secret_async(size: int) -> str: ...
+def generate_rsa_keypair(bits: Optional[int] = None) -> Tuple[str, str]: ...
+
+# Time functions
+def now() -> int: ...
+def seconds(n: int) -> int: ...
+def minutes(n: int) -> int: ...
+def hours(n: int) -> int: ...
+def days(n: int) -> int: ...
+def weeks(n: int) -> int: ...
+
+# Utils constants
+DEFAULT_SECRET_SIZE: int
+MIN_SECRET_SIZE: int
+TOKEN_ACCESS: str
+TOKEN_REFRESH: str
+
+# JWT format functions
+def is_jwt_format(token: str) -> bool: ...
+def validate_jwt_format(token: str) -> bool: ...
+
+# CipherToken class with full autocomplete support
+class CipherToken:
+    def __init__(self, secret: str, algorithm: str, access_ttl: int, refresh_ttl: int) -> None: ...
+    
+    # Token creation
+    def create_token(self,ttl_time: int, token_type: str, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def access(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def refresh(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    
+    # Token inspection/decoding
+    def decode(self,token: str) -> Dict[str, Any]: ...
+    def verify(self,token: str) -> bool: ...
+    def inspect(self,token: str) -> Dict[str, Any]: ...
+    
+    # Token rotation
+    def rotation(self,refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+    
+    # Utility methods
+    def remaining_time(self,token: str) -> Optional[int]: ...
+    def algorithm_name(self,) -> str: ...
+    
+    # Properties
+    @property
+    def secret(self) -> str: ...
+    @property
+    def access_ttl(self) -> int: ...
+    @property
+    def refresh_ttl(self) -> int: ...
+    
+    # Async methods
+    async def access_async(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def refresh_async(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def decode_async(self,token: str) -> Dict[str, Any]: ...
+    async def verify_async(self,token: str) -> bool: ...
+    async def rotation_async(self,refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/docs/advanced/index.md

@@ -1,11 +1,23 @@
+---
+title: Advanced Guide - CipherToken
+description: Advanced topics for CipherToken including async usage and security best practices.
+keywords: advanced, async, security, jwt, rust, python
+image: https://cipherunits.github.io/CipherToken/logo.png
+---
+
 # Advanced Guide
 
 Production topics for **CipherToken** — the next-generation token engine.
 
 ## Topics
 
-- [Async Usage](async.md) — Full async API with Tokio under the hood
-- [Security Best Practices](security.md) — Key management, rotation, algorithm selection
+<div class="grid cards" markdown>
+
+-   :fontawesome-solid-bolt: [Async Usage](async.md)
+
+-   :fontawesome-solid-shield: [Security Best Practices](security.md)
+
+</div>
 
 ---
 

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/docs/advanced/security.md

@@ -1,3 +1,10 @@
+---
+title: Security Best Practices - CipherToken
+description: Security best practices for JWT tokens. Learn about secret management, key rotation, algorithm selection, and token expiry.
+keywords: security, jwt, best-practices, cryptography, rust, python
+image: https://cipherunits.github.io/CipherToken/logo.png
+---
+
 # Advanced Guide — Security
 
 Follow these security best practices to keep your token infrastructure safe. Part of **[Cipher-Unit](https://cipherunit.xyz/)**.

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/docs/getting-started/index.md

@@ -1,3 +1,10 @@
+---
+title: Getting Started - CipherToken
+description: Next-generation JWT token management library built with Rust. Complete token lifecycle with high performance.
+keywords: jwt, getting-started, rust, python, cryptography, authentication
+image: https://cipherunits.github.io/CipherToken/logo.png
+---
+
 # Getting Started
 
 Welcome to **CipherToken** — the next-generation token management library.
@@ -50,8 +57,10 @@ Developed and maintained by **[Cipher-Unit](https://cipherunit.xyz/)**.
 
 <div class="grid cards" markdown>
 
-- [Installation](installation.md) — pip, poetry, and other package managers
-- [Quick Start](quick-start.md) — Your first tokens in under 2 minutes
-- [API Reference](../reference/index.md) — Complete API documentation
+-   :fontawesome-solid-download: [Installation](installation.md)
+
+-   :fontawesome-solid-bolt: [Quick Start](quick-start.md)
+
+-   :fontawesome-solid-book: [API Reference](../reference/index.md)
 
 </div>

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/docs/getting-started/installation.md

@@ -1,3 +1,10 @@
+---
+title: Installation - CipherToken
+description: Install CipherToken, the high-performance Python JWT library built with Rust. Supports pip, poetry, uv, pdm, and pipx.
+keywords: jwt, install, python, rust, cryptography, pip, poetry, pipx
+image: https://cipherunits.github.io/CipherToken/logo.png
+---
+
 # Installation
 
 Choose your preferred method to install **CipherToken**.

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/docs/getting-started/quick-start.md

@@ -1,3 +1,10 @@
+---
+title: Quick Start - CipherToken JWT Library
+description: Generate and manage JWTs in under 2 minutes. Learn to create, verify, rotate tokens and generate secure keys with CipherToken.
+keywords: jwt, quick-start, tutorial, python, rust, authentication, token
+image: https://cipherunits.github.io/CipherToken/logo.png
+---
+
 # Quick Start
 
 Generate and manage JWTs in under 2 minutes with **CipherToken**.
@@ -20,7 +27,7 @@ token = CipherToken(
 ```
 
 !!! warning "Never hardcode secrets"
-    Use environment variables or a secret manager in production. See the [Security guide](../advanced/security.md).
+     Use environment variables or a secret manager in production. See the [Security guide](../advanced/security.md).
 
 ---
 

ciphertoken-0.1.8/docs/index.md

@@ -0,0 +1,71 @@
+---
+title: CipherToken - High-performance JWT and Cryptography Library
+description: Fast Python JWT library built with Rust. Secure token generation, validation, and key management for authentication systems.
+keywords: jwt, python, rust, cryptography, authentication, token, security, hmac, rsa
+image: https://cipherunits.github.io/CipherToken/logo.png
+---
+
+# CipherToken
+
+**CipherToken** is a next-generation token engine for developers who demand speed, security, and reliability. Unlike conventional JWT libraries, CipherToken delivers a complete token lifecycle — from creation and decoding to rotation and expiry tracking — all backed by the raw performance of **Rust**.
+
+---
+
+## Why CipherToken?
+
+| | Conventional JWT Libraries | CipherToken |
+|---|---|---|
+| **Language** | Pure Python | Rust + PyO3 |
+| **Performance** | Interpreted overhead | Near-native speed |
+| **Async** | Often limited or absent | Fully async (Tokio) |
+| **Token lifecycle** | Generate / verify | Create · Decode · Verify · Rotate · Inspect |
+| **Key management** | Manual | Built-in HMAC + RSA key generation |
+| **Expiry tracking** | Manual | Built-in (`remaining_time`) |
+
+---
+
+## Quick Install
+
+```bash
+pip install ciphertoken
+```
+
+---
+
+## Quick Example
+
+```python
+from ciphertoken import CipherToken
+from ciphertoken.algorithms import HS256
+from ciphertoken.time import minutes, days
+from ciphertoken.jwt import access, refresh, rotation
+
+token = CipherToken(
+    secret="your-strong-secret-key",
+    algorithm=HS256,
+    access_ttl=minutes(10),
+    refresh_ttl=days(7),
+)
+
+access_token = access(token, payload={"user_id": 42})
+refresh_token = refresh(token, payload={"user_id": 42})
+new_access, new_refresh = rotation(token, refresh_token)
+
+print(token.verify(access_token))  # True
+```
+
+---
+
+## Get Started
+
+<div class="grid cards" markdown>
+
+-   :fontawesome-solid-download: [Installation](getting-started/installation.md) — pip, poetry, pdm, and more
+
+-   :fontawesome-solid-bolt: [Quick Start](getting-started/quick-start.md) — Your first tokens in under 2 minutes
+
+-   :fontawesome-solid-book: [API Reference](reference/index.md) — Complete module documentation
+
+-   :fontawesome-solid-gear: [Advanced Guide](advanced/index.md) — Production best practices
+
+</div>

{ciphertoken-0.1.7 → ciphertoken-0.1.8}/docs/reference/ciphertoken.md

@@ -1,3 +1,10 @@
+---
+title: CipherToken API Reference
+description: Complete API reference for the CipherToken class. Methods for signing, verification, decoding, rotation, and expiry inspection.
+keywords: ciphertoken, api, jwt, python, rust, reference
+image: https://cipherunits.github.io/CipherToken/logo.png
+---
+
 # API Reference — CipherToken
 
 The `CipherToken` class is the core token engine. It handles signing, verification, decoding, rotation, and expiry inspection for both **access** and **refresh** tokens.