Next Injective Git（`igit`）

Next Injective Git 是去中心化代码协作平台：Git 对象存 IPFS，仓库元数据与 refs 记录在 Injective 链上的 CosmWasm 合约中。项目提供 CLI igit、Git remote helper git-remote-igit 和浏览器端 Web UI，可通过原生 Git 工作流或钱包完成链上协作。

igit init my-repo "hello chain"
igit push inj main
igit clone igit://alice/my-repo

当前状态：Injective testnet（injective-888） 已部署合约：inj1mg6x7ht3zyyszed9aq67q6kd0y5rtq7wf756jh。Clone / Fetch 已公开可用；Push 需要本地 Kubo 和 injectived，短期上传身份令牌由 igit.xyz 自动签发和刷新。

核心能力

Git 原生兼容：支持 push、clone、fetch、pull，也可直接使用 igit://owner/repo remote。
链上协作：仓库与 refs、协作者权限、所有权转移、内容治理均由 repo-registry 合约管理。
社区功能：支持用户名、Fork、项目赞助、收入分配与不可转让的贡献 Badge。
Web 浏览：直接从 Injective 和 IPFS 读取仓库、源码、提交、Diff、交易和 CID，无中心化应用后端。
多层持久化：US Kubo 保存全量 Pin，HK 提供大陆可达的热层网关，Fil.one 保存经过 SHA-256 校验的 CAR 归档。

架构一览

flowchart LR
  subgraph Client["客户端"]
    G["本地 Git\npush / clone / fetch"]
    H["git-remote-igit\nremote helper"]
    K["本地 Kubo\nloopback :5001\npush 临时块"]
    W["Web UI\n仓库 / 源码 / 交易浏览"]
  end

  subgraph Chain["Injective 控制面"]
    LCD["LCD smart query"]
    TX["Injective RPC\n客户端签名并广播交易"]
    C["repo-registry CosmWasm 合约\nrefs: commit SHA + pack_uris\n权限 / moderation"]
  end

  subgraph Data["IPFS 数据面"]
    R["US 受控复制服务\n短期 CID 绑定授权"]
    U["US Kubo\n全量 Pin"]
    HK["HK 只读网关 + Kubo\n热层缓存"]
    USG["US 只读网关"]
    PUB["公共 IPFS 网关\n最后回退"]
  end

  subgraph Archive["持久化归档"]
    I["US archive-indexer\n轮询链上 refs"]
    F["Fil.one\nCAR + SHA-256"]
  end

  G -->|"Git 命令"| H
  H -->|"push: pack-objects"| K
  K -->|"Swarm / Bitswap\n提供临时块"| U
  H -->|"scoped HTTPS\n授权 + replication 请求"| R
  R -->|"loopback Kubo RPC\npin + 校验"| U
  R -->|"Pin confirmed"| H
  H -->|"injectived: update_ref"| TX
  W -->|"钱包签名交易"| TX
  TX --> C

  H -->|"list_refs / resolve_ref"| LCD
  W -->|"仓库 / refs / 活动查询"| LCD
  LCD -->|"查询"| C
  H -->|"GET /ipfs/CID\n按健康度选路"| HK
  W -->|"GET /ipfs/CID"| HK
  HK -->|"packfile"| H
  H -.->|"HK 不可用时改走"| USG
  USG -->|"packfile"| H
  HK -.->|"miss / timeout"| PUB
  USG -.->|"miss / timeout"| PUB
  PUB -->|"packfile"| H
  H -->|"index-pack / checkout"| G

  I -->|"轮询 update_ref 交易"| C
  I -->|"pin 全部历史 CID"| U
  I -->|"CAR 导出 + 哈希校验"| F
  U -->|"durable CID 同步\n热层策略"| HK

  classDef client fill:#eef6ff,stroke:#3b82f6,color:#0f172a
  classDef chain fill:#fff7ed,stroke:#f97316,color:#0f172a
  classDef data fill:#ecfdf5,stroke:#10b981,color:#0f172a
  classDef archive fill:#f5f3ff,stroke:#8b5cf6,color:#0f172a
  class G,H,K,W client
  class LCD,TX,C chain
  class R,U,HK,USG,PUB data
  class I,F archive

Push 顺序：本地生成增量 pack → 本地 Kubo 临时 add → US 复制服务 Pin 并校验 pack SHA-256 → 客户端签名 update_ref 写入链上；链上确认后才回收临时块。
Clone / Fetch 顺序：先从合约读取 refs 与 pack_uris，再通过 HK 网关读取；按健康检查回退 US 网关，最后才使用公共网关。本地没有 Kubo 也能读取。
持久化职责：US Kubo 保存全量 Pin，archive-indexer 将链上引用的 pack 导出到 Fil.one CAR；HK 只做热层缓存，不承担写入确认。

目录结构

路径	说明
`contracts/repo-registry/`	CosmWasm 合约（Rust）：仓库、refs、权限、Fork、赞助、Badge 与用户名
`cli/`	Go：`igit`、`git-remote-igit` 与 US 受控复制服务
`web/`	React + Vite Web UI：仓库浏览、钱包交易、Injective / IPFS Explorer
`scripts/`	Testnet 部署、端到端测试、网关、复制、归档与监控脚本
`docs/`	架构、基础设施、安全决策与开放问题

