orderly-one

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Orderly One — DEX Builder

Orderly One — DEX构建工具

Build, customize, and manage your own decentralized exchange (DEX) on Orderly Network using the Orderly One DEX-as-a-Service platform. Your DEX inherits Orderly's shared liquidity, central limit orderbook, and cross-chain settlement infrastructure — you focus on branding, community, and growth.

借助Orderly One DEX即服务平台，在Orderly Network上构建、定制并管理你自己的去中心化交易所（DEX）。你的DEX将继承Orderly的共享流动性、中心化限价订单簿和跨链结算基础设施——你只需专注于品牌、社区和增长。

Prerequisites

前提条件

Wallet: Agent must be running on Fly.io with
```
WALLET_SERVICE_URL
```
configured (EIP-191 signing via Privy)
No API keys needed: Authentication uses the agent's EVM wallet address + JWT tokens

钱包：Agent必须在Fly.io上运行，且已配置
```
WALLET_SERVICE_URL
```
（通过Privy实现EIP-191签名）
无需API密钥：认证使用Agent的EVM钱包地址 + JWT令牌

How It Works

工作原理

Orderly One lets you launch a white-label DEX with:

Shared orderbook liquidity from the entire Orderly Network
Multi-chain deployment (Arbitrum, Optimism, Base, Polygon, etc.)
Custom branding — name, logo, colors, domain
AI-powered theming — generate themes from text prompts
Graduation path — move from sandbox to production with your own broker ID

Authentication uses JWT tokens obtained via EIP-191 personal_sign (different from the Ed25519 auth used for Orderly trading).

Orderly One允许你推出白标DEX，具备以下特性：

共享订单簿流动性：来自整个Orderly Network的流动性
多链部署（Arbitrum、Optimism、Base、Polygon等）
自定义品牌——名称、Logo、配色、域名
AI驱动主题——通过文本提示生成主题
升级路径——从沙箱环境迁移到生产环境，并使用你自己的经纪商ID

认证采用通过EIP-191 personal_sign获取的JWT令牌（与Orderly交易使用的Ed25519认证不同）。

Tool Reference

工具参考

Tool	Auth	Purpose
`orderly_one_networks`	None	List supported chains for DEX deployment
`orderly_one_leaderboard`	None	DEX rankings, broker stats by volume/users
`orderly_one_stats`	None	Platform-wide aggregate statistics
`orderly_one_dex_get`	JWT	Get your DEX config or a specific DEX by ID
`orderly_one_dex_create`	JWT	Create a new DEX (name, chains, branding)
`orderly_one_dex_update`	JWT	Update DEX configuration
`orderly_one_dex_delete`	JWT	Delete a DEX (destructive)
`orderly_one_social_card`	JWT	Update social links and OG metadata
`orderly_one_domain`	JWT	Set or remove a custom domain
`orderly_one_visibility`	JWT	Toggle leaderboard visibility
`orderly_one_deploy_status`	JWT	Check deployment status, trigger upgrades
`orderly_one_theme`	JWT	AI theme generation and fine-tuning
`orderly_one_graduation`	JWT	Graduate DEX to production

工具	认证要求	用途
`orderly_one_networks`	无	列出支持DEX部署的链
`orderly_one_leaderboard`	无	DEX排名、按交易量/用户统计的经纪商数据
`orderly_one_stats`	无	平台级聚合统计数据
`orderly_one_dex_get`	JWT	获取你的DEX配置或通过ID查询特定DEX
`orderly_one_dex_create`	JWT	创建新DEX（名称、链、品牌）
`orderly_one_dex_update`	JWT	更新DEX配置
`orderly_one_dex_delete`	JWT	删除DEX（不可逆操作）
`orderly_one_social_card`	JWT	更新社交链接和OG元数据
`orderly_one_domain`	JWT	设置或移除自定义域名
`orderly_one_visibility`	JWT	切换在公开排行榜上的可见性
`orderly_one_deploy_status`	JWT	检查部署状态、触发升级
`orderly_one_theme`	JWT	AI主题生成与微调
`orderly_one_graduation`	JWT	将DEX升级到生产环境

Workflows

工作流程

Build a DEX

构建DEX

Check available networks:
```
orderly_one_networks
```
Create your DEX:
```
orderly_one_dex_create
```
with broker name and chain IDs
Check deployment:
```
orderly_one_deploy_status
```
(action: "status")
Configure branding:
```
orderly_one_social_card
```
with social links
Generate a theme:
```
orderly_one_theme
```
(action: "generate", prompt: "your style")

