Skip to content

Latest commit

 

History

History
521 lines (334 loc) · 22.8 KB

Antigone4224_WICL1st.md

File metadata and controls

521 lines (334 loc) · 22.8 KB
Raw

Web3 URL 残酷共学第 1 期残酷指引

⚠️ 正式开始前请确保你在身体上和精神上都处于合适的状态，请刻意练习，残酷面对 🆒。为方便检索 The First Web3 URL Intensive CoLearning 简写为 WICL1st，第 2 期即为WICL2nd，第 3 期即为 WICL3rd，以此类推。

⚠️ 报名需要按要求认真填写下面 [ XXX ] 部分，方可通过报名审核，通过审核即可开始自主学习。

Antigone4224

  1. 自我介绍：

    我是Antigone,cuit区块链准大三学生，想通过共学计划进一步，学习并参与到web3://这样新兴的协议中。本次共学的笔记会发在我的博客

    组队期待：

    还在观望，暂无，随时更新。

  2. 你认为你会完成本次 Web3 URL 的残酷学习吗？

    Maybe 80%

第 1 期共学时间计划

  • 7 月 8 日 - 7 月 14 日：

    • 自我介绍：大家按要求更新上方自我介绍，方面大家互相了解，及后续自由组队方向。

    • Web3 URL 残酷共学频道报道：大家可以自由在残酷共学群里交流分享，互动答疑，根据自身学习阶段情况随时开启自由组队。

    • 课前学习：了解残酷共学流程，GitHub 协作共学基础；Web3:// 协议课前学习。

  • 7 月 15 日 - 7 月 21 日：

    • 7 月 15 日 周一晚 8 点- 9 点（北京时间）： 第 1 次公开课分享
    • 本周共学内容： 涉及 Web3:// 的背景和演进历史；支持 Web3:// 协议的访问方式 (gateway 和 EVM browser)来浏览以太坊上面的数据；熟悉使用 Web3:// 和 EthStorage 早期测试网来部署简单的去中心化网站。
    • Homework1： 见课程 PPT。

  • 7 月 22 日 - 7 月 28 日

    • 7 月 22 日 周一晚 8 点- 9 点（北京时间）： 第 2 次公开课分享

    • 本周共学内容： 涉及 Web3:// 高级开发工具，包括：在命令行通过 web3curl 来通过 Web3:// 协议下载数据，通过 ethfs-uploader 批量上传网页数据，通过 manual 模式来搭建去中心化多人交互全链网站；及深入理解以太坊的存储模型和 gas 开销等。

    • 边学边用实战开发： 根据组队情况自由安排。

    • Homework2： 见课程 PPT。

  • 7 月 29 日 - 8 月 4 日

    • 7 月 29 日 周一晚 8 点- 9 点（北京时间）： 第 3 次公开课分享
    • 本周共学内容： 涉及实际应用案例分享及未来以太坊基础设施在 Web3:// 的重要作用及开发方向等。
    • 边学边用实战开发： 根据组队情况自由安排。
    • 结营分享： 具体时间及详情另在「Web3 URL 残酷共学频道」通知。

笔记证明 Notes Proof

07.15

  • 今日学习时间：2h
  • 学习内容小结：详情见我的博客,预习了一下slides里的内容，对于web3-url有了一个大致的了解。

预习了一下第一次的 slides,简单的介绍了一下web3://协议

ERC-4804提出了使用RFC 2396 URI来表示一个以太坊消息调用，给予了我们一种直接访问以太坊区块链的方式，也就是web3 url，从此不再需要经过http://或者ipfs的代理。

可以参考下面这张图（直接从slides里扒的链接，可能会没法加载= =）

下面的标识是对应URI的RFC标准，上面的标识是对应了对于区块链中具体寻址的对应。

img

可以看到web3:// 支持大多数http://的功能，就是对标以太坊生态中的http://,与ipfs://不同的是，web3://是直接对接到链上的，虽然看起来都是去中心化的一种应用层协议，但是ipfs://对接的是共享文件的peer节点，web3://对接的是以太坊或者EVM生态的区块链网络。

