Merge pull request #3406 from OffchainLabs/update-stylus-admonitions-fences

Apply formatting conventions to Stylus docs

Author: anegg0

docs/stylus/advanced/hostio-exports.mdx

@@ -19,9 +19,11 @@ Hostio functions are the foundational layer that powers all Stylus smart contrac
 - Understanding gas costs and execution flow
 - Debugging and troubleshooting contract behavior
 
-:::info
+<VanillaAdmonition type="info">
+
 Most developers should use the high-level SDK wrappers instead of calling hostio functions directly. The SDK provides safe, ergonomic interfaces that handle memory management and error checking automatically.
-:::
+
+</VanillaAdmonition>
 
 ## How hostio works
 
@@ -103,9 +105,11 @@ Gets the code hash of an account. Equivalent to EVM's `EXTCODEHASH` opcode.
 pub fn account_codehash(address: *const u8, dest: *mut u8);
 ```
 
-:::note
+<VanillaAdmonition type="note">
+
 Empty accounts return the keccak256 hash of empty bytes: `c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470`
-:::
+
+</VanillaAdmonition>
 
 ### Storage operations
 
@@ -132,9 +136,11 @@ Writes a 32-byte value to the storage cache. Equivalent to EVM's `SSTORE` opcode
 pub fn storage_cache_bytes32(key: *const u8, value: *const u8);
 ```
 
-:::warning
+<VanillaAdmonition type="warning">
+
 Values are cached and must be persisted using `storage_flush_cache` before they're permanently written to storage.
-:::
+
+</VanillaAdmonition>
 
 #### `storage_flush_cache`
 
@@ -200,9 +206,11 @@ Gets a bounded estimate of the L1 block number when the transaction was sequence
 pub fn block_number() -> u64;
 ```
 
-:::info
+<VanillaAdmonition type="info">
+
 See [Arbitrum block numbers and time](/arbitrum-essentials/arbitrum-vs-ethereum/block-numbers-and-time) for more information on how block numbers work on Arbitrum chains.
-:::
+
+</VanillaAdmonition>
 
 #### `block_timestamp`
 
@@ -228,9 +236,11 @@ pub fn msg_sender(sender: *mut u8);
 
 - `sender`: Pointer to write the 20-byte address
 
-:::note
+<VanillaAdmonition type="note">
+
 For L1-to-L2 retryable ticket transactions, addresses are aliased. See [address aliasing documentation](/how-arbitrum-works/deep-dives/l1-to-l2-messaging#address-aliasing).
-:::
+
+</VanillaAdmonition>
 
 #### `msg_value`
 
@@ -334,9 +344,11 @@ pub fn delegate_call_contract(
 ) -> u8;
 ```
 
-:::warning
+<VanillaAdmonition type="warning">
+
 Delegate calls execute code in the context of the current contract. Be extremely careful when delegate calling to untrusted contracts, as they have full access to your storage.
-:::
+
+</VanillaAdmonition>
 
 #### `static_call_contract`
 
@@ -427,9 +439,11 @@ pub fn emit_log(data: *const u8, len: usize, topics: usize);
 - `len`: Total length of data, including topics
 - `topics`: Number of topics (0-4)
 
-:::warning
+<VanillaAdmonition type="warning">
+
 Requesting more than 4 topics will cause a revert.
-:::
+
+</VanillaAdmonition>
 
 **Higher-level usage:**
 
@@ -466,9 +480,11 @@ Gets the amount of ink remaining—a Stylus-specific metering unit.
 pub fn evm_ink_left() -> u64;
 ```
 
-:::info
+<VanillaAdmonition type="info">
+
 Ink is Stylus's compute pricing unit. See [Ink and Gas](https://docs.arbitrum.io/stylus/concepts/gas-metering) for conversion between ink and gas.
-:::
+
+</VanillaAdmonition>
 
 #### `pay_for_memory_grow`
 
@@ -478,9 +494,11 @@ Pays for WASM memory growth. Automatically called when allocating new pages.
 pub fn pay_for_memory_grow(pages: u16);
 ```
 
-:::note
+<VanillaAdmonition type="note">
+
 The `entrypoint!` macro handles importing this hostio. Manual calls will unproductively consume gas.
-:::
+
+</VanillaAdmonition>
 
 ### Cryptography
 
