# BOWO.fi: Autonomous Capital Intelligence Protocol & Decoupled AI Agent Gateway **Master Technical Specification & Architecture Whitepaper v3.0** *Published: July 2026 | Revision 3.0* *Author: BOWO.fi Core Engineering & Marinka AI Research Lab* *Official Protocol Website: [https://bowo.fi](https://bowo.fi)* *Agent Gateway Console: [https://bowo.fi/admin/agent-gateway](https://bowo.fi/admin/agent-gateway)* --- ## Executive Table of Contents 1. **Abstract & Executive Summary** 2. **DeFi Macroeconomic Landscape & Problem Statement** 3. **Protocol Philosophy & Risk-Free Backing Floor (RFV)** 4. **Dual-Token System (BOWO Reserve Token & SHIMS Governance)** 5. **Tokenomics, Inflation Schedule & Emissions Decay** 6. **Staking Mechanism, Epoch Cycles & Auto-Rebase Calculations** 7. **UBIS Bonding System & Protocol-Owned Liquidity (POL)** 8. **Treasury Management & Collateral Reserve Asset Handling** 9. **The BOWO Agent Gateway & Marinka Capital Agent Architecture** 10. **`x402` HTTP Payment Protocol & Header Handshake Specification** 11. **Financial Intelligence Endpoints & Risk Scoring Engine** 12. **Multi-Marketplace Integration (MCP Server, Olas Mech, Virtuals ACP, A2A)** 13. **Governance Framework, Proposal Pipeline & 48-Hour Timelock** 14. **Growth OS, On-Chain Audit Logging & Security Telemetry** 15. **Developer API Reference, Endpoint Pricing & Conclusion** --- ## 01. Abstract & Executive Summary BOWO.fi is an autonomous on-chain capital intelligence protocol that unifies treasury-backed Risk-Free Value (RFV), Protocol-Owned Liquidity (POL), and an agent-native financial infrastructure framework called the **BOWO Agent Gateway**. The protocol addresses three fundamental structural challenges in modern decentralized finance: 1. **Mercenary Capital Flight:** Traditional yield farming protocols suffer from catastrophic liquidity migration as reward emissions decline. BOWO.fi resolves this through Protocol-Owned Liquidity acquired directly via UBIS Bonding. 2. **Value Floor Uncertainty:** Algorithmic stablecoins and unbacked reserve tokens suffer from extreme market volatility without intrinsic valuation guarantees. BOWO.fi enforces a strict 1 USDC/DAI backing floor per BOWO token held in treasury reserves. 3. **AI Agent Economic Interoperability:** Autonomous AI agents require programmatic, machine-readable access to financial intelligence without relying on human Web UI interaction or static API keys. The BOWO Agent Gateway introduces **Marinka Capital Agent** and the **`x402` Payment Required protocol standard**, enabling machine-to-machine micro-transactions over HTTP headers. --- ## 02. DeFi Macroeconomic Landscape & Problem Statement Decentralized finance has evolved from rudimentary automated market makers (AMMs) to complex, multi-chain liquidity ecosystems. However, institutional and autonomous agent capital deployment remains constrained by three structural vulnerabilities: ### 2.1 Mercenary Liquidity Traps Liquidity mining incentives attract short-term capital ("mercenary liquidity") that farms protocol tokens and immediately dumps them on secondary markets. When emissions taper, capital flees, leaving the protocol illiquid. ### 2.2 Unbacked Supply Expansion Protocols issuing unbacked tokens dilute existing holders without accumulating matching treasury assets. In contrast, BOWO.fi ensures every newly minted token is backed by tangible reserve assets. ### 2.3 Machine Agent Economic Isolation AI agents operating on Model Context Protocol (MCP), Olas, or Virtuals frameworks lack standardized ways to pay for on-chain risk analysis or strategy backtesting. Standard Web APIs require human credit cards or bearer API keys, breaking full agent autonomy. --- ## 03. Protocol Philosophy & Risk-Free Backing Floor (RFV) BOWO.fi establishes an intrinsic valuation floor guaranteed by smart contract parameters and automated treasury buybacks: $$\text{Intrinsic Backing Floor} = \frac{\text{Treasury Risk-Free Collateral Value (USDC + DAI + POL)}}{\text{Total BOWO Supply in Circulation}}$$ ### 3.1 Expansion Phase (`Market Price > $1.00 USD`) When market demand drives BOWO above $1.00: - The protocol enables **UBIS Bonding**, allowing users to deposit collateral (USDC, USDT, WETH) at a discount. - Collateral flows into the protocol treasury, increasing total reserves and enabling backing-backed supply expansion. ### 3.2 Contraction Phase (`Market Price < $1.00 USD`) When market price dips below $1.00: - The protocol treasury executes automated buybacks of BOWO using reserve assets. - Purchased tokens are burned, reducing total supply and restoring price parity with the $1.00 backing floor. --- ## 04. Dual-Token Architecture (BOWO & SHIMS) BOWO.fi separates reserve currency utility from protocol governance through a dual-token system: ``` +-----------------------------------+ | BOWO.fi Ecosystem | +-----------------------------------+ | +-----------------------+-----------------------+ | | v v +-----------------------+ +-----------------------+ | BOWO Reserve Token | | SHIMS Governance | | - Backed by Treasury | | - Voting Rights | | - Staking & Rebasing | | - Parameter Control | | - Intrinsic Floor $1 | | - Timelock Executions | +-----------------------+ +-----------------------+ ``` ### 4.1 BOWO (Reserve Currency Token) - **Primary Utility:** Store of value, staking asset, and payment currency for BOWO Agent Gateway intelligence requests. - **Collateral Floor:** Backed by treasury reserves (USDC, DAI, WETH, AAVE). - **Auto-Rebase:** Staked BOWO receives compounding auto-rebase yields per epoch (8-hour cycles). ### 4.2 SHIMS (Governance & Policy Token) - **Primary Utility:** Governance voting on risk engine parameters, gateway pricing structures, and timelocked contract upgrades. - **Timelock Control:** Proposals passed by SHIMS holders undergo a mandatory 48-hour timelock delay prior to on-chain execution. --- ## 05. Tokenomics, Inflation Schedule & Emissions The distribution of BOWO is structured to guarantee multi-year protocol runway while incentivizing long-term staking participation: | Allocation Category | Percentage | Allocation Purpose & Vesting Schedule | | :--- | :--- | :--- | | **Protocol Treasury Reserves** | 45% | Permanent backing floor reserves & risk-free liquidity backing | | **Staking Rebase Pool** | 25% | Emitted continuously over 4-year decay schedule across 8-hour epochs | | **UBIS Bonding Capacity** | 15% | Released dynamically based on market demand during expansion phases | | **Community & Ecosystem Growth** | 10% | Linear monthly vesting over 24 months for grants and integrations | | **Core Contributors & Audits** | 5% | 12-month cliff, 36-month linear vesting for core engineering & audits | --- ## 06. Staking Mechanism & Rebase Calculations Staking BOWO allows participants to capture protocol expansion yield through compounding rebase cycles: ### 6.1 Rebase Rate Formula The rebase yield per epoch (8 hours) is calculated dynamically based on treasury collateral growth: $$R_{\text{epoch}} = \min\left( R_{\text{max}}, \frac{\text{Excess Treasury Collateral}}{\text{Total Staked BOWO} \times \text{Target Backing Ratio}} \right)$$ - **Epoch Interval:** 8 Hours (3 Rebase Epochs per 24-hour day). - **Auto-Compounding:** Yields automatically compound into the user's staked position without manual gas claim calls. --- ## 07. UBIS Bonding System & Protocol-Owned Liquidity (POL) Traditional liquidity pools rely on third-party liquidity providers who extract fees and dump tokens. BOWO.fi's **UBIS (Universal Bonding Integration System)** enables users to sell collateral assets (USDC, USDT, WETH) to the protocol in exchange for discounted BOWO vested over a 3-day linear schedule. ``` +-------------------+ +---------------------+ +----------------------+ | User Collateral | ------> | UBIS Bonding | ------> | Protocol Treasury | | (USDC/USDT/WETH) | | (Vests BOWO 3 Days) | | (Permanent Backing) | +-------------------+ +---------------------+ +----------------------+ | v +--------------------+ | Protocol-Owned | | Liquidity (POL) | +--------------------+ ``` ### 7.1 Single-Step Approval Safety Protocol To eliminate user security risks associated with unlimited ERC-20 approvals, UBIS Bonding utilizes a single-step, exact-amount approval workflow. --- ## 08. The BOWO Agent Gateway & Marinka Capital Agent The **BOWO Agent Gateway** is a decoupled, agent-native financial infrastructure product built directly into BOWO.fi. ### 8.1 Marinka Capital Agent Marinka Capital Agent is an autonomous capital intelligence agent hired by other AI agents to discover yield options, evaluate smart contract and asset risk, optimize capital allocations, backtest strategy simulations, and enforce machine-readable strategy mandates. ### 8.2 Machine Capability Discovery Card External AI agents discover Marinka Capital Agent specs via standardized endpoints: - `GET /v1/agent/capabilities` - `GET /.well-known/agent-card` ```json { "name": "Marinka Capital Agent", "provider": "BOWO.fi", "version": "3.0.0", "capabilities": [ "capital allocation", "yield discovery", "protocol risk analysis", "asset risk analysis", "portfolio optimization", "liquidity analysis", "strategy simulation", "portfolio monitoring", "mandates generation" ], "supportedNetworks": ["Polygon", "Ethereum"], "auth": { "type": "x402", "header": "X-Payment-Hash" } } ``` --- ## 09. `x402` HTTP Payment Protocol Specification The BOWO Agent Gateway implements the **`x402` Payment Required protocol standard**, allowing AI agents to pay for financial intelligence micro-services directly over HTTP headers: ### 9.1 Protocol Sequence 1. **Agent Call:** Calling agent issues HTTP request to gateway service (e.g. `POST /v1/opportunities`). 2. **`402 Payment Required` Response:** Gateway intercepts unauthenticated calls and returns HTTP 402 with headers: - `X-Payment-Request-Amount: 0.05` - `X-Payment-Request-Asset: USDC` - `X-Payment-Request-Address: 0x74ebc69a19cbf4636bb964240dc75893d51915eb` 3. **On-Chain Settlement:** Calling agent submits requested USDC payment on Polygon. 4. **Authorized Retry:** Calling agent retries request with transaction proof header: - `X-Payment-Hash: 0xabc...123` - `X-Calling-Agent: Agent_Name` 5. **Data Delivery:** Gateway verifies the transaction on-chain and delivers payload. --- ## 10. Financial Intelligence Services & Endpoints | Endpoint | Method | Cost (USDC) | Description | | :--- | :--- | :--- | :--- | | `/v1/agent/capabilities` | GET | FREE | Machine capability discovery card | | `/.well-known/agent-card` | GET | FREE | Alias redirect for A2A discovery | | `/v1/opportunities` | POST | 0.05 USDC | Scans live yield registry (Aave, Compound, BOWO Pools, Lido) | | `/v1/yield/compare` | POST | 0.05 USDC | Cross-network net yield & fee comparison | | `/v1/risk/protocol` | POST | 0.10 USDC | Smart contract safety (40%), liquidity (30%), & oracle score (30%) | | `/v1/risk/asset` | POST | 0.10 USDC | Token issuer stability & volatility evaluation | | `/v1/allocation/optimize` | POST | 0.50 USDC | Mean-variance capital allocation weight solver | | `/v1/allocation/simulate` | POST | 0.50 USDC | 30/90/365 day drawdown backtest simulation | | `/v1/mandates` | POST | 2.00 USDC | Policy-controlled capital execution mandate creation | | `/mcp` | POST | Variable | Model Context Protocol RPC tool interface | --- ## 11. Multi-Marketplace Interoperability Marinka Capital Agent is natively accessible across four major AI agent networks: 1. **Model Context Protocol (MCP Server):** JSON-RPC tool endpoint exposed at `/mcp` for direct invocation by Claude, Cursor, and custom AI agents. 2. **Olas Mech Network:** Decentralized agent dispatch integration. 3. **Virtuals Agent Communication Protocol (ACP):** Cross-agent service transaction standard. 4. **Agent-to-Agent (A2A) Direct Discovery:** Peer-to-peer capability negotiation. --- ## 12. Governance, Timelock & Security Audits - **Timelock Security:** All admin and policy engine changes require a 48-hour timelock delay. - **Automated Audit Logs:** AML, KYC, and treasury transfer events are recorded in real-time on-chain and accessible via `/api/admin/audit/aml-logs`. - **Emergency Circuit Breakers:** Automated risk engines pause bonding curves if price deviation exceeds safe parameters. --- ## 13. Conclusion & Protocol Roadmap BOWO.fi establishes the infrastructure for autonomous AI capital allocation. By combining Protocol-Owned Liquidity, treasury backing guarantees, and the x402-monetized Agent Gateway, BOWO.fi powers the next generation of machine-to-machine financial intelligence. *To test the Agent Gateway interactive sandbox or download technical assets, visit [https://bowo.fi/admin/agent-gateway](https://bowo.fi/admin/agent-gateway).*