Stoa: swaps on Robinhood Chain

io.github.StoaDex由 GitHub 账号 StoaDex 发布v1.1.0更新于 Nov 21, 2026

Swaps, token safety checks, stock-token gaps, Spotlight and Stoa Pay on Robinhood Chain.

发布方自己的服务:Agent.chain.tokyo Address Contracts

已验证Streamable HTTP可网页运行金融安全与监控

概览

AI 生成的概览

Stoa 兑换路由器的 MCP 服务:在 Robinhood Chain 上报价、做安全检查并生成未签名兑换交易,支持跨链桥入与市场行情。

可以做什么
  • 列出网络上的代币与路由器地址,并跨多个交易场所报价,给出 amountOut、minOut 与价格影响
  • 生成未签名的兑换交易及所需的授权,交由用户自己的钱包签名
  • 模拟买入并立即卖回某代币,返回风险判定、买卖税、往返成本与持仓集中度
  • 报价从 Base、Arbitrum、Ethereum、Optimism 或 BNB Chain 跨链转入 Robinhood Chain 的 ETH、USDC 或 USDT
  • 读取 CoinMarketCap 市场背景:总市值、BTC/ETH 价格与占比、恐惧与贪婪指数及单个代币数据
  • 查询 Robinhood 股票代币的标的与链上价格,并查看 Stoa Spotlight 每周竞价与投票状态
适用场景
适合让助手协助用户在 Robinhood Chain 或 Elysium 上交易或评估代币:比较路由、买入前筛查代币、准备由钱包签名的兑换,或把资金跨链转入 Robinhood Chain。也适合快速获取市场背景和股票代币价格对比。
运行要求
位于 stoadex.com 的远程 streamable HTTP 端点;未声明任何软件包、环境变量或请求头。用户需要 Robinhood Chain(链 ID 4663,以 ETH 付 gas)或 Elysium 上的钱包,跨链时还需在受支持的源链上持有资金。
安装前请注意
该服务会生成真正转移资金的交易,由用户钱包签名并发送;卖出代币前需先向 approval.spender 授权。报价会变动,发送前应重新生成。代币地址应来自 list_tokens 或项目官网,未验证代币应先做安全检查。合约声明尚未审计,market_context 只是数据,不构成建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Stoa: swaps on Robinhood Chain,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.StoaDex%2Fstoa/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "stoa-swaps-on-robinhood-chain": {
      "type": "http",
      "url": "https://stoadex.com/mcp"
    }
  }
}

README

[Stoa: every route, compared. Swaps on Robinhood Chain and Elysium]

stoadex.com · Docs · $STOA · X / @StoaDEX

[CI] [Solidity 0.8.28] [Foundry] [Next.js 15] [Verified on Sourcify] [Not audited yet] [Signed mirror on Twigpine]

[Stoa on HEY Research Lab]

#BuildwithCMC: the MCP server at stoadex.com/mcp now has a market_context tool built on the CoinMarketCap API. See hackathon/cmc.

Stoa