slides里提供了两种使用web3:// 协议的方式，一种是火狐浏览器插件,这种访问还是经过了gateway 经过http://代理来实现的访问(看起来只是将请求转换成了url请求发送给gateway),然后就是一个[EVM Browser](https:/web3-protocol/evm-browser) 这个在我仅仅只看Readme的情况下，需要一个https的链接指定rpc，，翻了下源码，还真是http call rpc,,

  async #rpcCall(rpcUrl, args) {
    if(this.#rpcCallCounters[rpcUrl] === undefined) {
      this.#rpcCallCounters[rpcUrl] = 0;
    }
    this.#rpcCallCounters[rpcUrl]++;

    let postData = {
      jsonrpc: "2.0", 
      id: this.#rpcCallCounters[rpcUrl],
      method: "eth_call",
      params:[
        args,
        "latest"
      ]
    }

    const response = await fetch(rpcUrl, {
      method: 'POST', 
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(postData)
    })

    if(response.status != 200) {
      throw new Error("RPC returned an error HTTP code: " + response.status);
    }

    const json = await response.json()

    if(json.error) {
      throw new Error("RPC returned an error: " + json.error.message);
    }

    if(json.result === undefined || json.result === "" || json.result == "0x") {
      throw new Error("No data returned");
    }
    

    // We got some data!
    return json.result;
  }

感觉独立协议的部分应该还是未完全完成的状态？

按照ppt的指引，通过web3://访问

浏览器抓包也能很明显看出还是隐式的使用了https

image-20240715132058280

后面slides还讲了一堆将常规web2应用迁移到web3的例子，展示了web3://代替http://的可能性。

随后 slides里列出了对该erc进行拓展的ERC-5018：实现一个在合约类文件系统的接口给合约访问/上传资源，让合约应用显得更贴近web应用，更加符合常规web应用开发的逻辑。

ERC-6944：希望添加一种请求资源的参数解析模式(erc-4804提出了manual和auto两种，前者并不会自动填充参数，所以应该会产生参数缺失无法成功访问的问题)，应该也是为了优化web3网页的体验。

07.16

博客链接：web3-url-colearning-day2 (antigone4224.github.io)

完成了hw1

hw1:

Find the ownership of an your favor NFT

查询一下slides里展示的cyberbrokers吧

ERC721有ownerOf方法可以通过tokenid查询owner的地址

image-20240716151628876

在etherscan上查询的合约地址可以调用ownerOf方法，然而cyberbrokers-meta这个地址却不能

image-20240716151915929

再尝试了一下发现那个0x89的合约地址同样也无法执行renderBroker的方法

ens上查询了一下0x8b开头的一个合约地址能renderBroker

还是有点不太明白怎么回事暂时。

Find the balance of an account in an ERC-20 contract (USDC / USDT)

ERC20 有个balanceOf方法可以查询余额

web3:// (addr of contract)/balanceOf/(acc addr)?returns=(uint256)

image-20240716144143413

Deploy a contract in auto model and say “hello world”

很明显是要我们关注ERC 6860关于 解析模式(resolve mode)的定义了

 Resolve Mode
Once the “To” address and chainid are determined, the protocol will check the resolver mode of contract by calling the resolveMode method of the “To” address. The Solidity signature of resolveMode is:

function resolveMode() external returns (bytes32);
The protocol currently supports two resolve modes: auto and manual.

The manual mode will be used if the resolveMode return value is 0x6d616e75616c0000000000000000000000000000000000000000000000000000, i.e., “manual” in bytes32
The auto mode will be used if :
the resolveMode return value is 0x6175746f00000000000000000000000000000000000000000000000000000000, i.e, “auto” in bytes32, or
the resolveMode return value is 0x0000000000000000000000000000000000000000000000000000000000000000, or
the call to resolveMode throws an error (method not implemented or error thrown from the method)
Otherwise, the protocol will fail the request with the error “unsupported resolve mode”.

合约地址：0xea100cb127d5547793172248e730e1b4b6524984

部署在sepolia

代码：

pragma solidity >=0.7.0 <0.9.0;

contract Hello_world_auto {
    function sayHelloWorld() public pure returns (string memory) {
        return "Hello World";
    }

    function resolveMode() pure external returns (bytes32) {
        return bytes32("auto");
    }
}

