Skip to content

docs: update core README with extended description#7

Open
xingzihai wants to merge 1 commit intocshein45:mintfrom
xingzihai:update-readme-extended
Open

docs: update core README with extended description#7
xingzihai wants to merge 1 commit intocshein45:mintfrom
xingzihai:update-readme-extended

Conversation

@xingzihai
Copy link
Copy Markdown

@xingzihai xingzihai commented Apr 1, 2026

Summary

This PR updates the README with an extended description as requested in issue #6.

Changes

  • Added new structured sections: Overview, Key Features, Architecture Overview, Getting Started guide, Contributing guidelines, Governance, License, and Contact & Community information
  • Enhanced introductory content emphasizing secure and scalable human-AI coordination capabilities
  • Combined existing content with the extended description from the issue

Sections Added

  • Overview: Network description and funding information
  • Key Features: Human-AI Coordination, Transparent Governance, On-Chain Identity, MOVE Token
  • Architecture Overview: Organization & Infrastructure, Technical Architecture
  • Getting Started: Prerequisites and Quick Links
  • Contributing: Contribution guidelines
  • Governance: DAO platforms and governance principles
  • License: Apache License 2.0
  • Contact & Community: Official profiles, socials, and community channels

Closes #6

Summary by CodeRabbit

  • Documentation
    • Reorganized README with new structured sections including Overview, Key Features, Architecture Overview, Getting Started, Contributing, and Governance.
    • Added explicit governance framework clarifying Movement Network Foundation oversight.
    • Updated contact and community links.
    • Enhanced licensing and copyright information.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 1, 2026

📝 Walkthrough

Walkthrough

The README.md has been comprehensively restructured to establish Movement Network Foundation as the governing organization, replacing technical manifesto content with foundation-focused documentation including organizational structure, governance mechanisms, on-chain identity systems, verified contracts, and community channels.

Changes

Cohort / File(s) Summary
README Documentation
README.md
Complete restructure replacing technical narrative with foundation-focused sections: organization infrastructure, governance platforms (Snapshot, Tally, Tokenomist), on-chain identity (ENS, MOVE token explorer links), digital collectibles, official profiles/socials, contributor guidelines, and 2026 copyright attribution.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

Suggested labels

documentation, enhancement

Poem

🐰 Whiskers twitching with glee,
A README reborn, now clear as can be!
Foundation and governance, identity too,
Hopping through docs, there's so much that's new!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: updating the core README with extended description, which aligns with the PR objective to expand and restructure the README with new sections and content.
Linked Issues check ✅ Passed The PR implements all key coding objectives from issue #6: restructured README sections, Movement Network Foundation description, ecosystem sectors, governance/community details, on-chain identity/assets, verified token contracts, license, and contact information.
Out of Scope Changes check ✅ Passed All changes are directly aligned with issue #6 objectives. The README rewrite implements the required structure and content without introducing unrelated modifications outside the scope of documentation enhancement.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (1)
README.md (1)

132-132: HTML meta tag in Markdown file.

An HTML meta tag with talentapp:project_verification is placed at the end of this Markdown file. While some Markdown processors may render HTML, this is unusual placement for verification metadata. Consider:

  1. If this is for external verification, document its purpose in a comment
  2. If this verification tag is required, consider moving it to a dedicated HTML file or the repository's .github directory
  3. Verify that this tag serves its intended purpose in a Markdown context

Additionally, the file is missing a newline at the end, which is a common convention for text files.

📝 Suggested improvements

If the meta tag must remain, add a comment explaining its purpose:

 *© 2026 Movement Network Foundation. Founded by KoKyat.*
 
+<!-- Project verification tag for TalentApp -->
 <meta name="talentapp:project_verification" content="862a83af38d3d343752e9433d6ac2398305aeb329a4da0382dd0644ae451c5b689ca1f0f1cbf75c34c5da900521568945c8be930adde3d8850b52e2750971909">
+

