Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Амана (أمانة) — слой доверия для экономики машин

Прототип 0.2. Три вещи, которых не хватает платежам между ИИ-агентами:

  1. Эскроу — деньги сделки заперты, пока работа не проверена.
  2. Репутация — публичная история сделок каждого агента.
  3. Разбор споров — арбитр перепроверяет работу и решает, куда открыть замок.

Как запустить

node amana/server.js

Открыть в браузере: http://localhost:4402 — и нажать «Запустить заново», чтобы посмотреть сценарий с начала. Все деньги тестовые (tUSDC), настоящие средства нигде не участвуют.

Новое в 0.2

  • Настоящий поток x402. Агенты-исполнители — это HTTP-услуги (POST /agents/malik/audit). Запрос без оплаты получает честный статус 402 Payment Required с прейскурантом; работа начинается только после квитанции эскроу в заголовке X-Amana-Deal. Именно так устроен стандарт x402, на котором строится индустрия.
  • Реестры в духе ERC-8004. Репутация разделена на IdentityRegistry (паспортный стол агентов) и ReputationRegistry (отзывы, привязанные к настоящим сделкам — нельзя хвалить или топить агента без сделки с ним).
  • 8 языков мира. Русский, English, 中文, हिन्दी, Español, العربية (справа налево), Français, Português. Сервер пишет журнал ключами, панель переводит сама; выбор запоминается.

Что показывает сценарий

  • Акт 1. Честная сделка — Айша вызывает услугу Малика, получает HTTP 402, вносит 10 tUSDC в эскроу, и после проверки замок открывается исполнителю.
  • Акт 2. Попытка обмана — Хитрец сдаёт фиктивный отчёт; проверка ловит подлог, арбитр возвращает деньги, проигранный спор остаётся в реестре.
  • Акт 3. Репутация решает — Айша сверяется с реестром и выбирает честного исполнителя, хотя мошенник предлагает дешевле.

Устройство

Файл Роль
lib/ledger.js «Тетрадь»: счета и переводы (в будущем — блокчейн Base + USDC)
lib/escrow.js Замок сделки: CREATED → FUNDED → DELIVERED → проверка → выплата/возврат
lib/registry.js Реестры идентичности и репутации (по образу ERC-8004)
lib/agents.js Агенты-исполнители как HTTP-услуги с ответом 402 (по образу x402)
lib/scenario.js Сценарий из трёх актов; журнал пишется ключами для перевода
server.js Сервер: сценарий, услуги агентов, панель наблюдения
public/translations.js Словари восьми языков
public/ Панель наблюдения (браузер)

Что здесь настоящее, а что — модель

Настоящее: логика эскроу, репутации и споров; HTTP-обмен по правилам x402; структура реестров по ERC-8004. Модель: «тетрадь» вместо блокчейна и агенты, играющие по сценарию. Деньги везде тестовые.

Смарт-контракты (amana/chain)

Версия 0.3: замок теперь может держать не сервер, а блокчейн.

Контракт Роль
contracts/AmanaEscrow.sol Эскроу: деньги заперты в контракте; принять / спор / вердикт арбитра
contracts/AmanaRegistry.sol Реестры идентичности и репутации (по ERC-8004); отзывы пишет только эскроу
contracts/TestUSDC.sol Тестовый доллар (ERC-20, 6 знаков, как USDC)

Команды (из папки amana/chain):

npx hardhat node          # локальный блокчейн (отдельное окно)
npm run scenario          # репетиция трёх актов на блокчейне
node scripts/security-check.js   # проверка замков: 9 атак должны быть отбиты
node scripts/gen-wallet.js       # кошелёк развёртывателя (.env)
npm run deploy:base-sepolia      # развёртывание в Base Sepolia (нужен тестовый ETH)

Амана в публичной сети Base Sepolia — свершилось 01.08.2026

Контракт Адрес
AmanaRegistry 0x5e145630a02EE805Af8e0f3379Fe6b5104FB2a44
TestUSDC 0xbF1328f688830eA3f5Bc32F91348C11AB14c0f05
AmanaEscrow 0x0291e0c165c67B65033FEc2220A31BFBC4e7d9c2

Первая живая сделка (эскроу → сдача → приёмка → выплата → репутация 100/100): транзакция закрытия.

Путь топлива: кран Google (Ethereum Sepolia) → OptimismPortal → Base Sepolia (scripts/bridge-to-base.js; мост L1StandardBridge отбивал простой перевод, портал нижнего уровня сработал).

V2 — честный арбитр (v0.5)

Контракты второй версии в публичной сети Base Sepolia:

Контракт Адрес
AmanaEscrowV2 0x8750ccB1bE59Ff0ffEB7E461e8c2751A878aCCC9
AmanaRegistryV2 0x9a23c0f28E20645d97C1b56a2028F4c7285213aC

Два шага к честности:

  • Автоприёмка. Для проверяемых задач заказчик кладёт в сделку отпечаток верного ответа; совпал — замок открывается сам, в той же транзакции. Живое доказательство: сдача и выплата одной транзакцией, без людей.
  • Панель арбитров. Споры решают трое голосованием (2 из 3); один арбитр в одиночку не может ничего. Проверено 16 сценариями (scripts/v2-check.js).

Дорожная карта

  • Шаг 1 — рабочий прототип: эскроу + репутация + спор
  • Шаг 2а — язык стандартов: поток x402 (HTTP 402) и реестры ERC-8004; 8 языков панели
  • Шаг 2б-1 — смарт-контракты Solidity: эскроу + реестры, репетиция и проверка атаками на локальном блокчейне
  • Шаг 2б-2 — развёртывание в публичной сети Base Sepolia + первая живая сделка
  • Шаг 3а — белая бумага (docs/whitepaper-ru.md, docs/whitepaper-en.md), лицензия MIT, git-репозиторий
  • v0.4 — панель подключена к живой сети: блок «Живая сеть · Base Sepolia» и кнопка настоящей сделки
  • Шаг 3б — публикация на GitHub (нужен аккаунт владельца)

About

Amana - trust layer for the machine economy: escrow + reputation + disputes for AI agent deals (Base Sepolia)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages