# Welcome to City Protocol?

City Protocol is building the foundational infrastructure that enables founders to spin the **Attention-Capital Flywheel for their audiences.** We provide a comprehensive suite of tools that enable projects to seamlessly connect **user acquisition, retention,** and **monetization**.

Our vision is to become the consumer finance infrastructure layer that provides all the required **Neofinance and Viral Growth Components** for the founders-and-developers landscape today.

> By offering a non-custodial, modular, and open-access infrastructure, City Protocol serves as the distribution layer that connects **vault operators, project founders, and everyday users** through shared on-chain infrastructure, especially in an AI-accelerated world **where everyone can be a founder.**

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><mark style="color:$primary;"><strong>Attention as a Service</strong></mark></td><td>Engineering viral growth through UGC</td><td><a href="/pages/06wjLxjR6dzXkgMEvrdx">/pages/06wjLxjR6dzXkgMEvrdx</a></td><td><a href="/files/lfcHarR4b3iudSVpTZt8">/files/lfcHarR4b3iudSVpTZt8</a></td></tr><tr><td><mark style="color:$primary;"><strong>Neofinance as a Service</strong></mark></td><td>Modular stack for all neo-finance services</td><td><a href="/pages/FSFYsj6uw421bmzFdhvx">/pages/FSFYsj6uw421bmzFdhvx</a></td><td><a href="/files/TXaMqMeBFaKde2r8itZb">/files/TXaMqMeBFaKde2r8itZb</a></td></tr></tbody></table>

***

### Why City Protocol

<table data-card-size="large" data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><mark style="color:$primary;"><strong>Non-Custodial</strong></mark><br>Retain full control over assets through smart contracts with audited risk boundaries</td></tr><tr><td><mark style="color:$primary;"><strong>Institutional-Grade</strong></mark><br>Standardized smart contract framework with transparent reporting</td></tr><tr><td><mark style="color:$primary;"><strong>Fully Modular</strong></mark><br>Covers modules across Vault, Yield, Swap, Payment, Lending, and KYC/AML</td></tr><tr><td><mark style="color:$primary;"><strong>Easy Integration</strong></mark><br>Works with apps, Web3 projects, and trading platforms via unified SDK/API</td></tr></tbody></table>

***

### How City Protocol Works

City Protocol is designed to simplify and optimize growth and capital flow for founders and applications through a dual-layered approach. Below is a high-level walkthrough of how City Protocol operates:

{% stepper %}
{% step %}

#### Attention Layer: Engineer Virality

The user-facing interface for measuring mindshare and distributing rewards:

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th></tr></thead><tbody><tr><td><p><mark style="color:$primary;"><strong>AIUGC Layer</strong></mark></p><p>AI-powered user-generated content that lowers the barrier to user-driven growth</p></td><td><a href="/pages/lkUwilxFv10VQkf69CD6">/pages/lkUwilxFv10VQkf69CD6</a></td></tr><tr><td><p><mark style="color:$primary;"><strong>Mindshare Arena</strong></mark></p><p>Information market tracking project mindshare via heatmaps and leaderboards</p></td><td><a href="/pages/h3YPDd2Sk0loyLw6CG9M">/pages/h3YPDd2Sk0loyLw6CG9M</a></td></tr><tr><td><p><mark style="color:$primary;"><strong>Reward Hub</strong></mark></p><p>UGC incentive platform where users follow, post, and engage to earn token bonuses</p></td><td><a href="/pages/C49l248uBDoXbbwvkToo">/pages/C49l248uBDoXbbwvkToo</a></td></tr></tbody></table>
{% endstep %}

{% step %}

#### Capital Layer: Deploy Neofinance Infrastructure

ERC-4626 compatible vaults with asynchronous subscriptions, NAV-based settlement, role-based permissions, and configurable fee logic.

**Six Core Modules:**

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:$primary;"><strong>Yield</strong></mark><br>Automated return generation via Gauntlet, Steakhouse, Superstate, and more</td><td><a href="/pages/ExITOYoOHJs2tCsrj0ob">/pages/ExITOYoOHJs2tCsrj0ob</a></td></tr><tr><td><mark style="color:$primary;"><strong>Swap</strong></mark><br>Best-execution routing via PancakeSwap, Aerodrome, Uniswap, Li.Fi</td><td><a href="/pages/j06MoLWaGrfR68XSVyTF">/pages/j06MoLWaGrfR68XSVyTF</a></td></tr><tr><td><mark style="color:$primary;"><strong>Payment</strong></mark><br>Fiat and crypto rails via Gnosis Pay, Zerohash, StraitsX, and AI-native OpenClaw integration</td><td><a href="/pages/DgGZcBo7b5iu1ZPqYNIh">/pages/DgGZcBo7b5iu1ZPqYNIh</a></td></tr><tr><td><mark style="color:$primary;"><strong>On/Off Ramp</strong></mark><br>Global fiat gateways via Moonpay, Ramp, Mercuryo, Metacomp</td><td><a href="/pages/K28smAlnxBY9H1rL0esh">/pages/K28smAlnxBY9H1rL0esh</a></td></tr><tr><td><mark style="color:$primary;"><strong>Lending/Borrowing</strong></mark> Deep liquidity via AAVE, Compound, Morpho, Maple</td><td><a href="/pages/zSyklSuaAala26g2kZhU">/pages/zSyklSuaAala26g2kZhU</a></td></tr><tr><td><mark style="color:$primary;"><strong>KYC/AML</strong></mark><br>Compliance via Persona, Veriff, Onfido, Comply Advantage</td><td><a href="/pages/M9aOjWKC17fenARKPmHQ">/pages/M9aOjWKC17fenARKPmHQ</a></td></tr></tbody></table>