查看可用网络：
```
orderly_one_networks
```
创建你的DEX：使用
```
orderly_one_dex_create
```
，传入经纪商名称和链ID
检查部署状态：
```
orderly_one_deploy_status
```
（动作："status"）
配置品牌：使用
```
orderly_one_social_card
```
设置社交链接
生成主题：
```
orderly_one_theme
```
（动作："generate"，提示词："你的风格"）

Customize Your DEX

自定义DEX

Theme: Use
```
orderly_one_theme
```
with action "generate" for full themes or "fine_tune" for specific elements
Domain: Use
```
orderly_one_domain
```
to set a custom domain (requires DNS CNAME setup)
Social: Use
```
orderly_one_social_card
```
to configure Twitter, Discord, Telegram links and OG image
Visibility: Use
```
orderly_one_visibility
```
to show/hide on the public leaderboard

主题：使用
```
orderly_one_theme
```
，动作选择"generate"生成完整主题，或"fine_tune"调整特定元素
域名：使用
```
orderly_one_domain
```
设置自定义域名（需完成DNS CNAME配置）
社交：使用
```
orderly_one_social_card
```
配置Twitter、Discord、Telegram链接和OG图片
可见性：使用
```
orderly_one_visibility
```
设置在公开排行榜上的显示/隐藏状态

Graduate to Production

升级到生产环境

Check eligibility:
```
orderly_one_graduation
```
(action: "status")
Review fee options:
```
orderly_one_graduation
```
(action: "fees")
Make payment and verify:
```
orderly_one_graduation
```
(action: "verify", tx_hash, chain_id)
Finalize with admin wallet:
```
orderly_one_graduation
```
(action: "finalize", admin_wallet)

检查资格：
```
orderly_one_graduation
```
（动作："status"）
查看费用选项：
```
orderly_one_graduation
```
（动作："fees"）
支付并验证：
```
orderly_one_graduation
```
（动作："verify"，tx_hash, chain_id）
使用管理员钱包完成操作：
```
orderly_one_graduation
```
（动作："finalize"，admin_wallet）

Monitor & Upgrade

监控与升级

Check deployment status:
```
orderly_one_deploy_status
```
(action: "status")
Check for upgrades:
```
orderly_one_deploy_status
```
(action: "upgrade_check")
Trigger upgrade:
```
orderly_one_deploy_status
```
(action: "upgrade")
View workflow run details:
```
orderly_one_deploy_status
```
(action: "workflow", run_id)

检查部署状态：
```
orderly_one_deploy_status
```
（动作："status"）
检查可用升级：
```
orderly_one_deploy_status
```
（动作："upgrade_check"）
触发升级：
```
orderly_one_deploy_status
```
（动作："upgrade"）
查看工作流运行详情：
```
orderly_one_deploy_status
```
（动作："workflow"，run_id）

Supported Chains

支持的链

Use

orderly_one_networks

for the current list. Commonly supported:

Chain	Chain ID
Arbitrum	42161
Optimism	10
Base	8453
Polygon	137
Mantle	5000
Sei	1329

使用

orderly_one_networks

获取当前列表。常见支持的链：

链	链ID
Arbitrum	42161
Optimism	10
Base	8453
Polygon	137
Mantle	5000
Sei	1329

Error Handling

错误处理

401 Unauthorized: JWT expired — automatically refreshed on retry
403 Forbidden: Wallet not authorized for this DEX
404 Not Found: DEX ID doesn't exist
429 Rate Limited: Too many requests — check
```
orderly_one_deploy_status
```
rate limit status

401 Unauthorized：JWT过期——重试时会自动刷新
403 Forbidden：钱包未被授权访问此DEX
404 Not Found：DEX ID不存在
429 Rate Limited：请求过多——查看
```
orderly_one_deploy_status
```
的速率限制状态

Environment Variables

环境变量

Variable	Default	Description
`WALLET_SERVICE_URL`	Required	Privy wallet service URL
`ORDERLY_ONE_API_URL`	`https://api.dex.orderly.network`	API base URL

变量	默认值	描述
`WALLET_SERVICE_URL`	必填	Privy钱包服务URL
`ORDERLY_ONE_API_URL`	`https://api.dex.orderly.network`	API基础URL