Agent Layer

​

Принципы дизайна

​

Четыре агента

​

1. Accumulation Agent

• rwt_engine::vault_swap — ограничен swap’ами, где token_in ∈ {USDC} и token_out ∈ StrategyConfig.allowed_ot_mints
• Не может вызывать никакие другие инструкции vault

• RwtVault.total_invested_capital, .current_ot_positions
• StrategyConfig.allowed_ot_mints, .max_alloc_per_ot_bps, .max_total_ot_exposure_bps, .max_daily_swap_volume_usdc, .max_single_swap_volume_usdc, .max_slippage_bps, .allowed_swap_venues
• On-chain цены OT через состояния пулов DEX

• Какой OT приобрести сейчас — выбран для минимизации дистанции между текущей и целевой аллокацией, внутри разрешённого набора
• Сколько свопить — ограничено max_single_swap_volume_usdc и оставшимся бюджетом max_daily_swap_volume_usdc
• Через какую площадку маршрутизировать — выбирает пул с наименьшим slippage среди allowed_swap_venues
• Когда действовать — ждёт отклонения от цели, превышающее rebalance_deviation_bps

• Свопить на любой mint вне allowed_ot_mints
• Превысить лимит аллокации на OT
• Превысить дневной бюджет объёма
• Маршрутизировать через неодобренную площадку
• Трогать USDY, LP-позиции, распределение доходности или любые не-OT активы
• Менять любой параметр стратегии

AccumulationActionExecuted {
  agent: Pubkey,
  config_version: u64,
  target_ot: Pubkey,
  amount_in_usdc: u64,
  amount_out_ot: u64,
  venue: Pubkey,
  slippage_bps: u16,
  daily_volume_remaining: u64,
  target_allocation_before_bps: u16,
  target_allocation_after_bps: u16,
  timestamp: i64,
}

• Развёртывается через initialize_agent(role: Accumulation, keypair: new_agent_pk) — предложение governance
• Заменяется через rotate_agent(role: Accumulation, new_keypair: ...) — предложение governance, timelock 24ч
• Скомпрометированный агент: обнаруживается по аномальным событиям или обзору governance → активируется kill switch → ротация замены

​

2. Rebalancer Agent

• native_dex::grow_liquidity — расширение вправо при росте NAV
• native_dex::compress_liquidity — сжатие влево при уценке
• Не может вызывать никакие другие инструкции DEX

• RwtVault.nav_book_value
• PoolState.last_rebalance_nav_bin, .active_zone_lower, .active_bin_id
• BinArray для текущего распределения
• StrategyConfig.rebalance_deviation_bps, .rebalance_cooldown_secs, .geometric_density_r_bps, .max_active_zone_width

• Когда ребалансировка оправдана — порог отклонения пересечён И cooldown истёк
• Целевой bin детерминированно выведен из NAV
• Ширина активной зоны внутри максимума, заданного governance
• Направление — путь роста vs сжатия на основе знака отклонения

• Менять bin_step_bps или permanent_tail_floor_bin (это неизменяемое состояние пула)
• Трогать bin’ы ниже left_anchor_bin (permanent tail)
• Извлекать любые токены
• Действовать вне окна cooldown
• Превысить сконфигурированную ширину активной зоны

RebalanceExecuted {
  agent: Pubkey,
  config_version: u64,
  pool: Pubkey,
  path: GrowthPath | CompressionPath,
  old_nav_bin: i32,
  new_nav_bin: i32,
  nexus_usdc_pulled: u64,  // ноль для сжатия
  bins_affected: u32,
  timestamp: i64,
}

​

3. Yield Harvester Agent

• rwt_engine::claim_yield — забрать RWT из merkle tree Yield Distribution от имени vault
• Не может вызывать никакие другие инструкции vault

• Merkle-доказательства от off-chain publisher Yield Distribution
• StrategyConfig.yield_split (book_value_bps / arl_treasury_bps / nexus_bps)
• Правомочность claim из аккаунтов MerkleDistributor

• Когда забирать — обычно когда невостребованный баланс превышает порог, оправдывающий gas
• Батчинг — объединяет несколько ожидающих распределений в одной транзакции, когда возможно