image-20240716200355477

Deploy a contract in manual model and say “hello world”

同理

pragma solidity >=0.7.0 <0.9.0;

contract Hello_world_manual {
    function sayHelloWorld() public pure returns (string memory) {
        return "Hello World";
    }

    function resolveMode() pure external returns (bytes32) {
        return bytes32("manual");
    }
}

不过我还没有比较过manual，和auto访问时候的特性，这个丢到明天来继续。

07.17

博客地址：https://antigone4224.github.io/web3-url-colearning-day3

今天稍微有点事情，可能就没法接着把hw做完了，打算完善一下对于resolve mod的理解,阅读ERC 6860文档，对比Auto Mod 和manual Mod的区别：

the protocol will call the address with “Calldata” = keccak("resolveMode()")[0:4] = “0xDD473FAE”

在第一访问的开始，会尝试调用resolveMode()方法来确定resolvemod

如果仅指定地址 chainid,路径为空，Manual的calldata会是"/",AutoMod的calldata会为空。。

ManualMod会直接将Path+Query作为Calldata发出，而AutoMod会多一个进行abi转化的功能(AutoMod 可以把参数放到路径中，以及可以通过returns指定返回结果的类型，在调用的时候会自动转化成符合正常合约调用的abi的calldata调用的)。

Manual Mod 返回数据默认为text/html，如果不是会根据MIME后缀名自动识别，而Auto Mod则是根据returns的指定返回application/json，如果没有returns应该是undefined，从这个角度来说，ManualMod更适合于访问资源，而auto mod更适合于作为数据处理的中继。

Manual Mod可以很精准的定位资源在合约中的位置，但很明显这种直接将相对位置作为call data的方式是需要特殊支持的，就好像写web框架需要单独的文件服务一样，它更符合我们对于web2资源访问的构思。

07.18

博客地址：web3-url-colearning-day4 (antigone4224.github.io)

今天学习一下ethstorage。

EthStorage 是一个模块化和去中心化的存储 Layer 2，提供由数据可用性（DA）驱动的可编程键值存储。它为 Rollups 提供了长期的数据可用性解决方案，并为完全链上应用程序（如游戏、社交网络、人工智能等）开辟了新的可能性。

动机
EthStorage 背后的主要动机是提供基于以太坊的长期数据可用性。

EIP-4844 引入了数据斑块（data blobs），这增强了 Layer 2 扩展解决方案（如 Rollups）的吞吐量和效率。然而，这些数据斑块是临时可用的，意味着它们将在几周后被丢弃。这产生了一个显著的影响：L2 无法无条件地从 L1 推导出最新状态。如果某些数据无法再从 L1 检索，Rollup 可能无法同步链。

通过 EthStorage 作为长期数据可用性解决方案，L2 可以随时从它们的数据可用性层（以太坊 DA、Celestia、EigenDA 等 + EthStorage）中推导数据。

EthStorage 还为完全链上应用程序（如游戏、社交网络、人工智能等）开辟了新的可能性。

ethstorage文档

为ETHstorage提供存储，也算是某种存储挖矿（，可惜要550g的空余存储空间，不然挖矿还是挺香的

ethstorage的愿景是让以太坊网络的存储变得不再昂贵，到了一种可接受的程度，这样通过web3 url许多web2的网络服务也就可以部署在web3上了。

07.19

博客地址：web3-url-colearning-day5 (antigone4224.github.io)

在群组中发送地址，得到了1000测试ETH

可以拿来在ETH Storage上传文件

image-20240719153443861

image-20240719153355799

https://galileo.web3q.io/file.w3q/0x81fb5c383f192f7fa1f0788e1a06aed26ffac469/b_d42a32a060f284d3ffe3b4cf8cc08501.jpg

上传了我的qq头像（

成功的存在了galileo测试网上（

文件的地址一般是 web3://we3q.io:

花费两个测试ETH

image-20240719154421408

7.20

博客地址：web3-url-colearning-day6 (antigone4224.github.io)

今天学习一下Ethfs

安装Ethfs-cli

