iaiamaga/social-forests-protocol

## 🌍 使命：可编程繁荣 大多数可持续性承诺仅停留在营销层面。我们构建的是使其可验证的基础设施。 **社会森林将可持续性民主化**，将日常消费与真实的环境再生连接起来。在合作伙伴品牌花费的每一美元都会成为生物遗产——一棵活生生的非洲桃花心木树（*Khaya senegalensis*）的一部分，锚定在 Stellar 区块链上，归创造它的人所有。 我们将这种模式称为 **RWA 即服务 (RWAaaS)**：公司不投资资产——他们使用我们的基础设施向客户分发再生性返现。消费者累积 $LEAF 代币并**铸造一个 dNFT** ——一个代表真实生长树木所有权的动态 NFT。**树属于铸造它的人。** ## ⚙️ 运作原理：核心循环 | 参与者 | 行动与价值主张 | |--------|----------------| | 🏢 **公司 (B2B)** | 通过 x402 USDC 支付进入，购买 RWA 份额（真实的 Mogno 树木），并获得可验证的 ESG 影响。向其客户分发 $LEAF 代币作为“绿色返现”。 | | 🛰️ **预言机 (PoF)** | AI 和卫星数据验证物理世界中的生物量和碳水平。通过 `process_oracle_report` 将生长数据注入 dNFT。 | | 🌱 **消费者 (B2C)** | 从合作品牌获得 $LEAF 代币。累积叶子并**铸造一个 dNFT** ——一个代表真实非洲桃花心木树的动态 NFT，随着物理树木的生长而在链上生长。 | ### dNFT 的旅程 ``` Company buys RWA → Protocol mints $LEAF → Consumer earns $LEAF ↓ Consumer burns $LEAF → Forges dNFT (Tier 1) ↓ Oracle feeds growth data → dNFT evolves ↓ Consumer merges dNFTs → Higher Tier (Rare → Epic → Legend) ``` 每个 **dNFT** 都是由真实树木支持的活数字资产。它跟踪生物量、碳封存和生物阶段——所有这些都由 Proof of Flourishing 预言机在链上验证。 ## 🏗 架构——智能合约 (Soroban) 部署在 Stellar Soroban 上的六个模块化 Rust 合约（SDK v26.0.0）： | 合约 | 角色 | 状态 | |------|------|------| | `leaf_token` | **$LEAF 代币 (SEP-41)。** 可铸造/销毁/转移的可替代代币。供应上限为 10 亿。两步管理员转移。TTL 管理的余额。 | ✅ 测试网 | | `guardian_id` | **消费者 SBT。** 灵魂绑定的声誉代币 —— 经验值、等级 (1-50)、7 个生物时代。不可转让。 | ✅ 测试网 | | `company_id` | **公司 SBT。** 机构身份—— C-Cred 余额、C-Debt、ODS 徽章、Vereda 验证。 | ✅ 测试网 | | `collateral_vault` | **DeFi 市场。** 管理实物库存（幼苗）、公司间的 C-Cred 交易、债务结算。 | ✅ 测试网 | | `forest_mythos_vault` | **dNFT 引擎。** 代表真实树木的动态 NFT —— 铸造、锻造（合并）、预言机生长报告、90 天反翻转锁定、层级进化。 | ✅ 测试网 | | `journey_orchestrator` | **指挥家。** 编排所有合约—— B2B 接入、B2C 植树、锻造神话。复杂流程的单入口点。 | ✅ 测试网 | ### 合约交互图 ``` ┌─────────────────────────┐ │ journey_orchestrator │ │ (Maestro) │ └──────┬──────┬──────┬────┘ │ │ │ ┌────────────┘ │ └────────────┐ ▼ ▼ ▼ ┌────────────────┐ ┌──────────────┐ ┌─────────────────┐ │ leaf_token │ │ guardian_id │ │ forest_mythos │ │ ($LEAF) │ │ (XP/SBT) │ │ (dNFT Engine) │ └────────────────┘ └──────────────┘ └─────────────────┘ ▲ │ ┌────────────────┐ ┌──────────────┐ │collateral_vault│──────▶│ company_id │ │ (DeFi/C-Cred) │ │ (SBT Empresa)│ └────────────────┘ └──────────────┘ ``` ## 🛡 技术栈 | 层 | 技术 | |----|------| | 智能合约 | Rust · soroban-sdk 26.0.0 · `#![forbid(unsafe_code)]` | | 区块链 | Stellar Soroban (测试网) | | 支付 | x402 协议 (Stellar 上的 USDC) 通过 OpenZeppelin Facilitator | | RWA 桥 | Etherfuse Stablebonds *(存根——进行中)* | | 前端 | Next.js 16 · React 19 · TailwindCSS 4 · Framer Motion | | 钱包 | Freighter API v6 | | CI/CD | GitHub Actions (cargo test, WASM 构建, gitleaks, Next.js 构建) | ## 🔐 安全模型 | 功能 | 实现 | |------|------| | 管理员转移 | 两步 `propose_admin` → `accept_admin` (leaf_token) | | 供应上限 | MAX_SUPPLY = 10 亿 LEAF (链上强制执行) | | 灵魂绑定强制 | `transfer()` 因 `SoulboundToken` 错误而 panic (guardian_id) | | 反翻转锁定 | 第一阶段 dNFT 90 天转移锁定 (forest_mythos_vault) | | 预言机认证 | API 密钥头 (`X-Oracle-Api-Key`) + 仅服务器端密钥 | | x402 重放保护 | 内存中支付哈希去重 + TTL | | 初始化保护 | 所有合约在双重初始化时 panic + 管理员要求 auth | | 密钥扫描 | CI 管道中的 gitleaks | | 不安全代码 | 所有 6 个合约上的 `#![forbid(unsafe_code)]` | ## 💳 x402 支付流程 该协议使用 [x402 协议](https://www.x402.org/) 在 Stellar 上进行 HTTP 原生 USDC 支付： ``` Client → GET/POST endpoint → 402 Payment Required (with price + payTo) Client → Signs Soroban auth entry via Freighter Client → Re-sends request with X-Payment-Signature header Server → Facilitator verifies + settles on-chain Server → Returns prepared Soroban transaction XDR Client → Signs + submits the contract call ``` **受保护端点：** | 端点 | 价格 | 动作 | |------|------|------| | `POST /api/v1/x402/plant-tree` | 0.01 USDC | 销毁 LEAF → 铸造 dNFT → 奖励经验值 | | `POST /api/v1/x402/forge-mythos` | 0.05 USDC | 将 dNFT 合并为更高层级 | | `GET /api/v1/x402/rwa-data/[id]` | 0.001 USDC | 返回 dNFT 遥测数据 | ## 🌐 API 路由 | 路由 | 方法 | 用途 | |------|------|------| | `/api/v1/x402/plant-tree` | POST | x402 保护的植树 | | `/api/v1/x402/forge-mythos` | POST | x402 保护的 dNFT 锻造 | | `/api/v1/x402/rwa-data/[id]` | GET | x402 保护的 RWA 遥测 | | `/api/v1/oracle/report` | POST | 预言机注入生物量/碳数据（API 密钥认证） | | `/api/v1/distribute` | POST | 公司创建返现活动 + 二维码 | | `/api/v1/etherfuse` | POST | Etherfuse RWA 注册 webhook *(存根)* | | `/api/v1/resgate` | POST | 消费者兑换二维码获取 LEAF *(模拟)* | ## 🔑 环境变量 从 `.env.example` 创建 `.env.local`： | 变量 | 范围 | 描述 | |------|------|------| | `NEXT_PUBLIC_X402_PAY_TO` | 客户端 | 接收 x402 USDC 付款的 Stellar 地址 | | `NEXT_PUBLIC_X402_FACILITATOR_URL` | 客户端 | OpenZeppelin facilitator 端点 | | `X402_FACILITATOR_API_KEY` | 服务器 | x402 facilitator 的 API 密钥 | | `ORACLE_SECRET_KEY` | 服务器 | 预言机交易的 Stellar 密钥 | | `ORACLE_API_KEY` | 服务器 | 预言机端点认证的 API 密钥 | | `NEXT_PUBLIC_APP_URL` | 客户端 | 应用程序的基础 URL | ## 📍 合约地址（测试网） | 合约 | 地址 | |------|------| | leaf_token | `CDSK3UIEDWWLECIJ4IKEGSAK55IRPNNYOBSZ5QN4ZMOX3DL5SBKUYGPB` | | guardian_id | `CATUQHSIINJTJGIMSROVY47M2IJI2HDTQ2COXGI43Z4UNXQQXIW7WYEB` | | company_id | `CACWQXW5HTNUQBNCWAU62HWQCSBZO6FI2CISPHBMKDAF4NFWNYC35WOK` | | collateral_vault | `CAW55PMUSPCJYG3U66M4O544XHDH62YTPDN2GIIFXBR7LRS5Q333X76K` | | forest_mythos_vault | `CC3E5J47FPV7HZKSX3XE2Z6Y6X7VFC36HUYHGTC4NP3HMCOESPG7JP55` | | journey_orchestrator | `CDYBW7E33UT73BFVE73K6CWRCWK33O7DHCMZC6Z4HU2BX635ONPD7T6D` | **主网：** 待定——等待安全审计完成。 ## 🚀 快速开始 ``` # anslated as "构建", and "contracts" kept as "contracts" or translated. To be safe, I'll translate the verbs and keep nouns that are technical. rustup target add wasm32v1-none cargo install stellar-cli # But let's see the user's input: after "Frontend", it has "Pré-requisitos" which is Portuguese, so I need to translate that to Chinese as well. git clone https://github.com/G0vermind/social-forests-protocol.git cd social-forests-protocol # The user said: "Translate each of the following headings to Simplified Chinese." So all headings should be in Chinese, but with technical terms in English. make build # Now, for the Portuguese headings: "Pré-requisitos" is the same as "Prerequisites" in Portuguese, so I should translate it to Chinese. Similarly, "Clone e instalação" is "Clone and installation", "Build de todos os contratos" is "Build all contracts", "Testes" is "Tests". make test # So, I need to provide translations for all 10 lines. cd apps/web cp .env.example .env.local # Fill in your values npm install npm run dev # → http://localhost:3000 ``` ## 🗺 路线图 | 阶段 | 状态 | 里程碑 | |------|------|--------| | **第一阶段——种子** | 🔨 构建中 | 测试网上的 6 个模块化合约 · x402 支付集成 · 预言机 API · B2C 游戏化（经验值/时代） · dNFT 锻造 · Viveiro Maravilha “零号客户” | | **第二阶段——生长** | 🔜 已计划 | 主网上的 AI Vision 预言机 · Etherfuse Stablebond 集成 · 账户抽象（Google 登录） · $FLORA 治理合约 · Sómogno 集成 · 多签管理员 | | **第三阶段——规模化** | 🔜 已计划 | 二级 RWA 市场 · DAO 过渡 · C-Cred AMM · Pecém 港口出口 · 完全机构接入 · 主网部署 | ## 🌱 联合国可持续发展目标对齐 | 可持续发展目标 | 贡献 | |----------------|------| | **1 & 2** | 农村收入多样化（间作养蜂）；粮食安全 | | **5** | 资产管理中的性别平等；农村妇女的自主 Stellar 钱包 | | **8** | 塞阿拉州内陆的体面工作；DeFi 基础设施创新 | | **9** | 自然资产数字化；开放的 NbS 基础设施 | | **12** | 再生性返现模式；负责任消费和生产 | | **13** | 碳封存；巴黎协定 + 昆明-蒙特利尔框架对齐 | | **15** | 森林管理和生物多样性保护 | ## 👥 核心团队——网络编织者 - **Gustavo Gonçalves** · `创始人兼技术负责人` ([LinkedIn](https://www.linkedin.com/in/gustavo-gon%C3%A7alves-9a4a1523/) · [GitHub](https://github.com/G0vermind)) - **Vinicius Braz Rocha** · `ReFi 架构师` ([LinkedIn](https://www.linkedin.com/in/vrselfmedia/) · [GitHub](https://github.com/glocalVR)) - **Clarkson Luiz Buriche** · `环境开发与 AI` ([LinkedIn](https://www.linkedin.com/in/clarkson-luiz-buriche-bartalini-80446a6b/) · [GitHub](https://github.com/catitodev)) - **Iara Magalhães** · `Web3 开发者` ([LinkedIn](https://www.linkedin.com/in/iaiakedemy) · [GitHub](https://github.com/iaiamaga)) ### 顾问——守护者委员会 - **Francisco das Chagas Rosa** · `农学顾问` - **Patricia Lemos** · `法律顾问` ## ⚡ [RE]³ — ReReGeneradora：第一个减速器 - **Pedro Bruder** · `[RE]³ 顾问` ([LinkedIn](https://www.linkedin.com/in/pedrobruder) · [GitHub](https://github.com/BasedCaveman)) - **Vinícius Braz Rocha** · `[RE]³ 顾问兼协议联合发起人` ([LinkedIn](https://www.linkedin.com/in/vrselfmedia/) · [GitHub](https://github.com/glocalVR)) - **Enzo Garcia** · `[RE]³ 顾问` ([LinkedIn](https://www.linkedin.com/in/enzo-garcia-295066316) · [GitHub](https://github.com/F0rtyF0ur))


