Skip to content

Latest commit

 

History

History
790 lines (669 loc) · 29.7 KB

Rumbia.md

File metadata and controls

790 lines (669 loc) · 29.7 KB
timezone
Asia/Shanghai

Rumbia

  1. 自我介绍 一个酷爱web3的未来伟大交易者

  2. 你认为你会完成本次残酷学习吗? 要么完成,要么死亡

Notes

2024.09.23

一、 git操作 Git是一个分布式版本控制系统 克隆仓库 git clone 查看分支 git branch(git branch -r 列出远程跟踪分支 git branch -a 本地和远程all分支) 创建分支 git checkout -b 添加文件到暂存区 git add 提交修改 git commit -m "message"(将暂存区的修改提交到本地的仓库 message用来描述提交的内容) 推送修改到远程仓库 git push (更新远程仓库状态) 二、solidity Solidity 是一种用于编写以太坊虚拟机(EVM)智能合约的编程语言. Remix -> IDE //----许可证 // SPDX-License-Identifier: MIT //----"^"符号----- “^0.8.21” 表示要求使用的 Solidity 编译器版本至少为 0.8.21,但不包括下一个主版本(0.9.0 及以上版本)。 符号 “^” 在版本范围指定中被称为 “caret” 符号, 它允许使用与指定版本具有相同主版本号和更高的次版本号及补丁版本号,只要不破坏向后兼容性。 pragma solidity ^0.8.21; //合约 contract HelloWeb3{ string public _string = "Hello Web3!"; }

2024.09.24

一、关于solidity的变量类型 1.值类型(Value Type) bool uint(num) -->正整数 num是bit位 e.g: uint256 public _a = 20220330; // 256位正整数 int address: 一、定义: address 是solidity特有的 address类型的变量可以存储一个 20 字节的值,代表一个以太坊账户地址。这个地址可以是外部账户(由用户控制的账户,拥有私钥)或合约账户的地址。 通常以十六进制形式表示,例如0x1234567890abcdef1234567890abcdef12345678。 二、主要属性和方法 balance属性:可以使用address.balance来查询一个地址的以太币余额。例如,address payable someAddress; uint256 balance = someAddress.balance;可以获取地址someAddress的以太币余额并存储在变量balance中。
transfer方法:用于向一个地址发送以太币。例如,someAddress.transfer(100);将向地址someAddress发送 100 wei(以太坊的最小货币单位)的以太币。这个方法会抛出异常如果发送失败。 send方法:也用于发送以太币,但它返回一个布尔值表示发送是否成功。例如,bool success = someAddress.send(100);如果发送成功,success将为true,否则为false。 call方法:可以用于与其他合约进行交互或执行低级别的调用。它接受一个字节数组作为参数,可以指定要调用的函数和传递的参数。例如,(bool success, bytes memory data) = someAddress.call(abi.encodeWithSignature("someFunction()"));执行对地址someAddress上的 “someFunction” 函数的调用。 Q1: address payable addr; addr.transfer(1); 合约向addr 转账 1wei 定长字节数组(数值类型):数组长度在声明之后不能改变. e.g.:bytes1 bytes32 其最多存储32bytes数据
一字节等于8bit enum (太冷门了,无人问津...) 2.引用类型(Reference Type) 不定长字节数组 3.映射类型(Mapping Type) 4.函数类型(Function Type)

2024.09.25