快速开始

依赖

Clone / Fetch 只需要 Git、igit 和 git-remote-igit
从源码安装 CLI 时需要 Go 1.22+；发布版二进制不需要 Go
Node.js + npm（仅开发 Web UI）
Push 额外需要 Kubo 和 injectived；igit setup push 会安装经过 SHA-256 校验的锁定版本
编译合约需要 Rust 1.81.0 和 wasm32-unknown-unknown target；Injective VM 会拒绝新工具链生成的 reference-types / bulk-memory 指令
Windows 没有原生 injectived；Push 使用 WSL2 全家桶，不混用 Windows Git、WSL signer 和两套文件路径

1. 安装 CLI

Windows + WSL2（推荐）可从源码 checkout 一次完成 CLI、Kubo、injectived 和 testnet key 的安装：

powershell -ExecutionPolicy Bypass -File .\scripts\bootstrap-push.ps1 -Yes -CreateKey dev

首次注册 WSL 时脚本会创建普通 Linux 用户；默认名称来自 Windows 用户名，也可用 -LinuxUser alice 指定。

已有 WSL 发行版时，正式发布的 Windows igit.exe 也支持：

.\igit-windows-amd64.exe setup push --wsl Ubuntu-24.04 --yes --create-key dev

它会在 WSL2 中安装同版本 Linux CLI，并先用 release checksums.txt 校验 igit 和 remote helper。Linux 源码 checkout 可运行：

bash scripts/bootstrap-push.sh --yes --create-key dev

只开发或使用 Clone / Fetch 时仍可轻量安装：

cd cli
go install ./cmd/igit ./cmd/git-remote-igit
igit version
igit doctor --clone

igit 和 git-remote-igit 都必须在 PATH 中。若安装后找不到命令，请将 go env GOPATH 下的 bin 目录加入 PATH。

已有 CLI 的 Linux 用户可直接准备 Push 环境：

igit setup push                 # 交互确认，不覆盖可工作的现有工具
igit setup push --yes           # 非交互安装
igit setup push --no-kubo       # Kubo 由用户自行管理
igit setup upgrade --yes        # 强制刷新 igit 管理的锁定依赖
igit setup status               # 等价于完整 Push doctor

依赖版本、下载地址和 SHA-256 固定在 cli/internal/bootstrap/deps.json；托管文件位于 ~/.igit/deps 和 ~/.igit/bin。完整行为与排错见 Push 环境安装。

2. Clone 公开演示仓库

igit config set contract_address inj1mg6x7ht3zyyszed9aq67q6kd0y5rtq7wf756jh
igit clone igit://hny0305lin/demo-showcase

该流程只通过 LCD 和只读 HTTPS 网关访问 Injective / IPFS，不需要链上密钥、本地 Kubo 或上传授权。

3. 创建并 Push 仓库

若 setup 时没有使用 --create-key，先创建 testnet key。然后到 Injective testnet faucet 领取测试 INJ 作为 gas：

igit key new dev
igit key show                                  # 显示需要充值的 inj1... 地址

Push 使用受控复制服务。CLI 会从 https://www.igit.xyz/api/upload-authorization 自动取得十分钟有效的 Ed25519 身份令牌，并在过期前刷新；US 持久节点和 HK 热层节点的 Swarm 地址已经内置，无需手工复制 Token 或 Peer。

# setup 会初始化并在后台启动 Kubo；先确认所有硬性检查通过
igit doctor --push

# 创建链上仓库并推送现有本地仓库
igit init hello "my first on-chain repo"
REMOTE=$(igit clone-url hello)

cd my-project
igit remote add inj "$REMOTE"
igit push inj main

igit push / igit clone / igit pull 是对 git 的轻包装——你只用 igit 一个命令即可；原生 git push / git clone igit://... 同样有效（走 git-remote-igit 助手）。

从 GitHub 一键迁移现有仓库（全部分支 + tag 镜像上链）：

igit import github.com/user/repo          # 镜像到 igit://<你的地址>/repo
igit import github.com/user/repo my-name  # 自定义链上仓库名

常用链上协作命令

igit username register alice                    # 注册可读的 igit://alice/... 用户名
igit repos --all                                # 审计时包含 frozen/delisted 仓库
igit collab add hello inj1... maintainer         # 添加仓库维护者
igit fork <owner> <repo> [new-name]              # Fork 到自己的命名空间
igit sponsor <owner> <repo> 0.5 "great work"    # 赞助项目
igit badge award hello <recipient> "fixed CI"   # 颁发贡献 Badge
igit splits set hello <address>:2000             # 设置 20% 赞助收入分配

自行部署合约（维护者）

必须使用 Rust 1.81.0 编译链上 Wasm；Cargo.lock 已固定兼容依赖，请保留 --locked。

rustup toolchain install 1.81.0
rustup target add --toolchain 1.81.0 wasm32-unknown-unknown

cd contracts/repo-registry
cargo +1.81.0 test --locked
cargo +1.81.0 build --release --target wasm32-unknown-unknown --lib --locked