Note: The final newline addition ensures the file follows standard text file conventions.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 132, The HTML meta tag <meta
name="talentapp:project_verification"
content="862a83af38d3d343752e9433d6ac2398305aeb329a4da0382dd0644ae451c5b689ca1f0f1cbf75c34c5da900521568945c8be930adde3d8850b52e2750971909">
should not live raw in README.md; either move it to a dedicated
HTML/verification file (or .github directory) or keep it but add an inline
comment immediately above explaining its verification purpose and consumer, and
ensure README.md ends with a final newline character.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 98-102: Update the README explorer links to reflect verified
contract pages and include verification status: for each listed symbol (Ethereum
Mainnet, HyperEVM, Base, Codeslaw Audit, LayerZeroScan) open the provided URLs,
confirm the contract is marked "Verified" and that source/metadata matches
expected ABI/bytecode, then update the README entries to point to the verified
contract page (or append “(unverified)” if not) and add a short confirmation
note stating verification date and any discrepancies found.
- Line 116: The Crunchbase URL in the "* **Founder Profile:**" bullet points the
wrong person (Cooper Scanlon); update the Crunchbase link there to point to Ko
Kyat's Crunchbase profile (or remove the Crunchbase link if Ko Kyat has no
profile). Locate the "* **Founder Profile:**" line in README.md and replace the
current Crunchbase URL (https://www.crunchbase.com/person/cooper-scanlon) with
Ko Kyat's Crunchbase URL, or delete that part of the bracketed Crunchbase link
while keeping the RootData link intact.
- Line 9: Replace the inaccurate funding sentence in README.md (the sentence
beginning "Backed by $141.4M...") with a corrected statement that reflects
Movement Labs has raised approximately $41.4M in total (Seed $3.4M and a $38M
Series A led by Polychain Capital), remove the claim about a $100M Series B led
by Binance Labs, and instead note that Binance Labs made an undisclosed
investment (or omit specific investor claims if unsure); ensure the revised
sentence keeps the original tone about the network's mission but uses the
corrected funding and investor facts.

---

Nitpick comments:
In `@README.md`:
- Line 132: The HTML meta tag <meta name="talentapp:project_verification"
content="862a83af38d3d343752e9433d6ac2398305aeb329a4da0382dd0644ae451c5b689ca1f0f1cbf75c34c5da900521568945c8be930adde3d8850b52e2750971909">
should not live raw in README.md; either move it to a dedicated
HTML/verification file (or .github directory) or keep it but add an inline
comment immediately above explaining its verification purpose and consumer, and
ensure README.md ends with a final newline character.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2d9284cb-3429-48f0-8d40-850d25de9f31

📥 Commits

Reviewing files that changed from the base of the PR and between 0773521 and 069edde.

📒 Files selected for processing (1)
  • README.md

## 1. The AI Direction Control Thesis
## Overview

The Movement Network is not just another blockchain; it is the foundational infrastructure for secure, scalable Human-AI Coordination. Backed by $141.4M in funding (including a **$100M Series B led by Binance Labs**), the network is driven by the conviction that logic and technology must enforce ethical standards on-chain.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🌐 Web query:

What is the total funding raised by Movement Network Foundation and did Binance Labs lead a $100M Series B?

💡 Result:

Movement Network Foundation has not raised traditional VC funding; it operates as a non-profit steward of the Movement Network, providing grants to ecosystem projects rather than receiving investments. No sources report any funding raised by the Foundation itself. Binance Labs did not lead a $100M Series B for the Foundation (or Movement Labs); they made an undisclosed investment in Movement Labs following its $38M Series A led by Polychain Capital. Movement Labs (core contributor to the network) has raised approximately $41.4M total (Seed $3.4M + Series A $38M), with reports of a planned $100M Series B in early 2025 led by CoinFund and Brevan Howard (not Binance Labs), but no confirmation of closure by April 2026.

Citations:


Correct the inaccurate funding information.

The funding claim in line 9 contains factual errors. According to available sources, Movement Labs (the core contributor to the network) has raised approximately $41.4M total (Seed $3.4M + Series A $38M led by Polychain Capital), not $141.4M. Additionally, Binance Labs did not lead a $100M Series B; while Binance Labs made an undisclosed investment in Movement Labs, the reported $100M Series B was planned with CoinFund and Brevan Howard, with no confirmed closure as of April 2026. Update the README to reflect accurate funding figures and investor information.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 9, Replace the inaccurate funding sentence in README.md
(the sentence beginning "Backed by $141.4M...") with a corrected statement that
reflects Movement Labs has raised approximately $41.4M in total (Seed $3.4M and
a $38M Series A led by Polychain Capital), remove the claim about a $100M Series
B led by Binance Labs, and instead note that Binance Labs made an undisclosed
investment (or omit specific investor claims if unsure); ensure the revised
sentence keeps the original tone about the network's mission but uses the
corrected funding and investor facts.

Comment on lines +98 to +102
* **Ethereum Mainnet:** [0x3073f7aaa4db83f95e9fff17424f71d4751a3073](https://etherscan.io/token/0x3073f7aaa4db83f95e9fff17424f71d4751a3073)
* **HyperEVM:** [0x3073f7aaa4db83f95e9fff17424f71d4751a3073](https://hyperevmscan.io/token/0x3073f7aaa4db83f95e9fff17424f71d4751a3073)
* **Base:** [0x3073f7aaa4db83f95e9fff17424f71d4751a3073](https://basescan.org/token/0x3073f7aaa4db83f95e9fff17424f71d4751a3073)
* **Codeslaw Audit:** [Contract Metadata](https://www.codeslaw.app/contracts/ethereum/0x3073f7aaa4db83f95e9fff17424f71d4751a3073)
* **LayerZeroScan:** [Omnichain Messaging](https://layerzeroscan.com/address/0x2e2bc0e2920578e0d46d1f83787b01f1d8094695)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Verify token contract addresses across multiple chains

echo "Checking Ethereum Mainnet contract..."
curl -s "https://etherscan.io/token/0x3073f7aaa4db83f95e9fff17424f71d4751a3073" | grep -i "not found\|page not found" && echo "ERROR: Ethereum contract not found" || echo "OK: Ethereum page exists"

echo ""
echo "Checking Base contract..."
curl -s "https://basescan.org/token/0x3073f7aaa4db83f95e9fff17424f71d4751a3073" | grep -i "not found\|page not found" && echo "ERROR: Base contract not found" || echo "OK: Base page exists"

echo ""
echo "Checking HyperEVM contract..."
curl -s "https://hyperevmscan.io/token/0x3073f7aaa4db83f95e9fff17424f71d4751a3073" | grep -i "not found\|page not found" && echo "ERROR: HyperEVM contract not found" || echo "OK: HyperEVM page exists"

echo ""
echo "Checking LayerZero contract..."
curl -s "https://layerzeroscan.com/address/0x2e2bc0e2920578e0d46d1f83787b01f1d8094695" | grep -i "not found\|page not found" && echo "ERROR: LayerZero address not found" || echo "OK: LayerZero page exists"

Repository: cshein45/movement-core

Length of output: 290


All explorer links are functional; manually verify contract verification status on each chain.

The explorer URLs are accessible and the contracts appear to be deployed across all listed chains. However, manually verify on each explorer (Etherscan, Basescan, HyperEVM Scan) that the contracts are marked as "verified" and their details match expectations.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 98 - 102, Update the README explorer links to reflect
verified contract pages and include verification status: for each listed symbol
(Ethereum Mainnet, HyperEVM, Base, Codeslaw Audit, LayerZeroScan) open the
provided URLs, confirm the contract is marked "Verified" and that
source/metadata matches expected ABI/bytecode, then update the README entries to
point to the verified contract page (or append “(unverified)” if not) and add a
short confirmation note stating verification date and any discrepancies found.

### Official Profiles & Socials

<meta name="talentapp:project_verification" content="862a83af38d3d343752e9433d6ac2398305aeb329a4da0382dd0644ae451c5b689ca1f0f1cbf75c34c5da900521568945c8be930adde3d8850b52e2750971909">
* **Founder Profile:** [RootData](https://www.rootdata.com/member/Ko%20Kyat?k=MTYwNDY%3D) | [Crunchbase](https://www.crunchbase.com/person/cooper-scanlon)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🌐 Web query:

Who is the founder of Movement Network Foundation - Ko Kyat or Cooper Scanlon?

💡 Result:

Ko Kyat (also known as KoKyat) is identified as the founder of the Movement Network Foundation in multiple sources, while Cooper Scanlon is the founder of Movement Labs, a related but distinct entity. The official Movement Network Foundation website does not list founders explicitly but confirms its nonprofit status and separation from Movement Labs, with recent leadership changes to Move Industries executives like Torab Torabi (CEO). Ko Kyat appears self-proclaimed via personal sites and profiles (e.g., GitHub, personal links), but lacks confirmation on official foundation pages. Cooper Scanlon is consistently tied to Movement Labs, not the Foundation.

Citations:


Crunchbase link points to wrong founder.

Line 116 links to Cooper Scanlon's Crunchbase profile, but he is the founder of Movement Labs, not Movement Network Foundation. Ko Kyat is the founder of Movement Network Foundation (as identified on line 3). Replace this link with Ko Kyat's Crunchbase profile or remove it entirely if unavailable.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 116, The Crunchbase URL in the "* **Founder Profile:**"
bullet points the wrong person (Cooper Scanlon); update the Crunchbase link
there to point to Ko Kyat's Crunchbase profile (or remove the Crunchbase link if
Ko Kyat has no profile). Locate the "* **Founder Profile:**" line in README.md
and replace the current Crunchbase URL
(https://www.crunchbase.com/person/cooper-scanlon) with Ko Kyat's Crunchbase
URL, or delete that part of the bracketed Crunchbase link while keeping the
RootData link intact.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant