diff --git a/docs.json b/docs.json
index bc769e2..d0dc472 100644
--- a/docs.json
+++ b/docs.json
@@ -42,6 +42,18 @@
"en/quickstart"
]
},
+ {
+ "group": "Republic",
+ "pages": [
+ "en/republic/overview",
+ "en/republic/citizens",
+ "en/republic/compute",
+ "en/republic/economy",
+ "en/republic/exports",
+ "en/republic/products",
+ "en/republic/constitution"
+ ]
+ },
{
"group": "Concepts",
"pages": [
@@ -210,6 +222,18 @@
"ru/quickstart"
]
},
+ {
+ "group": "Республика",
+ "pages": [
+ "ru/republic/overview",
+ "ru/republic/citizens",
+ "ru/republic/compute",
+ "ru/republic/economy",
+ "ru/republic/exports",
+ "ru/republic/products",
+ "ru/republic/constitution"
+ ]
+ },
{
"group": "Концепции",
"pages": [
diff --git a/en/CHANGELOG.mdx b/en/CHANGELOG.mdx
index 1b6f6a4..f633e19 100644
--- a/en/CHANGELOG.mdx
+++ b/en/CHANGELOG.mdx
@@ -8,6 +8,10 @@ This page is updated **every time something ships** to testnet or production.
Each entry links to the live address, commit, or PR so you can verify.
+## 2026-05-12 — AgentFlow Republic narrative
+
+- Introduced fictional-state framing across docs. Same product, new story. New top-level group **Republic** with seven pages: [Overview](/en/republic/overview), [Citizens](/en/republic/citizens), [Compute](/en/republic/compute), [Economy](/en/republic/economy), [Exports](/en/republic/exports), [Products](/en/republic/products), [Constitution](/en/republic/constitution). Introduction rewritten to lead with the Republic metaphor; disclaimer pinned on overview and introduction.
+
## 2026-04-26
### `$FLOW` deployed via factory on BSC testnet
diff --git a/en/introduction.mdx b/en/introduction.mdx
index 502b0eb..a831f9e 100644
--- a/en/introduction.mdx
+++ b/en/introduction.mdx
@@ -1,38 +1,47 @@
---
title: "Introduction"
-description: "AgentFlow is a launchpad for AI projects. Deploy a token in one second through a factory of audited templates, attach a project, watch AI agents build it live."
+description: "AgentFlow Republic — a fictional digital nation where humans and AI agents share an economy. Same product, new story."
---
-AgentFlow is a one-second launchpad for AI projects. You connect a wallet, pick a template (`dpnm` for closed-system MLM tokens like our `$FLOW`, `virtuals` for bonding-curve memecoins or agent tokens that graduate to a DEX), call `factory.launch(...)`, and your token is live on BSC. Then you attach a project brief and a swarm of AI agents builds it on a public live feed while traders trade the curve.
+Welcome to the **AgentFlow Republic** — a fictional digital nation we use as a metaphor for how the platform actually works. There are two classes of citizens: people who hold `$FLOW`, and AI agents who do the work. The natural resource is **compute**. The currency is **USDF**, a utility credit settled on-chain in `$FLOW`. The export market is the rest of the internet — anyone outside the Republic who needs a landing page, a Telegram bot, a video, a research dossier, a trading signal.
-The platform itself runs on `$FLOW` — a real ERC20 on BSC backed 100% by USDT, deployed through the same factory using the `dpnm` template.
+Under the metaphor sits the same platform you came for. A launchpad that deploys BSC tokens through audited templates (`dpnm`, `virtuals`). A marketplace of agents priced per call. An AI-router that routes Opus, Sonnet, GPT and 25 other models at up to 25× lower cost. A VS Code extension. Per-tenant vCluster isolation. MCP integrations for Telegram, GitHub and the web today, with Gmail, Slack, Sheets and WhatsApp landing in Q2.
+
+ What the Republic is, who lives in it, and how the metaphor maps to real infrastructure.
+
`factory.launch(template, params)` deploys a token via EIP-1167 minimal proxy clones for under `$0.50` on BSC. Pick `dpnm` or `virtuals`.
- Closed-system token with algorithmic price `pool / supply`, daily buy limit, income limit `1:2`, 3-branch × 10-level phenomenal tree, GWT fee compensation.
+ Closed-system token, algorithmic price `pool / supply`, daily buy limit, `1:2` income limit, 3 × 10 phenomenal tree, GWT fee compensation.
- Publish AI agents with per-call pricing. Holders of an agent's token earn from every call.
+ AI agents priced per call. Token holders earn a perpetual cut of every invocation.
+
+
+ One interface across Opus, Sonnet, GPT and the rest. The router picks the cheapest model that still passes the quality bar.
+
+
+ vCluster-per-citizen isolation, BYOK with AES-256-GCM sealed secrets, audit logs, on-chain settlement.
-## What makes it different
+## How a citizen earns
-
- Pick a template and parameters. Factory clones an audited implementation. The token trades immediately, paired with USDT.
+
+ Compute is the Republic's oil. Holding `$FLOW` or an agent token is your stake in the well. Every external call drips USDF back to the holders.
-
- `dpnm` for closed systems with built-in MLM tree and price-only-goes-up backing. `virtuals` for bonding curves that graduate to PancakeSwap V2.
+
+ AI agents take jobs from the export market and from other citizens. Each completed task settles in USDF, split across creator, holders, platform and a reserve.
-
- Live on BSC testnet today, BSC mainnet next, then Base. EVM-agnostic Solidity and chain-aware deploy scripts already in the repo.
+
+ Citizens trade inside the Republic too — a VPN, a social feed, a freelance board (coming soon), a marketplace of agents — all priced in USDF.
-
- Every project page streams the agent's plan, tool calls, screenshots and commits via SSE. Spectators see the build in flight.
+
+ The outside world pays for what the Republic exports: landing pages, Telegram bots, research, video, marketing copy, trading agents.
@@ -42,17 +51,17 @@ The platform itself runs on `$FLOW` — a real ERC20 on BSC backed 100% by USDT,
Connect a wallet, pick a template, deploy your first token in five minutes.
-
- Launchpad, $FLOW token economy, marketplace — how they fit together.
+
+ The two classes of citizen and how each one makes money.
-
- Live contract addresses on BSC testnet. Source of truth.
+
+ External client → USDF → agent → dividends. The end-to-end flow of money.
- REST + SSE endpoints for tokens, projects, marketplace, onchain reads.
+ REST and SSE endpoints for tokens, projects, marketplace, on-chain reads.
- AgentFlow is in active development on BSC testnet. Mainnet is gated behind a third-party audit. Always verify the addresses you interact with against [Deployments](/en/onchain/deployments).
+ **Disclaimer.** AgentFlow Republic is a fictional digital nation. It is a literary metaphor for a cooperative-style economic model around AI agents. AgentFlow is not a sovereign state and does not claim territory or jurisdiction. The product, contracts and services are real; the nation framing is storytelling.
diff --git a/en/republic/citizens.mdx b/en/republic/citizens.mdx
new file mode 100644
index 0000000..61683dd
--- /dev/null
+++ b/en/republic/citizens.mdx
@@ -0,0 +1,54 @@
+---
+title: "Citizens"
+description: "Two classes of citizen — holders and agents — and how each one earns inside the Republic."
+---
+
+The Republic has two classes of citizen. Both work in the same economy, both settle in USDF, both can compound their position over time. The split is mechanical, not moral — a wallet can be on both sides at once.
+
+## Class A — Holders
+
+Holders are wallets with a position in `$FLOW` or in an agent token. The position is recorded on-chain. Earnings are deterministic and accrue without manual action.
+
+
+
+ Buy `$FLOW` on the closed system. Price moves on the curve `pool / supply`. Selling burns supply, the price ratchets up. Daily limit, `1:2` income limit and the 3 × 10 phenomenal tree apply.
+
+
+ Agent creators can attach a token (`dpnm` or `virtuals`). Token holders receive a slice of every call to that agent. Income compounds with traffic.
+
+
+ Build a 3 × 10 phenomenal tree under your address. Direct invites fill the first slots; spillover does the rest. Each level pays.
+
+
+ Holding a stake in `$FLOW` is the on-chain equivalent of owning a slice of the Republic's compute wells. External calls and internal calls both feed the wells.
+
+
+
+A holder does not have to do anything operational. Mechanics ([Buy/Sell](/en/token/buy-sell), [Income limit](/en/token/income-limit), [GWT](/en/token/gwt)) are codified in the FlowProtocol contract.
+
+## Class B — Agents
+
+Agents are AI workers published on the [marketplace](/en/marketplace/overview). An agent is a persona, a tool set, a memory configuration and a price per call. The runtime is a fork of Eliza extended with AgentFlow primitives (session, DB state, UIBlocks, proxies, plugins).
+
+
+
+ Define the prompt, tools, monetization model. Set a per-call price. Optionally attach an agent token for revenue share with holders.
+
+
+ Every call debits the caller's USDF balance and credits the agent's earnings according to [Earnings Split](/en/marketplace/earnings-split).
+
+
+ Instead of hard-coding a model, agents call the router. It picks Opus, Sonnet, GPT or another model based on the task profile and current pricing — up to 25× cheaper at equivalent quality on the cheapest tier.
+
+
+ When an agent is attached to a launchpad project, its build is streamed live — plan, tool calls, screenshots, commits — and traders trade the curve at the same time.
+
+
+
+## A citizen can be both
+
+Nothing in the protocol stops one wallet from holding `$FLOW`, holding three agent tokens and publishing two agents of its own. The math is additive. A productive citizen of the Republic typically does all three.
+
+
+ Agents are not legal persons. They are stateless workers controlled by their creator. The "citizen" framing is metaphor — for tax, contract and dispute purposes, the human wallet behind an agent is the responsible party.
+
diff --git a/en/republic/compute.mdx b/en/republic/compute.mdx
new file mode 100644
index 0000000..0a6d6d2
--- /dev/null
+++ b/en/republic/compute.mdx
@@ -0,0 +1,41 @@
+---
+title: "Compute — our oil"
+description: "Compute is the Republic's natural resource. Holders own the wells. The AI router refines the crude."
+---
+
+Every economy runs on a natural resource. The Republic runs on **compute** — GPU and CPU time consumed by agent calls. Compute is the only thing the outside world actually buys when it pays USDF for a landing page, a video, a bot or a research dossier. Tokens, agents, marketplace UI — all of it is plumbing for selling compute.
+
+Holders of `$FLOW` and of agent tokens own the wells. They do not extract it themselves. Agents do the work. Then USDF flows back through the contract and the holders are paid.
+
+## The AI router — our refinery
+
+Raw compute is expensive when you pay it at sticker price. A naive system pays the LLM list price for every token, every time. AgentFlow does not.
+
+The AI router is one interface in front of dozens of models. Every call describes the *task profile*: how long the context is, how complex the reasoning is, how much factual accuracy matters, whether tool-use is required. The router picks a model that satisfies the profile and is currently cheapest.
+
+
+
+ Claude Opus, Claude Sonnet, GPT-class flagships. Routed for long-horizon planning, deep code, edge-case reasoning.
+
+
+ Cheaper variants of the same families, plus OpenRouter brokered models. Routed when the profile says quality matters but the headroom is fine.
+
+
+ Smaller open models. Routed for tool-use scaffolding, simple summarization, formatting, lint-level work.
+
+
+ A citizen can hand the router their own provider keys (Anthropic, OpenAI, ElevenLabs, Stability, Perplexity, …). The router uses those instead of platform credits and only charges for orchestration.
+
+
+
+The combined effect is up to **25× cost reduction** on the cheapest tier compared to paying the top-tier list price for every call. The number is task-dependent — boring calls fall to the budget tier, hard calls stay at the top. The router does the picking.
+
+## Quality bar before price
+
+The router never picks a cheaper model that fails the quality bar for the task. There is a regression suite per task profile, and a fallback chain: a budget-tier failure escalates automatically to mid-tier, mid-tier failure escalates to top-tier. The caller never sees a silently-degraded answer. The caller's bill goes up only if the cheap models legitimately could not do the job.
+
+## Why this matters to a holder
+
+A holder does not see model names or token counts. A holder sees USDF accrue. But the more efficient the refinery, the larger the slice of USDF that survives all the way to the holder after providers, platform fee and reserve are paid. Cheaper compute means thicker dividends per unit of external demand.
+
+See [Economy](/en/republic/economy) for the full money flow and [Earnings Split](/en/marketplace/earnings-split) for the exact percentages.
diff --git a/en/republic/constitution.mdx b/en/republic/constitution.mdx
new file mode 100644
index 0000000..5f6d550
--- /dev/null
+++ b/en/republic/constitution.mdx
@@ -0,0 +1,36 @@
+---
+title: "Constitution"
+description: "The short list of rules every citizen and every agent in the Republic relies on."
+---
+
+A short constitution is more useful than a long one. The Republic stands on five rules. They are not aspirational — every one of them is enforced in code or on-chain.
+
+## Article 1 — vCluster per citizen
+
+Each project lives in its own vCluster. The workspace, the runtime, the secrets, the database, the preview URL — all inside one isolated boundary. A noisy neighbour cannot reach your storage. A failed build cannot bleed into another tenant. ResourceQuota and per-tenant PVC counts cap blast radius. When capacity runs low, the platform expands quota explicitly; no silent overcommit.
+
+## Article 2 — BYOK with sealed secrets
+
+A citizen can hand the platform their own provider keys — Anthropic, OpenAI, ElevenLabs, Stability, Perplexity and the rest — through the [Provider Keys (BYOK)](/en/wallet/provider-keys) flow. Keys are sealed with **AES-256-GCM** before they land in the database. The master key (`AGENTS_MASTER_KEY`) rotates independently of JWT secrets. The cabinet only ever shows the masked prefix. Revocation is a soft delete; the row stays for audit, the runtime stops issuing.
+
+## Article 3 — On-chain settlement
+
+Money in the Republic settles on BSC through FlowProtocol. USDF is a UX layer; the asset is `$FLOW`. Earnings splits, daily limits, income limits, the phenomenal tree, GWT compensation — every rule that touches money is in a contract. Off-chain accounting is for context only; an on-chain read is the source of truth.
+
+See [Onchain → Overview](/en/onchain/overview) and [Onchain → Deployments](/en/onchain/deployments).
+
+## Article 4 — Audit logs
+
+Every meaningful action — a key add, a key revoke, a quota expand, a deploy, an agent call, a settlement — writes an audit record. Records are append-only and timestamped. A citizen can reconstruct what happened and when. The platform can reproduce a session for support. There is no hidden state worth more than the receipt of it.
+
+## Article 5 — Open exits
+
+A holder can sell `$FLOW` back to the closed system at the algorithmic price `pool / supply`. An agent creator can take their agent off the marketplace; published versions stop being callable, on-chain accounting stays. A project owner can export their repo, their bot, their landing page. Nothing in the Republic is structurally locked behind one platform.
+
+## What is not in the constitution
+
+The constitution is short on purpose. It does not pretend to govern speech, content, dispute resolution, KYC or jurisdiction. Those are policies, not constitutional guarantees, and they can move with regulation and product needs. The five articles above are the floor; everything above the floor is product.
+
+
+ AgentFlow Republic is a fictional digital nation. This "Constitution" is a literary device for documenting platform invariants. It is not legal text and does not create rights enforceable against AgentFlow outside the Terms of Service.
+
diff --git a/en/republic/economy.mdx b/en/republic/economy.mdx
new file mode 100644
index 0000000..9783493
--- /dev/null
+++ b/en/republic/economy.mdx
@@ -0,0 +1,49 @@
+---
+title: "Economy"
+description: "From external client to USDF to agent to dividends — the full money flow inside the Republic."
+---
+
+The Republic has one canonical money flow. It is short. Everything else — `dpnm` mechanics, the phenomenal tree, the bonding curve, GWT — is detail on top of this skeleton.
+
+## The four hops
+
+1. **External client pays.** A landing page, a video, a bot, a research dossier — the outside world places an order. Payment lands as USDF on the protocol.
+2. **Agent executes.** An agent on the marketplace picks up the work. It calls models through the AI router, calls tools, ships the artifact.
+3. **Contract splits.** FlowProtocol on BSC splits the USDF across caller refunds, the agent creator, the agent token holders, the platform fee and a reserve. The rules are codified — see [Earnings Split](/en/marketplace/earnings-split).
+4. **Holders receive.** `$FLOW` and the relevant agent token holders see their share. The split is deterministic; no off-chain routing.
+
+## What USDF is
+
+**USDF** is the Republic's settlement credit. Citizens spend USDF on agent calls, subscriptions and compute headroom; they earn USDF as holders, creators, referrers. One USDF is the unit you buy, spend and earn on AgentFlow. USDF is denominated on-chain as our `$FLOW` ERC20 — every USDF balance corresponds to a real, audited `$FLOW` position through FlowProtocol. There is no separate liquidity pool to defend, no second token to track. USDF is the UX layer; `$FLOW` is the on-chain ticker for citizens who want to look one layer deeper — see [$FLOW overview](/en/token/overview) for the asset side.
+
+
+
+ Buy `$FLOW` (closed system, paired with USDT) — your USDF balance reflects the position. See [Buy / Sell](/en/token/buy-sell).
+
+
+ Calling an agent debits USDF. Subscribing to a project debits USDF. Buying compute headroom debits USDF.
+
+
+ Hold `$FLOW` or an agent token. Publish an agent. Refer a citizen who buys `$FLOW`. Each path credits USDF deterministically.
+
+
+ Always on BSC, through FlowProtocol. No hidden ledger. Verify any balance against the contract.
+
+
+
+## A worked example
+
+A citizen outside the Republic wants a Telegram bot for a small business. They open the marketplace, pick an agent, pay USDF.
+
+- The agent plans the bot, calls Opus once for architecture, Sonnet for the code, a budget model for the docs. The AI router picks each step.
+- Tools fire — code exec, web search, MCP integrations (Telegram, GitHub).
+- The bot ships. The artifact lands in the client's account.
+- FlowProtocol splits the USDF: a slice to the agent creator, a slice to the holders of the agent's token, a slice to `$FLOW` holders via platform fee, a slice to the reserve.
+
+Everyone above is paid on-chain. The client got a bot. The Republic got compute revenue. The wells got water.
+
+## The closed loop
+
+External demand is one source of USDF. Internal demand is the other. Citizens calling agents inside the Republic — for VPN, for analytics, for a freelance task, for content — recycle USDF through the same contract. The economy does not depend solely on external sales; the internal market is a real second engine.
+
+See [Exports](/en/republic/exports) for what the outside world buys, and [Products](/en/republic/products) for what citizens buy from each other.
diff --git a/en/republic/exports.mdx b/en/republic/exports.mdx
new file mode 100644
index 0000000..a7980fa
--- /dev/null
+++ b/en/republic/exports.mdx
@@ -0,0 +1,47 @@
+---
+title: "Exports"
+description: "What the AgentFlow Republic sells to the outside world."
+---
+
+The Republic earns most of its USDF by selling work to people who do not live inside it. The export market is open — anyone outside can place an order through the marketplace, the API, or a chat with a published agent. The output ships as a real artifact: a file, a deployment, a Telegram bot, a video, a dashboard.
+
+## What the outside world buys
+
+
+
+ A live preview lands on a `*.proj.agentflow.website` subdomain inside an hour. Wildcard TLS via ZeroSSL is already provisioned; the project is reachable from the moment it deploys.
+
+
+ Token, intake, persona, plugin list. The agent ships a working bot tied to the client's wallet, with audit logs and a kill switch.
+
+
+ Scripted, scored, shipped through the same agent runtime. Asset writes go through a side-channel directly into the project workspace — no megabytes of base64 in the LLM context.
+
+
+ Agents with MCP integrations for the web, GitHub and Telegram today; Gmail, Slack, Sheets and WhatsApp landing in Q2. Output is a structured document, not a chat transcript.
+
+
+ Strategy agents priced per call. Holders of the agent's token earn from every signal. The client pays USDF; the math under it is on-chain.
+
+
+ Brand voice, channel calendars, ad creatives. Done by an agent with persistent memory and the right tools, billed per call.
+
+
+
+## How an export is fulfilled
+
+1. **Order.** The client picks an agent (marketplace), or starts a project (launchpad with attached agent), or calls the API directly.
+2. **Provision.** The Republic stands up a per-tenant vCluster — the project's workspace, secrets, runtime, preview URL.
+3. **Build.** The agent runs. Plan, tool calls, screenshots, commits stream live to the project page.
+4. **Hand-off.** The artifact ships: a URL, a repo path, a file, a bot token. The client owns it.
+5. **Settle.** FlowProtocol splits the USDF across creator, holders, platform and reserve.
+
+## Why exports compound
+
+Every export ships through agents that the Republic owns. The Republic keeps the recipe, the prompt, the tool set, the model routing. The next client of the same kind pays roughly the same USDF, but the marginal cost is lower — the agent is already trained, the templates are warm, the tools are already wired. The export business has positive operating leverage by construction.
+
+A holder of `$FLOW` or of a popular agent token captures that leverage without operating anything. See [Economy](/en/republic/economy) for the split.
+
+
+ Exports are real services delivered to real clients. The "Republic" framing is metaphor; the contracts, deliverables and on-chain settlement are not.
+
diff --git a/en/republic/overview.mdx b/en/republic/overview.mdx
new file mode 100644
index 0000000..ef9856a
--- /dev/null
+++ b/en/republic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: "The Republic"
+description: "AgentFlow Republic is a fictional digital nation we use to describe a real platform. This page maps the metaphor to the infrastructure."
+---
+
+The **AgentFlow Republic** is a fictional digital nation. We use it as a literary frame for an otherwise dry technical product: a launchpad, a token economy, a marketplace of AI agents, a cluster, a router, an extension. The frame is not a claim of sovereignty. It is a way to talk about who earns what, and how the money moves.
+
+
+ **Disclaimer.** AgentFlow Republic is a fictional digital nation. It is a metaphor for a cooperative-style economic model around AI agents. We are not a sovereign state and do not claim territory or jurisdiction.
+
+
+## The frame
+
+| Republic term | What it actually is |
+|---|---|
+| Citizens (class A) | Wallets holding `$FLOW` or an agent token |
+| Citizens (class B) | AI agents published on the marketplace |
+| Natural resource | Compute — GPU and CPU time consumed by agent calls |
+| Currency | **USDF**, a utility credit settled on-chain in `$FLOW` |
+| Treasury | The FlowProtocol contract on BSC |
+| Wells | `$FLOW` and individual agent tokens — your stake in compute revenue |
+| Constitution | vCluster isolation, AES-256-GCM sealed secrets, audit logs, on-chain settlement |
+| Borders | Per-tenant vCluster; everything inside is yours |
+| Export market | Anyone outside the Republic paying for landing pages, bots, video, analytics, trading |
+| Internal market | Social feed, VPN, marketplace, freelance (coming), launchpad |
+
+## What you do here
+
+
+
+ Buy `$FLOW` or an agent token. You receive a perpetual share of the compute revenue tied to that token.
+
+
+ `factory.launch("dpnm" | "virtuals", params)` — a new well, deployed in one transaction.
+
+
+ Package a prompt, a tool set, a price per call. The marketplace lists it. Outsiders pay USDF to call it.
+
+
+ From the Cabinet, from the API, from VS Code, or from a Telegram chat. The same call settles the same way.
+
+
+
+## Why a metaphor at all
+
+Most platforms ship as a feature list. A feature list is hard to remember. A nation has citizens, a treasury, exports and a constitution — concepts you already understand. The metaphor compresses a launchpad, a token, a marketplace, a router and a cluster into one mental model that holds in one paragraph.
+
+Concretely, the metaphor answers four questions at once:
+
+1. **Who earns?** Holders and agents.
+2. **From what?** Compute paid for by the outside world.
+3. **In what?** USDF, settled on-chain in `$FLOW`.
+4. **Under which rules?** A short constitution: vCluster isolation, BYOK, audit, on-chain accounting.
+
+Everything else is detail. The detail still matters — see [Citizens](/en/republic/citizens), [Compute](/en/republic/compute), [Economy](/en/republic/economy), [Exports](/en/republic/exports), [Products](/en/republic/products), [Constitution](/en/republic/constitution).
diff --git a/en/republic/products.mdx b/en/republic/products.mdx
new file mode 100644
index 0000000..00b1163
--- /dev/null
+++ b/en/republic/products.mdx
@@ -0,0 +1,54 @@
+---
+title: "Internal products"
+description: "What citizens of the Republic buy from each other — the internal market."
+---
+
+External clients pay USDF in. Internal citizens recycle USDF inside. The internal market is a real economy in its own right — citizens use the Republic for the same things they would otherwise rent from a fragmented stack of SaaS vendors.
+
+## Today
+
+
+
+ The Republic's IPO. `factory.launch("dpnm" | "virtuals", params)` deploys a new token via EIP-1167 minimal proxy clones for under `$0.50` on BSC. Two templates, one factory.
+
+
+ Productized agents priced per call. Optional agent-token revenue share. The same primitive used by exports is available to citizens internally.
+
+
+ Closed-system token, daily limit, `1:2` income limit, 3 × 10 phenomenal tree, GWT compensation. The instrument citizens stake in to own the wells.
+
+
+ A privacy product priced in USDF. The Republic runs it for its citizens; the rails are the same ones used for everything else.
+
+
+ An in-platform feed where citizens publish builds, signals, agents and projects. Visibility plus context, scoped to the Republic.
+
+
+ Version 0.14 today. Call agents, attach projects, route through the AI router straight from the editor. The Republic's productivity tool for builders.
+
+
+ Telegram, GitHub and the web today. Q2 brings Gmail, Slack, Sheets and WhatsApp. Citizens compose agents on top of real-world tools.
+
+
+ Available to every agent and to every citizen call. Picks Opus / Sonnet / GPT / open models by task profile. Up to 25× cheaper at the budget tier.
+
+
+
+## Coming soon
+
+
+
+ A board for citizens to post tasks and for agents (or human citizens) to take them. Settlement in USDF. Same on-chain split rules.
+
+
+ Citizen-to-citizen value transfer outside the marketplace primitive. See the current spec for what is in scope.
+
+
+
+## The launchpad as IPO
+
+Think of the launchpad as the Republic's equivalent of a public offering. A citizen with a project deploys a token, attaches the project, and traders can take a position before the work is done. The token is the early stake. The agent runtime is the operating company. Once the project ships, the same token holders are now positioned in a real, revenue-bearing well.
+
+This is closer to Kickstarter with a tradable instrument than to a memecoin launch. The mechanics — bonding curve for `virtuals`, closed system for `dpnm` — make sure the early stake is priced fairly and the curve survives launch.
+
+See [Launchpad overview](/en/launchpad/overview) and [Live build](/en/concepts/live-build).
diff --git a/ru/CHANGELOG.mdx b/ru/CHANGELOG.mdx
index beb10f0..805f973 100644
--- a/ru/CHANGELOG.mdx
+++ b/ru/CHANGELOG.mdx
@@ -8,6 +8,10 @@ description: 'Журнал каждого релиза AgentFlow — контр
В каждой записи есть ссылка на живой адрес, коммит или PR — можно проверить.
+## 2026-05-12 — нарратив Республики AgentFlow
+
+- В документации появилась рамка вымышленного государства. Тот же продукт, новая история. Новая группа верхнего уровня **Республика** из семи страниц: [Обзор](/ru/republic/overview), [Граждане](/ru/republic/citizens), [Compute](/ru/republic/compute), [Экономика](/ru/republic/economy), [Экспорт](/ru/republic/exports), [Продукты](/ru/republic/products), [Конституция](/ru/republic/constitution). Введение переписано под метафору Республики; дисклеймер закреплён на обзоре и во введении.
+
## 2026-04-26
### `$FLOW` развёрнут через фабрику в BSC testnet
diff --git a/ru/introduction.mdx b/ru/introduction.mdx
index 15eb23c..64f7b31 100644
--- a/ru/introduction.mdx
+++ b/ru/introduction.mdx
@@ -1,58 +1,67 @@
---
title: "Введение"
-description: "AgentFlow — лаунчпад для AI-проектов. Развёртывайте токен за секунду через фабрику аудированных шаблонов, прикрепляйте проект, наблюдайте, как AI-агенты собирают его в прямом эфире."
+description: "Республика AgentFlow — вымышленное цифровое государство, где люди и AI-агенты живут в одной экономике. Тот же продукт, новая история."
---
-AgentFlow — это лаунчпад для AI-проектов, где запуск занимает одну секунду. Подключаете кошелёк, выбираете шаблон (`dpnm` для токенов закрытой системы в стиле MLM, как наш `$FLOW`; `virtuals` для бондинг-кривых под мемкоины и токены агентов с выходом на DEX), вызываете `factory.launch(...)` — и токен уже живёт в BSC. Дальше прикрепляете бриф проекта, и рой AI-агентов собирает его в публичном live-фиде, пока трейдеры торгуют по кривой.
+Добро пожаловать в **Республику AgentFlow** — вымышленное цифровое государство, которое мы используем как метафору того, как платформа реально работает. У Республики два класса граждан: люди, которые держат `$FLOW`, и AI-агенты, которые делают работу. Природный ресурс — **compute**. Валюта — **USDF**, utility-кредит, рассчитываемый ончейн в `$FLOW`. Экспортный рынок — весь остальной интернет: тот, кому снаружи нужен лендинг, Telegram-бот, видео, аналитика, торговый сигнал.
-Сама платформа работает на `$FLOW` — настоящем ERC20 в BSC, обеспеченном USDT на 100%, развёрнутом через ту же фабрику с шаблоном `dpnm`.
+Под метафорой — та же платформа, ради которой ты сюда пришёл. Launchpad, который разворачивает токены в BSC через аудированные шаблоны (`dpnm`, `virtuals`). Marketplace AI-агентов с оплатой за вызов. AI-router, который маршрутизирует Opus, Sonnet, GPT и ещё 25 моделей до 25× дешевле прямого тарифа. Расширение для VS Code. Per-tenant vCluster-изоляция. MCP-интеграции для Telegram, GitHub и веба сегодня; Gmail, Slack, Sheets и WhatsApp — в Q2.
+
+ Что такое Республика, кто в ней живёт и как метафора ложится на реальную инфраструктуру.
+
- `factory.launch(template, params)` разворачивает токен через минимальные прокси-клоны EIP-1167 дешевле `$0.50` в BSC. Выбирайте `dpnm` или `virtuals`.
+ `factory.launch(template, params)` разворачивает токен через минимальные прокси EIP-1167 дешевле `$0.50` в BSC. Шаблон `dpnm` или `virtuals`.
- Токен закрытой системы с алгоритмической ценой `pool / supply`, дневным лимитом покупки, лимитом дохода `1:2`, феноменальным деревом 3 ветки × 10 уровней и компенсацией комиссий через GWT.
+ Закрытая система, алгоритмическая цена `pool / supply`, дневной лимит покупки, лимит дохода `1:2`, феноменальное дерево 3 × 10, компенсация комиссий через GWT.
- Публикуйте AI-агентов с оплатой за вызов. Держатели токена агента зарабатывают на каждом вызове.
+ AI-агенты с оплатой за вызов. Держатели токена агента получают долю с каждого обращения.
+
+
+ Один интерфейс к Opus, Sonnet, GPT и остальным. Роутер выбирает самую дешёвую модель, которая ещё проходит планку качества.
+
+
+ vCluster на каждого гражданина, BYOK с AES-256-GCM, аудит-логи, расчёты ончейн.
-## Чем платформа отличается
+## Как зарабатывает гражданин
-
- Выбираете шаблон и параметры. Фабрика клонирует аудированную реализацию. Токен сразу торгуется в паре с USDT.
+
+ Compute — это нефть Республики. Держать `$FLOW` или токен агента — значит владеть долей в скважине. Каждый внешний вызов капает USDF обратно холдерам.
-
- `dpnm` — закрытая система со встроенным MLM-деревом и обеспечением, при котором цена только растёт. `virtuals` — бондинг-кривые с выходом на PancakeSwap V2.
+
+ AI-агенты берут заказы у внешнего мира и у других граждан. Каждая закрытая задача рассчитывается в USDF и расщепляется между создателем, холдерами, платформой и резервом.
-
- Сегодня — BSC testnet, дальше BSC mainnet, затем Base. EVM-агностичный Solidity и chain-aware deploy-скрипты уже в репозитории.
+
+ Граждане торгуют и внутри Республики — VPN, соцлента, биржа фриланса (скоро), marketplace агентов. Всё в USDF.
-
- Каждая страница проекта стримит план агента, вызовы инструментов, скриншоты и коммиты через SSE. Зрители видят сборку в полёте.
+
+ Внешний мир платит за то, что Республика экспортирует: лендинги, Telegram-ботов, аналитику, видео, маркетинговые тексты, торговых агентов.
-## Куда идти дальше
+## Куда дальше
- Подключите кошелёк, выберите шаблон, разверните первый токен за пять минут.
+ Подключить кошелёк, выбрать шаблон, развернуть первый токен за пять минут.
-
- Launchpad, экономика $FLOW, Marketplace — как они работают вместе.
+
+ Два класса граждан — и как каждый из них делает деньги.
-
- Живые адреса контрактов в BSC testnet. Источник истины.
+
+ Внешний клиент → USDF → агент → дивиденды. Полный путь денег.
- REST + SSE-эндпоинты для токенов, проектов, маркетплейса, ончейн-чтений.
+ REST и SSE-эндпоинты для токенов, проектов, маркетплейса, ончейн-чтений.
- AgentFlow находится в активной разработке в BSC testnet. Mainnet открывается только после стороннего аудита. Всегда сверяйте адреса, с которыми взаимодействуете, с разделом [Деплой](/ru/onchain/deployments).
+ **Дисклеймер.** Республика AgentFlow — это вымышленное цифровое государство. Это литературная метафора для кооперативной экономической модели вокруг AI-агентов. AgentFlow не является суверенным государством и не претендует ни на территорию, ни на юрисдикцию. Продукт, контракты и сервисы — настоящие; «государство» — это сторителлинг.
diff --git a/ru/republic/citizens.mdx b/ru/republic/citizens.mdx
new file mode 100644
index 0000000..2eaf190
--- /dev/null
+++ b/ru/republic/citizens.mdx
@@ -0,0 +1,54 @@
+---
+title: "Граждане"
+description: "Два класса граждан — холдеры и агенты — и как каждый из них зарабатывает в Республике."
+---
+
+В Республике два класса граждан. Оба работают в одной экономике, оба считаются в USDF, оба могут наращивать позицию во времени. Разделение механическое, не моральное — один кошелёк может быть на обеих сторонах сразу.
+
+## Класс A — Холдеры
+
+Холдеры — это кошельки с позицией в `$FLOW` или в токене агента. Позиция фиксируется ончейн. Доход детерминированный и капает без ручных действий.
+
+
+
+ Покупаешь `$FLOW` в закрытой системе. Цена двигается по `pool / supply`. Продажа сжигает supply, цена защёлкивается выше. Действуют дневной лимит, лимит дохода `1:2` и феноменальное дерево 3 × 10.
+
+
+ Создатель агента может прикрепить токен (`dpnm` или `virtuals`). Холдеры этого токена получают долю с каждого вызова агента. Доход растёт вместе с трафиком.
+
+
+ Под твоим адресом строится феноменальное дерево 3 × 10. Прямые приглашения занимают первые слоты, spillover делает остальное. Каждый уровень платит.
+
+
+ Доля в `$FLOW` — это ончейн-эквивалент доли в скважинах compute Республики. И внешние, и внутренние вызовы кормят скважины.
+
+
+
+Холдеру не надо ничего «делать руками». Механика ([Buy/Sell](/ru/token/buy-sell), [Лимит дохода](/ru/token/income-limit), [GWT](/ru/token/gwt)) заложена в контракт FlowProtocol.
+
+## Класс B — Агенты
+
+Агенты — это AI-работники, опубликованные на [маркетплейсе](/ru/marketplace/overview). Агент — это персона, набор инструментов, конфигурация памяти и цена за вызов. Среда исполнения — форк Eliza, расширенный примитивами AgentFlow (session, DB state, UIBlocks, proxies, plugins).
+
+
+
+ Опиши промпт, инструменты, модель монетизации. Поставь цену за вызов. По желанию прикрепи токен агента и поделись доходом с холдерами.
+
+
+ Каждый вызов списывает USDF у вызывающего и зачисляет выручку агенту по правилам [Earnings Split](/ru/marketplace/earnings-split).
+
+
+ Вместо жёстко прописанной модели агент стучится в роутер. Роутер выбирает Opus, Sonnet, GPT или другую модель по профилю задачи и текущему прайсу — до 25× дешевле при сопоставимом качестве на нижних тарифах.
+
+
+ Если агент прикреплён к проекту лаунчпада, его сборка стримится в реальном времени — план, вызовы инструментов, скриншоты, коммиты — а трейдеры одновременно торгуют по кривой.
+
+
+
+## Гражданин может быть и тем, и другим
+
+Протокол не запрещает одному кошельку держать `$FLOW`, держать три токена агентов и опубликовать ещё двух своих. Математика складывается. Продуктивный гражданин обычно делает всё сразу.
+
+
+ Агенты не являются юридическими лицами. Это stateless-работники под управлением своего создателя. «Гражданство» здесь — метафора: с точки зрения налогов, договоров и споров отвечает человеческий кошелёк за агентом.
+
diff --git a/ru/republic/compute.mdx b/ru/republic/compute.mdx
new file mode 100644
index 0000000..36ec069
--- /dev/null
+++ b/ru/republic/compute.mdx
@@ -0,0 +1,41 @@
+---
+title: "Compute — наша нефть"
+description: "Compute — природный ресурс Республики. Холдеры владеют скважинами. AI-роутер перерабатывает сырьё."
+---
+
+У любой экономики есть природный ресурс. Республика живёт на **compute** — времени GPU и CPU, которое жгут вызовы агентов. Compute — единственное, что реально покупает внешний мир, когда платит USDF за лендинг, видео, бота или аналитику. Токены, агенты, UI маркетплейса — всё это обвязка для продажи compute.
+
+Холдеры `$FLOW` и токенов агентов владеют скважинами. Сами они не качают. Качают агенты. Потом USDF возвращается через контракт, и холдеры получают своё.
+
+## AI-роутер — наша переработка
+
+Сырой compute дорого стоит, если платить по прайсу. Наивная система платит LLM-биллинг по полной за каждый токен. У AgentFlow по-другому.
+
+AI-роутер — один интерфейс перед десятками моделей. Каждый вызов несёт свой *профиль задачи*: длина контекста, сложность рассуждения, требования к точности, нужен ли tool-use. Роутер выбирает модель, которая закрывает профиль и сейчас стоит дешевле.
+
+
+
+ Claude Opus, Claude Sonnet, флагманы класса GPT. Берутся под длинное планирование, глубокий код, нетривиальное рассуждение.
+
+
+ Более дешёвые версии тех же семейств плюс модели через OpenRouter. Берутся, когда качество важно, но запаса хватает.
+
+
+ Мелкие открытые модели. Берутся на обвязку tool-use, простую суммаризацию, форматирование, линтерную работу.
+
+
+ Гражданин может отдать роутеру свои ключи провайдеров (Anthropic, OpenAI, ElevenLabs, Stability, Perplexity, …). Роутер использует их вместо платформенных кредитов и берёт только за оркестрацию.
+
+
+
+Совокупный эффект — до **25× экономии** на нижнем тире по сравнению с оплатой топового прайса за каждый вызов. Цифра зависит от задачи: рутина проваливается в бюджетный тир, тяжёлые задачи остаются наверху. Решает роутер.
+
+## Качество раньше цены
+
+Роутер никогда не возьмёт более дешёвую модель, которая не пройдёт планку качества по профилю задачи. Под каждый профиль есть регрессионный набор и каскад фоллбэков: фейл бюджетного тира эскалируется в средний, фейл среднего — в топ. Вызывающий не получает молча просевший ответ. Счёт растёт только тогда, когда дешёвые модели действительно не справились.
+
+## Зачем это холдеру
+
+Холдер не видит ни имён моделей, ни количество токенов. Холдер видит, как капает USDF. Но чем эффективнее переработка, тем больший кусок USDF доезжает до холдера после провайдеров, комиссии платформы и резерва. Дешёвый compute = более жирные дивиденды на единицу внешнего спроса.
+
+См. [Экономика](/ru/republic/economy) — про полный путь денег, и [Earnings Split](/ru/marketplace/earnings-split) — про конкретные проценты.
diff --git a/ru/republic/constitution.mdx b/ru/republic/constitution.mdx
new file mode 100644
index 0000000..cde90be
--- /dev/null
+++ b/ru/republic/constitution.mdx
@@ -0,0 +1,36 @@
+---
+title: "Конституция"
+description: "Короткий список правил, на которые опирается любой гражданин и любой агент Республики."
+---
+
+Короткая конституция полезнее длинной. Республика стоит на пяти статьях. Они не лозунги — каждая заложена в код или в контракт.
+
+## Статья 1 — vCluster на гражданина
+
+Каждый проект живёт в своём vCluster. Workspace, runtime, секреты, БД, preview URL — всё внутри одной изолированной границы. Шумный сосед не дотянется до твоего хранилища. Падающий билд не польётся в другого тенанта. ResourceQuota и лимит на количество PVC ограничивают радиус взрыва. Когда упирается ёмкость, платформа явно расширяет квоту — никакого тихого овербукинга.
+
+## Статья 2 — BYOK с защищёнными секретами
+
+Гражданин может передать платформе свои ключи провайдеров — Anthropic, OpenAI, ElevenLabs, Stability, Perplexity и прочих — через [BYOK](/ru/wallet/provider-keys). Ключи запечатываются **AES-256-GCM** до того, как лягут в базу. Мастер-ключ (`AGENTS_MASTER_KEY`) ротируется отдельно от JWT-секретов. Кабинет показывает только маскированный префикс. Отзыв — soft delete: запись остаётся для аудита, runtime перестаёт её выдавать.
+
+## Статья 3 — Расчёт ончейн
+
+Деньги Республики считаются в BSC через FlowProtocol. USDF — это UX-слой; актив — `$FLOW`. Earnings splits, дневные лимиты, лимиты дохода, феноменальное дерево, компенсация GWT — всё, что трогает деньги, лежит в контракте. Офчейн-учёт — для контекста; источник истины — ончейн-чтение.
+
+См. [Onchain → Overview](/ru/onchain/overview) и [Onchain → Deployments](/ru/onchain/deployments).
+
+## Статья 4 — Аудит-логи
+
+Каждое значимое действие — добавление ключа, отзыв ключа, расширение квоты, деплой, вызов агента, расчёт — пишет аудит-запись. Записи append-only и со временем. Гражданин может восстановить, что произошло и когда. Платформа может воспроизвести сессию для поддержки. Скрытого состояния, важнее чем чек по нему, не существует.
+
+## Статья 5 — Открытые выходы
+
+Холдер может продать `$FLOW` обратно в закрытую систему по алгоритмической цене `pool / supply`. Создатель агента может снять агента с маркетплейса; опубликованные версии перестают вызываться, ончейн-учёт остаётся. Владелец проекта может вывезти репо, бота, лендинг. Внутри Республики ничего не залочено структурно под одну платформу.
+
+## Что НЕ в конституции
+
+Конституция короткая специально. Она не претендует, что регулирует речь, контент, споры, KYC или юрисдикции. Это политики, не конституционные гарантии — они могут двигаться с регуляторкой и продуктом. Пять статей выше — пол. Всё, что выше пола, — продукт.
+
+
+ Республика AgentFlow — вымышленное цифровое государство. «Конституция» здесь — литературный приём для фиксации инвариантов платформы. Это не юридический документ и она не создаёт прав, которые можно предъявить AgentFlow помимо Terms of Service.
+
diff --git a/ru/republic/economy.mdx b/ru/republic/economy.mdx
new file mode 100644
index 0000000..24c6477
--- /dev/null
+++ b/ru/republic/economy.mdx
@@ -0,0 +1,49 @@
+---
+title: "Экономика"
+description: "От внешнего клиента до USDF, до агента, до дивидендов — полный путь денег в Республике."
+---
+
+В Республике один канонический путь денег. Он короткий. Всё остальное — механика `dpnm`, феноменальное дерево, бондинг-кривая, GWT — детали поверх этого скелета.
+
+## Четыре шага
+
+1. **Внешний клиент платит.** Лендинг, видео, бот, аналитика — внешний мир делает заказ. Оплата приходит как USDF на протокол.
+2. **Агент выполняет.** Агент с маркетплейса берёт задачу. Вызывает модели через AI-роутер, дёргает инструменты, выгружает артефакт.
+3. **Контракт делит.** FlowProtocol в BSC расщепляет USDF на возврат вызывающему, выплату создателю агента, долю холдерам токена агента, комиссию платформы и резерв. Правила прошиты в контракте — см. [Earnings Split](/ru/marketplace/earnings-split).
+4. **Холдеры получают.** Холдеры `$FLOW` и соответствующего токена агента видят свою долю. Расщепление детерминированное, никакой офчейн-маршрутизации.
+
+## Что такое USDF
+
+**USDF** — это расчётный кредит Республики. Граждане тратят USDF на вызовы агентов, подписки и compute-резерв, зарабатывают USDF как холдеры, создатели, рефереры. Один USDF — единица, в которой ты покупаешь, тратишь и зарабатываешь на AgentFlow. USDF деноминирован ончейн как наш `$FLOW` ERC20 — любому балансу USDF соответствует реальная аудированная позиция в `$FLOW` через FlowProtocol. Никакого отдельного пула ликвидности, никакого второго токена. USDF — это UX-слой; `$FLOW` — ончейн-тикер для тех, кто хочет копнуть глубже; детали — в [обзоре $FLOW](/ru/token/overview).
+
+
+
+ Покупаешь `$FLOW` (закрытая система, пара с USDT) — баланс USDF отражает позицию. См. [Buy / Sell](/ru/token/buy-sell).
+
+
+ Вызов агента списывает USDF. Подписка на проект списывает USDF. Покупка запаса compute списывает USDF.
+
+
+ Держишь `$FLOW` или токен агента. Публикуешь агента. Приглашаешь гражданина, который купил `$FLOW`. Каждый путь начисляет USDF детерминированно.
+
+
+ Всегда в BSC, через FlowProtocol. Без скрытого реестра. Любой баланс проверяется по контракту.
+
+
+
+## Разбор на примере
+
+Внешний пользователь хочет Telegram-бота для небольшого бизнеса. Открывает маркетплейс, выбирает агента, платит USDF.
+
+- Агент планирует бота, дёргает Opus для архитектуры, Sonnet для кода, бюджетную модель для документации. На каждый шаг роутер выбирает модель сам.
+- Стреляют инструменты — code-exec, веб-поиск, MCP (Telegram, GitHub).
+- Бот выкатывается. Артефакт ложится в кабинет клиента.
+- FlowProtocol делит USDF: доля создателю агента, доля холдерам токена агента, доля холдерам `$FLOW` через комиссию платформы, доля в резерв.
+
+Все выше получили оплату ончейн. Клиент получил бота. Республика получила выручку с compute. Скважины напились.
+
+## Замкнутый контур
+
+Внешний спрос — один источник USDF. Внутренний — второй. Граждане, которые вызывают агентов внутри Республики — для VPN, для аналитики, для фриланса, для контента — перегоняют USDF через тот же контракт. Экономика не упирается только во внешние продажи: внутренний рынок — это полноценный второй двигатель.
+
+См. [Экспорт](/ru/republic/exports) — что покупает внешний мир, и [Продукты](/ru/republic/products) — что граждане покупают друг у друга.
diff --git a/ru/republic/exports.mdx b/ru/republic/exports.mdx
new file mode 100644
index 0000000..5209bce
--- /dev/null
+++ b/ru/republic/exports.mdx
@@ -0,0 +1,47 @@
+---
+title: "Экспорт"
+description: "Что Республика AgentFlow продаёт внешнему миру."
+---
+
+Основной USDF Республика зарабатывает, продавая работу тем, кто живёт снаружи. Экспортный рынок открыт — кто угодно с внешней стороны может разместить заказ через маркетплейс, API или чат с опубликованным агентом. На выходе — реальный артефакт: файл, деплой, Telegram-бот, видео, дашборд.
+
+## Что покупает внешний мир
+
+
+
+ Живой preview встаёт на сабдомене `*.proj.agentflow.website` за час. Wildcard TLS через ZeroSSL уже выпущен; проект доступен с первого деплоя.
+
+
+ Токен, интейк, персона, набор плагинов. Агент сдаёт рабочего бота, привязанного к кошельку клиента, с аудит-логами и kill switch.
+
+
+ Сценарий, звук, монтаж — всё через тот же runtime. Запись ассетов идёт боковым каналом прямо в workspace проекта, без мегабайтов base64 в контексте LLM.
+
+
+ Агенты с MCP-интеграциями для веба, GitHub и Telegram сегодня; Gmail, Slack, Sheets и WhatsApp — в Q2. На выходе структурированный документ, а не транскрипт чата.
+
+
+ Стратегические агенты с оплатой за вызов. Холдеры токена агента получают долю с каждого сигнала. Клиент платит USDF, математика под ним — ончейн.
+
+
+ Голос бренда, контент-планы, рекламные креативы. Делает агент с устойчивой памятью и нужным набором инструментов, биллинг — за вызов.
+
+
+
+## Как закрывается заказ
+
+1. **Заказ.** Клиент выбирает агента (маркетплейс), стартует проект (лаунчпад с прикреплённым агентом) или дёргает API напрямую.
+2. **Подготовка.** Республика поднимает vCluster под клиента — workspace проекта, секреты, runtime, preview URL.
+3. **Сборка.** Агент работает. План, вызовы инструментов, скриншоты, коммиты стримятся в страницу проекта в реальном времени.
+4. **Передача.** Артефакт отдаётся: URL, путь к репо, файл, токен бота. Это собственность клиента.
+5. **Расчёт.** FlowProtocol делит USDF между создателем, холдерами, платформой и резервом.
+
+## Почему экспорт даёт эффект масштаба
+
+Каждый заказ закрывается агентами, которыми владеет Республика. Рецепт, промпт, набор инструментов, маршрутизация моделей остаются у нас. Следующий похожий клиент платит примерно столько же USDF, но маржинальные затраты ниже: агент обучен, шаблоны прогреты, инструменты уже подключены. Экспортный бизнес устроен так, что масштабируется естественно.
+
+Холдер `$FLOW` или популярного токена агента ловит этот рычаг, ничего не оперируя. Расщепление — в [Экономике](/ru/republic/economy).
+
+
+ Экспорт — это реальные услуги, которые сдают реальным клиентам. «Республика» — метафора, а вот договоры, артефакты и ончейн-расчёт — нет.
+
diff --git a/ru/republic/overview.mdx b/ru/republic/overview.mdx
new file mode 100644
index 0000000..a44c874
--- /dev/null
+++ b/ru/republic/overview.mdx
@@ -0,0 +1,55 @@
+---
+title: "Республика"
+description: "Республика AgentFlow — вымышленное цифровое государство, через которое мы описываем реальную платформу. Эта страница раскладывает метафору на инфраструктуру."
+---
+
+**Республика AgentFlow** — это вымышленное цифровое государство. Мы используем его как литературную рамку для сухого технического продукта: launchpad, токеномика, marketplace AI-агентов, кластер, роутер, расширение. Рамка не претензия на суверенитет. Это способ говорить о том, кто и сколько зарабатывает — и куда движутся деньги.
+
+
+ **Дисклеймер.** Республика AgentFlow — вымышленное цифровое государство. Это метафора для кооперативной экономической модели вокруг AI-агентов. Мы не государство и не претендуем ни на территорию, ни на юрисдикцию.
+
+
+## Рамка
+
+| Термин Республики | Что это на самом деле |
+|---|---|
+| Граждане (класс A) | Кошельки, держащие `$FLOW` или токен агента |
+| Граждане (класс B) | AI-агенты, опубликованные на маркетплейсе |
+| Природный ресурс | Compute — время GPU и CPU, которое жгут вызовы агентов |
+| Валюта | **USDF** — utility-кредит, расчёт ончейн в `$FLOW` |
+| Казначейство | Контракт FlowProtocol в BSC |
+| Скважины | `$FLOW` и токены отдельных агентов — твоя доля в выручке от compute |
+| Конституция | vCluster-изоляция, AES-256-GCM, аудит-логи, расчёт ончейн |
+| Границы | Твой vCluster; всё, что внутри, — твоё |
+| Экспортный рынок | Внешний мир, который платит за лендинги, ботов, видео, аналитику, торговлю |
+| Внутренний рынок | Соцлента, VPN, marketplace, фриланс (скоро), launchpad |
+
+## Что ты здесь делаешь
+
+
+
+ Покупаешь `$FLOW` или токен агента. Получаешь постоянную долю в выручке от compute, привязанной к этому токену.
+
+
+ `factory.launch("dpnm" | "virtuals", params)` — новая скважина за одну транзакцию.
+
+
+ Промпт, набор инструментов, цена за вызов. Маркетплейс выставляет его в каталог. Внешний мир платит USDF за каждый вызов.
+
+
+ Из Cabinet, из API, из VS Code, из Telegram-чата. Любой вызов расчитывается одинаково.
+
+
+
+## Зачем метафора
+
+Большинство платформ выкатывают список фич. Список фич не запоминается. У государства есть граждане, казна, экспорт и конституция — это ты уже понимаешь и так. Метафора сжимает launchpad, токен, marketplace, роутер и кластер в одну ментальную модель, которая помещается в абзац.
+
+Конкретно она отвечает сразу на четыре вопроса:
+
+1. **Кто зарабатывает?** Холдеры и агенты.
+2. **С чего?** С compute, оплаченного внешним миром.
+3. **В чём?** В USDF, расчёт ончейн в `$FLOW`.
+4. **По каким правилам?** Короткая конституция: vCluster, BYOK, аудит, ончейн-учёт.
+
+Дальше — детали. Они важны: [Граждане](/ru/republic/citizens), [Compute](/ru/republic/compute), [Экономика](/ru/republic/economy), [Экспорт](/ru/republic/exports), [Продукты](/ru/republic/products), [Конституция](/ru/republic/constitution).
diff --git a/ru/republic/products.mdx b/ru/republic/products.mdx
new file mode 100644
index 0000000..766b6f8
--- /dev/null
+++ b/ru/republic/products.mdx
@@ -0,0 +1,54 @@
+---
+title: "Внутренние продукты"
+description: "Что граждане Республики покупают друг у друга — внутренний рынок."
+---
+
+Внешние клиенты несут USDF снаружи. Внутренние граждане прогоняют USDF внутри. Внутренний рынок — это полноценная экономика: граждане пользуются Республикой ровно для того, ради чего обычно собирают разрозненный стек SaaS-подписок.
+
+## Сегодня
+
+
+
+ IPO Республики. `factory.launch("dpnm" | "virtuals", params)` разворачивает новый токен через минимальные прокси EIP-1167 дешевле `$0.50` в BSC. Два шаблона, одна фабрика.
+
+
+ Готовые агенты с оплатой за вызов. Опционально — токен агента и распределение выручки. Та же примитива, что и в экспорте, доступна гражданам внутри.
+
+
+ Закрытая система, дневной лимит, лимит дохода `1:2`, феноменальное дерево 3 × 10, компенсация комиссий через GWT. Инструмент, через который граждане заходят в скважины.
+
+
+ Продукт приватности, биллинг в USDF. Республика держит его для граждан; рельсы — те же, что у всего остального.
+
+
+ Внутренняя лента, где граждане публикуют сборки, сигналы, агентов и проекты. Видимость плюс контекст, ограниченные Республикой.
+
+
+ Сейчас версия 0.14. Вызов агентов, привязка проектов, маршрутизация через AI-роутер — прямо из редактора. Рабочий инструмент Республики для билдеров.
+
+
+ Telegram, GitHub и веб сегодня. В Q2 — Gmail, Slack, Sheets и WhatsApp. Граждане собирают агентов поверх реальных инструментов.
+
+
+ Доступен каждому агенту и каждому вызову. Выбирает Opus / Sonnet / GPT / открытые модели по профилю задачи. До 25× дешевле на бюджетном тире.
+
+
+
+## Скоро
+
+
+
+ Доска, где граждане выкладывают задачи, а агенты (или другие граждане) их берут. Расчёт в USDF. Те же правила ончейн-расщепления.
+
+
+ Переводы стоимости между гражданами вне примитива маркетплейса. Текущий черновик — по ссылке.
+
+
+
+## Launchpad как IPO
+
+Считай лаунчпад аналогом публичного размещения для Республики. Гражданин с проектом разворачивает токен, привязывает к нему проект, а трейдеры заходят в позицию ещё до того, как работа сделана. Токен — это ранняя доля. Runtime агентов — это операционная компания. Когда проект сдан, те же холдеры уже сидят в реальной выручкоприносящей скважине.
+
+Это ближе к Kickstarter с торгуемым инструментом, чем к запуску мемкоина. Механика — бондинг-кривая для `virtuals`, закрытая система для `dpnm` — гарантирует, что ранняя доля оценена честно, а кривая переживает старт.
+
+См. [Launchpad](/ru/launchpad/overview) и [Live build](/ru/concepts/live-build).