156 lines
3.9 KiB
Markdown
156 lines
3.9 KiB
Markdown
# TIME_BANK — Код Банка Времени
|
||
|
||
**Версия:** 3.0
|
||
**Дата:** Январь 2026
|
||
|
||
---
|
||
|
||
## Философия
|
||
|
||
```
|
||
Montana = Организм
|
||
TIME_BANK = Орган верификации эмиссии монет времени
|
||
```
|
||
|
||
**TIME_BANK верифицирует:**
|
||
- Прошло ровно 10 минут (600 секунд)
|
||
- Участники присутствовали N секунд
|
||
- Применяет халвинг
|
||
- Подтверждает эмиссию
|
||
|
||
**TIME_BANK НЕ печатает** монеты из воздуха — он **подтверждает время**.
|
||
|
||
---
|
||
|
||
## Структура модулей
|
||
|
||
```
|
||
код/
|
||
├── protocol.py # Константы протокола
|
||
├── halving.py # Логика халвинга
|
||
├── temporal_coordinates.py # τ₁, τ₂, τ₃, τ₄
|
||
├── presence_cache.py # Кэш присутствия
|
||
├── presence_proof.py # ML-DSA-65 подписи
|
||
├── time_bank.py # Основной класс
|
||
└── README.md # Этот файл
|
||
```
|
||
|
||
---
|
||
|
||
## Использование
|
||
|
||
### Базовое использование
|
||
|
||
```python
|
||
from time_bank import get_time_bank
|
||
|
||
# Получить singleton TIME_BANK
|
||
bank = get_time_bank()
|
||
|
||
# Начать присутствие
|
||
bank.start(address="user_123", addr_type="telegram")
|
||
|
||
# Регистрировать активность
|
||
bank.activity(address="user_123")
|
||
|
||
# Завершить присутствие
|
||
bank.end(address="user_123")
|
||
|
||
# Проверить баланс
|
||
balance = bank.balance(address="user_123")
|
||
```
|
||
|
||
### Статистика
|
||
|
||
```python
|
||
stats = bank.stats()
|
||
|
||
print(f"τ₂ count: {stats['t2_count']}")
|
||
print(f"τ₃ count: {stats['tau3_count']}")
|
||
print(f"τ₄ count: {stats['tau4_count']}")
|
||
print(f"Халвинг: {stats['halving_coefficient']:.4f}x")
|
||
print(f"Год: {stats['current_year']}")
|
||
```
|
||
|
||
### Presence Proofs
|
||
|
||
```python
|
||
# Получить последние 10 proofs
|
||
proofs = bank.get_presence_proofs(limit=10)
|
||
|
||
for proof in proofs:
|
||
print(f"T2 #{proof['t2_index']}")
|
||
print(f"Hash: {proof['proof_hash'][:32]}...")
|
||
print(f"Active: {proof['active_addresses']} addresses")
|
||
```
|
||
|
||
---
|
||
|
||
## Интеграция с Montana
|
||
|
||
TIME_BANK работает как **отдельный орган**, но интегрирован с:
|
||
|
||
- **ML-DSA-65** — пост-квантовые подписи
|
||
- **MontanaDB** — хранилище балансов
|
||
- **3-Mirror** — синхронизация узлов
|
||
- **Юнона (бот)** — интерфейс пользователя
|
||
|
||
### Пример интеграции с ботом
|
||
|
||
```python
|
||
from time_bank import get_time_bank
|
||
|
||
bank = get_time_bank()
|
||
|
||
@bot.message_handler(commands=['start'])
|
||
async def start_presence(message):
|
||
user_id = str(message.from_user.id)
|
||
bank.start(user_id, "telegram")
|
||
await bot.reply("⏱️ Присутствие начато!")
|
||
|
||
@bot.message_handler(commands=['balance'])
|
||
async def show_balance(message):
|
||
user_id = str(message.from_user.id)
|
||
balance = bank.balance(user_id)
|
||
await bot.reply(f"💰 Баланс: {balance} Ɉ")
|
||
```
|
||
|
||
---
|
||
|
||
## Важные особенности
|
||
|
||
### 1. Динамическая эмиссия
|
||
|
||
```python
|
||
# Эмиссия зависит от участников
|
||
total_seconds = sum(user.seconds for user in users)
|
||
emission = total_seconds × halving_coefficient
|
||
```
|
||
|
||
### 2. Банк вычитает себя
|
||
|
||
```python
|
||
# Банк подтверждает 600 секунд
|
||
bank_seconds = 600
|
||
|
||
# Вычитает свои секунды
|
||
emission = (total + bank - bank) × halving
|
||
= total × halving
|
||
```
|
||
|
||
### 3. Халвинг каждые τ₄
|
||
|
||
```python
|
||
# τ₄ = 0: 1.0x
|
||
# τ₄ = 1: 0.5x (÷2)
|
||
# τ₄ = 2: 0.25x (÷2)
|
||
# τ₄ = 3: 0.125x (÷2)
|
||
```
|
||
|
||
---
|
||
|
||
## Лицензия
|
||
|
||
Montana Protocol v1.0
|
||
Copyright © 2026 Alejandro Montana
|