Orderly One Dex_IT运维与安全 skill-PHP中文网

Orderly One Dex

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用 Orderly One API 创建并管理自定义 DEX：部署、自定义域名、毕业、主题化

有序网络: 有序 One DEQQOrderly One 是白标签的DEX平台.

功能概述

有序网络: 有序 One DEQQOrderly One 是白标签的DEX平台.是一项面向实际任务的技能，主要用于用户配置一个DEX( 名称, 品牌, 链条), API 叉一个 GitHub 模板 repo, 和 GitHub Actions 部署到。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

使用与执行

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

Orderly Network：Orderly One DEX

Orderly One 是一个白标 DEX 平台。用户配置 DEX（名称、品牌标识、支持链），API 会 Fork 一个 GitHub 模板仓库，并通过 GitHub Actions 自动部署至 GitHub Pages。完成“毕业”流程的 DEX 可获得手续费分成。

适用场景

构建自定义永续合约 DEX
管理 DEX 的部署、域名或主题样式
处理“毕业”流程以启用手续费共享

API 基础 URL

环境	基础 URL
Mainnet	`https://dex-api.orderly.network`
Testnet	`https://testnet-dex-api.orderly.network`

API 分类

使用 get_orderly_one_api_info MCP 工具获取全部端点的详细信息。

分类	说明	关键端点
auth	钱包签名认证	`/api/auth/nonce`, `/api/auth/verify`, `/api/auth/validate`
dex	DEX 的增删改查、域名配置与部署管理	`/api/dex`, `/api/dex/{id}`, `/api/dex/{id}/custom-domain`, `/api/dex/{id}/workflow-status`
theme	AI 驱动的主题生成	`/api/theme/modify`, `/api/theme/fine-tune`
graduation	从 Demo 版本升级为完整 DEX 并启用手续费共享	`/api/graduation/status`, `/api/graduation/fee-options`, `/api/graduation/verify-tx`
leaderboard	跨 DEX 排行榜	`/api/leaderboard`, `/api/leaderboard/broker/{brokerId}`
stats	平台统计数据	`/api/stats`, `/api/stats/swap-fee-config`

创建 / 更新 DEX

POST /api/dex（创建）与 PUT /api/dex/{id}（更新）均采用 multipart/form-data 编码格式。

必填字段

字段	类型	约束条件
`brokerName`	string	3–30 个字符，仅允许字母、数字、空格、点号（.）和短横线（-）

可选字段

链支持（Chains）：

字段	类型	说明
`chainIds`	number[]（JSON 格式）	例如：`[42161, 10, 8453]`
`defaultChain`	number	默认链 ID

品牌标识（Branding，文件上传）：

字段	类型	最大尺寸
`primaryLogo`	File	250 KB
`secondaryLogo`	File	100 KB
`favicon`	File	50 KB
`pnlPoster0..N`	File	每个 250 KB

主题样式（Theming）：

字段	类型	说明
`themeCSS`	string	用于覆盖默认主题的 CSS 变量
`tradingViewColorConfig`	string	图表颜色配置（JSON 格式）

社交链接（Social）：

字段	类型	说明
`telegramLink`	string	URL
`discordLink`	string	URL
`xLink`	string	URL

认证与钱包（Auth/Wallet）：

字段	类型	说明
`walletConnectProjectId`	string	WalletConnect 项目 ID
`privyAppId`	string	Privy 应用 ID
`privyTermsOfUse`	string	服务条款 URL
`privyLoginMethods`	string	以英文逗号分隔的登录方式列表
`enableAbstractWallet`	boolean	是否启用 Abstract 钱包
`disableEvmWallets`	boolean	是否禁用 EVM 钱包
`disableSolanaWallets`	boolean	是否禁用 Solana 钱包

网络环境（Network）：

字段	类型	说明
`disableMainnet`	boolean	是否禁用主网
`disableTestnet`	boolean	是否禁用测试网

交易功能（Trading）：

字段	类型	说明
`swapFeeBps`	number（取值范围：0–100）	兑换手续费（单位：基点），需确保 `enabledMenus` 中包含 “Swap”
`symbolList`	string	以英文逗号分隔的交易对列表（例如：`PERP_ETH_USDC`）

菜单配置（Menus）：

字段	类型	说明
`enabledMenus`	string	以英文逗号分隔；可选项包括：Trading、Portfolio、Markets、Leaderboard（默认启用）、Swap、Rewards、Vaults、Points
`customMenus`	string	格式为：`"Name,URL;Name2,URL2"`

SEO 设置（SEO）：

