🛡️ PPT - Smart Token Market Router

💰 Manager Contract Balances

🏦 Executor Balances (harvestable)

💵 USDC Dampener V3.1

💎 ETH Dampener V5

⚙️ Update Caps (Owner Only)

Default target: BOTH (50/50) USDC Dampener only ETH Dampener only BOTH (50/50) USDC Dampener only ETH Dampener only Set Target

💡 Deposited PC becomes sell inventory for the dampeners. The flywheel: harvest → buy PC → deposit → dampener sells into pumps → repeat.

🛡️ The Three Lines of Defense

PPT protects $PC price through three automated systems that work together:

1. Dampeners (USDC V3.1 + ETH V5) — Sell Into Pumps

When PC price rises above the trigger ($center + heat band), the dampener sells PC from its inventory into the pool, absorbing buy pressure and accumulating USDC/WETH. This prevents unsustainable price spikes.

• Center price: The target equilibrium (currently $45)
• Heat band: How far above center before selling kicks in (currently 5% = trigger at $47.25)
• Gap close (ETH only): When PC/USDC and PC/ETH pools diverge >0.5%, sells PC into the expensive pool to equalize

2. Nudge — Buy Support During Quiet Periods

When the market goes quiet (no sells for 1-2 hours), the keeper uses accumulated USDC/WETH to buy PC back, gently pushing price up. This creates a sustainable cycle:

Pump → Sell PC → Earn USDC/WETH → Quiet period → Buy PC back → Price support → Repeat

• SafeMax ceiling: Nudge won't buy if price is already near the sell trigger — prevents pushing into the sell zone
• Fixed-size buys: Each nudge buys up to the max amount (25 USDC / 0.01 WETH), same size every time
• Cooldown: Minimum 1 hour between nudges
• Self-sustaining: The USDC/WETH earned from dampener sells funds the nudge buys

3. ETH Tracker Vault — Correlation Ratchet

Tracks ETH/USD price movements independently from PC price. When ETH moves significantly, the tracker adjusts PC's position to maintain correlation:

• ETH pumps ≥ 0.83%: Sells PC (80% of the move), because ETH rising means PC should follow via natural arb
• ETH drops ≥ 0.83%: Buys PC (20% of the move), providing support during ETH weakness
• Anchor auto-ratchets: After each trade, the anchor updates to current ETH/USD — so it only fires on NEW moves

🚨 Black Swan Pyramid (Escalating Buy Support)

If ETH drops hard, the tracker escalates its buy aggressiveness through 4 tiers:

ETH Drop	Buy %	Max Trade	Response
Normal (≥0.83%)	20%	0.15% of pool	Gentle support
≥5%	30%	0.20% of pool	Moderate support
≥10%	50%	0.30% of pool	Strong support
≥20%	70%	0.40% of pool	Heavy support
≥30%	90%	0.50% of pool	Maximum defense

⚡ Smart Token Market Router

Public-facing swap interface: buy or sell PC through USDC or ETH pools. The router automatically stabilizes price post-swap if it crosses the heat band — so large buys get absorbed without creating arb opportunities for bots.

Dual mode: Split buys/sells across both pools proportionally by TVL, minimizing slippage and price impact.

Why use this over Uniswap directly? Swapping through the router avoids overpaying — it caps your buy at the stabilization threshold, so you don't push price into bot territory and lose value to arbitrage.

🤖 Smart Token Router Automator V4

The Automator wraps both dampener executors behind a single contract, enabling one-click treasury operations and a closed-loop PC flywheel from the dashboard.

Architecture

Your Admin Wallet (owner)
    ↓ calls
SmartTokenRouterAutomatorV4 (0x0e34…c6e)
    ├── harvests from → USDC Executor V3.1
    ├── harvests from → ETH Dampener V5
    └── routes swaps via → TreasuryRouter V4
                            ├── PC/USDC Pool
                            └── PC/ETH Pool

What It Does

• Harvest: Pull accumulated USDC and WETH from the two dampener executors into one contract. The dampeners earn these from selling PC into pumps — the Automator collects the profits.
• Deposit PC: Send accumulated PC back into the dampener contracts to refuel their sell inventory. Supports targeted deposit to USDC-side, ETH-side, or 50/50 split (default). Owner can change the default target.
• Swap: Buy or sell PC using the harvested USDC/WETH. Routes through the TreasuryRouter so dampener stabilization still fires automatically. Supports single-pool or dual-pool atomic swaps.
• Withdraw: Pull any token (USDC, WETH, PC) from the Automator to your wallet, or sweep everything at once.

Typical Workflow

1. Harvest Both — pulls USDC from V3.1 + WETH from V5 into the Automator (capped, separate cooldowns)
2. Deposit PC — sends accumulated PC back to dampeners (default 50/50 split, configurable)
3. Dual Buy PC — uses both USDC and WETH to buy PC across both pools atomically
4. Wait — PC price rises naturally or via nudge, dampeners sell again, accumulating more USDC/WETH
5. Repeat — harvest → buy → wait → harvest (closed-loop flywheel)

Dampeners sell PC → Earn USDC/WETH → Harvest → Buy PC back cheaper → Dampeners sell again → Repeat

Security

• Owner-only: Only the admin wallet (0xF60f...8F58) can call any function
• Additive roles: The Automator needs DEFAULT_ADMIN_ROLE on both dampeners to harvest, but your admin wallet keeps its existing role — you can still withdraw directly from the dampeners anytime
• No custody risk: Funds sit in the Automator (not a third party). You can sweep everything to your wallet with one click.
• Closed-loop flywheel: Harvest → Buy PC → Deposit to dampeners → Dampeners sell into pumps → Repeat. The PC deposit feature (V3) closes the loop.
• Reentrancy protected: All state-changing functions use OpenZeppelin's ReentrancyGuard