npm install -g ethfs-cli
ethfs-cli upload -f <directory|file> -a <address> -p <private-key> -r [rpc] -t [upload-type]

创建Flat Directory 合约

ethfs-cli create -p privkey
chainId = 3334
providerUrl = https://galileo.web3q.io:8545
FlatDirectory Address: 0x6F3F9E477a931d208c06efE7E6D3af251B000E94

得到

上传第一个文件夹

ethfs-cli upload -f myfolder -a 0x6F3F9E477a931d208c06efE7E6D3af251B000E94 -c 3334 -p privkey
providerUrl = https://galileo.web3q.io:8545
chainId = 3334
address: 0x6F3F9E477a931d208c06efE7E6D3af251B000E94

Send Success: File: hello.txt, Chunk Id: 0, Transaction hash: 0xa7a48056301a4b1773dff28a825576d6b8e2b2dd700d8a30dbbac77a4ac0450b
File hello.txt chunkId: 0 uploaded!


Total Upload Chunk Count: 1
Total Upload File Size: 0.005859375 KB
Total Cost: 0.0 ETHethfs-cli upload -f myfolder -a 0x6F3F9E477a931d208c06efE7E6D3af251B000E94 -c 3334 -p dadd64540987deea8210cfadcf50aeeed4ec14950a1f05260f7f59084f3b0727
providerUrl = https://galileo.web3q.io:8545
chainId = 3334
address: 0x6F3F9E477a931d208c06efE7E6D3af251B000E94

Send Success: File: hello.txt, Chunk Id: 0, Transaction hash: 0xa7a48056301a4b1773dff28a825576d6b8e2b2dd700d8a30dbbac77a4ac0450b
File hello.txt chunkId: 0 uploaded!


Total Upload Chunk Count: 1
Total Upload File Size: 0.005859375 KB
Total Cost: 0.0 ETH

成功上传

web3://0x6F3F9E477a931d208c06efE7E6D3af251B000E94:3334/hello.txt

image-20240720184338899

image-20240720184656521

7.21

博客链接：web3-url-colearning-day7 (antigone4224.github.io)

Use eth-blob-uploader to upload files via blobs

Use eth-blob-uploader to upload files via blobs

测试一下blob上传的命令行工具（

npm i -g eth-blob-uploader

eth-blob-uploader -r <rpc> -p <private-key> -f <file-path> -t <to-address>

上传文件（

img

7.22

博客链接：web3-url-colearning-day8 (antigone4224.github.io)

今天就是听课，解答了我之前的一些疑问。。

1.manual mod的路由实现问题，老师给了个示范项目

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

import "../W3RC3.sol";

contract FlatDirectory is W3RC3 {
    bytes public defaultFile = "";

    constructor(uint8 slotLimit) W3RC3(slotLimit) {}

    function resolveMode() external pure virtual returns (bytes32) {
        return "manual";
    }

    fallback(bytes calldata pathinfo) external returns (bytes memory)  {
        bytes memory content;
        if (pathinfo.length == 0) {
            // TODO: redirect to "/"?
            return bytes("");
        } else if (pathinfo[0] != 0x2f) {
            // Should not happen since manual mode will have prefix "/" like "/....."
            return bytes("incorrect path");
        }

        if (pathinfo[pathinfo.length - 1] == 0x2f) {
            (content, ) = read(bytes.concat(pathinfo[1:], defaultFile));
        } else {
            (content, ) = read(pathinfo[1:]);
        }

        StorageHelper.returnBytesInplace(content);
    }

    function setDefault(bytes memory _defaultFile) public virtual {
        require(msg.sender == owner, "must from owner");
        defaultFile = _defaultFile;
    }
}

感觉跟很古早的cgi开发很像。。。路由解析还是自己写代码实现的。。我本来以为会有个类似的框架啥的（（

2.ethfs-cli FlatDirectory文件上传的问题，并不会像正常文件系统一样保存目录的信息，，所有文件都放在一个文件夹中

3.web3-url跟正常的url一样，支持相对路径引用。。这点我都没有注意。

7.23

