= ({ page, onClick, isTopLevelPage }) => {
const router = useRouter();
- const isRouteSelected = router.pathname === page.route;
-
+ // const isRouteSelected = router.pathname === page.route;
+ const isRouteSelected = isPathMatch(router.asPath || router.pathname, page.route, router);
if (page.kind !== "Folder") {
return (
- {getPageTitle(page)}
+ {getPageTitleWithLocale(page, router.locale)}
);
diff --git a/src/components/shared/components/Layout/components/NavigationItem.tsx b/src/components/shared/components/Layout/components/NavigationItem.tsx
index 1726565e4..d22878f8b 100644
--- a/src/components/shared/components/Layout/components/NavigationItem.tsx
+++ b/src/components/shared/components/Layout/components/NavigationItem.tsx
@@ -1,4 +1,5 @@
import { ListItem } from "@mui/material";
+import { isPathStartWith, normalizePath } from "~/lib/helpers/router"; //导入工具函数
import clsx from "clsx";
import { useRouter } from "next/router";
import { createElement, useMemo } from "react";
@@ -21,17 +22,30 @@ export const NavigationItem = ({ item, isOpen, withLabel = true, onClick }: Navi
const router = useRouter();
+ // const isSelected = useMemo(() => {
+ // if (!url) {
+ // return false;
+ // }
+
+ // if (router.pathname === "/" || url === "/") {
+ // return url === router.pathname;
+ // }
+
+ // return router.pathname.startsWith(url);
+ // }, [url, router.pathname]);
const isSelected = useMemo(() => {
if (!url) {
return false;
}
-
- if (router.pathname === "/" || url === "/") {
- return url === router.pathname;
+
+ const currentPath = router.asPath || router.pathname;
+
+ if (currentPath === "/" || url === "/") {
+ return normalizePath(currentPath) === normalizePath(url);
}
-
- return router.pathname.startsWith(url);
- }, [url, router.pathname]);
+
+ return isPathStartWith(currentPath, url, router);
+ }, [url, router.asPath, router.pathname, router]);
return (
= ({ isMainPage,
{navSection.children
.filter((page) => page.route !== item.url)
+ // ✅ 添加去重逻辑：使用 Map 去重，只保留每个 route 的第一个页面
+ .reduce((acc, page) => {
+ if (!acc.find((p) => p.route === page.route)) {
+ acc.push(page);
+ }
+ return acc;
+ }, [] as typeof navSection.children)
.map((page) => (
{
+// const allPages = getAllPages();
+// const router = useRouter();
+// // ✅ 临时日志：查看页面结构
+// if (allPages.length > 0) {
+// console.log('🔵 getAllPages() 返回的页面:', allPages[7]);
+// }
+// const { flatDirectories, directoriesByRoute } = useMemo(() => getDirectories(allPages), [allPages]);
+
+// const dispatch = useAppDispatch();
+
+// useEffect(() => {
+// if (!allPages.length) return;
+
+// dispatch(setPages(allPages));
+// }, [allPages]);
+
+// useEffect(() => {
+// if (!flatDirectories.length || !directoriesByRoute) return;
+
+// dispatch(setDirectories({ flatDirectories, directoriesByRoute }));
+// }, [flatDirectories, directoriesByRoute]);
+// };
import { getAllPages } from "nextra/context";
+import { useRouter } from "next/router";
import { useEffect, useMemo } from "react";
import { useAppDispatch } from "../lib/app.store";
@@ -6,21 +37,128 @@ import { setDirectories, setPages } from "../lib/directories/directories.redux";
import { getDirectories } from "../lib/helpers/nextra";
export const useSetDirectoriesState = () => {
- const allPages = getAllPages();
+ const router = useRouter(); // 添加这一行获取当前 locale
+ const allPages = getAllPages();
+
+ // useEffect(() => {
+ // if (allPages.length > 0) {
+ // console.log('🔵 第一个页面对象结构:', {
+ // route: allPages[0].route,
+ // locale: (allPages[0] as any).locale,
+ // name: (allPages[0] as any).name,
+ // kind: allPages[0].kind,
+ // });
+ // // 打印前几个页面的详细信息
+ // allPages.slice(0, 3).forEach((page, idx) => {
+ // console.log(`🔵 页面 ${idx}:`, {
+ // route: page.route,
+ // locale: (page as any).locale,
+ // name: (page as any).name,
+ // kind: page.kind,
+ // });
+ // });
+ // }
+ // }, [allPages]);
+
+ // 从文件名或 route 中提取 locale
+ const extractLocaleFromPage = (page: typeof allPages[0]): string | null => {
+ // 方法 1: 从 page.locale 属性获取（如果存在）
+ if ('locale' in page && (page as any).locale) {
+ return (page as any).locale;
+ }
+
+ // 方法 2: 从 page.name 中提取（例如 "index.zh-CN" -> "zh-CN"）
+ if ('name' in page && (page as any).name) {
+ const name = (page as any).name as string;
+ const match = name.match(/\.(en-US|zh-CN)(\.|$)/);
+ if (match) {
+ return match[1];
+ }
+ }
+
+ // 方法 3: 从 route 中提取（例如 "/zh-CN/developers/evm" -> "zh-CN"）
+ if (page.route) {
+ const routeMatch = page.route.match(/\/(en-US|zh-CN)(\/|$)/);
+ if (routeMatch) {
+ return routeMatch[1];
+ }
+ }
+
+ // 如果没有找到 locale，返回 null（可能是默认语言或无 locale 的页面）
+ return null;
+ };
+
+ // 新增过滤逻辑（替换原来的日志代码）
+ // 根据当前 locale 过滤页面，避免显示重复内容
+ const filteredPages = useMemo(() => {
+ if (!router.locale || !allPages.length) return allPages;
+
+ // 过滤函数：根据 locale 属性过滤页面
+ const filterByLocale = (pages: typeof allPages, targetLocale: string): typeof allPages => {
+ return pages
+ .map((page) => {
+ if (page.kind === "Folder" && "children" in page) {
+ // 递归过滤子页面
+ const filteredChildren = filterByLocale(page.children, targetLocale);
+
+ // 如果过滤后没有子页面，不显示这个文件夹
+ if (filteredChildren.length === 0) return null;
+
+ return {
+ ...page,
+ children: filteredChildren,
+ };
+ } else {
+ // 从页面对象中提取 locale
+ const pageLocale = extractLocaleFromPage(page);
+
+ // 如果页面有明确的 locale 属性
+ if (pageLocale) {
+ // 如果匹配目标 locale，保留它
+ return pageLocale === targetLocale ? page : null;
+ }
+
+ // 如果页面没有 locale 属性：
+ // - 如果目标是默认语言，保留它（默认语言的页面可能没有 locale 后缀）
+ // - 如果目标不是默认语言，过滤掉它（没有 locale 后缀的页面应该只在默认语言时显示）
+ if (targetLocale === router.defaultLocale) {
+ return page;
+ }
+
+ // 非默认语言时，没有 locale 的页面应该被过滤掉
+ return null;
+ }
+ })
+ .filter((page): page is typeof allPages[0] => page !== null);
+ };
+
+ return filterByLocale(allPages, router.locale);
+ }, [allPages, router.locale, router.defaultLocale]);
- const { flatDirectories, directoriesByRoute } = useMemo(() => getDirectories(allPages), [allPages]);
+ // useEffect(() => {
+ // console.log('🔵 当前 locale:', router.locale);
+ // console.log('🔵 所有页面数量:', allPages.length);
+ // console.log('🔵 过滤后页面数量:', filteredPages.length);
+ // console.log('🔵 过滤后的第一个页面:', filteredPages[0]?.route, (filteredPages[0] as any)?.locale);
+ // }, [router.locale, allPages.length, filteredPages.length]);
+ // 使用 filteredPages 而不是 allPages
+ const { flatDirectories, directoriesByRoute } = useMemo(
+ () => getDirectories(filteredPages),
+ [filteredPages]
+ );
const dispatch = useAppDispatch();
+ // 使用 filteredPages 而不是 allPages
useEffect(() => {
- if (!allPages.length) return;
+ if (!filteredPages.length) return;
- dispatch(setPages(allPages));
- }, [allPages]);
+ dispatch(setPages(filteredPages));
+ }, [filteredPages, dispatch]);
useEffect(() => {
if (!flatDirectories.length || !directoriesByRoute) return;
dispatch(setDirectories({ flatDirectories, directoriesByRoute }));
}, [flatDirectories, directoriesByRoute]);
-};
+};
\ No newline at end of file
diff --git a/src/lib/data/meta-data.ts b/src/lib/data/meta-data.ts
new file mode 100644
index 000000000..3fabc74cc
--- /dev/null
+++ b/src/lib/data/meta-data.ts
@@ -0,0 +1,208 @@
+// 导入所有 _meta.json 文件
+// Root
+import enMetaRoot from '../../pages/_meta.en-US.json';
+import zhMetaRoot from '../../pages/_meta.zh-CN.json';
+
+// Start
+import enMetaStart from '../../pages/start/_meta.en-US.json';
+import zhMetaStart from '../../pages/start/_meta.zh-CN.json';
+
+// About
+import enMetaAbout from '../../pages/about/_meta.en-US.json';
+import zhMetaAbout from '../../pages/about/_meta.zh-CN.json';
+import enMetaAboutTokenUtility from '../../pages/about/token-utility/_meta.en-US.json';
+import zhMetaAboutTokenUtility from '../../pages/about/token-utility/_meta.zh-CN.json';
+import enMetaAboutServices from '../../pages/about/services/_meta.en-US.json';
+import zhMetaAboutServices from '../../pages/about/services/_meta.zh-CN.json';
+import enMetaAboutInfo from '../../pages/about/info/_meta.en-US.json';
+import zhMetaAboutInfo from '../../pages/about/info/_meta.zh-CN.json';
+
+// Developers
+import enMetaDevelopers from '../../pages/developers/_meta.en-US.json';
+import zhMetaDevelopers from '../../pages/developers/_meta.zh-CN.json';
+import enMetaDevelopersArchitecture from '../../pages/developers/architecture/_meta.en-US.json';
+import zhMetaDevelopersArchitecture from '../../pages/developers/architecture/_meta.zh-CN.json';
+import enMetaDevelopersChains from '../../pages/developers/chains/_meta.en-US.json';
+import zhMetaDevelopersChains from '../../pages/developers/chains/_meta.zh-CN.json';
+import enMetaDevelopersProtocol from '../../pages/developers/protocol/_meta.en-US.json';
+import zhMetaDevelopersProtocol from '../../pages/developers/protocol/_meta.zh-CN.json';
+import enMetaDevelopersStandards from '../../pages/developers/standards/_meta.en-US.json';
+import zhMetaDevelopersStandards from '../../pages/developers/standards/_meta.zh-CN.json';
+import enMetaDevelopersTutorials from '../../pages/developers/tutorials/_meta.en-US.json';
+import zhMetaDevelopersTutorials from '../../pages/developers/tutorials/_meta.zh-CN.json';
+import enMetaDevelopersEvm from '../../pages/developers/evm/_meta.en-US.json';
+import zhMetaDevelopersEvm from '../../pages/developers/evm/_meta.zh-CN.json';
+
+// Nodes
+import enMetaNodes from '../../pages/nodes/_meta.en-US.json';
+import zhMetaNodes from '../../pages/nodes/_meta.zh-CN.json';
+import enMetaNodesStartHere from '../../pages/nodes/start-here/_meta.en-US.json';
+import zhMetaNodesStartHere from '../../pages/nodes/start-here/_meta.zh-CN.json';
+import enMetaNodesValidate from '../../pages/nodes/validate/_meta.en-US.json';
+import zhMetaNodesValidate from '../../pages/nodes/validate/_meta.zh-CN.json';
+
+// Reference
+import enMetaReference from '../../pages/reference/_meta.en-US.json';
+import zhMetaReference from '../../pages/reference/_meta.zh-CN.json';
+import enMetaReferenceNetwork from '../../pages/reference/network/_meta.en-US.json';
+import zhMetaReferenceNetwork from '../../pages/reference/network/_meta.zh-CN.json';
+
+// Users
+import enMetaUsers from '../../pages/users/_meta.en-US.json';
+import zhMetaUsers from '../../pages/users/_meta.zh-CN.json';
+import enMetaUsersCli from '../../pages/users/cli/_meta.en-US.json';
+import zhMetaUsersCli from '../../pages/users/cli/_meta.zh-CN.json';
+import enMetaUsersCliGovernance from '../../pages/users/cli/governance/_meta.en-US.json';
+import zhMetaUsersCliGovernance from '../../pages/users/cli/governance/_meta.zh-CN.json';
+import enMetaUsersKeplr from '../../pages/users/keplr/_meta.en-US.json';
+import zhMetaUsersKeplr from '../../pages/users/keplr/_meta.zh-CN.json';
+import enMetaUsersLeap from '../../pages/users/leap/_meta.en-US.json';
+import zhMetaUsersLeap from '../../pages/users/leap/_meta.zh-CN.json';
+import enMetaUsersPingpub from '../../pages/users/pingpub/_meta.en-US.json';
+import zhMetaUsersPingpub from '../../pages/users/pingpub/_meta.zh-CN.json';
+import enMetaUsersZetahub from '../../pages/users/zetahub/_meta.en-US.json';
+import zhMetaUsersZetahub from '../../pages/users/zetahub/_meta.zh-CN.json';
+
+// 创建 meta 数据映射
+type MetaData = Record;
+type MetaDataMap = Record>;
+
+export const metaDataMap: MetaDataMap = {
+ 'en-US': {
+ '/': enMetaRoot,
+ '/start': enMetaStart,
+ '/about': enMetaAbout,
+ '/about/token-utility': enMetaAboutTokenUtility,
+ '/about/services': enMetaAboutServices,
+ '/about/info': enMetaAboutInfo,
+ '/developers': enMetaDevelopers,
+ '/developers/architecture': enMetaDevelopersArchitecture,
+ '/developers/chains': enMetaDevelopersChains,
+ '/developers/protocol': enMetaDevelopersProtocol,
+ '/developers/standards': enMetaDevelopersStandards,
+ '/developers/tutorials': enMetaDevelopersTutorials,
+ '/developers/evm': enMetaDevelopersEvm,
+ '/nodes': enMetaNodes,
+ '/nodes/start-here': enMetaNodesStartHere,
+ '/nodes/validate': enMetaNodesValidate,
+ '/reference': enMetaReference,
+ '/reference/network': enMetaReferenceNetwork,
+ '/users': enMetaUsers,
+ '/users/cli': enMetaUsersCli,
+ '/users/cli/governance': enMetaUsersCliGovernance,
+ '/users/keplr': enMetaUsersKeplr,
+ '/users/leap': enMetaUsersLeap,
+ '/users/pingpub': enMetaUsersPingpub,
+ '/users/zetahub': enMetaUsersZetahub,
+ },
+ 'zh-CN': {
+ '/': zhMetaRoot,
+ '/start': zhMetaStart,
+ '/about': zhMetaAbout,
+ '/about/token-utility': zhMetaAboutTokenUtility,
+ '/about/services': zhMetaAboutServices,
+ '/about/info': zhMetaAboutInfo,
+ '/developers': zhMetaDevelopers,
+ '/developers/architecture': zhMetaDevelopersArchitecture,
+ '/developers/chains': zhMetaDevelopersChains,
+ '/developers/protocol': zhMetaDevelopersProtocol,
+ '/developers/standards': zhMetaDevelopersStandards,
+ '/developers/tutorials': zhMetaDevelopersTutorials,
+ '/developers/evm': zhMetaDevelopersEvm,
+ '/nodes': zhMetaNodes,
+ '/nodes/start-here': zhMetaNodesStartHere,
+ '/nodes/validate': zhMetaNodesValidate,
+ '/reference': zhMetaReference,
+ '/reference/network': zhMetaReferenceNetwork,
+ '/users': zhMetaUsers,
+ '/users/cli': zhMetaUsersCli,
+ '/users/cli/governance': zhMetaUsersCliGovernance,
+ '/users/keplr': zhMetaUsersKeplr,
+ '/users/leap': zhMetaUsersLeap,
+ '/users/pingpub': zhMetaUsersPingpub,
+ '/users/zetahub': zhMetaUsersZetahub,
+ },
+};
+
+/**
+ * 根据 route 和 locale 获取 meta 标题
+ */
+// export const getMetaTitle = (route: string, locale: string, pageName?: string): string | null => {
+// const localeMeta = metaDataMap[locale as keyof typeof metaDataMap];
+// if (!localeMeta) return null;
+
+// // 找到匹配的路径
+// // 例如：/developers/evm -> /developers
+// const segments = route.split('/').filter(Boolean);
+
+// // 从根路径开始查找
+// for (let i = segments.length; i >= 0; i--) {
+// const path = '/' + segments.slice(0, i).join('/');
+// const meta = localeMeta[path];
+
+// if (meta && pageName) {
+// // 如果 meta 是对象，获取对应的页面标题
+// const pageMeta = (meta as any)[pageName];
+// if (pageMeta && typeof pageMeta === 'object' && 'title' in pageMeta) {
+// return pageMeta.title;
+// }
+// if (typeof pageMeta === 'string') {
+// return pageMeta;
+// }
+// }
+// }
+
+// return null;
+// };
+export const getMetaTitle = (route: string, locale: string, pageName?: string): string | null => {
+ const localeMeta = metaDataMap[locale as keyof typeof metaDataMap];
+ if (!localeMeta) return null;
+
+ const segments = route.split('/').filter(Boolean);
+
+ // 如果没有传入 pageName，从 route 中提取最后一个 segment
+ if (!pageName && segments.length > 0) {
+ pageName = segments[segments.length - 1];
+ }
+
+ if (!pageName) return null;
+
+ // 策略 1: 先尝试直接匹配当前路径的 meta（用于一级目录）
+ // 例如：/start 直接查找 /start 的 meta，pageName 可能是 "index"
+ const directMeta = localeMeta[route];
+ if (directMeta && typeof directMeta === 'object') {
+ const pageMeta = (directMeta as any)[pageName];
+ if (pageMeta) {
+ if (typeof pageMeta === 'object' && 'title' in pageMeta) {
+ return pageMeta.title;
+ }
+ if (typeof pageMeta === 'string') {
+ return pageMeta;
+ }
+ }
+ }
+
+ // 策略 2: 从父路径开始向上查找（用于二级及以上目录）
+ // 例如：/developers/evm -> 查找 /developers 的 meta 中的 evm
+ // 例如：/start -> 查找 / 的 meta 中的 start
+ for (let i = segments.length - 1; i >= 0; i--) {
+ const parentPath = '/' + segments.slice(0, i).join('/');
+ const parentMeta = localeMeta[parentPath];
+
+ if (parentMeta && typeof parentMeta === 'object') {
+ const pageMeta = (parentMeta as any)[pageName];
+ if (pageMeta) {
+ // 如果 pageMeta 是对象且有 title
+ if (typeof pageMeta === 'object' && 'title' in pageMeta) {
+ return pageMeta.title;
+ }
+ // 如果 pageMeta 是字符串
+ if (typeof pageMeta === 'string') {
+ return pageMeta;
+ }
+ }
+ }
+ }
+
+ return null;
+};
\ No newline at end of file
diff --git a/src/lib/helpers/nextra.ts b/src/lib/helpers/nextra.ts
index 66cb22d44..9d710bf94 100644
--- a/src/lib/helpers/nextra.ts
+++ b/src/lib/helpers/nextra.ts
@@ -1,6 +1,35 @@
import { startCase, toLower } from "lodash-es";
import { Page } from "nextra";
+import { useRouter } from "next/router";
+import { getMetaTitle } from "../data/meta-data";
+
+// 方案1：使用 hook（需要在组件中调用）
+export const useGetPageTitle = (page: Page) => {
+ const router = useRouter();
+
+ // 如果是 Folder 类型，尝试从 meta 数据映射获取
+ if (page.kind === "Folder" && router.locale) {
+ const metaTitle = getMetaTitle(page.route, router.locale, page.name);
+ if (metaTitle) return metaTitle;
+ }
+
+ // 回退到原来的逻辑
+ return page.meta?.title ? String(page.meta.title) : startCase(toLower(page.name));
+};
+
+// 方案2：直接传入 locale（如果需要在不使用 hook 的地方调用）
+export const getPageTitleWithLocale = (page: Page, locale?: string) => {
+ // 对于所有页面类型（Folder 和 MdxPage），都尝试从 meta 数据映射获取
+ if (locale) {
+ const metaTitle = getMetaTitle(page.route, locale, page.name);
+ if (metaTitle) return metaTitle;
+ }
+
+ // 回退到原来的逻辑
+ return page.meta?.title ? String(page.meta.title) : startCase(toLower(page.name));
+};
+
export const getPageTitle = (page: Page) =>
page.meta?.title ? String(page.meta.title) : startCase(toLower(page.name));
diff --git a/src/lib/helpers/router.ts b/src/lib/helpers/router.ts
new file mode 100644
index 000000000..9f19cbd5b
--- /dev/null
+++ b/src/lib/helpers/router.ts
@@ -0,0 +1,53 @@
+import { useRouter } from "next/router";
+
+/**
+ * 标准化路径，移除尾部斜杠（除非是根路径）
+ */
+export const normalizePath = (path: string): string => {
+ if (path === "/") return "/";
+ return path.replace(/\/$/, "") || "/";
+};
+
+/**
+ * 从路径中移除 locale 前缀
+ */
+export const removeLocalePrefix = (path: string, locales: string[] = ["en-US", "zh-CN"]): string => {
+ const localePattern = locales.map(locale => `/${locale}`).join("|");
+ const regex = new RegExp(`^(${localePattern})`);
+ return path.replace(regex, "");
+};
+
+/**
+ * 比较两个路径是否匹配（处理 locale 和尾部斜杠）
+ */
+export const isPathMatch = (path1: string, path2: string, router: ReturnType): boolean => {
+ // 标准化路径
+ let normalizedPath1 = normalizePath(path1);
+ let normalizedPath2 = normalizePath(path2);
+
+ // 如果 router.asPath 存在，使用它来获取完整路径（包含 locale）
+ // 但 router.pathname 通常不包含 locale，所以需要从 asPath 中移除 locale 来比较
+ const locales = router.locales || ["en-US", "zh-CN"];
+
+ // 移除 locale 前缀
+ normalizedPath1 = removeLocalePrefix(normalizedPath1, locales);
+ normalizedPath2 = removeLocalePrefix(normalizedPath2, locales);
+
+ // 再次标准化（处理移除 locale 后可能的双斜杠）
+ normalizedPath1 = normalizePath(normalizedPath1);
+ normalizedPath2 = normalizePath(normalizedPath2);
+
+ return normalizedPath1 === normalizedPath2;
+};
+
+/**
+ * 检查路径是否以某个前缀开始（处理 locale 和尾部斜杠）
+ */
+export const isPathStartWith = (fullPath: string, prefix: string, router: ReturnType): boolean => {
+ const normalizedFull = normalizePath(removeLocalePrefix(fullPath, router.locales || ["en-US", "zh-CN"]));
+ const normalizedPrefix = normalizePath(removeLocalePrefix(prefix, router.locales || ["en-US", "zh-CN"]));
+
+ if (normalizedPrefix === "/") return normalizedFull === "/";
+
+ return normalizedFull.startsWith(normalizedPrefix + "/") || normalizedFull === normalizedPrefix;
+};
\ No newline at end of file
diff --git a/src/middleware.js b/src/middleware.js
new file mode 100644
index 000000000..8047e5348
--- /dev/null
+++ b/src/middleware.js
@@ -0,0 +1,8 @@
+// src/middleware.js
+import { locales as nextraLocales } from "nextra/locales";
+
+export function middleware(request) {
+ console.log('🔵 Middleware 执行:', request.nextUrl.pathname);
+ console.log('🔵 Cookie:', request.cookies.get('NEXT_LOCALE')?.value);
+ return nextraLocales(request);
+}
\ No newline at end of file
diff --git a/src/pages/_meta.json b/src/pages/_meta.en-US.json
similarity index 100%
rename from src/pages/_meta.json
rename to src/pages/_meta.en-US.json
diff --git a/src/pages/_meta.zh-CN.json b/src/pages/_meta.zh-CN.json
new file mode 100644
index 000000000..6134c17f6
--- /dev/null
+++ b/src/pages/_meta.zh-CN.json
@@ -0,0 +1,24 @@
+{
+ "index": {
+ "title": "ZetaChain 文档"
+ },
+ "start": {
+ "title": "快速开始"
+ },
+ "developers": {
+ "title": "开发构建"
+ },
+ "reference": {
+ "title": "开发工具"
+ },
+ "nodes": {
+ "title": "运行节点"
+ },
+ "users": {
+ "title": "使用我们的产品"
+ },
+ "about": {
+ "title": "关于 ZetaChain"
+ }
+ }
+
\ No newline at end of file
diff --git a/src/pages/about/_meta.json b/src/pages/about/_meta.en-US.json
similarity index 100%
rename from src/pages/about/_meta.json
rename to src/pages/about/_meta.en-US.json
diff --git a/src/pages/about/_meta.zh-CN.json b/src/pages/about/_meta.zh-CN.json
new file mode 100644
index 000000000..60edd2e47
--- /dev/null
+++ b/src/pages/about/_meta.zh-CN.json
@@ -0,0 +1,15 @@
+{
+ "index": {
+ "title": "关于"
+ },
+ "token-utility": {
+ "title": "关于 ZETA 代币"
+ },
+ "services": {
+ "title": "应用与服务"
+ },
+ "info": {
+ "title": "更多信息"
+ }
+ }
+
\ No newline at end of file
diff --git a/src/pages/about/index.mdx b/src/pages/about/index.en-US.mdx
similarity index 100%
rename from src/pages/about/index.mdx
rename to src/pages/about/index.en-US.mdx
diff --git a/src/pages/about/index.zh-CN.mdx b/src/pages/about/index.zh-CN.mdx
new file mode 100644
index 000000000..7fef003f3
--- /dev/null
+++ b/src/pages/about/index.zh-CN.mdx
@@ -0,0 +1,20 @@
+---
+title: 关于
+description: 了解 ZetaChain，这条奠基性的公链让全链通用智能合约与任意区块链间消息成为可能。
+heroImgUrl: /img/pages/about.svg
+heroImgWidth: 562
+---
+
+import { KeyFeatures, RoadmapPillars, TechnicalRoadmap, WhatIsZetaChain } from "~/components/About";
+import { CurrentPageNavigationSections } from "~/components/shared";
+
+
+
+
+本文档中提及的任何第三方工具或服务仅供参考，并不构成对其可靠性、安全性或可信度的背书或保证。请在使用任何第三方工具前自行尽职调查并保持警惕。我们不对使用此类工具或服务所导致的任何损失或损害承担责任。
+
diff --git a/src/pages/about/info/_meta.json b/src/pages/about/info/_meta.en-US.json
similarity index 100%
rename from src/pages/about/info/_meta.json
rename to src/pages/about/info/_meta.en-US.json
diff --git a/src/pages/about/info/_meta.zh-CN.json b/src/pages/about/info/_meta.zh-CN.json
new file mode 100644
index 000000000..a949cb498
--- /dev/null
+++ b/src/pages/about/info/_meta.zh-CN.json
@@ -0,0 +1,12 @@
+{
+ "bounty": {
+ "title": "漏洞赏金计划"
+ },
+ "glossary": {
+ "title": "术语表"
+ },
+ "faq": {
+ "title": "常见问题"
+ }
+ }
+
\ No newline at end of file
diff --git a/src/pages/about/info/bug-bounty.mdx b/src/pages/about/info/bug-bounty.en-US.mdx
similarity index 100%
rename from src/pages/about/info/bug-bounty.mdx
rename to src/pages/about/info/bug-bounty.en-US.mdx
diff --git a/src/pages/about/info/bug-bounty.zh-CN.mdx b/src/pages/about/info/bug-bounty.zh-CN.mdx
new file mode 100644
index 000000000..c277651e6
--- /dev/null
+++ b/src/pages/about/info/bug-bounty.zh-CN.mdx
@@ -0,0 +1,11 @@
+ZetaChain 推出了覆盖面广的漏洞赏金计划，用于保障其 Web 应用、智能合约与区块链本身的安全。作为一条连接包括比特币在内多条网络、兼容 EVM 的一层公链，ZetaChain 致力于为跨链互操作应用打造坚固可靠的生态。
+
+该计划邀请安全研究人员定位并上报 ZetaChain 相关的 Web 应用、智能合约及区块链组件中的潜在漏洞。涵盖的风险类型包括业务逻辑漏洞、未授权交易、重入攻击、密码学缺陷等。赏金金额将依据漏洞的严重性与影响评估，尤其关注可能影响用户资金、共识机制或网络功能的关键问题。
+
+如欲参与，请通过 HackenProof 上的 ZetaChain 官方漏洞赏金平台提交所有安全发现：
+
+https://hackenproof.com/company/zetachain/programs
+
+研究人员须遵守负责任披露准则：在漏洞修复完成前，应保持保密，不得对外公开。
+
+赏金范围涵盖 ZetaChain 区块浏览器等 Web 应用、智能合约仓库及区块链组件。只有在指定范围内发现的漏洞才符合奖励条件。我们鼓励研究人员在遵守项目道德黑客规范的前提下，充分在允许范围内开展测试。***
\ No newline at end of file
diff --git a/src/pages/about/info/faq.mdx b/src/pages/about/info/faq.en-US.mdx
similarity index 100%
rename from src/pages/about/info/faq.mdx
rename to src/pages/about/info/faq.en-US.mdx
diff --git a/src/pages/about/info/faq.zh-CN.mdx b/src/pages/about/info/faq.zh-CN.mdx
new file mode 100644
index 000000000..7b55be184
--- /dev/null
+++ b/src/pages/about/info/faq.zh-CN.mdx
@@ -0,0 +1,72 @@
+---
+title: 常见问题
+description: 以下整理了大家最常问的问题，如未找到你的疑惑，欢迎加入 Discord 提问！团队与生态伙伴始终在线，乐于探讨新想法与问题。
+---
+
+import { globalLinks } from "~/constants";
+
+## 通用问题
+
+### 什么是 ZetaChain？
+
+ZetaChain 是一条兼容 EVM 的一层公链，可连接所有链。它让开发者轻松构建跨越任意链（包含比特币）的互操作 dApp。ZetaChain 支持跨链、跨层的价值转移、消息传递与智能合约调用，从而首次实现可读取并更新所有已连接网络状态的全链 dApp（odApp），并能够汇集多网络的流动性。
+
+在 [此处](/about) 了解更多 ZetaChain 详情。
+
+### 为什么 ZETA 会作为中介代币？中介代币是不是“不好”？
+
+ZETA 在网络中的用途广泛，其中包括跨链价值转移时的中介资产。就像 Ethereum 使用 ETH 支付 Gas 一样，ZETA 既是网络 Gas，也用于维护与激励网络去中心化（质押、绑定、惩罚等）。这些属性可验证地为 ZetaChain 的安全性、可持续性与扩展性提供坚实基础，尤其是与那些中心化、激励不足或长期不可持续的互操作方案相比。任何资产或数据仍然可以在已连接链之间自由转移。以 ZETA 作为跨链价值的计价单位还能最大程度降低攻击面，避免互操作领域常见的漏洞风险。
+
+在 [这里](/about/token-utility/token) 进一步了解 ZETA 代币。
+
+### 什么是 ZETA？
+
+ZETA 是 ZetaChain 的原生代币，也是最早在多链原生发行的代币之一。它在网络中扮演多重角色，包括跨链价值转移时的中介资产。除了充当 Gas 之外，ZETA 也用于维护网络去中心化——如质押、绑定、惩罚等。这些特性可验证地保障 ZetaChain 的安全、长寿与可扩展，相比许多中心化或激励不足的互操作方案更具可持续性。任何资产或数据仍可在已连接链之间流通，而跨链时以 ZETA 计价也极大压缩了攻击面，避免互操作项目常见的漏洞。
+
+### ZetaChain 的费用如何收取？
+
+当用户通过 ZetaChain 执行跨链操作时，只需在单笔交易中支付全部费用。所有费用（ZetaChain 网络手续费、目标链 Gas 等）都会在这笔交易里一次性结算。
+
+### 什么是全链 dApp？
+
+全链 dApp 是通过 ZetaChain 在不同区块链与扩容层上无缝运行的去中心化应用。它可以表现为部署在多条链上的智能合约，通过 ZetaChain 进行消息与价值传递；也可以是直接部署在 ZetaChain 上、并管理任意已连接链资产的智能合约；或者兼具两者。
+
+### ZetaChain 是“侧链”吗？
+
+不是。ZetaChain 是具备链无关互操作能力的一层智能合约区块链。它既不是侧链，也不是 Rollup，更不是传统意义的桥。
+
+### ZetaChain 与其他方案相比如何？
+
+截至目前，ZetaChain 在支持链无关全链 dApp 方面独树一帜。没有其他区块链能提供完全互操作的智能合约。这项能力让开发者得以像在单链上构建一样打造全链与跨链应用。尽管 Cosmos 等系统在 IBC 生态中提供互操作性，ZetaChain 则将无缝互操作拓展到所有链，包含比特币、狗狗币等非智能合约链。作为区块链与智能合约平台，ZetaChain 提供公开、透明、去中心化的互操作方案，同时支持全链消息与智能合约。开发者只需实现 dApp 业务逻辑，ZetaChain 会以最小信任假设处理跨链的数据与价值转移。不像 LayerZero 等方案需依赖第三方预言机/中继承担安全性——用户必须完全信任应用与中继 + 预言机——ZetaChain 以更简洁而稳健的信任模型完成跨链交易，开发者与用户只需信任网络即可完成数据与价值的传递。
+
+### ZetaChain 是桥吗？与桥有什么区别？
+
+ZetaChain 不是桥。本质上，它是一条区块链与互操作智能合约/消息平台。开发者可以基于 ZetaChain 构建满足特定需求的桥，此外 ZetaChain 也内建全链价值转移功能。通过 ZetaChain 转移价值无需包装资产；而包装资产与中心化托管往往是导致数亿美元亏损的事故关键（如 Wormhole、Poly Network 事件）。在 ZetaChain 中，静态资金不会因包装/锁定而暴露风险。
+
+### ZetaChain 的消息传递与智能合约有何不同？
+
+消息传递允许开发者在智能合约之间发送数据与价值，无论合约部署在 ZetaChain 还是已连接的链上。开发者可以像使用其他互操作消息协议（如 LayerZero）那样，在各链部署合约并通过 ZetaChain 传递消息；而 ZetaChain 的互操作智能合约则让开发者可以在单一位置编写全链逻辑，减少开销，并能控制比特币、狗狗币等非智能合约链。
+
+## 安全
+
+### 如果源链交易被回滚（例如 PoW 链遭攻击）时，ZetaChain 如何应对？
+
+当检测到深度链重组时，ZetaChain 会暂停运行，后续恢复将由包括 ZetaChain 验证人、核心团队、dApp 开发者与终端用户在内的多方共同协商。dApp 开发者应在应用中预留机制，以便在极端重组导致状态不一致时进行处理。
+
+### 是否有界面可以运行 PoS 验证人？
+
+请查阅 [验证人文档](/nodes/start-here/requirements)。
+
+## 测试网与主网
+
+### 主网何时上线？
+
+我们将很快公布测试网与 ZetaChain 主网的完整上线计划。请关注 Twitter、Discord 与 Telegram 获取更新。目前测试网已上线，你可以在上面构建 dApp。
+
+### 如何获取 ZETA？
+
+你可以在 Discord 服务器的 faucet 频道申请测试网 ZETA，或使用命令行水龙头。详情参见 [水龙头文档](/reference/faucet)。测试网 ZETA 没有、也不会具有任何货币价值，仅供体验与测试 ZetaChain 功能之用。
+
+### 测试网 ZETA 有价值吗？
+
+没有。测试网 ZETA 没有任何价值，未来也不会产生金钱价值。在测试网执行交易或获得 ZETA 仅用于测试。***
\ No newline at end of file
diff --git a/src/pages/about/info/glossary.mdx b/src/pages/about/info/glossary.en-US.mdx
similarity index 100%
rename from src/pages/about/info/glossary.mdx
rename to src/pages/about/info/glossary.en-US.mdx
diff --git a/src/pages/about/info/glossary.zh-CN.mdx b/src/pages/about/info/glossary.zh-CN.mdx
new file mode 100644
index 000000000..2b7d574d3
--- /dev/null
+++ b/src/pages/about/info/glossary.zh-CN.mdx
@@ -0,0 +1,63 @@
+---
+title: 术语表
+description: 本文汇总 ZetaChain 生态与开发过程中常见的术语定义。
+---
+
+## Chain Id（链 ID）
+
+每条 EVM 链都有独一无二的数字 ID。
+
+[Chainlist](https://chainlist.org/) 可根据链名称查询对应的 EVM 链 ID。
+
+## Core Validator（核心验证人）
+
+ZetaChain 采用 Tendermint 共识协议，这是一种部分同步的拜占庭容错（BFT）共识算法。每个验证人节点根据质押的 ZETA 数量获得相应投票权。验证人由其共识公钥标识，需保持全时在线参与区块提议与投票。作为回报，验证人可按质押金额比例获取区块奖励及潜在的 Gas、处理费等收益。
+
+## Cross-Chain（跨链）
+
+泛指在不同区块链之间传递数据或价值的行为。
+
+## Externally Managed Vault/Assets（外部托管金库/资产）
+
+凭借 TSS 架构，ZetaChain 验证人集合可在外部链上管理金库，正如该链上的账户一样运作。这让比特币等非智能合约链也能被 ZetaChain 上的合约托管。
+
+## Hyper-Connected Node（超连接节点）
+
+ZetaChain 节点会观察并处理所有已连接链上的交易。借助“超连接”能力，节点可以进行链无关的监测，从而实现互操作。
+
+## Multichain（多链）
+
+泛指跨越多条区块链的应用或概念。
+
+## Observer Validator（观察者验证人）
+
+观察者通过自身运行的全节点，监测外部连接链上特定地址的相关交易、事件或状态。
+
+## Omnichain（全链）
+
+好似所有区块链或层都联结成一条链。ZetaChain 是全链解决方案，具备链无关的互操作能力，可连接所有已接入的链。
+
+## Omnichain Messaging（全链消息）
+
+通过 ZetaChain 在多链之间无缝传递数据和/或价值。
+
+## Omnichain Smart Contracts（全链智能合约）
+
+ZetaChain 原生智能合约具备全链特性，可在已连接链上读写状态并管理资产。这类合约首开先河，使 dApp 能突破单一链或层的限制。
+
+## Revert（回退）
+
+在跨链交易中，如目标链交易失败（如资金不足、目标链状态变化等），ZetaChain 能够回退交易并将资金返还源链发送者。
+
+## Signer Validator（签名验证人）
+
+ZetaChain 持有用于与连接链认证交互的标准 ECDSA/EdDSA 密钥。密钥拆分给多个签名者，只有超级多数才能代表 ZetaChain 签名。必须确保任何单一实体或少量节点都无法独自为连接链签名。系统通过质押与正负激励保障经济安全。
+
+## TSS（阈值签名方案）
+
+为避免单点故障，ZetaChain 采用先进的多方阈值签名方案（TSS）。从外部看来，验证人集合共享一个 ECDSA/EdDSA 私钥、公钥与地址，签名可被连接链原生验证。内部则无中心化密钥生成者，私钥碎片分发给所有验证人；任何时刻都没有单个或少数验证人能拼接出完整私钥或代表网络签名。密钥生成与签名过程使用多方安全计算（MPC），不会泄露参与节点的私密信息。借助 TSS，ZetaChain 可以管理连接链上的原生金库/资金池（含比特币），从而为比特币等非智能合约链引入智能合约能力。ZetaChain 采用的 TSS 兼具热钱包的性能与冷钱包级别的安全性。
+
+## ZRC-20
+
+ZRC-20 是集成在 ZetaChain 全链智能合约平台上的代币标准。本质上，ZRC-20 是对以太坊 ERC-20 标准的扩展，新增了在所有已连接链上管理资产的能力。任何同质化代币（包括比特币、狗狗币、其他链的 ERC-20 等价物、链上 Gas 资产等）都可以在 ZetaChain 表示为 ZRC-20，并像普通 ERC-20 一样进行编排。***
+
diff --git a/src/pages/about/services/_meta.json b/src/pages/about/services/_meta.en-US.json
similarity index 100%
rename from src/pages/about/services/_meta.json
rename to src/pages/about/services/_meta.en-US.json
diff --git a/src/pages/about/services/_meta.zh-CN.json b/src/pages/about/services/_meta.zh-CN.json
new file mode 100644
index 000000000..49623276e
--- /dev/null
+++ b/src/pages/about/services/_meta.zh-CN.json
@@ -0,0 +1,38 @@
+{
+ "index": {
+ "title": "服务与提供方"
+ },
+ "wallets": {
+ "title": "钱包"
+ },
+ "the-graph": {
+ "title": "The Graph"
+ },
+ "alchemy": {
+ "title": "Alchemy"
+ },
+ "goldsky": {
+ "title": "Goldsky"
+ },
+ "pyth": {
+ "title": "Pyth"
+ },
+ "particle": {
+ "title": "Particle Network"
+ },
+ "envio": {
+ "title": "Envio"
+ },
+ "subquery": {
+ "title": "SubQuery"
+ },
+ "goldrush": {
+ "title": "GoldRush"
+ },
+ "space-id": {
+ "title": "Web3 Name SDK"
+ },
+ "onfinality": {
+ "title": "OnFinality"
+ }
+}
diff --git a/src/pages/about/services/alchemy.mdx b/src/pages/about/services/alchemy.en-US.mdx
similarity index 100%
rename from src/pages/about/services/alchemy.mdx
rename to src/pages/about/services/alchemy.en-US.mdx
diff --git a/src/pages/about/services/alchemy.zh-CN.mdx b/src/pages/about/services/alchemy.zh-CN.mdx
new file mode 100644
index 000000000..ff2d1819c
--- /dev/null
+++ b/src/pages/about/services/alchemy.zh-CN.mdx
@@ -0,0 +1,90 @@
+# Alchemy
+
+Alchemy 是一套区块链开发平台，提供构建与扩展去中心化应用所需的工具与基础设施。作为面向开发者的平台，Alchemy 帮助团队无需自建区块链基础设施，就能打造可扩展且可靠的 dApp。它通过提供一系列 API 与服务，简化与区块链网络的交互流程。
+
+Alchemy 的亮点之一是 Alchemy Supernode，可为连接并构建 ZetaChain 区块链提供可靠且可扩展的方式。借此，开发者能专注于功能创新，而无需担心节点运维的复杂度。
+
+借助 Alchemy，开发者可以访问实时区块链数据、管理智能合约，并监控跨多链的 dApp 运行情况，是构建稳健、可扩展、安全应用的多面手选择。
+
+## 注册 Alchemy 账号
+
+打开 https://auth.alchemy.com/signup，注册新账号或直接登录已有账号。
+
+
+
+## 创建新的 ZetaChain 项目
+
+在 Alchemy 控制台可查看当前账号下的全部项目。
+
+点击 “Create new app”，为项目填写名称与描述。
+
+
+
+
+
+Alchemy 中的所有应用默认即为多链。这意味着你的 dApp 创建后即可访问所有可用的 Alchemy 网络。可在 “Networks” 标签中查看全部网络及对应 API URL，并按需切换主网或测试网。
+
+
+
+## API Key 与 RPC 端点
+
+与 Alchemy RPC 实例的交互由 API key 保护。系统会自动为你生成 API key，可在应用页面右上角复制。
+
+同一页面也列出了所有支持链的 HTTP 与 WSS RPC 端点。找到 ZetaChain 网络并记录主网 URL，稍后会用它向 ZetaChain 发送请求。
+
+
+
+## 连接到 Alchemy
+
+如从零开始，可先创建目录并初始化 npm 项目：
+
+```
+mkdir zetachain-app
+cd zetachain-app
+npm init -y
+```
+
+使用 npm 安装 `axios`，这是一款常用的 HTTP 客户端，可用于发送 API 请求。
+
+```
+npm install axios
+```
+
+在项目目录下创建 `index.js`，粘贴以下代码，用于向 ZetaChain 网络发起请求。记得将 YOUR_API_KEY 替换为 Alchemy 控制台中的真实 API key。
+
+```ts
+const axios = require("axios");
+
+const url = `https://zetachain-mainnet.g.alchemy.com/v2/${YOUR_API_KEY}`;
+
+const payload = {
+ jsonrpc: "2.0",
+ id: 1,
+ method: "eth_blockNumber",
+ params: [],
+};
+
+axios
+ .post(url, payload)
+ .then((response) => {
+ console.log("Block Number:", parseInt(response.data.result));
+ })
+ .catch((error) => {
+ console.error(error);
+ });
+```
+
+使用 Node.js 运行脚本：
+
+```
+node index.js
+```
+
+终端应输出 ZetaChain 当前区块高度：
+
+```
+Block Number: 3688095
+```
+
+关于 ZetaChain 支持的全部 JSON-RPC 方法，请参阅 [Alchemy 文档](https://docs.alchemy.com/reference/zetachain-api-endpoints)。***
+
diff --git a/src/pages/about/services/apro.mdx b/src/pages/about/services/apro.en-US.mdx
similarity index 100%
rename from src/pages/about/services/apro.mdx
rename to src/pages/about/services/apro.en-US.mdx
diff --git a/src/pages/about/services/apro.zh-CN.mdx b/src/pages/about/services/apro.zh-CN.mdx
new file mode 100644
index 000000000..b3f99ce48
--- /dev/null
+++ b/src/pages/about/services/apro.zh-CN.mdx
@@ -0,0 +1,22 @@
+---
+title: APRO Oracle
+---
+
+## 概述
+
+[APRO Oracle](https://apro.com/) 结合链下计算与链上验证，提供可靠的价格预言机与数据服务。平台通过两种服务模式支持多链价格馈送：
+
+- **Data Push**：由去中心化节点运营者根据价格阈值或时间间隔推送数据更新到链上，提升扩展性并提供及时更新。
+- **Data Pull**：按需获取低延迟、高频率的数据，适用于需要快速数据且无需持续链上成本的 DeFi 协议与去中心化交易所。
+
+合约地址与支持的价格馈送请参阅 [价格馈送合约文档](https://docs.apro.com/en/data-push/price-feed-contract)。
+
+## 特性
+
+- 链下计算 + 链上验证
+- 可定制计算逻辑
+- TVWAP 价格发现机制
+- 多链支持
+
+更多集成指南与 API 文档请访问 [APRO 文档](https://docs.apro.com/en)。***
+
diff --git a/src/pages/about/services/envio.mdx b/src/pages/about/services/envio.en-US.mdx
similarity index 100%
rename from src/pages/about/services/envio.mdx
rename to src/pages/about/services/envio.en-US.mdx
diff --git a/src/pages/about/services/envio.zh-CN.mdx b/src/pages/about/services/envio.zh-CN.mdx
new file mode 100644
index 000000000..b648c2c5b
--- /dev/null
+++ b/src/pages/about/services/envio.zh-CN.mdx
@@ -0,0 +1,30 @@
+---
+title: Envio
+---
+
+## 概述
+
+Envio 是一款面向 EVM 兼容区块链的实时索引器，为开发者提供无缝、高效的链上数据索引方案。借助自动代码生成、灵活的语言支持等特性，Envio 提升了使用体验并简化开发流程。开发者可使用 JavaScript、TypeScript 或 ReScript 编写索引器。
+
+Envio 让链上数据索引变得简单快捷，具备高速同步与便捷的初始化流程，同时内置详尽的日志与错误信息，方便排查调试。
+
+
+ VIDEO
+
+
+## 核心特性
+
+- 自动代码生成：自动创建代码，节省时间。
+- 灵活语言支持：可使用 JavaScript、TypeScript 或 ReScript 编写索引器。
+- 同步速度快：体验高速的数据同步。
+- 简化配置：几乎无需设置即可快速上手。
+- 详尽日志：提供完整日志与错误信息，便于调试。***
+
diff --git a/src/pages/about/services/goldrush.mdx b/src/pages/about/services/goldrush.en-US.mdx
similarity index 100%
rename from src/pages/about/services/goldrush.mdx
rename to src/pages/about/services/goldrush.en-US.mdx
diff --git a/src/pages/about/services/goldrush.zh-CN.mdx b/src/pages/about/services/goldrush.zh-CN.mdx
new file mode 100644
index 000000000..1989d729a
--- /dev/null
+++ b/src/pages/about/services/goldrush.zh-CN.mdx
@@ -0,0 +1,153 @@
+---
+title: "GoldRush"
+---
+
+## 概述
+
+GoldRush API 为开发者提供统一接口，以快速、规模化地获取区块链历史数据，解决常见痛点：
+
+- 运行自建节点或使用公共节点的成本高且受限
+- 编写自定义 SQL 查询复杂
+- 数据索引等待时间长
+
+GoldRush 提供 RESTful API，采用一致的请求/响应结构。仅需替换 URL 中的网络名称，就能查询 200+ 支持网络中任意地址的全部代币余额。集成一次即可自动享受新网络支持、端点性能优化等更新。
+
+## 申请 GoldRush API Key
+
+使用 GoldRush API 前需注册账号并获取 API key。访问 [GoldRush 官网](https://goldrush.dev)，点击 “Signup for free API Key”，按提示填写信息并提交申请。
+
+
+
+提交后稍候，你将收到邀请邮件，点击链接完成注册。注册成功后即可获得访问 GoldRush API 所需的 API key，可在界面右上角复制备用。
+
+
+
+## 使用 GoldRush API
+
+GoldRush API 提供多种查询接口，如代币余额、交易、资产组合、区块等。除直接 HTTP 请求外，还支持 Python、TypeScript、Go、Ruby、Shell 等多语言 SDK。
+
+### 初始化项目
+
+使用以下命令初始化 npm 项目：
+
+```bash
+mkdir zetachain-app
+cd zetachain-app
+npm init -y
+```
+
+安装依赖：
+
+```bash
+npm install @covalenthq/client-sdk axios
+```
+
+### 查询代币余额
+
+以下示例演示如何通过 HTTP 请求与 TypeScript SDK 查询账户余额。
+
+#### 使用 HTTP 请求
+
+创建 `index.js` 并添加以下代码：
+
+```javascript
+const axios = require("axios");
+
+const apiKey = "your_api_key";
+const network = "zetachain-mainnet";
+const walletAddress = "your_wallet_address";
+const url = `https://api.covalenthq.com/v1/${network}/address/${walletAddress}/balances_v2/`;
+
+axios.get(url, {
+ auth: {
+ username: apiKey,
+ password: ""
+ },
+ headers: {
+ "Content-Type": "application/json"
+ }
+})
+.then((response) => {
+ console.log(JSON.stringify(response.data, null, 2));
+})
+.catch((error) => {
+ console.error("Request failed:", error);
+});
+```
+
+运行 `node index.js`，即可获得类似下面的结果：
+
+```json
+{
+ "data": {
+ "address": "0xece40cbb54d65282c4623f141c4a8a0be7d6adec",
+ "updated_at": "2024-08-28T10:17:28.671658047Z",
+ "next_update_at": "2024-08-28T10:22:28.671658318Z",
+ "quote_currency": "USD",
+ "chain_id": 7000,
+ "chain_name": "zetachain-mainnet",
+ "items": [
+ {
+ "contract_decimals": 18,
+ "contract_name": "Zeta",
+ "contract_ticker_symbol": "ZETA",
+ "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+ "supports_erc": [],
+ "logo_url": "https://www.datocms-assets.com/86369/1693331953-zetachain-colour.png",
+ "contract_display_name": "Zeta",
+ "logo_urls": {
+ "token_logo_url": "https://logos.covalenthq.com/tokens/7000/0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee.png",
+ "protocol_logo_url": null,
+ "chain_logo_url": "https://www.datocms-assets.com/86369/1693503842-zetachain-icon-white.svg"
+ },
+ "last_transferred_at": null,
+ "native_token": true,
+ "type": "cryptocurrency",
+ "is_spam": false,
+ "balance": "129029144648174752049",
+ "balance_24h": "129029144648174752049",
+ "quote_rate": 0.50380385,
+ "quote_rate_24h": 0.49448004,
+ "quote": 65.00538,
+ "pretty_quote": "$65.01",
+ "quote_24h": 63.802338,
+ "pretty_quote_24h": "$63.80",
+ "protocol_metadata": null,
+ "nft_data": null
+ }
+ ]
+ },
+ "error": false,
+ "error_message": null,
+ "error_code": null
+}
+```
+
+#### 使用 TypeScript SDK
+
+官方 SDK 往往更便捷。在 `index.js` 中复制以下代码：
+
+```javascript
+const { GoldRushClient } = require("@covalenthq/client-sdk");
+
+const apiKey = "your_api_key";
+const network = "zetachain-mainnet";
+const walletAddress = "your_wallet_address";
+
+const apiServices = async () => {
+ try {
+ const client = new GoldRushClient(apiKey);
+ const resp = await client.BalanceService.getTokenBalancesForWalletAddress(network, walletAddress);
+ console.log(resp.data);
+ } catch (error) {
+ console.error("An error occurred:", error);
+ }
+};
+
+apiServices().catch(console.error);
+```
+
+运行 `node index.js`，可获得与上述类似的结果。
+
+更多关于 GoldRush API 与 ZetaChain 集成的教程，请参阅 [ZetaChain Blockchain Data Indexing API](https://goldrush.dev/docs/networks/zetachain/) 文档。***
+
diff --git a/src/pages/about/services/goldsky.mdx b/src/pages/about/services/goldsky.en-US.mdx
similarity index 100%
rename from src/pages/about/services/goldsky.mdx
rename to src/pages/about/services/goldsky.en-US.mdx
diff --git a/src/pages/about/services/goldsky.zh-CN.mdx b/src/pages/about/services/goldsky.zh-CN.mdx
new file mode 100644
index 000000000..106462c13
--- /dev/null
+++ b/src/pages/about/services/goldsky.zh-CN.mdx
@@ -0,0 +1,286 @@
+---
+title: "子图：Goldsky"
+---
+
+## 概述
+
+本教程演示如何使用子图索引器查询全链合约事件数据。示例中我们将使用 [Goldsky](https://docs.goldsky.com/) 子图。
+
+在开始之前，假设你已经完成[跨链兑换教程](/developers/tutorials/swap/)。如果需要合约完整源码，可在 [`example-contracts` 仓库](https://github.com/zeta-chain/example-contracts/tree/main/omnichain/swap) 获取。
+
+## 为 Swap 合约添加事件
+
+新增 `SwapCompleted` 事件，用于在跨链兑换成功后触发：
+
+```solidity {13-18,81-86}
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.7;
+
+import "@zetachain/protocol-contracts/contracts/zevm/SystemContract.sol";
+import "@zetachain/protocol-contracts/contracts/zevm/interfaces/zContract.sol";
+import "@zetachain/toolkit/contracts/SwapHelperLib.sol";
+import "@zetachain/toolkit/contracts/BytesHelperLib.sol";
+
+contract Swap is zContract {
+ SystemContract public immutable systemContract;
+ uint256 constant BITCOIN = 18332;
+
+ event SwapCompleted(
+ address indexed zrc20,
+ address indexed targetToken,
+ uint256 amount,
+ bytes recipient
+ );
+
+ constructor(address systemContractAddress) {
+ systemContract = SystemContract(systemContractAddress);
+ }
+
+ modifier onlySystem() {
+ require(
+ msg.sender == address(systemContract),
+ "Only system contract can call this function"
+ );
+ _;
+ }
+
+ function onCrossChainCall(
+ zContext calldata context,
+ address zrc20,
+ uint256 amount,
+ bytes calldata message
+ ) external virtual override onlySystem {
+ address targetTokenAddress;
+ bytes memory recipientAddress;
+
+ if (context.chainID == BITCOIN) {
+ targetTokenAddress = BytesHelperLib.bytesToAddress(message, 0);
+ recipientAddress = abi.encodePacked(
+ BytesHelperLib.bytesToAddress(message, 20)
+ );
+ } else {
+ (address targetToken, bytes memory recipient) = abi.decode(
+ message,
+ (address, bytes)
+ );
+ targetTokenAddress = targetToken;
+ recipientAddress = recipient;
+ }
+
+ (address gasZRC20, uint256 gasFee) = IZRC20(targetTokenAddress)
+ .withdrawGasFee();
+
+ uint256 inputForGas = SwapHelperLib.swapTokensForExactTokens(
+ systemContract.wZetaContractAddress(),
+ systemContract.uniswapv2FactoryAddress(),
+ systemContract.uniswapv2Router02Address(),
+ zrc20,
+ gasFee,
+ gasZRC20,
+ amount
+ );
+
+ uint256 outputAmount = SwapHelperLib._doSwap(
+ systemContract.wZetaContractAddress(),
+ systemContract.uniswapv2FactoryAddress(),
+ systemContract.uniswapv2Router02Address(),
+ zrc20,
+ amount - inputForGas,
+ targetTokenAddress,
+ 0
+ );
+
+ IZRC20(gasZRC20).approve(targetTokenAddress, gasFee);
+ IZRC20(targetTokenAddress).withdraw(recipientAddress, outputAmount);
+
+ emit SwapCompleted(
+ zrc20,
+ targetTokenAddress,
+ outputAmount,
+ recipientAddress
+ );
+ }
+}
+```
+
+## 编译并部署合约
+
+```
+yarn
+
+npx hardhat compile --force
+
+npx hardhat deploy --network zeta_testnet
+```
+
+```
+🔑 Using account: 0x2cD3D070aE1BD365909dD859d29F387AA96911e1
+
+🚀 Successfully deployed contract on ZetaChain.
+📜 Contract address: 0x9846BBdE15B857d88DDad4e00CD76962245E1b6f
+🌍 Explorer: https://zetascan.com/address/0x9846BBdE15B857d88DDad4e00CD76962245E1b6f
+```
+
+## 配置 Goldsky
+
+安装 [Goldsky CLI](https://docs.goldsky.com/introduction)：
+
+```
+curl https://goldsky.com | sh
+```
+
+然后在 https://app.goldsky.com [创建账号](https://docs.goldsky.com/get-started/subgraphs)，于设置页生成 API key，并登录 CLI：
+
+```
+goldsky login
+```
+
+按提示粘贴 API key。
+
+在项目根目录创建 Goldsky 配置文件：
+
+```json filename="goldsky.json"
+{
+ "version": "1",
+ "name": "swap",
+ "abis": {
+ "swap": {
+ "path": "artifacts/contracts/Swap.sol/Swap.json"
+ }
+ },
+ "chains": ["zetachain-testnet"],
+ "instances": [
+ {
+ "abi": "swap",
+ "address": "0x9846BBdE15B857d88DDad4e00CD76962245E1b6f",
+ "chain": "zetachain-testnet",
+ "startBlock": 3065396
+ }
+ ]
+}
+```
+
+将 `address` 与 `startBlock` 更新为你部署合约时的实际值。
+
+创建子图：
+
+```
+goldsky subgraph deploy swap/v1 --from-abi goldsky.json
+```
+
+```
+◇ Subgraph generated, deploying to your goldsky project
+│
+◇ Deployed subgraph API: https://api.goldsky.com/api/public/project_clnujea22c0if34x5965c8c0j/subgraphs/swap-zetachain-testnet/v1/gn
+```
+
+## 与合约交互
+
+子图部署完成后，可执行跨链兑换与合约交互。示例中我们将 5 枚 tMATIC 兑换为 BTC。
+
+```
+npx hardhat interact --contract 0x9846BBdE15B857d88DDad4e00CD76962245E1b6f --amount 5 --network mumbai_testnet --target-token 0x65a45c57636f9BcCeD4fe193A602008578BcA90b --recipient tb1q2dr85d57450xwde6560qyhj7zvzw9895hq25tx
+```
+
+```
+🔑 Using account: 0x2cD3D070aE1BD365909dD859d29F387AA96911e1
+
+🚀 Successfully broadcasted a token transfer transaction on mumbai_testnet network.
+📝 Transaction hash: 0xb4318f04329d6ddd398b11ccba40d0404e1872494a054fb382267e2f1de160e9
+```
+
+可通过以下命令跟踪交易：
+
+```
+npx hardhat cctx 0xb4318f04329d6ddd398b11ccba40d0404e1872494a054fb382267e2f1de160e9
+```
+
+```
+CCTXs on ZetaChain found.
+
+✓ 0xf5fbf1ba190e074c64adaba044e2c4f6724aeebe70ca01b0998919d0b1059338: 80001 → 7001: OutboundMined (Remote omnichain contract call completed)
+⠏ 0xa0cfd783f991bd060239193082594dd3fe5ae239e97b8baaa0a303ee6ba6ba79: 7001 → 18332: PendingOutbound
+```
+
+当看到跨链交易进入 `PendingOutbound` 状态（示例中为 ZetaChain → Bitcoin，即 `7001 → 18332`）时，说明兑换已成功，`SwapCompleted` 事件应已触发。
+
+## 查询子图事件
+
+访问部署子图时输出的 API 地址（你的地址可能不同）：
+
+```
+https://api.goldsky.com/api/public/project_clnujea22c0if34x5965c8c0j/subgraphs/swap-zetachain-testnet/v1/gn
+```
+
+页面会显示 GraphQL Playground，可用于查询事件：
+
+```graphql
+query {
+ swapCompleteds(first: 5) {
+ id
+ }
+}
+```
+
+你将看到 `SwapCompleted` 事件 ID 列表：
+
+```json
+{
+ "data": {
+ "swapCompleteds": [
+ {
+ "id": "0xbfcc4e8ea59625da42aa3eec6e5aba66bcd120f8e83dea8dc855ebd1d834e1e6-25"
+ }
+ ]
+ }
+}
+```
+
+还可查询特定事件的详细信息：
+
+```graphql
+query {
+ swapCompleteds(where: { id: "0xbfcc4e8ea59625da42aa3eec6e5aba66bcd120f8e83dea8dc855ebd1d834e1e6-25" }) {
+ id
+ block_number
+ timestamp_
+ transactionHash_
+ contractId_
+ zrc20
+ targetToken
+ amount
+ recipient
+ }
+}
+```
+
+返回结果将包含从合约事件中发出的全部数据：
+
+```json
+{
+ "data": {
+ "swapCompleteds": [
+ {
+ "id": "0xbfcc4e8ea59625da42aa3eec6e5aba66bcd120f8e83dea8dc855ebd1d834e1e6-25",
+ "block_number": "3065437",
+ "timestamp_": "1704357233",
+ "transactionHash_": "0xbfcc4e8ea59625da42aa3eec6e5aba66bcd120f8e83dea8dc855ebd1d834e1e6",
+ "contractId_": "0x9846bbde15b857d88ddad4e00cd76962245e1b6f",
+ "zrc20": "0x48f80608b672dc30dc7e3dbbd0343c5f02c738eb",
+ "targetToken": "0x65a45c57636f9bcced4fe193a602008578bca90b",
+ "amount": "369767",
+ "recipient": "0x74623171326472383564353734353078776465363536307179686a377a767a7739383935687132357478"
+ }
+ ]
+ }
+}
+```
+
+恭喜！你已通过 Goldsky 子图索引器成功查询全链合约事件。想进一步了解 Goldsky，请访问 [Goldsky 文档](https://docs.goldsky.com/)。
+
+## 常见问题
+
+### 事件未被索引
+
+请等待来自 Goldsky 的邮件，确认子图已完成索引。***
+
diff --git a/src/pages/about/services/index.mdx b/src/pages/about/services/index.en-US.mdx
similarity index 100%
rename from src/pages/about/services/index.mdx
rename to src/pages/about/services/index.en-US.mdx
diff --git a/src/pages/about/services/index.zh-CN.mdx b/src/pages/about/services/index.zh-CN.mdx
new file mode 100644
index 000000000..1836a52d0
--- /dev/null
+++ b/src/pages/about/services/index.zh-CN.mdx
@@ -0,0 +1,32 @@
+---
+title: 服务与提供方
+---
+
+以下列出兼容 ZetaChain、可为开发者提供支持的服务。
+
+| 类型 | 服务 | 网站 |
+| ---- | ---- | ---- |
+| RPC | BlockPI | https://blockpi.io |
+| RPC | InfStones | https://infstones.com/fast-api |
+| RPC | BlastAPI | https://blastapi.io/ |
+| RPC | All That Node | https://www.allthatnode.com/ |
+| RPC | NOWNodes | https://nownodes.io/ |
+| API | Covalent | https://www.covalenthq.com/ |
+| Wallet as a Service | Particle Network | https://particle.network |
+| Wallet as a Service | Magic | https://magic.link/ |
+| Account Abstraction | Biconomy | https://www.biconomy.io/ |
+| Subgraph | Goldsky | https://goldsky.com/ |
+| Subgraph | Envio | https://envio.dev/ |
+| Subgraph & SubQuery | OnFinality | https://onfinality.io |
+| Wallet | MetaMask | https://metamask.io/ |
+| Wallet | Coinbase Wallet | https://www.coinbase.com/wallet |
+| Wallet | XDEFI Wallet | https://xdefi.io |
+| Wallet | Keplr | https://keplr.app/ |
+| Wallet | Leap | https://www.leapwallet.io/ |
+| Wallet | Safe | https://safe.zetachain.com/ |
+| Oracle | Pyth | https://pyth.network/ |
+| Data Provider | Mobula | https://mobula.io/ |
+| Development Platform | Tenderly | [https://tenderly.co/](https://tenderly.co/?mtm_campaign=ext-docs&mtm_kwd=zetachain) |
+
+如果表格缺少了支持 ZetaChain 的开发者服务，请[提交 Pull Request](https://github.com/zeta-chain/docs/blob/main/src/pages/about/services/index.mdx) 帮助我们保持最新。***
+
diff --git a/src/pages/about/services/onfinality.mdx b/src/pages/about/services/onfinality.en-US.mdx
similarity index 100%
rename from src/pages/about/services/onfinality.mdx
rename to src/pages/about/services/onfinality.en-US.mdx
diff --git a/src/pages/about/services/onfinality.zh-CN.mdx b/src/pages/about/services/onfinality.zh-CN.mdx
new file mode 100644
index 000000000..3acca39c9
--- /dev/null
+++ b/src/pages/about/services/onfinality.zh-CN.mdx
@@ -0,0 +1,61 @@
+---
+title: "OnFinality"
+---
+
+## OnFinality
+[OnFinality](https://onfinality.io) 是一套区块链基础设施平台，旨在为 Web3 构建者节省时间、降低复杂度。它为大型区块链团队提供可扩展的 API 端点、节点以及业内领先的数据索引托管服务。
+
+OnFinality Indexing 现已为 ZetaChain 提供企业级的 SubQuery 与 Subgraph 托管服务，让你的关键资产——数据——始终安全无忧。
+
+本教程将演示如何运行新的 ZetaChain SubQuery 项目。若需了解几乎相同的 [Subgraph 索引流程](https://documentation.onfinality.io/support/publishing-your-subgraph-project)，请参阅链接。
+
+## 准备工作
+
+开始前请确保你已具备：
+- 针对 ZetaChain 网络的可用 SubQuery 项目
+- 项目的 GitHub 仓库或托管于 IPFS 的版本（示例使用 `QmeUwNvKGoaL211UfgEm2kbSztFCTJ2RuCXzbRRUacCaFx`）
+- OnFinality Indexing Service 账户
+
+## 创建 ZetaChain 索引项目
+
+访问 [OnFinality Indexing](https://indexing.onfinality.io/) 服务创建首个项目。需使用 GitHub 账户进行登录认证。
+
+
+
+点击 “Create Project” 进入新建表单。选择要部署的项目类型（SubQuery），填写名称与描述。
+
+
+
+## 部署项目
+
+创建项目仅设置展示信息，必须部署版本后才会生效。部署将启动索引流程，并配置所需的查询服务以响应 GraphQL 请求。你也可以在此页面为现有项目部署新版本。
+
+新项目会显示 “Deploy your first version” 按钮。
+
+
+
+点击后填写部署信息：
+
+
+- **CID：** 填写准备阶段获取的 IPFS 部署 CID
+- **Manifest：** 从 CID 内容解析出的详情，用于校验部署是否正确
+
+- **Query Version：** 选择运行 SubQuery 查询服务的版本，建议使用最新版本
+- **Advanced Settings：** 高级设置较多，可参考内置帮助说明
+
+- **Network Endpoints：** 用于读取 ZetaChain 数据的 RPC 端点
+
+提交后，OnFinality 会开始索引项目。根据 ZetaChain 当前链状态与查询配置，完整同步可能需要数分钟。
+
+## 连接项目
+
+部署完成并且节点完成数据索引后，你即可通过界面显示的 GraphQL Query 端点连接项目。
+
+
+
+或者点击项目标题旁的三点图标，在 SubQuery Explorer 中查看，并使用浏览器内置的 Playground 进行查询。
+
+至此，你已具备在 ZetaChain 上构建快速、可扩展且数据丰富的 dApp 所需的一切。
+
+需要帮助？请联系 support@onfinality.io。***
+
diff --git a/src/pages/about/services/particle.mdx b/src/pages/about/services/particle.en-US.mdx
similarity index 100%
rename from src/pages/about/services/particle.mdx
rename to src/pages/about/services/particle.en-US.mdx
diff --git a/src/pages/about/services/particle.zh-CN.mdx b/src/pages/about/services/particle.zh-CN.mdx
new file mode 100644
index 000000000..0b94e98fc
--- /dev/null
+++ b/src/pages/about/services/particle.zh-CN.mdx
@@ -0,0 +1,27 @@
+---
+title: "账户抽象：Particle Network"
+---
+
+## 概述
+
+Particle Network 提供一套完整工具与服务，旨在提升 ZetaChain 上去中心化应用（dApp）的用户体验。
+
+Particle Network 技术栈原生支持 [ERC-4337 账户抽象](https://eips.ethereum.org/EIPS/eip-4337)，让开发者能够从用户初次接入到最终的用户操作构造与赞助，全程使用智能账户。
+
+Particle Network 还提供 Wallet as a Service（WaaS），作为浏览器扩展钱包的替代方案，允许用户通过传统 Web 应用常见的方式创建非托管账户，例如社交登录或邮箱/密码。WaaS 被嵌入到 Web 应用中，用户无需安装额外软件即可与 dApp 交互。
+
+Particle Network 技术栈的主要组件包括：
+
+- [Wallet as a Service](https://particlenetwork.readme.io/docs/understanding-wallet-as-a-service)（WaaS）。用户可通过社交登录或邮箱/密码进入 dApp。在“传统” WaaS 模式中，登录后会生成外部账户（EOA）。若结合账户抽象，则该 EOA 仅作中间层，最终为用户分配用于交互的智能账户。
+- 账户抽象（AA）
+ - [Bundler](https://particlenetwork.readme.io/docs/bundler)：Particle Network 在 AA 技术栈中提供开源 Bundler，用于构建并发送所有 `userOperation`。
+ - [Paymaster](https://particlenetwork.readme.io/docs/paymaster)：与 Bundler 配套，Particle Network 也提供 Paymaster，用于多链 Gas 赞助。
+
+Particle Network 技术栈具备模块化特性，开发者可按需选用组件。
+
+## 下一步
+
+想进一步了解如何使用 Particle Network WaaS 在 ZetaChain 上构建 dApp，推荐阅读下列教程，示例展示了如何在基于 React 的 Web 应用中集成钱包：
+
+https://particlenetwork.readme.io/docs/leveraging-particle-network-on-zetachain***
+
diff --git a/src/pages/about/services/pyth.mdx b/src/pages/about/services/pyth.en-US.mdx
similarity index 100%
rename from src/pages/about/services/pyth.mdx
rename to src/pages/about/services/pyth.en-US.mdx
diff --git a/src/pages/about/services/pyth.zh-CN.mdx b/src/pages/about/services/pyth.zh-CN.mdx
new file mode 100644
index 000000000..1e2441f52
--- /dev/null
+++ b/src/pages/about/services/pyth.zh-CN.mdx
@@ -0,0 +1,48 @@
+---
+title: Pyth 价格预言机
+---
+
+import { Alert } from "~/components/shared";
+
+## 概述
+
+[Pyth Network](https://docs.pyth.network/) 是一套价格预言机，为广泛资产提供高频、低延迟的价格馈送，可与 Chainlink 相媲美。它专为需要高精度与高可靠性的高频交易系统及其他应用而设计。
+
+Pyth 已部署至 ZetaChain，可提供加密货币、法币、股票等多种资产的价格。
+
+Pyth 合约地址：
+
+| 网络 | 地址 |
+| :--- | :--- |
+| Mainnet Beta | [0x2880aB155794e7179c9eE2e38200202908C17B43](https://zetachain.blockscout.com/address/0x2880aB155794e7179c9eE2e38200202908C17B43) |
+| Testnet | [0x0708325268dF9F66270F1401206434524814508b](https://zetachain-athens-3.blockscout.com/address/0x0708325268dF9F66270F1401206434524814508b) |
+
+来源：https://docs.pyth.network/price-feeds/contract-addresses/evm
+
+Pyth Network 是无需许可的系统，任何人都可向预言机提交价格。系统通过去中心化共识机制确保价格准确可靠。
+
+ZetaChain 贡献者团队运行着向 Pyth 预言机提交价格的调度器，定期更新资产价格，确保馈送数据最新、准确。
+
+
+ ZetaChain 的 Pyth 调度器以公共服务形式提供，旨在提升开发体验、便于测试 dApp。若你构建的是生产级应用，建议**自行运行调度器**。更多信息请参阅 [Pyth 文档](https://docs.pyth.network/price-feeds/schedule-price-updates/using-scheduler)。
+
+
+当前支持的资产：BTC、BNB、MATIC、ETH、USDC、ZETA、USDT。
+
+价格馈送 ID： https://pyth.network/developers/price-feed-ids
+
+## Pyth Entropy
+
+[Pyth Entropy](https://docs.pyth.network/entropy) 允许开发者在链上快速生成安全的随机数。其快速响应能力适用于构建 NFT 铸造、链游等需要流畅用户体验的应用。Entropy 还提供强有力的安全保障，确保用户与开发者都能信任结果的随机性。
+
+Pyth Entropy 目前已在 ZetaChain 提供服务。关于如何通过 Entropy 生成随机数，请[查看指南](https://docs.pyth.network/entropy/generate-random-numbers)。
+
+Pyth Entropy 合约地址：
+
+| 网络 | 地址 |
+| :--- | :--- |
+| Mainnet Beta | [0x36825bf3Fbdf5a29E2d5148bfe7Dcf7B5639e320](https://zetachain.blockscout.com/address/0x36825bf3Fbdf5a29E2d5148bfe7Dcf7B5639e320) |
+| Testnet | [0x4374e5a8b9C22271E9EB878A2AA31DE97DF15DAF](https://zetachain-athens-3.blockscout.com/address/0x4374e5a8b9C22271E9EB878A2AA31DE97DF15DAF) |
+
+可通过此[示例](https://docs.pyth.network/entropy/create-your-first-entropy-app) 创建首个基于 Entropy 的应用。***
+
diff --git a/src/pages/about/services/space-id.mdx b/src/pages/about/services/space-id.en-US.mdx
similarity index 100%
rename from src/pages/about/services/space-id.mdx
rename to src/pages/about/services/space-id.en-US.mdx
diff --git a/src/pages/about/services/space-id.zh-CN.mdx b/src/pages/about/services/space-id.zh-CN.mdx
new file mode 100644
index 000000000..946fa1fe1
--- /dev/null
+++ b/src/pages/about/services/space-id.zh-CN.mdx
@@ -0,0 +1,104 @@
+---
+title: SPACE ID Web3 Name SDK
+description: 解析 Web3 域名或反向解析传统地址
+---
+
+## 概述
+
+该 SDK 的核心能力包括：
+
+- 域名解析：解析域名以获取相关信息，例如关联的传统地址、各类记录（头像、IPFS 链接、社交数据等）及元数据。
+- 反向解析：支持反向地址解析，可在跨链或不同顶级域名（TLD）之间，为指定地址找出主域名，返回链级主域名（Chain Primary Name）或 TLD 主域名（TLD Primary Name）。
+
+### 关键术语
+
+**TLD Primary Name：**
+
+- 每个地址都可以为每个顶级域名设置 TLD Primary Name，即便该域名尚未在 SPACE ID 上完成验证。
+- 例如，可将 “allen.eth” 设为 .eth 的 TLD Primary Name，“allen.zeta” 对应 .zeta，“allen.bnb” 对应 .bnb。
+
+**Chain Primary Name：**
+
+- 每条链或网络下，每个地址只能拥有一个唯一的 Chain Primary Name。
+- 当同一条链上存在多个已验证的 TLD 时，仅能选择其中一个作为该链的反向解析域名。
+- 例如，可将 “allen.eth” 设为以太坊的 Chain Primary Name，而 “allen.zeta” 则作为 ZetaChain 的主域名。
+
+Web3 Name SDK 默认支持所有基于 EVM 的域名解析；反向解析会针对每条 EVM 链返回 Chain Primary Name。项目管理员可选择集成全部或部分链与 TLD，并按需定制反向解析配置，使 SDK 能灵活适配项目需求。
+
+## 快速上手
+
+开发者无需额外配置，即可使用 Web3 Name SDK 进行 Web3 域名解析或传统地址的反向解析。
+
+## 安装
+
+`npm install @web3-name-sdk/core viem@^1.20`
+
+若使用 Next.js，请在 `next.config.js` 中加入如下配置以转译 CommonJS 依赖：
+
+```typescript
+const nextConfig = {
+ transpilePackages: ["@web3-name-sdk/core"],
+};
+```
+
+### 1. 初始化客户端
+
+```typescript
+import { createWeb3Name } from "@web3-name-sdk/core";
+
+const web3Name = createWeb3Name();
+```
+
+### 2. 解析域名
+
+可通过一次请求获取域名对应的地址：
+
+```typescript
+const address = await web3name.getAddress("zeta.zeta");
+const address = await web3name.getAddress("bts_official.lens");
+const address = await web3name.getAddress("beresnev.crypto");
+const address = await web3name.getAddress("registry.zeta");
+```
+
+### 3. 解析地址
+
+方法中提供可选参数用于选择目标链或 TLD。传入链 ID 可在指定链上解析地址，并返回这些链上所有 TLD 中可用的域名。
+
+```typescript
+// 在 ZetaChain 上解析地址
+const name = await web3name.getDomainName({
+ address: "0x253a4ee0acb7c89bab7c20097200ea240119049a",
+ queryChainIdList: [7000],
+}); // 预期返回：karlyshka.zeta
+```
+
+传入 TLD 列表则可限制从特定 TLD 中获取可用的 TLD 主域名。
+
+```typescript
+// 在 .zeta TLD 中解析地址
+const name = await web3name.getDomainName({
+ address: "0x253a4ee0acb7c89bab7c20097200ea240119049a",
+ queryTldList: ["zeta"],
+}); // 预期返回：karlyshka.zeta
+```
+
+### 4. 记录
+
+通过提供域名与键名可以获取对应的文本记录。例如，下方示例返回 zeta.zeta 的头像记录：
+
+```typescript
+const record = await web3Name.getDomainRecord({
+ name: "zeta.zeta",
+ key: "avatar",
+});
+```
+
+### 5. 元数据
+
+可直接通过 SDK 获取域名元数据。
+
+```typescript
+// 请求元数据
+const metadata = await web3Name.getMetadata({ name: "public.zeta" });
+```***
+
diff --git a/src/pages/about/services/subquery.mdx b/src/pages/about/services/subquery.en-US.mdx
similarity index 100%
rename from src/pages/about/services/subquery.mdx
rename to src/pages/about/services/subquery.en-US.mdx
diff --git a/src/pages/about/services/subquery.zh-CN.mdx b/src/pages/about/services/subquery.zh-CN.mdx
new file mode 100644
index 000000000..8a08adfbf
--- /dev/null
+++ b/src/pages/about/services/subquery.zh-CN.mdx
@@ -0,0 +1,25 @@
+# SubQuery Indexer
+
+SubQuery 是领先的区块链数据索引器，为 Web3 项目提供快速、灵活、通用的去中心化 API。借助 SubQuery SDK，开发者能够高效获取丰富的索引数据，从而快速构建沉浸式去中心化应用。SubQuery 支持包括 ZetaChain、Ethereum、Cosmos、Near、Polygon、Polkadot、Algorand 等在内的众多生态。
+
+SubQuery 的竞争优势之一在于，单个项目即可聚合多条区块链的数据。这使得开发者能够构建功能丰富的仪表盘分析与多链区块浏览器，而不仅限于单链场景。
+
+得益于多 RPC 端点配置、多工作线程能力以及可自定义的缓存架构，SubQuery 能够提供卓越性能。更多信息请查阅详尽的[官方文档](https://academy.subquery.network/)。
+
+实用资源：
+
+- SubQuery 文档：[SubQuery Academy](https://academy.subquery.network/)
+- [快速入门指南](https://academy.subquery.network/quickstart/quickstart.html)
+- [ZetaChain Starter](https://github.com/subquery/ethereum-subql-starter/tree/main/Zetachain/zetachain-starter)
+- [ZetaChain 测试网 Starter](https://github.com/subquery/ethereum-subql-starter/tree/main/Zetachain/zetachain-testnet-starter)
+
+如有技术问题或需要支持，请联系 `start@subquery.network`。
+
+## 运行与托管 ZetaChain SubQuery API
+
+秉持开源理念，SubQuery 提供三种部署方式：
+
+- 本地或自选云服务商运行。配置步骤可参考[说明文档](https://academy.subquery.network/run_publish/run.html)。
+- 使用企业级[托管服务](https://managedservice.subquery.network/)，提供生产可用的零停机蓝绿部署，并附带慷慨的免费套餐。了解[如何开始](https://academy.subquery.network/run_publish/publish.html)。
+- 发布至[去中心化网络](https://subquery.network/network)，这是面向 dApp 开发者的终极数据服务，兼具开放性、性能、可靠性与可扩展性。SubQuery Network 以可验证、可激励的方式为全球社区索引和提供数据，并自 ZetaChain 启动起即提供支持。***
+
diff --git a/src/pages/about/services/the-graph.mdx b/src/pages/about/services/the-graph.en-US.mdx
similarity index 100%
rename from src/pages/about/services/the-graph.mdx
rename to src/pages/about/services/the-graph.en-US.mdx
diff --git a/src/pages/about/services/the-graph.zh-CN.mdx b/src/pages/about/services/the-graph.zh-CN.mdx
new file mode 100644
index 000000000..45287e51a
--- /dev/null
+++ b/src/pages/about/services/the-graph.zh-CN.mdx
@@ -0,0 +1,184 @@
+# The Graph
+
+在构建 dApp 时获取智能合约的历史数据往往令人头疼。[The Graph](https://thegraph.com/) 通过子图（Subgraph）API，为智能合约数据提供便捷的查询方式。其基础设施依赖去中心化索引者网络，可让你的 dApp 真正实现去中心化。
+
+## 快速上手
+
+这些子图只需几分钟即可搭建。按照以下三步开始：
+
+1. 初始化子图项目
+2. 部署并发布
+3. 在 dApp 中查询
+
+以下为详细步骤：
+
+## 1. 初始化子图项目
+
+### 在 Subgraph Studio 创建子图
+
+进入 [Subgraph Studio](https://thegraph.com/studio/) 并连接钱包。连接后点击 “Create a Subgraph” 即可开始。命名时建议使用标题格式（Title Case），例如 “Subgraph Name Chain Name”。
+
+
+
+创建后会进入子图页面，右侧列出了所需的 CLI 命令：
+
+
+
+### 安装 Graph CLI
+
+在本地运行：
+
+```
+npm install -g @graphprotocol/graph-cli
+```
+
+### 初始化子图
+
+可直接从子图页面复制命令（含专属 slug）：
+
+```
+graph init --studio
+```
+
+CLI 会提示你填写相关信息：
+
+
+
+确保合约已在区块浏览器通过验证，CLI 会自动获取 ABI 并完成初始化。如未成功获取 ABI，可重试解决。
+
+## 2. 部署并发布
+
+### 部署到 Subgraph Studio
+
+先运行：
+
+```bash
+$ graph codegen
+$ graph build
+```
+
+接着运行以下命令进行认证与部署（可从子图页面复制，包含专属 deploy key 与 slug）：
+
+```bash
+$ graph auth --studio
+$ graph deploy --studio
+```
+
+系统会要求输入版本标签，可填写 `v0.0.1` 等自定义格式。
+
+### 测试子图
+
+可在 Playground 区域执行示例查询。详情页会显示 API 端点，可在 dApp 中使用该端点。
+
+
+
+### 将子图发布到 The Graph 去中心化网络
+
+当子图准备上线时，可发布到去中心化网络。在 Subgraph Studio 的子图页面点击 “Publish”：
+
+
+
+需要在 Arbitrum One 上支付交易费用 —— The Graph 的智能合约均部署在 Arbitrum One，即便你的子图索引的是其他链数据。
+
+
+
+> **提示：** 发布时若看到 “Partial Indexer Support” 警告，表示该链上的子图目前仅由 The Graph 默认索引者索引，尚无独立索引者参与。测试网通常存在此限制。主网上该提示会在链启用索引者奖励后消失，届时可吸引更多索引者支持你的子图。
+
+## 3. 查询子图
+
+恭喜！你现在可以在去中心化网络上查询子图。
+
+对于去中心化网络上的任意子图，只需向其 Explorer 页面顶部的查询 URL 发送 GraphQL 请求即可。
+
+下例来自 Messari 的 [CryptoPunks Ethereum 子图](https://thegraph.com/explorer/subgraphs/HdVdERFUe8h61vm2fDyycHgxjsde5PbB832NHgJfZNqK)：
+
+
+
+该子图的查询 URL 为：
+
+`https://gateway-arbitrum.network.thegraph.com/api/`**[api-key]**`/subgraphs/id/HdVdERFUe8h61vm2fDyycgxjsde5PbB832NHgJfZNqK`
+
+将你的 API Key 填入后即可向该端点发送 GraphQL 查询。
+
+### 获取 API Key
+
+
+
+在 Subgraph Studio 页面顶部选择 “API Keys” 菜单即可创建。
+
+## 附录
+
+### 示例查询
+
+以下查询返回售价最高的 CryptoPunks：
+
+```graphql
+{
+ trades(orderBy: priceETH, orderDirection: desc) {
+ priceETH
+ tokenId
+ }
+}
+```
+
+将其发送至查询 URL 会返回如下结果：
+
+```
+{
+ "data": {
+ "trades": [
+ {
+ "priceETH": "124457.067524886018255505",
+ "tokenId": "9998"
+ },
+ {
+ "priceETH": "8000",
+ "tokenId": "5822"
+ },
+// ...
+```
+
+
+💡 小知识：在 [CryptoPunks 官网](https://cryptopunks.app/cryptopunks/topsales) 上看到的最高成交价是 Punk #5822，而不是 #9998。原因是官方屏蔽了通过闪电贷完成的那笔交易。
+
+
+### 示例代码
+
+```jsx
+const axios = require('axios');
+
+const graphqlQuery = `{
+ trades(orderBy: priceETH, orderDirection: desc) {
+ priceETH
+ tokenId
+ }
+}`;
+const queryUrl = 'https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/HdVdERFUe8h61vm2fDyycHgxjsde5PbB832NHgJfZNqK'
+
+const graphQLRequest = {
+ method: 'post',
+ url: queryUrl,
+ data: {
+ query: graphqlQuery,
+ },
+};
+
+// 发送 GraphQL 查询
+axios(graphQLRequest)
+ .then((response) => {
+ // 在此处理响应
+ const data = response.data.data
+ console.log(data)
+
+ })
+ .catch((error) => {
+ // 处理错误
+ console.error(error);
+ });
+```
+
+### 更多资源
+
+- 想优化与自定义子图以提升性能，可阅读[创建子图指南](https://thegraph.com/docs/en/developing/creating-a-subgraph/)。
+- 若需了解更多查询方法，请参考[查询文档](https://thegraph.com/docs/en/querying/querying-the-graph/)。***
+
diff --git a/src/pages/about/services/wallets.mdx b/src/pages/about/services/wallets.en-US.mdx
similarity index 100%
rename from src/pages/about/services/wallets.mdx
rename to src/pages/about/services/wallets.en-US.mdx
diff --git a/src/pages/about/services/wallets.zh-CN.mdx b/src/pages/about/services/wallets.zh-CN.mdx
new file mode 100644
index 000000000..48bd73b27
--- /dev/null
+++ b/src/pages/about/services/wallets.zh-CN.mdx
@@ -0,0 +1,48 @@
+---
+title: 钱包
+---
+
+## 概述
+
+ZetaChain 是基于 Cosmos SDK 构建、兼容 EVM 的区块链，并支持与比特币互操作。这意味着许多 EVM 与 Cosmos 钱包都可用于签名交易并与 ZetaChain 交互。
+
+要从已连接的链访问 ZetaChain，或直接与 ZetaChain 交互，我们建议使用 EVM 钱包。
+
+## EVM 钱包
+
+建议使用以下钱包（亦有其他选择）：
+
+- [Metamask](https://metamask.io)
+- [Coinbase Wallet](https://www.coinbase.com/wallet)
+
+如需在钱包中添加 ZetaChain，可参考[网络详情页面](/reference/network/details)提供的配置信息。
+
+## 比特币钱包
+
+若要在比特币网络上访问 ZetaChain，需要满足特定条件的钱包。详见文档中的[比特币章节](/developers/chains/bitcoin)。
+
+已验证兼容性的钱包：
+
+- [XDEFI](https://www.xdefi.io/)
+- [OKX](https://www.okx.com/web3)
+- [UniSat](https://unisat.io/)
+- [Xverse](https://www.xverse.app/)
+
+其他钱包也可能适用，但以上名单已通过专门测试。
+
+## Cosmos 钱包
+
+Cosmos 钱包可用于在 ZetaChain 上转移原生代币；若 dApp 支持 Cosmos 钱包，也可用于签名 ZetaChain 的 EVM 交易。若你侧重于 ZetaChain 的 Cosmos 功能（原生代币转账、治理、群组、质押、授权等），推荐使用 Cosmos 钱包。
+
+### Keplr
+
+[Keplr](https://keplr.app/) 是一款广受欢迎的浏览器扩展与移动端钱包，支持多条 Cosmos 链，也可用于访问 ZetaChain。
+
+在 Keplr 浏览器扩展中添加 ZetaChain： https://chains.keplr.app/。
+
+### Leap
+
+[Leap](https://www.leapwallet.io/) 同样提供扩展与移动应用，支持 Cosmos 生态。用户可查看余额、交易记录，在账户间转账、查看并投票治理提案、查看委托并向验证人委托。
+
+在 Leap 浏览器扩展中添加 ZetaChain： https://developers.leapwallet.io/chain-store。***
+
diff --git a/src/pages/about/token-utility/_meta.json b/src/pages/about/token-utility/_meta.en-US.json
similarity index 100%
rename from src/pages/about/token-utility/_meta.json
rename to src/pages/about/token-utility/_meta.en-US.json
diff --git a/src/pages/about/token-utility/_meta.zh-CN.json b/src/pages/about/token-utility/_meta.zh-CN.json
new file mode 100644
index 000000000..67854058a
--- /dev/null
+++ b/src/pages/about/token-utility/_meta.zh-CN.json
@@ -0,0 +1,20 @@
+{
+ "overview": {
+ "title": "代币用途"
+ },
+ "token": {
+ "title": "ZETA 代币"
+ },
+ "distribution": {
+ "title": "ZETA 分配"
+ },
+ "validators": {
+ "title": "验证人激励"
+ },
+ "gas": {
+ "title": "Gas 费用"
+ },
+ "liquidity": {
+ "title": "核心流动性池"
+ }
+}
diff --git a/src/pages/about/token-utility/distribution.mdx b/src/pages/about/token-utility/distribution.en-US.mdx
similarity index 100%
rename from src/pages/about/token-utility/distribution.mdx
rename to src/pages/about/token-utility/distribution.en-US.mdx
diff --git a/src/pages/about/token-utility/distribution.zh-CN.mdx b/src/pages/about/token-utility/distribution.zh-CN.mdx
new file mode 100644
index 000000000..7495d8a4b
--- /dev/null
+++ b/src/pages/about/token-utility/distribution.zh-CN.mdx
@@ -0,0 +1,74 @@
+---
+title: ZETA 分配
+---
+
+import { Alert } from "~/components/shared";
+
+## 概述
+
+ZETA 初始供应量按以下比例分配，总量为 2,100,000,000。约 4 年后，协议计划依据既定曲线，将通胀目标调整为基于当前流通量的每年约 2.5%。ZetaChain 还拥有治理模型，可在货币政策等方面进行调整，以促进长期可持续发展。
+
+## 代币信息
+
+| 代币名称 | ZETA |
+| -------- | ---- |
+| 总供应量 | 2,100,000,000 |
+
+## 代币分配
+
+| 类型 | 百分比 | 数量 | 解锁计划 |
+| ---- | ---- | ---- | ---- |
+| 用户增长池 | 10.00% | 210,000,000 | 上线时解锁 4.5%。首月后连续 5 个月每月解锁 0.2%。上线 6 个月后，剩余部分按 36 个月平均解锁。 |
+| 生态增长基金 | 12.00% | 252,000,000 | 上线时解锁 1.5%。上线 6 个月后，剩余部分按 42 个月平均解锁。 |
+| 验证人激励 | 10.00% | 210,000,000 | 通过区块发行在 4 年内逐步释放。 |
+| 流动性激励 | 5.50% | 115,500,000 | 上线时解锁 3%，剩余部分自上线起按 48 个月平均解锁。 |
+| 协议金库 | 24.00% | 504,000,000 | 上线时解锁 2%。上线 12 个月后，剩余部分按 36 个月平均解锁。 |
+| 核心贡献者 | 22.50% | 472,500,000 | 上线 6 个月后起、为期 6 个月内，每月解锁 1/18。上线 12 个月后，剩余部分按 24 个月平均解锁（每月 1/36）。 |
+| 购买方与顾问 | 16.00% | 336,000,000 | 上线 6 个月后起、为期 6 个月内，每月解锁 1/18。上线 12 个月后，剩余部分按 24 个月平均解锁（每月 1/36）。 |
+
+锁仓的 ZETA 可用于质押给验证人，为网络提供安全并参与交易验证。锁仓 ZETA 仅限用于质押，不能用于其他用途。部分第三方可能会将质押中的 ZETA 计入流通供应量。被质押的锁仓代币数量是动态的，可通过区块链或相关浏览器查询实时数据；不同机构对流通、质押或总供应量的计算方法可能不同。
+
+### 用户增长池
+
+用于激励 ZetaChain 的使用与用户增长。会通过多种基于活跃度和真实行为的计划发放，例如 ZetaLabs 空投、钱包活动及其他面向社区的奖励，以提升对 ZetaChain 功能的认知与使用。
+
+### 生态增长基金
+
+用于支持生态合作伙伴与开发者。例如，通过资助计划帮助 dApp 开发者起步，或激励钱包伙伴原生集成 ZetaChain。
+
+### 验证人激励
+
+初始供应量中的 10% 用于 ZetaChain 的初始发行池，在网络前 4 年提供区块奖励，保障网络安全。该池耗尽后，协议会通过验证人奖励引入计划中的 2.5% 通胀，与发行曲线独立。更多关于验证人激励与分配的内容可参阅[相关文档](/about/token-utility/validators)。
+
+### 流动性激励
+
+网络 TSS 管理的资产包含针对流动性提供者的奖励，用于激励在 ZetaChain EVM 上可用的流动性。该部分旨在鼓励提供对协议与生态稳定至关重要的流动性，以便在 ZetaChain 上实现低滑点、低 Gas 的价值转移。
+
+为鼓励核心 ZRC-20 等池子的流动性，该池将用于提供链上激励，帮助用户与开发者获得顺畅的交易体验。
+
+### 协议金库
+
+金库资金用于推动生态与社区项目，例如网络保险、漏洞赏金、协议开发与赏金计划、运营等，以改善 ZetaChain 生态。
+
+### 核心贡献者、顾问与购买方
+
+ZETA 会分配给购买方，以及为 ZetaChain 网络做出贡献的核心成员与顾问。
+
+## 代币分配日志
+
+### 2024 年 10 月 23 日
+
+为提升安全性与去中心化，已有 15 亿枚 ZETA 永久锚定在 ZetaChain 原生网络。ZETA 仍可转回以太坊（ERC-20），但可转移至以太坊的上限现为 6 亿枚。
+
+此次更新不影响总供应量、流通供应量或任何参与者持有的 ZETA，各链合计总量仍为 21 亿，功能不受影响。所有网络参与者的流通计划保持不变。
+
+锚定措施通过确保 15 亿枚 ZETA 受 ZetaChain 原生网络而非 ERC-20 合约保护，从而提升网络安全性。这是迈向去中心化与增强安全性的关键一步，对用户和开发者至关重要。
+
+该举措还为即将到来的多链集成奠定基础，为可跨越以太坊、比特币等任意区块链的 Universal Apps 提供更安全的底层。
+
+查看以太坊连接器上转移至空地址的交易：https://etherscan.io/tx/0x772a9afed8af83d3e51b5d3c8fceced29e955483c47c55e0a996402022acf89d
+
+
+ 上述内容为当前关于 ZetaChain 与 ZETA 的设计思路与模型，未来可能会根据主网及后续发展进行调整。
+
+
diff --git a/src/pages/about/token-utility/gas.mdx b/src/pages/about/token-utility/gas.en-US.mdx
similarity index 100%
rename from src/pages/about/token-utility/gas.mdx
rename to src/pages/about/token-utility/gas.en-US.mdx
diff --git a/src/pages/about/token-utility/gas.zh-CN.mdx b/src/pages/about/token-utility/gas.zh-CN.mdx
new file mode 100644
index 000000000..5124b7470
--- /dev/null
+++ b/src/pages/about/token-utility/gas.zh-CN.mdx
@@ -0,0 +1,18 @@
+---
+title: Gas 费用
+---
+
+## 概述
+
+ZETA 用于支付 ZetaChain EVM、全链智能合约功能以及跨链消息的 Gas 费用。费用按质押 ZETA 比例分配给验证人集合，未来也计划覆盖其他网络参与者。
+
+总体而言，无论用户通过跨链消息还是智能合约与 dApp 交互，费用都会打包收取，并分配给为网络创造价值的角色，如发起交易、维护安全或直接贡献协议的参与者。大部分费用将流向验证人，成为其主要激励/奖励。网络日后可升级，将部分 Gas 费用分配给社区或开发者回馈池。
+
+## 全链 Gas 费用
+
+关于全链智能合约与 ZetaChain EVM 的 Gas 费用，可查看[相关文档](/developers/evm/gas/#omnichain-contract-fees)。
+
+## 跨链消息 Gas 费用
+
+跨链消息的 Gas 费用说明参见[该章节](/developers/evm/gas/#cross-chain-messaging-fees)。***
+
diff --git a/src/pages/about/token-utility/liquidity.mdx b/src/pages/about/token-utility/liquidity.en-US.mdx
similarity index 100%
rename from src/pages/about/token-utility/liquidity.mdx
rename to src/pages/about/token-utility/liquidity.en-US.mdx
diff --git a/src/pages/about/token-utility/liquidity.zh-CN.mdx b/src/pages/about/token-utility/liquidity.zh-CN.mdx
new file mode 100644
index 000000000..ed6ff59ba
--- /dev/null
+++ b/src/pages/about/token-utility/liquidity.zh-CN.mdx
@@ -0,0 +1,17 @@
+---
+title: 核心流动性池
+description: ZetaChain 的核心流动性池依托 ZETA，支持跨链 Gas 支付。
+---
+
+## 概述
+
+网络设有 ZETA / 管理式代币 Gas 池，用于支付出站交易的 Gas。
+
+在执行 ZetaChain 跨链功能时，协议会使用这些基础池为连接链的交易支付出站 Gas。也就是说，ZetaChain 核心功能的使用越多，这些池的使用率与手续费也越高。套利者可在网络使用池子的过程中对其进行再平衡。
+
+协议初期通过 UniV2 池实现该功能，后续会探索 Curve 式池、DEX 聚合器等方案，以确保终端用户与开发者的成本与滑点更低。
+
+## 什么是核心池？
+
+ZetaChain 需要在其 EVM 上建立 [ZETA] / [Gas ZRC-20] 的 Uniswap 池，以在向目标链写入出站交易时兑换 ZETA。每当新增连接链时，都会创建一个 ZETA 与该链原生 Gas 资产之间的池。了解如何为 ZETA 提供流动性，请参考[指南](/users/zetahub/pool)。***
+
diff --git a/src/pages/about/token-utility/overview.mdx b/src/pages/about/token-utility/overview.en-US.mdx
similarity index 100%
rename from src/pages/about/token-utility/overview.mdx
rename to src/pages/about/token-utility/overview.en-US.mdx
diff --git a/src/pages/about/token-utility/overview.zh-CN.mdx b/src/pages/about/token-utility/overview.zh-CN.mdx
new file mode 100644
index 000000000..48f6644f3
--- /dev/null
+++ b/src/pages/about/token-utility/overview.zh-CN.mdx
@@ -0,0 +1,42 @@
+---
+title: 代币用途
+---
+
+## 概述
+
+本节介绍 ZETA 的职能，以及它在 ZetaChain 生态各组件中的作用。
+
+ZetaChain 的使命是成为跨链通用访问、简洁性与实用性的基础平台。ZetaChain 是为互操作性而生的权益证明区块链，支持创建可跨越任意链（包括比特币）的全链 dApp。所有交易、激励、数据安全与跨链交互均需要 ZETA 才能运转。
+
+区块链生态中的代币用途涵盖众多概念与主题。ZETA 的代币设计基于广泛研究、既有成果与前沿技术，旨在伴随 ZetaChain 实用性与使用规模的增长而扩展。协议内建治理机制，允许网络根据生态与参与者需求自我调整与升级，以维护公共利益与 ZetaChain 网络的功能。
+
+## 核心网络功能
+
+ZetaChain 的节点架构可读取或写入任意已连接链。借助全新、兼容 ERC-20 的 ZRC-20 标准，ZetaChain 上的智能合约可在一个位置管理连接链上的资产。阈值签名（TSS）地址中的流动性由分布式验证人网络以去中心化方式管理。资产可存入连接链上的 TSS 地址与 ERC-20 托管合约，从而由 ZetaChain 智能合约原生调用。连接链上的用户可以发送消息实现价值与数据转移（“跨链消息”），或调用 ZetaChain EVM 上的合约以编排任意连接链的流动性；也可使用 MetaMask 等钱包直接连接 ZetaChain EVM 与合约交互。
+
+总的来说，ZetaChain 的网络功能为开发者提供完整平台，只需在 ZetaChain 部署一次，即可构建面向未来、链无关的应用。这类单合约部署称为全链智能合约。
+
+由此，ZetaChain 解锁了诸如比特币智能合约与可编程性、任意链可访问的应用、更简洁的跨链操作等场景。
+
+## 主要参与者
+
+生态中主要有四类参与者：
+
+- ZetaChain 核心验证人：负责保障与维护网络。
+- ZetaChain 观察者/签名者：负责外部链与 TSS 地址的监测与签名，从而支持网络的跨链功能。两类角色目前由同一组验证人承担，未来可能拆分。
+- 交易用户：在 ZetaChain EVM 与跨链交互时支付手续费。
+- ZETA 持有者/委托人：可参与网络治理与安全。
+
+## ZETA 的核心用途
+
+围绕 ZETA 的生态运作主要由以下支柱构成：
+
+- 协议向验证人发放固定区块奖励与激励，初始固定池结束后过渡到可变通胀。激励（及罚没）构成权益证明区块链的基础，确保协议安全与激励一致。
+- 以 ZETA 支付的交易（Gas）费用会分配给验证人、委托人及其他权益证明参与者，同时保护网络免受垃圾交易与 DDoS 攻击。
+- 在跨链消息中，ZETA 会在源链燃烧、在目标链铸造，不仅用于捆绑 Gas，也充当跨链价值转移的“媒介”，无需创建新的包装资产即可完成价值传递。
+- 由 ZETA 与连接链资产组成的核心流动性池，使用户能够在 ZetaChain 及连接链之间交易（例如支付出站交易的 Gas）。流动性提供者将以原生代币（如目标链 Gas 代币）形式获得交易手续费与流动性激励。
+
+## 延伸阅读
+
+欲深入了解上述内容，可查阅以下文档，了解 ZETA 用途与生态的各子模块与概念。***
+
diff --git a/src/pages/about/token-utility/token.mdx b/src/pages/about/token-utility/token.en-US.mdx
similarity index 100%
rename from src/pages/about/token-utility/token.mdx
rename to src/pages/about/token-utility/token.en-US.mdx
diff --git a/src/pages/about/token-utility/token.zh-CN.mdx b/src/pages/about/token-utility/token.zh-CN.mdx
new file mode 100644
index 000000000..a7bbd3b82
--- /dev/null
+++ b/src/pages/about/token-utility/token.zh-CN.mdx
@@ -0,0 +1,16 @@
+---
+title: ZETA 代币
+---
+
+## 概述
+
+ZETA 初始总供应量为 2,100,000,000（21 亿）。约 4 年后，协议计划依据既定曲线，将通胀目标调整为基于当前流通量的每年约 2.5%，以保障网络的长期可持续性。ZetaChain 还具备治理模型，可针对货币政策等进行升级，以进一步实现长期可持续目标并按生态需求进行调整。
+
+### ZETA 的用途
+
+- ZETA 作为 **Gas** 用于 ZetaChain 的全链智能合约层与内部交易。类似 EIP-1559 的交易会随时间燃烧部分 ZETA。
+- ZETA 用于协议核心流动性池，与外部 ZRC-20 Gas 资产兑换，从而支付并**向外部链写入出站交易**。
+- ZETA 作为**跨链中介资产**随跨链消息传递。发送跨链消息时，dApp/用户会附加 ZETA 以代表价值，并一次性支付全部 Gas 与交易费用。ZETA 也会在核心流动性池中兑换，用于支付出站 Gas。
+- ZETA 是保障 **PoS 区块链安全** 的关键。验证人需要质押 ZETA，用户也可将 ZETA 委托给验证人以获得区块发行奖励。
+- ZETA 用于 **治理** 投票（网络升级、政策调整等）。***
+
diff --git a/src/pages/about/token-utility/validators.mdx b/src/pages/about/token-utility/validators.en-US.mdx
similarity index 100%
rename from src/pages/about/token-utility/validators.mdx
rename to src/pages/about/token-utility/validators.en-US.mdx
diff --git a/src/pages/about/token-utility/validators.zh-CN.mdx b/src/pages/about/token-utility/validators.zh-CN.mdx
new file mode 100644
index 000000000..50af272da
--- /dev/null
+++ b/src/pages/about/token-utility/validators.zh-CN.mdx
@@ -0,0 +1,41 @@
+---
+title: 验证人激励
+description: 验证人激励旨在补偿运营者为网络安全所投入的成本与风险。尽管分配比例可通过参数或协议升级进行调整，用于奖励的总额度是固定的。
+---
+
+## 验证人类型
+
+验证人由核心验证人、观察者与 TSS 签名者三类角色组成。为了处理交易并保障网络安全，交易手续费与奖励会分配给验证人。
+
+> _说明：原则上，观察者与 TSS 签名者是独立角色，但在当前阶段会合并运行，运营者将作为“核心验证人”或“观察者/签名者”参与。成为观察者/签名者的前提是先运行核心验证人（观察者/签名者从技术角度同时承担三种角色）。观察者/签名者获得区块奖励的 25%，核心验证人获得剩余 75%。上线初期，计划按总质押额选取前 100 名核心验证人参与共识，观察者/签名者初始设定为 9 个节点，未来会逐步增加以提升去中心化程度。_
+
+以下描述各类验证人的职责与对应的区块奖励份额。
+
+**核心验证人（75%）**
+
+负责 ZetaCore（ZetaChain 基础链）的共识运作，支持 PoS 机制与用户委托。任何人都可以运行验证人来获得奖励并保障网络安全。用户可将质押委托给现有运营者，或自建节点。
+
+**观察者验证人（12.5%）**
+
+负责监测已连接的外部链，并将相关事件发送给核心验证人。随着验证/证明机制进一步完善，观察者的重要性将下降，相应奖励份额会通过治理逐步转向 TSS 签名者。
+
+**TSS 签名验证人（12.5%）**
+
+当 ZetaChain 需要把核心验证人处理的交易写入外部链时，会通过去中心化的 TSS 签名者网络完成。
+
+## 验证人区块奖励
+
+初始供应量中的 10% 分配给验证人激励池，在网络上线后的前 4 年按固定时间/区块速率释放。验证人依据该曲线与其保障网络的贡献获得奖励。
+
+随着初始池逐渐耗尽，协议会在特定区块高度引入计划中的 2.5% 通胀，通过验证人奖励发放，并与原发行曲线独立。该阶段后，通胀率将由网络通过治理设定与调整。
+
+此外，系统设定了质押率目标。当实际质押率高于目标值时，发行量会下降；低于目标时，发行量会增加，从而在不同阶段鼓励增减质押。但核心发行曲线与奖励池总量保持不变。
+
+## 解锁期
+
+任何质押都有 21 天的解锁期。奖励会分配给委托人/质押者，但提出赎回时需等待 21 天才能领取。
+
+## 惩罚机制
+
+为确保网络活性与安全，验证人若偏离协议要求，将面临质押 ZETA 被罚没的惩罚。例如，核心验证人未按时投票、投出冲突票等 Cosmos SDK 定义的违规行为都会被处罚。对于观察者/签名者，还会对其他违规行为（多次未观测到关键外部事件、上报错误事件、未参加 TSS 密钥生成或签名等）罚没其对应核心验证人质押的 ZETA。***
+
diff --git a/src/pages/developers/_meta.json b/src/pages/developers/_meta.en-US.json
similarity index 100%
rename from src/pages/developers/_meta.json
rename to src/pages/developers/_meta.en-US.json
diff --git a/src/pages/developers/_meta.zh-CN.json b/src/pages/developers/_meta.zh-CN.json
new file mode 100644
index 000000000..122f87ffc
--- /dev/null
+++ b/src/pages/developers/_meta.zh-CN.json
@@ -0,0 +1,26 @@
+{
+ "index": {
+ "title": "开发构建"
+ },
+ "apps": {
+ "title": "全链应用"
+ },
+ "evm": {
+ "title": "全链 EVM"
+ },
+ "standards": {
+ "title": "全链资产"
+ },
+ "chains": {
+ "title": "已连接链"
+ },
+ "tutorials": {
+ "title": "教程"
+ },
+ "protocol": {
+ "title": "协议合约"
+ },
+ "architecture": {
+ "title": "协议架构"
+ }
+}
diff --git a/src/pages/developers/architecture/_meta.json b/src/pages/developers/architecture/_meta.en-US.json
similarity index 100%
rename from src/pages/developers/architecture/_meta.json
rename to src/pages/developers/architecture/_meta.en-US.json
diff --git a/src/pages/developers/architecture/_meta.zh-CN.json b/src/pages/developers/architecture/_meta.zh-CN.json
new file mode 100644
index 000000000..ad3b803ba
--- /dev/null
+++ b/src/pages/developers/architecture/_meta.zh-CN.json
@@ -0,0 +1,23 @@
+{
+ "overview": {
+ "title": "架构概览"
+ },
+ "observers": {
+ "title": "观察者-签名者验证者"
+ },
+ "privileged": {
+ "title": "特权操作"
+ },
+ "rewards": {
+ "title": "质押奖励"
+ },
+ "whitelisting": {
+ "title": "ERC-20 白名单"
+ },
+ "modules": {
+ "title": "模块"
+ },
+ "zetacored": {
+ "title": "ZetaChain 节点 CLI"
+ }
+}
diff --git a/src/pages/developers/architecture/modules.mdx b/src/pages/developers/architecture/modules.en-US.mdx
similarity index 100%
rename from src/pages/developers/architecture/modules.mdx
rename to src/pages/developers/architecture/modules.en-US.mdx
diff --git a/src/pages/developers/architecture/modules.zh-CN.mdx b/src/pages/developers/architecture/modules.zh-CN.mdx
new file mode 100644
index 000000000..749f0cd2b
--- /dev/null
+++ b/src/pages/developers/architecture/modules.zh-CN.mdx
@@ -0,0 +1,889 @@
+---
+title: 节点模块规范
+---
+
+## authority
+
+### 消息（Messages）
+
+#### MsgUpdatePolicies
+
+`UpdatePolicies` 用于更新策略。
+
+```proto
+message MsgUpdatePolicies {
+ string creator = 1;
+ Policies policies = 2;
+}
+```
+
+#### MsgUpdateChainInfo
+
+`UpdateChainInfo` 用于更新链信息对象。
+当提供的链在链信息对象中不存在时会新增；若已存在则更新。
+
+```proto
+message MsgUpdateChainInfo {
+ string creator = 1;
+ pkg.chains.Chain chain = 3;
+}
+```
+
+#### MsgRemoveChainInfo
+
+`RemoveChainInfo` 会移除指定链 ID 的链信息。
+
+```proto
+message MsgRemoveChainInfo {
+ string creator = 1;
+ int64 chain_id = 2;
+}
+```
+
+#### MsgAddAuthorization
+
+`AddAuthorization` 用于新增授权。如果授权已存在，将以提供的策略覆盖。
+该消息应由管理员策略账户调用。
+
+```proto
+message MsgAddAuthorization {
+ string creator = 1;
+ string msg_url = 2;
+ PolicyType authorized_policy = 3;
+}
+```
+
+#### MsgRemoveAuthorization
+
+`RemoveAuthorization` 会从列表中移除授权，应由管理员策略账户调用。
+
+```proto
+message MsgRemoveAuthorization {
+ string creator = 1;
+ string msg_url = 2;
+}
+```
+
+## crosschain
+
+### 概述
+
+`crosschain` 模块负责跟踪跨链交易（CCTX）的入站与出站流程。
+
+与该模块交互的主要参与者是观察者验证者（Observers）。观察者运行链下程序 `zetaclient`，监听连接链上的入站交易、ZetaChain 上待处理的出站交易，以及连接链上的出站交易。
+
+在观察到入站或出站交易后，观察者会参与投票流程。
+
+#### 投票
+
+当观察者为某笔交易提交投票时，会创建一个 `ballot`（若此前不存在）。观察者可以对该投票单投票。当投票数量达到 `BallotThreshold` 时，投票单即视为“已完成”。
+
+将投票单推进到“已完成”状态的最后一票会触发跨链交易执行并支付相关 Gas 成本。
+
+投票单完成后提交的投票会被丢弃。
+
+#### 入站交易
+
+入站交易指在连接链上观察到的跨链交易。观察者通过广播 `MsgVoteInbound` 对入站交易进行投票。
+
+将投票单推进到“已完成”状态的最后一票会触发跨链交易执行。
+
+若目标链是 ZetaChain 且 CCTX 不包含消息，则会将 ZRC-20 代币存入 ZetaChain 上的账户。
+
+若目标链是 ZetaChain 且 CCTX 包含消息，则会存入 ZRC-20 代币并在 ZetaChain 上调用合约。合约地址与参数由消息提供。
+
+若目标链不是 ZetaChain，则会将交易状态更新为 “pending outbound”，并按出站交易流程处理该 CCTX。
+
+#### 出站交易
+
+###### Pending Outbound
+
+观察者会在 ZetaChain 上监听待处理的出站交易。为处理此类交易，观察者需要参与 TSS 密钥签名（keysign）流程，完成签名后将签名交易广播至连接链。
+
+###### Observed Outbound
+
+观察者会在连接链上监控已广播的出站交易。一旦交易在连接链上“确认”（或“被打包”），观察者会向 ZetaChain 发送 `VoteOutbound` 消息进行投票。
+
+当投票超过阈值后，投票流程完成，交易状态更新为最终状态。
+
+#### 权限
+
+| Message | 管理策略账户 | 观察者验证者 |
+| ------------------------ | ------------ | ------------ |
+| MsgVoteTSS | | ✅ |
+| MsgGasPriceVoter | | ✅ |
+| MsgVoteOutbound | | ✅ |
+| MsgVoteInbound | | ✅ |
+| MsgAddOutboundTracker | ✅ | ✅ |
+| MsgRemoveOutboundTracker | ✅ | |
+
+#### 状态
+
+模块在状态中存储以下信息：
+
+- 出站交易列表
+- 链的 nonce 列表
+- 链的最新高度列表
+- 跨链交易列表
+- 入站交易与跨链交易之间的映射
+- TSS 密钥
+- 观察者提交的连接链 Gas 价格
+
+### 消息（Messages）
+
+#### MsgAddOutboundTracker
+
+`AddOutboundTracker` 在出站交易跟踪器中新增记录。仅管理员策略账户与观察者验证者可在无需证明情况下广播该消息。如果找不到待处理的 CCTX，而该链 ID 与 nonce 已存在记录，则会移除该跟踪器。
+
+```proto
+message MsgAddOutboundTracker {
+ string creator = 1;
+ int64 chain_id = 2;
+ uint64 nonce = 3;
+ string tx_hash = 4;
+ pkg.proofs.Proof proof = 5;
+ string block_hash = 6;
+ int64 tx_index = 7;
+}
+```
+
+#### MsgAddInboundTracker
+
+`AddInboundTracker` 会在入站交易跟踪器中新增记录。
+
+```proto
+message MsgAddInboundTracker {
+ string creator = 1;
+ int64 chain_id = 2;
+ string tx_hash = 3;
+ pkg.coin.CoinType coin_type = 4;
+ pkg.proofs.Proof proof = 5;
+ string block_hash = 6;
+ int64 tx_index = 7;
+}
+```
+
+#### MsgRemoveInboundTracker
+
+`RemoveInboundTracker` 会在存在时移除入站跟踪器。
+
+```proto
+message MsgRemoveInboundTracker {
+ string creator = 1;
+ int64 chain_id = 2;
+ string tx_hash = 3;
+}
+```
+
+#### MsgRemoveOutboundTracker
+
+`RemoveOutboundTracker` 会按链 ID 与 nonce 移除出站交易跟踪器中的记录。
+授权：管理员策略第 1 组。
+
+```proto
+message MsgRemoveOutboundTracker {
+ string creator = 1;
+ int64 chain_id = 2;
+ uint64 nonce = 3;
+}
+```
+
+#### MsgVoteGasPrice
+
+`VoteGasPrice` 提交指定区块高度的连接链 Gas 价格信息。每位验证者提交的价格会单独记录，并更新中位数索引。
+
+仅观察者验证者可广播此消息。
+
+```proto
+message MsgVoteGasPrice {
+ string creator = 1;
+ int64 chain_id = 2;
+ uint64 price = 3;
+ uint64 priority_fee = 6;
+ uint64 block_number = 4;
+ string supply = 5;
+}
+```
+
+#### MsgVoteOutbound
+
+`VoteOutbound` 为在连接链上已广播并确认的出站交易投票。若这是首个投票，会创建新的投票单；当投票达到阈值时，投票单完成并处理出站交易。
+
+若观测成功，将铸造等量于 `burned` 与 `minted` 差值的 ZETA，并存入模块账户。
+
+若观测失败，则根据之前的状态处理：
+
+- 若之前状态为 `PendingOutbound`，将创建新的回退交易。为支付回退交易费用，会用 CCTX 携带的代币在 ZetaChain 上的 Uniswap V2 合约中兑换目标链的 ZRC-20 Gas 代币，然后销毁。更新 nonce，若成功则状态改为 `PendingRevert`。
+- 若之前状态为 `PendingRevert`，则 CCTX 作废。
+
+```mermaid
+stateDiagram-v2
+
+ state observation <>
+ state success_old_status <>
+ state fail_old_status <>
+ PendingOutbound --> observation: Finalize outbound
+ observation --> success_old_status: Observation succeeded
+ success_old_status --> Reverted: Old status is PendingRevert
+ success_old_status --> OutboundMined: Old status is PendingOutbound
+ observation --> fail_old_status: Observation failed
+ fail_old_status --> PendingRevert: Old status is PendingOutbound
+ fail_old_status --> Aborted: Old status is PendingRevert
+ PendingOutbound --> Aborted: Finalize outbound error
+
+```
+
+仅观察者验证者可广播此消息。
+
+```proto
+message MsgVoteOutbound {
+ string creator = 1;
+ string cctx_hash = 2;
+ string observed_outbound_hash = 3;
+ uint64 observed_outbound_block_height = 4;
+ uint64 observed_outbound_gas_used = 10;
+ string observed_outbound_effective_gas_price = 11;
+ uint64 observed_outbound_effective_gas_limit = 12;
+ string value_received = 5;
+ pkg.chains.ReceiveStatus status = 6;
+ int64 outbound_chain = 7;
+ uint64 outbound_tss_nonce = 8;
+ pkg.coin.CoinType coin_type = 9;
+ ConfirmationMode confirmation_mode = 13;
+}
+```
+
+#### MsgVoteInbound
+
+`VoteInbound` 为在连接链上观察到的入站交易投票。若为首个投票，会创建新的投票单；当投票达到阈值时，投票单完成并创建新的 CCTX。
+
+若接收链为 ZetaChain，则调用 `HandleEVMDeposit`。若存入的是 ZETA，则调用 `MintZetaToEVMAccount` 将代币铸造至接收账户；若是连接链的 Gas 代币或 ERC-20，则调用 ZRC-20 的 `deposit`，并在消息非空时调用系统合约的 `depositAndCall` 执行 ZetaChain 上的全链合约。若成功，CCTX 状态更新为 `OutboundMined`。
+
+若接收链为连接链，则调用 `FinalizeInbound` 以准备将 CCTX 作为出站交易处理。为支付出站交易费用，会用 CCTX 携带代币在 ZetaChain 上的 Uniswap V2 合约中兑换目标链的 ZRC-20 Gas 代币并销毁。更新 nonce，若成功则状态改为 `PendingOutbound`。
+
+```mermaid
+stateDiagram-v2
+
+ state evm_deposit_success <>
+ state finalize_inbound <>
+ state evm_deposit_error <>
+ PendingInbound --> evm_deposit_success: Receiver is ZetaChain
+ evm_deposit_success --> OutboundMined: EVM deposit success
+ evm_deposit_success --> evm_deposit_error: EVM deposit error
+ evm_deposit_error --> PendingRevert: Contract error
+ evm_deposit_error --> Aborted: Internal error, invalid chain, gas, nonce
+ PendingInbound --> finalize_inbound: Receiver is connected chain
+ finalize_inbound --> Aborted: Finalize inbound error
+ finalize_inbound --> PendingOutbound: Finalize inbound success
+
+```
+
+仅观察者验证者可广播此消息。
+
+```proto
+message MsgVoteInbound {
+ string creator = 1;
+ string sender = 2;
+ int64 sender_chain_id = 3;
+ string receiver = 4;
+ int64 receiver_chain = 5;
+ string amount = 6;
+ string message = 8;
+ string inbound_hash = 9;
+ uint64 inbound_block_height = 10;
+ uint64 gas_limit = 11;
+ pkg.coin.CoinType coin_type = 12;
+ string tx_origin = 13;
+ string asset = 14;
+ uint64 event_index = 15;
+ ProtocolContractVersion protocol_contract_version = 16;
+ RevertOptions revert_options = 17;
+ CallOptions call_options = 18;
+ bool is_cross_chain_call = 19;
+ InboundStatus status = 20;
+ ConfirmationMode confirmation_mode = 21;
+}
+```
+
+#### MsgWhitelistERC20
+
+`WhitelistERC20` 会部署新的 ZRC-20、创建外部代币对象，并发起跨链交易在外部链上将该 ERC-20 加入白名单。
+授权：管理员策略第 1 组。
+
+```proto
+message MsgWhitelistERC20 {
+ string creator = 1;
+ string erc20_address = 2;
+ int64 chain_id = 3;
+ string name = 4;
+ string symbol = 5;
+ uint32 decimals = 6;
+ int64 gas_limit = 7;
+ string liquidity_cap = 8;
+}
+```
+
+#### MsgUpdateTssAddress
+
+`UpdateTssAddress` 用于更新 TSS 地址。
+
+```proto
+message MsgUpdateTssAddress {
+ string creator = 1;
+ string tss_pubkey = 2;
+}
+```
+
+#### MsgMigrateTssFunds
+
+`MigrateTssFunds` 将资金从当前 TSS 迁移至新 TSS。
+
+```proto
+message MsgMigrateTssFunds {
+ string creator = 1;
+ int64 chain_id = 2;
+ string amount = 3;
+}
+```
+
+#### MsgAbortStuckCCTX
+
+`AbortStuckCCTX` 用于终止卡住的 CCTX。授权：管理员策略第 2 组。
+
+```proto
+message MsgAbortStuckCCTX {
+ string creator = 1;
+ string cctx_index = 2;
+}
+```
+
+#### MsgRefundAbortedCCTX
+
+`RefundAbortedCCTX` 用于为已终止的 CCTX 退款。它会验证 CCTX 是否已终止且尚未退款，并检查退款地址有效性，然后将金额退还给退款地址，并将 CCTX 标记为已退款。相关退款地址与金额逻辑可参考文档中的 `GetRefundAddress` 与 `GetAbortedAmount`。
+
+```proto
+message MsgRefundAbortedCCTX {
+ string creator = 1;
+ string cctx_index = 2;
+ string refund_address = 3;
+}
+```
+
+#### MsgUpdateRateLimiterFlags
+
+`UpdateRateLimiterFlags` 更新速率限制器标志。授权：管理员策略（运维）。
+
+```proto
+message MsgUpdateRateLimiterFlags {
+ string creator = 1;
+ RateLimiterFlags rate_limiter_flags = 2;
+}
+```
+
+#### MsgMigrateERC20CustodyFunds
+
+`MigrateERC20CustodyFunds` 将资金从当前 ERC20Custody 合约迁移到新合约。
+
+```proto
+message MsgMigrateERC20CustodyFunds {
+ string creator = 1;
+ int64 chain_id = 2;
+ string new_custody_address = 3;
+ string erc20_address = 4;
+ string amount = 5;
+}
+```
+
+#### MsgUpdateERC20CustodyPauseStatus
+
+`UpdateERC20CustodyPauseStatus` 会创建管理员命令 CCTX，以更新 ERC20Custody 合约的暂停状态。
+
+```proto
+message MsgUpdateERC20CustodyPauseStatus {
+ string creator = 1;
+ int64 chain_id = 2;
+ bool pause = 3;
+}
+```
+
+## emissions
+
+### 概述
+
+`emissions` 模块负责协调观察者、验证者与 TSS 签名者的奖励分配。目前仅在每个区块向验证者分发奖励，未分配的观察者与 TSS 奖励会存于各自池中。
+
+奖励分发逻辑在 begin blocker 中实现。
+
+模块会记录用于计算奖励的参数：
+
+- 最大质押因子
+- 最小质押因子
+- 平均出块时间
+- 目标质押比例
+- 验证者奖励比例
+- 观察者奖励比例
+- TSS 签名者奖励比例
+- 持续时间因子常数
+
+### 消息（Messages）
+
+#### MsgUpdateParams
+
+`UpdateParams` 定义了通过治理更新 `x/emissions` 模块参数的操作。
+权限账户固定为 `x/gov` 模块账户。
+
+```proto
+message MsgUpdateParams {
+ string authority = 1;
+ Params params = 2;
+}
+```
+
+#### MsgWithdrawEmission
+
+`WithdrawEmission` 允许用户提取可提取的排放奖励。成功提取后，会将未分发奖励池中的金额转入用户账户。
+若请求金额大于可提取余额，则会提取最大可用金额；若池内余额不足以满足请求，则返回错误。
+
+```proto
+message MsgWithdrawEmission {
+ string creator = 1;
+ string amount = 2;
+}
+```
+
+## fungible
+
+### 概述
+
+`fungible` 模块用于在 ZetaChain 上部署连接链（外部链）中的同质化代币（称为 “foreign coins”）。
+
+外部代币会在 ZetaChain 上表示为 ZRC-20 代币。
+
+当在 ZetaChain 上部署外部代币时，会部署 ZRC-20 合约、创建流动性池、为池子注入流动性，并将该代币添加到模块状态中的外部代币列表。
+
+模块包含以下逻辑：
+
+- 在 ZetaChain 上部署外部代币
+- 部署系统合约、Uniswap 与包装 ZETA
+- 从连接链向 ZetaChain 的全链智能合约存入并调用（`DepositZRC20AndCallContract` 与 `DepositZRC20`）
+
+该模块高度依赖[协议合约](https://github.com/zeta-chain/protocol-contracts)。
+
+#### 状态
+
+`fungible` 模块会跟踪以下状态：
+
+- 系统合约地址
+- 外部代币列表
+
+### 消息（Messages）
+
+#### MsgDeploySystemContracts
+
+`DeploySystemContracts` 用于部署新的系统合约实例。
+授权：管理员策略第 2 组。
+
+```proto
+message MsgDeploySystemContracts {
+ string creator = 1;
+}
+```
+
+#### MsgDeployFungibleCoinZRC20
+
+`DeployFungibleCoinZRC20` 会将连接链上的同质化代币以 ZRC-20 形式部署到 ZetaChain。
+
+若该代币为 Gas 代币，将执行以下操作：
+
+* 部署该代币的 ZRC-20 合约；
+* 在系统合约中设置 ZRC-20 合约地址为代币地址；
+* 铸造 ZETA 并存入模块账户；
+* 在系统合约上调用 `setGasZetaPool` 记录池信息；
+* 调用 `addLiquidityETH` 向池子添加流动性。
+
+若该代币非 Gas 代币：
+
+* 部署 ZRC-20 合约；
+* 将该代币加入模块状态的外部代币列表。
+
+授权：管理员策略第 2 组。
+
+```proto
+message MsgDeployFungibleCoinZRC20 {
+ string creator = 1;
+ string ERC20 = 2;
+ int64 foreign_chain_id = 3;
+ uint32 decimals = 4;
+ string name = 5;
+ string symbol = 6;
+ pkg.coin.CoinType coin_type = 7;
+ int64 gas_limit = 8;
+ string liquidity_cap = 9;
+}
+```
+
+#### MsgRemoveForeignCoin
+
+`RemoveForeignCoin` 会从模块状态的外部代币列表中移除某个代币。
+授权：管理员策略第 2 组。
+
+```proto
+message MsgRemoveForeignCoin {
+ string creator = 1;
+ string zrc20_address = 2;
+}
+```
+
+#### MsgUpdateSystemContract
+
+`UpdateSystemContract` 用于更新系统合约。
+
+```proto
+message MsgUpdateSystemContract {
+ string creator = 1;
+ string new_system_contract_address = 2;
+}
+```
+
+#### MsgUpdateContractBytecode
+
+`UpdateContractBytecode` 用于将合约的字节码更新为现有合约的字节码。仅 ZRC-20 合约或 WZeta 连接器合约可更新。
+重要：新合约字节码必须与旧合约保持相同的存储布局；可以新增变量，但不能移除已有变量。
+授权：管理员策略第 2 组。
+
+```proto
+message MsgUpdateContractBytecode {
+ string creator = 1;
+ string contract_address = 2;
+ string new_code_hash = 3;
+}
+```
+
+#### MsgUpdateZRC20WithdrawFee
+
+`UpdateZRC20WithdrawFee` 用于更新 ZRC-20 代币的提现费用与 Gas 上限。
+
+```proto
+message MsgUpdateZRC20WithdrawFee {
+ string creator = 1;
+ string zrc20_address = 2;
+ string new_withdraw_fee = 6;
+ string new_gas_limit = 7;
+}
+```
+
+#### MsgUpdateZRC20LiquidityCap
+
+`UpdateZRC20LiquidityCap` 用于更新 ZRC-20 代币的流动性上限。
+授权：管理员策略第 2 组。
+
+```proto
+message MsgUpdateZRC20LiquidityCap {
+ string creator = 1;
+ string zrc20_address = 2;
+ string liquidity_cap = 3;
+}
+```
+
+#### MsgPauseZRC20
+
+`PauseZRC20` 可暂停一组 ZRC-20 代币。
+授权：管理员策略 `groupEmergency`。
+
+```proto
+message MsgPauseZRC20 {
+ string creator = 1;
+ string zrc20_addresses = 2;
+}
+```
+
+#### MsgUnpauseZRC20
+
+`UnpauseZRC20` 恢复 ZRC-20 代币的运行。
+授权：管理员策略 `groupOperational`。
+
+```proto
+message MsgUnpauseZRC20 {
+ string creator = 1;
+ string zrc20_addresses = 2;
+}
+```
+
+#### MsgUpdateGatewayContract
+
+`UpdateGatewayContract` 更新 ZetaChain 协议用于读取入站、处理出站的 zevm 网关合约。
+
+```proto
+message MsgUpdateGatewayContract {
+ string creator = 1;
+ string new_gateway_contract_address = 2;
+}
+```
+
+#### MsgUpdateZRC20Name
+
+`UpdateZRC20Name` 更新 ZRC-20 代币的名称和/或符号。
+
+```proto
+message MsgUpdateZRC20Name {
+ string creator = 1;
+ string zrc20_address = 2;
+ string name = 3;
+ string symbol = 4;
+}
+```
+
+#### MsgBurnFungibleModuleAsset
+
+`BurnFungibleModuleAsset` 会销毁 `fungible` 模块上的 ZRC-20 余额。若提供零地址，则会销毁 `fungible` 模块持有的原生 ZETA。
+
+```proto
+message MsgBurnFungibleModuleAsset {
+ string creator = 1;
+ string zrc20_address = 2;
+}
+```
+
+#### MsgUpdateGatewayGasLimit
+
+`UpdateGatewayGasLimit` 更新 ZetaChain 协议使用的网关 Gas 上限。
+
+```proto
+message MsgUpdateGatewayGasLimit {
+ string creator = 1;
+ uint64 new_gas_limit = 2;
+}
+```
+
+## lightclient
+
+### 消息（Messages）
+
+#### MsgEnableHeaderVerification
+
+`EnableHeaderVerification` 为指定链 ID 启用区块头验证标志。启用后可提交区块头并用于校验证明正确性。
+
+```proto
+message MsgEnableHeaderVerification {
+ string creator = 1;
+ int64 chain_id_list = 2;
+}
+```
+
+#### MsgDisableHeaderVerification
+
+`DisableHeaderVerification` 为指定链 ID 禁用区块头验证标志。禁用后无法提交区块头或用其校验证明。
+
+```proto
+message MsgDisableHeaderVerification {
+ string creator = 1;
+ int64 chain_id_list = 2;
+}
+```
+
+## observer
+
+### 概述
+
+`observer` 模块维护用于投票的投票单、链与观察者账户的映射、受支持的连接链列表、核心参数（合约地址、出站交易调度间隔等）、观察者参数（投票阈值、最低观察者委托等）以及管理员策略参数。
+
+投票单用于为入站与出站交易投票。`observer` 模块提供投票单的创建、读取、更新、删除（CRUD）能力，并提供辅助函数判断投票单是否完成。投票机制也为其他模块所用，例如观察者验证者在 `crosschain` 模块中对交易进行投票。
+
+观察者验证者是在 `zetacored`（区块链节点）旁运行 `zetaclient` 的验证者，获授权对跨链交易的入站与出站进行投票。
+
+链与观察者账户之间的映射目前在创世阶段设定，并在 `crosschain` 模块中用于判断某观察者验证者是否有权对特定链的交易进行投票。
+
+### 消息（Messages）
+
+#### MsgAddObserver
+
+`AddObserver` 将观察者地址加入观察者集合。
+
+```proto
+message MsgAddObserver {
+ string creator = 1;
+ string observer_address = 2;
+ string zetaclient_grantee_pubkey = 3;
+ bool add_node_account_only = 4;
+}
+```
+
+#### MsgUpdateObserver
+
+`UpdateObserver` 用于更新观察者地址。
+授权：管理员策略（管理员更新）或旧观察者地址（当观察者因违规被记墓碑时）。
+
+```proto
+message MsgUpdateObserver {
+ string creator = 1;
+ string old_observer_address = 2;
+ string new_observer_address = 3;
+ ObserverUpdateReason update_reason = 4;
+}
+```
+
+#### MsgUpdateChainParams
+
+`UpdateChainParams` 更新特定链的参数，或新增一条链。链参数包括确认次数、出站交易调度间隔、ZETA 代币、连接器与 ERC20 托管合约地址等。
+仅管理员策略账户可广播。
+
+```proto
+message MsgUpdateChainParams {
+ string creator = 1;
+ ChainParams chainParams = 2;
+}
+```
+
+#### MsgRemoveChainParams
+
+`RemoveChainParams` 会移除某条链的参数。
+
+```proto
+message MsgRemoveChainParams {
+ string creator = 1;
+ int64 chain_id = 2;
+}
+```
+
+#### MsgVoteBlame
+
+```proto
+message MsgVoteBlame {
+ string creator = 1;
+ int64 chain_id = 2;
+ Blame blame_info = 3;
+}
+```
+
+#### MsgUpdateKeygen
+
+`UpdateKeygen` 更新密钥生成所在的区块高度，并将状态设置为“pending keygen”。
+授权：管理员策略第 1 组。
+
+```proto
+message MsgUpdateKeygen {
+ string creator = 1;
+ int64 block = 2;
+}
+```
+
+#### MsgVoteBlockHeader
+
+`VoteBlockHeader` 为新区块头投票，以便存储。
+
+```proto
+message MsgVoteBlockHeader {
+ string creator = 1;
+ int64 chain_id = 2;
+ bytes block_hash = 3;
+ int64 height = 4;
+ pkg.proofs.HeaderData header = 5;
+}
+```
+
+#### MsgResetChainNonces
+
+`ResetChainNonces` 处理链 nonce 的重置。
+
+```proto
+message MsgResetChainNonces {
+ string creator = 1;
+ int64 chain_id = 2;
+ int64 chain_nonce_low = 3;
+ int64 chain_nonce_high = 4;
+}
+```
+
+#### MsgVoteTSS
+
+`VoteTSS` 就创建 TSS 密钥并记录其信息（公钥、参与者与运营者地址、完成与 keygen 高度）进行投票。
+
+当投票通过时，会在链上记录 TSS 密钥信息，并将 keygen 状态设为 “success”。
+
+若 keygen 不存在、已完成或已失败，则投票会失败。
+
+仅节点账户可广播该消息。
+
+```proto
+message MsgVoteTSS {
+ string creator = 1;
+ string tss_pubkey = 2;
+ int64 keygen_zeta_height = 3;
+ pkg.chains.ReceiveStatus status = 4;
+}
+```
+
+#### MsgEnableCCTX
+
+`EnableCCTX` 启用 `IsInboundEnabled` 与 `IsOutboundEnabled` 标志，这两个标志用于控制入站与出站的创建。由具备 `groupOperational` 策略类型的策略账户启用。
+
+```proto
+message MsgEnableCCTX {
+ string creator = 1;
+ bool enableInbound = 2;
+ bool enableOutbound = 3;
+}
+```
+
+#### MsgDisableCCTX
+
+`DisableCCTX` 禁用 `IsInboundEnabled` 与 `IsOutboundEnabled` 标志。由具备 `groupEmergency` 策略类型的策略账户禁用。
+
+```proto
+message MsgDisableCCTX {
+ string creator = 1;
+ bool disableInbound = 2;
+ bool disableOutbound = 3;
+}
+```
+
+#### MsgDisableFastConfirmation
+
+`DisableFastConfirmation` 为指定链 ID 禁用快速确认。被禁用的链仅使用安全确认次数（SAFE confirmation count）来确认入站与出站。
+
+```proto
+message MsgDisableFastConfirmation {
+ string creator = 1;
+ int64 chain_id = 2;
+}
+```
+
+#### MsgUpdateGasPriceIncreaseFlags
+
+`UpdateGasPriceIncreaseFlags` 更新 GasPriceIncreaseFlags，这些标志用于控制 Gas 价格上调。由具备 `groupOperational` 策略类型的策略账户更新。
+
+```proto
+message MsgUpdateGasPriceIncreaseFlags {
+ string creator = 1;
+ GasPriceIncreaseFlags gasPriceIncreaseFlags = 2;
+}
+```
+
+#### MsgUpdateOperationalFlags
+
+```proto
+message MsgUpdateOperationalFlags {
+ string creator = 1;
+ OperationalFlags operational_flags = 2;
+}
+```
+
+#### MsgUpdateOperationalChainParams
+
+`UpdateOperationalChainParams` 更新与运维相关的链参数。与 `MsgUpdateChainParams` 不同，该消息不会修改敏感参数，例如用于监听连接链的网关合约地址。
+
+```proto
+message MsgUpdateOperationalChainParams {
+ string creator = 1;
+ int64 chain_id = 2;
+ uint64 gas_price_ticker = 3;
+ uint64 inbound_ticker = 4;
+ uint64 outbound_ticker = 5;
+ uint64 watch_utxo_ticker = 6;
+ int64 outbound_schedule_interval = 7;
+ int64 outbound_schedule_lookahead = 8;
+ ConfirmationParams confirmation_params = 9;
+ bool disable_tss_block_scan = 10;
+}
+```
+
diff --git a/src/pages/developers/architecture/observers.mdx b/src/pages/developers/architecture/observers.en-US.mdx
similarity index 100%
rename from src/pages/developers/architecture/observers.mdx
rename to src/pages/developers/architecture/observers.en-US.mdx
diff --git a/src/pages/developers/architecture/observers.zh-CN.mdx b/src/pages/developers/architecture/observers.zh-CN.mdx
new file mode 100644
index 000000000..e0c5ea425
--- /dev/null
+++ b/src/pages/developers/architecture/observers.zh-CN.mdx
@@ -0,0 +1,24 @@
+---
+title: 观察者-签名者验证者
+---
+
+import { ObserverList, ObserverParams } from "~/components/Docs";
+
+import { Alert } from "~/components/shared";
+
+ZetaChain 拥有两类验证者：核心验证者与观察者-签名者验证者（observer-signers）。
+
+协议设计中包含观察者与签名者两种角色：观察者负责监控连接链上的活动，签名者则代表协议使用阈值签名地址（TSS）签署交易。然而，目前 ZetaChain 上的所有观察者-签名者验证者同时担任这两种角色——他们既要观察连接链上的交易，也要参与交易签名。
+
+观察者-签名者需要运行各连接链的节点，通过 `zetaclient` 监听事件，并将交易写入连接链。
+
+协议的设计允许观察者-签名者在未来选择自己想要监控的链，从而形成更灵活的体系：他们可以仅监控自己感兴趣的链（例如其基础设施专注于运行 EVM 节点）。在当前版本中，所有观察者-签名者都会监控全部连接链。
+
+以下为 ZetaChain 测试网上的观察者-签名者列表：
+
+
+ {" "}
+ 需要特别指出的是，任何单个实体或少数节点都无法在连接链上代表 ZetaChain 签署消息。{" "}
+
+
diff --git a/src/pages/developers/architecture/privileged.mdx b/src/pages/developers/architecture/privileged.en-US.mdx
similarity index 100%
rename from src/pages/developers/architecture/privileged.mdx
rename to src/pages/developers/architecture/privileged.en-US.mdx
diff --git a/src/pages/developers/architecture/privileged.zh-CN.mdx b/src/pages/developers/architecture/privileged.zh-CN.mdx
new file mode 100644
index 000000000..e954a3e88
--- /dev/null
+++ b/src/pages/developers/architecture/privileged.zh-CN.mdx
@@ -0,0 +1,23 @@
+---
+title: 特权操作
+---
+
+import { AdminPolicy } from "~/components/Docs";
+import { Alert } from "~/components/shared";
+
+部分特权操作（交易消息）仅允许经授权的实体执行。有些消息要求发送者必须是观察者验证者，另一些则要求发送者为特定的策略账户。
+
+策略账户类似于链上的多签账户，由成员投票批准消息执行。
+
+每个群组都包含管理员、成员集合与策略账户集合。每个策略账户拥有管理员、地址以及决策策略（投票门槛、投票期限等）。
+
+ZetaChain 的群组机制由 [`group` Cosmos SDK 模块](https://docs.cosmos.network/v0.50/modules/group/)驱动。
+
+ZetaChain 可以拥有任意数量的群组，任何人都可以创建群组。本文档仅关注授予执行特权操作授权的策略账户。
+
+这些策略账户会在创世阶段设定，且与其他模块参数一样可通过治理流程修改。这一点非常关键：尽管协议中存在管理员与特权策略账户等概念，但它们是由链上社区通过治理选出的。如果某个群组/策略管理员或成员出现恶意行为，社区可以创建新的群组，选出新的管理员与成员，并通过参数变更提案将观察者模块的参数指向新的策略账户。
+
+下表按所需策略账户与模块列出了所有特权消息。每条消息根据所属模块（如 crosschain、fungible、observer 等）分类，并需要相应策略账户的授权。
+
+, amount: u64, receiver: [u8; 20], revert_options: Option) -> Result<()>
+```
+
+该指令接收 SOL（以 lamports 计价）并发送至 ZetaChain 上的 `receiver`。注意 1 SOL = 1,000,000,000 lamports，指定 `amount` 时需转换单位。
+
+`receiver` 可以是 ZetaChain 上的外部账户或全链应用地址。即便接收方是具备标准 `receive` 函数的合约，`deposit` 也不会触发合约调用；如需存入并调用全链应用，请使用 `deposit_and_call`。
+
+存入完成后，接收方会得到该代币的 [ZRC-20 版本](/developers/evm/zrc20)，例如 ZRC-20 SOL。
+
+## 存入 SPL 代币
+
+若要将 SPL 代币存入 EOA 或全链合约，请调用 `deposit_spl_token` 指令：
+
+```rust
+pub fn deposit_spl_token(ctx: Context, amount: u64, receiver: [u8; 20], revert_options: Option) -> Result<()>
+```
+
+仅可存入[受支持的 SPL 代币](/developers/evm/zrc20)。接收方会获得存入代币的 ZRC-20 版本（如 ZRC-20 USDC.SOL）。SPL 代币必须先通过白名单才能通过 Gateway 存入。
+
+`amount` 指定存入的 SPL 代币数量。
+
+## 存入 SOL 并调用全链应用
+
+如需存入 SOL 并调用全链应用，请使用 `deposit_and_call` 指令：
+
+```rust
+pub fn deposit_and_call(ctx: Context, amount: u64, receiver: [u8; 20], message: Vec, revert_options: Option) -> Result<()>
+```
+
+跨链交易处理完成后，将执行目标全链应用合约的 `onCall` 函数。
+
+`receiver` 必须是全链应用合约地址。
+
+调用全链应用时，`message` 会传递给 `onCall`。
+
+## 存入 SPL 代币并调用全链应用
+
+`deposit_spl_token_and_call` 指令可在发送 SPL 代币的同时调用全链应用：
+
+```rust
+pub fn deposit_spl_token_and_call(ctx: Context, amount: u64, receiver: [u8; 20], message: Vec, revert_options: Option) -> Result<()>
+```
+
+其中 `amount` 为 SPL 代币数量。
+
+当前协议版本一次仅支持存入一种 SPL 代币。
+
+## 调用全链应用
+
+```rust
+pub fn call(ctx: Context, receiver: [u8; 20], message: Vec, revert_options: Option) -> Result<()>
+```
+
+在仅需在 ZetaChain 执行逻辑且无需资产转移时使用。
+
+## 回退选项
+
+Solana Gateway 支持在跨链执行失败时通过 `revert_options` 处理回退场景。所有指令（`deposit`、`deposit_spl_token`、`deposit_and_call` 等）都可传入该可选参数，以便精细控制 ZetaChain 端调用失败时的行为。
+
+`RevertOptions` 结构体定义如下：
+
+```rust
+pub struct RevertOptions {
+ pub revert_address: Pubkey,
+ pub abort_address: [u8; 20],
+ pub call_on_revert: bool,
+ pub revert_message: Vec,
+ pub on_revert_gas_limit: u64,
+}
+```
+
+### 字段说明
+
+- `revert_address`：当跨链调用在 ZetaChain 处理后失败时，接收退回代币的 Solana `Pubkey`。需根据资产类型提供有效的 SOL 或 SPL 账户。
+- `abort_address`：ZetaChain 上 20 字节的以太坊风格地址。当全链合约的 `onCall` 失败且无法回退到 Solana（例如 Gas 不足、回退路径无效或内部错误）时接收资产，作为最终兜底。若 `call_on_revert` 为 `true`，该地址也可能通过应用的 `onRevert` 接收回退消息。
+- `call_on_revert`：布尔值，决定当交易失败时是否在 Solana 端调用 `on_revert` 或在 ZetaChain 调用 `onAbort` 钩子。
+- `revert_message`：传递给 Solana 端 `on_revert` 与 ZetaChain 端 `onAbort` 的任意字节数据，可包含原始意图、失败原因或自定义信息。
+- `on_revert_gas_limit`：为 ZetaChain 回退交易分配的 Gas 上限，需确保足以执行 `onRevert` 钩子。
+
+### 注意事项
+
+- 若省略 `revert_options`，默认行为是在回退时将代币退回给发送者。
+- 为全面保护资产，建议始终设置 `abort_address`。
+
+### 实现 `on_revert`
+
+当调用 ZetaChain 上的全链合约发生回退且协议能够将交易回退至 Solana 时，Gateway 会调用你在 Solana 程序中实现的 `on_revert`，方便应用回滚状态、记录日志或补偿用户。
+
+```rust
+pub fn on_revert(
+ ctx: Context,
+ amount: u64, // 最初存入的资产数量（lamports 或 SPL）
+ sender: Pubkey, // 在 Solana 发起存入/调用的账户
+ data: Vec, // 通过 `revert_message` 提供的自定义数据
+) -> Result<()>
+```
+
+实现此函数可增强应用在跨链失败场景下的韧性与透明度。
+
+## 提取并调用 Solana 程序
+
+若要在 ZetaChain 的全链应用中提取 ZRC-20 代币并调用 Solana 程序，可使用 ZetaChain Gateway 的 `withdrawAndCall`。目标 Solana 程序需实现 `on_call` 函数，函数签名如下：
+
+```rust
+pub fn on_call(
+ ctx: Context,
+ amount: u64,
+ sender: [u8; 20],
+ data: Vec,
+) -> Result<()>
+```
+
+其中：
+
+- `amount`：提取的代币数量
+- `sender`：在 ZetaChain 发起调用的全链应用地址
+- `data`：来自全链应用的附加数据
+
+程序需同时支持 SOL 与 SPL 代币提取。若涉及 SPL，程序上下文中必须包含相应的代币账户与铸币账户。
+
+从 ZetaChain 调用 Solana 程序时，消息载荷需同时包含程序账户与传递给程序的数据。载荷采用 ABI 编码的元组，包含：
+
+1. 账户元数据数组，每个账户包含：
+ - `publicKey`：账户的 Solana 公钥
+ - `isWritable`：账户是否可被修改
+
+2. 传递给程序 `on_call` 的数据
+
+账户数组必须包含程序 `on_call` 所需的全部账户。
+
+对于 SOL 提取，账户数组需包含：
+
+- 程序 PDA（可写）
+- Gateway PDA（只读）
+- System program（只读）
+
+对于 SPL 提取，账户数组需包含：
+
+- 程序 PDA（可写）
+- 程序关联的代币账户（可写）
+- Mint 账户（只读）
+- Gateway PDA（只读）
+- Token program（只读）
+- System program（只读）
+
+`data` 字段可为程序 `on_call` 期望的任意字节。
+
+有关从全链应用调用 Solana 程序的完整示例（包括消息编码与程序实现），请参考 [ZetaChain 示例仓库中的 Solana 示例](https://github.com/zeta-chain/example-contracts/tree/main/examples/call/solana)。
+
+## 手续费
+
+每次存入将收取 2,000,000 lamports（0.002 SOL）的手续费。
+
+## 错误处理
+
+Solana Gateway 程序定义了多种错误码以覆盖不同失败场景，包括：
+
+- `SignerIsNotAuthority`：签名者无权执行该操作。
+- `DepositPaused`：当前暂停售入。
+- `NonceMismatch`：提供的 nonce 与预期不符。
+- `TSSAuthenticationFailed`：TSS 签名验证失败。
+- `DepositToAddressMismatch`：存入目标地址不匹配。
+- `MessageHashMismatch`：消息哈希验证失败。
+- `MemoLengthExceeded`：Memo 长度超出限制。
+- `SPLAtaAndMintAddressMismatch`：SPL 代币账户地址与预期不符。
+- `EmptyReceiver`：接收地址为空。
+- `InvalidInstructionData`：指令数据无效。
+
diff --git a/src/pages/developers/chains/sui.mdx b/src/pages/developers/chains/sui.en-US.mdx
similarity index 100%
rename from src/pages/developers/chains/sui.mdx
rename to src/pages/developers/chains/sui.en-US.mdx
diff --git a/src/pages/developers/chains/sui.zh-CN.mdx b/src/pages/developers/chains/sui.zh-CN.mdx
new file mode 100644
index 000000000..1ba8f1947
--- /dev/null
+++ b/src/pages/developers/chains/sui.zh-CN.mdx
@@ -0,0 +1,77 @@
+# Sui Gateway
+
+若要从 Sui 链与全链应用交互，请使用 Sui Gateway。
+
+有关使用 Sui Gateway 的分步示例，请参阅 [Sui 教程](/developers/tutorials/sui/)。
+
+Sui Gateway 支持：
+
+- 将原生 SUI 及其他代币存入 ZetaChain 的帐号或全链应用
+- 存入代币的同时调用全链应用
+
+## 存入代币
+
+若要将代币存入 ZetaChain 上的 EOA 或全链合约，可调用 `deposit` 函数：
+
+```move
+public entry fun deposit(
+ gateway: &mut Gateway,
+ coins: Coin,
+ receiver: String,
+ ctx: &mut TxContext,
+)
+```
+
+`deposit` 接受任何已列入白名单的代币类型 `T`（包含原生 SUI），并将其发送至 ZetaChain 上的 `receiver`。
+
+`receiver` 参数须为合法的 EVM 风格地址（带 `0x` 前缀的十六进制字符串），可对应 ZetaChain 上的外部账户或全链应用地址。即使接收方是全链应用合约，`deposit` 也不会触发合约调用；如需存入并调用应用，请使用 `deposit_and_call`。
+
+存入完成后，接收方会在 ZetaChain 获得该代币的 ZRC-20 版本。
+
+## 存入代币并调用全链应用
+
+若要存入代币并调用全链应用合约，请使用 `deposit_and_call`：
+
+```move
+public entry fun deposit_and_call(
+ gateway: &mut Gateway,
+ coins: Coin,
+ receiver: String,
+ payload: vector,
+ ctx: &mut TxContext,
+)
+```
+
+`receiver` 必须是 ZetaChain 上全链应用合约地址；`payload` 将传递给该应用的 `onCall` 函数。
+
+载荷最大为 1024 字节，超出将导致交易失败。
+
+## 管理函数
+
+Sui Gateway 提供多项需要特殊能力对象的管理函数：
+
+- `whitelist`：为新的代币类型启用存入（需 `WhitelistCap`）
+- `withdraw`：由 TSS 地址在将代币自 ZetaChain 提取回 Sui 时调用。仅 TSS 节点持有特定能力对象（`WithdrawCap`）。`nonce` 参数可防止重放攻击，确保每笔提取只处理一次。
+- `unwhitelist`：禁用某种代币类型的存入（需 `AdminCap`）
+- `pause`：暂时禁用所有存入（需 `AdminCap`）
+- `unpause`：重新启用存入（需 `AdminCap`）
+- `issue_withdraw_and_whitelist_cap`：轮换 TSS 能力对象（需 `AdminCap`）
+
+## 事件
+
+Gateway 会发出以下事件，便于监控：
+
+- `DepositEvent`：成功存入代币时触发
+- `DepositAndCallEvent`：存入代币并调用合约时触发
+- `WithdrawEvent`：提取代币时触发
+- `NonceIncreaseEvent`：提取 nonce 增加时触发
+
+## 只读函数
+
+Gateway 提供若干只读接口：
+
+- `nonce()`：返回当前提取 nonce
+- `vault_balance()`：返回 Gateway 中特定代币类型的余额
+- `is_whitelisted()`：检查代币类型是否已启用存入
+- `is_paused()`：检查存入功能当前是否暂停
+
diff --git a/src/pages/developers/chains/ton.mdx b/src/pages/developers/chains/ton.en-US.mdx
similarity index 100%
rename from src/pages/developers/chains/ton.mdx
rename to src/pages/developers/chains/ton.en-US.mdx
diff --git a/src/pages/developers/chains/ton.zh-CN.mdx b/src/pages/developers/chains/ton.zh-CN.mdx
new file mode 100644
index 000000000..698b784e4
--- /dev/null
+++ b/src/pages/developers/chains/ton.zh-CN.mdx
@@ -0,0 +1,57 @@
+若要从 TON 与全链应用交互，请使用 TON Gateway。
+
+TON Gateway 支持：
+
+- 将 TON 存入 ZetaChain 的帐号或全链应用
+- 存入 TON 并调用全链应用
+- 从 ZetaChain 提取 TON
+
+## 存入 TON
+
+若要将 TON 存入 EOA 或全链合约，请向 Gateway 合约发送如下结构的内部消息：
+
+```func
+op_code:uint32 query_id:uint64 evm_recipient:slice (160 bits)
+```
+
+存入操作的 `op_code` 为 `101`。`query_id` 预留供未来使用，目前设置为 `0`。
+
+`evm_recipient` 指定 ZetaChain 上接收 TON 的地址，可以是外部账户或全链应用地址。
+
+以下示例展示了如何在 TypeScript 中构造存入消息：
+
+```typescript
+const opDeposit = 101;
+const body = beginCell().storeUint(opDeposit, 32).storeUint(0, 64).storeUint(zevmRecipient, 160).endCell();
+```
+
+存入完成后，接收方会获得该 TON 的 [ZRC-20 版本](/developers/evm/zrc20)。
+
+## 存入 TON 并调用全链应用
+
+若要存入 TON 并调用全链应用合约，请向 Gateway 合约发送如下结构的内部消息：
+
+```func
+op_code:uint32 query_id:uint64 evm_recipient:slice (160 bits) call_data:cell
+```
+
+`depositAndCall` 的 `op_code` 为 `102`；`query_id` 仍设置为 `0`。请注意 `call_data` 需使用大多数 TON 库支持的 ["snake data"](https://docs.ton.org/v3/guidelines/dapps/asset-processing/nft-processing/metadata-parsing#snake-data-encoding) 格式编码。
+
+`evm_recipient` 必须是全链应用合约地址。
+
+`call_data` 单元（cell）包含将传递给全链应用 `onCall` 函数的载荷。
+
+以下示例展示了如何在 TypeScript 中构造存入并调用的消息：
+
+```typescript
+const opDepositAndCall = 102;
+const body = beginCell()
+ .storeUint(opDepositAndCall, 32)
+ .storeUint(0, 64)
+ .storeUint(zevmRecipient, 160)
+ .storeRef(callDataCell) // callDataCell 需为包含载荷的 cell
+ .endCell();
+```
+
+跨链交易处理完成后，将执行目标全链应用合约的 `onCall` 函数。
+
diff --git a/src/pages/developers/chains/zetachain.mdx b/src/pages/developers/chains/zetachain.en-US.mdx
similarity index 100%
rename from src/pages/developers/chains/zetachain.mdx
rename to src/pages/developers/chains/zetachain.en-US.mdx
diff --git a/src/pages/developers/chains/zetachain.zh-CN.mdx b/src/pages/developers/chains/zetachain.zh-CN.mdx
new file mode 100644
index 000000000..b5f130127
--- /dev/null
+++ b/src/pages/developers/chains/zetachain.zh-CN.mdx
@@ -0,0 +1,228 @@
+要从全链应用向连接链上的合约发起调用或提取代币，请使用 ZetaChain Gateway。
+
+ZetaChain Gateway 支持：
+
+- 将 ZRC-20 代币提取为连接链上的原生 Gas 代币或 ERC-20 代币。
+- 在提取代币的同时，对连接链上的合约发起调用。
+- 单纯对连接链上的合约发起调用。
+
+注意：目前不支持提取 ZETA 代币，调用会触发 `ZETANotSupported()` 回退。
+
+## 提取 ZRC-20 代币
+
+若要将 ZRC-20 代币提取到连接链上的 EOA 或合约，可调用 Gateway 合约的 `withdraw` 函数：
+
+```solidity
+function withdraw(bytes memory receiver, uint256 amount, address zrc20, RevertOptions calldata revertOptions) external;
+```
+
+`receiver` 可以是连接链上的外部拥有账户（EOA）或智能合约。即便接收方是具备标准 `receive` 函数的合约，`withdraw` 也不会触发合约调用；如果需要在提取后调用连接链合约，请改用 `withdrawAndCall`。
+
+`receiver` 类型为 `bytes`，以兼容不同链的地址格式（例如比特币的 Bech32）。当向 EVM 链提取时，需要将 `address` 转换为 `bytes`。
+
+当向非 EVM 链提取时，请确保将 `receiver` 地址按**字符串**编码为 `bytes`，即将地址作为字符串逐字转换为字节。
+
+例如，若 Solana 上的接收地址为：
+
+```
+GBwCxLUt5qn12aCD4uVKMWnoXPn2DoH126p8FrFmGNUy
+```
+
+对应的 `bytes` 表示为：
+
+```
+0x47427743784c557435716e31326143443475564b4d576e6f58506e32446f4831323670384672466d474e5579
+```
+
+`amount` 指定提取数量；`zrc20` 为待提取代币的 ZRC-20 地址。
+
+注意：某些连接链对提取金额设有最低限制。例如，将 ZRC-20 SOL 提取回 Solana 时，最少需 1,000,000（lamports）以满足免租金要求。
+
+`revertOptions.revertMessage` 长度不得超过 1024 字节。
+
+无需指定目标链，因为每个 ZRC-20 代币都绑定其存入的链，只能提取回原链。例如，要将 ZRC-20 USDC.ETH 提取到 BNB 链，必须先将其兑换为 ZRC-20 USDC.BNB。
+
+## 提取 ZRC-20 并调用连接链合约
+
+如需在提取 ZRC-20 的同时调用连接链上的合约，请使用 `withdrawAndCall`：
+
+```solidity
+function withdrawAndCall(bytes memory receiver, uint256 amount, address zrc20, bytes calldata message, CallOptions calldata callOptions, RevertOptions calldata revertOptions) external;
+```
+
+该函数会根据 `zrc20` 所指向的链提取代币并调用合约。例如，提取 ZRC-20 ETH 时，将调用以太坊上的目标合约。
+
+`message` 与 `revertOptions.revertMessage` 的总长度不得超过 1024 字节。
+
+## 调用连接链合约
+
+若仅需调用连接链合约（不提取代币），可使用 `call` 函数：
+
+```solidity
+function call(bytes memory receiver, address zrc20, bytes calldata message, CallOptions calldata callOptions, RevertOptions calldata revertOptions) external;
+```
+
+此处 `zrc20` 表示目标链 Gas 代币的 ZRC-20 地址，用于标识目标链。例如调用以太坊合约时需使用 ZRC-20 ETH 地址。
+
+`message` 与 `revertOptions.revertMessage` 总长度同样不得超过 1024 字节。
+
+## 调用参数（CallOptions）
+
+`CallOptions` 用于配置对连接链合约的调用细节，`call` 与 `withdrawAndCall` 均会使用：
+
+```solidity
+struct CallOptions {
+ uint256 gasLimit;
+ bool isArbitraryCall;
+}
+```
+
+- **`gasLimit`**：跨链合约调用可消耗的最大 Gas。若实际消耗超出该值，交易将回退。
+- **`isArbitraryCall`**：决定调用类型是“任意调用”（`true`）还是“认证调用”（`false`）。
+
+任意调用可以执行连接链上任意函数，但不会保留原始调用者身份，即目标合约中的 `msg.sender` 为 Gateway 地址，而非源全链合约。适用于无需调用者身份的场景（如代币兑换）。
+
+认证调用只会触发连接链合约中的 `onCall` 函数。协议通过 `onCall` 接收的 `context.sender`（源全链合约地址）实现鉴权，目标合约可据此验证并信任调用方，拒绝未经授权的调用。
+
+## `message` 参数格式
+
+对于任意调用（`isArbitraryCall` 为 `true`），`withdrawAndCall` 与 `call` 的 `message` 参数需包含目标函数的编码选择器和参数：
+
+- **函数选择器**：函数签名的 Keccak-256 哈希前 4 个字节。
+- **参数**：按以太坊 ABI 规则编码的剩余字节。
+
+例如：
+
+```
+0xa777d0dc00000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000005616c696365000000000000000000000000000000000000000000000000000000
+```
+
+- **函数选择器**：`0xa777d0dc` 对应 `hello(string)`。
+- **参数**：余下数据表示字符串参数 `alice` 的十六进制编码（`616c696365`）。
+
+对于认证调用，`message` 仅包含 ABI 编码的参数（无需函数选择器，因为调用会路由至指定的 `onCall`）。
+
+## 回退交易（Revert Transactions）
+
+当跨链交易（CCTX）失败时，ZetaChain 会依据 `RevertOptions` 结构体决定如何处理。行为取决于交易方向——是连接链到 ZetaChain，还是 ZetaChain 到连接链。
+
+### 连接链 → ZetaChain（入向）
+
+该场景发生在连接链上的合约通过 Gateway 的 `depositAndCall` 或 `call` 向 ZetaChain 发送代币或消息时。
+
+
+
+1. 连接链合约调用 Gateway 的 `depositAndCall` 或 `call`。
+2. Gateway 将调用转发至 ZetaChain 的**全链合约**。
+3. 若 `onCall` 函数回退，协议启动回退流程。
+
+回退行为：
+
+- 若原始调用携带的 `amount` **足以覆盖回退所需 Gas**：
+
+ - ZetaChain 会兑换部分金额为连接链对应的 Gas 代币（ZRC-20）。
+ - 协议将剩余代币与回退消息发送至连接链上的 `revertAddress`。
+ - 若 `callOnRevert` 为 `true`，Gateway 会调用 `onRevert`。
+
+- 若 `amount` **不足**或为零（例如无资产调用），Gateway 会在 ZetaChain 上调用 `onAbort`（目标为 `abortAddress`）。
+
+### ZetaChain → 连接链（出向）
+
+
+
+该场景发生在 ZetaChain 上的全链合约通过 `withdrawAndCall` 或 `call` 与连接链合约交互时。
+
+流程：
+
+1. 全链合约在 ZetaChain 上通过 `withdrawAndCall` 或 `call` 发起调用。
+2. Gateway 将消息和/或代币转发至连接链目标合约。
+3. 若目标合约回退，ZetaChain 启动回退流程。
+
+回退行为：
+
+- 若 `callOnRevert` 为 `true`：
+
+ - Gateway 会在 ZetaChain 上调用 `revertAddress` 的 `onRevert`。
+ - 剩余 ZRC-20 代币会连同回退上下文一并传递。
+ - 若 `onRevert` 自身回退，Gateway 会将 ZRC-20 代币转给 `abortAddress` 并调用其 `onAbort`。
+
+- 若 `callOnRevert` 为 `false`：
+
+ - Gateway 仅将代币转给 `revertAddress`，不执行任何函数。
+
+`RevertOptions` 结构体定义了跨链交易（CCTX）回退时资产的处理方式。
+
+### `RevertOptions` 结构体
+
+```solidity
+struct RevertOptions {
+ address revertAddress;
+ bool callOnRevert;
+ address abortAddress;
+ bytes revertMessage;
+ uint256 onRevertGasLimit;
+}
+```
+
+- `revertAddress`：接收代币或回退逻辑的地址。若为零地址，代币会退回原调用者。
+- `callOnRevert`：指定 Gateway 是否调用 `onRevert`。
+- `abortAddress`：在 `onCall` 回退（无资产调用）或回退执行失败（有资产调用）时的处理地址。
+- `revertMessage`：传递给 `onRevert` 与 `onAbort` 的消息。
+- `onRevertGasLimit`：`onRevert` 可用的最大 Gas，用于确定所需代币数量。
+
+### `onRevert`
+
+```solidity
+struct RevertContext {
+ address asset;
+ uint64 amount;
+ bytes revertMessage;
+}
+
+interface Revertable {
+ function onRevert(RevertContext calldata revertContext) external;
+}
+```
+
+- 在连接链上，`asset` 为最初存入的 ERC-20（或原生 Gas 代币对应的零地址）。
+- 在 ZetaChain 上，`asset` 为原始调用中提取的 ZRC-20。
+
+### `onAbort`
+
+```solidity
+struct AbortContext {
+ bytes sender;
+ address asset;
+ uint256 amount;
+ bool outgoing;
+ uint256 chainID;
+ bytes revertMessage;
+}
+
+interface Abortable {
+ function onAbort(AbortContext calldata abortContext) external;
+}
+```
+
+- 当回退执行失败时，ZetaChain 会作为兜底调用。
+- 适用于入向与出向交易。
+
+### 总结
+
+| 方向 | 触发条件 | 回退路径 | 回退失败的兜底措施 |
+| -------------------- | -------------------------------------- | --------------------------------------------- | --------------------------- |
+| 连接链 → ZetaChain | 全链合约的 `onCall()` 回退 | 若资金充足，在连接链调用 `onRevert()` | 在 ZetaChain 调用 `onAbort()` |
+| ZetaChain → 连接链 | 连接链目标合约回退 | 若 `callOnRevert` 为真，在 ZetaChain 调用 `onRevert()` | 在 ZetaChain 调用 `onAbort()` |
+
diff --git a/src/pages/developers/evm/_meta.json b/src/pages/developers/evm/_meta.en-US.json
similarity index 100%
rename from src/pages/developers/evm/_meta.json
rename to src/pages/developers/evm/_meta.en-US.json
diff --git a/src/pages/developers/evm/_meta.zh-CN.json b/src/pages/developers/evm/_meta.zh-CN.json
new file mode 100644
index 000000000..a7aa78ec0
--- /dev/null
+++ b/src/pages/developers/evm/_meta.zh-CN.json
@@ -0,0 +1,32 @@
+{
+ "index": {
+ "title": "概览"
+ },
+ "gateway": {
+ "title": "Gateway"
+ },
+ "connector": {
+ "title": "连接器合约"
+ },
+ "gas": {
+ "title": "Gas 费用"
+ },
+ "cctx": {
+ "title": "跨链交易"
+ },
+ "zeta": {
+ "title": "ZETA"
+ },
+ "zrc20": {
+ "title": "ZRC-20"
+ },
+ "erc20": {
+ "title": "ERC-20"
+ },
+ "addresses": {
+ "title": "账户地址"
+ },
+ "throughput": {
+ "title": "流动性吞吐"
+ }
+}
diff --git a/src/pages/developers/evm/addresses.mdx b/src/pages/developers/evm/addresses.en-US.mdx
similarity index 100%
rename from src/pages/developers/evm/addresses.mdx
rename to src/pages/developers/evm/addresses.en-US.mdx
diff --git a/src/pages/developers/evm/addresses.zh-CN.mdx b/src/pages/developers/evm/addresses.zh-CN.mdx
new file mode 100644
index 000000000..ece31b90b
--- /dev/null
+++ b/src/pages/developers/evm/addresses.zh-CN.mdx
@@ -0,0 +1,56 @@
+---
+title: 账户地址
+---
+
+import { AddressConverter } from "~/components/Docs";
+
+## 概览
+
+ZetaChain 基于 Cosmos SDK 构建，并使用 Cosmos EVM 模块提供 EVM 兼容性。身兼 Cosmos 与 EVM 链意味着 ZetaChain 支持两种地址格式：[bech32 Cosmos 地址](https://docs.cosmos.network/main/build/spec/addresses/bech32) 与 [十六进制 EVM 地址](https://ethereum.org/developers/docs/accounts)。
+
+bech32 地址具备易读性，通常以链相关的前缀开头，并通过内置的错误检测能力降低抄录与输入失误的风险。ZetaChain 的 bech32 地址使用 `zeta` 前缀。
+
+EVM 地址则以 20 字节十六进制字符串表示，用于标识 EVM 上的账户。
+
+若两种地址源自同一公钥，则同一账户可同时拥有对应的 bech32 与 EVM 地址。
+
+例如，以下为一个 bech32 地址：
+
+```
+zeta19nfaqu9wr0fktyyampva98ec025kjy0phww5um
+```
+
+可通过 HTTP API 查询该地址的账户余额：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/cosmos/bank/v1beta1/balances/zeta19nfaqu9wr0fktyyampva98ec025kjy0phww5um
+
+同一账户的 EVM 地址为：
+
+```
+0x2cD3D070aE1BD365909dD859d29F387AA96911e1
+```
+
+同样可使用 Foundry 的 `cast` 工具查询余额：
+
+```
+cast balance 0x2cD3D070aE1BD365909dD859d29F387AA96911e1 --rpc-url https://zetachain-athens-evm.blockpi.network/v1/rpc/public
+```
+
+两种查询返回的余额相同。
+
+这意味着你可以将同一助记词导入 Cosmos 钱包与 EVM 钱包，访问同一个账户。部分钱包（如 Keplr）会同时显示 bech32 与十六进制地址。
+
+> 对于表示同一账户的 bech32 与十六进制地址，无需互相转账。
+
+## 账户类型
+
+若在 Cosmos 与 EVM 钱包中使用同一账户时遇到问题，可通过链上 API 检查账户类型：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/cosmos/auth/v1beta1/accounts/zeta19nfaqu9wr0fktyyampva98ec025kjy0phww5um
+
+为确保 Cosmos 与 EVM 兼容，账户的 `@type` 应为 `/ethermint.crypto.v1.ethsecp256k1.PubKey`。
+
+## 地址转换工具
+
+如需在 bech32 地址与 EVM 地址之间转换，可使用[地址转换器](/reference/tools/address-converter)。
+
diff --git a/src/pages/developers/evm/cctx.mdx b/src/pages/developers/evm/cctx.en-US.mdx
similarity index 100%
rename from src/pages/developers/evm/cctx.mdx
rename to src/pages/developers/evm/cctx.en-US.mdx
diff --git a/src/pages/developers/evm/cctx.zh-CN.mdx b/src/pages/developers/evm/cctx.zh-CN.mdx
new file mode 100644
index 000000000..91912bc35
--- /dev/null
+++ b/src/pages/developers/evm/cctx.zh-CN.mdx
@@ -0,0 +1,99 @@
+跨链交易（CCTX）可分为两类：入站与出站。
+
+**入站交易**（连接链 → ZetaChain）在连接链上发起，并在 ZetaChain 上落地。一次入站交易包含两笔链上交易：
+
+- 入站：在连接链上发起并被观测到的交易。
+- 出站：对应交易在 ZetaChain 上广播并执行。
+
+**出站交易**（ZetaChain → 连接链）在 ZetaChain 上发起，并在连接链上落地。一次出站交易同样包含两笔交易：
+
+- 入站：在 ZetaChain 上发起并被观测到的交易。
+- 出站：对应交易在连接链上广播并执行。
+
+追踪 CCTX 时，可使用入站交易哈希查询 ZetaChain 的 Cosmos SDK HTTP API，以获取 CCTX 哈希。如果某个 CCTX 进一步触发另一笔 CCTX（例如一次入站操作触发出站），则可将第一笔 CCTX 的哈希作为入站哈希继续查询下一笔 CCTX。
+
+## 入站与出站联合流程
+
+以下示例展示了从 Ethereum Sepolia 向 ZetaChain 上的全链应用发起调用，并进一步触发 ZetaChain 向 Polygon Amoy 的出站调用。
+
+用户调用 EVM Gateway 的 `depositAndCall`，目标是 [ZetaChain 上的全链兑换合约](/developers/tutorials/swap)。该合约会将存入资产兑换为目标 ZRC-20 代币，并调用 ZetaChain Gateway 的 `withdraw`，从而在 Polygon Amoy 发起代币转账。
+
+该流程涉及两笔 CCTX：
+
+1. Ethereum Sepolia → ZetaChain 测试网
+2. ZetaChain 测试网 → Polygon Amoy
+
+Ethereum Sepolia 上的入站交易：
+
+https://sepolia.etherscan.io/tx/0x8e925fa63c69bd27a3aa8e30f4c0f1e67e5fd3fedb23339b387b51b1543e55af
+
+使用该入站交易哈希查询 CCTX 1 哈希：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/zeta-chain/crosschain/inboundHashToCctxData/0x8e925fa63c69bd27a3aa8e30f4c0f1e67e5fd3fedb23339b387b51b1543e55af
+
+再将 CCTX 1 哈希（`0x542b...11da`）作为入站哈希，查询 CCTX 2：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/zeta-chain/crosschain/inboundHashToCctxData/0x542b6bd80004f4013b725c2170b9ed01731b8af9dc61bfb5c0534dc2f0d511da
+
+Polygon Amoy 上的出站交易：
+
+https://amoy.polygonscan.com/tx/0x49f67ece0c0b59d58312df91342d46b14496abf2d8a52a1a5ce9f4c6136e8d75
+
+## 入站示例
+
+以下示例展示了从 Ethereum Sepolia 向 ZetaChain 上的全链应用发起调用。
+
+用户调用 EVM Gateway 的 `depositAndCall`，目标为 [全链兑换合约](/developers/tutorials/swap)。合约会将存入资产兑换成目标 ZRC-20，并转给 ZetaChain 上的收款人。
+
+该流程仅产生一笔 CCTX：Ethereum Sepolia → ZetaChain 测试网。
+
+Ethereum Sepolia 上的入站交易：
+
+https://sepolia.etherscan.io/tx/0xfacdad3d12988e1065e32b757d1bbc7e868fb8cbae51c909b3f178027d233f79
+
+CCTX 详情：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/zeta-chain/crosschain/inboundHashToCctxData/0xfacdad3d12988e1065e32b757d1bbc7e868fb8cbae51c909b3f178027d233f79
+
+若使用该 CCTX 哈希继续查询，API 会返回 HTTP 404，说明此 CCTX 未触发新的跨链交易。
+
+## 入站并终止（Abort）
+
+以下示例展示了从 Ethereum Sepolia 调用 ZetaChain 全链应用但最终被终止的情况。
+
+用户调用 EVM Gateway 的 `depositAndCall`，目标为 [全链兑换合约](/developers/tutorials/swap)。合约尝试将存入资产兑换为目标 ZRC-20，并计划向 Polygon Amoy 提现。但提供的代币数量不足以覆盖 Polygon Amoy 的提现 Gas 费用，导致交易回退；同时，剩余代币不足以支付回退至 Ethereum Sepolia 的费用，因此交易最终终止。
+
+Ethereum Sepolia 入站交易：
+
+https://sepolia.etherscan.io/tx/0x254d687404ff8f1cd481d2b25866e8c0a68c5d7fde08deaa60e61577752e1466
+
+CCTX 详情：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/zeta-chain/crosschain/inboundHashToCctxData/0x254d687404ff8f1cd481d2b25866e8c0a68c5d7fde08deaa60e61577752e1466
+
+## 入站并回退（Revert）
+
+以下示例展示了从 Base Sepolia 调用 ZetaChain 全链应用并发生回退的情况。
+
+用户调用 EVM Gateway 的 `depositAndCall`，目标为 [全链兑换合约](/developers/tutorials/swap)。合约尝试将存入资产兑换为目标 ZRC-20，并计划向 Polygon Amoy 提现，但代币数量不足以支付提现 Gas 费用，导致交易回退。
+
+Base Sepolia 入站交易：
+
+https://sepolia.basescan.org/tx/0x9fcff3ff5ec57b7198543e6a204f08447d6dd8dc54d33100e3e79f6deb8dc407
+
+ZetaChain 上的 CCTX 详情：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/zeta-chain/crosschain/inboundHashToCctxData/0x9fcff3ff5ec57b7198543e6a204f08447d6dd8dc54d33100e3e79f6deb8dc407
+
+回退后的 Base Sepolia 交易：
+
+https://sepolia.basescan.org/tx/0xd86a5babfb7c3297b98d05d145707010aa8f7b690af151729035c3e2d0567eae
+
+## 多个出站交易
+
+单笔交易可以触发多个 CCTX。
+
+以下示例展示了在 ZetaChain 上一次函数调用对多条链执行多个 Gateway `call`：
+
+https://zetachain-athens.blockpi.network/lcd/v1/public/zeta-chain/crosschain/inboundHashToCctxData/0x3d56898690abb98a514b0b05b799c0d61c0e305a5f962504f3b301adf01b1b34
+
diff --git a/src/pages/developers/evm/erc20.mdx b/src/pages/developers/evm/erc20.en-US.mdx
similarity index 100%
rename from src/pages/developers/evm/erc20.mdx
rename to src/pages/developers/evm/erc20.en-US.mdx
diff --git a/src/pages/developers/evm/erc20.zh-CN.mdx b/src/pages/developers/evm/erc20.zh-CN.mdx
new file mode 100644
index 000000000..a0b4b5439
--- /dev/null
+++ b/src/pages/developers/evm/erc20.zh-CN.mdx
@@ -0,0 +1,13 @@
+---
+title: ZetaChain 上的 ERC-20
+---
+
+import { Alert } from "~/components/shared";
+
+ZetaChain 完全兼容以太坊虚拟机（EVM），可无许可部署 [ERC-20](https://ethereum.org/en/developers/docs/standards/tokens/erc-20) 代币合约。
+
+
+ {" "}
+ 部署在 ZetaChain 的 ERC-20 **不具备** [ZRC-20](/developers/evm/zrc20) 的属性，尤其是无法从 ZetaChain 提现至连接链。{" "}
+
+
diff --git a/src/pages/developers/evm/gas.mdx b/src/pages/developers/evm/gas.en-US.mdx
similarity index 100%
rename from src/pages/developers/evm/gas.mdx
rename to src/pages/developers/evm/gas.en-US.mdx
diff --git a/src/pages/developers/evm/gas.zh-CN.mdx b/src/pages/developers/evm/gas.zh-CN.mdx
new file mode 100644
index 000000000..85bcd61fc
--- /dev/null
+++ b/src/pages/developers/evm/gas.zh-CN.mdx
@@ -0,0 +1,49 @@
+---
+title: Gas 费用
+---
+
+import { Fees } from "~/components/Docs";
+
+## 调用全链应用
+
+通过 Gateway 从连接链在 ZetaChain 上调用全链应用时，费用与普通交易一致，使用源链的原生 Gas 代币支付。不会产生额外费用；当调用来自连接链时，可将 ZetaChain 上执行全链应用视为“免 Gas”。
+
+例如，从以太坊向 ZetaChain 存入 ETH 时，所需费用以 ETH 支付，符合以太坊的常规 Gas 计费方式。关于以太坊 Gas 的更多信息，请参阅[官方文档](https://ethereum.org/en/developers/docs/gas/)。
+
+直接调用 ZetaChain EVM 上的合约（非跨链调用）时，用户需为每笔交易提供 Gas。ZetaChain EVM 采用 [Cosmos EVM](https://evm.cosmos.network/protocol/concepts/gas-and-fees) 实现的 Gas 市场机制，并遵循以太坊的 EIP-1559 费用模型，以保障网络安全、防止垃圾交易。
+
+## 出站调用与提现
+
+ZetaChain 上的全链应用可主动向连接链合约发起调用，或将 ZRC-20 代币提现回连接链。这类操作需要支付“提现 Gas 费用（withdraw gas fee）”，该费用基于目标链的 Gas 上限计算。
+
+在全链应用向连接链合约发起调用前，应根据预期 Gas 上限查询提现 Gas 费用：
+
+```solidity
+(address gasZRC20, uint256 gasFee) = IZRC20(zrc20).withdrawGasFeeWithGasLimit(gasLimit);
+```
+
+- `gasZRC20`：目标链的 Gas 代币地址。例如，以太坊的 USDC 与 ETH 都使用 ZRC-20 ETH 作为 Gas 代币。
+- `gasFee`：在指定 Gas 上限下所需的费用，便于准确估算成本。
+
+在将 ZRC-20 代币提现至连接链前，可查询提现 Gas 费用：
+
+```solidity
+(address gasZRC20, uint256 gasFee) = IZRC20(zrc20).withdrawGasFee();
+```
+
+提现至连接链会触发代币转移，无需显式指定 Gas 上限。
+
+务必查询最新费用、授权 Gateway 可支配所需金额，并确保 Gas ZRC-20 余额充足；若 Gateway 无法将费用转移至自身，操作将失败。
+
+## 当前费用
+
+下表展示了默认 Gas 上限为 500,000 时的提现 Gas 费用，费用以目标链的原生 Gas 代币表示。
+
+
+
+
diff --git a/src/pages/developers/protocol/_meta.json b/src/pages/developers/protocol/_meta.en-US.json
similarity index 100%
rename from src/pages/developers/protocol/_meta.json
rename to src/pages/developers/protocol/_meta.en-US.json
diff --git a/src/pages/developers/protocol/_meta.zh-CN.json b/src/pages/developers/protocol/_meta.zh-CN.json
new file mode 100644
index 000000000..797fe5521
--- /dev/null
+++ b/src/pages/developers/protocol/_meta.zh-CN.json
@@ -0,0 +1,14 @@
+{
+ "evm": {
+ "title": "ZetaChain 与 EVM"
+ },
+ "solana": {
+ "title": "Solana"
+ },
+ "ton": {
+ "title": "TON"
+ },
+ "sui": {
+ "title": "Sui"
+ }
+}
diff --git a/src/pages/developers/protocol/evm.md b/src/pages/developers/protocol/evm.en-US.md
similarity index 100%
rename from src/pages/developers/protocol/evm.md
rename to src/pages/developers/protocol/evm.en-US.md
diff --git a/src/pages/developers/protocol/evm.zh-CN.md b/src/pages/developers/protocol/evm.zh-CN.md
new file mode 100644
index 000000000..2dfa66be3
--- /dev/null
+++ b/src/pages/developers/protocol/evm.zh-CN.md
@@ -0,0 +1,492 @@
+
+
+## GatewayEVM
+[源码链接](https://github.com/zeta-chain/protocol-contracts/blob/main/contracts/evm/GatewayEVM.sol)
+
+`GatewayEVM` 合约是外部链调用智能合约的入口。
+
+*合约本身不持有资金，也不应被授予任何额度。*
+
+
+### 状态变量
+#### custody
+托管合约地址。
+
+```solidity
+address public custody;
+```
+
+#### tssAddress
+TSS（阈值签名方案）地址。
+
+```solidity
+address public tssAddress;
+```
+
+#### zetaConnector
+`ZetaConnector` 合约地址。
+
+```solidity
+address public zetaConnector;
+```
+
+#### zetaToken
+Zeta 代币合约地址。
+
+```solidity
+address public zetaToken;
+```
+
+#### additionalActionFeeWei
+同一笔交易中跨链动作的额外手续费。
+
+*同一交易中的第一个动作免费，之后的动作需支付该费用。*
+
+*管理员可调节该费用以适配网络状况。*
+
+```solidity
+uint256 public additionalActionFeeWei;
+```
+
+#### TSS_ROLE
+TSS 角色标识。
+
+```solidity
+bytes32 public constant TSS_ROLE = keccak256("TSS_ROLE");
+```
+
+#### ASSET_HANDLER_ROLE
+资产处理角色标识。
+
+```solidity
+bytes32 public constant ASSET_HANDLER_ROLE = keccak256("ASSET_HANDLER_ROLE");
+```
+
+#### PAUSER_ROLE
+暂停角色标识。
+
+```solidity
+bytes32 public constant PAUSER_ROLE = keccak256("PAUSER_ROLE");
+```
+
+#### MAX_PAYLOAD_SIZE
+payload 与 `revertOptions` 中 revert message 的最大尺寸。
+
+```solidity
+uint256 public constant MAX_PAYLOAD_SIZE = 2880;
+```
+
+#### _TRANSACTION_ACTION_COUNT_KEY
+记录交易动作数量的存储槽键位。
+
+*使用 transient storage（tload/tstore）以节省 gas。*
+
+```solidity
+uint256 private constant _TRANSACTION_ACTION_COUNT_KEY = 0x01;
+```
+
+### 函数
+#### constructor
+
+```solidity
+constructor();
+```
+
+#### initialize
+初始化 TSS 地址、Zeta 代币地址，并将管理员账户设为 `DEFAULT_ADMIN_ROLE`。管理员负责升级与暂停，TSS 承担 TSS 角色。
+
+```solidity
+function initialize(address tssAddress_, address zetaToken_, address admin_) public initializer;
+```
+
+#### _authorizeUpgrade
+授权合约升级，调用者必须具备管理员权限。
+
+```solidity
+function _authorizeUpgrade(address newImplementation) internal override onlyRole(DEFAULT_ADMIN_ROLE);
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`newImplementation`|`address`|新实现合约地址|
+
+#### updateTSSAddress
+更新 TSS 地址。
+
+```solidity
+function updateTSSAddress(address newTSSAddress) external onlyRole(DEFAULT_ADMIN_ROLE);
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`newTSSAddress`|`address`|新的 TSS 地址|
+
+#### pause
+暂停合约。
+
+```solidity
+function pause() external onlyRole(PAUSER_ROLE);
+```
+
+#### unpause
+恢复合约。
+
+```solidity
+function unpause() external onlyRole(PAUSER_ROLE);
+```
+
+#### updateAdditionalActionFee
+调整额外动作费用。
+
+*仅管理员可调用，可根据网络情况调节。*
+
+*设置为 0 时，额外动作费用功能被禁用。*
+
+```solidity
+function updateAdditionalActionFee(uint256 newFeeWei) external onlyRole(DEFAULT_ADMIN_ROLE);
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`newFeeWei`|`uint256`|新的额外动作费用（wei）|
+
+#### executeRevert
+向目标合约转移 `msg.value` 并执行其 `onRevert`，仅 TSS 可调用，可支付。
+
+```solidity
+function executeRevert(
+ address destination,
+ bytes calldata data,
+ RevertContext calldata revertContext
+)
+ public
+ payable
+ nonReentrant
+ onlyRole(TSS_ROLE)
+ whenNotPaused;
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`destination`|`address`|目标合约地址|
+|`data`|`bytes`|Calldata|
+|`revertContext`|`RevertContext`|回退上下文|
+
+#### execute
+向目标地址发起普通调用，不包含 ERC20 转账。仅 TSS 可调用，可支付。
+
+```solidity
+function execute(
+ MessageContext calldata messageContext,
+ address destination,
+ bytes calldata data
+)
+ external
+ payable
+ nonReentrant
+ onlyRole(TSS_ROLE)
+ whenNotPaused
+ returns (bytes memory);
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`messageContext`|`MessageContext`|跨链消息上下文|
+|`destination`|`address`|目标地址|
+|`data`|`bytes`|Calldata|
+
+|返回值|类型|说明|
+|----|----|----|
+|``|`bytes`|调用返回值|
+
+#### executeWithERC20
+使用 ERC20 代币执行调用。仅资产处理角色可调用，使用 ERC20 allowance，结束时会重置授权。
+
+```solidity
+function executeWithERC20(
+ MessageContext calldata messageContext,
+ address token,
+ address to,
+ uint256 amount,
+ bytes calldata data
+)
+ public
+ nonReentrant
+ onlyRole(ASSET_HANDLER_ROLE)
+ whenNotPaused;
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`messageContext`|`MessageContext`|消息上下文|
+|`token`|`address`|ERC20 代币地址|
+|`to`|`address`|目标合约地址|
+|`amount`|`uint256`|转账数量|
+|`data`|`bytes`|Calldata|
+
+#### revertWithERC20
+直接转移 ERC20 并调用 `onRevert`。仅资产处理角色可调用。
+
+```solidity
+function revertWithERC20(
+ address token,
+ address to,
+ uint256 amount,
+ bytes calldata data,
+ RevertContext calldata revertContext
+)
+ external
+ nonReentrant
+ onlyRole(ASSET_HANDLER_ROLE)
+ whenNotPaused;
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`token`|`address`|ERC20 地址|
+|`to`|`address`|目标地址|
+|`amount`|`uint256`|数量|
+|`data`|`bytes`|Calldata|
+|`revertContext`|`RevertContext`|回退上下文|
+
+#### deposit (ETH，第一个动作)
+向 TSS 地址存入 ETH 并调用全链合约，仅适用于交易中的第一个动作。
+
+```solidity
+function deposit(address receiver, RevertOptions calldata revertOptions) external payable whenNotPaused;
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`receiver`|`address`|接收地址|
+|`revertOptions`|`RevertOptions`|回退选项|
+
+#### deposit (ETH，指定金额)
+向 TSS 地址存入指定 ETH，`msg.value` = `amount + fee`。
+
+```solidity
+function deposit(
+ address receiver,
+ uint256 amount,
+ RevertOptions calldata revertOptions
+)
+ external
+ payable
+ whenNotPaused;
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`receiver`|`address`|接收地址|
+|`amount`|`uint256`|存入金额（不含费用）|
+|`revertOptions`|`RevertOptions`|回退选项|
+
+#### deposit (ERC20)
+向托管或连接器合约存入 ERC20。
+
+```solidity
+function deposit(
+ address receiver,
+ uint256 amount,
+ address asset,
+ RevertOptions calldata revertOptions
+)
+ external
+ payable
+ whenNotPaused;
+```
+
+|参数|类型|说明|
+|----|----|----|
+|`receiver`|`address`|接收地址|
+|`amount`|`uint256`|存入数量|
+|`asset`|`address`|ERC20 地址|
+|`revertOptions`|`RevertOptions`|回退选项|
+
+#### depositAndCall (ETH，第一个动作)
+向 TSS 存入 ETH 并调用全链合约，仅限第一个动作。
+
+```solidity
+function depositAndCall(
+ address receiver,
+ bytes calldata payload,
+ RevertOptions calldata revertOptions
+)
+ external
+ payable
+ whenNotPaused;
+```
+
+#### depositAndCall (ETH，指定金额)
+向 TSS 存入指定 ETH 并调用合约，`msg.value` = `amount + fee`。
+
+```solidity
+function depositAndCall(
+ address receiver,
+ uint256 amount,
+ bytes calldata payload,
+ RevertOptions calldata revertOptions
+)
+ external
+ payable
+ whenNotPaused;
+```
+
+#### depositAndCall (ERC20)
+向托管/连接器存入 ERC20 并调用全链合约。
+
+```solidity
+function depositAndCall(
+ address receiver,
+ uint256 amount,
+ address asset,
+ bytes calldata payload,
+ RevertOptions calldata revertOptions
+)
+ external
+ payable
+ whenNotPaused;
+```
+
+#### call
+不转移资产的跨链调用。
+
+```solidity
+function call(
+ address receiver,
+ bytes calldata payload,
+ RevertOptions calldata revertOptions
+)
+ external
+ payable
+ whenNotPaused;
+```
+
+#### setCustody
+设置托管合约地址。
+
+```solidity
+function setCustody(address custody_) external onlyRole(DEFAULT_ADMIN_ROLE);
+```
+
+#### setConnector
+设置连接器合约地址。
+
+```solidity
+function setConnector(address zetaConnector_) external onlyRole(DEFAULT_ADMIN_ROLE);
+```
+
+#### _resetApproval
+重置指定地址的代币授权，确保先清零再设置新值。
+
+```solidity
+function _resetApproval(address token, address to) private returns (bool);
+```
+
+#### _transferFromToAssetHandler / _transferToAssetHandler
+内部函数，用于将代币转移给资产处理者（连接器或托管合约），代码略。
+
+#### _executeArbitraryCall / _executeAuthenticatedCall
+内部函数，执行任意或认证调用。
+
+#### _revertIfOnCallOrOnRevert
+确保内部调用不会在 `onCall` / `onRevert` 执行中再次触发。
+
+#### _processFee
+处理跨链动作手续费：首个动作免费，之后动作收取 `ADDITIONAL_ACTION_FEE_WEI`。若费用为 0 会 revert。
+
+#### _validateChargedFeeForERC20 / _validateChargedFeeForETHWithAmount
+校验 ERC20 或 ETH 操作的费用是否正确。
+
+#### _getNextActionIndex
+使用 transient storage 获取并自增交易动作计数。
+
+
+## GatewayZEVM
+[源码链接](https://github.com/zeta-chain/protocol-contracts/blob/main/contracts/zevm/GatewayZEVM.sol)
+
+`GatewayZEVM` 合约是调用全链合约的入口。
+
+*合约本身不持有资金，也不应被授予额度。*
+
+### 状态变量
+- `PROTOCOL_ADDRESS`：协议常量地址。
+- `PAUSER_ROLE`：暂停角色。
+- `zetaToken`：Zeta 代币地址。
+- `registry`：ZetaChain 上的注册表地址。
+
+### 核心函数
+- `initialize`：初始化 Zeta 代币地址与管理员。
+- `pause` / `unpause`：暂停与恢复。
+- `setRegistryAddress`：配置注册表地址。
+- `_safeTransferFrom` / `_safeBurn` / `_safeDeposit`：内部安全操作。
+- `_burnProtocolFees`、`_burnZRC20ProtocolFees`、`_withdrawZRC20WithGasLimit`：费用结算与提现辅助。
+- `withdraw` / `withdrawAndCall` / `call`：向外部链提现或调用合约。
+- `execute` / `depositAndCall`：协议在 ZEVM 上执行/存入并调用用户合约。
+- `executeRevert` / `depositAndRevert` / `executeAbort`：回退与中止流程。
+- `getMaxMessageSize` / `getMinGasLimit` / `getMaxRevertGasLimit`：查询限制参数。
+
+
+## INotSupportedMethods
+[源码链接](https://github.com/zeta-chain/protocol-contracts/blob/main/contracts/Errors.sol)
+
+定义不支持的方法错误。
+
+### 错误
+- `CallOnRevertNotSupported()`：调用不支持 `callOnRevert`。
+
+
+## ERC20Custody
+[源码链接](https://github.com/zeta-chain/protocol-contracts/blob/main/contracts/evm/ERC20Custody.sol)
+
+托管存入 ZetaChain 的 ERC20，并通过 Gateway 调用合约。
+
+*该合约不会直接调用外部合约，所有调用均经由 Gateway。*
+
+### 状态变量
+- `gateway`：Gateway 接口。
+- `whitelisted`：白名单映射。
+- `tssAddress`：TSS 地址。
+- `supportsLegacy`：是否支持 Legacy 接口。
+- 角色：`PAUSER_ROLE`、`WITHDRAWER_ROLE`、`WHITELISTER_ROLE`。
+
+### 核心函数
+- `initialize`：初始化 Gateway、TSS 与管理员角色。
+- `pause` / `unpause`：暂停控制。
+- `updateTSSAddress`：更新 TSS。
+- `setSupportsLegacy`：配置 Legacy 支持。
+- `whitelist` / `unwhitelist`：管理白名单。
+- `withdraw` / `withdrawAndCall` / `withdrawAndRevert`：提现与调用。
+- `deposit`：Legacy 存入（已弃用）。
+
+
+## IERC20Custody
+[源码链接](https://github.com/zeta-chain/protocol-contracts/blob/main/contracts/evm/interfaces/IERC20Custody.sol)
+
+### 函数
+- `whitelisted(address token)`：查询是否在白名单。
+- `withdraw(address token, address to, uint256 amount)`：直接提现。
+- `withdrawAndCall`：提现并通过 Gateway 调用。
+- `withdrawAndRevert`：提现并带回退逻辑。
+
+
+## IERC20CustodyErrors
+[源码链接](https://github.com/zeta-chain/protocol-contracts/blob/main/contracts/evm/interfaces/IERC20Custody.sol)
+
+接口错误定义：
+- `ZeroAddress()`：地址为零。
+- `NotWhitelisted()`：代币未在白名单。
+- `LegacyMethodsNotSupported()`：调用不支持的旧方法。
+
+
+## IERC20CustodyEvents
+[源码链接](https://github.com/zeta-chain/protocol-contracts/blob/main/contracts/evm/interfaces/IERC20Custody.sol)
+
+事件定义：
+- `Withdrawn`：提现事件。
+- `WithdrawnAndCalled`：提现并调用。
+- `WithdrawnAndReverted`：提现并回退调用。
+- `Whitelisted` / `Unwhitelisted`：白名单变更。
+- `Deposited`：Legacy 存入事件。
+- `UpdatedCustodyTSSAddress`：TSS 更新事件。
+
diff --git a/src/pages/developers/protocol/solana.md b/src/pages/developers/protocol/solana.en-US.md
similarity index 100%
rename from src/pages/developers/protocol/solana.md
rename to src/pages/developers/protocol/solana.en-US.md
diff --git a/src/pages/developers/protocol/solana.zh-CN.md b/src/pages/developers/protocol/solana.zh-CN.md
new file mode 100644
index 000000000..eef2c1cea
--- /dev/null
+++ b/src/pages/developers/protocol/solana.zh-CN.md
@@ -0,0 +1,112 @@
+## Crate 文档
+
+**版本：** 0.1.0
+**格式版本：** 41
+
+本文档概述 ZetaChain Solana Gateway 程序提供的 Anchor 模块、指令与数据结构，便于在 Solana 链上与 ZetaChain 通信。
+
+---
+
+## 模块 `gateway`
+
+### 子模块
+
+- `program`：Solana Program 入口，暴露 `Gateway` 类型及相关实现。
+- `gateway`：核心逻辑模块，包含所有指令处理函数。
+- `instruction`：由 Anchor 生成的指令数据结构，供客户端序列化。
+
+---
+
+### 类型：`Gateway`
+
+`Gateway` 结构代表整个 Solana Gateway 程序。它实现了 Anchor 与 SPL 运行所需的多种 trait（如 `Clone`、`Send`、`TryFrom` 等），并提供 `id()` 返回程序 `Pubkey`。
+
+---
+
+## 指令处理函数
+
+模块 `gateway` 中定义了常用指令，以下列出主要函数及其参数：
+
+### `initialize`
+- 初始化 Gateway PDA。
+- 参数：`tss_address`（20 字节以太坊地址）、`chain_id`。
+
+### `increment_nonce`
+- 在出站失败时由 TSS 调用，递增 nonce。
+- 参数：`amount`、`signature`、`recovery_id`、`message_hash`、`nonce`。
+
+### `execute`
+- 提取 SOL 并调用目标程序的 `on_call`。
+- 参数：`amount`、`sender`（20 字节地址）、`data`、`signature`、`recovery_id`、`message_hash`、`nonce`。
+
+### `execute_revert`
+- 提取 SOL 并调用目标程序的 `on_revert`。
+- 参数同 `execute`，但 `sender` 为 `Pubkey`。
+
+### `execute_spl_token` / `execute_spl_token_revert`
+- 处理 SPL 代币提取并回调目标程序。
+- 额外参数：`decimals`（小数位）、`amount`。
+
+### `set_deposit_paused`
+- 切换存入功能的启停状态，仅 PDA authority 可调用。
+
+### `update_tss`
+- 更新 TSS 地址，仅 PDA authority 可调用。
+
+### `update_authority`
+- 更新 PDA authority。
+
+### `reset_nonce`
+- 重置 PDA nonce。
+
+### `whitelist_spl_mint` / `unwhitelist_spl_mint`
+- 由 TSS 调用，管理 SPL 代币白名单。
+- 参数包含 TSS 签名、`recovery_id`、`message_hash`、`nonce`。
+
+### `deposit` / `deposit_and_call`
+- 从 Solana 存入 SOL 并可选携带消息调用 ZetaChain zEVM 合约。
+- 参数：`amount`、`receiver`（20 字节地址）、`message`、`revert_options`。
+
+### `deposit_spl_token` / `deposit_spl_token_and_call`
+- 存入 SPL 代币并可选调用 zEVM 合约。
+
+### `call`
+- 仅发送消息到 zEVM 合约，不携带资产。
+
+### `withdraw` / `withdraw_spl_token`
+- 由 TSS 调用，从 Gateway 提取 SOL 或 SPL 代币。
+- 参数包含签名、`message_hash`、`nonce`。
+
+---
+
+## 指令数据结构（模块 `instruction`）
+
+Anchor 自动生成的结构体对应每个指令。示例如下：
+
+- `Initialize`：包含 `tss_address`、`chain_id`。
+- `IncrementNonce`：包含 `amount`、`signature`、`recovery_id`、`message_hash`、`nonce`。
+- `Execute` / `ExecuteRevert`：包含跨链调用参数与签名。
+- `ExecuteSplToken` / `ExecuteSplTokenRevert`：扩展 SPL 代币字段。
+- `SetDepositPaused`、`UpdateTss`、`UpdateAuthority`、`ResetNonce` 等管理类结构。
+- `Deposit`、`DepositAndCall`、`DepositSplToken`、`DepositSplTokenAndCall`、`Call`：对应各类存入与调用。
+
+所有结构均实现 `BorshSerialize`、`BorshDeserialize`、`InstructionData` 等 trait，方便在客户端组合交易。
+
+---
+
+## 辅助类型
+
+文件还定义了 `RevertOptions` 等结构（未完整展示），用于描述跨链回退策略、目标信息等。
+
+---
+
+## 小结
+
+Solana Gateway 提供了完整的跨链指令集合，让 Solana 程序可：
+- 初始化与管理 Gateway 状态（TSS、nonce、authority 等）
+- 存入 SOL / SPL 代币并向 ZetaChain 发起消息
+- 从 ZetaChain 提取资产并回调 Solana 程序
+- 管理白名单与暂停状态
+
+开发者可使用 Anchor 生成的指令结构构建客户端交易，也可参考上方函数签名在程序内进行调用。更多细节可查阅源码与 Anchor 文档。***
+
diff --git a/src/pages/developers/protocol/sui.md b/src/pages/developers/protocol/sui.en-US.md
similarity index 100%
rename from src/pages/developers/protocol/sui.md
rename to src/pages/developers/protocol/sui.en-US.md
diff --git a/src/pages/developers/protocol/sui.zh-CN.md b/src/pages/developers/protocol/sui.zh-CN.md
new file mode 100644
index 000000000..f2b80b4bf
--- /dev/null
+++ b/src/pages/developers/protocol/sui.zh-CN.md
@@ -0,0 +1,84 @@
+## 模块 `gateway::gateway`
+
+本文档概述 ZetaChain Sui Gateway 模块中暴露的结构体、常量与函数，帮助开发者理解如何在 Sui 链上与 ZetaChain 交互。
+
+---
+
+### 核心结构体
+
+- `Vault`：托管特定代币的仓库，包含余额与白名单标记。
+- `Gateway`：模块主对象，维护所有 `Vault`、当前 `nonce`、活跃权限 ID 及暂停状态。
+- `WithdrawCap` / `WhitelistCap` / `AdminCap`：分别控制提现、白名单和管理员操作的能力凭证。
+- `DepositEvent`、`DepositAndCallEvent`、`WithdrawEvent`、`NonceIncreaseEvent`、`DonateEvent`：跨链操作时发布的事件，便于链上追踪。
+
+---
+
+### 常量
+
+定义了若干错误码与限制：
+
+- `EAlreadyWhitelisted`、`ENotWhitelisted`：白名单状态校验。
+- `ENonceMismatch`：防止 nonce 复用。
+- `EInvalidReceiverAddress`：无效的 EVM 接收地址。
+- `EPayloadTooLong`：消息载荷超限，`PayloadMaxLength = 1024` 字节。
+- `EInactiveWithdrawCap`、`EInactiveWhitelistCap`：权限凭证校验。
+- `EDepositPaused`：暂停状态提示。
+
+---
+
+### 初始化与权限管理
+
+- `init`：创建 Gateway 对象，生成三类 Cap 并分发给交易发起者，默认将 `SUI` 加入白名单。
+- `issue_withdraw_and_whitelist_cap` / `issue_withdraw_and_whitelist_cap_impl`：管理员重新签发新的提现与白名单 Cap，并更新活跃 ID。
+- `pause` / `unpause`：管理员暂停或恢复存入功能，对应实现 `pause_impl` / `unpause_impl`。
+- `reset_nonce`：管理员重置 `nonce`。
+
+---
+
+### Nonce 与权限校验
+
+- `increase_nonce`：持有 `WithdrawCap` 的调用者（通常为 TSS）可在出站失败时手动递增 nonce，并触发 `NonceIncreaseEvent`。
+- `nonce` / `active_withdraw_cap` / `active_whitelist_cap`：查询当前 `nonce` 和活跃 Cap ID。
+
+---
+
+### 白名单操作
+
+- `whitelist` / `whitelist_impl`：使用 `WhitelistCap` 将某种代币加入白名单，若 vault 已存在则更新标记，否则创建新 vault。
+- `unwhitelist` / `unwhitelist_impl`：管理员移除白名单。
+- `is_whitelisted`：检测某代币是否被允许存入。
+
+---
+
+### 存入与事件
+
+- `deposit`：用户将代币存入 Gateway，传入 EVM 接收地址，记录事件 `DepositEvent`。
+- `deposit_and_call`：在存入的同时附带 payload 触发 zEVM 合约调用，payload 不得超过 `1024` 字节，对应事件 `DepositAndCallEvent`。
+- `donate`：向 Gateway 捐赠代币，接收地址固定为零地址，触发 `DonateEvent`。
+- `check_receiver_and_deposit_to_vault`：内部函数，统一检查接收地址有效性、白名单状态及暂停状态，并将代币注入 Vault。
+
+---
+
+### 提现与回调
+
+- `withdraw`：持有 `WithdrawCap` 的调用者从 Vault 中提取代币和用于 gas 的 SUI，分别转给跨链接收地址与交易发起者，同时发布 `WithdrawEvent`。
+- `withdraw_impl`：提现实现函数，校验 Cap、nonce 与白名单状态，并返回 `(Coin, Coin)`。
+
+---
+
+### 工具函数
+
+- `vault_balance`：查询指定代币在 Vault 中的余额。
+- `is_paused`：返回存入功能是否被暂停。
+- `coin_name`：将类型名称转换为 ASCII 字符串，用作 Vault 键值。
+
+---
+
+## 总结
+
+Sui Gateway 模块通过 Cap 权限体系与事件机制，为跨链存取、消息传递提供安全保障。常见流程包括：
+1. 管理员使用 `init` 初始化，并根据需要签发新的权限 Cap。
+2. 用户调用 `deposit` 或 `deposit_and_call` 将资产跨链至 zEVM。
+3. TSS 或授权实体使用 `withdraw` / `increase_nonce` 等函数处理出站资产与异常情况。
+4. 通过事件与查询函数监控状态、余额及暂停标识。***
+
diff --git a/src/pages/developers/protocol/ton.md b/src/pages/developers/protocol/ton.en-US.md
similarity index 100%
rename from src/pages/developers/protocol/ton.md
rename to src/pages/developers/protocol/ton.en-US.md
diff --git a/src/pages/developers/protocol/ton.zh-CN.md b/src/pages/developers/protocol/ton.zh-CN.md
new file mode 100644
index 000000000..e6d608a1e
--- /dev/null
+++ b/src/pages/developers/protocol/ton.zh-CN.md
@@ -0,0 +1,99 @@
+
+## TON Gateway 文档
+
+### 文件 `gateway.fc`
+
+#### 操作码常量
+
+- `op::internal::donate = 100`
+- `op::internal::deposit = 101`
+- `op::internal::deposit_and_call = 102`
+- `op::internal::call = 103`
+- `op::external::withdraw = 200`
+- `op::external::increase_seqno = 205`
+- `op::authority::set_deposits_enabled = 201`
+- `op::authority::update_tss = 202`
+- `op::authority::update_code = 203`
+- `op::authority::update_authority = 204`
+- `op::authority::reset_seqno = 206`
+
+#### `handle_deposit`
+
+```func
+() handle_deposit(int amount, slice in_msg_body) impure inline {
+```
+
+处理用户向 Gateway 存入 TON，并指定 ZetaChain zEVM 上的接收地址。
+
+#### `handle_call`
+
+```func
+() handle_call(int amount, slice in_msg_body) impure inline {
+```
+
+执行 zEVM 合约的 `onCall`，确保 `call_data` 大小与 gas 成本满足要求。当前不会退还超过手续费的多余金额，建议仅发送与 `op::call` 计算结果相等的金额。
+
+#### `handle_set_deposits_enabled`
+
+```func
+() handle_set_deposits_enabled(slice sender, slice message) impure inline {
+```
+
+启用或停用存款功能。
+
+#### `handle_update_tss`
+
+```func
+() handle_update_tss(slice sender, slice message) impure inline {
+```
+
+更新 TSS 地址，需格外谨慎，错误地址会导致资金损失。
+
+#### `handle_update_code`
+
+```func
+() handle_update_code(slice sender, slice message) impure inline {
+```
+
+升级合约代码。内部调用 `handle_code_update(cell new_code)`。
+
+#### `handle_reset_seqno`
+
+```func
+() handle_reset_seqno(slice sender, slice message) impure inline {
+```
+
+将序列号重置为指定值，对应 `reset_seqno(uint32 new_seqno)`。
+
+#### `recv_internal`
+
+```func
+() recv_internal(int my_balance, int msg_value, cell in_msg_full, slice in_msg_body) impure {
+```
+
+所有内部消息的入口。
+
+#### `handle_withdrawal`
+
+```func
+() handle_withdrawal(slice payload) impure inline {
+```
+
+执行资产提现，参数包括接收地址、金额和 `seqno`。
+
+#### `handle_increase_seqno`
+
+```func
+() handle_increase_seqno(slice payload) impure inline {
+```
+
+单纯将 `seqno` 加一，用于处理失败后的重试。载荷包含 `failure_reason` 与 `seqno`。
+
+#### `recv_external`
+
+```func
+() recv_external(slice message) impure {
+```
+
+所有外部消息的入口，依赖上述处理函数完成具体逻辑。***
+
diff --git a/src/pages/developers/standards/_meta.json b/src/pages/developers/standards/_meta.en-US.json
similarity index 100%
rename from src/pages/developers/standards/_meta.json
rename to src/pages/developers/standards/_meta.en-US.json
diff --git a/src/pages/developers/standards/_meta.zh-CN.json b/src/pages/developers/standards/_meta.zh-CN.json
new file mode 100644
index 000000000..6165df3e6
--- /dev/null
+++ b/src/pages/developers/standards/_meta.zh-CN.json
@@ -0,0 +1,11 @@
+{
+ "overview": {
+ "title": "概览"
+ },
+ "nft": {
+ "title": "通用 NFT"
+ },
+ "token": {
+ "title": "通用代币"
+ }
+}
diff --git a/src/pages/developers/standards/nft.mdx b/src/pages/developers/standards/nft.en-US.mdx
similarity index 100%
rename from src/pages/developers/standards/nft.mdx
rename to src/pages/developers/standards/nft.en-US.mdx
diff --git a/src/pages/developers/standards/nft.zh-CN.mdx b/src/pages/developers/standards/nft.zh-CN.mdx
new file mode 100644
index 000000000..d3b837483
--- /dev/null
+++ b/src/pages/developers/standards/nft.zh-CN.mdx
@@ -0,0 +1,213 @@
+通用 NFT 是完全互操作的 ERC-721 代币，可在任意已连接链上铸造与转移，无需包装或跨链桥。每个 NFT 拥有跨链保持一致的持久 Token ID，元数据显示在跨链转移中始终保留。这为跨链游戏、市场与身份等场景带来真正的链无关所有权与交互体验。
+
+ZetaChain 上的通用 NFT 基于标准的 [OpenZeppelin ERC-721](https://docs.openzeppelin.com/contracts/5.x/api/token/erc721) 实现，并采用 [UUPS 可升级](https://docs.openzeppelin.com/contracts/5.x/api/proxy#UUPSUpgradeable) 代理模式，使开发者能够在保证安全的前提下扩展与升级 NFT 逻辑。
+
+## 方案一：创建新的通用 NFT
+
+新建通用 NFT 项目：
+
+```
+npx zetachain@latest new --project nft
+```
+
+安装依赖：
+
+```
+cd nft
+yarn
+forge soldeer update
+```
+
+编译合约：
+
+```
+forge build
+```
+
+## 方案二：升级现有 ERC-721 项目
+
+你可以在现有的 ERC-721 项目中集成通用 NFT 能力，只需安装官方标准合约包：
+
+```bash
+yarn add @zetachain/standard-contracts
+```
+
+随后参考 [示例实现](https://github.com/zeta-chain/example-contracts/tree/main/examples/nft/contracts)，按照注释加入专为通用 NFT 设计的 ZetaChain 集成逻辑。
+
+这样即可在 ZetaChain 与所有已连接的 EVM 链上支持跨链铸造、转移与持久 Token ID。
+
+## 部署到测试网
+
+```
+RPC_ETHEREUM=$(zetachain q chains show --chain-id 11155111 -f rpc)
+RPC_BASE=$(zetachain q chains show --chain-id 84532 -f rpc)
+RPC_ZETACHAIN=$(zetachain q chains show --chain-id 7001 -f rpc)
+
+ZRC20_ETHEREUM=$(zetachain q tokens show -s ETH.ETHSEP -f zrc20)
+ZRC20_BASE=$(zetachain q tokens show -s ETH.BASESEP -f zrc20)
+
+GATEWAY_ETHEREUM=0x0c487a766110c85d301d96e33579c5b317fa4995
+GATEWAY_BASE=0x0c487a766110c85d301d96e33579c5b317fa4995
+GATEWAY_ZETACHAIN=0x6c533f7fe93fae114d0954697069df33c9b74fd7
+
+GAS_LIMIT=1000000
+```
+
+```
+PRIVATE_KEY=...
+```
+
+在 ZetaChain、Base 与 Ethereum 上部署合约。
+
+```
+NFT_ZETACHAIN=$(npx tsx commands deploy \
+ --rpc $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ --name ZetaChainUniversalNFT \
+ --gas-limit $GAS_LIMIT | jq -r .contractAddress) && echo $NFT_ZETACHAIN
+```
+
+```
+0x6335bAB2eF31B79eE01dCFDB656a1eEf5ACd0840
+```
+
+```
+NFT_BASE=$(npx tsx commands deploy \
+ --rpc $RPC_BASE \
+ --private-key $PRIVATE_KEY \
+ --name EVMUniversalNFT \
+ --gateway $GATEWAY_BASE \
+ --gas-limit $GAS_LIMIT | jq -r .contractAddress) && echo $NFT_BASE
+```
+
+```
+0xB7c73Ee9B4E65458C972d64bbfAe653d0E6F389A
+```
+
+```
+NFT_ETHEREUM=$(npx tsx commands deploy \
+ --rpc $RPC_ETHEREUM \
+ --private-key $PRIVATE_KEY \
+ --name EVMUniversalNFT \
+ --gateway $GATEWAY_ETHEREUM \
+ --gas-limit $GAS_LIMIT | jq -r .contractAddress) && echo $NFT_ETHEREUM
+```
+
+```
+0x166d406a3049C04bF884a4C8cfe99c5bdCebC928
+```
+
+### 连接合约
+
+部署完成后，需要将各合约互信，使其能进行跨链通信。在 ZetaChain 上调用 `setConnected`，按链对应的 ZRC-20 Gas 代币注册 Connected 合约：
+
+```
+cast send $NFT_ZETACHAIN 'setConnected(address,bytes)' $ZRC20_BASE $NFT_BASE --rpc-url $RPC_ZETACHAIN --private-key $PRIVATE_KEY
+```
+
+```
+cast send $NFT_ZETACHAIN 'setConnected(address,bytes)' $ZRC20_ETHEREUM $NFT_ETHEREUM --rpc-url $RPC_ZETACHAIN --private-key $PRIVATE_KEY
+```
+
+随后在每条已连接链上，调用 `setUniversal` 将 Universal 合约地址指回 ZetaChain：
+
+```
+cast send $NFT_BASE 'setUniversal(address)' $NFT_ZETACHAIN --rpc-url $RPC_BASE --private-key $PRIVATE_KEY
+```
+
+```
+cast send $NFT_ETHEREUM 'setUniversal(address)' $NFT_ZETACHAIN --rpc-url $RPC_ETHEREUM --private-key $PRIVATE_KEY
+```
+
+这样即可确保只有经过授权的合约可以跨链发送与接收 NFT。
+
+### 在 ZetaChain 铸造
+
+```
+TOKEN_ID=$(npx tsx commands mint \
+ --rpc $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ --contract $NFT_ZETACHAIN \
+ --token-uri https://example.com/nft/metadata/1 | jq -r .tokenId) && echo $TOKEN_ID
+```
+
+### 从 ZetaChain 转移至 Base
+
+将该 NFT 从 ZetaChain 转移到 Base。Gas 金额（以 ZETA 指定）为估算值，剩余部分会退回用户。
+
+使用 ZRC-20 Base ETH 作为目标地址，用于指明目标链。
+
+```
+npx tsx commands transfer \
+ --rpc $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ --contract $NFT_ZETACHAIN \
+ --token-id $TOKEN_ID \
+ --destination $ZRC20_BASE \
+ --gas-amount 5 | jq -r .transferTransactionHash
+```
+
+```
+0xc1d363c8fddd21add48580c52550248f969a9a3b65d1377440cefe7fa8631db8
+```
+
+```
+zetachain q cctx --hash 0xc1d363c8fddd21add48580c52550248f969a9a3b65d1377440cefe7fa8631db8
+```
+
+```
+7001 → 84532 ✅ OutboundMined
+CCTX: 0x8066aaf467afb79d5c969b3389f958d566637ad690410b7538706d20d6eeceac
+Tx Hash: 0xc1d363c8fddd21add48580c52550248f969a9a3b65d1377440cefe7fa8631db8 (on chain 7001)
+Tx Hash: 0xe2c966b67fdc6759669cebc021466c408449f5c2c19954ffdb6e73d714ec29bc (on chain 84532)
+Sender: 0x6335bAB2eF31B79eE01dCFDB656a1eEf5ACd0840
+Receiver: 0xB7c73Ee9B4E65458C972d64bbfAe653d0E6F389A
+Message: 0000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba32000000000000000000000000a6ca386bc8dc2baad9c67208f0129de2244bda1b00000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba320000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000002268747470733a2f2f6578616d706c652e636f6d2f6e66742f6d657461646174612f310000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+```
+
+### 从 Base 转移至 Ethereum
+
+再将 NFT 从 Base 转移到 Ethereum。Token ID 保持不变。
+
+```
+npx tsx commands transfer \
+ --rpc $RPC_BASE \
+ --private-key $PRIVATE_KEY \
+ --contract $NFT_BASE \
+ --token-id $TOKEN_ID \
+ --destination $ZRC20_ETHEREUM \
+ --gas-amount 0.05 | jq -r .transferTransactionHash
+```
+
+```
+0x4aa957b2678232fb3f09557e8fcee22d5503272b6d6b8001677f32cbcdfa30dc
+```
+
+```
+zetachain q cctx --hash 0x4aa957b2678232fb3f09557e8fcee22d5503272b6d6b8001677f32cbcdfa30dc
+```
+
+```
+84532 → 7001 ✅ OutboundMined
+CCTX: 0xa54aea97073e6f76bf28c46290b0544b80aa1e85702284aacbedf03d5f59c322
+Tx Hash: 0x4aa957b2678232fb3f09557e8fcee22d5503272b6d6b8001677f32cbcdfa30dc (on chain 84532)
+Tx Hash: 0xe8d8432917cc0cb98f60285c711608003859924f3dc962c648db23232a36dcbb (on chain 7001)
+Sender: 0xB7c73Ee9B4E65458C972d64bbfAe653d0E6F389A
+Receiver: 0x6335bAB2eF31B79eE01dCFDB656a1eEf5ACd0840
+Message: 00000000000000000000000005ba149a7bd6dc1f937fa9046a9e05c05f3b18b00000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba32000000000000000000000000a6ca386bc8dc2baad9c67208f0129de2244bda1b00000000000000000000000000000000000000000000000000000000000000c00000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba320000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000002268747470733a2f2f6578616d706c652e636f6d2f6e66742f6d657461646174612f310000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+Amount: 50000000000000000 Gas tokens
+
+7001 → 11155111 ✅ OutboundMined
+CCTX: 0x34656cbd3210f3e33edb6d261bfdbc800476baa85f40fc15b75f934efbbd30c9
+Tx Hash: 0xa54aea97073e6f76bf28c46290b0544b80aa1e85702284aacbedf03d5f59c322 (on chain 7001)
+Tx Hash: 0xe7c0d400bd94e5c84cb44752d1e9e05e05f73f0433f6e915e77cc7fdde47d8fd (on chain 11155111)
+Sender: 0x6335bAB2eF31B79eE01dCFDB656a1eEf5ACd0840
+Receiver: 0x166d406a3049C04bF884a4C8cfe99c5bdCebC928
+Message: 0000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba32000000000000000000000000a6ca386bc8dc2baad9c67208f0129de2244bda1b00000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000e22dfad4b38420000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba320000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000002268747470733a2f2f6578616d706c652e636f6d2f6e66742f6d657461646174612f310000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+Amount: 3978993754388546 Gas tokens
+```
+
+## 源码
+
+https://github.com/zeta-chain/example-contracts/tree/main/examples/nft
+
diff --git a/src/pages/developers/standards/overview.mdx b/src/pages/developers/standards/overview.en-US.mdx
similarity index 100%
rename from src/pages/developers/standards/overview.mdx
rename to src/pages/developers/standards/overview.en-US.mdx
diff --git a/src/pages/developers/standards/overview.zh-CN.mdx b/src/pages/developers/standards/overview.zh-CN.mdx
new file mode 100644
index 000000000..c052f0396
--- /dev/null
+++ b/src/pages/developers/standards/overview.zh-CN.mdx
@@ -0,0 +1,65 @@
+通用 NFT 与通用代币标准，使非同质化代币（ERC-721）与同质化代币（ERC-20）能够在任意链上铸造，并在已连接的链之间无缝转移。
+
+为方便起见，本文将通用 NFT 与通用代币统称为“资产”。
+
+当资产在链间转移时，会先在源链上销毁，并将资产的元数据与信息通过消息发送给目标链上的资产合约，由该合约铸造出对应资产。
+
+通用 NFT 与通用代币项目均由两个合约组成：**Universal** 与 **Connected**。
+
+Universal 合约部署在 ZetaChain，用于：
+
+- 在 ZetaChain 上铸造资产
+- 将资产从 ZetaChain 转移到已连接的链
+- 处理来自已连接链到 ZetaChain 的入站资产转移
+- 处理已连接链之间的资产转移
+
+Connected 合约部署在一个或多个已连接的 EVM 链上，用于：
+
+- 在已连接链上铸造资产
+- 将资产转移到另一条已连接链或 ZetaChain
+- 处理来自 ZetaChain 或其他已连接链的入站资产转移
+
+Universal 合约必须在 ZetaChain 上部署；Connected 合约可按需部署，以便为特定链启用资产转移。
+
+通用资产可以在任意链上铸造——无论是 ZetaChain，还是任何已连接的 EVM 链。
+
+对于通用 NFT，资产铸造后会获得一个跨所有链唯一的持久 ID。该 ID 在资产跨链流转时保持不变。
+
+资产可从 ZetaChain 转移到已连接链、从已连接链转移回 ZetaChain，也能在已连接链之间互转。ZetaChain 作为跨链交易的枢纽，所有转移都会经由它进行路由。例如，当资产从以太坊转移到 BNB 时，会触发两笔跨链交易：Ethereum → ZetaChain → BNB。这样的设计不会增加时间或成本，却能在新增链时线性扩展。
+
+跨链资产转移支持回退（revert）。如果目标链上的转移失败，资产会返还给源链上的原始发送者。
+
+资产合约只接受来自可信合约的跨链调用。每个已连接链上的合约都会存储 ZetaChain 上 Universal 合约的地址；Universal 合约则保存其他链上 Connected 合约的地址。这样可确保只有同一资产合集下的合约才可发起跨链转移。
+
+以下以通用 NFT 为例，展示整体流程：
+
+
+
+## 部署
+
+1. 在 ZetaChain 上部署 **Universal** 合约。该步骤必不可少，因为 ZetaChain 是所有跨链转移（包括已连接 EVM 链之间互转）的枢纽。
+2. 在任一受支持的 EVM 链（如 Ethereum、Base、Polygon、BNB）部署 **Connected** 合约。
+3. 在 ZetaChain 上的 Universal 合约中执行 `setConnected(zrc20, connectedAddress)`：
+ - `zrc20` 是目标 EVM 链的 [ZRC-20 合约](/developers/evm/zrc20)，用来标识该链。
+ - `connectedAddress` 是该 EVM 链上 **Connected** 合约的地址（步骤 2）。
+4. 在已连接的 EVM 链上执行
+ `ConnectedAsset.setUniversal(universalAddress)`，其中 `universalAddress` 为 ZetaChain 上 **Universal** 合约的地址（步骤 1）。
+
+至此，ZetaChain 与已连接 EVM 链上可信的资产合约已部署并互相绑定。
+
+若要支持更多 EVM 链，重复步骤 2 与步骤 3 即可。
+
+> `setConnected` 与 `setUniversal` 用于建立合约之间的信任关系。每个合约都会验证跨链调用是否来自受信任的对应方。
+
+## Gas 费用
+
+- **EVM → ZetaChain：** 不收取跨链费用。
+- **ZetaChain → EVM：** 需要支付 **ZETA** 作为跨链费用，金额基于目标链的 ZRC-20 提现费用。系统会将 ZETA 自动兑换成目标链的 ZRC-20 Gas 代币以完成执行。
+- **EVM → EVM：** 跨链费用以**源链的 Gas 代币**支付。例如，从 Ethereum 转移资产到 BNB 时，费用以 ETH 支付。ZetaChain 使用 ZRC-20 ETH 进行执行，并兑换为 ZRC-20 BNB 调用目标链。
+
+## 回退处理
+
+如果跨链转移在目标链失败（例如因为耗尽 Gas、合约拒绝或网络错误），资产会**返还给原始发送者**。
+
+当两个已连接 EVM 链之间的转移失败时，资产会回退到 **ZetaChain 上的原始发送者**，而非源链。这避免了将资产退回源链时的高昂开销，发送者随后可再次发起到同链或其他链的转移。***
+
diff --git a/src/pages/developers/standards/token.mdx b/src/pages/developers/standards/token.en-US.mdx
similarity index 100%
rename from src/pages/developers/standards/token.mdx
rename to src/pages/developers/standards/token.en-US.mdx
diff --git a/src/pages/developers/standards/token.zh-CN.mdx b/src/pages/developers/standards/token.zh-CN.mdx
new file mode 100644
index 000000000..876bd0265
--- /dev/null
+++ b/src/pages/developers/standards/token.zh-CN.mdx
@@ -0,0 +1,196 @@
+通用代币是完全互操作的 ERC-20 代币，可在任意已连接链上铸造与转移，无需包装或跨链桥。每个代币在所有链上都保持统一的总量与元数据，为多链 DeFi、支付与治理系统带来真正的链无关流动性。
+
+ZetaChain 上的通用代币基于标准的 [OpenZeppelin ERC-20](https://docs.openzeppelin.com/contracts/5.x/api/token/erc20) 实现，并采用 [UUPS 可升级](https://docs.openzeppelin.com/contracts/5.x/api/proxy#UUPSUpgradeable) 代理模式，使开发者可以在保障安全的前提下迭代与升级代币逻辑。
+
+## 方案一：创建新的通用代币
+
+新建通用代币项目：
+
+```
+npx zetachain@latest new --project token
+```
+
+安装依赖：
+
+```
+cd token
+yarn
+forge soldeer update
+```
+
+编译合约：
+
+```
+forge build
+```
+
+## 方案二：升级现有 ERC-20 项目
+
+你可以将现有 ERC-20 项目升级为通用代币，只需安装官方标准合约包：
+
+```bash
+yarn add @zetachain/standard-contracts
+```
+
+随后参考 [示例实现](https://github.com/zeta-chain/example-contracts/tree/main/examples/token/contracts)，留意带有通用代币专用逻辑的注释，并将相关代码整合进你的合约中。
+
+这样即可让代币支持在 ZetaChain 与已连接 EVM 链之间进行跨链铸造、转移与总量跟踪。
+
+## 部署到测试网
+
+```
+RPC_ETHEREUM=$(zetachain q chains show --chain-id 11155111 -f rpc)
+RPC_BASE=$(zetachain q chains show --chain-id 84532 -f rpc)
+RPC_ZETACHAIN=$(zetachain q chains show --chain-id 7001 -f rpc)
+
+ZRC20_ETHEREUM=$(zetachain q tokens show -s ETH.ETHSEP -f zrc20)
+ZRC20_BASE=$(zetachain q tokens show -s ETH.BASESEP -f zrc20)
+
+GATEWAY_ETHEREUM=0x0c487a766110c85d301d96e33579c5b317fa4995
+GATEWAY_BASE=0x0c487a766110c85d301d96e33579c5b317fa4995
+GATEWAY_ZETACHAIN=0x6c533f7fe93fae114d0954697069df33c9b74fd7
+
+GAS_LIMIT=1000000
+```
+
+```
+PRIVATE_KEY=...
+```
+
+在 ZetaChain、Base 与 Ethereum 上部署合约。
+
+```
+ZETACHAIN_TOKEN=$(npx tsx commands deploy \
+ --rpc $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ --name ZetaChainUniversalToken \
+ --gas-limit $GAS_LIMIT | jq -r .contractAddress) && echo $ZETACHAIN_TOKEN
+```
+
+```
+BASE_TOKEN=$(npx tsx commands deploy \
+ --rpc $RPC_BASE \
+ --private-key $PRIVATE_KEY \
+ --name EVMUniversalToken \
+ --gateway $GATEWAY_BASE \
+ --gas-limit $GAS_LIMIT | jq -r .contractAddress) && echo $BASE_TOKEN
+```
+
+```
+ETHEREUM_TOKEN=$(npx tsx commands deploy \
+ --rpc $RPC_ETHEREUM \
+ --private-key $PRIVATE_KEY \
+ --name EVMUniversalToken \
+ --gateway $GATEWAY_ETHEREUM \
+ --gas-limit $GAS_LIMIT | jq -r .contractAddress) && echo $ETHEREUM_TOKEN
+```
+
+### 连接合约
+
+部署完成后，需要让各合约互信以支持跨链通信。在 ZetaChain 上调用 `setConnected`，按链对应的 ZRC-20 Gas 代币注册 Connected 合约：
+
+```
+cast send $ZETACHAIN_TOKEN 'setConnected(address,bytes)' $ZRC20_BASE $BASE_TOKEN --rpc-url $RPC_ZETACHAIN --private-key $PRIVATE_KEY
+```
+
+```
+cast send $ZETACHAIN_TOKEN 'setConnected(address,bytes)' $ZRC20_ETHEREUM $ETHEREUM_TOKEN --rpc-url $RPC_ZETACHAIN --private-key $PRIVATE_KEY
+```
+
+随后在每条已连接链上，调用 `setUniversal` 指回 ZetaChain 上的 Universal 合约：
+
+```
+cast send $BASE_TOKEN 'setUniversal(address)' $ZETACHAIN_TOKEN --rpc-url $RPC_BASE --private-key $PRIVATE_KEY
+```
+
+```
+cast send $ETHEREUM_TOKEN 'setUniversal(address)' $ZETACHAIN_TOKEN --rpc-url $RPC_ETHEREUM --private-key $PRIVATE_KEY
+```
+
+这样即可确保只有授权合约能跨链发送与接收代币。
+
+### 在 ZetaChain 铸造
+
+```
+npx tsx commands mint \
+ --rpc $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ --contract $ZETACHAIN_TOKEN \
+ --amount 10 | jq -r .mintTransactionHash
+```
+
+https://zetachain-testnet.blockscout.com/tx/0xbe550cb123e34c4bddf3b273e854837ea6f727e527bf80a752870c3f8bff0ef1
+
+### 从 ZetaChain 转移至 Base
+
+将代币从 ZetaChain 转移到 Base。Gas 金额（以 ZETA 指定）为估算值，未使用部分会退还给用户。
+
+使用 ZRC-20 Base ETH 作为目标地址，指明代币要转移到的链。
+
+```
+npx tsx commands transfer \
+ --rpc $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ --from $ZETACHAIN_TOKEN \
+ --destination $ZRC20_BASE \
+ --amount 10 \
+ --gas-amount 5 | jq -r .transferTransactionHash
+```
+
+```
+zetachain q cctx --hash 0x2ced374831b7612f4f2df98f2d1f30b2fa797ddcc62df0a5883b402b9310fe7a
+```
+
+```
+7001 → 84532 ✅ OutboundMined
+CCTX: 0x88ac99d5ce593af62f5e56e2cdeb14797e23fb890933f50d74f1c8944b91b991
+Tx Hash: 0x2ced374831b7612f4f2df98f2d1f30b2fa797ddcc62df0a5883b402b9310fe7a (on chain 7001)
+Tx Hash: 0x4c0dbfda09e0364a54be7f812a49c677739f0c3a9bc6d2e6bf0c8d5ea4a7903d (on chain 84532)
+Sender: 0xE3CA615E4Bd2b106ff51e88A04Ec39A2Afc75212
+Receiver: 0x449777033Ff53aD3B4F70C17c31110476E61D2A8
+Message: 0000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba32000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba3200000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000
+```
+
+### 从 Base 转移至 Ethereum
+
+再将代币从 Base 转移到 Ethereum。
+
+```
+npx tsx commands transfer \
+ --rpc $RPC_BASE \
+ --private-key $PRIVATE_KEY \
+ --from $BASE_TOKEN \
+ --destination $ZRC20_ETHEREUM \
+ --amount 10 \
+ --gas-amount 0.005 | jq -r .transferTransactionHash
+```
+
+```
+zetachain q cctx --hash 0x8db12522169485a44ba8490d53f734ac6b7f5da72a6decbe3ae462198a960cee
+```
+
+```
+84532 → 7001 ✅ OutboundMined
+CCTX: 0x39d970fc742519c87e67733ffd13315dce907c07e65cf97ba4ffba2e2bf2ceed
+Tx Hash: 0x8db12522169485a44ba8490d53f734ac6b7f5da72a6decbe3ae462198a960cee (on chain 84532)
+Tx Hash: 0x180f7fecd37f9e097ae5372ec729502933aa15cd6ec078af1efb911370fb33ea (on chain 7001)
+Sender: 0x449777033Ff53aD3B4F70C17c31110476E61D2A8
+Receiver: 0xE3CA615E4Bd2b106ff51e88A04Ec39A2Afc75212
+Message: 00000000000000000000000005ba149a7bd6dc1f937fa9046a9e05c05f3b18b00000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba32000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba3200000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000
+Amount: 5000000000000000 Gas tokens
+
+7001 → 11155111 ✅ PendingOutbound (transaction broadcasted to target chain)
+CCTX: 0xbbc4e169decc986556b079445dc5055725dff65e9ee66a48613374c1b4e64eda
+Tx Hash: 0x39d970fc742519c87e67733ffd13315dce907c07e65cf97ba4ffba2e2bf2ceed (on chain 7001)
+Tx Hash: 0x5f973954ab6c6745e770e02f4697309b3e18be60fc53764c7b6deec07cd5fe4b (on chain 11155111)
+Sender: 0xE3CA615E4Bd2b106ff51e88A04Ec39A2Afc75212
+Receiver: 0xBc1eE0E9452eC2E809FC2dBD0000A7D6095fDfC2
+Message: 0000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba32000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000006ba661563e1c0000000000000000000000004955a3f38ff86ae92a914445099caa8ea2b9ba3200000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000
+Amount: 118362341785116 Gas tokens
+Status: PendingOutbound, initiating outbound
+```
+
+## 源码
+
+https://github.com/zeta-chain/example-contracts/tree/main/examples/token
+
diff --git a/src/pages/developers/tutorials/_meta.json b/src/pages/developers/tutorials/_meta.en-US.json
similarity index 100%
rename from src/pages/developers/tutorials/_meta.json
rename to src/pages/developers/tutorials/_meta.en-US.json
diff --git a/src/pages/developers/tutorials/_meta.zh-CN.json b/src/pages/developers/tutorials/_meta.zh-CN.json
new file mode 100644
index 000000000..ab2fe1bac
--- /dev/null
+++ b/src/pages/developers/tutorials/_meta.zh-CN.json
@@ -0,0 +1,32 @@
+{
+ "intro": {
+ "title": "入门指南"
+ },
+ "hello": {
+ "title": "第一个全链合约"
+ },
+ "frontend": {
+ "title": "构建 Web 应用"
+ },
+ "swap": {
+ "title": "跨链兑换"
+ },
+ "messaging": {
+ "title": "跨链消息"
+ },
+ "call": {
+ "title": "往返 EVM 的调用"
+ },
+ "solana": {
+ "title": "往返 Solana 的调用"
+ },
+ "sui": {
+ "title": "从 Sui 发起调用"
+ },
+ "sui-withdraw-and-call": {
+ "title": "调用 Sui"
+ },
+ "staking": {
+ "title": "质押"
+ }
+}
diff --git a/src/pages/developers/tutorials/call.mdx b/src/pages/developers/tutorials/call.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/call.mdx
rename to src/pages/developers/tutorials/call.en-US.mdx
diff --git a/src/pages/developers/tutorials/call.zh-CN.mdx b/src/pages/developers/tutorials/call.zh-CN.mdx
new file mode 100644
index 000000000..665b1e53f
--- /dev/null
+++ b/src/pages/developers/tutorials/call.zh-CN.mdx
@@ -0,0 +1,478 @@
+在本教程中，你将构建一个 ZetaChain 全链应用，使其能够：
+
+- 处理来自连接 EVM 链的入站调用
+- 向连接 EVM 链上的合约发起出站调用
+- 使用回退机制优雅处理失败
+
+你将部署两个合约：
+
+- **Universal App**：部署在 ZetaChain，处理跨链调用，可向连接链回发调用并可选携带代币。
+- **Connected Contract**：部署在连接的 EVM 链，可调用 Universal App，并接收其回调。
+
+该模式展示了 ZetaChain 与连接链之间双向通信的核心流程：
+
+- 入站调用：连接链 → ZetaChain
+- 出站调用：ZetaChain → 连接链
+- 可选的双向代币转移
+- 回退处理以在失败时平稳恢复
+
+完成后，你将拥有一个最小可用的双向合约调用示例，支持可选代币流转与健壮的错误处理。
+
+## 前置条件
+
+请先完成以下教程：
+
+- [全链应用简介](/start/app/)
+- [ZetaChain 入门](/developers/tutorials/intro)
+- [第一个全链应用](/developers/tutorials/hello)
+
+## 环境初始化
+
+使用 `call` 模板创建项目：
+
+```bash
+zetachain new --project call
+cd call
+```
+
+安装依赖：
+
+```bash
+yarn
+```
+
+拉取 Solidity 依赖并编译合约：
+
+```bash
+forge soldeer update
+forge build
+```
+
+现在可以开始编写 Universal App 与 Connected Contract 的核心逻辑。接下来我们先解析 Universal App 如何处理入站调用并向连接链发起出站调用。
+
+## Universal App
+
+Universal App 部署在 ZetaChain，实现 `UniversalContract` 接口。它通过 Gateway 接收来自连接链的调用，也可以（带或不带代币）向连接链发起调用。
+
+### 处理入站调用
+
+当连接链调用 Universal App 时，Gateway 会触发 `onCall`。在此解码消息并执行你的业务逻辑：
+
+```solidity
+function onCall(
+ MessageContext calldata context,
+ address zrc20,
+ uint256 amount,
+ bytes calldata message
+) external override onlyGateway {
+ string memory name = abi.decode(message, (string));
+ emit HelloEvent("Hello on ZetaChain", name);
+}
+```
+
+- `context`：包含来源链与发送者信息
+- `zrc20`：源链 Gas 资产（或转入代币）的 ZRC-20 地址
+- `amount`：转入的代币数量
+- `message`：源链编码的任意载荷
+
+### 发起出站调用
+
+若要从 Universal App 调用连接链合约，首先根据目标链的 Gas 上限报价手续费，向调用方收取后批准 Gateway：
+
+```solidity
+(, uint256 gasFee) = IZRC20(zrc20).withdrawGasFeeWithGasLimit(callOptions.gasLimit);
+IZRC20(zrc20).transferFrom(msg.sender, address(this), gasFee);
+IZRC20(zrc20).approve(address(gateway), gasFee);
+```
+
+然后通过 `gateway.call` 发送跨链请求：
+
+```solidity
+gateway.call(
+ receiver, // bytes：连接链合约地址
+ zrc20, // 目标链 Gas 对应的 ZRC-20
+ message, // 目标合约的 calldata
+ callOptions, // Gas 上限、调用类型
+ revertOptions // 回退处理配置
+);
+```
+
+### 同步提取代币并调用
+
+如果希望在一次交易中既提取代币又调用目标链合约，可使用：
+
+```solidity
+gateway.withdrawAndCall(
+ receiver,
+ amount,
+ zrc20,
+ message,
+ callOptions,
+ revertOptions
+);
+```
+
+该流程会在 ZetaChain 销毁相应 ZRC-20，并在目标链释放对应原生资产或 ERC-20，同时执行合约调用。
+
+## Connected Contract
+
+Connected 合约部署在连接的 EVM 链，通过 EVM Gateway 与 ZetaChain 上的 Universal App 交互。
+
+实际上，你也可以直接从 EOA 调用 Gateway 发起跨链调用，这里使用合约仅为示例，展示如何在链上工作流中嵌入跨链逻辑。
+
+### 调用 Universal App（EVM → ZetaChain）
+
+向 Universal App 发送任意 calldata：
+
+```solidity
+gateway.call(
+ receiver, // address：ZetaChain 上 Universal App 的 EVM 地址
+ message, // bytes：传入 Universal onCall 的 ABI 编码载荷
+ revertOptions // 执行失败时的回退处理
+);
+```
+
+跨链交易完成后，目标 Universal App 的 `onCall` 会收到该载荷。
+
+### 存入代币
+
+向 ZetaChain 的地址/合约存入原生 Gas：
+
+```solidity
+gateway.deposit{value: msg.value}(receiver, revertOptions);
+```
+
+存入受支持的 ERC-20：
+
+```solidity
+IERC20(asset).transferFrom(msg.sender, address(this), amount);
+IERC20(asset).approve(address(gateway), amount);
+gateway.deposit(receiver, amount, asset, revertOptions);
+```
+
+`deposit` 仅将代币转给 ZetaChain 上的 `receiver`（EOA 或合约），不执行任何逻辑，代币以 ZRC-20 形式到账。
+
+### 存入并调用
+
+在一次交易中发送价值并在 ZetaChain 执行逻辑。
+
+原生 Gas：
+
+```solidity
+gateway.depositAndCall{value: msg.value}(
+ receiver,
+ message,
+ revertOptions
+);
+```
+
+ERC-20：
+
+```solidity
+IERC20(asset).transferFrom(msg.sender, address(this), amount);
+IERC20(asset).approve(address(gateway), amount);
+gateway.depositAndCall(
+ receiver,
+ amount,
+ asset,
+ message,
+ revertOptions
+);
+```
+
+跨链交易完成后，目标 Universal App 的 `onCall` 会在收到代币与载荷的同一执行中运行。
+
+## 回退处理
+
+跨链调用可能因为目标链 Gas 不足、目标合约不存在函数、或逻辑回退等原因失败。通过传入 `RevertOptions` 结构体，可以优雅应对这些情况。
+
+当调用失败时，Gateway 会调用发起方合约的 `onRevert`，并携带 `RevertContext` 说明原因。
+
+### 示例：Universal App 的 onRevert
+
+```solidity
+function onRevert(RevertContext calldata revertContext)
+ external
+ onlyGateway
+{
+ emit RevertEvent("Revert on ZetaChain", revertContext);
+}
+```
+
+你可以利用该钩子：
+
+- 触发事件供链下监控
+- 向原始发送者退款
+- 重试或执行补偿逻辑
+
+### 传递 RevertOptions
+
+在调用或 `withdrawAndCall` 时，传入 `RevertOptions` 可配置：
+
+- 回退地址（接收退款）
+- 是否调用 `onRevert`
+- 自定义回退消息
+- 回退调用的 Gas 限额
+
+出站调用示例：
+
+```solidity
+gateway.call(
+ receiver,
+ zrc20,
+ message,
+ callOptions,
+ RevertOptions({
+ revertAddress: msg.sender,
+ callOnRevert: true,
+ abortAddress: address(0),
+ revertMessage: abi.encode("refund"),
+ onRevertGasLimit: 500_000
+ })
+);
+```
+
+## 方案一：部署到测试网
+
+部署前需要准备：
+
+- 拥有资金的私钥（ZetaChain 测试网与连接 EVM 测试网，如 Base Sepolia）
+- 两条链的 Gateway 地址
+
+```bash
+GATEWAY_BASE=0x0c487a766110c85d301d96e33579c5b317fa4995
+
+RPC_ZETACHAIN=https://zetachain-athens-evm.blockpi.network/v1/rpc/public
+RPC_BASE=https://sepolia.base.org
+```
+
+### 部署 Universal 至 ZetaChain 测试网
+
+```bash
+UNIVERSAL=$(forge create Universal \
+ --rpc-url $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ --broadcast \
+ --json | jq -r .deployedTo) && echo $UNIVERSAL
+```
+
+### 部署 Connected 至 Base Sepolia
+
+```bash
+CONNECTED=$(forge create Connected \
+ --rpc-url $RPC_BASE \
+ --private-key $PRIVATE_KEY \
+ --broadcast \
+ --json \
+ --constructor-args $GATEWAY_BASE | jq -r .deployedTo) && echo $CONNECTED
+```
+
+### 调用 Universal App
+
+在 Base Sepolia 上调用 Connected 合约，它会通过 Gateway 转发至 ZetaChain 上的 Universal App。跨链交易完成后，`onCall` 会执行。
+
+```bash
+cast send $CONNECTED \
+ --rpc-url $RPC_BASE \
+ --private-key $PRIVATE_KEY \
+ --json \
+ "call(address,bytes,(address,bool,address,bytes,uint256))" \
+ $UNIVERSAL \
+ $(cast abi-encode "f(string)" "hello") \
+ "(0x0000000000000000000000000000000000000000,false,$UNIVERSAL,0x,0)" | jq -r '.transactionHash'
+```
+
+第三个参数即 RevertOptions 结构：
+
+```
+(revertAddress, callOnRevert, abortAddress, revertMessage, onRevertGasLimit)
+```
+
+- `revertAddress`：失败时退款地址。对于无代币转移的 `call`，使用零地址。
+- `callOnRevert`：Gateway 的 `call` 不支持回退调用，因此必须为 `false`。
+- `abortAddress`：交付失败时的中止地址。使用 Universal 合约地址，以便触发 `onAbort`。
+- `revertMessage`：回退时返回的任意字节。
+- `onRevertGasLimit`：`callOnRevert` 为 `false` 时设为 `0`。
+
+也可使用命令：
+
+```bash
+npx tsx ./commands connected call \
+ --rpc $RPC_BASE \
+ --contract $CONNECTED \
+ --private-key $PRIVATE_KEY \
+ --receiver $UNIVERSAL \
+ --types string \
+ --values hello \
+ --name Connected
+```
+
+广播交易后，可使用 ZetaChain CLI 追踪跨链流程：
+
+```bash
+zetachain query cctx --hash $HASH
+```
+
+该命令会展示 CCTX 全生命周期，包括当前状态、源/目标链事件以及错误或回退详情，是确认跨链调用成功最便捷的方式。
+
+## 从 Universal App 发起出站调用
+
+Universal App 可主动向连接 EVM 链的合约发起调用。应用会使用目标链 Gas 对应的 ZRC-20 代币支付费用，然后调用 Gateway。
+
+首先根据目标 Gas 上限报价费用：
+
+```bash
+GAS_LIMIT=500000
+ZRC20_BASE=0x236b0DE675cC8F46AE186897fCCeFe3370C9eDeD
+
+GAS_FEE=$(cast call --json $ZRC20_BASE \
+ "withdrawGasFeeWithGasLimit(uint256)(address,uint256)" \
+ $GAS_LIMIT \
+ --rpc-url $RPC_ZETACHAIN | jq -r '.[1]') && echo $GAS_FEE
+```
+
+批准 Universal App 支付该费用：
+
+```bash
+cast send $ZRC20_BASE \
+ "approve(address,uint256)" \
+ $UNIVERSAL \
+ $GAS_FEE \
+ --rpc-url $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY
+```
+
+发起跨链调用：
+
+```bash
+cast send --json \
+ --rpc-url $RPC_ZETACHAIN \
+ --private-key $PRIVATE_KEY \
+ $UNIVERSAL \
+ "call(bytes,address,bytes,(uint256,bool),(address,bool,address,bytes,uint256))" \
+ $(cast abi-encode "f(bytes)" $CONNECTED) \
+ $ZRC20_BASE \
+ $(cast abi-encode "f(string)" "hello") \
+ "($GAS_LIMIT,false)" \
+ "($UNIVERSAL,false,$UNIVERSAL,0x,0)" | jq -r '.transactionHash'
+```
+
+- `$GAS_LIMIT` 必须与 `withdrawGasFeeWithGasLimit` 中使用的值一致。
+- `isArbitraryCall` 控制调用类型：`false` 表示认证消息，`true` 表示任意函数调用载荷。
+
+回退配置说明：
+
+- `revertAddress`：使用 Universal 合约地址，若出站调用失败，将回退交易发送回该合约。
+- `callOnRevert`：设为 `true`。从 ZetaChain 向外的调用支持回退调用，因为从连接链到 ZetaChain 的交易不需再支付 Gas。
+- `abortAddress`：同样设为 Universal 合约地址，以便处理无法回退的情况。
+- `revertMessage`：示例中留空。
+- `onRevertGasLimit`：设为 0，因回退调用到 ZetaChain 不产生 Gas 费用。
+
+也可使用命令：
+
+```
+npx tsx ./commands universal call \
+ --rpc $RPC_ZETACHAIN \
+ --contract $UNIVERSAL \
+ --private-key $PRIVATE_KEY \
+ --receiver $CONNECTED \
+ --types string \
+ --values hello \
+ --name Universal \
+ --zrc20 $ZRC20_BASE
+```
+
+## 方案二：部署到 Localnet
+
+Localnet 允许你在本机部署并测试两个合约，同时运行本地 ZetaChain 与连接的 EVM 链，迭代速度更快，无需等待测试网确认或申请水龙头。
+
+```bash
+npx zetachain localnet start
+```
+
+该命令会启动带预置账户的 Anvil，并部署本地 ZetaChain 核心合约。部署信息保存在 `~/.zetachain/localnet/`。
+
+从 Localnet 注册表中获取 RPC、预置私钥与相关合约地址：
+
+```bash
+RPC=http://localhost:8545
+ZRC20_ETHEREUM=$(jq -r '."11155112".zrc20Tokens[] | select(.coinType == "gas" and .originChainId == "11155112") | .address' ~/.zetachain/localnet/registry.json) && echo $ZRC20_ETHEREUM
+PRIVATE_KEY=$(jq -r '.private_keys[0]' ~/.zetachain/localnet/anvil.json) && echo $PRIVATE_KEY
+GATEWAY_ETHEREUM=$(jq -r '.["11155112"].contracts[] | select(.contractType == "gateway") | .address' ~/.zetachain/localnet/registry.json) && echo $GATEWAY_ETHEREUM
+```
+
+部署 Universal App：
+
+```bash
+UNIVERSAL=$(forge create Universal \
+ --rpc-url $RPC \
+ --private-key $PRIVATE_KEY \
+ --broadcast \
+ --json | jq -r .deployedTo) && echo $UNIVERSAL
+```
+
+部署 Connected 合约：
+
+```bash
+CONNECTED=$(forge create Connected \
+ --rpc-url $RPC \
+ --private-key $PRIVATE_KEY \
+ --broadcast \
+ --json \
+ --constructor-args $GATEWAY_ETHEREUM | jq -r .deployedTo) && echo $CONNECTED
+```
+
+模拟连接链向 Universal App 发送消息：
+
+```bash
+npx tsx ./commands connected call \
+ --rpc $RPC \
+ --contract $CONNECTED \
+ --private-key $PRIVATE_KEY \
+ --receiver $UNIVERSAL \
+ --types string \
+ --values hello \
+ --name Connected
+```
+
+本地跨链交易完成后，Universal App 的 `onCall` 会执行。
+
+再模拟 ZetaChain → 连接链的调用：
+
+```bash
+npx tsx ./commands universal call \
+ --rpc $RPC \
+ --contract $UNIVERSAL \
+ --private-key $PRIVATE_KEY \
+ --receiver $CONNECTED \
+ --types string \
+ --values hello \
+ --name Universal \
+ --zrc20 $ZRC20_ETHEREUM
+```
+
+该命令将：
+
+1. 报价目标链所需 Gas 费用（以 `$ZRC20_ETHEREUM` 表示）
+2. 批准 Universal App 支付该费用
+3. 通过 Gateway 发送跨链调用
+
+## 总结
+
+你已经构建并测试了一个展示双向合约通信核心机制的全链应用。通过部署 ZetaChain 上的 Universal App 与连接链上的 Connected 合约，你学会了：
+
+- 如何通过 Gateway 接收并处理来自连接链的调用
+- 如何从 ZetaChain 向连接链回发调用
+- 如何利用回退机制在失败时保障跨链逻辑稳定
+- 如何在测试网或完全本地环境中运行相同流程以加速迭代
+
+这一模式是构建真正全链 dApp 的基础：不再局限于单链，而是能够在同一处协调多链逻辑、资产与数据。
+
+接下来你可以：
+
+- 接入更多连接链，扩展应用的覆盖面
+- 拓展合约逻辑，支持兑换、质押、NFT 转移等复杂流程
+- 将 Universal App 整合至更大的协议，统一多链流动性与用户体验
+
+借助 ZetaChain，这些模式在接入任何区块链时都保持一致，使你的应用从第一天起即具备跨链、可拓展的能力。现在就将这个最小示例打造成真正的跨链功能吧！
+
diff --git a/src/pages/developers/tutorials/frontend.mdx b/src/pages/developers/tutorials/frontend.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/frontend.mdx
rename to src/pages/developers/tutorials/frontend.en-US.mdx
diff --git a/src/pages/developers/tutorials/frontend.zh-CN.mdx b/src/pages/developers/tutorials/frontend.zh-CN.mdx
new file mode 100644
index 000000000..d0c3cd7cf
--- /dev/null
+++ b/src/pages/developers/tutorials/frontend.zh-CN.mdx
@@ -0,0 +1,230 @@
+在本教程中，你将为 **Hello World 全链应用** 添加一个基于 React 的前端。该应用会连接 EVM 测试网钱包，通过 ZetaChain Gateway 发送跨链调用，并追踪在 ZetaChain 上的执行结果。
+
+你将学习如何：
+
+- 在 React 中引入并使用 ZetaChain Toolkit (`evmCall`)
+- 配置网络与合约地址
+- 从连接的 EVM 链向 ZetaChain 上的 Hello 合约发送消息
+- 轮询 ZetaChain 获取跨链交易状态（CCTX），并展示源链与目标链的区块浏览器链接
+
+
+
+## 应用功能概览
+
+Hello 前端提供一个简单 UI 展示完整跨链流程：
+
+1. 连接受支持的 EVM 测试网钱包（如 Arbitrum Sepolia）。
+2. 使用 `evmCall` 通过 ZetaChain Gateway 向部署在 ZetaChain 的 Hello 合约发送消息。
+3. 跟踪交易：保存源链交易哈希，轮询 ZetaChain 的跨链执行（CCTX），并展示双链区块浏览器链接。
+
+## 前置条件
+
+在开始之前，请先完成以下教程：
+
+- [全链应用简介](/start/app/)
+- [ZetaChain 入门](/developers/tutorials/intro)
+- [第一个全链应用](/developers/tutorials/hello)
+
+## 环境准备
+
+如果你已经完成“第一个全链应用”教程，并拥有 Hello 项目，只需进入前端目录并安装依赖：
+
+```bash
+cd hello/frontend
+yarn
+```
+
+若尚未创建项目，可执行：
+
+```bash
+npx zetachain@latest new --project hello
+cd hello/frontend
+yarn
+```
+
+## 工作原理
+
+前端通过引入辅助函数、连接钱包、构造调用参数并轮询跨链结果来与 ZetaChain 集成。以下是关键步骤。
+
+### 引入 Toolkit
+
+```ts filename="frontend/src/MessageFlowCard.tsx"
+import { evmCall } from "@zetachain/toolkit/chains/evm";
+import { ethers, ZeroAddress } from "ethers";
+```
+
+ZetaChain Toolkit 提供用于发送跨链交易的 `evmCall` 函数。应用同样使用 `ethers` 进行钱包与交易管理，并使用 `ZeroAddress` 配置回退选项。
+
+### 从钱包获取 Signer
+
+```ts filename="frontend/src/MessageFlowCard.tsx"
+const ethersProvider = new ethers.BrowserProvider(selectedProvider.provider);
+const signer = (await ethersProvider.getSigner()) as ethers.AbstractSigner;
+```
+
+应用通过 [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963) 标准连接钱包。Signer 用于授权并发送跨链调用。
+
+### 指定 Hello 合约地址
+
+```ts filename="frontend/src/constants/contracts.ts"
+export const HELLO_UNIVERSAL_CONTRACT_ADDRESS = "0x61a184EB30D29eD0395d1ADF38CC7d2F966c4A82";
+```
+
+将该地址替换为你在 ZetaChain 测试网上部署的 Hello 合约地址，作为跨链调用的 `receiver`。
+
+### 构建调用参数
+
+```ts filename="frontend/src/MessageFlowCard.tsx"
+const evmCallParams = {
+ receiver: helloUniversalContractAddress,
+ types: ["string"],
+ values: [stringValue],
+ revertOptions: {
+ callOnRevert: false,
+ revertAddress: ZeroAddress,
+ revertMessage: "",
+ abortAddress: ZeroAddress,
+ onRevertGasLimit: 1000000,
+ },
+};
+
+const evmCallOptions = {
+ signer,
+ txOptions: {
+ gasLimit: 1000000,
+ },
+};
+```
+
+上述代码定义了载荷与执行选项：
+
+- `receiver`：ZetaChain 上的 Hello 合约。
+- `types` / `values`：传入 `onCall` 的 ABI 编码参数（此处为单个 `string`）。
+- `revertOptions`：可选的回退逻辑配置。
+- `txOptions`：交易参数（如 Gas 上限）。
+
+### 发送跨链调用
+
+```ts filename="frontend/src/MessageFlowCard.tsx"
+const result = await evmCall(evmCallParams, evmCallOptions);
+await result.wait();
+
+setConnectedChainTxHash(result.hash);
+```
+
+调用通过 Gateway 发出。`result.hash` 为源链交易哈希，应用会保存以便展示区块浏览器链接并跟踪跨链状态。
+
+### 配置网络与浏览器
+
+```ts filename="frontend/src/constants/chains.ts"
+export const SUPPORTED_CHAINS = [
+ {
+ explorerUrl: "https://sepolia.arbiscan.io/tx/",
+ name: "Arbitrum Sepolia",
+ chainId: 421614,
+ icon: "/logos/arbitrum-logo.svg",
+ colorHex: "#28446A",
+ },
+];
+
+export const ZETACHAIN_ATHENS_BLOCKSCOUT_EXPLORER_URL = "https://zetachain-testnet.blockscout.com/tx/";
+```
+
+应用维护受支持网络及其浏览器链接，发送调用后即可展示源链与 ZetaChain 的对应交易。
+
+### 轮询跨链状态
+
+```ts filename="frontend/src/MessageFlowCard.tsx"
+const response = await fetch(`${CCTX_POLLING_URL}/${connectedChainTxHash}`);
+if (response.ok) {
+ const data = (await response.json()) as CrossChainTxResponse;
+ const txHash = data.CrossChainTxs?.[0]?.outbound_params?.[0]?.hash;
+ if (txHash) setZetachainTxHash(txHash);
+}
+```
+
+应用定期向 ZetaChain 公共 API 发起请求，使用源链交易哈希进行查询。一旦 ZetaChain 完成处理，响应会包含目标链交易哈希，并显示在 UI 中。
+
+## UI 端到端流程
+
+前端引导用户完成一个完整的跨链流程：
+
+1. **连接钱包**：应用检测兼容 EIP-6963 的钱包，并通过 `WalletProvider` 连接，以便签名交易。
+2. **选择网络**：用户从预设的 `SUPPORTED_CHAINS` 中选择源链，每条链包含名称、ID 与浏览器链接。
+3. **输入消息**：输入纯文本字符串，应用会限制字节长度以确保编码后可安全发送。
+4. **发送调用**：点击 **Send** 时执行 `evmCall`，将 ZetaChain 上的 Hello 合约作为接收者，并保存源链交易哈希。
+5. **跟踪结果**：UI 立即展示源链交易，同时开始轮询 CCTX，一旦获取到，在界面上展示源链与 ZetaChain 的浏览器链接。
+
+## 安装与运行
+
+在前端目录安装依赖并启动开发服务器：
+
+```bash
+cd hello/frontend
+yarn
+yarn dev
+```
+
+默认情况下，Vite 开发服务器会运行在 `http://localhost:5173`。
+
+## 钱包
+
+前端默认使用基于 [Dynamic](https://www.dynamic.xyz/) 的 `@zetachain/wallet`，支持 EVM、Solana、Sui、比特币。你也可以一键切换到仅支持 EVM 的 EIP-6963 钱包。
+
+- 默认：`USE_DYNAMIC_WALLET = true`
+- EIP-6963：将 `USE_DYNAMIC_WALLET` 设为 `false`
+
+```ts filename="frontend/src/constants/wallets.ts"
+export const USE_DYNAMIC_WALLET = true;
+```
+
+根组件会根据该标志决定是否包裹在 EIP-6963 Provider 中：
+
+```ts filename="frontend/src/main.tsx"
+{
+ USE_DYNAMIC_WALLET ? (
+
+
+ );
+}
+```
+
+无论使用哪种钱包模式，EVM 链都会提供 Signer，因此发送 `evmCall`、跟踪 CCTX 与展示浏览器链接的流程完全相同。
+
+### 配置合约地址（可选）
+
+默认情况下，应用指向预设的 Hello 合约地址：
+
+```ts filename="frontend/src/constants/contracts.ts"
+export const HELLO_UNIVERSAL_CONTRACT_ADDRESS = "0x61a184EB30D29eD0395d1ADF38CC7d2F966c4A82";
+```
+
+如果你在 ZetaChain 测试网部署了自己的 Hello 合约，请将其替换为你的地址；否则可使用默认地址进行测试。
+
+### 常见问题
+
+- **网络不匹配**：切换到受支持且已连接的 EVM 测试网。
+- **接收者无效**：确认 ZetaChain Hello 合约地址正确且已部署。
+- **Toolkit/ethers 打包问题**：保持 `vite.config.ts` 中 `optimizeDeps` 与 `resolve.dedupe/alias` 设置。
+- **CCTX 未找到**：跨链执行可能需要时间，应用默认每 15 秒轮询一次。
+
+## 总结
+
+通过该前端，你已经完成 Hello World 全链应用的端到端体验：
+
+- 在 ZetaChain 上部署并响应跨链调用的合约。
+- 一个 React 前端，连接钱包，借助 Gateway 发送消息，并跟踪 ZetaChain 上的执行。
+
+这一示例展示了 **构建全链应用的核心模式**：接受任意连接链的调用，在 ZetaChain 上处理，并向用户提供跨链可见性。
+
+接下来，你可以扩展应用以：
+
+- 接受更丰富的载荷（数字、地址、结构体等）
+- 在全链合约里执行更复杂的状态变更
+- 构建更高级的 UI 以管理跨链资产与操作
+
+借助 ZetaChain 的工具与 API，你可以轻松将该示例扩展为真实的全链应用。
+
diff --git a/src/pages/developers/tutorials/hello.mdx b/src/pages/developers/tutorials/hello.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/hello.mdx
rename to src/pages/developers/tutorials/hello.en-US.mdx
diff --git a/src/pages/developers/tutorials/hello.zh-CN.mdx b/src/pages/developers/tutorials/hello.zh-CN.mdx
new file mode 100644
index 000000000..62256b37b
--- /dev/null
+++ b/src/pages/developers/tutorials/hello.zh-CN.mdx
@@ -0,0 +1,256 @@
+在本教程中，你将创建一个简单的 ZetaChain 全链应用。该应用在接收到来自连接链的跨链调用时会触发事件。
+
+
+ VIDEO
+
+
+完成本教程后，你将学会：
+
+- 构建一个基础的全链应用
+- 将其部署到 ZetaChain Localnet
+- 使用连接链上的 Gateway 调用你的全链应用
+
+
+
+## 前置准备
+
+开始之前，请先完成以下教程：
+
+- [全链应用简介](/start/app/)
+- [ZetaChain 入门](/developers/tutorials/intro)
+
+## 环境初始化
+
+首先使用 ZetaChain CLI 初始化项目，这会生成基础的项目结构：
+
+```bash
+npx zetachain@latest new --project hello
+cd hello
+yarn
+forge soldeer update
+```
+
+- `npx zetachain@latest new --project hello` 使用最新的 `zetachain` 包创建名为 `hello` 的项目目录。
+- `cd hello` 进入该目录。
+- `yarn`（或 `npm install`）安装 `package.json` 中声明的依赖。
+- `forge soldeer update` 同步并更新 Foundry Soldeer 管理的 Solidity 依赖，确保与你的合约兼容的最新版本。
+
+## 全链合约
+
+全链应用需要实现 `UniversalContract` 接口：
+
+```solidity filename="contracts/Universal.sol"
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.26;
+
+import "@zetachain/protocol-contracts/contracts/zevm/interfaces/UniversalContract.sol";
+
+contract Universal is UniversalContract {
+ event HelloEvent(string, string);
+
+ function onCall(
+ MessageContext calldata context,
+ address zrc20,
+ uint256 amount,
+ bytes calldata message
+ ) external override onlyGateway {
+ string memory name = abi.decode(message, (string));
+ emit HelloEvent("Hello: ", name);
+ }
+}
+```
+
+`onCall` 会在合约通过 Gateway 接收到来自连接链的调用时触发。参数包括：
+
+- `context`：`MessageContext` 结构体，其中
+ - `chainID`：发起跨链调用的连接链 ID
+ - `sender`：在连接链上调用 Gateway 的地址（EOA 或合约）
+ - `origin`：已弃用
+- `zrc20`：源链资产在 ZetaChain 上对应的 ZRC-20 地址
+- `amount`：转入的代币数量
+- `message`：编码后的载荷数据
+
+本示例中，`onCall` 会将消息解码为字符串并触发事件。
+
+为保证只有连接链调用才能触发 `onCall`，函数使用了继承自 `UniversalContract` 的 `onlyGateway` 修饰器，从而可信任参数。
+
+## 方案一：部署到 Localnet
+
+本节展示如何在 ZetaChain [Localnet](/reference/localnet) 部署并交互全链合约。Localnet 提供隔离、安全的测试环境，无需支付真实费用，也不会影响线上部署。
+
+> 建议使用分屏终端或两个独立终端窗口：一个专门运行 Localnet，另一个用于执行项目命令，便于持续开发。
+
+首先启动本地 ZetaChain 网络，模拟完整环境：
+
+1. 新开一个终端窗口用于运行 Localnet。
+2. 执行：
+
+```
+npx zetachain localnet start
+```
+
+等待所有组件启动后，终端会打印格式化表格，列出 ZETACHAIN、ETHEREUM、BNB 等链的关键合约地址。后续与本地网络交互需要这些地址。
+
+> **不要关闭该终端！** Localnet 必须持续运行，关闭后需重新启动。
+
+接下来编译智能合约，将 Solidity 代码转换为 EVM 可执行的字节码：
+
+1. 打开第二个终端（或在当前终端拆分窗口）。
+2. 切换至项目目录。
+3. 运行：
+
+```
+forge build
+```
+
+该命令会编译项目内所有合约，生成最新版字节码。
+
+从连接链获取已预置资金的私钥：
+
+```
+PRIVATE_KEY=$(jq -r '.private_keys[0]' ~/.zetachain/localnet/anvil.json) && echo $PRIVATE_KEY
+```
+
+部署全链合约：
+
+```
+UNIVERSAL=$(forge create Universal \
+ --rpc-url http://localhost:8545 \
+ --private-key $PRIVATE_KEY \
+ --evm-version paris \
+ --broadcast \
+ --json | jq -r .deployedTo) && echo $UNIVERSAL
+```
+
+### 调用全链应用
+
+要从连接链调用部署在 ZetaChain 的全链应用，需要向该链的 Gateway 发送交易。
+
+获取连接链的 Gateway 地址：
+
+```
+GATEWAY_EVM=$(jq -r '.["11155112"].contracts[] | select(.contractType == "gateway") | .address' ~/.zetachain/localnet/registry.json) && echo $GATEWAY_EVM
+```
+
+你也可以直接在 Localnet 启动时终端输出的表格中查找。
+
+调用 Gateway 的 `call` 方法，将消息发送至部署在 ZetaChain 的全链合约：
+
+```
+npx zetachain evm call \
+ --rpc http://localhost:8545 \
+ --gateway $GATEWAY_EVM \
+ --receiver $UNIVERSAL \
+ --private-key $PRIVATE_KEY \
+ --types string \
+ --values hello
+```
+
+交易处理完成后，你将在 Localnet 终端看到 `[ZetaChain]: Event from onCall` 日志。
+
+## 方案二：部署到测试网
+
+### 钱包与环境配置
+
+与 ZetaChain 交互并部署合约需要一个 EVM 兼容私钥，并在项目中安全管理。
+
+私钥用于签名交易，可通过以下方式获取：
+
+- **MetaMask**：浏览器扩展，可创建新钱包并生成私钥，务必妥善备份助记词。
+- **cast CLI**：命令行快速生成：
+
+```
+PRIVATE_KEY=$(cast wallet new --json | jq -r '.[0].private_key') && echo $PRIVATE_KEY
+```
+
+该命令使用 Foundry 的 `cast` 工具生成新钱包，`--json` 输出 JSON，再用 `jq` 提取 `private_key` 字段。
+
+### 部署合约到 ZetaChain
+
+将合约部署到 ZetaChain 测试网：
+
+```
+UNIVERSAL=$(forge create Universal \
+ --rpc-url https://zetachain-athens-evm.blockpi.network/v1/rpc/public \
+ --private-key $PRIVATE_KEY \
+ --broadcast \
+ --json | jq -r .deployedTo)
+```
+
+### 从 Base 调用全链合约
+
+本节演示如何从连接测试网（Base Sepolia）发起跨链交易，与部署在 ZetaChain 的全链应用交互。主要步骤包括：发送初始交易，以及跟踪跨链执行状态。
+
+调用 ZetaChain 上的全链应用，需要向 Base Sepolia 的 Gateway 发送交易，可使用 `npx zetachain evm call`：
+
+```
+npx zetachain evm call \
+ --chain-id 84532 \
+ --receiver $UNIVERSAL \
+ --private-key $PRIVATE_KEY \
+ --types string \
+ --values hello
+```
+
+参数说明：
+
+- `--chain-id 84532`：Base Sepolia 的链 ID，表示交易来源。
+- `--receiver $UNIVERSAL`：ZetaChain 上全链合约的地址。
+- `--private-key $PRIVATE_KEY`：Base Sepolia 上发送方的钱包私钥。
+- `--types string`：传入数据类型为字符串。
+- `--values hello`：实际传递的字符串消息。
+
+执行成功后将返回交易哈希，表示交易已在 Base Sepolia 发起：
+
+```
+Transaction hash: 0x89308870b0863c5ae48dc783059277cbcf4296b1b343413ac543418262a4ccbc
+```
+
+可在区块浏览器中查看：
+
+https://sepolia.basescan.org/tx/0x89308870b0863c5ae48dc783059277cbcf4296b1b343413ac543418262a4ccbc
+
+### 跟踪跨链交易状态
+
+交易发起后，ZetaChain 协议会将其跨链输送并在目标链（ZetaChain）执行。可使用 `npx zetachain query cctx` 实时跟踪其状态：
+
+```
+npx zetachain query cctx --hash 0x89308870b0863c5ae48dc783059277cbcf4296b1b343413ac543418262a4ccbc
+```
+
+- `--hash` 参数使用之前获得的 Base Sepolia 交易哈希。
+
+示例输出：
+
+```
+84532 → 7001 ✅ OutboundMined
+CCTX: 0x56f9bc09dc646b13aa713b56348e8a53ea39759146afad61e66973791b752e3bTx
+Tx Hash: 0x89308870b0863c5ae48dc783059277cbcf4296b1b343413ac543418262a4ccbc (on chain 84532)
+Tx Hash: 0x34edd96c8a7b2bd9d530de0e49bb5e8625204a77b77cc79133814e1814f79ebc (on chain 7001)
+Sender: 0x4955a3F38ff86ae92A914445099caa8eA2B9bA32
+Receiver: 0xFeb4F33d424D6685104624d985095dacab567151
+Message: 0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000568656c6c6f000000000000000000000000000000000000000000000000000000
+```
+
+关键信息：
+
+- `84532 → 7001`：跨链方向从 Base Sepolia（84532）到 ZetaChain（7001），✅ 表示出站交易已成功挖出。
+- `CCTX: ...`：跨链交易的内部哈希。
+- `Tx Hash` 行分别显示源链与目标链的交易哈希。
+- `Sender` 与 `Receiver`：源链发送地址与 ZetaChain 上接收的全链合约地址。
+- `Message`：传递给全链合约的 ABI 编码载荷（“hello”）。
+
diff --git a/src/pages/developers/tutorials/intro.mdx b/src/pages/developers/tutorials/intro.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/intro.mdx
rename to src/pages/developers/tutorials/intro.en-US.mdx
diff --git a/src/pages/developers/tutorials/intro.zh-CN.mdx b/src/pages/developers/tutorials/intro.zh-CN.mdx
new file mode 100644
index 000000000..75d713382
--- /dev/null
+++ b/src/pages/developers/tutorials/intro.zh-CN.mdx
@@ -0,0 +1,108 @@
+在 ZetaChain 上，你可以构建全链应用：这些智能合约能够跨多条区块链读取、写入并管理资产。全链应用极大降低了跨链开发复杂度，让你可以一次构建、处处运行，打造无缝的用户体验。
+
+本页面将帮助你完成环境配置、安装核心工具，并根据你的目标指引合适的教程。
+
+
+ VIDEO
+
+
+## 准备工作
+
+开始之前，请确保系统已安装以下工具：
+
+- **[Node.js](https://nodejs.org/en)（建议 v21 及以上）**：用于运行 ZetaChain CLI 并管理 JavaScript 依赖。
+- **[Yarn](https://yarnpkg.com/) 或 npm**：项目依赖安装与更新的包管理器，两者任选其一。
+- **[Git](https://git-scm.com/)**：项目源码管理与协作的必备工具。
+- **[jq](https://jqlang.org/)**：轻量级命令行 JSON 处理器，便于解析 Localnet 输出与编写脚本。
+- **[Foundry](https://getfoundry.sh/)**：快速、模块化的以太坊开发工具包，用于编译合约、管理依赖并运行 Localnet。
+
+## 设置环境
+
+安装 ZetaChain CLI：
+
+```bash
+npm install -g zetachain
+```
+
+[ZetaChain CLI](/reference/cli/) 是与你的主要交互工具。你将用它来发起跨链调用、转移代币、追踪跨链交易、在多网络间管理账户、查询余额等。
+
+尝试运行：
+
+```bash
+zetachain query chains list
+```
+
+该命令会输出当前已接入 ZetaChain 的所有区块链，是验证环境是否配置成功的便捷方式。
+
+对于本地开发，推荐启动 Localnet——一个自包含环境，集成了 ZetaChain、EVM、Solana、Sui 与 TON。无需依赖公共测试网，就能以最快速度构建、测试全链应用。
+
+要运行 Localnet，请确保已安装 [Foundry](https://getfoundry.sh/)。它提供核心的 EVM 工具链，也是启动本地网络的前提。
+
+如需在 Localnet 中加入非 EVM 链，请参考 [Localnet 文档](/reference/localnet/) 中的额外先决条件。
+
+## 工具与参考资料
+
+环境就绪后，以下资源将帮助你与 ZetaChain 交互并开展开发工作。
+
+### 区块浏览器
+
+ZetaChain 同时兼具 Cosmos 链与 EVM 链的特性。你可以使用 Cosmos 浏览器查看区块、验证者与治理活动，也可以使用 EVM 浏览器追踪合约与交易。两类链接均整理在 [浏览器参考](/reference/explorers/) 中。
+
+### 水龙头
+
+在测试网部署或测试前，你需要获取代币。[水龙头页面](/reference/faucet/) 列出了所有可用水龙头，既提供 ZETA Gas，也提供连接链上的测试代币。
+
+### 网络
+
+ZetaChain 同时运行主网与测试网。本教程主要针对测试网，但你可随时切换。RPC、链 ID 等信息见 [网络参考](/developers/chains/list/)。
+
+### RPC
+
+若需连接应用、钱包或 Foundry、Hardhat 等框架，需要使用 RPC 节点。ZetaChain 主网与测试网的公共 RPC 均列于 [RPC 参考](/reference/network/api)。
+
+### 合约
+
+Gateway 等核心协议合约已部署在 ZetaChain 上，其地址汇总在 [协议合约参考](/reference/network/contracts/)。
+
+### 代币
+
+所有已列入白名单的 ZRC-20 代币及其合约地址，均可在 [代币参考](/developers/evm/zrc20/) 中查看。
+
+### MCP
+
+通过 ZetaChain 的 Model Context Protocol (MCP) 服务器，将 Cursor 或 Claude Code 与链上查询、操作相连接。详见 [MCP 参考](/reference/mcp/)。
+
+## 下一步去哪儿
+
+环境配置完成后，可直接开始构建。根据目标选择合适的路线：
+
+### 学习基础
+
+- [第一个全链合约](/developers/tutorials/hello/)（10 分钟）构建你的首个全链合约，理解 ZetaChain 开发的基础。
+- [构建 Web 应用](/developers/tutorials/frontend)（10 分钟）连接钱包、发送跨链调用，并用简单前端追踪执行状态。
+
+### 往返全链应用的调用
+
+- [EVM](/developers/tutorials/call/)（30 分钟）学习如何在 EVM 链与 ZetaChain 全链应用之间发送与接收调用。
+- [Solana](/developers/tutorials/solana/)（60 分钟）从 Solana 存入资产并调用全链应用，或向 Solana 发起出站调用。
+- [Sui](/developers/tutorials/sui/)（60 分钟）从 Sui 存入资产并调用全链应用。
+- [Sui 提现与调用](/developers/tutorials/sui-withdraw-and-call/)（60 分钟）向 Sui 提现资产并调用合约。
+
+### 跨链消息传递
+
+- [跨链消息](/developers/tutorials/messaging/)（30 分钟）直接在 EVM 网络间发起跨链调用，无需构建全链应用。
+
+### 构建真实场景应用
+
+- [全链 NFT](/developers/standards/nft/)（45 分钟）创建可在多链间无缝流转的 NFT。
+- [全链代币](/developers/standards/token/)（45 分钟）部署可跨链存在并互转的同质化代币。
+- [跨链兑换](/developers/tutorials/swap/)（30 分钟）构建兼容以太坊、Solana、比特币等链的全链兑换应用。
+
diff --git a/src/pages/developers/tutorials/messaging.mdx b/src/pages/developers/tutorials/messaging.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/messaging.mdx
rename to src/pages/developers/tutorials/messaging.en-US.mdx
diff --git a/src/pages/developers/tutorials/messaging.zh-CN.mdx b/src/pages/developers/tutorials/messaging.zh-CN.mdx
new file mode 100644
index 000000000..86a002a29
--- /dev/null
+++ b/src/pages/developers/tutorials/messaging.zh-CN.mdx
@@ -0,0 +1,336 @@
+本教程演示如何使用 ZetaChain 的消息基础设施，在两条 EVM 链上的合约间发送跨链消息。
+
+与部署在 ZetaChain 上的全链应用不同，此模式允许你将所有合约逻辑留在已有的连接 EVM 链上。ZetaChain 仅负责在它们之间路由消息，无需在 ZetaChain 部署任何合约。
+
+> 为什么使用该模式？相比直接在 ZetaChain 部署全链应用，此方式可让全部业务逻辑保留在你熟悉的连接 EVM 链上。ZetaChain 只负责传输载荷，并不部署合约代码。
+
+完成本教程后，你将：
+
+- 在两个 EVM 测试网（Base 与 Ethereum Sepolia）部署消息传递合约
+- 建立它们之间的跨链通信
+- 从一条链向另一条链发送消息与代币数量
+- 跟踪跨链交易从源链到目标链的状态
+
+
+ VIDEO
+
+
+## 创建项目
+
+使用 `messaging` 模板创建新项目：
+
+```
+npx zetachain new --project messaging
+```
+
+安装 TypeScript 与 Foundry 依赖：
+
+```
+cd messaging
+yarn
+forge soldeer update
+```
+
+编译合约：
+
+```
+forge build
+```
+
+为了让脚本读取，建议将私钥保存为环境变量：
+
+```
+PRIVATE_KEY=...
+```
+
+## Messaging 合约
+
+要启用跨链消息传递，合约需继承 ZetaChain 的 `Messaging` 基类并实现必要函数。
+
+从 ZetaChain 标准合约包引入 `Messaging.sol`：
+
+```solidity
+import "@zetachain/standard-contracts/contracts/messaging/contracts/Messaging.sol";
+```
+
+在合约中继承 `Messaging`：
+
+```solidity
+contract Example is Messaging { ... }
+```
+
+在构造函数中按要求初始化参数：
+
+```solidity
+constructor(
+ address payable _gateway,
+ address owner,
+ address _router
+) Messaging(_gateway, owner, _router) {}
+```
+
+`Messaging` 基类会提供对 Gateway 与 Router 的访问，并确保合约正确接入 ZetaChain 的跨链消息系统。
+
+你需要实现三个核心内部函数，用于处理消息投递与回退：
+
+#### onMessageReceive
+
+当跨链消息成功到达目标链时会自动触发：
+
+```solidity
+function onMessageReceive(
+ bytes memory data,
+ bytes memory sender,
+ uint256 amount,
+ bytes memory asset
+) internal override {
+ //...
+}
+```
+
+在此解码消息，执行状态更新、触发下游调用或处理接收到的代币。
+
+#### onMessageRevert
+
+当目标合约的 `onMessageReceive` 执行失败（如 calldata 无效或逻辑回退）时触发：
+
+```solidity
+function onMessageRevert(
+ bytes memory data,
+ bytes memory sender,
+ uint256 amount,
+ bytes memory asset
+) internal override {
+ //...
+}
+```
+
+#### onRevert
+
+当消息在路由过程中未抵达目标链时触发，执行于源链：
+
+```solidity
+function onRevert(RevertContext calldata context)
+ external
+ payable
+ override
+ onlyGateway
+{
+ if (context.sender != router) revert Unauthorized();
+ //...
+}
+```
+
+可在此执行退款、补偿逻辑或发出通知。
+
+### 发送消息
+
+要发起跨链消息，合约需调用 EVM Gateway 的 `depositAndCall`，该函数会将消息与可选代币交给 ZetaChain 的消息层进行路由。
+
+根据是否发送原生 Gas（如 ETH）或 ERC-20，有两种形式：
+
+发送带 ETH 的消息：
+
+```solidity
+gateway.depositAndCall{value: msg.value}(
+ router,
+ message,
+ revertOptions
+);
+```
+
+发送受支持的 ERC-20：
+
+```solidity
+gateway.depositAndCall(
+ router,
+ amount,
+ asset,
+ message,
+ revertOptions
+);
+```
+
+其中 `asset` 为要发送的 ERC-20 地址，必须已被 ZetaChain 支持。
+
+### 消息载荷结构
+
+`message` 参数是单个 `bytes`，需按 Universal Router 可识别的结构进行 ABI 编码：
+
+```solidity
+abi.encode(
+ receiver, // bytes：目标链合约地址
+ targetToken, // address：目标链需接收的代币对应的 ZRC-20
+ data, // bytes：消息载荷（如 ABI 编码的 "hello"）
+ gasLimit, // uint256：目标链执行所需 Gas
+ revertOptions // struct：失败时的回退策略
+)
+```
+
+例如将字符串 `"hello"` 发送到 Ethereum Sepolia 的合约：
+
+```solidity
+bytes memory data = abi.encode("hello");
+bytes memory message = abi.encode(
+ abi.encodePacked(receiver),
+ targetToken,
+ data,
+ 300_000,
+ revertOptions
+);
+```
+
+随后将 `message` 传入 `depositAndCall()`，经过 ZetaChain 路由至目标链，并在目标合约的 `onMessageReceive()` 中解码使用。
+
+### Universal Router 介绍
+
+当你调用 `gateway.depositAndCall(...)` 发送跨链消息时，具体的路由与执行逻辑由 **Universal Router** 合约在 ZetaChain 上完成。它是所有跨链消息的入口，负责：
+
+- 解析源链传来的消息载荷
+- 将部分代币换成目标链 Gas 代币用于支付执行费用，将剩余部分换成目标链指定代币交给目标合约
+- 将消息与代币转发至目标合约
+- 在目标调用失败时进行回退处理
+
+所有继承 Messaging 基类的合约共享同一个 Universal Router，这让开发体验更一致，无需重复实现。你只需专注于编码载荷并调用 Gateway，其余细节由 ZetaChain 代劳。
+
+> 🔧 进阶：若需要更多自定义（如调整代币交换方式、改用自定义 Router 或变更消息处理逻辑），可部署自定义 Router，并在 Messaging 构造函数中传入对应地址。
+
+## 部署消息合约
+
+部署到 Base Sepolia：
+
+```
+MESSAGING_BASE=$(./commands/index.ts deploy --rpc https://sepolia.base.org --private-key $PRIVATE_KEY | jq -r .contractAddress)
+```
+
+部署到 Ethereum Sepolia：
+
+```
+MESSAGING_ETHEREUM=$(./commands/index.ts deploy --rpc https://sepolia.drpc.org --private-key $PRIVATE_KEY | jq -r .contractAddress)
+```
+
+## 互联合约
+
+在跨链通信前，两份合约需显式彼此信任，以防恶意合约伪造跨链消息。此步骤将为两个合约建立双向链接。
+
+每个合约需知晓：
+
+- 远程合约地址
+- 远程链 ID
+
+通过合约的 `setConnected()` 函数完成配置。ZetaChain 仅向已登记的可信合约传递消息。
+
+⚠️ 若跳过此步骤或填写错误地址/链 ID，目标链会拒绝消息。
+
+```
+./commands/index.ts connect \
+ --contract $MESSAGING_BASE \
+ --target-contract $MESSAGING_ETHEREUM \
+ --rpc https://sepolia.base.org \
+ --target-chain-id 11155111 \
+ --private-key $PRIVATE_KEY
+```
+
+```
+./commands/index.ts connect \
+ --contract $MESSAGING_ETHEREUM \
+ --target-contract $MESSAGING_BASE \
+ --rpc https://sepolia.drpc.org \
+ --target-chain-id 84532 \
+ --private-key $PRIVATE_KEY
+```
+
+完成双向连接后，双方即可互发消息。
+
+## 发送跨链消息
+
+一切部署就绪后，可从一条链向另一条链发送消息。
+
+以下示例将字符串 `"hello"` 从 Base Sepolia 的合约发送至 Ethereum Sepolia 的合约：
+
+```
+./commands/index.ts message \
+ --rpc https://sepolia.base.org \
+ --private-key $PRIVATE_KEY \
+ --contract $MESSAGING_BASE \
+ --target-contract $MESSAGING_ETHEREUM \
+ --types string \
+ --values hello \
+ --target-token 0x05BA149A7bd6dC1F937fA9046A9e05C05f3b18b0 \
+ --amount 0.005
+```
+
+| 参数 | 说明 |
+| --- | --- |
+| `--rpc https://sepolia.base.org` | 源链（Base Sepolia）的 RPC，交易由此发出 |
+| `--private-key $PRIVATE_KEY` | 源链上用于签名与支付的账户，需持有发送代币 |
+| `--contract $MESSAGING_BASE` | 源链已部署的消息合约地址 |
+| `--target-contract $MESSAGING_ETHEREUM` | 目标链合约地址 |
+| `--types string` | 消息的 ABI 类型，可为单一类型或元组 |
+| `--values hello` | 实际发送的值，即字符串 `"hello"` |
+| `--target-token 0x...` | ZetaChain 上代表目标链代币的 ZRC-20 地址 |
+| `--amount 0.005` | 总发送数量，其中一部分用于支付目标链 Gas，其余转给目标合约 |
+
+### 数量如何处理
+
+使用 `--amount` 发送跨链消息时，你不仅转移代币，还预付目标链的 Gas：
+
+1. 在源链提供代币（如 Base ETH），可以是原生资产或受支持的 ERC-20。
+2. 通过 `--target-token` 指定 ZetaChain 上代表目标链代币的 ZRC-20。
+3. ZetaChain 会自动：
+ - 将部分金额兑换成目标链的 Gas 代币（ZRC-20 形式），用于支付执行成本。
+ - 将剩余金额兑换成目标合约所需的目标代币，并转入目标合约。
+
+这样你无需持有目标链原生代币，即可完成跨链调用。
+
+```json
+{
+ "contractAddress": "0xee2E8dfefd723e879CAa30A1DaD94046Fa3D24D4",
+ "targetContract": "0x7c9BbA0630c9452F726bc15D0a73cdF769438efE",
+ "targetToken": "0x05BA149A7bd6dC1F937fA9046A9e05C05f3b18b0",
+ "message": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000568656c6c6f000000000000000000000000000000000000000000000000000000",
+ "transactionHash": "0x939e230dd504efdf1fce31202a5980b4d0376430ddf535d080666256353c02c3",
+ "amount": "0.005"
+}
+```
+
+## 跟踪跨链交易
+
+使用上述交易哈希查询跨链状态：
+
+```
+npx zetachain query cctx --hash 0x939e230dd504efdf1fce31202a5980b4d0376430ddf535d080666256353c02c3
+```
+
+```
+84532 → 7001 ✅ OutboundMined
+CCTX: 0xd88d92d0b9b0a2fde416bf6383e430b51de48114b0b03e7cc34e7f8d8df15cb7
+Tx Hash: 0x939e230dd504efdf1fce31202a5980b4d0376430ddf535d080666256353c02c3 (on chain 84532)
+Tx Hash: 0x8c368f6a3cfc55950b5d2b0d98c63d1904a79300490ec7d1c258505f372054e3 (on chain 7001)
+Sender: 0xee2E8dfefd723e879CAa30A1DaD94046Fa3D24D4
+Receiver: 0x5BD35697D4a62DE429247cbBDCc5c47F70477775
+Message: ...
+
+7001 → 11155111 ✅ OutboundMined
+CCTX: 0x8952c9f95dfb5673a9fbfa2196842b750f5530f4931a55088b1276599328fd64
+Tx Hash: 0xd88d92d0b9b0a2fde416bf6383e430b51de48114b0b03e7cc34e7f8d8df15cb7 (on chain 7001)
+Tx Hash: 0xf30e4414087e8b5c81e257e8a97ac9105dde37cbbd6bb33a1691c4a30585507e (on chain 11155111)
+Sender: 0x5BD35697D4a62DE429247cbBDCc5c47F70477775
+Receiver: 0x7c9BbA0630c9452F726bc15D0a73cdF769438efE
+Message: ...
+```
+
+这表明消息已经从 Base Sepolia 经过 ZetaChain 成功抵达 Ethereum Sepolia。
+
+可在 Etherscan 验证目标链交易：
+
+https://sepolia.etherscan.io/tx/0xf30e4414087e8b5c81e257e8a97ac9105dde37cbbd6bb33a1691c4a30585507e
+
diff --git a/src/pages/developers/tutorials/solana.mdx b/src/pages/developers/tutorials/solana.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/solana.mdx
rename to src/pages/developers/tutorials/solana.en-US.mdx
diff --git a/src/pages/developers/tutorials/solana.zh-CN.mdx b/src/pages/developers/tutorials/solana.zh-CN.mdx
new file mode 100644
index 000000000..06fa3868d
--- /dev/null
+++ b/src/pages/developers/tutorials/solana.zh-CN.mdx
@@ -0,0 +1,163 @@
+使用 ZetaChain 与 Solana 构建全链应用非常简单。你可以直接从 Solana 存入 SOL 与 SPL-20 代币到 ZetaChain 的账户或智能合约，ZetaChain 上的全链合约可以处理这些存入，并执行由 Solana 发起的合约调用。
+
+本教程将引导你：
+
+- 使用 localnet 搭建本地开发环境
+- 在 ZetaChain 部署全链合约
+- 从 Solana 向 ZetaChain 存入代币（SOL 与 SPL-20）
+- 执行 deposit-and-call 交易，在存入代币的同时调用全链应用
+- 将代币提现回 Solana，并在提现过程中可选调用 Solana 程序
+
+与 Solana 的交互由 Solana Gateway 程序处理，详见[文档说明](/developers/chains/solana)。
+
+## 前置条件
+
+开始前请确保已安装并配置：
+
+- [`solana` CLI](https://solana.com/docs/intro/installation)
+
+## 克隆示例项目
+
+创建项目并安装依赖：
+
+```bash
+npx zetachain@latest new --project call
+cd call
+yarn
+```
+
+## 启动 Localnet
+
+运行以下命令启动包含 ZetaChain 与 Solana 的本地开发环境：
+
+```bash
+yarn zetachain localnet start
+```
+
+请保持该终端运行。
+
+## 编译并部署示例全链合约
+
+在新终端窗口中编译并部署全链合约：
+
+```bash
+npx hardhat compile --force
+npx hardhat deploy --name Universal --network localhost --gateway 0x5FC8d32690cc91D4c39d9d3abcBD16989F875707
+```
+
+执行后会输出合约部署成功的提示：
+
+```
+🚀 Successfully deployed "Universal" contract on localhost.
+📜 Contract address: 0x8198f5d8F8CfFE8f9C413d98a0A55aEB8ab9FbB7
+```
+
+请记录合约地址（此示例为 `0x8198f5d8F8CfFE8f9C413d98a0A55aEB8ab9FbB7`），后续会用到。
+
+## 存入 SOL
+
+从 Solana 向 ZetaChain 存入 SOL：
+
+```
+npx hardhat localnet:solana-deposit \
+ --receiver 0x8198f5d8F8CfFE8f9C413d98a0A55aEB8ab9FbB7 \
+ --amount 0.1
+```
+
+- `--receiver`：ZetaChain 上的全链合约地址
+- `--amount`：欲存入的 SOL 数量
+
+## 存入并调用
+
+在存入代币的同时调用已部署的全链合约：
+
+```bash
+npx hardhat localnet:solana-deposit-and-call \
+ --receiver 0x8198f5d8F8CfFE8f9C413d98a0A55aEB8ab9FbB7 \
+ --amount 0.1 \
+ --types '["string"]' hello
+```
+
+该命令会在存入代币的同时向合约传入字符串参数 `"hello"`。
+
+## 提现至 Solana
+
+将代币从 ZetaChain 提现回 Solana：
+
+```bash
+npx hardhat zetachain-withdraw \
+ --gateway-zeta-chain 0x5FC8d32690cc91D4c39d9d3abcBD16989F875707 \
+ --receiver DrexsvCMH9WWjgnjVbx1iFf3YZcKadupFmxnZLfSyotd \
+ --network localhost \
+ --zrc20 0xd97B1de3619ed2c6BEb3860147E30cA8A7dC9891 \
+ --amount 0.1
+```
+
+- `--gateway-zeta-chain`：ZetaChain Gateway 地址
+- `--receiver`：接收提现代币的 Solana 钱包地址
+- `--zrc20`：目标提现代币在 ZetaChain 上的 ZRC-20 地址
+- `--amount`：提现数量
+
+## 提现并调用 Solana 程序
+
+除了单纯提现外，还可以在提现过程中调用 Solana 程序，实现更复杂的操作，例如在收款时自动执行合约逻辑、质押或兑换。
+
+项目 `solana` 目录中提供了示例程序，包含可由 ZetaChain 全链应用在提现时调用的 `on_call` 函数。
+
+以下步骤展示如何构建示例程序，并通过 ZetaChain Gateway 执行 “withdraw and call”。
+
+### 构建并配置示例 Solana 程序
+
+设置 SPL-20 USDC 地址，可在 `localnet` 输出表格中找到：
+
+```bash
+USDC_SPL=3Kx5SY7SwzdUZSorLVSpPgxBL8DZFiu8mg4FWduu2tQp
+```
+
+```bash
+cd solana && anchor build && npx ts-node setup/main.ts "$USDC_SPL" && cd -
+```
+
+完成后会输出类似信息，表示程序部署成功：
+
+```
+Connected program deployment output: Program Id: 9BjVGjn28E58LgSi547JYEpqpgRoo1TErkbyXiRSNDQy
+```
+
+### 提现 SOL 并调用 Solana 程序
+
+通过 ZetaChain Gateway 提现 SOL 并调用 Solana 程序：
+
+```bash
+npx hardhat zetachain-withdraw-and-call \
+ --receiver 9BjVGjn28E58LgSi547JYEpqpgRoo1TErkbyXiRSNDQy \
+ --gateway-zeta-chain 0x5FC8d32690cc91D4c39d9d3abcBD16989F875707 \
+ --zrc20 0xd97B1de3619ed2c6BEb3860147E30cA8A7dC9891 \
+ --amount 0.01 \
+ --network localhost \
+ --types '["bytes"]' $(npx ts-node solana/setup/encodeCallArgs.ts "sol" "$USDC_SPL")
+```
+
+- `--receiver`：需要调用的 Solana 程序 ID
+- `--types '["bytes"]'`：表示合约调用参数为字节数组（即编码后的 Solana 调用数据）
+- 引号中的命令会生成编码后的账户与数据
+- `--zrc20`：ZetaChain 上 SOL 的 ZRC-20 地址
+
+### 提现 SPL-20 并调用 Solana 程序
+
+将 ZRC-20 形式的 SPL-20 USDC 提现同时调用 Solana 程序：
+
+```bash
+npx hardhat zetachain-withdraw-and-call \
+ --receiver 9BjVGjn28E58LgSi547JYEpqpgRoo1TErkbyXiRSNDQy \
+ --gateway-zeta-chain 0x5FC8d32690cc91D4c39d9d3abcBD16989F875707 \
+ --zrc20 0x48f80608B672DC30DC7e3dbBd0343c5F02C738Eb \
+ --amount 0.01 \
+ --network localhost \
+ --types '["bytes"]' $(npx ts-node solana/setup/encodeCallArgs.ts "spl" "$USDC_SPL")
+```
+
+- `--zrc20`：ZetaChain 上 SPL-20 USDC 的 ZRC-20 地址
+
+通过本教程，你已学会在 ZetaChain 部署全链合约、从 Solana 存入 SOL 与 SPL-20、在存入时调用合约、将资产提现回 Solana，并在提现时触发 Solana 程序，为跨链交互提供更多扩展玩法。
+
diff --git a/src/pages/developers/tutorials/staking.mdx b/src/pages/developers/tutorials/staking.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/staking.mdx
rename to src/pages/developers/tutorials/staking.en-US.mdx
diff --git a/src/pages/developers/tutorials/staking.zh-CN.mdx b/src/pages/developers/tutorials/staking.zh-CN.mdx
new file mode 100644
index 000000000..0f2512e1a
--- /dev/null
+++ b/src/pages/developers/tutorials/staking.zh-CN.mdx
@@ -0,0 +1,146 @@
+ZetaChain 是基于 Cosmos SDK 构建的权益证明（PoS）区块链，由质押原生代币 ZETA 的验证者守护。委托者（普通用户）可以将自己的 ZETA 质押给验证者以参与网络安全，并获得奖励。由于 ZetaChain 同时提供 EVM 环境，智能合约可通过专用的 Staking 预编译直接访问 Cosmos 质押功能，使合约、脚本与前端能够使用熟悉的 EVM 工具完成委托、解绑、领取奖励等操作。
+
+本教程将使用 Foundry（`cast`）与 curl 与 staking 预编译交互。相同函数也可在 Solidity 合约或 Web 前端中调用。
+
+- 预编译地址：`0x0000000000000000000000000000000000000800`
+- 文档：[Staking Precompile](https://evm.cosmos.network/v0.4.x/documentation/smart-contracts/precompiles/staking)
+- 接口：[StakingI.sol](https://github.com/cosmos/evm/blob/v0.4.0/precompiles/staking/StakingI.sol)
+
+### 前置条件
+
+- [Foundry](https://getfoundry.sh/)（包含 `cast`）
+- 用于 JSON 处理的 `jq`
+- 持有测试网 ZETA 的私钥
+
+### 快速环境配置
+
+```bash
+export RPC_URL="https://zetachain-athens-evm.blockpi.network/v1/rpc/public"
+export PRIVATE_KEY="YOUR_PRIVATE_KEY_HEX"
+
+cast wallet address $PRIVATE_KEY
+cast balance --rpc-url "$RPC_URL" $(cast wallet address $PRIVATE_KEY)
+
+export STAKING_PRECOMPILE=0x0000000000000000000000000000000000000800
+```
+
+## 查询验证者
+
+在委托前需要了解可选的验证者。每个验证者都有一个 operator 地址（`zetavaloper...`），委托时需指定。
+
+Cosmos SDK 提供 REST API（LCD）列出验证者。获取处于 bonded 状态（参与共识）的验证者：
+
+```bash
+curl -s \
+ "https://zetachain-athens.blockpi.network/lcd/v1/public/cosmos/staking/v1beta1/validators?status=BOND_STATUS_BONDED&pagination.limit=1000" \
+| jq -r '.validators[] | [ .operator_address, (.description.moniker) ] | @tsv'
+```
+
+示例输出：
+
+```
+zetavaloper1qumrwnz9x2emzd5yjylp8pf9w2wh3my0gag27y LiveRaveN
+zetavaloper1p3emgemv8q0fmtw70kfzwecmcvyd9ztqlzudwn RockX
+...
+```
+
+这是获取验证者 operator 地址的最简单方式。也可以在合约或前端中直接调用预编译的 `validators` 函数在链上读取。验证者列表也可在 [ZetaChain 浏览器](https://testnet.zetachain.exploreme.pro/validators) 查看。
+
+## 委托
+
+委托操作会将你的 ZETA 质押给验证者，获得奖励。通过 staking 预编译，可直接使用 EVM 工具完成。
+
+- `amount` 单位为 wei（1 ZETA = `1e18` wei）
+- `--value` 需与 `amount` 相同，因为委托消耗原生 ZETA
+
+```bash
+cast send $STAKING_PRECOMPILE \
+ "delegate(address,string,uint256)" \
+ $(cast wallet address $PRIVATE_KEY) \
+ "zetavaloper1ymnrwg9e3xr9xkw42ygzjx34dyvwvtc24ct0t5" \
+ 1000000000000000000 \
+ --rpc-url $RPC_URL \
+ --private-key $PRIVATE_KEY
+```
+
+此交易向验证者质押 1 ZETA。
+
+### 验证委托情况
+
+可通过 `delegation` 函数查询委托数量，返回 `(uint256 shares, (string denom, uint256 amount))`：
+
+```bash
+cast call $STAKING_PRECOMPILE \
+ "delegation(address,string)(uint256,(string,uint256))" \
+ $(cast wallet address $PRIVATE_KEY) \
+ "zetavaloper1ymnrwg9e3xr9xkw42ygzjx34dyvwvtc24ct0t5" \
+ --rpc-url $RPC_URL
+```
+
+示例输出：
+
+```
+(1000000000000000000, (azeta, 1000000000000000000))
+```
+
+- shares：你在该验证者池中的份额
+- balance：委托金额（wei），denom 为 `azeta`
+
+## 解绑委托
+
+解绑会开启解锁期：解绑后的 ZETA 停止产生收益，需等解锁完成后才能取回。可以部分或全部解绑。
+
+- `amount` 仍然以 wei 表示
+- 使用委托时的同一验证者地址
+- `--value` 与 `amount` 保持一致
+
+```bash
+cast send $STAKING_PRECOMPILE \
+ "undelegate(address,string,uint256)" \
+ $(cast wallet address $PRIVATE_KEY) \
+ "zetavaloper1ymnrwg9e3xr9xkw42ygzjx34dyvwvtc24ct0t5" \
+ 1000000000000000000 \
+ --rpc-url $RPC_URL \
+ --private-key $PRIVATE_KEY
+```
+
+该交易将从验证者解绑 1 ZETA。
+
+### 确认变动
+
+解绑后，再次查询委托余额会减少：
+
+```bash
+cast call $STAKING_PRECOMPILE \
+ "delegation(address,string)(uint256,(string,uint256))" \
+ $(cast wallet address $PRIVATE_KEY) \
+ "zetavaloper1ymnrwg9e3xr9xkw42ygzjx34dyvwvtc24ct0t5" \
+ --rpc-url $RPC_URL
+```
+
+示例（解绑 1 ZETA 后）：
+
+```
+(0, (azeta, 0))
+```
+
+若部分解绑，则显示剩余金额。
+
+### 注意事项
+
+- 解锁期内，解绑金额处于锁定状态，待期满后才会返还为可用 ZETA。
+- 可多次提交解绑，每次会生成独立的 unbonding 条目。
+- 尝试解绑超过已委托数量将失败。
+
+## 总结
+
+借助 staking 预编译，你可以在 EVM 环境中直接操作 ZetaChain 的 PoS 系统——无需使用 Cosmos 工具，即可通过 `cast`、Solidity 合约或前端应用完成委托、解绑或查询验证者信息。
+
+你还可以构建全链合约，代表连接链用户自动质押 ZETA，为以下跨链场景铺路：
+
+- 协议自动质押多链奖励或闲置资产
+- 结合跨链流动性与质押收益的策略
+- 用户无需离开主链即可管理委托的应用
+
+质押是保障网络安全并获取奖励的基础能力。接下来可进一步探索预编译提供的高级函数，例如再委托、查询解锁条目、领取奖励等。***
+
diff --git a/src/pages/developers/tutorials/sui-withdraw-and-call.mdx b/src/pages/developers/tutorials/sui-withdraw-and-call.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/sui-withdraw-and-call.mdx
rename to src/pages/developers/tutorials/sui-withdraw-and-call.en-US.mdx
diff --git a/src/pages/developers/tutorials/sui-withdraw-and-call.zh-CN.mdx b/src/pages/developers/tutorials/sui-withdraw-and-call.zh-CN.mdx
new file mode 100644
index 000000000..d24df6069
--- /dev/null
+++ b/src/pages/developers/tutorials/sui-withdraw-and-call.zh-CN.mdx
@@ -0,0 +1,212 @@
+与 ZetaChain 全链应用进行交互时，Sui 区块链同样扮演关键角色。本教程展示如何在一次交易中将代币提现至 Sui，并同时调用 Sui 合约，从而实现无缝跨链操作与强大的 DeFi 流程。
+
+你将学会：
+
+- 搭建包含 ZetaChain 与 Sui 的 localnet 环境
+- 部署并配置可响应 ZetaChain 调用的 Sui 合约
+- 执行 `withdrawAndCall()`，即同时发送代币并触发 Sui 上的合约逻辑
+
+## 前置条件
+
+开始前请确保已安装并配置以下工具：
+
+- [Sui CLI](https://docs.sui.io/references/cli)：用于启动本地 Sui 节点并与之交互
+- [Foundry](https://getfoundry.sh/)：借助 `cast` 编码 ABI 载荷
+- [jq](https://stedolan.github.io/jq/)：解析 Sui CLI 的 JSON 输出
+
+## 合约概览
+
+示例合约演示如何在 ZetaChain 与 Sui 之间处理跨链交互。`connected` 模块负责：
+
+- 通过 `on_call` 接收来自 ZetaChain 的代币
+- 使用模拟的 Cetus DEX 实现代币兑换
+- 将兑换后的代币发送至指定接收地址
+
+该 Sui 合约使用 `0x2::coin` 与自定义的 `token::TOKEN` 类型表示转移的资产。
+
+## 克隆示例项目
+
+首先克隆示例合约仓库并安装依赖：
+
+```bash
+npx zetachain@next new --project call
+cd call
+yarn
+```
+
+## 启动 Localnet
+
+启动包含 ZetaChain 与 Sui 的本地开发环境：
+
+```bash
+npx zetachain localnet start
+```
+
+保持终端打开。启动成功后会输出包含 Gateway 模块与对象 ID 的表格。
+
+## 在 Sui 部署合约
+
+进入 Sui 合约目录并部署：
+
+```bash
+cd sui
+```
+
+```bash
+sui move build --force
+```
+
+从水龙头获取测试 SUI：
+
+```
+sui client faucet
+```
+
+发布合约包：
+
+```
+PUBLISHED=$(sui client publish --skip-dependency-verification --json)
+```
+
+提取发布的包 ID：
+
+```
+PACKAGE=$(echo $PUBLISHED | jq -r '.objectChanges[] | select(.type == "published") | .packageId') && echo $PACKAGE
+```
+
+## 设置池子
+
+部署完成后，需要初始化池子、铸造代币并注入初始流动性。
+
+获取 Treasury Cap：
+
+```bash
+TREASURY=$(echo $PUBLISHED | jq -r --arg pkg "$PACKAGE" '.objectChanges[] | select(.type == "created" and .objectType == "0x2::coin::TreasuryCap<\($pkg)::token::TOKEN>") | .objectId') && echo $TREASURY
+```
+
+获取池子 ID：
+
+```
+POOL=$(echo $PUBLISHED | jq -r --arg pkg "$PACKAGE" '.objectChanges[] | select(.type == "created" and .objectType == "\($pkg)::cetusmock::Pool<0x2::sui::SUI, \($pkg)::token::TOKEN>") | .objectId') && echo $POOL
+```
+
+铸造代币：
+
+```
+RECIPIENT=$(sui client active-address) && echo $RECIPIENT
+```
+
+```
+sui client call \
+ --package "$PACKAGE" \
+ --module token \
+ --function mint_and_transfer \
+ --args "$TREASURY" 1000000 "$RECIPIENT"
+```
+
+获取铸造后的代币对象 ID：
+
+```
+TOKEN=$(sui client objects --json | jq -r --arg pkg "$PACKAGE" '.[].data | select(.type == "0x2::coin::Coin<\($pkg)::token::TOKEN>") | .objectId') && echo $TOKEN
+```
+
+将代币存入池子：
+
+```
+sui client call \
+ --package "$PACKAGE" \
+ --module cetusmock \
+ --function deposit \
+ --type-args "0x2::sui::SUI" "$PACKAGE::token::TOKEN" \
+ --args "$POOL" "$TOKEN"
+```
+
+## 向 Gateway 存入 SUI
+
+跨链操作前，需要向 ZetaChain Gateway 存入 SUI。先获取 Sui 代币 ID：
+
+```
+COIN=$(sui client gas --json | jq -r '.[0].gasCoinId') && echo $COIN
+```
+
+示例地址：
+
+```
+ETH_ADDRESS=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
+GATEWAY_PACKAGE=0xa3ce10f68ed22d2cbbc31eaa709ee15e2e30348bfc6ff97b7d128d03b679c5c2
+GATEWAY_OBJECT=0xe925d4059435083b70bc504ce912202214edd06f693bdc3f9573a996292780c7
+```
+
+使用 localnet 输出中的 Gateway 地址执行存入：
+
+```
+sui client call \
+ --package "$GATEWAY_PACKAGE" \
+ --module gateway \
+ --function deposit \
+ --type-args 0x2::sui::SUI \
+ --args "$GATEWAY_OBJECT" "$COIN" "$ETH_ADDRESS"
+```
+
+> **注意**：请将 `GATEWAY_PACKAGE`、`GATEWAY_OBJECT` 替换为实际 localnet 输出中的值。
+
+## 准备 Withdraw and Call
+
+接下来执行 withdraw and call，将代币提现至 Sui 并同时调用 Sui 合约。
+
+获取所需合约 ID：
+
+```bash
+CONFIG=$(echo $PUBLISHED | jq -r --arg pkg "$PACKAGE" '.objectChanges[] | select(.type == "created" and .objectType == "\($pkg)::cetusmock::GlobalConfig") | .objectId') && echo $CONFIG
+```
+
+```
+CLOCK=$(echo $PUBLISHED | jq -r --arg pkg "$PACKAGE" '.objectChanges[] | select(.type == "created" and .objectType == "\($pkg)::cetusmock::Clock") | .objectId') && echo $CLOCK
+```
+
+```
+PARTNER=$(echo $PUBLISHED | jq -r --arg pkg "$PACKAGE" '.objectChanges[] | select(.type == "created" and .objectType == "\($pkg)::cetusmock::Partner") | .objectId') && echo $PARTNER
+```
+
+准备载荷：
+
+```
+MESSAGE=$RECIPIENT
+```
+
+```
+TOKEN_TYPE="$PACKAGE::token::TOKEN" && echo $TOKEN_TYPE
+```
+
+```
+PAYLOAD=$(npx ts-node ./setup/encodeCallArgs.ts "$TOKEN_TYPE" "$CONFIG,$POOL,$PARTNER,$CLOCK" "$MESSAGE") && echo $PAYLOAD
+```
+
+## 执行 Withdraw and Call
+
+首先授权 Gateway 消耗 ZRC-20 Sui：
+
+```
+cast send 0xd97B1de3619ed2c6BEb3860147E30cA8A7dC9891 "approve(address,uint256)" 0x2279B7A0a67DB372996a5FaB50D91eAA73d2eBe6 1000000000000000000000000 --private-key ac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
+```
+
+然后提现并调用：
+
+```
+cast send 0x2279B7A0a67DB372996a5FaB50D91eAA73d2eBe6 "withdrawAndCall(bytes,uint256,address,bytes,(uint256,bool),(address,bool,address,bytes,uint256))" \
+ "$PACKAGE" \
+ "1000000" \
+ "0xd97B1de3619ed2c6BEb3860147E30cA8A7dC9891" \
+ "$PAYLOAD" \
+ "(10000,false)" \
+ "(0xB0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48,true,0xC0b86991c6218b36c1d19D4a2e9Eb0cE3606eB49,0xdeadbeef,50000)" \
+ --private-key ac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
+```
+
+该交易会：
+
+1. 将代币从 ZetaChain 提现至 Sui
+2. 同时调用指定 Sui 合约并传入参数
+
+此流程展示了如何将资产提现与合约调用结合，实现 ZetaChain 与 Sui 之间复杂的跨链 DeFi 交互。***
+
diff --git a/src/pages/developers/tutorials/sui.mdx b/src/pages/developers/tutorials/sui.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/sui.mdx
rename to src/pages/developers/tutorials/sui.en-US.mdx
diff --git a/src/pages/developers/tutorials/sui.zh-CN.mdx b/src/pages/developers/tutorials/sui.zh-CN.mdx
new file mode 100644
index 000000000..4434db8db
--- /dev/null
+++ b/src/pages/developers/tutorials/sui.zh-CN.mdx
@@ -0,0 +1,276 @@
+ZetaChain 让基于 Sui 的应用能够直接与部署在 ZetaChain 上的全链智能合约交互。借助 ZetaChain 的全链互操作层，Sui 应用可以：
+
+- 将 SUI 与受支持的同质化代币存入 ZetaChain
+- 向全链合约发起跨链调用
+- 接收来自全链合约的跨链调用与代币转账
+
+本教程将教你：
+
+- 同时运行 ZetaChain 与 Sui 的本地开发环境
+- 在 ZetaChain 部署全链合约
+- 将 SUI 代币从 Sui 地址存入 ZetaChain
+- 通过跨链调用触发全链合约中的函数
+
+完成后，你将掌握如何从 Sui 转移资产、触发 ZetaChain 逻辑，无论是通过客户端钱包还是 Sui 合约。
+
+## 前置条件
+
+开始前请安装以下工具：
+
+| 工具 | 用途 |
+| --- | --- |
+| [Sui CLI](https://docs.sui.io/references/cli) | 运行本地 Sui 验证节点、管理地址与对象、部署合约 |
+| [Foundry](https://getfoundry.sh/) | 使用 `cast` 为跨链调用编码 ABI 载荷 |
+| [Node.js](https://nodejs.org/en) | 运行 ZetaChain CLI 与基于 JavaScript 的工具 |
+| [Yarn](https://yarnpkg.com/) | 安装与管理项目依赖 |
+| [jq](https://jqlang.org/) | 在脚本中解析 JSON 输出 |
+
+## 克隆示例项目
+
+使用 ZetaChain CLI 生成项目：
+
+```bash
+npx zetachain@latest new --project call
+cd call
+```
+
+该模板已包含 Sui 与 ZetaChain 合约示例。
+
+安装依赖：
+
+```bash
+yarn
+forge soldeer update
+```
+
+环境现已可用于本地开发与测试。
+
+## 启动 Localnet
+
+同时启动 ZetaChain 与 Sui 的本地环境：
+
+```bash
+yarn zetachain localnet start --chains sui
+```
+
+该命令会启动：
+
+- 本地 ZetaChain 实例
+- 本地 Sui 验证节点
+- 两条网络上的预部署 Gateway 合约
+
+请保持该终端运行。启动成功后会看到类似表格：
+
+```
+SUI
+┌──────────────────┬──────────────────────────────────────────────────────────────────────────────────┐
+│ (index) │ Values │
+├──────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
+│ gatewayPackageId │ '0x17360c15c10bbc4ebc57e9872f2993dc4376f7f0bb78920fe5fa9ad276ac7f86' │
+│ gatewayObjectId │ '0x9a26d6b6f413228bb120446977a8d8003eceb490cb7afd8921494815adc0a497' │
+│ userMnemonic │ 'grape subway rack mean march bubble carry avoid muffin consider thing street' │
+│ userAddress │ '0x2fec3fafe08d2928a6b8d9a6a77590856c458d984ae090ccbd4177ac13729e65' │
+│ tokenUSDC │ '6b0b8d1bbc40893a7f793f52c46aeea9db9f2f710c6a623c666bff712e26c94a::token::TOKEN' │
+└──────────────────┴──────────────────────────────────────────────────────────────────────────────────┘
+```
+
+> 💡 请妥善保留 `gatewayPackageId`、`gatewayObjectId` 与 `userMnemonic`，后续步骤会用到。
+
+## 部署全链合约
+
+接下来部署 ZetaChain 上的全链合约。
+
+首先从本地环境获取 Gateway 地址与预置私钥：
+
+```bash
+GATEWAY_ZETACHAIN=$(jq -r '.["31337"].contracts[] | select(.contractType == "gateway") | .address' ~/.zetachain/localnet/registry.json) && echo $GATEWAY_ZETACHAIN
+```
+
+```bash
+PRIVATE_KEY=$(jq -r '.private_keys[0]' ~/.zetachain/localnet/anvil.json) && echo $PRIVATE_KEY
+```
+
+编译合约：
+
+```
+forge build
+```
+
+部署 `Universal` 合约：
+
+```bash
+UNIVERSAL=$(forge create Universal \
+ --rpc-url http://localhost:8545 \
+ --private-key $PRIVATE_KEY \
+ --broadcast \
+ --json \
+ --constructor-args $GATEWAY_ZETACHAIN | jq -r .deployedTo) && echo $UNIVERSAL
+```
+
+## 存入 ZetaChain
+
+部署完成后，即可通过 Sui Gateway 合约将 SUI 存入 ZetaChain 上的全链合约。
+
+使用以下命令从 Sui 存入代币：
+
+```bash
+npx zetachain sui deposit \
+ --mnemonic "grape subway rack mean march bubble carry avoid muffin consider thing street" \
+ --receiver $UNIVERSAL \
+ --gateway-package 0x17360c15c10bbc4ebc57e9872f2993dc4376f7f0bb78920fe5fa9ad276ac7f86 \
+ --gateway-object 0x9a26d6b6f413228bb120446977a8d8003eceb490cb7afd8921494815adc0a497 \
+ --amount 0.001 \
+ --chain-id 104
+```
+
+> 🔎 请将 `--gateway-package` 与 `--gateway-object` 替换为你本地输出中的实际值。
+
+该命令会调用 Sui Gateway 的存入函数。ZetaChain 监听到存入事件后，会铸造等量 ZRC-20 SUI，并转入全链合约。
+
+## 存入并调用
+
+此步骤在存入 SUI 的同时调用全链合约：
+
+```bash
+npx zetachain sui deposit-and-call \
+ --mnemonic "grape subway rack mean march bubble carry avoid muffin consider thing street" \
+ --receiver $UNIVERSAL \
+ --gateway-package 0x17360c15c10bbc4ebc57e9872f2993dc4376f7f0bb78920fe5fa9ad276ac7f86 \
+ --gateway-object 0x9a26d6b6f413228bb120446977a8d8003eceb490cb7afd8921494815adc0a497 \
+ --amount 0.001 \
+ --chain-id 104 \
+ --types string \
+ --values hello
+```
+
+命令会调用 Sui Gateway 的 `deposit_and_call`，将 SUI 与载荷（此处为 `"hello"`）一并发送到 ZetaChain，触发全链合约的 `onCall`。
+
+## 构建并部署 Sui 合约
+
+你还可以部署一个 Sui 合约，在链上逻辑中发起存入操作。
+
+进入 Sui 合约目录：
+
+```bash
+cd sui
+```
+
+查看 `Move.toml`：
+
+```toml filename="sui/Move.toml"
+[dependencies]
+gateway = { local = "/usr/local/share/localnet/protocol-contracts-sui" }
+```
+
+示例项目已引入 Localnet 的 Gateway 模块。若在测试网/主网使用，将引用公共地址。
+
+构建 Sui 合约：
+
+```bash
+sui move build --force
+```
+
+将包发布到本地 Sui：
+
+```bash
+SUI_CONTRACT=$(sui client publish \
+ --skip-dependency-verification \
+ --json 2>/dev/null | jq -r '.objectChanges[] | select(.type == "published") | .packageId') && echo $SUI_CONTRACT
+```
+
+## 通过水龙头获取代币
+
+你的 Sui 账户需要一些 SUI 支付交易费。通过本地水龙头获取：
+
+```bash
+sui client faucet
+```
+
+## 从 Sui 合约发起存入并调用
+
+在 Sui 中，可通过 Programmable Transaction Block（PTB）实现复杂交易：组合多步操作并作为单笔交易提交。客户端应用构建并签名 PTB，提交后由 Sui 一次性执行。
+
+项目中已有 TypeScript 命令 `commands/suiDepositAndCall.ts`，默认直接构建 ABI 载荷并调用 Sui Gateway。我们将其修改为：
+
+1. 先调用自定义的 Sui 合约并获取返回值
+2. 将返回值作为载荷传递给 Sui Gateway
+
+打开 `commands/suiDepositAndCall.ts`，修改载荷构造：
+
+```ts filename="commands/suiDepositAndCall.ts"
+// const payload = tx.pure.vector("u8", utils.arrayify(payloadABI));
+
+const payload = tx.moveCall({
+ target: `${options.connected}::connected::hello`,
+ arguments: [tx.pure.string(params.values[0] as string)],
+});
+```
+
+这会调用 `connected::hello`，返回值即作为载荷转发给 Gateway 的 `deposit_and_call`。
+
+由于 Sui 合约不便直接编码 EVM 所需数据，我们将全链合约的 `onCall` 签名改为接收 `bytes` 并按 UTF-8 解读：
+
+```solidity
+function onCall(
+ MessageContext calldata context,
+ address zrc20,
+ uint256 amount,
+ bytes calldata message
+) external override onlyGateway {
+ // string memory name = abi.decode(message, (string));
+ emit HelloEvent("Hello on ZetaChain", string(message));
+}
+```
+
+重新构建并部署合约：
+
+```bash
+forge build
+```
+
+```bash
+UNIVERSAL=$(forge create Universal \
+ --rpc-url http://localhost:8545 \
+ --private-key $PRIVATE_KEY \
+ --broadcast \
+ --json \
+ --constructor-args $GATEWAY_ZETACHAIN | jq -r .deployedTo) && echo $UNIVERSAL
+```
+
+现在执行 PTB：调用 Sui 合约获取返回值，将其传给 Sui Gateway，再由 Gateway 调用 ZetaChain 上的全链合约：
+
+```bash
+npx tsx commands deposit-and-call \
+ --private-key suiprivkey1qrqtrevmd40vxlv3q6fcgmm09af5p8f8j67ezve0u3nhrs0psslgjnw3y5p \
+ --receiver $UNIVERSAL \
+ --gateway-package 0xc52d19fd2f0bcb94d0c285d480b6a8af515f5ec19d0cff8818fc9bf0d3731b85 \
+ --gateway-object 0xa755a1106ae7039a25c10578b6f3c5b73963055e0d6fc40e8abcebea454a6389 \
+ --amount 0.001 \
+ --chain-id 104 \
+ --types string \
+ --values alice \
+ --connected $SUI_CONTRACT
+```
+
+终端中应看到类似事件输出：
+
+```
+[ZetaChain] Event from onCall: {"_type":"log","address":"0xa6e99A4ED7498b3cdDCBB61a6A607a4925Faa1B7",...}
+```
+
+可通过解码日志验证：
+
+```bash
+cast abi-decode "data()(string,string)" \
+ 0x0000000000000000000000000000000000000000000000000000000000000040...
+```
+
+预期输出：
+
+```
+"Hello on ZetaChain"
+"hello alice"
+```
+
+至此，你已完成从 Sui 合约到 ZetaChain 的跨链调用，并掌握了定制载荷与事件处理的流程。***
+
diff --git a/src/pages/developers/tutorials/swap.mdx b/src/pages/developers/tutorials/swap.en-US.mdx
similarity index 100%
rename from src/pages/developers/tutorials/swap.mdx
rename to src/pages/developers/tutorials/swap.en-US.mdx
diff --git a/src/pages/developers/tutorials/swap.zh-CN.mdx b/src/pages/developers/tutorials/swap.zh-CN.mdx
new file mode 100644
index 000000000..acaab6cdd
--- /dev/null
+++ b/src/pages/developers/tutorials/swap.zh-CN.mdx
@@ -0,0 +1,394 @@
+## 简介
+
+本教程将带你构建一个 ZetaChain 全链应用，实现无缝的跨链代币兑换。用户可从连接链发送原生 Gas 代币或 ERC-20，并在另一条链上接收不同的代币，整个过程在一笔交易中完成。例如，用户可直接将以太坊上的 USDC 兑换为比特币上的 BTC，而无需使用跨链桥或中心化交易所。
+
+你将学会：
+
+- 创建可在多链间执行代币兑换的全链应用
+- 将其部署到 ZetaChain
+- 从连接的 EVM 链触发跨链兑换
+
+兑换逻辑由部署在 ZetaChain 上的智能合约实现，符合 `UniversalContract` 接口。通过 Gateway，该合约可被任意连接链调用。当连接链发送代币时，会以 [ZRC-20](/developers/evm/zrc20) 形式进入 ZetaChain。ZRC-20 是外部资产在 ZetaChain 上的原生表示，既保留了原资产属性，又允许在 ZetaChain 上编程，包括跨链提现。
+
+Swap 合约执行以下步骤：
+
+1. 接收来自连接链的跨链调用及原生或 ERC-20 代币。
+2. 解码消息载荷，获取：
+ - 目标代币（ZRC-20）地址
+ - 目标链上的收款人地址
+3. 查询目标链提现该代币所需的 Gas 费用。
+4. 若需提现到连接链，使用 Uniswap v2 池将部分输入代币兑换为目标链 Gas 所需的 ZRC-20。
+5. 将剩余代币兑换为目标代币。
+6. 将兑换后的代币提现给目标链上的收款人。
+
+这种方式让用户仅需一次交易即可发起复杂的多链操作，隐藏了流动性路由、Gas 支付与跨链执行等底层细节。
+
+> 注意：本教程示例使用 ZetaChain 上的 Uniswap v2 池。这些池主要用于 ZetaChain 进行小额代币交换（例如在跨链交易回退时获取 Gas），可能没有足够流动性支持大额交易。生产环境建议使用活跃 DEX（如 [Beam](https://docs.beamdex.xyz/) 或 [Zuno](https://docs.zunodex.xyz/)）的池，或部署其他 DEX。
+
+## 前置条件
+
+请先完成以下教程：
+
+- [全链应用简介](/start/app/)
+- [ZetaChain 入门](/developers/tutorials/intro)
+- [第一个全链应用](/developers/tutorials/hello)
+
+## 环境准备
+
+使用 CLI 创建新项目：
+
+```bash
+zetachain new --project swap
+```
+
+安装依赖：
+
+```bash
+cd swap
+yarn
+```
+
+通过 Foundry 的包管理器拉取 Solidity 依赖：
+
+```bash
+forge soldeer update
+```
+
+编译合约：
+
+```bash
+forge build
+```
+
+至此，你已拥有带 Foundry 与 ZetaChain CLI 支持的开发环境，可进行本地部署与测试。
+
+## 了解 Swap 合约
+
+`Swap` 合约是部署在 ZetaChain 的全链应用，允许用户通过一次跨链调用完成代币兑换。传入的代币会以 ZRC-20 形式接收，必要时通过 Uniswap v2 进行兑换，最终可提现到连接链。
+
+### 全链入口：onCall
+
+合约部署在 ZetaChain，实现 `UniversalContract`，仅暴露一个入口函数。跨链调用只能经由 Gateway 触发，保证调用面可信且简洁。
+
+```solidity
+function onCall(
+ MessageContext calldata context,
+ address zrc20,
+ uint256 amount,
+ bytes calldata message
+) external onlyGateway
+```
+
+- `onlyGateway` 保证 `onCall` 仅由 Gateway 调用。
+- `MessageContext` 包含源链 ID（`context.chainID`）与原始调用者（`context.sender`），可视为源的权威身份。
+
+### 资产模型：ZRC-20
+
+来自连接链的资产会在 ZetaChain 表示为 ZRC-20。在 `onCall` 中，`zrc20` 为输入代币，`amount` 为接收数量。若需向其他链发送资产，合约需批准 Gateway 消耗特定 ZRC-20 数量，然后调用 `withdraw`。
+
+两个关键接口：
+
+**目标链提现 Gas 询价**：
+
+```solidity
+(address gasZRC20, uint256 gasFee) = IZRC20(targetToken).withdrawGasFee();
+```
+
+- `gasZRC20`：代表目标链 Gas 代币的 ZRC-20。
+- `gasFee`：在目标链执行所需的费用。
+
+**向连接链提现**（销毁 ZRC-20，释放对端原生资产）：
+
+```solidity
+IZRC20(gasZRC20).approve(address(gateway), gasFee);
+IZRC20(params.target).approve(address(gateway), out);
+
+gateway.withdraw(
+ abi.encodePacked(params.to), // 链无关的接收者（bytes）
+ out, // 提现数量
+ params.target, // 待提现的 ZRC-20
+ revertOptions // 失败处理
+);
+```
+
+若目标链 Gas 代币 (`gasZRC20`) 与目标代币相同，可合并批准 `out + gasFee`。
+
+### 使用用户输入筹集目标链 Gas
+
+应用会从用户输入中扣除目标链 Gas，无需用户额外准备。
+
+流程：
+
+1. 通过 `withdrawGasFee()` 获取目标链 Gas 需求。
+2. 使用 DEX 报价确认输入是否足够：
+
+ ```solidity
+ uint256 minInput = quoteMinInput(inputToken, targetToken);
+ if (amount < minInput) revert InsufficientAmount(...);
+ ```
+
+3. 若输入代币不是 `gasZRC20`，兑换足够金额以支付 Gas：
+
+ ```solidity
+ inputForGas = SwapHelperLib.swapTokensForExactTokens(
+ uniswapRouter, inputToken, gasFee, gasZRC20, amount
+ );
+ ```
+
+4. 将剩余部分兑换为目标代币：
+
+ ```solidity
+ out = SwapHelperLib.swapExactTokensForTokens(
+ uniswapRouter, inputToken, amount - inputForGas, targetToken, 0
+ );
+ ```
+
+`quoteMinInput()` 使用 Uniswap v2 的 `getAmountsIn` 估算覆盖 Gas 所需的最小输入。
+
+### 链无关地址
+
+收款人（以及事件中的发送者）以原始 `bytes` 表示，而非 `address`，因此同一合约可同时服务 EVM、比特币、Solana 等链。跨链提现时，将 `bytes` 直接传给 `gateway.withdraw` 即可。
+
+### 解码消息载荷
+
+跨链调用可携带额外参数，作为 ABI 编码的载荷。Swap 合约中载荷包含三项：
+
+```
+(address targetToken, bytes recipient, bool withdrawFlag)
+```
+
+- `targetToken`：兑换后需交付的 ZRC-20 地址。
+- `recipient`：目标链收款地址（raw bytes），适用于任意链。
+- `withdrawFlag`：`true` 表示提现至其他链；`false` 表示留在 ZetaChain。
+
+在 `onCall` 中解码：
+
+```solidity
+(address targetToken, bytes memory recipient, bool withdrawFlag) =
+ abi.decode(message, (address, bytes, bool));
+```
+
+### 回退处理：RevertOptions 与 onRevert
+
+若目标调用/转账失败，Gateway 会携带 `RevertContext` 调用 `onRevert`。合约会在 `revertMessage` 中编码原始发送者与输入代币，方便自动退款：
+
+```solidity
+function onRevert(RevertContext calldata context) external onlyGateway {
+ (bytes memory sender, address zrc20) =
+ abi.decode(context.revertMessage, (bytes, address));
+
+ (uint256 out,,) = handleGasAndSwap(
+ context.asset, context.amount, zrc20, true
+ );
+
+ gateway.withdraw(
+ sender,
+ out,
+ zrc20,
+ RevertOptions({
+ revertAddress: address(bytes20(sender)),
+ callOnRevert: false,
+ abortAddress: address(0),
+ revertMessage: "",
+ onRevertGasLimit: gasLimit
+ })
+ );
+}
+```
+
+这样就能在任意链上执行一致的退款流程。
+
+### 使用流动性池兑换
+
+全链合约可使用 ZetaChain 上的任意 DEX/AMM。本示例通过 `SwapHelperLib` 调用 Uniswap v2：
+
+```solidity
+SwapHelperLib.swapTokensForExactTokens(
+ uniswapRouter, inputToken, gasFee, gasZRC20, amount
+);
+
+SwapHelperLib.swapExactTokensForTokens(
+ uniswapRouter, inputToken, swapAmount, targetToken, 0
+);
+```
+
+若 `inputToken == gasZRC20`，则直接使用 `gasFee`，无需兑换 Gas，仅需将剩余余额兑换为目标代币。
+
+你可自由替换为其他 DEX 接口或自定义路由逻辑，只需保证 ZRC-20 资金流与 Gateway 提现语义正确。
+
+## 方案一：部署到测试网
+
+部署 Swap 合约到 ZetaChain 测试网：
+
+```bash
+UNIVERSAL=$(npx tsx commands deploy --private-key $PRIVATE_KEY | jq -r .contractAddress) && echo $UNIVERSAL
+```
+
+脚本会自动使用测试网的 Gateway 与 Uniswap Router 地址。
+
+部署成功后，`UNIVERSAL` 环境变量即为测试网上 Swap 合约地址。后续触发跨链兑换时会用到该地址。
+
+获取 EVM 发送地址：
+
+```bash
+RECIPIENT=$(cast wallet address $PRIVATE_KEY) && echo $RECIPIENT
+```
+
+查询 Ethereum Sepolia 上 ETH 对应的 ZRC-20 地址：
+
+```bash
+ZRC20_ETHEREUM_ETH=$(zetachain q tokens show --symbol sETH.SEPOLIA -f zrc20) && echo $ZRC20_ETHEREUM_ETH
+```
+
+## 从 Base 兑换到 Ethereum
+
+发起 Base → Ethereum 兑换：
+
+```bash
+npx zetachain evm deposit-and-call \
+ --chain-id 84532 \
+ --amount 0.001 \
+ --types address bytes bool \
+ --receiver $UNIVERSAL \
+ --values $ZRC20_ETHEREUM_ETH $RECIPIENT true
+```
+
+该命令会向 Base Gateway 调用 `depositAndCall`，将 0.001 ETH 包装为 Base ETH 的 ZRC-20，并携带载荷发送至 ZetaChain 上的 Swap 合约。合约在 ZetaChain 使用 Uniswap v2 将 Base ETH 兑换为 Ethereum ETH 的 ZRC-20，并提现至 Ethereum Sepolia 上的 `RECIPIENT`。
+
+整个流程在一笔跨链交易中完成，无需提前准备目标链 Gas，也不需手动使用桥或路由器。
+
+Base 交易示例：
+
+https://sepolia.basescan.org/tx/0x8def0ff44c0e45803f209bc864123a08a03e6e1fadc5ac6f28f4c17f1463aae9
+
+可通过：
+
+```
+zetachain query cctx --hash 0x8def0ff44c0e45803f209bc864123a08a03e6e1fadc5ac6f28f4c17f1463aae9
+```
+
+查看完整跨链明细，包括 Base → ZetaChain 的入站与 ZetaChain → Ethereum Sepolia 的出站交易、哈希、地址与代币数量。
+
+## 从 Solana 兑换到 Ethereum
+
+发起 Solana → Ethereum Sepolia 兑换：
+
+```bash
+npx zetachain solana deposit-and-call \
+ --recipient $UNIVERSAL \
+ --types address bytes bool \
+ --values $ZRC20_ETHEREUM_ETH $RECIPIENT true \
+ --chain-id 901 \
+ --private-key $SOLANA_PRIVATE_KEY \
+ --amount 0.01
+```
+
+该命令会在 Solana Gateway 锁定 0.01 SOL，并以 ZRC-20 SOL 形式连同载荷发送至 Swap 合约。合约再将其兑换为 Ethereum ETH 的 ZRC-20 并提现给 `RECIPIENT`。收款地址以 `bytes` 表示，让同一合约可同时处理 EVM 与非 EVM 链。
+
+Solana 交易示例：
+
+https://solana.fm/tx/28xsic7NqafyxqDjmqfYL5f6RoHFYLrCKvjSA4UJCXyESmdCb1bVpW3dqT2QJrwV6KmfdWuHrwj8uW4txHZiXLxm?cluster=devnet-solana
+
+查看跨链详情：
+
+```bash
+npx zetachain query cctx --hash 28xsic7NqafyxqDjmqfYL5f6RoHFYLrCKvjSA4UJCXyESmdCb1bVpW3dqT2QJrwV6KmfdWuHrwj8uW4txHZiXLxm
+```
+
+## 从 Bitcoin 兑换到 Ethereum
+
+同样可从比特币发起兑换。以下命令通过铭文发送 0.05 BTC：
+
+在执行前，将 `PRIVATE_KEY_BTC` 设置为你的比特币私钥。
+
+```bash
+zetachain bitcoin inscription deposit-and-call \
+ --private-key $PRIVATE_KEY_BTC \
+ --receiver $UNIVERSAL \
+ --types address bytes bool \
+ --values $ZRC20_ETHEREUM_ETH $RECIPIENT true \
+ --amount 0.05
+```
+
+比特币交易被观察并处理后，合约会在一条跨链流程中完成兑换与提现。
+
+## 方案二：部署到 Localnet
+
+查询 Uniswap Router 地址：
+
+```bash
+UNISWAP_ROUTER=$(jq -r '.["31337"].contracts[] | select(.contractType == "uniswapRouterInstance") | .address' ~/.zetachain/localnet/registry.json) && echo $UNISWAP_ROUTER
+```
+
+查询 Gateway 地址：
+
+```bash
+GATEWAY_ZETACHAIN=$(jq -r '.["31337"].contracts[] | select(.contractType == "gateway") | .address' ~/.zetachain/localnet/registry.json) && echo $GATEWAY_ZETACHAIN
+```
+
+获取 Localnet 预置私钥：
+
+```bash
+PRIVATE_KEY=$(jq -r '.private_keys[0]' ~/.zetachain/localnet/anvil.json) && echo $PRIVATE_KEY
+```
+
+部署合约：
+
+```bash
+UNIVERSAL=$(npx tsx commands/index.ts deploy \
+ --private-key $PRIVATE_KEY \
+ --rpc http://localhost:8545 \
+ --gateway $GATEWAY_ZETACHAIN \
+ --uniswap-router $UNISWAP_ROUTER | jq -r .contractAddress) && echo $UNIVERSAL
+```
+
+部署完成后，`UNIVERSAL` 即为本地部署地址。
+
+### Ethereum → BNB（Localnet）
+
+先准备变量。
+
+获取 Ethereum 的 Gateway：
+
+```bash
+GATEWAY_ETHEREUM=$(jq -r '.["11155112"].contracts[] | select(.contractType == "gateway") | .address' ~/.zetachain/localnet/registry.json) && echo $GATEWAY_ETHEREUM
+```
+
+查询 BNB Gas 代币对应的 ZRC-20：
+
+```bash
+ZRC20_BNB=$(jq -r '."98".chainInfo.gasZRC20' ~/.zetachain/localnet/registry.json) && echo $ZRC20_BNB
+```
+
+获取本地私钥对应地址：
+
+```bash
+RECIPIENT=$(cast wallet address $PRIVATE_KEY) && echo $RECIPIENT
+```
+
+触发兑换：
+
+```bash
+npx zetachain evm deposit-and-call \
+ --rpc http://localhost:8545 \
+ --chain-id 11155112 \
+ --gateway $GATEWAY_ETHEREUM \
+ --amount 0.001 \
+ --types address bytes bool \
+ --receiver $UNIVERSAL \
+ --private-key $PRIVATE_KEY \
+ --values $ZRC20_BNB $RECIPIENT true
+```
+
+这会将 0.001 ETH 从本地 Ethereum 环境发送至 ZetaChain，转换为 ZRC-20 BNB，并提现到本地 BNB 链的地址。
+
+## 总结
+
+本教程展示了如何编写实现跨链代币兑换的全链应用，部署到本地或测试环境，并从连接 EVM 链触发代币兑换。同时，你也了解了在跨链兑换中处理 Gas 费用与代币授权的机制。
+
+## 源码
+
+教程示例可在示例合约仓库中找到：
+
+https://github.com/zeta-chain/example-contracts/tree/main/examples/swap
+
diff --git a/src/pages/index.mdx b/src/pages/index.en-US.mdx
similarity index 100%
rename from src/pages/index.mdx
rename to src/pages/index.en-US.mdx
diff --git a/src/pages/index.zh-CN.mdx b/src/pages/index.zh-CN.mdx
new file mode 100644
index 000000000..a4a53eda7
--- /dev/null
+++ b/src/pages/index.zh-CN.mdx
@@ -0,0 +1,23 @@
+---
+title: ZetaChain 中文文档
+description: ZetaChain 是唯一为全链互操作性构建的去中心化区块链与智能合约平台。
+---
+
+欢迎来到 **ZetaChain 中文文档**！这里汇集了 ZetaChain 的核心概念、开发教程、节点运行指引以及终端用户指南，帮助你快速掌握全链开发与使用要点。
+
+## 如何开始
+
+- 想快速体验 ZetaChain？请访问 [快速开始](/zh/start/)。
+- 准备构建全链应用？前往 [开发者专区](/zh/developers/) 获取架构说明、示例与 SDK。
+- 需要了解网络参数或工具？查看 [参考信息](/zh/reference/)。
+- 计划运行验证者或节点？阅读 [运行节点](/zh/nodes/)。
+- 如果你是终端用户，可浏览 [使用指南](/zh/users/) 学习如何使用官方产品。
+
+## 获得帮助
+
+- 加入 [Discord 中文社区](https://discord.gg/zetachain) 与其他构建者交流。
+- 在 [GitHub 文档仓库](https://github.com/zeta-chain/docs) 提交 Issue 或 PR，共同完善中文内容。
+- 关注官方公告，及时了解 ZetaChain 生态的最新动态。
+
+祝你在 ZetaChain 的全链世界中构建、探索愉快！
+
diff --git a/src/pages/nodes/_meta.json b/src/pages/nodes/_meta.en-US.json
similarity index 100%
rename from src/pages/nodes/_meta.json
rename to src/pages/nodes/_meta.en-US.json
diff --git a/src/pages/nodes/_meta.zh-CN.json b/src/pages/nodes/_meta.zh-CN.json
new file mode 100644
index 000000000..c98a32e48
--- /dev/null
+++ b/src/pages/nodes/_meta.zh-CN.json
@@ -0,0 +1,11 @@
+{
+ "index": {
+ "title": "运行节点"
+ },
+ "start-here": {
+ "title": "从这里开始"
+ },
+ "validate": {
+ "title": "验证"
+ }
+}
diff --git a/src/pages/nodes/index.mdx b/src/pages/nodes/index.en-US.mdx
similarity index 100%
rename from src/pages/nodes/index.mdx
rename to src/pages/nodes/index.en-US.mdx
diff --git a/src/pages/nodes/index.zh-CN.mdx b/src/pages/nodes/index.zh-CN.mdx
new file mode 100644
index 000000000..c47214de6
--- /dev/null
+++ b/src/pages/nodes/index.zh-CN.mdx
@@ -0,0 +1,15 @@
+---
+title: 运行节点
+description: 通过运行节点成为 ZetaChain 网络的重要一员。无论测试网还是主网都能轻松起步。
+heroImgUrl: /img/pages/operate.svg
+heroImgWidth: 549
+---
+
+import { CurrentPageNavigationSections } from "~/components/shared";
+import { GetSupport } from "~/components/Support";
+
+
+
+
diff --git a/src/pages/nodes/start-here/_meta.json b/src/pages/nodes/start-here/_meta.en-US.json
similarity index 100%
rename from src/pages/nodes/start-here/_meta.json
rename to src/pages/nodes/start-here/_meta.en-US.json
diff --git a/src/pages/nodes/start-here/_meta.zh-CN.json b/src/pages/nodes/start-here/_meta.zh-CN.json
new file mode 100644
index 000000000..748b1811e
--- /dev/null
+++ b/src/pages/nodes/start-here/_meta.zh-CN.json
@@ -0,0 +1,14 @@
+{
+ "requirements": {
+ "title": "技术要求"
+ },
+ "setup": {
+ "title": "节点部署"
+ },
+ "syncing": {
+ "title": "节点同步"
+ },
+ "validator": {
+ "title": "创建核心验证人"
+ }
+}
diff --git a/src/pages/nodes/start-here/requirements.mdx b/src/pages/nodes/start-here/requirements.en-US.mdx
similarity index 100%
rename from src/pages/nodes/start-here/requirements.mdx
rename to src/pages/nodes/start-here/requirements.en-US.mdx
diff --git a/src/pages/nodes/start-here/requirements.zh-CN.mdx b/src/pages/nodes/start-here/requirements.zh-CN.mdx
new file mode 100644
index 000000000..8f3bd3d65
--- /dev/null
+++ b/src/pages/nodes/start-here/requirements.zh-CN.mdx
@@ -0,0 +1,136 @@
+---
+title: 技术要求
+---
+
+## 节点规格
+
+以下为推荐的 ZetaChain 节点配置。
+
+| 节点类型 | CPU | 内存 | 数据盘 |
+| :------- | :-- | :--- | :----- |
+| 核心验证人 | 4 核 | 16 GB | 300+ GB |
+| 全节点 | 4 核 | 12 GB | 300+ GB |
+| 归档节点 | 4 核 | 12 GB | 3+ TB |
+
+建议在支持高 IOPS（12K 及以上）的 NVMe SSD 机器上运行验证人，以免落后并遭到监禁处罚。
+
+## 网络要求
+
+#### 公网端口
+
+ZetaChain 节点通过以下端口通信，请确保向公网开放。
+
+| 节点类型 | 端口 | 协议 |
+| :------- | :--- | :--- |
+| 全节点 & 验证人 | 26656 | TCP |
+
+#### RPC / API / 归档节点
+
+如需在节点上开放 RPC/API 服务，请同时开放以下端口。
+
+| RPC 类型 | 端口 | 协议 |
+| :------- | :--- | :--- |
+| Tendermint | 26657 | TCP |
+| EVM RPC - HTTP | 8545 | TCP |
+| EVM RPC - WSS | 8546 | TCP |
+| Cosmos RPC | 1317 | TCP |
+
+#### 操作系统
+
+ZetaChain 节点在 x86_64 架构上开发与测试，二进制以 Ubuntu 22.04 LTS x86_64 编译。本指南默认你使用该系统；若采用其他系统，可能需要适当调整。
+
+## 基础设施成本分析
+
+了解运行 ZetaChain 节点的成本有助于规划部署。以下为不同托管方案的成本拆解。
+
+### 月度成本对比
+
+#### 公有云
+
+| 服务商 | 实例类型 | 计算 | 存储 | 基础总价 | 含带宽（估算）* |
+| :----- | :------- | :--- | :--- | :------- | :-------------- |
+| **AWS** | t3.xlarge | \$121.47 | \$24.00 | \$145.47 | \$235-595 |
+| **AWS** | m5.xlarge | \$140.00 | \$24.00 | \$164.00 | \$254-614 |
+| **AWS** | Reserved（1 年） | \$85.00 | \$24.00 | \$109.00 | \$199-559 |
+| **GCP** | n2-standard-4 | \$141.79 | \$51.00 | \$192.79 | \$271-754 |
+
+\* 带宽成本会因数据传输量（估算 1-5 TB/月）差异较大。
+
+#### 自建/独立服务器
+
+| 服务商 | 配置 | 月费 | 备注 |
+| :----- | :--- | :--- | :--- |
+| **Hetzner** | 4 核、32GB RAM、NVMe SSD | €54.99（约 \$60） | 1 Gbps 端口不限流（FUP 可能适用） |
+| **OVHcloud** | 4 核、16GB RAM、NVMe/1TB SSD | €43.99（约 \$48） | 1 Gbps 端口不限流（FUP 可能适用） |
+| **Vultr** | 8 vCPU、16GB RAM、300GB NVMe | \$180.00 | 性能佳，注意端口速率限制 |
+| **Cherry Servers** | 4 核、32GB RAM、240GB SSD | \$120.00 | 企业级硬件 |
+| **InMotion Hosting** | 4 核、16GB RAM、1TB SSD | \$69.99 | 预算型方案 |
+
+### 年度成本概览
+
+| 托管类型 | 低端 | 高端 | 适合对象 |
+| :------- | :--- | :--- | :------- |
+| **裸金属** | \$576 | \$2,160 | 降本增效 |
+| **AWS 保留实例** | \$2,388 | \$6,708 | 企业/生产级 |
+| **GCP 优化方案** | \$2,772 | \$7,608 | 深耕 Google 生态 |
+
+### 其他成本因素
+
+#### 带宽需求
+
+ZetaChain 验证人需处理：
+
+- 区块传播与验证
+- P2P 网络通信
+- 状态同步
+
+**估算流量：** 每月 1-5 TB
+
+- 云服务：\$90-600/月（超出免费额度后）
+- 裸金属：通常不限流或费用低廉
+
+#### 运维成本
+
+- **监控与管理：** \$20-50/月
+- **备份与灾备：** \$10-50/月
+- **安全与维护：** 视情况而定
+
+### 推荐方案
+
+#### 目标为降本
+
+- **裸金属（Hetzner / OVHcloud）：\$48-60/月**
+ - 价格性能比高
+ - 通常包含不限流带宽
+ - 适合位于稳定地区的验证人
+
+#### 生产/企业环境
+
+- **AWS Savings Plans 或保留实例：\$199–300/月（估算）**
+ - SLA 与支持更佳，IAM/KMS 成熟
+ - 易于扩展与管理
+ - 建议多可用区部署以降低中断风险
+- **企业级裸金属（Cherry Servers）：\$120/月**
+ - 专用硬件性能
+ - 确保预留机器或热备份
+
+#### 高性能场景
+
+- 必须使用 NVMe SSD 满足验证人需求
+- 考虑专用带宽
+- 部署完善的监控与告警
+
+### 关键考量
+
+#### 性能需求
+
+- 验证人需高 IOPS（12K+）
+- 强烈推荐 NVMe SSD
+- 网络延迟对性能至关重要
+
+#### 可靠性因素
+
+- 验证人奖励依赖高可用性
+- 性能不佳存在被罚没风险
+- 注意地理分布，保证去中心化程度
+
diff --git a/src/pages/nodes/start-here/setup.mdx b/src/pages/nodes/start-here/setup.en-US.mdx
similarity index 100%
rename from src/pages/nodes/start-here/setup.mdx
rename to src/pages/nodes/start-here/setup.en-US.mdx
diff --git a/src/pages/nodes/start-here/setup.zh-CN.mdx b/src/pages/nodes/start-here/setup.zh-CN.mdx
new file mode 100644
index 000000000..29d1b78ae
--- /dev/null
+++ b/src/pages/nodes/start-here/setup.zh-CN.mdx
@@ -0,0 +1,217 @@
+---
+title: 节点部署
+description: 本指南演示如何部署 ZetaChain 主网 Beta 节点。如需部署测试网节点，请遵循相同步骤，只需将部分参数（如链 ID、种子节点等）替换为对应表格中的值。
+---
+
+import { Alert } from "~/components/shared";
+
+## 安装 ZetaChain 节点二进制
+
+首先下载二进制文件并赋予可执行权限。请将 `VERSION` 替换为最新的 [治理软件升级提案](/reference/tools/proposals) 中指定版本，同时根据需要修改平台后缀（如 `-linux-amd64`）。
+
+```
+sudo wget https://github.com/zeta-chain/node/releases/download/VERSION/zetacored-linux-amd64 -O /usr/local/bin/zetacored &&\
+sudo chmod a+x /usr/local/bin/zetacored
+```
+
+关于版本的更多信息，请查看 [GitHub Releases](https://github.com/zeta-chain/node/releases)。
+
+验证 `zetacored` 版本：
+
+```
+zetacored version
+```
+
+## 创建非 root 用户
+
+建议使用普通用户运行 ZetaChain 二进制，而非 root。
+
+```bash
+sudo useradd -m -s /bin/bash zetachain
+```
+
+## 初始化数据目录
+
+| 网络 | 链 ID |
+| ---- | ----- |
+| 主网 | zetachain_7000-1 |
+| 测试网 | athens_7001-1 |
+
+```
+sudo -u zetachain zetacored init MONIKER --chain-id zetachain_7000-1
+```
+
+将 `MONIKER` 替换为节点名称。默认初始化路径为 `$HOME/.zetacored`，可通过 `--home` 自定义。
+
+## 获取配置文件
+
+| 网络 | 配置文件 |
+| ---- | -------- |
+| 主网 | https://github.com/zeta-chain/network-config/tree/main/mainnet |
+| 测试网 | https://github.com/zeta-chain/network-config/tree/main/athens3 |
+
+将配置文件下载到数据目录：
+
+```
+sudo -u zetachain wget https://raw.githubusercontent.com/zeta-chain/network-config/main/mainnet/genesis.json -O /home/zetachain/.zetacored/config/genesis.json &&\
+sudo -u zetachain wget https://raw.githubusercontent.com/zeta-chain/network-config/main/mainnet/client.toml -O /home/zetachain/.zetacored/config/client.toml &&\
+sudo -u zetachain wget https://raw.githubusercontent.com/zeta-chain/network-config/main/mainnet/config.toml -O /home/zetachain/.zetacored/config/config.toml &&\
+sudo -u zetachain wget https://raw.githubusercontent.com/zeta-chain/network-config/main/mainnet/app.toml -O /home/zetachain/.zetacored/config/app.toml
+```
+
+## 修改配置
+
+虽然下载的配置已包含通用参数，但仍需根据节点情况做少量调整。
+
+若机器拥有公网 IPv4 地址，可运行：
+
+```
+curl -4 icanhazip.com
+```
+
+如果有 IPv6 地址，也可以使用。
+
+将节点 `moniker` 与外部地址替换为正确值：
+
+```text filename="~/.zetacored/config/config.toml"
+moniker = "{MONIKER}"
+external_address = "{YOUR_EXTERNAL_IP_ADDRESS_HERE}:26656"
+```
+
+## 设置文件与进程限制
+
+为更好地管理节点资源，建议调整最大文件描述符（nofile）与进程数（nproc）。
+
+编辑 `/etc/security/limits.conf`：
+
+```
+* soft nproc 262144
+* hard nproc 262144
+* soft nofile 262144
+* hard nofile 262144
+```
+
+编辑 `/etc/sysctl.conf`：
+
+```
+fs.file-max=262144
+```
+
+## 安装 Cosmovisor
+
+来自 [Cosmos 文档](https://docs.cosmos.network/v0.47/build/tooling/cosmovisor)：
+
+> cosmovisor 是 Cosmos SDK 应用的进程管理器，可在链升级时自动切换应用二进制。它会轮询升级高度创建的 upgrade-info.json 文件，并自动下载新二进制、停止旧进程、切换并重启节点。
+
+### 源码安装
+
+```bash
+go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.7.1
+mv $(go env GOPATH)/bin/cosmovisor /usr/local/bin/cosmovisor
+```
+
+### 预编译二进制
+
+从 [cosmovisor v1.7.1 发布页](https://github.com/cosmos/cosmos-sdk/releases/tag/cosmovisor%2Fv1.7.1) 下载对应平台的压缩包。例如：
+
+```bash
+wget https://github.com/cosmos/cosmos-sdk/releases/download/cosmovisor%2Fv1.7.1/cosmovisor-v1.7.1-linux-amd64.tar.gz
+tar xf cosmovisor-v1.7.1-linux-amd64.tar.gz &&\
+chmod a+x cosmovisor &&\
+sudo mv cosmovisor /usr/local/bin
+```
+
+## 配置 Cosmovisor
+
+### 创建 `cosmovisor` 目录
+
+```bash
+sudo -u zetachain mkdir -p /home/zetachain/.zetacored/cosmovisor/genesis/bin &&\
+sudo -u zetachain mkdir -p /home/zetachain/.zetacored/cosmovisor/upgrades
+```
+
+### 安装当前 `zetacored` 二进制
+
+将 [部署阶段](./setup) 获取的 `zetacored` 二进制放入 `/home/zetachain/.zetacored/cosmovisor/genesis/bin`：
+
+```bash
+sudo -u zetachain cp /usr/local/bin/zetacored /home/zetachain/.zetacored/cosmovisor/genesis/bin
+```
+
+## 配置 `zetacored` systemd 服务
+
+### 创建 systemd 单元
+
+创建本地 systemd 单元目录：
+
+```bash
+sudo mkdir -p /usr/local/lib/systemd/system/
+```
+
+创建 `/usr/local/lib/systemd/system/zetacored.service`：
+
+```bash
+cat <
+ 在此示例中，我们设置了 `DAEMON_ALLOW_DOWNLOAD_BINARIES=true`，意味着 `cosmovisor` 会自动下载升级提案指定的新二进制。如果 GitHub API 故障，下载会失败。建议保持该功能开启，但在升级前预加载并校验新二进制，以降低风险。如已预加载，将不会触发下载。更多内容请查看 [cosmovisor 自动下载说明](https://docs.cosmos.network/v0.47/build/tooling/cosmovisor#auto-download)。
+
+
+运行 `sudo systemctl daemon-reload` 以加载服务。
+
+运行 `sudo systemctl enable zetacored` 以设置开机自启，你应看到如下信息：
+
+```
+Created symlink /etc/systemd/system/multi-user.target.wants/zetacored.service → /usr/local/lib/systemd/system/zetacored.service.
+```
+
+## 下一步
+
+### 升级准备
+
+关注 Discord 上的 [#testnet-announcements](https://discord.com/channels/858516330432299008/1088945250124435486) 与 [#mainnet-announcements](https://discord.com/channels/858516330432299008/1210655572798476338) 获取升级提案通知。
+
+为升级做准备时，请从 GitHub Release 下载新二进制并放入 cosmovisor 升级目录，目录名称需与升级名称一致。升级名称**不是** GitHub 发布名称，可在 [治理升级提案页面](/reference/tools/proposals) 查阅。示例：
+
+| 升级名称 | `zetacored` 路径 | git tag |
+| -------- | ---------------- | ------- |
+| `v26` | `~/.zetacored/cosmovisor/upgrades/v26/bin/zetacored` | `v26.0.0` |
+| `v27` | `~/.zetacored/cosmovisor/upgrades/v27/bin/zetacored` | `v27.0.1` |
+
+安装完成后请：
+
+- 校验校验和
+- 运行 `zetacored version` 确认二进制可执行
+
+### 监控
+
+生产环境建议监控节点资源（CPU、内存、磁盘及 IO），以便及时发现性能下降。
+
+`zetacored` 会生成日志，可用于定位错误并排查问题。若按上述步骤配置为 Systemd 服务，可使用 `journalctl -eu zetacored` 查看日志。
+
+### 指标
+
+Prometheus 默认在 **26660** 端口提供指标，可由 Prometheus Collector 拉取。更多信息请参考 [Cosmos SDK Telemetry 文档](https://docs.cosmos.network/v0.50/learn/advanced/telemetry)。***
+
diff --git a/src/pages/nodes/start-here/syncing.mdx b/src/pages/nodes/start-here/syncing.en-US.mdx
similarity index 100%
rename from src/pages/nodes/start-here/syncing.mdx
rename to src/pages/nodes/start-here/syncing.en-US.mdx
diff --git a/src/pages/nodes/start-here/syncing.zh-CN.mdx b/src/pages/nodes/start-here/syncing.zh-CN.mdx
new file mode 100644
index 000000000..0a95ef642
--- /dev/null
+++ b/src/pages/nodes/start-here/syncing.zh-CN.mdx
@@ -0,0 +1,123 @@
+---
+title: 节点同步
+---
+
+import { Alert } from "~/components/shared";
+import { NodeSnapshots } from "~/components/Docs";
+
+
+ 本指南假设你已经完成[节点部署](/nodes/start-here/setup)。
+
+
+# 方案一：快照同步
+
+此方法会下载已备份的节点数据目录。
+
+选择网络与快照类型，将快照下载并解压至 `/home/zetachain/.zetacored`。
+
+## 下载最新全节点快照
+
+以下命令可下载并解压最新全节点快照：
+
+```bash
+# 安装 lz4
+sudo apt update && sudo apt install lz4 -y
+
+# 获取一次 JSON 响应
+SNAPSHOT_JSON=$(curl -s https://snapshots.rpc.zetachain.com/mainnet/fullnode/latest.json)
+
+# 提取链接与文件名
+SNAPSHOT_LINK=$(echo $SNAPSHOT_JSON | jq -r '.snapshots[].link')
+SNAPSHOT_FILENAME=$(echo $SNAPSHOT_JSON | jq -r '.snapshots[].filename')
+
+# 下载并解压快照
+sudo -u zetachain curl "$SNAPSHOT_LINK" -o "/home/zetachain/$SNAPSHOT_FILENAME" && \
+sudo -u zetachain lz4 -dc /home/zetachain/$SNAPSHOT_FILENAME | sudo -u zetachain tar -C /home/zetachain/.zetacored/ -xvf - && \
+sudo systemctl start zetacored
+```
+
+
+ **归档快照** 现已改为 **多分卷** 格式。你可以展开 **"Show Parts"** 分别下载，或复制提供的 **POSIX 下载脚本** 一键完成下载、合并与解压。只需点击分卷列表下方的 **“Copy to Clipboard”** 图标复制命令，并在终端执行即可。
+
+
+
+ 快照的数据库后端为 **pebbledb**。请确保节点使用相同后端，否则无法直接使用快照。
+
+
+#### 其他快照来源
+
+##### 主网：
+
+- https://polkachu.com/tendermint_snapshots/zetachain
+- https://app.nodejumper.io/zetachain/sync
+- https://itrocket.net/services/mainnet/zetachain/#snap
+
+##### 测试网：
+
+- https://app.nodejumper.io/zetachain-testnet/sync
+- https://itrocket.net/services/testnet/zetachain/#snap
+
+# 方案二：KYVE 的 KSYNC
+
+以下内容介绍如何使用 KSYNC 同步 ZetaChain 主网节点。
+
+KSYNC 可直接从去中心化的 KYVE 数据湖将区块与状态同步快照导入 Cosmos 节点。借助 KSYNC，Cosmos 验证人无需等待 P2P 节点同步，也无需手动查找可信 app hash；此外还可回溯至创世高度进行状态同步。
+
+更多信息：https://docs.kyve.network/ksync
+
+### 安装 KSYNC
+
+安装最新版本：
+
+```
+go install github.com/KYVENetwork/ksync/cmd/ksync@latest
+```
+
+检查安装：
+
+```
+ksync version
+```
+
+### 配置节点
+
+在 `config.toml` 中修改以下配置：
+
+```text filename="/home/zetachain/.zetacored/config/config.toml"
+db_backend = "goleveldb"
+```
+
+当前需将数据库后端改为默认的 goleveldb，因为 KSYNC 暂不支持 ZetaChain 依赖的 pebbledb（https://github.com/BlockPILabs/cosmos-db）。
+
+### 同步节点
+
+```
+ksync state-sync --binary="/path/to/zetacored" --chain-id=zetachain_7000-1 --snapshot-pool-id=11
+```
+
+# 节点健康检查
+
+### 查询节点状态
+
+可通过状态接口确认节点同步情况：
+
+```
+curl http://localhost:26657/status | jq
+```
+
+确保 `catching_up` 为 false，同时留意 `latest_block_height` 与 `latest_block_time`。
+
+### 查看日志
+
+可通过监控日志确认节点运行情况，日志中应持续输出如下 `INF` 信息：
+
+```
+4:10AM INF executed block height=3468229 module=state num_invalid_txs=1 num_valid_txs=24 server=node
+4:10AM INF commit synced commit=436F6D6D697449447B5B3139332032323120323438203430203230
+4:10AM INF committed state app_hash=C1DDF828CB4126E8239D92FB57006D978664911BF75FDB2606804083C4F65354 height=3468229
+4:10AM INF indexed block events height=3468229 module=txindex server=node
+4:11AM INF Timed out dur=4468.382473 height=3468230 module=consensus round=0 server=node step=1
+```
+
diff --git a/src/pages/nodes/validate/_meta.json b/src/pages/nodes/validate/_meta.en-US.json
similarity index 100%
rename from src/pages/nodes/validate/_meta.json
rename to src/pages/nodes/validate/_meta.en-US.json
diff --git a/src/pages/nodes/validate/_meta.zh-CN.json b/src/pages/nodes/validate/_meta.zh-CN.json
new file mode 100644
index 000000000..db4f3ab60
--- /dev/null
+++ b/src/pages/nodes/validate/_meta.zh-CN.json
@@ -0,0 +1,8 @@
+{
+ "validator": {
+ "title": "创建核心验证人"
+ },
+ "validator-gcp": {
+ "title": "在 Google Compute Engine 上部署核心验证人"
+ }
+}
diff --git a/src/pages/nodes/validate/validator-gcp.mdx b/src/pages/nodes/validate/validator-gcp.en-US.mdx
similarity index 100%
rename from src/pages/nodes/validate/validator-gcp.mdx
rename to src/pages/nodes/validate/validator-gcp.en-US.mdx
diff --git a/src/pages/nodes/validate/validator-gcp.zh-CN.mdx b/src/pages/nodes/validate/validator-gcp.zh-CN.mdx
new file mode 100644
index 000000000..d32376691
--- /dev/null
+++ b/src/pages/nodes/validate/validator-gcp.zh-CN.mdx
@@ -0,0 +1,391 @@
+---
+title: 在 Google Compute Engine 上部署核心验证人
+---
+
+本指南介绍如何在 Google Compute Engine（GCE）上快速部署 ZetaChain 验证人，帮助工程师迅速搭建节点，后续可根据自身需求扩展。
+
+## 概览
+
+准备如下资源：
+
+- 独立的服务账号
+- 一台 GCE 虚拟机
+- 建议：用于缓存关键文件的 Cloud Storage 存储桶
+- 建议：两个 Secret Manager 密钥，分别存放 keyring 密码与助记词
+
+### 服务账号
+
+服务账号需在项目中具备以下权限：
+
+- roles/storage.objectAdmin
+- roles/secretmanager.secretAccessor
+- roles/secretmanager.viewer
+- roles/secretmanager.secretVersionManager
+
+推荐使用专用服务账号，而非默认账号，以提升安全性。
+
+### GCE 实例
+
+示例配置：
+
+- n2-standard-4（4 核、16GB RAM）
+- Ubuntu 24.04
+- 20 GB 启动盘（“平衡型”持久磁盘）
+- 2 块 NVMe 磁盘（稍后组建 RAID）
+- 将[服务账号](https://cloud.google.com/compute/docs/access/service-accounts) 指定为验证人账号
+- 将服务账号访问范围设为允许访问所有 Cloud API
+- 设置 `enable-oslogin` 元数据为 `true`，启用 [OS Login](https://cloud.google.com/compute/docs/oslogin/set-up-oslogin)
+- 启用 [Shielded VM](https://cloud.google.com/compute/shielded-vm/docs/modifying-shielded-vm)
+
+以下 Terraform 配置可供参考（需按实际情况调整）。其中的 cloud-init 模板将使用如下值：
+
+- **chain_id：** athens_7001-1
+- **network：** athens3
+- **snapshot_host：** https://testnet-fullnode.snapshots.zetachain.com/
+- **snapshot：** fullnode-snapshot-v20-H7341468-2024-10-22_20-03.tar
+- **protocol_version：** v22
+- **node_version：** v22.0.0
+
+```
+locals {
+ moniker = "cw3-${var.env}-${var.zetachain_node_type}"
+ static_labels = {
+ chain-id = var.zetachain.chain_id
+ # 标记节点类型，便于同行发现。
+ node-type = var.zetachain_node_type
+ }
+ variable_labels = var.ops_agent_policy != "" ? map("goog-ops-agent-policy", var.ops_agent_policy) : {}
+}
+
+resource "google_compute_instance" "zetachain_node" {
+ name = var.name
+ project = var.project
+ machine_type = "n2-standard-4"
+ zone = var.zone
+
+ boot_disk {
+ initialize_params {
+ image = "projects/ubuntu-os-cloud/global/images/ubuntu-2404-noble-amd64-v20241004"
+ size = "20"
+ type = "pd-standard"
+ }
+ }
+
+ // 两块本地 NVME 磁盘
+ scratch_disk {
+ interface = "NVME"
+ }
+ scratch_disk {
+ interface = "NVME"
+ }
+
+ service_account {
+ email = var.service_account
+ scopes = ["https://www.googleapis.com/auth/cloud-platform"]
+ }
+
+ network_interface {
+ network = var.network
+
+ access_config {
+ // 临时公网 IP
+ }
+ }
+
+ labels = merge(local.variable_labels, local.static_labels)
+
+ metadata = {
+ user-data = templatefile(
+ "${path.module}/files/cloud-config.yaml.tmpl",
+ {
+ gcs_bucket_snapshots = var.gcs_bucket_snapshots
+ gcs_bucket_static = var.gcs_bucket_static
+ zetachain_chain_id = var.zetachain.chain_id
+ zetachain_network = var.zetachain.network
+ zetachain_snapshot_host = var.zetachain.snapshot_host
+ zetachain_snapshot = var.zetachain.snapshot
+ zetachain_version = var.zetachain.protocol_version
+ zetacored_version = var.zetachain.node_version
+ moniker = jsonencode(local.moniker)
+ }
+ )
+
+ enable-oslogin = "TRUE"
+ chain-id = var.zetachain.chain_id
+ }
+
+ shielded_instance_config {
+ enable_secure_boot = true
+ enable_integrity_monitoring = true
+ }
+}
+```
+
+我们使用 cloud-init 自动化节点初始化，具体内容如下。
+
+### Cloud Storage
+
+将二进制与快照缓存到 Cloud Storage，可避免依赖外部资源，并在恢复时缩短复制时间。建议使用[双区域](https://cloud.google.com/storage/docs/locations) 存储桶，并包含实例所在区域。
+
+### Secrets
+
+建议使用 Secret Manager 备份验证人助记词与 keyring 密码，以便恢复或自动化访问。
+
+## Cloud Init
+
+[cloud-init](https://cloud-init.io/) 负责安装链上软件，验证人密钥创建与质押仍需人工完成。
+
+初始化包含以下脚本（由 cloud-init 写入并执行）：
+
+1. 配置磁盘阵列
+2. 安装 Go
+3. 构建并安装 Cosmovisor
+4. 设置 ZetaChain 所需的系统限制
+5. 安装 zetacored
+6. 配置 zetacored 节点
+
+cloud-init 还会写入 `zetacored` 的 systemd 服务文件，并创建 `zetachain` 用户以运行节点软件。
+
+```
+#cloud-config
+
+package_update: true
+package_upgrade: true
+packages:
+- curl
+- git
+- jq
+- lz4
+- build-essential
+- unzip
+- mdadm
+
+users:
+ - name: zetachain
+ gecos: Zetachain
+ lock_passwd: true
+
+write_files:
+- path: /etc/systemd/system/zetacored.service
+ permissions: 0644
+ owner: root
+ content: |
+ [Unit]
+ Description=zetacored (running under Cosmovisor)
+ After=multi-user.target
+ StartLimitIntervalSec=0
+ [Install]
+ WantedBy=multi-user.target
+ [Service]
+ User=zetachain
+ ExecStart=/usr/local/bin/cosmovisor run start --home /var/lib/zetacored/ --log_format json --moniker ${moniker}
+ Restart=on-failure
+ RestartSec=3
+ WorkingDirectory=/var/lib/zetacored/cosmovisor
+ Environment="DAEMON_NAME=zetacored"
+ Environment="DAEMON_HOME=/var/lib/zetacored"
+ Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"
+ Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
+ Environment="DAEMON_DATA_BACKUP_DIR=/var/lib/zetacored"
+ Environment="UNSAFE_SKIP_BACKUP=true"
+ Type=simple
+ LimitNOFILE=262144
+
+- path: /usr/local/bin/setup-disk-array.sh
+ permissions: "0744"
+ content: |
+ #!/bin/bash
+ mdadm --create /dev/md0 --level=0 --raid-devices=2 /dev/nvme0n1 /dev/nvme0n2
+ mkfs.ext4 /dev/md0
+ mkdir -p /var/lib/zetacored
+ UUID=`sudo blkid -o value -s UUID /dev/md0`
+ echo "UUID=$UUID /var/lib/zetacored ext4 defaults 0 0" >> /etc/fstab
+ systemctl daemon-reload
+ mount /var/lib/zetacored
+
+- path: /usr/local/bin/configure-system-limits.sh
+ permissions: "0744"
+ content: |
+ #!/bin/bash
+ echo "* hard nproc 262144" >> /etc/security/limits.conf
+ echo "* soft nproc 262144" >> /etc/security/limits.conf
+ echo "* hard nofile 262144" >> /etc/security/limits.conf
+ echo "* soft nofile 262144" >> /etc/security/limits.conf
+ echo "fs.file-max=262144" >> /etc/sysctl.conf
+
+- path: /usr/local/bin/configure-zetacored.sh
+ permissions: "0744"
+ content: |
+ #!/bin/bash
+ CONFIG_TOML="/var/lib/zetacored/config/config.toml"
+ APP_TOML="/var/lib/zetacored/config/app.toml"
+
+ fetch_config () {
+ gsutil cp gs://${gcs_bucket_static}/network-config/${zetachain_network}/$1 /var/lib/zetacored/config/$1
+ if [ $? -eq 1 ]; then
+ wget https://raw.githubusercontent.com/zeta-chain/network-config/main/${zetachain_network}/$1 -O /var/lib/zetacored/config/$1
+ gsutil cp /var/lib/zetacored/config/$1 gs://${gcs_bucket_static}/network-config/${zetachain_network}/$1
+ fi
+ }
+
+ /usr/local/bin/zetacored init --home /var/lib/zetacored ${moniker} --chain-id ${zetachain_chain_id}
+
+ fetch_config app.toml
+ fetch_config client.toml
+ fetch_config config.toml
+ fetch_config genesis.json
+
+ external_address=$(wget -qO- eth0.me)
+ sed -i.bak -e "s/^moniker *=.*/moniker = \"${moniker}\"/" $CONFIG_TOML
+ sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $CONFIG_TOML
+
+ mkdir -p /var/lib/zetacored/cosmovisor/genesis/bin
+ mkdir -p /var/lib/zetacored/cosmovisor/upgrades
+ cp /usr/local/bin/zetacored /var/lib/zetacored/cosmovisor/genesis/bin/zetacored
+
+ gsutil cp gs://${gcs_bucket_static}/snapshot/${zetachain_network}/${zetachain_snapshot} /var/lib/zetacored/snapshot.tar
+ if [ $? -eq 1 ]; then
+ wget ${zetachain_snapshot_host}${zetachain_snapshot} -O /var/lib/zetacored/snapshot.tar
+ gsutil cp /var/lib/zetacored/snapshot.tar gs://${gcs_bucket_static}/snapshot/${zetachain_network}/${zetachain_snapshot}
+ fi
+
+ tar -xf /var/lib/zetacored/snapshot.tar -C /var/lib/zetacored
+ rm /var/lib/zetacored/snapshot.tar
+
+ /var/lib/zetacored/cosmovisor/genesis/bin/zetacored --home /var/lib/zetacored config keyring-backend file
+
+ chown -R zetachain:zetachain /var/lib/zetacored/config /var/lib/zetacored/cosmovisor /var/lib/zetacored/data
+
+ systemctl enable zetacored.service
+ systemctl start zetacored.service
+
+- path: /usr/local/bin/install-zetacored.sh
+ permissions: "0744"
+ content: |
+ #!/bin/bash
+ gsutil cp gs://${gcs_bucket_static}/binaries/${zetacored_version}/zetacored-linux-amd64 /usr/local/bin/zetacored
+ if [ $? -eq 1 ]; then
+ wget https://github.com/zeta-chain/node/releases/download/${zetacored_version}/zetacored-linux-amd64 -O /usr/local/bin/zetacored
+ gsutil cp /usr/local/bin/zetacored gs://${gcs_bucket_static}/binaries/${zetacored_version}/zetacored-linux-amd64
+ fi
+
+ mkdir -p /var/lib/zetacored/cosmovisor/genesis/bin
+ mkdir -p /var/lib/zetacored/cosmovisor/upgrades/${zetachain_version}/bin
+ cp /usr/local/bin/zetacored /var/lib/zetacored/cosmovisor/genesis/bin/zetacored
+ cp /usr/local/bin/zetacored /var/lib/zetacored/cosmovisor/upgrades/${zetachain_version}/bin/zetacored
+
+ chmod a+x /usr/local/bin/zetacored
+
+- path: /usr/local/bin/install-go.sh
+ permissions: "0744"
+ content: |
+ #!/bin/bash
+ GO_VERSION="1.20"
+ curl -L -O "https://golang.org/dl/go$GO_VERSION.linux-amd64.tar.gz"
+ sudo rm -rf /usr/local/go
+ sudo tar -C /usr/local -xzf "go$GO_VERSION.linux-amd64.tar.gz"
+ rm "go$GO_VERSION.linux-amd64.tar.gz"
+
+- path: /usr/local/bin/install-cosmovisor.sh
+ permissions: "0744"
+ content: |
+ #!/bin/bash
+ /usr/local/go/bin/go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.5.0
+ cp ~/go/bin/cosmovisor /usr/local/bin/
+
+runcmd:
+- sudo /usr/local/bin/setup-disk-array.sh
+- sudo /usr/local/bin/install-go.sh
+- sudo /usr/local/bin/install-cosmovisor.sh
+- sudo /usr/local/bin/configure-system-limits.sh
+- sudo /usr/local/bin/install-zetacored.sh
+- sudo /usr/local/bin/configure-zetacored.sh
+```
+
+## 验证人配置
+
+节点上线后仍需手动配置验证人。在部署前，务必通过日志高度与浏览器（如 [ZetaScan](https://zetascan.com/)）比较，确认节点已完全同步。
+
+关键步骤包括：
+
+1. 确认节点已同步
+2. 创建密钥
+3. 将助记词备份至 Secret Manager
+4. 将资金转入验证人钱包
+5. 链上质押创建验证人
+
+### 确认节点同步
+
+查看日志：
+
+```
+sudo -u zetachain journalctl -f -u zetacored.service
+```
+
+日志中应出现高度信息，例如：
+
+```
+Nov 06 22:32:53 athens3-us-south1-b-validator cosmovisor[485856]: {"level":"info","module":"server","server":"node","module":"state","height":7559702,"num_txs":4,"app_hash":"00A3F5A42D9D8C10D84447A6D085DFEB7D5CB9F62FB0A842F859C8529B2C3168","time":"2024-11-06T22:32:53Z","message":"committed state"}
+```
+
+### 创建/恢复密钥
+
+运行：
+
+```
+sudo /var/lib/zetacored/cosmovisor/current/bin/zetacored --home /var/lib/zetacored keys add operator --algo secp256k1
+```
+
+系统会提示输入 keyring 密码，并输出公钥与助记词。
+
+### 备份助记词
+
+使用 `umask 077` 确保新文件无多余权限，将助记词写入文件，再通过 gcloud 上传至 Secret Manager：
+
+```
+gcloud secrets versions add my-secret \
+ --data-file=seed_phrase.txt
+```
+
+### 转入资金
+
+查看新建密钥列表：
+
+```
+sudo /var/lib/zetacored/cosmovisor/current/bin/zetacored --home /var/lib/zetacored keys list
+```
+
+向该地址转入资金，并通过以下命令检查余额：
+
+```
+sudo /var/lib/zetacored/cosmovisor/current/bin/zetacored --home /var/lib/zetacored query bank balances $(/var/lib/zetacored/cosmovisor/current/bin/zetacored keys show operator -a)
+```
+
+### 质押创建验证人
+
+需提取 ED25519 公钥（与账户公钥不同），示例命令：
+
+```
+sudo -u mantrachain mantrachaind --home /var/lib/mantrachain tendermint show-validator | jq .key
+```
+
+随后发送创建交易，替换 `\` 与 `\`，并按需调整金额与链 ID：
+
+```
+sudo /var/lib/zetacored/cosmovisor/current/bin/zetacored --home /var/lib/zetacored tx staking create-validator \
+ --amount=1000000000000000000azeta \
+ --pubkey="{\"@type\":\"/cosmos.crypto.ed25519.PubKey\",\"key\":\"\"}" \
+ --moniker="" \
+ --chain-id=athens_7001-1 \
+ --commission-rate="1.00" \
+ --commission-max-rate="1.00" \
+ --commission-max-change-rate="0.01" \
+ --min-self-delegation="1000000" \
+ --gas="auto" \
+ --gas-adjustment=1.15 \
+ --gas-prices="1.0azeta" \
+ --from=operator
+```
+
+系统会要求输入 keyring 密码并确认交易，成功后验证人即在链上创建完成。***
+
diff --git a/src/pages/nodes/validate/validator.mdx b/src/pages/nodes/validate/validator.en-US.mdx
similarity index 100%
rename from src/pages/nodes/validate/validator.mdx
rename to src/pages/nodes/validate/validator.en-US.mdx
diff --git a/src/pages/nodes/validate/validator.zh-CN.mdx b/src/pages/nodes/validate/validator.zh-CN.mdx
new file mode 100644
index 000000000..f5af9b177
--- /dev/null
+++ b/src/pages/nodes/validate/validator.zh-CN.mdx
@@ -0,0 +1,159 @@
+---
+title: 创建核心验证人
+---
+
+import { Alert } from "~/components/shared";
+
+## 概述
+
+
+ 本指南假设你已完成[节点部署](/nodes/start-here/setup)，并通过任一方式同步完节点。
+
+
+本文为简化指南，不涵盖安全密钥管理的细节。请务必遵循业界最佳实践生成与管理密钥。超出 ZetaChain 验证人基础搭建范围的安全问题，官方无法提供支持。
+
+该流程需在运行验证人的账户下执行。若你按节点部署文档创建了 `zetachain` 用户，可通过以下命令切换：
+
+```bash
+sudo su -l zetachain
+```
+
+### 创建验证人账户
+
+创建 `operator` 账户，并妥善保存输出的助记词，后续访问账户时需要用到。
+
+```bash
+zetacored keys add operator --algo secp256k1
+```
+
+### 为验证人账户充值
+
+查询新账户余额，初始时 `balances` 应为空：
+
+```bash
+zetacored query bank balances $(zetacored keys show operator -a)
+```
+
+向验证人地址转入资金，可从个人钱包或交易所划转。务必使用 ZetaChain 的 Cosmos 网络，而非 EVM 网络。
+
+完成转账后再次检查余额：
+
+```bash
+zetacored query bank balances $(zetacored keys show operator -a)
+```
+
+### 创建验证人
+
+通过质押 **azeta** 代币创建验证人。以下示例针对 ZetaChain 主网 Beta，请根据需要调整。记下输出中的交易哈希。
+
+首先在 `~/validator.json` 中填入配置模板，并替换为你的实际信息：
+
+```text
+{
+ "pubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"EXAMPLE+F405Jcm2vXV+2v4fnjodh6aafuIdeoW+rUw="},
+ "amount": "1000000000000000000azeta",
+ "moniker": "myvalidator",
+ "identity": "验证人（可选）身份标识，如 UPort 或 Keybase",
+ "website": "验证人（可选）网站",
+ "security": "验证人（可选）安全联系邮箱",
+ "details": "验证人（可选）描述",
+ "commission-rate": "0.1",
+ "commission-max-rate": "0.2",
+ "commission-max-change-rate": "0.01",
+ "min-self-delegation": "1000000"
+}
+```
+
+- `amount`：计划绑定的代币数量
+- `moniker`：验证人名称
+- `commission-rate`：向委托人收取的区块奖励与手续费分成比例
+- `commission-max-rate`：最大佣金率，创建后不可修改
+- `commission-max-change-rate`：每日最大佣金增幅，创建后不可修改
+- `min-self-delegation`：验证人需保持的最低自委托 **azeta** 数量，若低于此值将被监禁并移出验证人集合
+- 佣金参数中的 `commission-max-change-rate` 表示佣金率的百分比“点”变化。例如从 1% 调整到 2% 属于增加 1 个百分点
+- `min-self-delegation` 必须是正整数，代表验证人必须始终维持的最小自委托投票权
+
+使用 `zetacored tendermint show-validator` 获取验证人公钥，并替换进 `validator.json`。
+
+最后执行创建交易，记录输出中的 txhash：
+
+```bash
+zetacored tx staking create-validator ~/validator.json \
+ --gas=10000000 \
+ --gas-prices=10000000000azeta \
+ --from=operator
+```
+
+---
+
+### 查看交易状态
+
+通过交易哈希查询日志，确认无错误。如出现错误，需排查后重新执行。
+
+```bash
+zetacored query tx
+```
+
+### 查看验证人状态
+
+查询验证人详情确认创建成功：
+
+```bash
+zetacored query staking validator $(zetacored keys show operator --bech val -a)
+```
+
+如果状态为 `status: BOND_STATUS_UNBONDED`，说明质押的 **azeta** 不足以进入活跃验证人集合。
+
+此时验证人不会签名出块，也无法获得奖励，但可以接受委托。
+
+使用以下命令追加委托，调整代币数量以满足最低质押要求。要进入前 100 名验证人（按投票权排序），截至 2025 年一季度大约需要 700 枚 ZETA。
+
+```bash
+zetacored tx staking delegate $(zetacored keys show operator --bech val -a) 2000000azeta \
+ --gas=10000000 --gas-prices=10000000000azeta --from operator
+```
+
+当累计质押达到要求后，验证人会自动进入活跃集合，状态变为 `status: BOND_STATUS_BONDED`。
+
+### 确认验证人运行状况
+
+验证人完成绑定后，可通过以下命令确认其已在验证人集合中，应返回你的验证人地址：
+
+```bash
+zetacored query tendermint-validator-set | grep $(zetacored tendermint show-address)
+```
+
+还可查看签名信息，确保 `missed_blocks_counter: "0"` 且 `index_offset` 持续增长：
+
+```bash
+zetacored query slashing signing-info $(zetacored tendermint show-validator)
+```
+
+### 备份验证人共识密钥
+
+默认情况下，验证人的共识密钥仅存储在节点本地。为防止意外数据丢失导致无法控制节点，请务必备份 `~/.zetacored/config/priv_validator_key.json`，并安全保存于节点以外的位置。
+
+### 解除监禁
+
+若验证人因长时间不同步（停机）而被监禁，可通过查询状态确认 `jailed: true`。当节点重新同步至最新高度后，执行以下命令解除监禁：
+
+```bash
+zetacored tx slashing unjail --from=operator
+```
+
+查询交易状态确保无误，并使用前文命令确认验证人已重新进入活跃集合。
+
+### 提取收益
+
+可使用以下命令提取奖励（含佣金）：
+
+```bash
+zetacored tx distribution withdraw-rewards --commission [validator_address]
+```
+
+如需将奖励发往其他地址，可配置提现地址：
+
+```bash
+zetacored tx distribution set-withdraw-addr [withdraw-addr]
+```
+
diff --git a/src/pages/reference/_meta.json b/src/pages/reference/_meta.en-US.json
similarity index 100%
rename from src/pages/reference/_meta.json
rename to src/pages/reference/_meta.en-US.json
diff --git a/src/pages/reference/_meta.zh-CN.json b/src/pages/reference/_meta.zh-CN.json
new file mode 100644
index 000000000..ff8f1643f
--- /dev/null
+++ b/src/pages/reference/_meta.zh-CN.json
@@ -0,0 +1,32 @@
+{
+ "index": {
+ "title": "工具"
+ },
+ "network": {
+ "title": "RPC 与合约"
+ },
+ "cli": {
+ "title": "CLI"
+ },
+ "localnet": {
+ "title": "本地网络"
+ },
+ "toolkit": {
+ "title": "工具包"
+ },
+ "registry": {
+ "title": "合约注册表"
+ },
+ "faucet": {
+ "title": "水龙头"
+ },
+ "explorers": {
+ "title": "区块浏览器"
+ },
+ "mcp": {
+ "title": "MCP"
+ },
+ "tools": {
+ "title": "更多工具"
+ }
+}
diff --git a/src/pages/reference/cli.mdx b/src/pages/reference/cli.en-US.mdx
similarity index 100%
rename from src/pages/reference/cli.mdx
rename to src/pages/reference/cli.en-US.mdx
diff --git a/src/pages/reference/cli.zh-CN.mdx b/src/pages/reference/cli.zh-CN.mdx
new file mode 100644
index 000000000..ae95ce567
--- /dev/null
+++ b/src/pages/reference/cli.zh-CN.mdx
@@ -0,0 +1,1265 @@
+# ZetaChain CLI
+
+一个用于构建与交互 [ZetaChain](https://www.zetachain.com) 全链应用的命令行工具。通过同一个 CLI 即可无缝操作 EVM、Solana、Bitcoin、Sui 与 TON。
+
+## ✨ 功能
+
+- 基于模板快速搭建新的 ZetaChain 全链应用
+- 一条命令启动涵盖 EVM、Solana 等多链的本地开发环境
+- 查询跨链手续费、合约、余额、跨链交易、代币等信息
+- 在 Solana、Sui、Bitcoin、TON 与 ZetaChain 全链应用之间发起跨链调用
+- 在已连接的链之间转移受支持的代币
+
+## ✅ 前置条件
+
+- Node.js ≥ 18
+- Git（用于克隆模板）
+- （可选）Docker ≥ 24，用于 `localnet`
+
+## 🚀 快速开始
+
+免安装运行：
+
+```bash
+npx zetachain@next new
+```
+
+或全局安装：
+
+```bash
+npm install -g zetachain@latest
+```
+
+若需体验最新功能，请使用 `zetachain@next`。
+
+## 📘 示例
+
+创建新项目：
+
+```bash
+zetachain new
+```
+
+启动本地网络：
+
+```bash
+zetachain localnet start
+```
+
+查询跨链余额：
+
+```bash
+zetachain query balances
+```
+
+## 🧭 CLI 参考
+
+查看完整命令文档：
+
+```bash
+zetachain docs
+```
+
+也可以在任意命令后使用 `--help`：
+
+```bash
+zetachain accounts --help
+```
+
+## 🤝 参与贡献
+
+欢迎贡献代码或反馈问题，随时提交 Issue 或 Pull Request。
+
+## 📚 延伸阅读
+
+- [ZetaChain 文档](https://www.zetachain.com/docs)
+- [CLI 文档](https://www.zetachain.com/docs/reference/cli/)
+- [加入 Discord](https://discord.gg/zetachain)
+
+## zetachain new
+
+```
+Usage: zetachain new [options]
+
+Create a new universal contract project.
+
+Options:
+ --verbose Enable verbose logging
+ --output Specify custom output directory or name
+ --project Specify the example project to use and skip the
+ prompt
+ -h, --help display help for command
+
+```
+
+## zetachain accounts
+
+```
+Usage: zetachain accounts [options] [command]
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ create [options] Create a new account
+ delete [options] Delete an existing account
+ import [options] Import an existing account using either a private key or a
+ mnemonic
+ list [options] List all available accounts
+ show [options] Show details of an existing account
+
+```
+
+## zetachain accounts create
+
+```
+Usage: zetachain accounts create [options]
+
+Options:
+ --type Account type (choices: "evm", "solana", "sui", "bitcoin",
+ "ton")
+ --name Account name (default: "default")
+ -h, --help display help for command
+
+```
+
+## zetachain accounts delete
+
+```
+Usage: zetachain accounts delete [options]
+
+Options:
+ --type Account type (choices: "evm", "solana", "sui", "bitcoin",
+ "ton")
+ --name Account name
+ -h, --help display help for command
+
+```
+
+## zetachain accounts import
+
+```
+Usage: zetachain accounts import [options]
+
+Import an existing account using either a private key or a mnemonic
+
+Options:
+ --type Account type (choices: "evm", "solana", "sui", "bitcoin",
+ "ton")
+ --name Account name (default: "default")
+ --private-key Private key in hex format
+ --mnemonic Mnemonic phrase
+ -h, --help display help for command
+
+```
+
+## zetachain accounts list
+
+```
+Usage: zetachain accounts list [options]
+
+Options:
+ --json Output in JSON format
+ -h, --help display help for command
+
+```
+
+## zetachain accounts show
+
+```
+Usage: zetachain accounts show [options]
+
+Options:
+ --type Account type (choices: "evm", "solana", "sui", "bitcoin",
+ "ton")
+ --name Account name
+ -h, --help display help for command
+
+```
+
+## zetachain query
+
+```
+Usage: zetachain query|q [options] [command]
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ balances [options] Fetch native and ZETA token balances
+ cctx [options] Query cross-chain transaction data in real-time
+ fees [options] Fetch omnichain and cross-chain messaging fees
+ tokens|t ZRC-20 token commands
+ chains|c Supported chains commands
+
+```
+
+## zetachain query balances
+
+```
+Usage: zetachain query balances [options]
+
+Options:
+ --evm Fetch balances for a specific EVM address
+ --solana Fetch balances for a specific Solana address
+ --bitcoin Fetch balances for a specific Bitcoin address
+ --sui Fetch balances for a specific Sui address
+ --ton Fetch balances for a specific TON address
+ --name Account name
+ --network Network to use (choices: "mainnet", "testnet", default:
+ "testnet")
+ --json Output balances as JSON
+ --show-zero Include zero balances (default: false)
+ -h, --help display help for command
+
+```
+
+## zetachain query cctx
+
+```
+Usage: zetachain query cctx [options]
+
+Query cross-chain transaction data in real-time
+
+Options:
+ -h, --hash Inbound transaction hash
+ -r, --rpc RPC endpoint (default:
+ "https://zetachain-athens.blockpi.network/lcd/v1/public")
+ -d, --delay Delay between polling rounds in milliseconds (default:
+ "2000")
+ -t, --timeout Timeout duration in milliseconds (default: indefinite)
+ (default: "0")
+ --help display help for command
+
+```
+
+## zetachain query fees
+
+```
+Usage: zetachain query fees [options]
+
+Fetch omnichain and cross-chain messaging fees
+
+Options:
+ --api API endpoint URL (default:
+ "https://zetachain-athens.blockpi.network/lcd/v1/public")
+ --rpc RPC endpoint URL (default:
+ "https://zetachain-athens-evm.blockpi.network/v1/rpc/public")
+ --gas-limit Gas limit for withdraw and call
+ --json Output results in JSON format
+ -h, --help display help for command
+
+```
+
+## zetachain query tokens
+
+```
+Usage: zetachain query tokens|t [options] [command]
+
+ZRC-20 token commands
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ list|l [options] List all ZRC-20 tokens
+ show|s [options] Show detailed information for a specific ZRC-20 token
+
+```
+
+## zetachain query tokens list
+
+```
+Usage: zetachain query tokens list|l [options]
+
+List all ZRC-20 tokens
+
+Options:
+ --api API endpoint URL (default:
+ "https://zetachain-athens.blockpi.network/lcd/v1/public")
+ --json Output tokens as JSON
+ --columns Additional columns to show (choices: "asset", "type",
+ "decimals", default: [])
+ -h, --help display help for command
+
+```
+
+## zetachain query tokens show
+
+```
+Usage: zetachain query tokens show|s [options]
+
+Show detailed information for a specific ZRC-20 token
+
+Options:
+ --api API endpoint URL (default:
+ "https://zetachain-athens.blockpi.network/lcd/v1/public")
+ --symbol -s Token symbol (e.g., POL.AMOY, USDC.BSC)
+ --field -f Return specific field value (for scripting). Use 'zrc20'
+ as shorthand for 'zrc20_contract_address'
+ --json Output token as JSON
+ -h, --help display help for command
+
+```
+
+## zetachain query chains
+
+```
+Usage: zetachain query chains|c [options] [command]
+
+Supported chains commands
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ list|l [options] List all supported chains
+ show|s [options] Show detailed information for a specific chain (by chain
+ name or chain ID)
+
+```
+
+## zetachain query chains list
+
+```
+Usage: zetachain query chains list|l [options]
+
+List all supported chains
+
+Options:
+ --api API endpoint URL (default:
+ "https://zetachain-athens.blockpi.network/lcd/v1/public")
+ --json Output chains as JSON
+ -h, --help display help for command
+
+```
+
+## zetachain query chains show
+
+```
+Usage: zetachain query chains show|s [options]
+
+Show detailed information for a specific chain (by chain name or chain ID)
+
+Options:
+ --api-testnet Testnet API endpoint URL (default:
+ "https://zetachain-athens.blockpi.network/lcd/v1/public")
+ --api-mainnet Mainnet API endpoint URL (default:
+ "https://zetachain.blockpi.network/lcd/v1/public")
+ --chain-name Chain name
+ -c, --chain-id Chain ID
+ --field -f Return specific field value (for scripting)
+ --json Output chain as JSON
+ -h, --help display help for command
+
+```
+
+## zetachain faucet
+
+```
+Usage: zetachain faucet [options]
+
+Request testnet ZETA tokens from the faucet.
+
+Options:
+ --address Recipient address.
+ --name Account name to use if address not provided (default:
+ "default")
+ -h, --help display help for command
+
+```
+
+## zetachain zetachain
+
+```
+Usage: zetachain zetachain|z [options] [command]
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ call [options] Call a contract on a connected chain from
+ ZetaChain
+ withdraw [options] Withdraw tokens from ZetaChain to a connected
+ chain
+ withdraw-and-call [options] Withdraw tokens from ZetaChain and call a
+ contract on a connected chain
+
+```
+
+## zetachain zetachain call
+
+```
+Usage: zetachain zetachain call [options]
+
+Options:
+ --zrc20 The address of ZRC-20 to pay fees
+ --receiver The address of the receiver contract on a
+ connected chain. Non-hex strings will be
+ automatically encoded to hex.
+ --name Account name (default: "default")
+ --chain-id Chain ID of the network
+ --private-key Private key for signing transactions
+ --rpc RPC URL of the network
+ --gateway Gateway contract address on ZetaChain
+ --revert-address Revert address (default:
+ "0x0000000000000000000000000000000000000000")
+ --abort-address Abort address (default:
+ "0x0000000000000000000000000000000000000000")
+ --call-on-revert Whether to call on revert (default: false)
+ --on-revert-gas-limit Gas limit for the revert transaction
+ (default: "1000000")
+ --revert-message Revert message (default: "0x")
+ --tx-options-gas-limit Gas limit for the transaction (default:
+ "1000000")
+ --tx-options-gas-price Gas price for the transaction (default:
+ "10000000000")
+ --call-options-gas-limit Gas limit for the call (default: "1000000")
+ --call-options-is-arbitrary-call Call any function (default: false)
+ --yes Skip confirmation prompt (default: false)
+ --function Function to call (example: "hello(string)")
+ --types List of parameter types (e.g. uint256
+ address)
+ --values Parameter values for the function call
+ --data Raw data for non-EVM chains like Solana
+ -h, --help display help for command
+
+```
+
+## zetachain zetachain withdraw
+
+```
+Usage: zetachain zetachain withdraw [options]
+
+Options:
+ --zrc20 The address of ZRC-20 to pay fees
+ --receiver The address of the receiver contract on a
+ connected chain. Non-hex strings will be
+ automatically encoded to hex.
+ --name Account name (default: "default")
+ --chain-id Chain ID of the network
+ --private-key Private key for signing transactions
+ --rpc RPC URL of the network
+ --gateway Gateway contract address on ZetaChain
+ --revert-address Revert address (default:
+ "0x0000000000000000000000000000000000000000")
+ --abort-address Abort address (default:
+ "0x0000000000000000000000000000000000000000")
+ --call-on-revert Whether to call on revert (default: false)
+ --on-revert-gas-limit Gas limit for the revert transaction
+ (default: "1000000")
+ --revert-message Revert message (default: "0x")
+ --tx-options-gas-limit Gas limit for the transaction (default:
+ "1000000")
+ --tx-options-gas-price Gas price for the transaction (default:
+ "10000000000")
+ --call-options-gas-limit Gas limit for the call (default: "1000000")
+ --call-options-is-arbitrary-call Call any function (default: false)
+ --yes Skip confirmation prompt (default: false)
+ --amount The amount of tokens to withdraw
+ -h, --help display help for command
+
+```
+
+## zetachain zetachain withdraw-and-call
+
+```
+Usage: zetachain zetachain withdraw-and-call [options]
+
+Options:
+ --zrc20 The address of ZRC-20 to pay fees
+ --receiver The address of the receiver contract on a
+ connected chain. Non-hex strings will be
+ automatically encoded to hex.
+ --name Account name (default: "default")
+ --chain-id Chain ID of the network
+ --private-key Private key for signing transactions
+ --rpc RPC URL of the network
+ --gateway Gateway contract address on ZetaChain
+ --revert-address Revert address (default:
+ "0x0000000000000000000000000000000000000000")
+ --abort-address Abort address (default:
+ "0x0000000000000000000000000000000000000000")
+ --call-on-revert Whether to call on revert (default: false)
+ --on-revert-gas-limit Gas limit for the revert transaction
+ (default: "1000000")
+ --revert-message Revert message (default: "0x")
+ --tx-options-gas-limit Gas limit for the transaction (default:
+ "1000000")
+ --tx-options-gas-price Gas price for the transaction (default:
+ "10000000000")
+ --call-options-gas-limit Gas limit for the call (default: "1000000")
+ --call-options-is-arbitrary-call Call any function (default: false)
+ --yes Skip confirmation prompt (default: false)
+ --amount The amount of tokens to withdraw
+ --function Function to call (example: "hello(string)")
+ --types List of parameter types (e.g. uint256
+ address)
+ --values Parameter values for the function call
+ --data Raw data for non-EVM chains like Solana
+ -h, --help display help for command
+
+```
+
+## zetachain evm
+
+```
+Usage: zetachain evm [options] [command]
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ call [options] Call a contract on ZetaChain from an
+ EVM-compatible chain
+ deposit-and-call [options] Deposit tokens and call a contract on ZetaChain
+ from an EVM-compatible chain
+ deposit [options] Deposit tokens to ZetaChain from an EVM-compatible
+ chain
+
+```
+
+## zetachain evm call
+
+```
+Usage: zetachain evm call [options]
+
+Options:
+ --chain-id Chain ID of the network
+ --receiver Receiver address on ZetaChain
+ --name Account name (default: "default")
+ --private-key Private key for signing transactions
+ --rpc RPC URL for the source chain
+ --gateway EVM Gateway address
+ --revert-address Address to revert to in case of failure
+ (default: signer address)
+ --abort-address Address to receive funds if aborted (default:
+ "0x0000000000000000000000000000000000000000")
+ --call-on-revert Whether to call revert address on failure
+ (default: false)
+ --on-revert-gas-limit Gas limit for revert operation (default:
+ "200000")
+ --revert-message Message to include in revert (default: "")
+ --gas-limit Gas limit for the transaction
+ --gas-price Gas price for the transaction
+ --yes Skip confirmation prompt (default: false)
+ --types List of parameter types (e.g. uint256 address)
+ --values Parameter values for the function call
+ -h, --help display help for command
+
+```
+
+## zetachain evm deposit-and-call
+
+```
+Usage: zetachain evm deposit-and-call [options]
+
+Options:
+ --chain-id Chain ID of the network
+ --receiver Receiver address on ZetaChain
+ --name Account name (default: "default")
+ --private-key Private key for signing transactions
+ --rpc RPC URL for the source chain
+ --gateway EVM Gateway address
+ --revert-address Address to revert to in case of failure
+ (default: signer address)
+ --abort-address Address to receive funds if aborted (default:
+ "0x0000000000000000000000000000000000000000")
+ --call-on-revert Whether to call revert address on failure
+ (default: false)
+ --on-revert-gas-limit Gas limit for revert operation (default:
+ "200000")
+ --revert-message Message to include in revert (default: "")
+ --gas-limit Gas limit for the transaction
+ --gas-price Gas price for the transaction
+ --yes Skip confirmation prompt (default: false)
+ --amount Amount of tokens to deposit
+ --erc20 ERC20 token address (optional for native token
+ deposits)
+ --types List of parameter types (e.g. uint256 address)
+ --values Parameter values for the function call
+ -h, --help display help for command
+
+```
+
+## zetachain evm deposit
+
+```
+Usage: zetachain evm deposit [options]
+
+Options:
+ --chain-id Chain ID of the network
+ --receiver Receiver address on ZetaChain
+ --name Account name (default: "default")
+ --private-key Private key for signing transactions
+ --rpc RPC URL for the source chain
+ --gateway EVM Gateway address
+ --revert-address Address to revert to in case of failure
+ (default: signer address)
+ --abort-address Address to receive funds if aborted (default:
+ "0x0000000000000000000000000000000000000000")
+ --call-on-revert Whether to call revert address on failure
+ (default: false)
+ --on-revert-gas-limit Gas limit for revert operation (default:
+ "200000")
+ --revert-message Message to include in revert (default: "")
+ --gas-limit Gas limit for the transaction
+ --gas-price Gas price for the transaction
+ --yes Skip confirmation prompt (default: false)
+ --amount Amount of tokens to deposit
+ --erc20 ERC20 token address (optional for native token
+ deposits)
+ -h, --help display help for command
+
+```
+
+## zetachain solana
+
+```
+Usage: zetachain solana [options] [command]
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ call [options] Call a universal contract on ZetaChain
+ deposit-and-call [options] Deposit tokens from Solana and call a universal
+ contract on ZetaChain
+ deposit [options] Deposit tokens from Solana
+ encode [options] Encode payload data for Solana
+
+```
+
+## zetachain solana call
+
+```
+Usage: zetachain solana call [options]
+
+Call a universal contract on ZetaChain
+
+Options:
+ --recipient EOA or contract address on ZetaChain
+ --mnemonic Mnemonic
+ --name Name of the wallet (default: "default")
+ --private-key Private key in base58 or hex format (with optional 0x prefix)
+ --chain-id Chain ID of the network
+ --revert-address Revert address
+ --abort-address Abort address (default: "0x0000000000000000000000000000000000000000")
+ --call-on-revert Call on revert (default: false)
+ --revert-message Revert message (default: "")
+ --on-revert-gas-limit On revert gas limit (default: "0")
+ --types List of parameter types (e.g. uint256 address)
+ --values Parameter values for the function call
+ -h, --help display help for command
+
+```
+
+## zetachain solana deposit-and-call
+
+```
+Usage: zetachain solana deposit-and-call [options]
+
+Deposit tokens from Solana and call a universal contract on ZetaChain
+
+Options:
+ --recipient EOA or contract address on ZetaChain
+ --mnemonic Mnemonic
+ --name Name of the wallet (default: "default")
+ --private-key Private key in base58 or hex format (with optional 0x prefix)
+ --chain-id Chain ID of the network
+ --revert-address Revert address
+ --abort-address Abort address (default: "0x0000000000000000000000000000000000000000")
+ --call-on-revert Call on revert (default: false)
+ --revert-message Revert message (default: "")
+ --on-revert-gas-limit On revert gas limit (default: "0")
+ --amount Amount of tokens to deposit
+ --token-program Token program (default: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA")
+ --types List of parameter types (e.g. uint256 address)
+ --values Parameter values for the function call
+ --mint SPL token mint address
+ -h, --help display help for command
+
+```
+
+## zetachain solana deposit
+
+```
+Usage: zetachain solana deposit [options]
+
+Options:
+ --recipient EOA or contract address on ZetaChain
+ --mnemonic Mnemonic
+ --name Name of the wallet (default: "default")
+ --private-key Private key in base58 or hex format (with optional 0x prefix)
+ --chain-id Chain ID of the network
+ --revert-address Revert address
+ --abort-address Abort address (default: "0x0000000000000000000000000000000000000000")
+ --call-on-revert Call on revert (default: false)
+ --revert-message Revert message (default: "")
+ --on-revert-gas-limit On revert gas limit (default: "0")
+ --amount Amount of tokens to deposit
+ --token-program Token program (default: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA")
+ --mint SPL token mint address
+ -h, --help display help for command
+
+```
+
+## zetachain solana encode
+
+```
+Usage: zetachain solana encode [options]
+
+Options:
+ --connected Connected PDA account address
+ --data Data to encode
+ --gateway Gateway program address
+ --mint Mint address for SPL token operations
+ --accounts Additional accounts in format 'address:isWritable'
+ -h, --help display help for command
+
+```
+
+## zetachain sui
+
+```
+Usage: zetachain sui [options] [command]
+
+Options:
+ -h, --help display help for command
+
+Commands:
+ deposit-and-call [options] Deposit tokens from Sui and call a contract on
+ ZetaChain
+ deposit [options] Deposit tokens from Sui
+ encode [options] Encode payload data for SUI
+
+```
+
+## zetachain sui deposit-and-call
+
+```
+Usage: zetachain sui deposit-and-call [options]
+
+Options:
+ --mnemonic Mnemonic for the account
+ --private-key Private key for the account
+ --gateway-object Gateway object ID
+ --gateway-package Gateway package ID
+ --receiver Receiver address on ZetaChain
+ --amount Amount to deposit in decimal format
+ --chain-id Chain ID
+ --coin-type Coin type to deposit (default:
+ "0x2::sui::SUI")
+ --gas-budget Gas budget in MIST (default: "10000000")
+ --name Account name (default: "default")
+ --decimals Number of decimals for the coin type
+ (default: "9")
+ --values Parameter values for the function call
+ --types List of parameter types (e.g. uint256
+ address)
+ -h, --help display help for command
+
+```
+
+## zetachain sui deposit
+
+```
+Usage: zetachain sui deposit [options]
+
+Options:
+ --mnemonic Mnemonic for the account
+ --private-key Private key for the account
+ --gateway-object Gateway object ID
+ --gateway-package Gateway package ID
+ --receiver