diff --git a/modules/architecture/pages/staking.adoc b/modules/architecture/pages/staking.adoc index 7a54f5c383..989551c882 100644 --- a/modules/architecture/pages/staking.adoc +++ b/modules/architecture/pages/staking.adoc @@ -326,8 +326,9 @@ The following procedures are only intended for developers who are either interes | Entering a delegation pool | Invoke the delegation pool contract's https://github.com/starkware-libs/starknet-staking/blob/main/docs/spec.md#enter_delegation_pool[`enter_delegation_pool`^] function -a| * `amount` should be denominated in FRI (i.e., 1*10^18^ = 1 STRK) -* You must first approve the transfer of STRK tokens to the delegation pool contract by invoking the STRK contract's `approve` function +a| * Use this when delegating to a pool **for the first time** +* `amount` should be denominated in FRI (i.e., 1×10^18^ = 1 STRK) +* You must first approve the transfer of STRK tokens to the delegation pool contract by invoking the STRK contract’s `approve` function | Claiming rewards | Invoke the delegation pool contract's https://github.com/starkware-libs/starknet-staking/blob/main/docs/spec.md#claim_rewards-1[`claim_rewards`^] function @@ -335,8 +336,9 @@ a| * `amount` should be denominated in FRI (i.e., 1*10^18^ = 1 STRK) | Adding to a delegation pool | Invoke the delegation pool contract's https://github.com/starkware-libs/starknet-staking/blob/main/docs/spec.md#add_to_delegation_pool[`add_to_delegation_pool`^] function -a| * `amount` should be denominated in FRI (i.e., 1*10^18^ = 1 STRK) -* You must first approve the transfer of STRK tokens to the delegation pool contract by invoking the STRK contract's `approve` function +a| * Use this when **adding more tokens** to a pool you have already entered +* `amount` should be denominated in FRI (i.e., 1×10^18^ = 1 STRK) +* You must first approve the transfer of STRK tokens to the delegation pool contract by invoking the STRK contract’s `approve` function | Switching delegation pools | Invoke the delegation pool contract's https://github.com/starkware-libs/starknet-staking/blob/main/docs/spec.md#switch_delegation_pool[`switch_delegation_pool`^] function