function 一、形式: function () {internal|external|public|private} [pure|view|payable] [returns ()] function:声明函数时的固定用法。要编写函数,就需要以 function 关键字开头。 :函数名。 ():圆括号内写入函数的参数,即输入到函数的变量类型和名称。(传入的参数 及其类型) {internal|external|public|private}:函数可见性说明符,共有4种。 public:内部和外部均可见。 external:只能从合约外部访问(但内部可以通过 this.f() 来调用,f是函数名)。 private:只能从本合约内部访问,继承的合约也不能使用。 internal: 只能从合约内部访问,继承的合约可以用。 [pure|view|payable]:决定函数权限/功能的关键字。payable(可支付的)很好理解,带着它的函数,运行的时候可以给合约转入 ETH。 [returns ()]:函数返回的变量类型和名称。 public 和 extenal 的区别 一、函数可见性范围 public函数: 可以在内部(合约内部的其他函数)和外部(通过交易调用合约)被访问。 对于合约内部的调用,public函数的调用方式与内部函数相同,可以直接调用。 对于外部调用,通常通过交易发送到合约地址来触发。 external函数: 主要用于外部调用。不能在合约内部以与内部函数相同的方式调用(即不能直接使用 “函数名 ()” 的方式调用),但可以通过 “this. 函数名 ()” 的方式从合约内部进行外部调用。 二、Gas 开销和效率 external函数在某些情况下可能具有较低的 Gas 开销,特别是在处理复杂的数据结构或进行大量的外部调用时。 这是因为external函数在接收参数时采用不同的方式,它将参数存储在 calldata 区域而不是内存中,这可以节省一些 Gas。 public函数在内部调用时可能更加方便,因为它们可以像内部函数一样被调用,不需要特殊的语法。但在处理外部调用时,可能会有一些额外的 Gas 开销,因为参数通常会被复制到内存中。

合约中定义的函数需要明确指定可见性,没有默认值!!! public|private|internal 也可用于修饰状态变量。 public变量会自动生成同名的getter函数,用于查询数值。未标明可见性类型的状态变量,默认为internal。

Prue 和 view :: 一句话总结: 当不需要读取和写入链上的状态变量 用prue 当只读不写的时候 用view 最重要的是:用户从外部调用包含这两个关键字的函数时不消耗gas! internal v.s. external: 1.可见性 internal :只有在当前合约内部以及当前合约派生的合约内部访问,外部不可以! external:可以从合约外部通过交易访问,也可以在派生合约中被访问 (this.Functionname()) 2.gas开销: external: 接收参数时会把参数存在calldate区域,节省gas internal :处理合约内部调用更加高效 ,不需要处理外部调用的一些额外开销. 接收参数时会把参数存在memory

payable: // payable: 递钱,能给合约支付eth的函数 function minusPayable() external payable returns(uint256 balance) { minus();
balance = address(this).balance; }

calldate -------wait day05----...

函数返回值return 和 returns : returns 跟在函数名后面,用于声明返回值的变量类型及变量名 (可以不声明变量名哦 只是不推荐这么写哈哈哈) return:写在函数主体内,返回指定变量. // 返回多个变量 function returnMultiple() public pure returns(uint256, bool, uint256[3] memory){ return(1, true, [uint256(1),2,5]); } 这里 1,2,5 要强转成uint256() 因为编译器默认为uint8 类型不匹配 下面是返回类型: 命名式返回: // 命名式返回 function returnNamed() public pure returns(uint256 _number, bool _bool, uint256[3] memory _array){ _number = 2; _bool = false; _array = [uint256(3),2,1]; } //不需要return 只需要为returns里声明的变量赋值即可 当然 return 也不错哈

// 命名式返回,依然支持return function returnNamed2() public pure returns(uint256 _number, bool _bool, uint256[3] memory _array){ return(1, true, [uint256(1),2,5]); } 解构式赋值: uint256 _number; bool _bool; uint256[3] memory _array; (_number, _bool, _array) = returnNamed(); 如果只想读取部分 e.g. _array (, ,_array ) = returnNamed();

2024.09.26

变量数据存储和作用域
Morkdown笔记的用法...

1.Solidity 变量数据存储和作用域

引用类型(Reference Type)

  • 包括数组(array)和结构体(struct)

  • 占用存储空间大,使用时必须声明数据存储位置 (这就是为啥数组后面不加memory会报错的原因哈) 数据存储位置

  • storage

    • 合约里的状态变量默认使用
    • 存储在链上,类似计算机硬盘
    • 消耗 gas 多
  • memory

    • 用于函数参数和临时变量
    • 存储在内存中,不上链
    • 花费gas 少,
  • calldata

    • 类似 memory,存储在内存中,不上链
    • 变量不可修改(immutable)
    • 常用于函数参数