Stoa is a swap router with maker-quoted pools (PropAMM). Every swap is quoted against every venue the router knows on the network: Stoa maker pools, Uniswap V2, V3 and V4, Aero, Ramses and Liquidity Book. It fills where the trader gets the most, directly or through the wrapped native token. Stoa charges a flat 2 bps protocol fee, once per swap (a route through two Stoa maker pools pays each pool's fee; see Fees).

It is live on Elysium (chain 99901) and Robinhood Chain (chain 4663).

How a swap works

mermaid
flowchart LR    U([Trader]) -->|quote| R[StoaRouter]    R -->|asks every venue,<br/>direct and via WETH/WHYPE| V{{Stoa maker pools<br/>Uniswap V2 · V3 · V4<br/>Aero · Ramses · Liquidity Book}}    V -->|best route| R    U -->|swap with minOut| R    R -->|fill| V    R -->|output, measured| U    R -->|2 bps| F[FeeDistributor]    F -->|10%| Ref([Referrer])    F -->|protocol share,<br/>Robinhood Chain| B[StoaBuyback]    B -->|buy and burn| S(("$STOA"))
  • The router never trusts a venue. It measures what the trader actually receives and reverts below minOut (standard tokens; see K-1 in the security review for tokens that tax transfers). Venues are allowlisted adapters; new ones wait in public before they go live.
  • Maker pools are quoted every block by bonded makers. When no maker quotes, swaps still fill on the best outside venue.
  • Uniswap V4 pools are registered permissionlessly in Stoa's adapter, limited to hooks on an allowlist fixed at deployment.

Governance and security

ElysiumRobinhood Chain
Router0x1047…7dbA0x2F28…3eE5
Owner of every contract48h timelock 0xeBa0…417B48h timelock 0xAC75…3ed8
Proposer and executor2-of-3 Safe 0xBF71…055F2-of-3 Safe 0xa1a4…D386
  • No upgradeable code. No proxies; a fix is a new deployment.
  • Every owner action waits 48 hours in public, and a new venue waits another 24 hours in the router itself. A guardian wallet can only pause swaps.
  • Every contract is source-verified on Sourcify (exact match), so the code here is the code that runs.
  • Not audited yet. Maker pools cap each fill at $500 and public LP vaults stay closed until an external audit. Design guarantees, trusted roles and known limits: contracts/SECURITY.md.

Every address: docs/contracts, or web/lib/deployments.json (Elysium) and web/lib/deployments-4663.json (Robinhood Chain).

$STOA

0x13E6…6718 on Robinhood Chain, launched on Pons. Two jobs, both enforced by contracts:

  1. Buyback and burn. StoaBuyback owns the Robinhood Chain FeeDistributor. Protocol fees can only leave it as a swap into $STOA through the Stoa router, burned in the same transaction. A keeper runs it weekly.
  2. Maker bonds. Makers bond $STOA in BondRegistry to quote Stoa pools on Robinhood Chain. Slashed bonds are burned.

$STOA pays no fee share and no yield. Details: docs/token.

Repository

FolderWhatStack
contracts/Router, maker pools, venue adapters, fee distributor, buyback, bond registry; deploy and governance scripts; unit, attack and live fork testsSolidity 0.8.28, Foundry
web/stoadex.com: trade, pools, earn, curators, $STOA, referrals, portfolio, admin console, docsNext.js 15, wagmi, viem, three.js
web/content/docs/The documentation at stoadex.com/docsMarkdown (GitBook format)
maker/Maker bot: quotes a Stoa pool every block from the Hyperliquid order book, with risk limitsTypeScript, viem
.github/workflows/CI, deployments, monitoring and the scheduled jobs belowGitHub Actions

Development

Requirements: Foundry, Node 22.

bash
git clone --recurse-submodules <repo-url> && cd stoa
# contracts: build, unit and attack testscd contracts && forge build && forge test
# live fork tests (read-only, against mainnet state)ELYSIUM_RPC_URL=https://rpc.elysium.kinetiq.xyz forge test --match-contract "ForkElysium|ForkVenues"ROBINHOOD_RPC_URL=https://rpc.mainnet.chain.robinhood.com forge test --match-contract ForkRobinhood
# web appcd ../web && npm install && cp .env.example .env.local && npm run dev
# maker bot (dry run)cd ../maker && npm install && cp .env.example .env && npm run build && DRY_RUN=1 npm start

The contracts have 93 tests: 73 unit and attack tests (including fuzzing) and 20 fork tests that trade against live pools, run governance through the real Safe and timelock, and check every allowed Uniswap V4 hook with a real buy and sell.

Automation

WorkflowWhenWhat
CIevery pushforge fmt, build with sizes, unit and Elysium fork tests; web and maker tests
Health checkhourlysite up, router not paused and quoting, keeper gas
Refresh Uniswap V4 poolsdailyranks the most traded V4 pools and registers new ones on both chains
$STOA graduation watcherevery 10 minregisters $STOA's Uniswap V4 pool as soon as it leaves the Pons curve
Robinhood governance stepshourly while pendingmoves timelocked Safe actions forward when they are due
$STOA buyback & burnweeklyturns Robinhood Chain protocol fees into burned $STOA
Deploy / smoke swapmanualdry run first, then broadcast; real swap round trip on mainnet

Security

Please report vulnerabilities privately: see SECURITY.md. Do not open a public issue for them.

License

The smart contracts in contracts/src are MIT licensed (contracts/LICENSE), as their SPDX headers state. The web app, maker bot, docs and brand assets are © Stoa, all rights reserved.

来源:README.md,提交 b061253

工具

13

list_tokens

List tokens

Tokens Stoa lists on a network, with address, symbol and decimals, plus the router address. Any other token address can still be quoted, but treat it as unverified and run safety_check first.

输入参数chain

quote

Quote a swap

Compare every venue Stoa routes for this exact amount and return the route it would fill: amountOut (after Stoa's 2 bps fee), minOut for the slippage, price impact and the venues. Read-only.

输入参数chainamount必填buyToken必填sellToken必填slippageBps

build_swap

Build an unsigned swap

Same as quote, plus the unsigned transaction (to, data, value, chainId) for the taker's wallet to sign, and the approval it needs first when selling a token. Stoa never signs or sends anything.

输入参数chaintaker必填amount必填buyToken必填referrersellToken必填slippageBpsdeadlineSeconds

safety_check

Token safety check

Simulate a small buy and an immediate sell-back of a token through Stoa's live router (eth_call, nothing sent), and read how concentrated its supply is. Returns verdict ok | caution | danger | unknown, buy and sell tax, round-trip cost, creator and top-10 holdings. A pass describes the token today; its owner can still change the rules.

输入参数chaintoken必填

bridge_quote

Bridge to Robinhood Chain

Move ETH, USDC or USDT from Base, Arbitrum, Ethereum, Optimism or BNB Chain to the same wallet on Robinhood Chain (arriving as ETH or USDG), through LI.FI over Across. Returns an unsigned transaction on the source chain that Stoa has already decoded: receiver and refund address are the wallet, destination is Robinhood Chain, it spends exactly the amount asked. If 'approval' is present, approve exactly that amount first. Regular wallets only.

输入参数amount必填wallet必填toTokenfromChain必填fromToken必填

market_context

Market context (CoinMarketCap)

CoinMarketCap data to put a trade in context: total crypto market cap and 24h change, BTC and ETH prices and dominance, the Fear and Greed index, and for up to 5 Robinhood Chain tokens their price, market cap, liquidity, 24h high/low, volume, trades, buyers and sellers. Use it before suggesting or explaining a trade; use quote for the price a swap actually gets.

输入参数tokens

stock_tokens

Robinhood stock tokens

Robinhood Stock Tokens on Robinhood Chain: Robinhood's price for the underlying stock next to the on-chain price, liquidity, 24h volume and whether Stoa can route a swap. Optionally filter by ticker.

输入参数symbolroutableOnly

stock_gaps

Stock token price gaps

Robinhood Stock Tokens whose on-chain price is furthest from Robinhood's own price right now: cheaper or dearer on-chain, among pools with real liquidity that actually trade (pools with under $100 of 24h volume and gaps over 25% are left out as stale). Optionally a 7-day history of one token's gap from Stoa's open dataset. Information, not trading advice; outside US market hours Robinhood's price follows the overnight session.

输入参数sidelimithistoryForminLiquidityUsd

open_data

Stoa open data

Stoa's public on-chain data: every swap routed through Stoa (newest first), the Points season 1 board, or the venue-quote basket (the same swaps quoted on every Robinhood Chain venue in one block). Also lists the open datasets on Hugging Face with their download links and checksums.

输入参数setlimit

spotlight

Spotlight this week

Stoa Spotlight on Robinhood Chain: projects bid ETH for 3 sponsored slots a week and $STOA holders lock and vote; voters share most of each winning bid. Returns the week, its phase (before_week_1, bids_open, votes_only) and closing times, the rules (quorum, min bid, entry fee), every candidate with its bid, votes, whether it wins if voting closed now, the votes it still needs and the ETH per 1M votes it would pay now, last week's winners and the $STOA locked. Give `token` and `votes` to estimate what that many more votes on that token would earn if it wins (an estimate: bids and votes move until the week closes). Sponsored, not reviewed: run safety_check before buying a Spotlight token.

输入参数tokenvotes

payment_status

Is a Stoa Pay link paid?

Whether a Stoa Pay link has been paid on Robinhood Chain, read from the chain: the paying transaction, who paid and when.

输入参数url必填

版本历史

2
  1. v1.1.0最新Nov 21, 2026
  2. v1.0.0Nov 19, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Chain 集成