{% endstep %}

{% step %}

#### Developer Access & Integration

<mark style="color:$primary;">**Unified SDK**</mark>\
The `@cityprotocol/core` package provides a TypeScript SDK that wraps complex multi-step transactions into simple asynchronous functions.

<mark style="color:$primary;">**Portfolio Client**</mark>\
Access indexed vault data, user transactions, and historical TVL snapshots through the `CityPortfolioClient` subgraph interface.

<mark style="color:$primary;">**Chain Abstraction**</mark>\
Users deposit from any supported EVM network and receive vault shares, while strategy execution occurs on the optimal chain.
{% endstep %}
{% endstepper %}

***

### Core Features

<table data-card-size="large" data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><mark style="color:$primary;"><strong>Modular Architecture</strong></mark><br>Developers pick and choose specific modules, from a simple swap interface to a complex yield-bearing vault with KYC gating.</td></tr><tr><td><mark style="color:$primary;"><strong>Attention-Capital Flywheel</strong></mark><br>The only neofinance platform that connects mindshare measurement directly to on-chain capital deployment.</td></tr><tr><td><mark style="color:$primary;"><strong>Institutional-Grade Security</strong></mark><br>Independent third-party NAV valuation, MPC/multisig approvals, separation of duties, and immutable on-chain reporting.</td></tr><tr><td><mark style="color:$primary;"><strong>Chain Abstraction</strong></mark><br>Unified user experience across L1 and L2 environments without fragmenting liquidity.</td></tr><tr><td><mark style="color:$primary;"><strong>AI-Native Payments</strong></mark><br>Integration with OpenClaw enables x402 standard payments, AI sub-accounts, and agent-driven commerce for the $5T projected AI-mediated transaction market.</td></tr><tr><td><mark style="color:$primary;"><strong>Transparent Fee Structure</strong></mark><br>All fees encoded directly in smart contracts and visible prior to deposit — eliminating information asymmetry.</td></tr></tbody></table>

***

### Integration Benefits

#### **Revenue Impact**

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><mark style="color:$primary;"><strong>Passive Income</strong></mark><br>Consistent yield generated through management fees, performance fees, and entry/exit fees, distributed automatically as shares at each settlement.</td></tr><tr><td><mark style="color:$primary;"><strong>User Growth</strong></mark><br>Higher retention through Viral City's engineered virality and the Reward Module's UGC incentives that convert passive holders into active contributors.</td></tr><tr><td><mark style="color:$primary;"><strong>Competitive Edge</strong></mark><br>Market leadership through a complete neofinance stack that would otherwise require individual connections to yield, swap, payment, vault, fiat ramps, lending, and KYC/AML.</td></tr></tbody></table>

#### **Technical Advantages**

<mark style="color:$primary;">**Performance**</mark>\
Asynchronous request-then-settle workflow ensures consistent pricing and reduces operational complexity at scale.

<mark style="color:$primary;">**Scalability**</mark>\
Built in Solidity, deployed on Base and all EVM-compatible chains with native cross-chain messaging.

<mark style="color:$primary;">**Security**</mark>\
Separation of duties between Vault Admin, Curator, Valuation Provider, and Whitelist Manager roles, reinforced by independent audits.

<mark style="color:$primary;">**Zero Custody Risk**</mark>\
City Protocol never takes custody of user funds. Assets are held exclusively in audited smart contracts with explicit risk parameters.

***

### Ready to Get Started?

<mark style="color:$primary;">**SDK Documentation**</mark>\
Explore the `@cityprotocol/core` reference covering vault creation, deposits, cooldowns, and portfolio queries.

<mark style="color:$primary;">**Quick Integration**</mark>\
Install via `bun add @cityprotocol/core viem` and instantiate a `CityClient` to start interacting with vaults.

<mark style="color:$primary;">**Developer Support**</mark>\
Join the developer community and get direct support from the City Protocol team.

<mark style="color:$primary;">**Ecosystem Access**</mark>\
Plug into mature integration partners across six core verticals, from AAVE and Uniswap to Moonpay and Persona, through a single interface.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://city-protocol.gitbook.io/docs/introduction/welcome-to-city-protocol.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.