injectived tx wasm store target/wasm32-unknown-unknown/release/repo_registry.wasm \
  --from mykey --chain-id injective-888 \
  --node https://testnet.sentry.tm.injective.network:443 \
  --gas auto --gas-adjustment 1.4 --gas-prices 500000000inj --yes

# testnet 保留单签 admin 以便迁移；主网应改为多签 + 时间锁
ADMIN=$(injectived keys show mykey -a)
injectived tx wasm instantiate <CODE_ID> '{"admin":"'$ADMIN'"}' \
  --label igit-repo-registry --admin "$ADMIN" --from mykey ... --yes

也可用 scripts/testnet-deploy.sh <store交易hash> 完成 instantiate 和 CLI 配置；scripts/testnet-e2e.sh 用于真实 testnet + IPFS 端到端回归。

工作原理

push：git-remote-igit 生成增量 packfile → 本地 Kubo add?pin=false 临时加入并通过 Swarm 提供给 US → 受控复制服务确认 US Kubo 全量 Pin 且校验 pack SHA-256 → injectived 签名广播 update_ref。只有交易成功后才执行本地 IPFS GC；交易失败会保留临时块以便重试，US 未上链 Pin 按 TTL 回收。
clone/fetch：LCD 查询合约 list_refs / resolve_ref → 先探测 HK/US /healthz 并按延迟排序 → 仅通过 HTTPS GET /ipfs/<cid> 下载（失败再回退公共网关）→ git index-pack 注入本地对象库；本地没有 Kubo 也能完成。
权限：owner 可管理协作者（Maintainer 可推送、Reader 只读标记）、转移所有权；内容委员会（未设时为 admin）可设置 moderation_status，Frozen 状态下合约拒绝一切 ref 写入。

详细写入状态机和安全边界见目标拓扑与迁移方案；未决设计见开放问题。

开发

# 合约
cd contracts/repo-registry && cargo +1.81.0 test --locked

# CLI
(cd cli && go test ./... && go vet ./...)

# Acceptance fixtures (from the repository root)
bash scripts/feegrant-policy-gate-test.sh
bash scripts/feegrant-issue-test.sh
bash scripts/feegrant-record-push-test.sh
bash scripts/gateway-fallback-acceptance.sh
bash scripts/replication-reaper-test.sh
bash scripts/replication-config-check-test.sh
bash scripts/schedule-upgrade-test.sh
bash scripts/mainnet-governance-check-test.sh

# Web UI
cd web && npm ci && npm run build
# 本地开发：npm run dev

IPFS 网关与临时上传

CLI 默认健康探测香港 https://igit-hk.haohanyh.ovh 与美国 https://igit-us.haohanyh.ovh。读取不启动、不依赖本地 Kubo，按 /healthz 延迟排序后使用只读 HTTPS 网关，并继续回退公共 IPFS 网关。

igit gateway status                 # 查看两地健康和延迟
igit gateway select                 # 查看当前自动选路顺序

# Push 配置均有内置默认值；只有私有部署才需要覆盖。
igit config list

igit 只访问本机 Kubo RPC；HK/US Kubo 管理 API 从不暴露给普通用户。Push 会自动取得短期 identity token，再换取与 CID、仓库、ref、pack SHA-256 和有效期绑定的一次性 ticket；该 ticket 不能提交链上交易。显式的 upload.authorization、upload.us_peer 与 upload.hk_peer 仍可用于私有或离线部署，并可用 igit config unset <key> 清除。没有本地 Kubo 时，Clone / Fetch 仍然可用。

Release artifacts

The tag-based build and its current verification scope are documented in docs/release.md. Checksums are published to GitHub and can be registered immutably in repo-registry with scripts/register-release.sh; clients can verify a local artifact with igit release verify <version> <platform> <file>.

Contract upgrades are announced with igit upgrade schedule <wasm-sha256> and can be inspected with igit upgrade show. The contract enforces a 14-day delay and requires the same hash in the later migration transaction.

License

Apache-2.0

Name		Name	Last commit message	Last commit date
Latest commit History 71 Commits
.github/workflows		.github/workflows
cli		cli
contracts/repo-registry		contracts/repo-registry
docs		docs
injective-agent-skills		injective-agent-skills
scripts		scripts
web		web
.ci-check.jq		.ci-check.jq
.gitattributes		.gitattributes
.gitignore		.gitignore
.txlist.jq		.txlist.jq
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md

Navigation Menu

Repository files navigation

Next Injective Git（`igit`）

核心能力

架构一览

目录结构

快速开始

依赖

1. 安装 CLI

2. Clone 公开演示仓库

3. 创建并 Push 仓库

常用链上协作命令

自行部署合约（维护者）

工作原理

开发

IPFS 网关与临时上传

Release artifacts

License

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

Next Injective Git（igit）

核心能力

架构一览

目录结构

快速开始

依赖

1. 安装 CLI

2. Clone 公开演示仓库

3. 创建并 Push 仓库

常用链上协作命令

自行部署合约（维护者）

工作原理

开发

IPFS 网关与临时上传

Release artifacts

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Next Injective Git（`igit`）