● Dampener — sell into pumps ● Nudge — buy support ● Automator — flywheel buy ● ETH Tracker — correlation ratchet

83 commits · 9 days · 11 contract deployments · May 12-20, 2026

📅 Day 1 - May 12: Foundation

Solidity contracts, test suite, first mainnet deployment.

• Initial HeatDampener V1 - reference Solidity + Foundry setup
• Full test suite: 4 sanity + 18 must-revert tests (all passing)
• Keeper bot - standalone Node.js, PM2 managed, structured logging
• ETH mainnet deployment - TWAP oracle, deploy script, Flashbots keeper
• Role management: deployer → temp admin → transfer → renounce

Deployed: V1 Executor 0x45Cd...505E1b · TWAP Oracle 0x9D01...39c

📅 Day 2 - May 13: V2 → V3 + ETH Side

Rapid iteration - executor redesign, ETH pool support, admin dashboard.

• ExecutorV2 - removed external vault, USDC stays in contract
• Nudge buy-back - recycles USDC into gentle price support during quiet periods
• V3 Autonomous Executor - merged sell + nudge into one contract
• Randomized sell delay (2-10 min) to prevent timing prediction
• v1.5 ETH-side dampener - full build with TWAP
• ETHSideDampenerV4 - spot-only, USD floor, no TWAP
• Admin frontend panel - withdraw, pause, oracle update

Deployed: V2 0x441D...192A4b · V3 USDC 0xa682...227272 · ETH V3 0xf790...C513 · ETH V4 0x1811...cEB

📅 Day 3 - May 14: Treasury Router + 0% Slippage

On-chain router for atomic swap+dampener. Slippage innovation.

• TreasuryRouter - atomic swap + dampener in one TX
• grantRole buttons in admin panel + client-side dampener estimates
• 0% slippage - exact quote or revert. Sandwich attackers pay LP fees, making MEV unprofitable
• Keeper auto-size gap close + removed TWAP pre-check

📅 Day 4 - May 15: V3.1 + Tracker Vault + Dashboard

TWAP fully removed. ETH correlation tracking. Major dashboard overhaul.

• V3.1 USDC Executor - pure spot-based, zero warm-up, zero snapshot gas
• ETHTrackerVault - asymmetric ratchet for ETH/USD correlation dampening
• Black Swan Pyramid: escalating buy tiers (20%→90%) as ETH drops increase
• Tracker vault deposit cards (PC + WETH with wrap helper)
• Treasury router UX - wallet balance cap + bidirectional rates
• 3-tab dashboard layout (after multiple layout attempts + reverts)
• MAX buttons + unwrap WETH + dampener preview with POST-SWAP price
• Comprehensive README + operating guide updates

Deployed: USDC V3.1 0xE6E6...832C · ETH V5 0xEfA5...46a7 · Tracker 0x0401...2ED0 · Router V3 0xe5dD...0A

📅 Days 5-6 - May 18: Arb Advisory + Oscillator Research

Cross-pool arbitrage analysis. Oscillator keeper experiments on mainnet.

• Arb threshold advisory panel - shows when cross-pool divergence creates arb opportunity
• Correct arb P&L accounting for 100% LP owner
• Treasury UI warns about GAP_OVERSHOOT before execution
• Oscillator experiments: buy→sell profit cycle testing (Phase A/B, documented)

📅 Day 7 - May 19: Dual Pool Ops + Public Launch

Buy/sell across both pools. Admin/public separation. Production deploy.

• Binary-search closeGap to prevent GAP_OVERSHOOT
• Dual buy mode - buy both pools atomically, auto-fill by TVL ratio
• Dual sell mode - split PC across pools with auto-quote
• Post-TX breakdown panel with etherscan links
• Tracker vault integrated into keeper-dual
• Admin parameter panel on dashboard
• "How It Works" documentation section
• Access control: admin-only everything except Smart Token Market Router
• MAX buttons for dual buy/sell + red over-balance warning
• Full system audit + production deploy

📅 Day 8 - May 20: TreasuryRouter V4

Atomic single-TX dual operations.

• TreasuryRouter V4 - native dualBuyPC / dualSellPC functions
• Both pools in one atomic TX - if either leg fails, everything reverts
• Replaced 2-leg sequential approach with single contract call

Deployed: Router V4 0x173E...8A53

📊 Contract Evolution

USDC Side

Version	Address	Status	Key Feature
V1	0x45Cd...505E1b	⛔ Drained	TWAP oracle, external vault
V2	0x441D...192A4b	⛔ Drained	No vault, USDC in contract
V3	0xa682...227272	⛔ Drained	Autonomous sell + nudge
V3.1	0xE6E6...832C	✅ Active	Pure spot, zero warm-up

ETH Side

Version	Address	Status	Key Feature
V3	0xf790...C513	⛔ Drained	TWAP-based
V4	0x1811...cEB	⛔ Drained	Spot + USD floor
V5	0xEfA5...46a7	✅ Active	GapClose + nudge + USD floor

Infrastructure

Contract	Address	Status
ETH Tracker Vault	0x0401...2ED0	✅ Active
Treasury Router V3	0xe5dD...0A	Superseded
Treasury Router V4	0x173E...8A53	✅ Active
TWAP Oracle	0x9D01...39c	Unused (V3.1+ spot-only)

83 commits · 9 active days · 11 contract deployments · 7 deprecated contracts