在上一课中，我们已经完成了一个最简单的合约部署流程。这一课我们将重点学习与合约交互，包括如何调用函数、读取状态和修改变量。
Solidity 合约不是 REST API —— 与它交互不是发个 HTTP 请求那么简单。
合约代码：Counter.sol
我们从一个最基础的合约开始：
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract Counter {
uint256 public count;
function increment() public {
count += 1;
}
function getCount() public view returns (uint256) {
return count;
}
}
count是一个状态变量。getCount()是一个 view 函数（只读）。increment()是一个修改函数（会产生交易）。
一、Solidity 不是 REST API
| 操作 | REST 等价 | Solidity 中的意义 | | :--------- | :-------------------- | :-------------------------- | | 读取数据 | GET /resource | call 调用 view/pure 函数 | | 修改数据 | POST /resource/update | sendTransaction (broadcast) | | 请求者身份 | token / session | msg.sender | | 状态存储 | DB / memory | 链上状态 (state) |
二、读取 (View)
function getCount() public view returns (uint256)
- 读取性调用，不需要 Gas
- 不会生成交易，不会上链
- 用于前端展示或本地 call 操作
Foundry示例:
Counter.s.sol：
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "forge-std/Script.sol";
import "../src/Counter.sol";
contract CounterScript is Script {
function run() external {
// 开始广播，使用本地 anvil 的私钥
vm.startBroadcast();
// 部署合约
Counter counter = new Counter();
// // 调用 increment()
// counter.increment();
// 调用 getCount()
uint256 count = counter.getCount();
console.log("Count is:", count); // 打印输出，方便查看
vm.stopBroadcast();
}
}
执行:
# 配置私钥
$ export PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
# 查询私钥对应账户的余额
$ cast balance 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --rpc-url http://127.0.0.1:8545 --ether
10000.000000000000000000
# 执行脚本
$ forge script script/Counter.s.sol --rpc-url http://127.0.0.1:8545 -vv
# 再次查询余额，余额并没有减少
$ cast balance 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --rpc-url http://127.0.0.1:8545 --ether
10000.000000000000000000
三、修改 (Transaction)
function increment() public
- 需要 发起交易 （sendTransaction）
- 需要 签名 和 Gas 费用
- 会产生新的 block 和 state change
Foundry示例:
删除上面Counter.s.sol中调用increment()的注释即可。
配合命令:
$ forge script script/Counter.s.sol:CounterScript --rpc-url http://127.0.0.1:8545 --broadcast --private-key $PRIVATE_KEY -vv
# 再次查询余额，因为要发起交易
$ cast balance 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --rpc-url http://127.0.0.1:8545 --ether
9999.999866064999866065
四、msg.sender 的作用
msg.sender 是什么？
在 Solidity 中：
msg.sender是当前调用合约的账户地址或合约地址。
它代表当前 消息（调用）发送者，具体取决于调用上下文。
举个例子：
- 如果你用钱包或脚本直接调用合约函数，那么：
msg.sender= 你的钱包地址（或脚本里广播用的地址）
- 如果你通过另一个合约间接调用：
msg.sender= 调用者合约的地址，而不是原始用户
常见用途：
| 场景 | 用法 |
| :--------------- | :------------------------------------------- |
| 权限控制 | require(msg.sender == owner, "Not owner"); |
| 记录谁调用了函数 | logs.push(msg.sender); |
| 发 token、NFT | _mint(msg.sender, 1); |
Foundry示例:
在我们执行的合约中增加一个 whoAmI() 函数：
function whoAmI() public view returns (address) {
return msg.sender;
}
然后我们在 Counter.s.sol 脚本中增加一个新的脚本合约 WhoAmIScript:
contract WhoAmIScript is Script {
function run() external {
vm.startBroadcast();
// 部署合约
Counter counter = new Counter();
address sender = counter.whoAmI();
console.log("msg.sender returned by whoAmI():", sender);
vm.stopBroadcast();
}
}
执行命令:
# 配置私钥
$ export PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
# 这里我们使用配置的私钥来部署这个合约，所以会收到返回消息 `msg.sender returned by whoAmI(): 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266`
$ forge script script/Counter.s.sol:WhoAmIScript --rpc-url http://127.0.0.1:8545 --broadcast --private-key $PRIVATE_KEY -vv
五、忽隐忽现的 --broadcast --private-key
在上面的操作中，--broadcast --private-key 这两个参数时而出现，时而消失，为什么呢？
这是一个非常关键的问题，理解 --broadcast 和 --private-key 的用途，有助于你区分交易仿真和实际上链之间的根本区别。
先说结论：
| 命令类型 | 是否需要 --broadcast | 是否需要 --private-key | 是否发真实交易 | 是否消耗 gas | 用途说明 |
|:--------------------- |:------------------ |:------------------- |:---------------- |:-------- |:------------------------ |
| forge simulate（仿真） | ❌ | ❌ | ❌ | ❌ | 只是仿真，不上链 |
| forge script（仿真/模拟） | ❌ | ❌ | ❌ | ❌ | 只是模拟执行，不发交易 |
| forge script（发送交易） | ✅ | ✅ | ✅ | ✅ | 真实发送交易，上链 |
| cast call（只读函数） | ❌ | ❌ | ❌ | ❌ | 链下读取 view/pure 函数 |
| cast send（写操作） | ✅ | ✅ | ✅ | ✅ | 发送写操作，如 mint、转账等 |
举个例子
1. 读取操作（只读函数，如 getCount() 或 whoAmI()）
不需要发交易：
$ forge script script/ViewOnly.s.sol:ViewOnly --rpc-url http://127.0.0.1:8545
或者：
$ cast call 0x... "getCount()" --rpc-url http://127.0.0.1:8545
因为这些是 view 函数调用（不改变状态），底层调用的是 eth_call，属于 EVM 仿真，不会上链、不计 gas、不需要签名。
2. 写操作（改变状态的函数，如 increment()）
如果你希望脚本 真的发送交易，你必须加入：
--broadcast：明确告诉 Foundry，要发出交易--private-key：提供签名者（即谁发送交易）
$ forge script script/CounterScript.s.sol:CounterScript \
--rpc-url http://127.0.0.1:8545 \
--private-key $PRIVATE_KEY \
--broadcast \
-vv
如果你不加
--broadcast，脚本会“演一下” increment 的逻辑，但不会真的把它写入区块链状态。
原理解析
| 参数 | 背后逻辑 |
| ---------------- | ------------------------------------ |
| --broadcast | 把模拟的交易真正发出去（eth_sendRawTransaction） |
| --private-key | 用于签名交易，没有就无法广播 |
| 不加 --broadcast | 默认只仿真交易（用 eth_call 方式模拟 EVM 执行） |
实际建议
| 情况 | 是否加参数 |
| :----------------- | :----------------------------------- |
| 你只是测试脚本逻辑、打印数据等 | ❌ 不加 --broadcast、不加私钥 |
| 你想部署合约或更改链上状态 | ✅ 加 --broadcast 和 --private-key |
| 你调用纯 view/pure 函数 | ❌ 直接用 cast call 或脚本仿真 |
声明：本作品采用署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)进行许可，使用时请注明出处。
Author: mengbin
blog: mengbin
Github: mengbin92
腾讯云开发者社区：孟斯特