字段	类型	约束条件
`seoSiteName`	string	最多 100 字符
`seoSiteDescription`	string	最多 300 字符
`seoSiteLanguage`	string	支持 `"en"` 或 `"en-US"`
`seoSiteLocale`	string	例如：`"en_US"`
`seoTwitterHandle`	string	格式如：`"@handle"`
`seoThemeColor`	string	例如：`"#1a1b23"`
`seoKeywords`	string	最多 500 字符

其他设置（Other）：

字段	类型	说明
`availableLanguages`	string	JSON 数组格式；支持语言：en、zh、tc、ja、es、ko、vi、de、fr、ru、id、tr、it、pt、uk、pl、nl
`analyticsScript`	string	Base64 编码格式的分析脚本
`enableServiceDisclaimerDialog`	boolean	是否显示服务免责声明弹窗
`enableCampaigns`	boolean	是否启用 ORDER 代币活动及 Points 菜单
`restrictedRegions`	string	以英文逗号分隔的国家/地区名称（例如：`"United States,China"`）
`whitelistedIps`	string	IP 白名单

响应结果

创建成功（201）： { id, brokerId, brokerName, repoUrl, userId, createdAt }

更新成功（200）： 返回完整的 DEX 对象（含全部字段）

核心工作流

认证流程

向 POST /api/auth/nonce 提交 { address } → 获取待签名消息
签名内容："Sign this message to authenticate with Orderly One: {nonce}"
向 POST /api/auth/verify 提交 { address, signature } → 获取 JWT Token
后续所有请求均需携带请求头：Authorization: Bearer {token}

创建 DEX 流程

按上述字段组装 multipart/form-data 请求体
调用 POST /api/dex → 返回 { id, brokerId, repoUrl }
轮询 GET /api/dex/{id}/workflow-status，直至响应中 conclusion: "success"

毕业流程（手续费共享）

调用 GET /api/graduation/fee-options → 获取 USDC/ORDER 支付金额及 receiverAddress
在 Ethereum、Arbitrum 或 Base 网络上将对应代币转账至 receiverAddress
调用 POST /api/graduation/verify-tx，提交参数：{ txHash, chain, chainId, chainType: "EVM", brokerId, makerFee, takerFee, rwaMakerFee, rwaTakerFee, paymentType } → 创建 broker ID

broker ID 创建完成后，需完成管理员钱包注册：

EVM 钱包： 第 4 步：调用 Orderly Network API 完成注册：

GET https://api.orderly.org/v1/registration_nonce
使用 EIP-712 标准对以下数据签名：{ brokerId, chainId, timestamp, registrationNonce }
POST https://api.orderly.org/v1/register_account，提交参数：{ message, signature, userAddress, chainType: "EVM" }

调用 POST /api/graduation/finalize-admin-wallet（请求体为空）

Solana 钱包： 第 4 步：调用 Orderly Network API 完成注册：

GET https://api.orderly.org/v1/registration_nonce
使用 Solana 钱包对以下消息签名：{ brokerId, chainId: 900900900, timestamp, registrationNonce }
POST https://api.orderly.org/v1/register_account，提交参数：{ message, signature, userAddress, chainType: "SOL" }

调用 POST /api/graduation/finalize-admin-wallet（请求体为空）

EVM 多签钱包 / Gnosis Safe： 第 4 步：在 Safe 钱包中使用 Transaction Builder 创建批量交易：

目标地址（To）： Orderly Vault 合约（按链区分）
方法（Method）： delegateSigner
调用数据（Data）： [keccak256(brokerId), userAddress]

在 Safe 钱包中执行该批量交易（需满足签名人数要求）
调用 POST /api/graduation/finalize-admin-wallet，提交参数：{ multisigAddress, multisigChainId }

Orderly MCP

本技能依赖 Orderly MCP 服务。若尚未安装，请参考 orderly-onboarding 技能完成初始化配置。

工具： get_orderly_one_api_info

{ endpoint: "/api/dex" } —— 查询指定端点详情
{ category: "graduation" } —— 查询某分类下全部端点
{} —— 获取完整 API 概览

常见问题

问题	解决方案
DEX 部署卡住	调用 `/api/dex/{id}/workflow-runs/{runId}` 查看具体任务失败原因
自定义域名未生效	检查 CNAME 记录是否指向 `{org}.github.io`，并等待 DNS 生效
毕业验证失败	确认已向 `receiverAddress` 发起交易，并等待足够区块确认
Logo 上传失败	检查文件大小是否超出限制（主 Logo ≤ 250 KB，副 Logo ≤ 100 KB）
CSS 样式无效	提交前请校验 `themeCSS` 的语法正确性