Update README.md

Author: root28root

vesting/README.md

@@ -1,71 +1,68 @@
-# Vesting — linear time-based vesting (Aptos Move)
-
-**Модуль:** `Vesting::vesting`  
-**Статус:** компилируется; CI зелёный; есть юнит-тесты  
-**Юзкейсы:** эмиссия и разлок токенов по времени, тим-вестинг, инвест-расписания
-
----
-
-## Идея
-Простейший вестинг с **линейным разлоком** между `[start, end]`. Денежной логики тут нет — это **учётная модель**: всё считается во внутренних числовых балансах (u64), чтобы было легко интегрировать в реальный токен позже.
-
-Формула:
-vested(now) =
-0, if now <= start
-total, if now >= end
-floor(total * (now-start) / (end-start)), otherwise
-
-claimable(now) = vested(now) - already_claimed
-
-## Данные
-- `struct Schedule { ben: address, total: u64, start: u64, end: u64, claimed: u64, active: bool }`
-- `vector<Schedule>` — хранится под адресом админа (инициатора)
-- Внутренние «балансы» по адресам для демо-учёта: `view_balance(admin_addr, owner) -> u64`
-
----
-
-## Публичный API (entries)
-- `entry init(admin: &signer)`
-  - Однократная инициализация хранилища под `address_of(admin)`.
-
-- `entry create(admin: &signer, ben: address, total: u64, start: u64, end: u64)`
-  - Добавляет расписание. Первый созданный идёт под `id = 0`, далее по инкременту.
-  - Валидация времени: `start < end`.
-
-- `entry claim(ben: &signer, admin_addr: address, id: u64, now: u64)`
-  - Клеймит дельту `claimable(now)` для расписания `id` и увеличивает внутренний баланс бенефициара.
-  - Проверяет, что `ben` == назначенный бенефициар.
+# Vesting — linear token vesting (Aptos Move)
+
+Simple, gas-friendly linear vesting with on-chain accounting of claimed amounts.
+
+**Module:** `Vesting::vesting`  
+**Status:** compiles; CI green  
+**Use cases:** team/seed vesting, grants, OTC unlocks
+
+## Data model
+struct Schedule {
+beneficiary: address,
+total: u64,
+start: u64,
+end: u64,
+claimed: u64,
+}
+struct Balance { owner: address, amount: u64 }
+struct State { admin, schedules, balances, initialized }
+
+`vested_at(now)` = linear piecewise (0 → total).  
+`claimable_at(now)` = `vested_at - claimed` (floor math, no remainders).
+
+## Public API
+- `entry init(admin)` — one-time init under `address_of(admin)`.
+- `entry create(admin, beneficiary, total, start, end)` — append schedule.
+- `entry claim(ben, admin_addr, sched_id, now)` — claim to internal balance.
+- `view_balance(admin_addr, owner)` — read internal balance (for demos/tests).
+
+Errors:  
+`E_ALREADY_INIT=1, E_NOT_INIT=2, E_BAD_TIME=3, E_NOT_BENEFICIARY=4, E_BAD_ID=5, E_NOTHING_TO_CLAIM=6`.
+
+## Devnet
+- **Package address:** `0x225b...5278`
+- **Publish tx:** `0xedfb5d7e52...b62c2`
+- **Demo tx (entry_demo):** `0xc74e87de5f...b4f8`
+
+## Quick start
+```bash
+# publish (from your Aptos profile)
+aptos move publish --assume-yes
 
-- `fun view_balance(admin_addr: address, owner: address): u64`
-  - Возвращает внутренний «накопленный» баланс адреса в рамках хранилища `admin_addr`.
+# init
+aptos move run --function-id <PKG>::vesting::init
 
-> ⚠️ Денежные переводов нет — это осознанно. В реальном проекте сюда можно подвязать  `Coin`/трансфер NFT или экспортировать учтённую величину в другой модуль.
+# create schedule (total=100, [0..100]) for <PKG>
+aptos move run --function-id <PKG>::vesting::create \
+  --args address:<PKG> u64:100 u64:0 u64:100
 
----
+# claims at t=30,80,200
+aptos move run --function-id <PKG>::vesting::claim --args address:<PKG> u64:0 u64:30
+aptos move run --function-id <PKG>::vesting::claim --args address:<PKG> u64:0 u64:80
+aptos move run --function-id <PKG>::vesting::claim --args address:<PKG> u64:0 u64:200
 
-## Errors (major)
-- creation with an invalid time (e.g., `start >= end`)
-- labels non-beneficiary
-- accessing a non-existent schedule/uninitialized storage
+Inspect via REST
+REST="https://fullnode.devnet.aptoslabs.com"
+curl -s "$REST/v1/accounts/<PKG>/resource/<PKG>::vesting::State" | jq .
+curl -s "$REST/v1/accounts/<PKG>/resource/<PKG>::vesting::State" \
+  | jq -r '.data.schedules[] | {beneficiary,total,start,end,claimed}'
 
----
+Contacts
 
-## Unit tests (`tests/vesting_tests.move`)
-- **Линейный разлок**: последовательные клеймы увеличивают баланс до `total`.
-- **Bad time**: создание с неправильным временем падает.
-- **Wrong beneficiary**: клейм не тем адресом падает.
+Discord: @rootmhz_
 
----
+Telegram: @Nikolai_Rootmhz
 
-## Quick start (локально)
+Email: 007rootmhz@gmail.com
 
-```bash
-cd vesting
-aptos move compile
-aptos move test --filter .
-
-## Contacts
-- Discord: [@rootmhz_](https://discord.com/users/1047911417396875264)
-- Telegram: [@Nikolai_Rootmhz](https://t.me/Nikolai_Rootmhz)
-- Email: [007rootmhz@gmail.com](mailto:007rootmhz@gmail.com)
-- Hire me: [issue form](https://github.com/root28root/move-projects/issues/new?template=hire-me.yml)
+Hire me: issue form