数据位置赋值规则 基于传值和传址

  • storage 到 local storage:创建引用,修改会影响原变量
  • memory 到 memory:创建引用,修改会影响原变量
  • 其他情况:创建独立副本,修改不影响原变量
uint[] x = [1,2,3]; // 状态变量:数组 x

function fStorage() public{
    //声明一个storage的变量 xStorage,指向x。**修改xStorage也会影响x**
    uint[] storage xStorage = x;
    xStorage[0] = 100;
}

变量作用域

  • 状态变量
    • 存储在链上
    • 所有合约内函数可访问
    • gas 消耗高
    contract Variables {
    uint public a1 = 1;
    uint public y=999;
   
}
  • 局部变量
    • 仅在函数执行过程中有效
    • 存储在内存中,不上链
    • gas 消耗低
function bar() external pure returns(uint){
    uint xx = 1;
    uint yy = 3;
    uint zz = xx + yy;
    return(zz);
}
  • 全局变量

    • Solidity 预留关键字
    • 可在函数内直接使用,无需声明
    • 全局变量使用文档 就比如下面: 以太单位与时间单位
      solidity中不存在小数点!! 用0来代替小数点,来确保交易的精度
  • 以太单位:wei, gwei, ether

  • wei: 1

  • gewi: 1e9=1000000000

  • ether: 1e18=1000000000000000000

    时间单位:可以在合约中规定一个操作必须在一周内完成,或者某个事件在一个月后发生。这样就能让合约的执行可以更加精确,不会因为技术上的误差而影响合约的结果。

  • 时间单位:seconds, minutes, hours, days, weeks

2024.09.27

引用类型

数组 array

可存整数,字节,地址等等。 分为可变长(动态)和固定长度(静态)数组

  • 固定长度数组

    • 基本格式: T[k] T是元素类型 K是长度
    uint[8] public a;
    address[100] public a1;
  • 动态数组

    • T[]
    uint[] array1; 

    ==bytes==比较特殊!!

    • bytes是数组 但是不用加[]
    • 不能用byte[]声明单字节数组
    • 可以用bytesbytes1[]

数组创建规则

  • 对memory 修饰的动态数组,用new来创建,但是必须声明长度! 且长度不可改变
  • [1,2,3] 不声明类型的情况下 会默认uint8 声明则按找第一个元素为准
uint[] memory array=new uint[](5);

数组成员

  • length: 数组长度
  • push(): 添加0元素
  • push(x):在数组最后添加一个元素x
  • pop():去除栈顶元素(最后一个)

结构体 Struct

结构体元素类型可以是原始类型,也可以是引用类型

结构体可以作为数组或映射的元素(?)

struct student{
    string public name;
    uint8: public scroe;
}

给结构体赋值的四种方法:
// 方法1:在函数中创建一个storage的struct引用
 function method1() public {
        student storage s = student({name: "Alice", score: 80});
    }
// 方法2:直接引用状态变量的struct
 student public s2 = student("Bob", 90);
// 方法3:构造函数式
 student public s3;
 constructor() {
        s3 = student("Charlie", 75);
    }
// 方法4:key value
    student public s4;
    function method4() public {
        s4 = student({name: "David", score: 85});
    }

2024.09.28

映射类型

一、功能与特性

  • 高效的键值存储
  • mapping 允许你根据特定的键来快速查找对应的值。它类似于其他编程语言中的字典或哈希表结构
  • 例如,mapping(uint => string) myMapping;可以将无符号整数类型的键映射到字符串类型的值。
  • mapping 类型的数据在存储上相对灵活。每个键值对是独立存储的,不占用连续的内存空间

二、局限性

不可遍历

  • mapping 不能直接进行遍历,无法像数组那样通过循环依次访问所有的元素。
  • 这是因为 mapping 没有固定的顺序,并且 Solidity 目前没有提供直接遍历 mapping 的方法。

