add source code annotations

Author: MichaelTrestman

docs/keys/proxies/create-proxy.md

@@ -94,7 +94,7 @@ After submitting the transaction, check the Polkadot.JS web app's **Explorer** p
 
 :::warning
 
-- With the SmallTransfer proxy type, transfers are limited to less than 0.5 TAO (500,000,000 RAO). Use the Transfer proxy type for amounts above this limit.
+- With the SmallTransfer proxy type, transfers are limited to less than 0.5 TAO (500,000,000 RAO). Use the Transfer proxy type for amounts above this limit. See [source code: SmallTransfer limit definition](https://github.com/opentensor/subtensor/blob/main/common/src/lib.rs#L43).
 - The delegate account must hold enough funds to cover transaction fees, which are approximately 25 µTAO (0.000025 TAO).
   :::
 
@@ -178,9 +178,9 @@ After the announcement waiting period has passed, the delegate account can now e
 
 ## Troubleshooting
 
-- `proxy.Duplicate`: A proxy with the same configuration already exists on the real account.
-- `proxy.Unannounced`: A non-zero delay proxy requires an announcement; announce and wait the delay.
-- `proxy.Unproxyable`/`system.CallFiltered`: The call is not permitted under the current `ProxyType`.
-- `proxy.TooMany`: You exceeded `MaxProxies` or `MaxPending`. Remove unused proxies/announcements.
-- `proxy.NotProxy`: Ensure you’re submitting from the delegate account and referencing the correct real account.
+- `proxy.Duplicate`: A proxy with the same configuration already exists on the real account. See [source code: `Duplicate` error](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L739).
+- `proxy.Unannounced`: A non-zero delay proxy requires an announcement; announce and wait the delay. See [source code: `Unannounced` error](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L743).
+- `proxy.Unproxyable`/`system.CallFiltered`: The call is not permitted under the current `ProxyType`. See [source code: `Unproxyable` error](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L737).
+- `proxy.TooMany`: You exceeded `MaxProxies` or `MaxPending`. Remove unused proxies/announcements. See [source code: `TooMany` error](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L731).
+- `proxy.NotProxy`: Ensure you're submitting from the delegate account and referencing the correct real account. See [source code: `NotProxy` error](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L735).
 - `Token.FundsUnavailable`: Ensure that your real account has enough available funds to cover the transaction.

docs/keys/proxies/index.md

@@ -65,7 +65,7 @@ The following table shows the available `ProxyType` options and their descriptio
 | `NonCritical`            | Allows only non-critical operations.                                                |
 | `NonTransfer`            | Blocks all transfer operations.                                                     |
 | `Senate`                 | Allows senate governance operations.                                                |
-| `NonFungible`            | Blocks all TAO transfer or movement.                                                |
+| `NonFungibile` (sic)     | Blocks all TAO transfer or movement.                                                |
 | `Triumvirate`            | Allows triumvirate governance operations.                                           |
 | `Governance`             | Covers both senate and triumvirate governance operations.                           |
 | `Staking`                | Allows staking-related operations.                                                  |
@@ -77,6 +77,8 @@ The following table shows the available `ProxyType` options and their descriptio
 | `SwapHotkey`             | Allows hotkey swap operations.                                                      |
 | `SubnetLeaseBeneficiary` | Allows management of leased subnets.                                                |
 
+See [source code: ProxyType enum definition](https://github.com/opentensor/subtensor/blob/main/common/src/lib.rs#L144-L162) and [source code: proxy filtering implementation](https://github.com/opentensor/subtensor/blob/main/runtime/src/lib.rs#L678-L884).
+
 ### Choosing the Right `ProxyType`
 
 When setting up proxies, always follow the principle of least privilege. Choose the narrowest `ProxyType` that covers the intended actions instead of defaulting to broad permissions. For example:
@@ -92,8 +94,8 @@ Only use the unrestricted `Any` type when no other option fits. If a proxy call
 
 To ensure scalability and prevent abuse, proxy usage is subject to certain limits as shown:
 
-- **`MaxProxies`**: This refers to the maximum number of delegate accounts that can be linked to a single real account. Each account can register up to 20 proxies in total. See [source code](https://github.com/opentensor/subtensor/blob/main/runtime/src/lib.rs#L644).
-- **`MaxPending`**: This refers to the maximum number of pending announcements that a delegate account can have. This limit helps prevent excessive queuing. Each account can have up to 75 pending announcements at a time. See [source code](https://github.com/opentensor/subtensor/blob/main/runtime/src/lib.rs#L645).
+- **`MaxProxies`**: This refers to the maximum number of delegate accounts that can be linked to a single real account. Each account can register up to 20 proxies in total. See [source code: MaxProxies configuration](https://github.com/opentensor/subtensor/blob/main/runtime/src/lib.rs#L670).
+- **`MaxPending`**: This refers to the maximum number of pending announcements that a delegate account can have. This limit helps prevent excessive queuing. Each account can have up to 75 pending announcements at a time. See [source code: MaxPending configuration](https://github.com/opentensor/subtensor/blob/main/runtime/src/lib.rs#L671).
 
 ## Best practices for using proxies
 

docs/keys/proxies/pure-proxies.md

@@ -25,7 +25,7 @@ All transactions involving a pure proxy must be signed by the delegator account.
 When submitting calls with the `proxy(real, forceProxyType, call)` extrinsic, the pure proxy account is passed as the `real` argument, while the delegator signs the transaction. This effectively reverses the usual proxy relationship where the proxy account only authorizes the transaction, while the real account appears as the origin on chain.
 
 :::info
-You can modify who signs for a pure proxy by assigning another account as its _any proxy_. This is done by executing a proxy call that creates a standard proxy with the `Any` proxy type. The new account can then sign on behalf of the pure proxy—for example, when updating signers in a multisig wallet.
+You can modify who signs for a pure proxy by assigning another account as its _any proxy_. This is done by executing a proxy call that creates a standard proxy with the `Any` proxy type. The new account can then sign on behalf of the pure proxy—for example, when updating signers in a multisig wallet. See [source code: pure proxy account generation](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L827-L850).
 :::
 
 ## Prerequisites
@@ -39,7 +39,7 @@ You can modify who signs for a pure proxy by assigning another account as its _a
 
 ## Create a pure proxy
 
-Use the `proxy::createPure` extrinsic to create a pure proxy as shown:
+Use the `proxy::createPure` extrinsic to create a pure proxy as shown. See [source code: `createPure` implementation](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L328-L360):
 
 1. In the navbar menu, navigate to **Developers** → **Extrinsics**.
 2. Under “using the selected account”, pick the delegator account.
@@ -92,7 +92,7 @@ Importing the proxy account makes it selectable in the Polkadot-JS web app UI.
 
 ### Kill a pure proxy
 
-Pure proxies are killed using the `killPure` extrinsic as shown:
+Pure proxies are killed using the `killPure` extrinsic as shown. See [source code: `killPure` implementation](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L380-L406):
 
 1. Go to **Developer** → **Extrinsics**.
 2. Under “using the selected account”, choose the pure proxy account.
@@ -114,6 +114,6 @@ Killing a pure proxy permanently deletes the account and releases its reserved d
 ## Troubleshooting
 
 - `Token.FundsUnavailable`: Ensure thhat the pure proxy account has been funded and has enough funds to cover the transfer.
-- `proxy.NotProxy`: Ensure you’re executing the pure proxy correctly—from the creator account and referencing the pure proxy account as `real`.
-- `Proxy.NoPermission`: The `killPure` call is not permitted under the current.
+- `proxy.NotProxy`: Ensure you're executing the pure proxy correctly—from the creator account and referencing the pure proxy account as `real`. See [source code: `NotProxy` error](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L735).
+- `Proxy.NoPermission`: The `killPure` call is not permitted under the current. See [source code: `NoPermission` error](https://github.com/opentensor/subtensor/blob/main/pallets/proxy/src/lib.rs#L741).
 - `system.CallFiltered`: The call is not permitted under the current `ProxyType`.