• Менять распределение (это параметр governance)
• Перемещать RWT куда-либо, кроме назначений распределения
• Свопить забранные токены
• Пропустить распределение (попытка маршрутизировать в другое место отклоняется)

YieldHarvested {
  agent: Pubkey,
  config_version: u64,
  total_claimed_rwt: u64,
  to_book_value: u64,
  to_arl_treasury: u64,
  to_nexus: u64,
  split_version: u64,  // какая версия yield_split применилась
  timestamp: i64,
}

​

4. LP Manager Agent

• native_dex::nexus_deposit — принимать входящий USDC/RWT в аккумулятор Nexus
• native_dex::nexus_swap — свопить между токенами, которые держит Nexus (напр. USDC ↔ RWT для балансировки финансирования)
• native_dex::nexus_add_liquidity — предоставлять LP в не-мастер пулы
• native_dex::nexus_remove_liquidity — забирать LP, когда governance перераспределяет
• Не может вызывать никакие другие инструкции

• LiquidityNexus.usdc_balance, .rwt_balance, .lp_positions
• StrategyConfig.master_pool_funding_priority, .min_nexus_usdc_reserve_bps, .permanent_tail_refill_enabled
• Состояние конкретного пула

• Когда маршрутизировать USDC в Rebalancer (для grow_liquidity) vs. держать как резерв
• Какую стороннюю пару пополнить, если governance одобрил несколько
• Когда ребалансировать внутренний баланс USDC/RWT для операций Nexus

• Разворачивать ниже уровня min_nexus_usdc_reserve_bps
• Добавлять ликвидность в любой пул, не в whitelist governance
• Извлекать токены в любое место назначения, кроме Казначейства Areal (через nexus_claim_rewards)
• Вызывать grow_liquidity или compress_liquidity — это роль Rebalancer

NexusActionExecuted {
  agent: Pubkey,
  config_version: u64,
  action: Deposit | Swap | AddLiquidity | RemoveLiquidity,
  pool: Option<Pubkey>,
  usdc_delta: i128,  // знаковое
  rwt_delta: i128,
  reserve_after_bps: u16,
  timestamp: i64,
}

​

Анализ радиуса поражения

​

Идентичность агента и ротация

​

Идентичность

pub struct AgentRegistry {
    pub accumulation_agent: Pubkey,
    pub rebalancer_agent: Pubkey,
    pub yield_harvester_agent: Pubkey,
    pub lp_manager_agent: Pubkey,
    pub kill_switch_authority: Pubkey,  // отдельная — pause authority, Team Multisig
    pub rotation_history: Vec<RotationRecord>,  // последние N ротаций для аудита
    pub bump: u8,
}

​

Ротация

rotate_agent(role: AgentRole, new_keypair: Pubkey)
  вызывающий: authority (из прошедшего предложения futarchy)
  эффект: AgentRegistry.<role>_agent = new_keypair, эмитирует AgentRotated
  timelock: 24ч operational (агенты заменяемы без влияния на экосистему)
  аудит: rotation_history дополняется {old_key, new_key, proposal_id, ts}

1. Pause Authority (Team Multisig) активирует kill switch мгновенно
2. Предложение ротации отправляется через futarchy
3. Истекает 24ч timelock
4. Ротация применяется; деактивация kill switch запускает свой собственный 7-дневный timelock
5. Параллельный аудит охвата компрометации в окне деактивации

​

Паттерн взаимодействия

00:00  LP Manager депонирует входящий USDC от маршрутизации crank (доходность + выручка)
00:15  Yield Harvester батчит дневные merkle claim'ы → распределение применяется
01:00  Accumulation Agent оценивает отклонение; исполняет первый swap OT, если триггер
04:00  Rebalancer обнаруживает дрейф NAV > 1% → вызывает grow_liquidity
04:02  LP Manager пополняет резерв USDC Nexus из простаивающего баланса
...
23:00  Серия итоговых событий дня консолидируется в explorer

​

Что агенты НЕ будут делать

​

Резюме