## 🌍 使命：可编程繁荣 大多数可持续性承诺仅停留在宣传层面。我们构建的是使其可验证的基础设施。 **社会森林将可持续性民主化**，将日常消费与真实的环境再生连接起来。在合作品牌花费的每一雷亚尔都会成为生物遗产——一棵活生生的非洲桃花心木树（*Khaya senegalensis*）的一部分，锚定在 Stellar 区块链上，归赢得它的人所有。 我们称之为 **RWA 即服务 (RWAaaS)**：公司不“投资”资产——他们使用我们的基础设施向客户分发再生性返现。消费者累积 $LEAF 代币并**铸造一个 dNFT** ——一个代表真实生长树木所有权的动态 NFT。**树属于铸造它的人。** ## ⚙️ 运作原理：核心循环 | 参与者 | 行动与价值主张 | |--------|----------------| | 🏢 **公司 (B2B)** | 通过 USDC (x402) 支付进入，购买 RWA 份额（真实的 Mogno 树木），并获得可验证的 ESG 影响。向其客户分发 $LEAF 代币作为“绿色返现”。 | | 🛰️ **预言机 (PoF)** | AI 和卫星数据验证物理世界中的生物量和碳水平。通过 `process_oracle_report` 将生长数据注入 dNFT。 | | 🌱 **消费者 (B2C)** | 从合作品牌获得 $LEAF 代币。累积叶子并**铸造一个 dNFT** ——一个代表真实非洲桃花心木树的动态 NFT，随着物理树木的生长而在链上生长。 | ### dNFT 的旅程 ``` Empresa compra RWA → Protocolo emite $LEAF → Consumidor ganha $LEAF ↓ Consumidor queima $LEAF → Forja dNFT (Tier 1) ↓ Oráculo alimenta dados → dNFT evolui ↓ Consumidor funde dNFTs → Tier Superior (Raro → Épico → Lenda) ``` 每个 **dNFT** 都是由真实树木支持的活数字资产。它跟踪生物量、碳封存和生物阶段——所有这些都由 Proof of Flourishing 预言机在链上验证。 ## 🔒 智能合约图 (Soroban) Stellar Soroban 网络上的六个模块化 Rust 合约（SDK v26.0.0）： | 合约 | 功能 | 状态 | |------|------|------| | `leaf_token` | **$LEAF 代币 (SEP-41)。** 可铸造/销毁/转移，最大供应量 10 亿。两步管理员。TTL 管理。 | ✅ 测试网 | | `guardian_id` | **消费者 SBT。** 灵魂绑定的声誉——经验值、等级 (1-50)、7 个生物时代。不可转让。 | ✅ 测试网 | | `company_id` | **公司 SBT。** 机构身份—— C-Cred、C-Debt、ODS 徽章、Vereda 验证。 | ✅ 测试网 | | `collateral_vault` | **DeFi 市场。** 实物库存管理（幼苗）、公司间 C-Cred 交易、债务结算。 | ✅ 测试网 | | `forest_mythos_vault` | **dNFT 引擎。** 代表真实树木的动态 NFT —— 铸造、锻造、预言机报告、90 天反翻转锁定。 | ✅ 测试网 | | `journey_orchestrator` | **指挥家。** 编排所有合约—— B2B 接入、B2C 植树、神话锻造。单入口点。 | ✅ 测试网 | ## 💳 x402 支付流程 该协议使用 [x402 协议](https://www.x402.org/) 在 Stellar 上进行 HTTP 原生 USDC 支付： | 端点 | 价格 | 动作 | |------|------|------| | `POST /api/v1/x402/plant-tree` | 0.01 USDC | 销毁 LEAF → 铸造 dNFT → 奖励经验值 | | `POST /api/v1/x402/forge-mythos` | 0.05 USDC | 将 dNFT 合并为更高层级 | | `GET /api/v1/x402/rwa-data/[id]` | 0.001 USDC | 返回 dNFT 遥测数据 | ## 🚀 快速开始 ``` # Let me list them with translations: rustup target add wasm32v1-none cargo install stellar-cli # 1. Prerequisites – 前提条件 git clone https://github.com/G0vermind/social-forests-protocol.git cd social-forests-protocol # 2. Clone & install – 克隆和安装 make build # 3. Build all contracts – 构建所有合约 make test # 4. Run tests – 运行测试 cd apps/web cp .env.example .env.local # Preencha seus valores npm install npm run dev # → http://localhost:3000 ``` ## 🗺 路线图 | 阶段 | 状态 | 里程碑 | |------|------|--------| | **第一阶段——种子** | 🔨 构建中 | 测试网上的 6 个模块化合约 · x402 集成 · 预言机 API · B2C 游戏化（经验值/时代） · dNFT 锻造 · Viveiro Maravilha “零号客户” | | **第二阶段——生长** | 🔜 已计划 | 主网 AI Vision 预言机 · Etherfuse Stablebonds 集成 · 账户抽象（Google 登录） · $FLORA 治理合约 · Sómogno 集成 · 多签管理员 | | **第三阶段——规模化** | 🔜 已计划 | 二级 RWA 市场 · DAO 过渡 · C-Cred AMM · Pecém 港口出口 · 完全机构接入 · 主网部署 | ## 🌱 联合国可持续发展目标对齐 | 可持续发展目标 | 贡献 | |----------------|------| | **1 & 2** | 农村收入多样化（间作养蜂）；粮食安全 | | **5** | 资产管理中的性别平等；农村妇女的自主 Stellar 钱包 | | **8** | 塞阿拉州内陆的体面工作；DeFi 基础设施创新 | | **9** | 自然资产数字化；开放的 NbS 基础设施 | | **12** | 再生性返现模式；负责任消费和生产 | | **13** | 碳封存；巴黎协定 + 昆明-蒙特利尔框架对齐 | | **15** | 森林管理和生物多样性保护 | ## 👥 核心团队——网络编织者 - **Gustavo Gonçalves** · `创始人兼技术负责人` ([LinkedIn](https://www.linkedin.com/in/gustavo-gon%C3%A7alves-9a4a1523/) · [GitHub](https://github.com/G0vermind)) - **Vinicius Braz Rocha** · `ReFi 架构师` ([LinkedIn](https://www.linkedin.com/in/vrselfmedia/) · [GitHub](https://github.com/glocalVR)) - **Clarkson Luiz Buriche** · `环境开发与 AI` ([LinkedIn](https://www.linkedin.com/in/clarkson-luiz-buriche-bartalini-80446a6b/) · [GitHub](https://github.com/catitodev)) - **Iara Magalhães** · `Web3 开发者` ([LinkedIn](https://www.linkedin.com/in/iaiakedemy) · [GitHub](https://github.com/iaiamaga)) ### 顾问——守护者委员会 - **Francisco das Chagas Rosa** · `农学顾问` - **Patricia Lemos** · `法律顾问` ## ⚡ [RE]³ — ReReGeneradora：第一个减速器 - **Pedro Bruder** · `[RE]³ 顾问` ([LinkedIn](https://www.linkedin.com/in/pedrobruder) · [GitHub](https://github.com/BasedCaveman)) - **Vinícius Braz Rocha** · `[RE]³ 顾问兼协议联合发起人` ([LinkedIn](https://www.linkedin.com/in/vrselfmedia/) · [GitHub](https://github.com/glocalVR)) - **Enzo Garcia** · `[RE]³ 顾问` ([LinkedIn](https://www.linkedin.com/in/enzo-garcia-295066316) · [GitHub](https://github.com/F0rtyF0ur))

标签：B2B2C, ESG, Rust, RWA, Soroban, Stellar, Web3, x402协议, 代币化, 代币经济, 企业ESG, 动态NFT, 区块链, 去中心化基础设施, 可持续发展, 可视化界面, 智能合约, 林业, 森林保护, 气候审计, 气候行动, 气候金融, 消费者激励, 环保区块链, 真实世界资产, 碳信用, 绿色返现, 绿色金融, 网络流量审计, 自动化攻击, 资产代币化, 透明度, 链上审计