EVM 兼容性
OXN 在 enclave 内运行一个完全兼容的 EVM。实际上，几乎所有能在以太坊上跑的合约都能在 OXN 上无修改运行。本页记录那少数行为有差异的地方，让你在踩坑前先看到它们。
必须调的编译器设置
把 evmVersion 锁定为 "paris"。 这是 OXN 上最重要的一个设置，也是 "invalid code" 错误最常见的来源。
Solidity 0.8.20 及以后默认 evmVersion: "shanghai"，会生成 PUSH0 opcode (0x5F)。OXN 运行时尚未实现 PUSH0。用 Shanghai 默认编译的合约能成功部署，但运行到 PUSH0 的路径会 revert 报 invalid code——典型 Solidity 产物里这样的路径会有很多个。
| 工具链 | 设置 |
|---|---|
| Hardhat | hardhat.config.js 里 solidity.settings.evmVersion: "paris" |
| Foundry | foundry.toml 里 evm_version = "paris" |
| solc-js | settings.evmVersion: "paris" |
诊断技巧：如果你升级 solc 之后 bytecode.length 显著增大、又开始出 invalid code，很可能就是 PUSH0。paris 编译的 ERC-20 通常约 5.8 KB；shanghai 编译的约 6.2 KB，含约 180 条 PUSH0 指令。
Opcode 支持矩阵
| EVM 版本 | 引入的 opcode | OXN 支持 |
|---|---|---|
| Frontier | 基础指令集 | 完全 |
| Homestead | DELEGATECALL | 完全 |
| Byzantium | RETURNDATASIZE、RETURNDATACOPY、REVERT、STATICCALL | 完全 |
| Constantinople | SHL、SHR、SAR、CREATE2、EXTCODEHASH | 完全 |
| Istanbul | CHAINID、SELFBALANCE、gas 调整 | 完全 |
| Berlin | EIP-2929 gas 重定价 | 完全 |
| London | EIP-1559（base fee）、BASEFEE opcode | 部分（BASEFEE 返回 0 或固定值；无 EIP-1559 费用拍卖） |
| Paris | The Merge（DIFFICULTY → PREVRANDAO） | 完全 |
| Shanghai | PUSH0、warm COINBASE、EIP-3651 | 不 支持 |
| Cancun | 瞬态存储（TLOAD、TSTORE）、MCOPY、BLOBHASH | 不支持 |
设 evmVersion: "paris" 就在支持范围内。
标准 EVM 预编译合约
以太坊标准预编译（0x01 到 0x0a）支持情况：
| 地址 | 功能 | OXN 支持 |
|---|---|---|
0x01 | ecrecover | 完全 |
0x02 | sha256 | 完全 |
0x03 | ripemd160 | 完全 |
0x04 | identity | 完全 |
0x05 | modexp | 完全 |
0x06 | ecAdd（bn128） | 完全 |
0x07 | ecMul（bn128） | 完全 |
0x08 | ecPairing（bn128） | 完全 |
0x09 | blake2f | 完全 |
0x0a | pointEvaluation（KZG） | 不支持 |
OpenZeppelin、Solmate 以及大多数标准库只用 0x01–0x09，这些全部在场。pointEvaluation（用于 EIP-4844 blob 验证）在 OXN 上不需要，因为 OXN 没有 blob 交易。
与以太坊的行为差异
区块环境。
| Opcode / 全局变量 | 以太坊 | OXN |
|---|---|---|
block.number | 以太坊区块高度 | OXN 区块高度 |
block.timestamp | 区块的 Unix 时间戳 | 一致 |
blockhash(n) | 区块 n 的哈希（最近 256） | 一致 |
block.chainid | 1（主网） | 186（OXN 测试网） |
block.coinbase | 矿工 / 提议人地址 | 零地址或固定哨兵值 |
block.difficulty / PREVRANDAO | 随机数信标 | 固定哨兵值——不要用作随机源 |
block.basefee | EIP-1559 base fee | 0 或固定值——当前用 legacy 费用模型 |
随机数。 block.difficulty / PREVRANDAO、block.timestamp、block.hash 都是公开可预测的。在机密合约里不要用它们做随机数。 用 Sapphire.randomBytes 预编译——见预编译：随机数。
Gas 估算。 显式设置 gasLimit，不要依赖 eth_estimateGas。见 Gas 与手续费。
事件日志可见性。 以太坊上：任何观察者都能解码所有事件。OXN 上：加密，只有 emit 它们的调用者能解码。见机密性模型。
Revert reason 可见性。 以太坊上：任何观察者都能读到 revert 原因。OXN 上：加密，只有调用者能解码。没有调用者的会话密钥，从外部调试不可能。
测试合约的 OXN 兼容性
发布前的快速清单：
- 编译器配置里
evmVersion: "paris" - 没有使用
PUSH0（隐式满足——来自 evmVersion） - 不依赖
block.difficulty/PREVRANDAO做随机 - 不依赖 EIP-1559 费用参数（
maxFeePerGas、maxPriorityFeePerGas） - 不使用瞬态存储（
TLOAD、TSTORE） - 每笔交易显式
gasLimit - 事件设计考虑了 OXN 加密模型（如需全局索引，加一份公开事件或用中继）
集成测试跑在 OXN 测试网上，而不是只跑本地 Hardhat network。本地模拟器不建模机密性、不建模 OXN 特有的 opcode 支持。
从以太坊迁移的成本
大多数合约的迁移是两行改动：编译器配置里的 evmVersion: "paris"，加上部署脚本里的显式 gasLimit。
用到加密特性（Sapphire.encrypt、签名查询等）的合约是 OXN 原生的，在公开 EVM 链上编译不过——这是预期。如果迁移目标是让一份合约在以太坊和 OXN 上都能跑，把 OXN 特有代码路径放在开关后或独立合约里。
分步指南见将以太坊 dApp 迁移到 OXN。