> For the complete documentation index, see [llms.txt](https://cowgalaxy.gitbook.io/cowgalaxy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cowgalaxy.gitbook.io/cowgalaxy-docs/03-portal.md).

# 03 门户官网

门户（cowgalaxy.com）与三款游戏互补：用于 **钱包与个人中心、智能体授权、市场、活动、公测 XP、领资产和社交数据**。使用与游戏相同的钱包地址，资产与玩家身份才能正确对应。

## 顶栏菜单一览

| 菜单     | 页面                              | 做什么                                                                                                                         |
| ------ | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **公测** | 公测说明 `/beta`                    | 公测规则、空投口径（见 [04](/cowgalaxy-docs/04-beta.md)）                                                                               |
|        | 领取公测资产 `/betaAssets`            | 开服礼包（每地址一次）、每日补给（每 24 小时）                                                                                                   |
|        | 邀请赚积分 `/betaInvite`             | 邀请码、积分、等级、排行榜                                                                                                               |
|        | 今日 `/today`                     | 聚合牧场、征途、沙盒与联盟当天要做的事                                                                                                         |
|        | 反馈与社区                           | 跳转论坛发帖（默认「Bug 和问题反馈」分类）                                                                                                     |
| **游戏** | 传奇牧场 `/rangeland`               | 游戏介绍与入口、教程视频、排行榜                                                                                                            |
|        | 星际征途 `/trek`                    | 第二款游戏介绍与入口（**公测中**），进入游戏跳转 trek.cowgalaxy.com，玩法见 [星际征途](https://cowgalaxy.gitbook.io/cowgalaxy-docs/trek/zh)               |
|        | 星际沙盒 `/sandbox`                 | 第三款游戏介绍与入口（**Sepolia 公测中**），进入游戏跳转 sandbox.cowgalaxy.com，玩法见 [星际沙盒](https://cowgalaxy.gitbook.io/cowgalaxy-docs/sandbox/zh) |
| **市场** | IGO 创世盲盒 `/IGO`                 | 创世盲盒发售（USDT）                                                                                                                |
|        | 交易市场 `/nftMarket`               | 买卖牛 / 盲盒 / 星球（见 [02](/cowgalaxy-docs/02-market.md)）                                                                         |
|        | 游戏商店 `/gameStore`               | 小牛、皮肤盲盒用 USDT 购买（各 10 USDT），道具用 IRT 购买（道具有每日限量）                                                                             |
|        | 光轮集市 `/CattleMart`              | 光轮宝箱、碎片合成、开盒里程碑                                                                                                             |
|        | 星际挖矿 `/farm/interstellarmining` | USDT 存入链上池子，按份额分每日发放的 IRG                                                                                                   |
| **社区** | 我的好友 `/social/friends`          | 查看游戏好友列表、待处理申请、亲密度                                                                                                          |
|        | 我的星球 `/social/planet`           | 查看星球成员、公告、联邦星球；会长可改名 / 公告 / 图标                                                                                              |
|        | 排行榜 `/social/leaderboards`      | 常规榜单，以及公会战赛季、星港与征途首通的「荣誉墙」                                                                                                  |
| **更多** | Litepaper `/litepaper`          | 世界观、三款游戏、XP、空投与主网经济设计                                                                                                       |
|        | 玩家手册                            | 本手册                                                                                                                         |

兑换券中心 `/voucherCenter` 不在顶栏：在个人中心点击持有的券卡片即可进入兑换。空投 `/airdrop` 的入口在页脚。

年终质押与公会征集计划已于 2026-11 下线：主网不部署固定年化质押，邀请与推荐奖励只发游戏内道具、称号或 XP（口径见 Litepaper 第 7 节）。

***

## 连接钱包与签名登录

门户采用 Reown AppKit，支持两类常见方式：

1. **电脑浏览器扩展**：点击右上角「连接钱包」，选择 MetaMask 等已安装钱包。
2. **WalletConnect**：电脑端显示二维码后用手机钱包扫码；手机端也可直接唤起钱包或使用钱包内置浏览器。

公测请连接 **Sepolia**。公开页面可以不连钱包浏览；进入需要地址的页面或主动点击连接时才会加载钱包连接界面。若浏览器保留了上次连接，门户会尝试静默恢复。

连接地址与签名登录不是同一件事：

* **连接钱包**只让页面读取地址。
* **签名登录**用于公测资产、邀请 / XP、智能体授权及会长管理等账户数据；签名不上链、不花 gas。
* 门户登录默认有效 **7 天**，未过期会跨页面复用；切换地址或断开钱包会清除当前登录态。
* **approve、领取、兑换、挂单、成交**属于链上交易，钱包会显示网络、合约和 gas。

***

## 今日清单（`/today`）

「今日」把《传奇牧场》《星际征途》《星际沙盒》及联盟活动当天可做的事聚合在一页，并显示各分区与总清单的完成进度。

* 页面按 **UTC+8 零点**换日；清单本身采用零代币规则，**不会额外发放 IRG 或 IRT**。各玩法原有奖励仍按各自规则领取。
* 需要先连接钱包并完成签名登录，签名不上链、不花 Gas。若钱包地址已静默恢复，但浏览器里没有可复用的登录态，页面不会自动弹签名，而会显示「**签名查看**」按钮。
* 三款游戏主界面都有「**今日 n/m**」角标与本游戏面板；点「全部」可回到门户查看跨游戏完整清单。
* 「去完成」只打开对应游戏，门户不会代替你签到、开战、捐建或领取。

游戏内说明：[牧场日常](https://cowgalaxy.gitbook.io/cowgalaxy-docs/rangeland/zh/she-jiao-yu-ri-chang/10-daily) · [征途星图](https://cowgalaxy.gitbook.io/cowgalaxy-docs/trek/zh/02-star-map) · [沙盒奖励与今日](https://cowgalaxy.gitbook.io/cowgalaxy-docs/sandbox/zh/09-pending-and-claiming)

***

## 荣誉墙与资料徽标

在「社交 → 排行榜 → 荣誉墙」可查看牧场公会战已结算赛季终榜、沙盒星港榜和征途星座首通榜。赛季冠军、赛季上榜、星港建设与星座首通等荣誉也会汇总为个人资料页徽标；它们是结果展示，不会由门户重复发奖。牧场赛季规则见 [公会战](https://cowgalaxy.gitbook.io/cowgalaxy-docs/rangeland/zh/zhan-dou-yu-gong-hui/08-guild-battle)。

***

## 个人中心与 NFT 详情（`/profile`）

从右上角钱包菜单进入「我的钱包」。侧栏包括 **账户、NFT、亲密关系、智能体授权**；「我的挂单」在钱包下拉菜单与市场页中。

* NFT 按游戏分组：牧场的星球 / 牛牛 / 盲盒 / 租赁 / 徽章 / 皮肤 / 道具，征途道具，沙盒星座坐标 / 材料 / 模块，以及其他头像和兑换券。
* NFT 详情页按资产能力显示属性、父母、星级、寿命，以及 **出售、转账、开盒、租赁**中的可用操作；没有按钮通常表示该资产不支持该操作。
* 普通牛的转移与交易限制、哪些资产尚未接入市场，见 [02](/cowgalaxy-docs/02-market.md)。
* **星球租赁**（`/cardPackage/PanletLease`）：家园会长把会长权按月出租，承租人付租续租，见 [星球与公会](https://cowgalaxy.gitbook.io/cowgalaxy-docs/rangeland/zh/zhan-dou-yu-gong-hui/07-guild)

***

## 智能体授权（个人中心）

官方 Telegram **AI 战斗智能体 CowGalaxy Play** 当前只接入《星际征途》。使用流程：

1. 先在「公测 → 邀请赚积分 → 关注官方渠道」绑定 Telegram。
2. 在个人中心打开「智能体授权」，创建 **智能体钥匙（Agent Key）**，授权《星际征途》并允许 CowGalaxy Play 使用。
3. 设置每日 AI 出战场次与 7 / 30 / 90 天有效期；当前每个钱包最多同时保留 **10 把有效钥匙**。
4. 在 Telegram 打开 CowGalaxy Play，发送 `/play`，选择据点与小队后召唤 AI 出战。

创建钥匙时，钱包会签一条写明地址、游戏、权限、每日上限和有效期的授权文案；它不是链上交易。权限边界：

* Agent Key **只能指挥战斗**。领取掉落、邮件附件、旗舰升级、转让和任何链上操作仍须由玩家钱包签名。
* AI 出战期间网页端暂时只读；战斗结束后自动恢复，同一账号同一时刻只能进行一场战斗。
* 官方 CowGalaxy Play 通过已绑定的 Telegram 识别玩家，**不需要钥匙明文**。
* 钥匙明文只在创建时显示一次，门户只保存哈希。只有使用自己的第三方 AI Agent 时才需要保存并配置明文。
* 可随时吊销并查看登录、开战、结束与吊销记录；每日场次按 UTC+8 零点重置。

***

## 星际挖矿（`/farm/interstellarmining`）

把 USDT 存入链上池子，按存入份额分得每日发放的 IRG，随存随取。每日发放量固定为 **2,400,000 IRG**，不随池子规模或币价调整；页面展示的「每日发放 IRG」直接读链上参数。门户不展示年化或收益率，主网规则随主网合约一并生效。

***

## 限时购盒与集市

| 页面       | 内容                                                                                                                                                                   |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **IGO**  | 创世盲盒：白名单 100 USDT、公售 150 USDT，总量 1800（白名单 600 / 公开 1,200）；开出创世牛 / 普通牛 / 道具礼包 / 皮肤礼包                                                                                  |
| **光轮集市** | 光轮宝箱 5 USDT / 个，总量 20000；开出行星碎片 / 集市盲盒 / 小牛券 / 创世券；碎片可合成小牛、创世、家园星球，未命中改发链上配置的消耗道具，不再发放 IRG；每日 FOMO 奖池已关闭，改为按个人累计开盒数领取里程碑奖励（每档每地址一次）；推荐关系只记录在链上，奖励由游戏侧发道具或 XP，不返 USDT |

各类盒子能开什么、几率多少，见 [**盲盒能开什么**](https://cowgalaxy.gitbook.io/cowgalaxy-docs/rangeland/zh/bang-zhu/13-blind-box)。开出的券在个人中心点击券卡片进入 **兑换券中心** 换成资产。

***

## 兑换券中心与游戏商店

* **游戏商店**：小牛、皮肤盲盒各 10 USDT（收入进协议国库，按回购规则部分用于回购销毁），生命药剂、体力包、成长包用 IRT 购买并销毁，价格与游戏内道具商店一致；小牛不限量，道具有全服每日限量，次日补满
* **兑换券中心**：持有的券（含集市开出的光轮 / 创世 / 小牛券）一键兑换成对应资产；每张券的 IRT 手续费按合约配置读取（当前为 0 即免费）；成年牛券与小牛券不能同时兑换
* 兑换需先对券合约授权；兑出的道具去游戏背包使用，兑出的牛要放回牛栏

***

## 空投（`/airdrop`）

这是按官方公告的活动名单领取代币 / NFT 的通用页面：可搜索钱包地址、查看批次并领取；每期活动的开放与截止时间以列表中的「活动」为准，逾期不再补发。入口在页脚。

**公测 XP 主网空投是另一套计划，不在本页结算**：总额 1,500 万 IRT，按交互分 60% / 反馈分 20% / 社区分 20% 计算份额，单地址上限 0.05%（7,500 IRT）；门槛为公测期间活跃 ≥ 10 天且 10 个游玩维度中至少 4 个有分；主网上线后以 Merkle 证明领取，领取后锁仓：TGE 解锁 10%，其余 12 个月线性释放，领取期 90 天。不要把当前空投页面是否有名单当成公测资格结果；详见 [04](/cowgalaxy-docs/04-beta.md)。

***

## 论坛与反馈（bbs.cowgalaxy.com）

论坛使用同一个钱包签名登录，支持游戏讨论、版本规划、Bug 反馈、回复与站内提醒。门户「公测 → 反馈与社区」会直接打开「Bug 和问题反馈」发帖页。

* 「Bug 和问题反馈」不是公开广场：帖子和回复只对作者与管理员可见。
* 发帖请写清页面、复现步骤、预期 / 实际结果、钱包地址和必要截图；不要发布私钥或助记词。
* 同一地址两次发帖至少间隔 30 秒、回复至少间隔 10 秒。

公测反馈如何进入 XP 与空投计划，见 [04](/cowgalaxy-docs/04-beta.md)。

***

## 使用门户的通用步骤

1. 确认域名是 `cowgalaxy.com`，连接与游戏相同的钱包地址
2. 切换到页面要求的网络；公测通常为 Sepolia
3. 先判断钱包请求是「登录签名」「授权」还是「交易」
4. 需要时授权代币 / NFT，再确认具体交易内容与 gas
5. 等待链上确认；门户索引通常还会等待少量区块，列表可能稍后更新
6. 回到游戏客户端刷新或重新登录查看资产

相关：市场细节 → [02](/cowgalaxy-docs/02-market.md)；公测与邀请 → [04](/cowgalaxy-docs/04-beta.md)；开奖几率 → [盲盒能开什么](https://cowgalaxy.gitbook.io/cowgalaxy-docs/rangeland/zh/bang-zhu/13-blind-box)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cowgalaxy.gitbook.io/cowgalaxy-docs/03-portal.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.