Updating with mainnet deployment March 8th, 2026 (#124)

Author: mod

docs/build/api/contracts/api-reference/app-registry.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # AppRegistry
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/AppRegistry.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/AppRegistry.sol)
 
 **Inherits:**
 [Locker](/src/Locker.sol/abstract.Locker.md), [ISlash](/src/interfaces/ISlash.sol/interface.ISlash.md), AccessControl
@@ -25,6 +25,10 @@ No collateral weight for parameter administration — this registry is purely fo
 collateral management and slashing. See NodeRegistry for the parameter-administration-enabled
 variant used by node operators.
 Slashing can occur in both Locked and Unlocking states.
+Adjudicators are not economically incentivised by slash outcomes by design.
+Dispute initiators pay the adjudicator's handling fee off-chain (similar to
+arbitration forums / ODRP). This avoids creating perverse incentives around
+decision outcomes.
 
 
 ## State Variables
@@ -36,7 +40,7 @@ bytes32 public constant ADJUDICATOR_ROLE = keccak256("ADJUDICATOR_ROLE")
 
 
 ### slashCooldown
-Minimum time (seconds) that must elapse between any two slash calls.
+Minimum time (seconds) that must elapse between consecutive slashes by the same adjudicator.
 
 
 ```solidity
@@ -45,11 +49,21 @@ uint256 public slashCooldown
 
 
 ### lastSlashTimestamp
-Timestamp of the last successful slash.
+Timestamp of the last successful slash per adjudicator.
 
 
 ```solidity
-uint256 public lastSlashTimestamp
+mapping(address => uint256) public lastSlashTimestamp
+```
+
+
+### minSlashAmount
+Minimum slash amount. Slashes below this are rejected unless `amount == balance`
+(full-balance slash). Prevents zero-amount or dust slashes from resetting the cooldown.
+
+
+```solidity
+uint256 public minSlashAmount
 ```
 
 
@@ -63,7 +77,7 @@ constructor(address asset_, uint256 unlockPeriod_, address admin_) Locker(asset_
 
 ### setSlashCooldown
 
-Sets the global cooldown between slash calls.
+Sets the per-adjudicator cooldown between slash calls.
 
 
 ```solidity
@@ -76,6 +90,21 @@ function setSlashCooldown(uint256 newCooldown) external onlyRole(DEFAULT_ADMIN_R
 |`newCooldown`|`uint256`|The new cooldown in seconds (0 disables the cooldown).|
 
 
+### setMinSlashAmount
+
+Sets the minimum slash amount.
+
+
+```solidity
+function setMinSlashAmount(uint256 newAmount) external onlyRole(DEFAULT_ADMIN_ROLE);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`newAmount`|`uint256`|The new minimum amount (0 disables the minimum).|
+
+
 ### slash
 
 Reduces a user's locked balance and transfers the slashed tokens
@@ -105,6 +134,12 @@ function slash(address user, uint256 amount, address recipient, bytes calldata d
 event SlashCooldownUpdated(uint256 oldCooldown, uint256 newCooldown);
 ```
 
+### MinSlashAmountUpdated
+
+```solidity
+event MinSlashAmountUpdated(uint256 oldAmount, uint256 newAmount);
+```
+
 ## Errors
 ### SlashCooldownActive
 

docs/build/api/contracts/api-reference/faucet.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # Faucet
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Faucet.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/Faucet.sol)
 
 **Title:**
 Faucet — YELLOW testnet token faucet

docs/build/api/contracts/api-reference/interfaces/ilock.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # ILock
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/interfaces/ILock.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/interfaces/ILock.sol)
 
 **Title:**
 ILock
@@ -146,14 +146,15 @@ event Relocked(address indexed user, uint256 balance);
 ### Withdrawn
 
 ```solidity
-event Withdrawn(address indexed user, uint256 balance);
+event Withdrawn(address indexed user, address indexed destination, uint256 balance);
 ```
 
 **Parameters**
 
 |Name|Type|Description|
 |----|----|-----------|
 |`user`|`address`|The user that withdrew.|
+|`destination`|`address`|The address that received the tokens.|
 |`balance`|`uint256`|The amount withdrawn.|
 
 ## Errors

docs/build/api/contracts/api-reference/interfaces/islash.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # ISlash
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/interfaces/ISlash.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/interfaces/ISlash.sol)
 
 **Title:**
 ISlash
@@ -68,3 +68,19 @@ The recipient cannot be the adjudicator calling slash.
 error RecipientIsAdjudicator();
 ```
 
+### RecipientIsUser
+The recipient cannot be the slashed user.
+
+
+```solidity
+error RecipientIsUser();
+```
+
+### SlashAmountTooLow
+The slash amount is below the minimum and does not equal the full balance.
+
+
+```solidity
+error SlashAmountTooLow();
+```
+

docs/build/api/contracts/api-reference/locker.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # Locker
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Locker.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/Locker.sol)
 
 **Inherits:**
 [ILock](/src/interfaces/ILock.sol/interface.ILock.md), ReentrancyGuard

docs/build/api/contracts/api-reference/node-registry.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # NodeRegistry
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/NodeRegistry.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/NodeRegistry.sol)
 
 **Inherits:**
 [Locker](/src/Locker.sol/abstract.Locker.md), Votes

docs/build/api/contracts/api-reference/treasury.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # Treasury
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Treasury.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/Treasury.sol)
 
 **Inherits:**
 Ownable2Step, ReentrancyGuard

docs/build/api/contracts/api-reference/yellow-governor.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # YellowGovernor
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Governor.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/Governor.sol)
 
 **Inherits:**
 Governor, GovernorSettings, GovernorCountingSimple, GovernorVotes, GovernorVotesQuorumFraction, GovernorTimelockControl, GovernorPreventLateQuorum, GovernorProposalGuardian

docs/build/api/contracts/api-reference/yellow-token.md

@@ -6,7 +6,7 @@ displayed_sidebar: buildSidebar
 ---
 
 # YellowToken
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Token.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/dcd9928fb0cdf7b35bc4cae06401284b2529d311/src/Token.sol)
 
 **Inherits:**
 ERC20Permit

docs/build/api/contracts/faq.md

@@ -1,7 +1,7 @@
 ---
 title: "FAQ"
 description: "Frequently asked questions about Yellow Network smart contracts."
-sidebar_position: 7
+sidebar_position: 2
 displayed_sidebar: buildSidebar
 ---