@btc-vision/btc-runtime 1.11.0-rc.9 → 1.11.0

package/docs/advanced/quantum-resistance.md

@@ -1,12 +1,12 @@
 # Quantum Resistance
 
-OPNet includes built-in quantum-resistant cryptography through ML-DSA (Module-Lattice Digital Signature Algorithm). The `Address` class provides automatic access to ML-DSA public keys without requiring any custom storage.
+OP_NET includes built-in quantum-resistant cryptography through ML-DSA (Module-Lattice Digital Signature Algorithm). The `Address` class provides automatic access to ML-DSA public keys without requiring any custom storage.
 
 ## Overview
 
 Quantum computers pose a threat to traditional cryptographic schemes:
 
-| Algorithm | Quantum Threat | OPNet Status |
+| Algorithm | Quantum Threat | OP_NET Status |
 |-----------|---------------|--------------|
 | ECDSA | Vulnerable (Shor's algorithm) | Supported (deprecated), transition to ML-DSA |
 | Schnorr | Vulnerable (Shor's algorithm) | Supported, with transition plan |
@@ -40,7 +40,7 @@ const isValid = Blockchain.verifySignature(
 - Existing signatures remain safe (retroactive attack impossible)
 - Future transactions from exposed addresses are at risk
 
-### OPNet's Approach
+### OP_NET's Approach
 
 1. **Dual signature support** - Both Schnorr and ML-DSA signatures
 2. **Extended addresses** - Store both Schnorr (taproot) and ML-DSA key references
@@ -49,7 +49,7 @@ const isValid = Blockchain.verifySignature(
 
 ## ML-DSA Security Levels
 
-OPNet supports three ML-DSA security levels, from classical Schnorr to quantum-resistant ML-DSA:
+OP_NET supports three ML-DSA security levels, from classical Schnorr to quantum-resistant ML-DSA:
 
 ```mermaid
 ---
@@ -57,7 +57,7 @@ config:
   theme: dark
 ---
 flowchart LR
-    subgraph OPNet["OPNet Security Architecture"]
+    subgraph OP_NET["OP_NET Security Architecture"]
         subgraph Classical["Classical Security"]
             C1["Schnorr<br/>256-bit<br/>Classical: Strong<br/>Quantum: Broken"]
         end
@@ -83,7 +83,7 @@ flowchart LR
 | Level3 | ML-DSA-65 | 1,952 bytes | 3,309 bytes | 4,032 bytes | Category 3 (~AES-192) |
 | Level5 | ML-DSA-87 | 2,592 bytes | 4,627 bytes | 4,896 bytes | Category 5 (~AES-256) |
 
-**OPNet uses ML-DSA-44 (Level2) by default**, balancing security and performance.
+**OP_NET uses ML-DSA-44 (Level2) by default**, balancing security and performance.
 
 ### Level Constants
 
@@ -109,7 +109,7 @@ config:
   theme: dark
 ---
 flowchart LR
-    subgraph OPNet["OPNet Quantum-Resistant Signatures"]
+    subgraph OP_NET["OP_NET Quantum-Resistant Signatures"]
         subgraph MLDSA["ML-DSA-44 - Level2 - Default"]
             PK["Public Key<br/>1,312 bytes"]
             SIG["Signature<br/>2,420 bytes"]
@@ -133,7 +133,7 @@ flowchart LR
 
 ### Automatic ML-DSA Key Access
 
-Every `Address` in OPNet stores the SHA256 hash of an ML-DSA public key. The full public key is automatically loaded on demand:
+Every `Address` in OP_NET stores the SHA256 hash of an ML-DSA public key. The full public key is automatically loaded on demand:
 
 ```typescript
 import { Address, Blockchain } from '@btc-vision/btc-runtime/runtime';
@@ -214,7 +214,7 @@ config:
 sequenceDiagram
     participant User as 👤 User
     participant Wallet as Wallet
-    participant Blockchain as OPNet Runtime
+    participant Blockchain as OP_NET Runtime
     participant Contract as Contract
 
     Note over User,Blockchain: Key Generation (Off-chain)
@@ -310,7 +310,7 @@ const isValid = Blockchain.verifyMLDSASignature(
 
 ## Migration Path: Schnorr to ML-DSA
 
-OPNet manages a phased transition from classical to quantum-resistant signatures:
+OP_NET manages a phased transition from classical to quantum-resistant signatures:
 
 ```mermaid
 ---
@@ -319,7 +319,7 @@ config:
 ---
 sequenceDiagram
     participant User as User/Wallet
-    participant Network as OPNet Network
+    participant Network as OP_NET Network
     participant Consensus as Consensus Rules
 
     Note over User,Consensus: Phase 1: Transition Period (Current)
@@ -431,13 +431,13 @@ class QuantumSecureContract extends OP_NET {
 }
 ```
 
-## Solidity vs OPNet: Quantum Resistance Comparison
+## Solidity vs OP_NET: Quantum Resistance Comparison
 
-OPNet is the first smart contract platform with built-in quantum-resistant cryptography. Solidity and the EVM have no quantum resistance capabilities.
+OP_NET is the first smart contract platform with built-in quantum-resistant cryptography. Solidity and the EVM have no quantum resistance capabilities.
 
 ### Feature Comparison Table
 
-| Feature | Solidity/EVM | OPNet | OPNet Advantage |
+| Feature | Solidity/EVM | OP_NET | OP_NET Advantage |
 |---------|--------------|-------|-----------------|
 | **Quantum-Safe Signatures** | Not supported | ML-DSA (FIPS 204) | Future-proof security |
 | **Post-Quantum Algorithm** | None | ML-DSA-44/65/87 | NIST standardized |
@@ -449,16 +449,16 @@ OPNet is the first smart contract platform with built-in quantum-resistant crypt
 
 ### Quantum Threat Analysis
 
-| Algorithm | Shor's Algorithm Impact | Grover's Algorithm Impact | Status in OPNet |
+| Algorithm | Shor's Algorithm Impact | Grover's Algorithm Impact | Status in OP_NET |
 |-----------|------------------------|---------------------------|-----------------|
 | ECDSA (Solidity) | **Broken** (polynomial time) | Weakened | N/A |
-| ECDSA (OPNet) | **Broken** (polynomial time) | Weakened | Deprecated |
-| Schnorr (OPNet) | **Broken** (polynomial time) | Weakened | Transition only |
-| ML-DSA (OPNet) | **Secure** | Minimal impact | **Recommended** |
+| ECDSA (OP_NET) | **Broken** (polynomial time) | Weakened | Deprecated |
+| Schnorr (OP_NET) | **Broken** (polynomial time) | Weakened | Transition only |
+| ML-DSA (OP_NET) | **Secure** | Minimal impact | **Recommended** |
 
 ### Security Level Comparison
 
-| Security Level | Solidity | OPNet ML-DSA | NIST Category | Quantum Security |
+| Security Level | Solidity | OP_NET ML-DSA | NIST Category | Quantum Security |
 |----------------|----------|--------------|---------------|------------------|
 | ~AES-128 equivalent | ECDSA (broken by quantum) | ML-DSA-44 (Level2) | Category 2 | **Secure** |
 | ~AES-192 equivalent | Not available | ML-DSA-65 (Level3) | Category 3 | **Secure** |
@@ -466,7 +466,7 @@ OPNet is the first smart contract platform with built-in quantum-resistant crypt
 
 ### Key and Signature Size Comparison
 
-| Metric | Solidity (ECDSA) | OPNet (Schnorr) | OPNet (ML-DSA-44) | OPNet (ML-DSA-87) |
+| Metric | Solidity (ECDSA) | OP_NET (Schnorr) | OP_NET (ML-DSA-44) | OP_NET (ML-DSA-87) |
 |--------|------------------|-----------------|-------------------|-------------------|
 | Public Key Size | 33/65 bytes | 32 bytes | 1,312 bytes | 2,592 bytes |
 | Signature Size | 65 bytes | 64 bytes | 2,420 bytes | 4,627 bytes |
@@ -475,7 +475,7 @@ OPNet is the first smart contract platform with built-in quantum-resistant crypt
 
 ### Capability Matrix
 
-| Capability | Solidity | OPNet |
+| Capability | Solidity | OP_NET |
 |------------|:--------:|:-----:|
 | ECDSA verification (Ethereum) | Yes | Yes (deprecated) |
 | ECDSA verification (Bitcoin) | No | Yes (deprecated) |
@@ -491,7 +491,7 @@ OPNet is the first smart contract platform with built-in quantum-resistant crypt
 
 ### Timeline: Quantum Threat vs Platform Readiness
 
-| Timeframe | Quantum Computer Status | Solidity Status | OPNet Status |
+| Timeframe | Quantum Computer Status | Solidity Status | OP_NET Status |
 |-----------|------------------------|-----------------|--------------|
 | **2024-2025** | Early NISQ era (~1000 qubits) | Vulnerable (no plan) | ML-DSA ready |
 | **2026-2030** | Scaling (~4000+ qubits possible) | **Critical risk** | Dual-key transition |
@@ -511,7 +511,7 @@ flowchart LR
         S3 --> S4["Funds at risk"]
     end
 
-    subgraph OPNet["OPNet - Built-in Migration"]
+    subgraph OP_NET["OP_NET - Built-in Migration"]
         O1["Schnorr (current)"] --> O2["Dual-key period"]
         O2 --> O3["ML-DSA only"]
         O3 --> O4["Quantum secure"]
@@ -531,7 +531,7 @@ function verify(bytes32 hash, uint8 v, bytes32 r, bytes32 s) external view retur
 
     // CRITICAL VULNERABILITIES:
     // - ECDSA is broken by Shor's algorithm
-    // - No upgrade path to quantum-safe algorithms
+    // - No update path to quantum-safe algorithms
     // - All funds signed with exposed public keys at risk
     // - No way to add ML-DSA or other PQC algorithms
 }
@@ -540,10 +540,10 @@ function verify(bytes32 hash, uint8 v, bytes32 r, bytes32 s) external view retur
 // EIP proposals for PQC have not been implemented
 ```
 
-#### OPNet: Built-in Quantum Resistance
+#### OP_NET: Built-in Quantum Resistance
 
 ```typescript
-// OPNet - Quantum-resistant
+// OP_NET - Quantum-resistant
 @method(
     { name: 'hash', type: ABIDataTypes.BYTES32 },
     { name: 'signature', type: ABIDataTypes.BYTES },
@@ -596,7 +596,7 @@ contract SolidityContract {
 ```
 
 ```typescript
-// OPNet - Automatic key access
+// OP_NET - Automatic key access
 @final
 class OPNetContract extends OP_NET {
 
@@ -615,12 +615,12 @@ class OPNetContract extends OP_NET {
 }
 ```
 
-### Why OPNet for Quantum Security?
+### Why OP_NET for Quantum Security?
 
-| Solidity Limitation | OPNet Solution |
+| Solidity Limitation | OP_NET Solution |
 |---------------------|----------------|
 | ECDSA only (quantum vulnerable) | ML-DSA (quantum resistant) |
-| No upgrade path | Built-in consensus migration |
+| No update path | Built-in consensus migration |
 | Must store large keys manually | Automatic key loading |
 | No NIST PQC algorithms | FIPS 204 ML-DSA |
 | Single key per address | Dual-key architecture |
@@ -630,9 +630,9 @@ class OPNetContract extends OP_NET {
 
 ### Cost Comparison
 
-| Operation | Solidity | OPNet Cost | Notes |
+| Operation | Solidity | OP_NET Cost | Notes |
 |-----------|----------|------------|-------|
-| Store ML-DSA public key | Not practical (1,312 bytes) | 0 | OPNet loads automatically |
+| Store ML-DSA public key | Not practical (1,312 bytes) | 0 | OP_NET loads automatically |
 | Store ML-DSA signature | Not practical (2,420 bytes) | N/A | Not stored, verified |
 | Quantum-safe verification | Not possible | Standard | No additional cost |
 | Key migration | Contract redeploy | Consensus-managed | No user action needed |

package/docs/advanced/signature-verification.md

@@ -1,6 +1,6 @@
 # Signature Verification
 
-OPNet supports multiple signature schemes for authentication and authorization. This guide covers Schnorr signatures, ECDSA (secp256k1), quantum-resistant ML-DSA, and common verification patterns.
+OP_NET supports multiple signature schemes for authentication and authorization. This guide covers Schnorr signatures, ECDSA (secp256k1), quantum-resistant ML-DSA, and common verification patterns.
 
 ## Overview
 
@@ -41,7 +41,7 @@ const isValidBTC: bool = Blockchain.verifyBitcoinECDSASignature(
 
 ## Signature Scheme Comparison
 
-OPNet supports Schnorr, ECDSA (secp256k1), and quantum-resistant ML-DSA signatures:
+OP_NET supports Schnorr, ECDSA (secp256k1), and quantum-resistant ML-DSA signatures:
 
 ```mermaid
 ---
@@ -49,7 +49,7 @@ config:
   theme: dark
 ---
 flowchart LR
-    subgraph OPNet["OPNet Signature Verification"]
+    subgraph OP_NET["OP_NET Signature Verification"]
         subgraph ECDSA["ECDSA - Legacy (Deprecated)"]
             E1["Public Key: 33/64/65 bytes"]
             E2["Signature: 64 or 65 bytes"]
@@ -118,7 +118,7 @@ config:
 ---
 sequenceDiagram
     participant Contract as Contract
-    participant Blockchain as OPNet Runtime
+    participant Blockchain as OP_NET Runtime
     participant SchnorrVerifier as Schnorr Verifier
     participant ExtendedAddress as ExtendedAddress
 
@@ -161,7 +161,7 @@ config:
 ---
 sequenceDiagram
     participant Contract as Contract
-    participant Blockchain as OPNet Runtime
+    participant Blockchain as OP_NET Runtime
     participant MLDSAVerifier as ML-DSA Verifier
     participant Address as Address
 
@@ -205,11 +205,11 @@ const isValid = Blockchain.verifyMLDSASignature(
 | Level3 | ML-DSA-65 | 1,952 bytes | 3,309 bytes | Category 3 (~AES-192) |
 | Level5 | ML-DSA-87 | 2,592 bytes | 4,627 bytes | Category 5 (~AES-256) |
 
-**OPNet uses ML-DSA-44 (Level2) by default.**
+**OP_NET uses ML-DSA-44 (Level2) by default.**
 
 ## ECDSA Verification (Deprecated)
 
-OPNet now supports ECDSA (secp256k1) signatures for backward compatibility with Ethereum and Bitcoin ecosystems. These methods are **deprecated** and only available when `UNSAFE_QUANTUM_SIGNATURES_ALLOWED` consensus flag is set.
+OP_NET now supports ECDSA (secp256k1) signatures for backward compatibility with Ethereum and Bitcoin ecosystems. These methods are **deprecated** and only available when `UNSAFE_QUANTUM_SIGNATURES_ALLOWED` consensus flag is set.
 
 ### Ethereum ECDSA (ecrecover model)
 
@@ -257,7 +257,7 @@ Both ECDSA methods emit a runtime `WARNING` and are gated behind the `UNSAFE_QUA
 
 ## Keccak-256 Hashing
 
-OPNet includes a built-in Keccak-256 implementation (Ethereum-compatible, pre-NIST). This is useful for ECDSA-related workflows, Ethereum-style function selectors, and EIP-712 typed data hashing.
+OP_NET includes a built-in Keccak-256 implementation (Ethereum-compatible, pre-NIST). This is useful for ECDSA-related workflows, Ethereum-style function selectors, and EIP-712 typed data hashing.
 
 ```typescript
 import { keccak256, keccak256Concat, functionSelector, ethAddressFromPubKey } from '@btc-vision/btc-runtime/runtime';
@@ -375,7 +375,7 @@ class SignatureContract extends OP_NET {
 
         // Create the message to verify
         const message = new BytesWriter(32);
-        message.writeString('Hello, OPNet!');
+        message.writeString('Hello, OP_NET!');
         const messageHash = sha256(message.getBuffer());
 
         // Verify using consensus-aware method
@@ -420,13 +420,13 @@ class SignatureContract extends OP_NET {
 }
 ```
 
-## Solidity vs OPNet: Signature Verification Comparison
+## Solidity vs OP_NET: Signature Verification Comparison
 
-OPNet provides significant advantages over Solidity for signature verification, including quantum-resistant signatures, native Schnorr support, and simplified APIs.
+OP_NET provides significant advantages over Solidity for signature verification, including quantum-resistant signatures, native Schnorr support, and simplified APIs.
 
 ### Feature Comparison Table
 
-| Feature | Solidity/EVM | OPNet | OPNet Advantage |
+| Feature | Solidity/EVM | OP_NET | OP_NET Advantage |
 |---------|--------------|-------|-----------------|
 | **Primary Signature Scheme** | ECDSA (secp256k1) | Schnorr + ML-DSA + ECDSA | Multiple schemes, quantum-resistant option |
 | **Quantum Resistance** | Not supported | ML-DSA (FIPS 204) | Future-proof security |
@@ -441,7 +441,7 @@ OPNet provides significant advantages over Solidity for signature verification,
 
 ### Signature Scheme Comparison
 
-| Aspect | Solidity (ECDSA) | OPNet (ECDSA) | OPNet (Schnorr) | OPNet (ML-DSA) |
+| Aspect | Solidity (ECDSA) | OP_NET (ECDSA) | OP_NET (Schnorr) | OP_NET (ML-DSA) |
 |--------|------------------|---------------|-----------------|----------------|
 | Algorithm | secp256k1 ECDSA | secp256k1 ECDSA | BIP340 Schnorr | FIPS 204 Lattice |
 | Public Key Size | 33 or 65 bytes | 33, 64, or 65 bytes | 32 bytes | 1,312+ bytes |
@@ -454,7 +454,7 @@ OPNet provides significant advantages over Solidity for signature verification,
 
 ### Capability Matrix
 
-| Capability | Solidity | OPNet |
+| Capability | Solidity | OP_NET |
 |------------|:--------:|:-----:|
 | ECDSA verification (Ethereum ecrecover) | Yes | Yes (deprecated) |
 | ECDSA verification (Bitcoin direct) | No | Yes (deprecated) |
@@ -502,10 +502,10 @@ function verifySignature(
 }
 ```
 
-#### OPNet: verifySignature
+#### OP_NET: verifySignature
 
 ```typescript
-// OPNet - verifySignature (simple, safe)
+// OP_NET - verifySignature (simple, safe)
 function verifySignature(
     signer: Address,
     signature: Uint8Array,
@@ -557,7 +557,7 @@ function permit(
 ```
 
 ```typescript
-// OPNet
+// OP_NET
 @method(
     { name: 'owner', type: ABIDataTypes.ADDRESS },
     { name: 'spender', type: ABIDataTypes.ADDRESS },
@@ -593,7 +593,7 @@ public permit(calldata: Calldata): BytesWriter {
 
 ### Security Comparison
 
-| Security Aspect | Solidity | OPNet |
+| Security Aspect | Solidity | OP_NET |
 |-----------------|----------|-------|
 | Signature Malleability | Vulnerable (requires OpenZeppelin) | Not vulnerable |
 | Replay Attack Protection | Manual nonce tracking | Built-in patterns |
@@ -604,7 +604,7 @@ public permit(calldata: Calldata): BytesWriter {
 
 ### Implementation Complexity
 
-| Task | Solidity Lines of Code | OPNet Lines of Code |
+| Task | Solidity Lines of Code | OP_NET Lines of Code |
 |------|:----------------------:|:-------------------:|
 | Basic signature verification | ~15 | ~5 |
 | EIP-712 domain separator | ~20 | ~15 |
@@ -626,7 +626,7 @@ function verify(bytes32 hash, uint8 v, bytes32 r, bytes32 s) public view returns
 ```
 
 ```typescript
-// OPNet - Clear boolean result
+// OP_NET - Clear boolean result
 function verify(hash: Uint8Array, signature: Uint8Array, signer: Address): bool {
     // Returns false on invalid signature - no silent failures
     // Returns false on malformed input - no exceptions
@@ -634,9 +634,9 @@ function verify(hash: Uint8Array, signature: Uint8Array, signer: Address): bool
 }
 ```
 
-### Why OPNet for Signature Verification?
+### Why OP_NET for Signature Verification?
 
-| Solidity Limitation | OPNet Solution |
+| Solidity Limitation | OP_NET Solution |
 |---------------------|----------------|
 | ECDSA only | ECDSA + Schnorr + ML-DSA support |
 | No quantum resistance | Built-in ML-DSA (FIPS 204) |

package/docs/api-reference/blockchain.md

@@ -26,7 +26,7 @@ const timestamp = Blockchain.block.medianTimestamp;
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `block.number` | `Blockchain.block.number` |
 | `block.timestamp` | `Blockchain.block.medianTimestamp` |
@@ -51,7 +51,7 @@ const unsafeAllowed = Blockchain.tx.consensus.unsafeSignaturesAllowed();
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `msg.sender` | `Blockchain.tx.sender` |
 | `tx.origin` | `Blockchain.tx.origin` |
@@ -70,7 +70,7 @@ const deployer = Blockchain.contractDeployer;
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `address(this)` | `Blockchain.contractAddress` |
 
@@ -90,7 +90,7 @@ if (Blockchain.network === Networks.Mainnet) {
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `block.chainid` | `Blockchain.chainId` |
 
@@ -280,7 +280,7 @@ public getBalance(address: Address): u256 {
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `mapping(address => uint256) balances` | `AddressMemoryMap` with pointer |
 | `balances[addr] = value` | `Blockchain.setStorageAt(pointerHash, value)` |
@@ -389,7 +389,7 @@ sequenceDiagram
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `target.call(data)` | `Blockchain.call(target, calldata, false)` |
 | `target.functionCall(args)` | `Blockchain.call(target, calldata, true)` |
@@ -449,16 +449,16 @@ updateContractFromExisting(
 | `calldata` | `BytesWriter \| null` | Optional calldata passed to VM (default: empty) |
 
 ```typescript
-// Basic upgrade (not recommended without access control)
+// Basic update (not recommended without access control)
 Blockchain.updateContractFromExisting(newBytecodeAddress);
 
 // With calldata
-const upgradeData = new BytesWriter(32);
-upgradeData.writeU256(migrationVersion);
-Blockchain.updateContractFromExisting(newBytecodeAddress, upgradeData);
+const updateData = new BytesWriter(32);
+updateData.writeU256(migrationVersion);
+Blockchain.updateContractFromExisting(newBytecodeAddress, updateData);
 ```
 
-> **Warning:** This is a privileged operation. Always implement access control (e.g., `onlyDeployer`) and consider using the `Upgradeable` base class or `UpgradeablePlugin` for timelock protection. See [Contract Upgrades](../advanced/contract-upgrades.md) for details.
+> **Warning:** This is a privileged operation. Always implement access control (e.g., `onlyDeployer`) and consider using the `Updatable` base class or `UpdatablePlugin` for timelock protection. See [Contract Updates](../advanced/updatable) for details.
 
 ## Cryptographic Operations
 
@@ -740,7 +740,7 @@ if (Blockchain.isContract(targetAddress)) {
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `address.code.length > 0` | `Blockchain.isContract(address)` |
 
@@ -772,7 +772,7 @@ const hash = Blockchain.getBlockHash(Blockchain.block.number - 10);
 > **Warning:** Only ~256 recent blocks available. Older blocks return zeros.
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `blockhash(blockNumber)` | `Blockchain.getBlockHash(blockNumber)` |
 
@@ -791,7 +791,7 @@ Blockchain.emit(new TransferEvent(from, to, amount));
 ```
 
 **Solidity Comparison:**
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `emit Transfer(from, to, amount)` | `Blockchain.emit(new TransferEvent(from, to, amount))` |
 

package/docs/api-reference/events.md

@@ -507,7 +507,7 @@ class Unpaused extends NetEvent {
 
 ### Indexed-Style Events
 
-While OPNet doesn't have Solidity's indexed parameters, you can structure events for efficient filtering:
+While OP_NET doesn't have Solidity's indexed parameters, you can structure events for efficient filtering:
 
 ```typescript
 @final
@@ -621,7 +621,7 @@ class Withdraw extends NetEvent {
 
 ## Solidity Comparison
 
-| Solidity | OPNet |
+| Solidity | OP_NET |
 |----------|-------|
 | `event Transfer(address indexed from, address indexed to, uint256 value)` | `class TransferredEvent extends NetEvent` |
 | `emit Transfer(from, to, value)` | `emitEvent(new TransferredEvent(operator, from, to, value))` |

package/docs/api-reference/op20.md

@@ -151,7 +151,7 @@ public override onDeployment(calldata: Calldata): void {
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC20) | OPNet (OP20) |
+| Solidity (ERC20) | OP_NET (OP20) |
 |------------------|--------------|
 | `constructor(string name, string symbol)` | `onDeployment(calldata)` + `instantiate()` |
 
@@ -292,7 +292,7 @@ protected _allowance(owner: Address, spender: Address): u256
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC20) | OPNet (OP20) |
+| Solidity (ERC20) | OP_NET (OP20) |
 |------------------|--------------|
 | `function name() view returns (string)` | `name(calldata): BytesWriter` |
 | `function balanceOf(address) view returns (uint256)` | `balanceOf(calldata): BytesWriter` |
@@ -405,7 +405,7 @@ sequenceDiagram
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC20) | OPNet (OP20) |
+| Solidity (ERC20) | OP_NET (OP20) |
 |------------------|--------------|
 | `function transfer(address to, uint256 amount) returns (bool)` | `transfer(calldata): BytesWriter` |
 | `function transferFrom(address from, address to, uint256 amount) returns (bool)` | `transferFrom(calldata): BytesWriter` |
@@ -553,7 +553,7 @@ sequenceDiagram
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC20) | OPNet (OP20) |
+| Solidity (ERC20) | OP_NET (OP20) |
 |------------------|--------------|
 | `function approve(address, uint256) returns (bool)` | N/A (use increaseAllowance/decreaseAllowance) |
 | `function increaseAllowance(address, uint256) returns (bool)` | `increaseAllowance(calldata): BytesWriter` |
@@ -639,7 +639,7 @@ protected _spendAllowance(owner: Address, spender: Address, amount: u256): void
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC20) | OPNet (OP20) |
+| Solidity (ERC20) | OP_NET (OP20) |
 |------------------|--------------|
 | `function _mint(address, uint256) internal` | `_mint(Address, u256): void` |
 | `function _burn(address, uint256) internal` | `_burn(Address, u256): void` |
@@ -781,7 +781,7 @@ class BurnedEvent extends NetEvent {
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC20) | OPNet (OP20) |
+| Solidity (ERC20) | OP_NET (OP20) |
 |------------------|--------------|
 | `event Transfer(address indexed from, address indexed to, uint256 value)` | `TransferredEvent(operator, from, to, amount)` |
 | `event Approval(address indexed owner, address indexed spender, uint256 value)` | `ApprovedEvent(owner, spender, amount)` |
@@ -887,7 +887,7 @@ export class MyToken extends OP20 {
 
 ## Solidity Comparison Summary
 
-| Solidity (ERC20) | OPNet (OP20) |
+| Solidity (ERC20) | OP_NET (OP20) |
 |------------------|--------------|
 | `constructor(...)` | `onDeployment(calldata)` |
 | `function name()` | `name(): string` |

package/docs/api-reference/op721.md

@@ -136,7 +136,7 @@ public instantiate(
 | `skipDeployerVerification` | `boolean` | Skip deployer check (default: false) |
 
 **Solidity Comparison:**
-| Solidity (ERC721) | OPNet (OP721) |
+| Solidity (ERC721) | OP_NET (OP721) |
 |-------------------|---------------|
 | `constructor(string name, string symbol)` | `onDeployment(calldata)` + `instantiate()` |
 
@@ -223,7 +223,7 @@ public isApprovedForAll(owner: Address, operator: Address): bool
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC721) | OPNet (OP721) |
+| Solidity (ERC721) | OP_NET (OP721) |
 |-------------------|---------------|
 | `function ownerOf(uint256) view returns (address)` | `ownerOf(u256): Address` |
 | `function balanceOf(address) view returns (uint256)` | `balanceOf(Address): u256` |
@@ -366,7 +366,7 @@ sequenceDiagram
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC721) | OPNet (OP721) |
+| Solidity (ERC721) | OP_NET (OP721) |
 |-------------------|---------------|
 | `function transferFrom(address, address, uint256)` | `safeTransferFrom(calldata): BytesWriter` |
 | `function safeTransferFrom(address, address, uint256, bytes)` | `safeTransferFrom(calldata): BytesWriter` |
@@ -403,7 +403,7 @@ public setApprovalForAll(calldata: Calldata): BytesWriter
 | approved | bool | 1 byte |
 
 **Solidity Comparison:**
-| Solidity (ERC721) | OPNet (OP721) |
+| Solidity (ERC721) | OP_NET (OP721) |
 |-------------------|---------------|
 | `function approve(address, uint256)` | `approve(calldata): BytesWriter` |
 | `function setApprovalForAll(address, bool)` | `setApprovalForAll(calldata): BytesWriter` |
@@ -515,7 +515,7 @@ protected _isApprovedForAll(owner: Address, operator: Address): boolean
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC721) | OPNet (OP721) |
+| Solidity (ERC721) | OP_NET (OP721) |
 |-------------------|---------------|
 | `function _mint(address, uint256) internal` | `_mint(Address, u256): void` |
 | `function _burn(uint256) internal` | `_burn(u256): void` |
@@ -693,7 +693,7 @@ class URIEvent extends NetEvent {
 ```
 
 **Solidity Comparison:**
-| Solidity (ERC721) | OPNet (OP721) |
+| Solidity (ERC721) | OP_NET (OP721) |
 |-------------------|---------------|
 | `event Transfer(address indexed, address indexed, uint256 indexed)` | `TransferredEvent(operator, from, to, tokenId)` |
 | `event Approval(address indexed, address indexed, uint256 indexed)` | `ApprovedEvent(owner, spender, tokenId)` |
@@ -802,7 +802,7 @@ export class MyNFT extends OP721 {
 
 ## Solidity Comparison Summary
 
-| Solidity (ERC721) | OPNet (OP721) |
+| Solidity (ERC721) | OP_NET (OP721) |
 |-------------------|---------------|
 | `constructor(name, symbol)` | `instantiate(new OP721InitParameters(name, symbol, baseURI, maxSupply, ...))` |
 | `function ownerOf(uint256)` | `ownerOf(u256): Address` |

package/docs/api-reference/storage.md

@@ -1,6 +1,6 @@
 # Storage API Reference
 
-Storage classes provide persistent state management for OPNet smart contracts.
+Storage classes provide persistent state management for OP_NET smart contracts.
 
 ## Import
 
@@ -714,7 +714,7 @@ public updateBoth(a: u256, b: u256): void {
 
 ## Solidity Comparison
 
-| Solidity | OPNet Storage |
+| Solidity | OP_NET Storage |
 |----------|---------------|
 | `uint256 public value` | `StoredU256` |
 | `mapping(address => uint256)` | `AddressMemoryMap` |