参数与返回值限制

  • mapping 不能作为函数的外部参数或返回值,除非是在内部函数调用中。
  • 这意味着你不能直接将一个 mapping 传递给另一个合约的函数,或者从一个函数中返回一个 mapping。

三、映射规则

规则 1

  • 映射的_KeyType只能选择 Solidity 内置的值类型,比如uint、address等,不能用自定义的结构体。
  • 而_ValueType可以使用自定义的类型。

规则 2

  • 映射的存储位置必须是storage,因此可以用于合约的状态变量、函数中的storage变量和library函数的参数。

四、映射的原理

  • 原理1: 映射不储存任何键(Key)的资讯,也没有length的资讯。
  • 原理2: 映射使用keccak256(abi.encodePacked(key, slot))当成offset存取value,其中slot是映射变量定义所在的插槽位置。(暂时不懂)
  • 原理3: 因为Ethereum会定义所有未使用的空间为0,所以未赋值(Value)的键(Key)初始值都是各个type的默认值,如uint的默认值是0。

2024.09.29

变量的初始值

值类型:

  • boolean: false
  • string:""
  • int/uint: 0
  • enum:枚举的第一个元素
  • address:address(0)/ 0x0x0000000000000000000000000000000000000000(20个零)
  • function ++ internal: 空白函数 ++ external: 空白函数

关于address为什么是20个字节

一、安全性考虑

  • 降低碰撞概率:较长的地址长度大大降低了随机生成两个相同地址的可能性。在区块链这样的分布式系统中,确保地址的唯一性对于资产的安全至关重要。如果地址长度过短,碰撞的概率会增加,可能导致资产被错误地发送到错误的地址或者被恶意攻击者通过地址碰撞进行攻击。
  • 抗攻击能力:20 字节的长度使得通过暴力破解等方式猜测地址变得极其困难。在密码学中,较长的密钥长度通常意味着更高的安全性,地址的长度也遵循了这一原则。攻击者需要巨大的计算资源和时间才能尝试出有效的地址,从而增加了攻击的成本和难度。

二、数学和密码学基础

  • 哈希函数的结果:在区块链中,地址通常是通过对公钥等信息进行哈希运算得到的。常见的哈希算法如 SHA-256 等会产生固定长度的输出。经过一系列的处理和转换,最终得到的地址长度为 20 字节,这与哈希函数的特性和密码学的设计有关。
  • 椭圆曲线加密:许多区块链使用椭圆曲线加密算法来生成公钥和私钥对。在这种加密体系中,公钥的长度通常与地址长度相关。20 字节的地址长度可以与椭圆曲线加密算法的参数相匹配,确保加密和签名的安全性和有效性。 三、网络效率和兼容性
  • 数据传输和存储效率:在区块链网络中,节点之间需要频繁地传输和存储地址信息。20 字节的长度在保证安全性的前提下,相对较为紧凑,可以减少网络传输的带宽占用和节点的存储需求。这对于大规模的区块链网络来说非常重要,可以提高网络的效率和可扩展性。
  • 兼容性和标准化:采用固定的 20 字节长度地址有助于实现不同区块链系统之间的兼容性和互操作性。如果地址长度不统一,不同的区块链平台之间进行交互和集成将变得更加困难。标准化的地址长度使得开发者可以更容易地构建跨链应用和工具,促进区块链生态系统的发展。

引用类型初始值

  • 映射mapping: 所有元素都为其默认值的mapping
  • 结构体struct: 所有成员设为其默认值的结构体
  • 数组array ++ 动态数组: [] ++ 静态数组(定长): 所有成员设为其默认值的静态数组

delete操作符

delete a会让变量a的值变为初始值。

2024.09.30

constant and immutable

  • Constant常量和immutable不变量 使用变量声明这俩关键字后,不能在初始化函数之后更改数值
  • 提高合约安全性
  • 节省gas

constant

  • 必须在声明的时候初始化,之后也不能改变!!
  • 尝试改变就会报错!
uint constant a=99;
uint constant address=0x0x0000000000000000000000000000000000000078;