今天几乎没有怎么学习，在思考做的项目的一些事情。点子是有一些的： 1.类似于4chan这样的中文匿名留言板，定时消除没有人看的thread的这种 2.是一个类似于githubpages的静态网站托管？，我不确定是否已经有了这样的基建 3.是一个类似于date back machine这样的合约来实时保存一些网站的快照。 4.类似于annas archive和zlib的网络图书馆。。 具体的构想我会在把这些设想完善之后写到博客里

7.24

今天加入了暗黑石头剪刀布的组队中，大概讨论了一下项目的架构，牌的生成和验证，以及后面用ethfs的云盘作为拓展来防止不交牌导致的流局等等。。 项目notion链接https://gigantic-bandicoot-5c1.notion.site/Web3-E-Card-6bcf5fc4ac2b4e36a801deb66af5c937

7.25

今天项目建立了github仓库：https:/OutlawVoyage/OutlawVoyage 继续完善一些关于对局的细节部分，讨论了一下对局中怎么交换卡牌，以及明确了成员的工作时间等。。后续几天应该就可以开始贡献代码了。。

7.26

微信群里继续讨论项目中要实现的合约和数据结构。主要是pncan在做,项目暂定的时间节点大概为： 8.4结营 8.3完成测试 8.2完成debug 7.31-8.1两天合体 7.27-7.30 五天代码 7.26 pnkcan完成架构 只能说感觉对于solidity语言了解的不太够，具体的架构设计要出来肯定得先写个简单点的demo验证，然后写代码的时候慢慢改了。

7.27

这几天的开发的规划： 代码开发（五天）

任务：

  1. 7.27 - 系统设置和基础合约
    • 后端合约开发工程师A：设置项目基础结构，编写系统参数和管理合约。
    • 前端开发工程师：搭建前端项目结构，准备基本的UI组件。
  2. 7.28 - 船班和船只管理合约
    • 后端合约开发工程师B：编写船班管理合约，包括船班的创建、设置参数等。
    • 后端合约开发工程师A：编写船只管理合约，包括船只的创建、状态管理等。
    • 前端开发工程师：实现前端界面，允许用户查看和创建船班。
  3. 7.29 - 玩家和Table管理合约
    • 后端合约开发工程师C：编写玩家管理合约，包括玩家报名、状态管理等。
    • 后端合约开发工程师D：编写Table管理合约，包括Table创建、玩家加入、明文提交等。
    • 前端开发工程师：实现前端界面，允许用户报名、创建和加入Table。
  4. 7.30 - 交易和结算合约
    • 后端合约开发工程师A、B：编写交易厅合约，包括交易的创建和管理。
    • 后端合约开发工程师C、D：编写结算合约，包括胜负判定、奖励分配等。
    • 前端开发工程师：实现前端界面，允许用户进行交易和查看结算结果。

我负责后端开发工程师c的工作。。

7.28

今天在折腾合约开发部署环境的问题，gpt建议的truffle，我看了下已经停止维护了，，consensys建议使用hardhat，项目结构也差不多，也考虑了foundry，但hardhat可以前后端一起测试。还在等大家一起商量出项目具体的开发测试环境。

7.29

听周会介绍了正常以太坊存储的计算方法，（靠sstore字节码消耗gas和gas费用率计算），以及ethstorage作为存储layer2的原理（链上存储验证文件哈希，而不是文件本体），也算更深入了解了layer2扩容的概念

项目部分总算把环境搞定了，在协作着完成demo部分的代码，还是着眼于最小实现，先做出来，不过ddl是8.9,比起8.4来说还是多了很多时间，不是那么紧迫了，也有更多时间拿来打磨。

7.30

提交了我自己的一部分代码，完成了桌子和对局相关的逻辑（创建牌桌，加入牌桌，提交明文，翻牌结算对局等），具体可以看项目的commit。。

08.01

修正了一下之前写的代码的报错，大体上又重新审了一遍源码，记录了一些自己觉得可能不合理的部分，等待晚上十点开语音会议讨论后面的修改和完善。

08.02

完善了昨天语音会议提出来的代码逻辑的问题。增加了扣星和淘汰的代码，调整了桌子的创建和索引以配合前端展示等。

08.03

继续修改代码，修改了玩家淘汰的逻辑，以及开始尝试编译合约等。