Updating docs

Author: mod

docs/contracts/AppRegistry.sol/contract.AppRegistry.md

@@ -1,5 +1,5 @@
 # AppRegistry
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/AppRegistry.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/AppRegistry.sol)
 
 **Inherits:**
 [Locker](/src/Locker.sol/abstract.Locker.md), [ISlash](/src/interfaces/ISlash.sol/interface.ISlash.md), AccessControl
@@ -18,6 +18,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
@@ -29,7 +33,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
@@ -38,11 +42,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
 ```
 
 
@@ -56,7 +70,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
@@ -69,6 +83,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
@@ -98,6 +127,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/contracts/Faucet.sol/contract.Faucet.md

@@ -1,5 +1,5 @@
 # Faucet
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Faucet.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/Faucet.sol)
 
 **Title:**
 Faucet — YELLOW testnet token faucet

docs/contracts/Governor.sol/contract.YellowGovernor.md

@@ -1,5 +1,5 @@
 # YellowGovernor
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Governor.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/Governor.sol)
 
 **Inherits:**
 Governor, GovernorSettings, GovernorCountingSimple, GovernorVotes, GovernorVotesQuorumFraction, GovernorTimelockControl, GovernorPreventLateQuorum, GovernorProposalGuardian

docs/contracts/Locker.sol/abstract.Locker.md

@@ -1,5 +1,5 @@
 # Locker
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Locker.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/Locker.sol)
 
 **Inherits:**
 [ILock](/src/interfaces/ILock.sol/interface.ILock.md), ReentrancyGuard

docs/contracts/NodeRegistry.sol/constants.NodeRegistry.md

@@ -1,5 +1,5 @@
 # Constants
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/NodeRegistry.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/NodeRegistry.sol)
 
 ### NAME
 

docs/contracts/NodeRegistry.sol/contract.NodeRegistry.md

@@ -1,5 +1,5 @@
 # NodeRegistry
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/NodeRegistry.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/NodeRegistry.sol)
 
 **Inherits:**
 [Locker](/src/Locker.sol/abstract.Locker.md), Votes

docs/contracts/Token.sol/contract.YellowToken.md

@@ -1,5 +1,5 @@
 # YellowToken
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Token.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/Token.sol)
 
 **Inherits:**
 ERC20Permit

docs/contracts/Treasury.sol/contract.Treasury.md

@@ -1,5 +1,5 @@
 # Treasury
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/Treasury.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/Treasury.sol)
 
 **Inherits:**
 Ownable2Step, ReentrancyGuard

docs/contracts/interfaces/ILock.sol/interface.ILock.md

@@ -1,5 +1,5 @@
 # ILock
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/interfaces/ILock.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/interfaces/ILock.sol)
 
 **Title:**
 ILock
@@ -139,14 +139,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/contracts/interfaces/ISlash.sol/interface.ISlash.md

@@ -1,5 +1,5 @@
 # ISlash
-[Git Source](https://github.com/layer-3/yellow/blob/f97fcc52ddfdc5918cb91b2af5538abb0060ee27/src/interfaces/ISlash.sol)
+[Git Source](https://github.com/layer-3/yellow/blob/081e9e5ab0ebd446958aa9ad2a2b9aa91b26a69c/src/interfaces/ISlash.sol)
 
 **Title:**
 ISlash
@@ -61,3 +61,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();
+```
+