immutable

  • 可以在声明时 或者 在 构造函数constuctor中初始化
contract MyContract {
    uint immutable c;

    constructor(uint _value) {
        c = _value;
    }
}

+ 可以使用全局变量例如**address(this)****block.number **或者自定义的函数给immutable变量初始化

2024.10.01

控制流

一、条件语句(if-else)

if (condition) {
    // 条件为真时执行的代码
} else {
    // 条件为假时执行的代码
}

二、循环语句(for、while、do-while)

1. for 循环

for (initialization; condition; increment) {
    // 循环体代码
}
  • initialization:初始化循环变量。
  • condition:循环继续的条件。
  • increment:在每次循环迭代后执行的操作,通常用于更新循环变量。

2. while 循环

while (condition) {
    // 循环体代码
}
  • 只要条件为真,就会一直执行循环体。

3. do-while 循环

do {
    // 循环体代码
} while (condition);
  • 先执行一次循环体,然后再检查条件是否为真,如果为真则继续循环。

三、开关语句(switch)

switch (expression) {
    case value1:
        // 当 expression 等于 value1 时执行的代码
        break;
    case value2:
        // 当 expression 等于 value2 时执行的代码
        break;
    default:
        // 当 expression 不等于任何 case 值时执行的代码
}

2024.10.01

一、构造函数

  • 构造函数是在合约创建时被自动调用的特殊函数,用于初始化合约的状态变量。
  • 可以设置合约的初始状态,例如初始化变量的值、设置权限等。
  • 确保合约在创建时处于一个合理的初始状态,方便后续的使用和交互。
    contract MyContract {
        uint public myVariable;

        constructor(uint _initialValue) {
            myVariable = _initialValue;
        }
    }

二、修饰器

修饰器是一种可以用来修改函数行为的特殊函数。它可以在函数执行前或执行后添加额外的逻辑。

  • 可以实现代码的复用,避免在多个函数中重复编写相同的逻辑。
  • 可以对函数的输入参数进行验证,提高合约的安全性。
  • 可以在函数执行前后记录日志、进行权限检查等操作。
    modifier onlyOwner {
        require(msg.sender == owner, "Only the owner can call this function.");
        _;
    }
    function myFunction() onlyOwner {
        // Function body
    }
//带有onlyOwner修饰符的函数只能被owner地址调用
  • 多个修饰器的使用:可以在一个函数上同时使用多个修饰器,它们会按照顺序依次执行。
    modifier modifier1 {
        // Modifier 1 logic
        _;
    }

    modifier modifier2 {
        // Modifier 2 logic
        _;
    }

    function myFunction() modifier1 modifier2 {
        // Function body
    }
  • myFunction函数会先执行modifier1的逻辑,然后执行modifier2的逻辑,最后执行函数本身的逻辑。

2024.10.02

事件

**事件(Events)**是一种方便的工具,用于在区块链上记录和通知外部应用程序发生的特定操作。

一、事件的定义

  • 事件通过使用event关键字来定义。
event Transfer(address indexed from, address indexed to, uint256 value);

二、触发事件

在合约的函数中,使用emit关键字来触发事件。

function transfer(address _to, uint256 _value) public {
    emit Transfer(msg.sender, _to, _value);
}

//当调用transfer函数时,会触发Transfer事件,记录这次转移操作。

三、事件的作用

外部应用程序监听:外部的区块链节点或 DApp 可以监听特定的事件,以便实时了解合约中发生的操作。这对于构建实时监控、用户界面更新等功能非常有用。

   myContract.events.Transfer({
       fromBlock: 0
   }, function(error, event) {
       console.log(event);
   });
  • 记录操作历史:事件提供了一种在区块链上记录操作的方式,方便后续的审计和查询。
  • 提高透明度:事件使得合约的操作更加透明,用户和开发者可以更容易地了解合约的行为。

四、事件的特点

  • 低成本:触发事件的成本相对较低,不会消耗大量的 gas。
  • 不可变:一旦事件被触发并记录在区块链上,就无法被修改或删除。

2024.10.03