@@ -520,9 +538,11 @@ Reads the program calldata. Equivalent to EVM's `CALLDATACOPY` opcode.
 pub fn read_args(dest: *mut u8);
 ```
 
-:::note
+<VanillaAdmonition type="note">
+
 This reads all of the calldata of the call.
-:::
+
+</VanillaAdmonition>
 
 #### `read_return_data`
 

docs/stylus/cli-tools/debugging-tx.mdx

@@ -196,9 +196,11 @@ The `replay` command allows you to debug transaction execution interactively:
 cargo stylus replay --tx=$TX_HASH --endpoint=$RPC_URL --use-native-tracer
 ```
 
-:::note
+<VanillaAdmonition type="note">
+
 The `--use-native-tracer` flag uses `stylusTracer` instead of `jsTracer`, which is required for tracing Stylus transactions on most RPC providers. See [RPC endpoint compatibility](#rpc-endpoint-compatibility) for details.
-:::
+
+</VanillaAdmonition>
 
 The debugger loads and sets a breakpoint at the `user_entrypoint` function:
 

docs/stylus/how-tos/caching-contracts.mdx

@@ -50,7 +50,7 @@ uint192 minBid = cacheManager.getMinBid(contractAddress);
 
 Here, the [`contractAddress`] is the address of the Stylus contract you want to cache.
 
-```bash
+```shell
 cargo stylus cache suggest-bid [contractAddress]
 ```
 
@@ -70,7 +70,7 @@ cacheManager.placeBid{value: bidAmount}(contractAddress);
 
 You can place a bid using the `cargo stylus cache bid` command:
 
-```bash
+```shell
 cargo stylus cache bid <--private-key-path <PRIVATE_KEY_PATH>|--private-key <PRIVATE_KEY>|--keystore-path <KEYSTORE_PATH>> [contractAddress] [bidAmount]
 ```
 
@@ -83,7 +83,7 @@ If you specify a bid amount using `cargo stylus`, it will automatically validate
 
 To check if a specific address is cached, you can use the `cargo stylus status` command:
 
-```bash
+```shell
 cargo stylus cache status --address=[contractAddress]
 ```
 

docs/stylus/partials/_stylus-no-multi-inheritance-banner-partial.mdx

@@ -1,5 +1,5 @@
-:::info
+<VanillaAdmonition type="info">
 
 Stylus doesn't support contract multi-inheritance yet.
 
-:::
+</VanillaAdmonition>

docs/stylus/reference/stylus-toml-reference.mdx

@@ -94,9 +94,11 @@ crate-type = ["lib", "cdylib"]
 - `lib` enables standard Rust imports and testing.
 - `cdylib` produces the WebAssembly binary that gets deployed onchain.
 
-:::caution
+<VanillaAdmonition type="warning">
+
 Removing `cdylib` from `crate-type` prevents the contract from compiling to WASM. Removing `lib` prevents running tests and exporting ABI.
-:::
+
+</VanillaAdmonition>
 
 ### `[dependencies]`
 
@@ -169,9 +171,11 @@ opt-level = 3
 | `panic`         | `abort` | Use immediate abort on panic instead of unwinding (smaller binary).                                                                                      |
 | `opt-level`     | `3`     | Optimize for speed. Use `"s"` or `"z"` to optimize for binary size instead. See [Optimizing binaries](/stylus/how-tos/optimizing-binaries) for guidance. |
 
-:::tip
+<VanillaAdmonition type="tip">
+
 If your contract exceeds the 24KB compressed size limit, change `opt-level` to `"z"` for maximum size reduction. This typically produces smaller binaries at the cost of some runtime performance.
-:::
+
+</VanillaAdmonition>
 
 ## `rust-toolchain.toml`
 
@@ -188,9 +192,11 @@ targets = ["wasm32-unknown-unknown"]
 | `channel` | Rust compiler version. Used by block explorers for deterministic source verification.                           |
 | `targets` | Must include `wasm32-unknown-unknown` for Stylus contracts. Additional targets can be listed for local testing. |
 
-:::caution
+<VanillaAdmonition type="warning">
+
 Changing the Rust version may affect source code verification on block explorers like Arbiscan. Pin to a specific stable version rather than using `stable` or `nightly`.
-:::
+
+</VanillaAdmonition>
 
 ## Complete examples