Solidity private 状态变量链上可读:eth_getStorageAt 按槽位还原动态字符串
blockchain/solidity · verified
一句话结论
Solidity 的 private 只限制合约代码内部的访问权限,不加密链上存储;任何人只要能拿到合约地址和部署时的存储布局,就能用 JSON-RPC 的 eth_getStorageAt 直接读取指定槽位,按动态字符串的规则拼接连续槽位并解码出明文,所谓“私有变量”并不具备机密性。
原理
- EVM 存储是公开的键值空间:每个合约账户都有 2^256 个 32 字节槽位,状态变量按声明顺序从槽 0 开始分配(常量、immutable、结构体/数组另有规则)。
eth_getStorageAt(address, slot, block)直接返回某个槽的 32 字节原始值,不需要调用合约函数,也不需要任何权限。 private的语义:private只阻止其他合约和外部调用者通过 Solidity 接口访问变量;它不会加密数据,也不会阻止读取底层 storage。真正需要保密的数据必须加密后上链,或只把承诺/哈希放上链、明文留在链下。- 动态字符串/字节数组的布局:若
string private flag位于槽p,槽p本身通常存放length * 2 + 1(长度标记与数据位置标志),实际数据从keccak256(p)开始,按 32 字节一个槽连续存放;长度超过 31 字节时跨多个槽。 - 本题的槽位:flag 是槽 0 上的长字符串,数据起始槽为
keccak256(32 字节全零),即0x290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e563。flag 长 79 字节,跨 3 个槽;读取 base、base+1、base+2 三个 32 字节字并拼接,截取前 79 字节,即为 flag 的 ASCII。 - 为什么能还原:字符串数据在槽内是从低位地址开始、左对齐连续存放的;多个槽按 base 递增顺序拼接后就是原始字节流。只要知道字符串长度(可从槽
p的低位读出,或按题目提示),截掉末尾填充即可。 - 常见误区:
private变量在区块浏览器/Solidity 源码中看不到,但链上节点的eth_getStorageAt、调试器debug_storageRangeAt、以及任何归档节点都能读取;把 API key、口令、flag 直接写成private string是最常见的链上泄露。
触发条件
- 目标合约在链上部署,攻击者知道合约地址与所用网络(主网/Sepolia 等)。
- 目标把敏感数据(口令、flag、密钥材料)存进合约状态变量,且没有额外加密/承诺方案。
- 攻击者能访问支持
eth_getStorageAt的 RPC 节点(公共 RPC、自建节点、归档节点均可)。 - 知道或能推断状态变量的声明顺序和槽位;对动态字符串还需知道数据起始槽与长度。
- 目标合约未把敏感数据放在
immutable/constant之外的特殊结构里,或即使有结构也能按布局推导。
利用步骤
- 获取合约地址、网络与 RPC URL;可在区块浏览器查看合约创建交易和已验证源码(若开源),确认状态变量声明顺序。
- 确定目标变量所在槽
p(第一个状态变量为 0,依此类推);若变量是动态字符串/数组,计算数据起始槽keccak256(p)。 - 用
eth_getStorageAt读取base、base+1、base+2等连续槽;每个返回值是 0x 前缀的 32 字节十六进制。 - 去掉
0x后按读取顺序拼接;若知道字符串长度 L,取前2*L个十六进制字符,转字节后按 ASCII/UTF-8 解码。 - 若不知道长度:读取槽
p的原始值,length = value // 2(最低位为 1 表示长字符串);或从拼接结果尾部去掉00填充后解码。 - 对结构体/数组/映射:按 Solidity 存储布局递归计算槽位;映射槽为
keccak256(key . slot),动态数组元素从keccak256(slot)开始。 - 用
eth_call调用公开 getter 交叉验证;若 getter 不存在,直接以原始 storage 为准。
PoC
import requests
CONTRACT = "0x88DC8f1de5Ff74d644C1a1defDc54869E5Ce3c08"
RPC_URL = "https://ethereum-sepolia-rpc.publicnode.com"
FLAG_LENGTH = 79
# 槽 0 是动态字符串,数据起始槽 = keccak256(32 字节零)
BASE_SLOT = "0x290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e563"
def get_slot(slot: str) -> str:
r = requests.post(RPC_URL, json={
"jsonrpc": "2.0", "id": 1, "method": "eth_getStorageAt",
"params": [CONTRACT, slot, "latest"],
}, timeout=10)
r.raise_for_status()
return r.json()["result"][2:]
def read_string(length: int) -> str:
raw = ""
base = int(BASE_SLOT, 16)
for i in range((length + 31) // 32):
raw += get_slot(hex(base + i))
return bytes.fromhex(raw[: length * 2]).decode("ascii")
print(read_string(FLAG_LENGTH))
通用槽位计算:
from eth_utils import keccak
def data_slot(p: int) -> int:
return int.from_bytes(keccak(p.to_bytes(32, "big")), "big")
# mapping(address => uint256) at slot p:
# slot = keccak(abi.encode(key, p))
变体与关联
- 固定长度 bytes32/uint256:直接读槽
p即可;bytes32左对齐,uint256右对齐,注意字节序。 - 短字符串(<=31 字节):数据与长度打包在槽
p内,低字节为length*2,高字节为字符串内容;直接按槽内字节解析。 - 动态数组:槽
p存长度,元素从keccak256(p)开始;结构体数组还要按元素步长跳槽。 - 映射:
keccak256(abi.encode(key, p));嵌套映射逐层计算。 - 升级代理:逻辑合约的 storage 布局由代理槽位决定,需按代理的存储布局读取;EIP-1967 实现槽本身也可读。
- 关联卡片:[[blockchain-solidity-evm-guess-honeypot-detection]](同样依赖 EVM storage 可见性识别合约状态);[[blockchain-wallet-safe-delegatecall-slot0-mastercopy-hijack]](存储槽覆盖型攻击)。
检测与防御
- 不要把秘密放在链上:任何写入合约 storage 的数据都应视为公开;敏感数据使用链下存储 + 链上哈希/承诺,或使用经过审计的加密方案。
- 最小化上链数据:只存必要状态;避免把口令、API key、私钥、flag、个人数据写入
private变量。 - 审计存储布局:检查合约是否有
private/internal敏感字段、动态字符串跨槽、代理布局冲突;用eth_getStorageAt做一次只读自查。 - 权限与可观测性:对 RPC 访问做限流与审计;监控大量连续
eth_getStorageAt调用(尤其是同一合约相邻槽位),可能是自动化读取。 - 密钥管理:链上合约不应持有长期密钥;必须使用时采用门限签名、HSM、链下签名等方案。