继承

一、继承的概念和作用

它可以显著减少重复代码,提高开发效率和代码的可维护性。如果把合约看作是对象,Solidity 支持面向对象的编程风格,通过继承实现代码的复用和扩展。 二、继承的规则 virtual关键字:在父合约中的函数,如果希望子合约重写,需要加上virtual关键字。这表示该函数可以在子合约中被重新定义。

function hip() public virtual{
    emit Log("Yeye");
}
  • override关键字:子合约重写了父合约中的函数,需要加上override关键字。这明确表示该函数是对父合约中同名函数的重写。
function hip() public virtual override{
    emit Log("Baba");
}
  • 修饰public变量的重写:用override修饰public变量,会重写与变量同名的getter函数。

三、简单继承

  • 首先定义一个父合约,例如爷爷合约Yeye,包含一个事件和多个函数。
contract Yeye {
    event Log(string msg);

    function hip() public virtual{
        emit Log("Yeye");
    }

    function pop() public virtual{
        emit Log("Yeye");
    }

    function yeye() public virtual {
        emit Log("Yeye");
    }
}
contract Baba is Yeye{
    function hip() public virtual override{
        emit Log("Baba");
    }

    function pop() public virtual override{
        emit Log("Baba");
    }

    function baba() public virtual{
        emit Log("Baba");
    }
}

四、多重继承

  • Solidity 的合约可以继承多个合约。继承时要按辈分最高到最低的顺序排列。
  • 例如,写一个合约Erzi,继承Yeye合约和Baba合约,应写成contract Erzi is Yeye, Baba,否则会报错。
  • 如果某一函数在多个继承的合约里都存在,在子合约里必须重写,否则会报错。重写在多个父合约中都重名的函数时,override关键字后面要加上所有父合约名字,例如override(Yeye, Baba)。

五、修饰器的继承

Solidity 中的修饰器也可以继承。用法与函数继承类似,在相应的地方加virtual和override关键字即可。

contract Base1 {
    modifier exactDividedBy2And3(uint _a) virtual {
        require(_a % 2 == 0 && _a % 3 == 0);
        _;
    }
}

contract Identifier is Base1 {
    // 可以使用父合约的修饰器
    function getExactDividedBy2And3(uint _dividend) public exactDividedBy2And3(_dividend) pure returns(uint, uint) {
        return getExactDividedBy2And3WithoutModifier(_dividend);
    }

    // 也可以重写修饰器
    modifier exactDividedBy2And3(uint _a) override {
        _;
        require(_a % 2 == 0 && _a % 3 == 0);
    }
}

六、构造函数的继承

  • 子合约有两种方法继承父合约的构造函数:
  • 在继承时声明父构造函数的参数,例如contract B is A(1)。
  • 在子合约的构造函数中声明构造函数的参数:
contract C is A {
    constructor(uint _c) A(_c * _c) {}
}

七、调用父合约的函数

  • 直接调用:子合约可以直接用父合约名.函数名()的方式来调用父合约函数。
function callParent() public{
    Yeye.pop();
}
``
- super关键字:子合约可以利用super.函数名()来调用最近的父合约函数。但在多重+菱形继承链条上使用super关键字时,会调用继承链条上的每一个合约的相关函数,而不是只调用最近的父合约。
## 八、钻石继承
**钻石继承指一个派生类同时有两个或两个以上的基类**。在 Solidity 中,虽然多个子合约继承同一个父合约,但整个过程中父合约只会被调用一次。Solidity 借鉴了 Python 的方式,强制一个由基类构成的 DAG(有向无环图)使其保证一个特定的顺序。

```solidity

contract God {
    event Log(string message);

    function foo() public virtual {
        emit Log("God.foo called");
    }

    function bar() public virtual {
        emit Log("God.bar called");
    }
}

contract Adam is God {
    function foo() public virtual override {
        emit Log("Adam.foo called");
        super.foo();
    }

    function bar() public virtual override {
        emit Log("Adam.bar called");
        super.bar();
    }
}

contract Eve is God {
    function foo() public virtual override {
        emit Log("Eve.foo called");
        super.foo();
    }

    function bar() public virtual override {
        emit Log("Eve.bar called");
        super.bar();
    }
}

contract people is Adam, Eve {
    function foo() public override(Adam, Eve) {
        super.foo();
    }

    function bar() public override(Adam, Eve) {
        super.bar();
    }
}
  • 调用合约people中的super.bar()会依次调用Eve、Adam,最后是God合约。

2024.10.07

一、抽象合约

  • 包含至少一个未实现函数的合约被称为抽象合约。
  • 抽象合约不能被实例化,只能作为其他合约的基类被继承。
  • 用于定义一组函数的规范,让继承它的合约来具体实现这些函数。
  • 可以实现代码的复用和模块化设计。
  • 使用** abstract 关键字**声明抽象合约。
  • 未实现的函数通常使用 **virtual **关键字标记,并在继承的合约中使用 override 关键字实现。
   abstract contract BaseContract {
       function someFunction() public virtual returns (uint);
   }

   contract DerivedContract is BaseContract {
       function someFunction() public override returns (uint) {
           return 42;
       }
   }

二、接口

  • 接口是一种特殊的抽象合约,只包含函数声明,不能有函数实现、状态变量或构造函数。

  • 接口用于定义合约之间的交互规范。

  • 确保不同的合约之间有一致的函数调用方式,便于合约之间的交互和集成。

  • 可以作为一种设计约束,保证实现接口的合约满足特定的功能要求。

  • 使用 interface 关键字声明接口。

  • 接口中的函数只能是外部函数(external)或公共函数(public)。

   interface IToken {
       function transfer(address to, uint amount) external returns (bool);
   }

   contract MyContract {
       function sendTokens(IToken token, address to, uint amount) public {
           token.transfer(to, amount);
       }
   }

三、IERC721 事件

  • Transfer 事件:在转账时被释放,记录代币的发出地址from,接收地址to和tokenId。
  • Approval 事件:在授权时被释放,记录授权地址owner,被授权地址approved和tokenId。
  • ApprovalForAll 事件:在批量授权时被释放,记录批量授权的发出地址owner,被授权地址operator和授权与否的approved。

四、IERC721 函数

  • balanceOf:返回某地址的 NFT 持有量balance。
  • ownerOf:返回某tokenId的主人owner。
  • transferFrom:普通转账,参数为转出地址from,接收地址to和tokenId。
  • safeTransferFrom:安全转账(如果接收方是合约地址,会要求实现ERC721Receiver接口)。参数为转出地址from,接收地址to和tokenId。
  • approve:授权另一个地址使用你的 NFT。参数为被授权地址approve和tokenId。
  • getApproved:查询tokenId被批准给了哪个地址。
  • setApprovalForAll:将自己持有的该系列 NFT 批量授权给某个地址operator。
  • isApprovedForAll:查询某地址的 NFT 是否批量授权给了另一个operator地址。
  • safeTransferFrom:安全转账的重载函数,参数里面包含了data。

五、什么时候使用接口

如果知道一个合约实现了IERC721接口,不需要知道它具体代码实现,就可以与它交互。例如,无聊猿 BAYC 属于 ERC721 代币,实现了IERC721接口的功能。只需知道它的合约地址,用IERC721接口就可以与它交互,比如用balanceOf()来查询某个地址的 BAYC 余额,用safeTransferFrom()来转账 BAYC。

contract interactBAYC {
    // 利用 BAYC 地址创建接口合约变量(ETH 主网)
    IERC721 BAYC = IERC721(0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D);

    // 通过接口调用 BAYC 的 balanceOf() 查询持仓量
    function balanceOfBAYC(address owner) external view returns (uint256 balance){
        return BAYC.balanceOf(owner);
    }

    // 通过接口调用 BAYC 的 safeTransferFrom() 安全转账
    function safeTransferFromBAYC(address from, address to, uint256 tokenId) external{
        BAYC.safeTransferFrom(from, to, tokenId);
    }
}