Skip to content

Update name from wallet stake permission to Wallet permission #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Sipher merged 6 commits into from
Sep 16, 2025
Merged

Update name from wallet stake permission to Wallet permission #40

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
57120e2
Add Wallet Stake Permission explanations and create guide for setting…
Sipher Sep 11, 2025
569d2c8
Clarify wallet stake permission details and add create guide to enhan…
Sipher Sep 11, 2025
37146a4
Update wallet-stake-permission.mdx
rad2520 Sep 13, 2025
ecc3431
Update wallet-stake-permission.mdx
rad2520 Sep 13, 2025
1e3b4a7
Rename "Wallet Stake Permission" to "Wallet Permission" across docume…
Sipher Sep 16, 2025
f0a8cd5
Merge branch 'main' into dev
Sipher Sep 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions astro.config.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ export default defineConfig({
{ label: "Wallet Stake Permission", slug: "explanations/system/wallet-stake-permission" },
{ label: "Stream Permissions", slug: "explanations/system/stream-permissions" },
{ label: "Capability Permissions", slug: "explanations/system/capability-permissions" },
{ label: "Wallet Permission", slug: "explanations/system/wallet-stake-permission" },
],
Comment on lines +46 to 47
Copy link

@coderabbitai coderabbitai bot Sep 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Sidebar duplicate under Explanations → System.

Two items point to the same slug; keep one labeled “Wallet Permission.”

-                { label: "Wallet Stake Permission", slug: "explanations/system/wallet-stake-permission" },
+                { label: "Wallet Permission", slug: "explanations/system/wallet-stake-permission" },
                 { label: "Stream Permissions", slug: "explanations/system/stream-permissions" },
                 { label: "Capability Permissions", slug: "explanations/system/capability-permissions" },
-                { label: "Wallet Permission", slug: "explanations/system/wallet-stake-permission" },
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
{ label: "Wallet Permission", slug: "explanations/system/wallet-stake-permission" },
],
{ label: "Wallet Permission", slug: "explanations/system/wallet-stake-permission" },
{ label: "Stream Permissions", slug: "explanations/system/stream-permissions" },
{ label: "Capability Permissions", slug: "explanations/system/capability-permissions" },
],
🤖 Prompt for AI Agents 
In astro.config.mjs around lines 46-47, the sidebar under Explanations → System
contains a duplicate entry pointing to the same slug
"explanations/system/wallet-stake-permission"; remove the duplicate array/object
entry so only one item remains labeled "Wallet Permission" (ensure the remaining
entry retains the label and slug exactly as "Wallet Permission" /
"explanations/system/wallet-stake-permission").

},
{
Expand Down Expand Up @@ -91,6 +92,7 @@ export default defineConfig({
{ label: "Create Stream Permission", slug: "how-to-guides/system/create-stream-permission" },
{ label: "Create Wallet Stake Permission", slug: "how-to-guides/system/create-wallet-stake-permission" },
{ label: "Manage Permissions", slug: "how-to-guides/system/manage-permissions" },
{ label: "Create Wallet Permission", slug: "how-to-guides/system/create-wallet-stake-permission" },
],
Comment on lines +95 to 96
Copy link

@coderabbitai coderabbitai bot Sep 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

🧩 Analysis chain

Sidebar duplicate under How‑to Guides → System.

Same slug appears twice. Update the old label and drop the new one.

-                { label: "Create Wallet Stake Permission", slug: "how-to-guides/system/create-wallet-stake-permission" },
+                { label: "Create Wallet Permission", slug: "how-to-guides/system/create-wallet-stake-permission" },
                 { label: "Manage Permissions", slug: "how-to-guides/system/manage-permissions" },
-                { label: "Create Wallet Permission", slug: "how-to-guides/system/create-wallet-stake-permission" },

Quick check for mismatched slugs (“stream-permissions” vs “emission-permissions” used elsewhere):

🏁 Script executed:

#!/bin/bash
rg -nP 'explanations/system/(stream-permissions|emission-permissions)'

Length of output: 942

Sidebar duplicate under How‑to Guides → System + mismatched explanation slugs

  • Update the old label and drop the duplicate so the slug how-to-guides/system/create-wallet-stake-permission appears only once in astro.config.mjs (around lines 95–96).
  • Fix TOC mismatch: src/content/docs/explanations/table-of-contents.mdx:29 currently links "Stream Permissions" to /explanations/system/emission-permissions — change it to /explanations/system/stream-permissions to match astro.config.mjs:44 and the how-to pages (src/content/docs/how-to-guides/system/create-stream-permission.mdx:123; src/content/docs/how-to-guides/system/create-emission-permission.mdx:125).
🤖 Prompt for AI Agents 
In astro.config.mjs around lines 95–96, remove the duplicate sidebar entry for
the slug how-to-guides/system/create-wallet-stake-permission and update the old
label so that the slug appears only once in the list; then in
src/content/docs/explanations/table-of-contents.mdx around line 29, change the
"Stream Permissions" TOC link from /explanations/system/emission-permissions to
/explanations/system/stream-permissions to match astro.config.mjs and the how‑to
pages.

},
{
Expand Down
12 changes: 8 additions & 4 deletions src/content/docs/explanations/system/wallet-stake-permission.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: Wallet Stake Permission
description: Understanding secure wallet staking permissions and delegation.

title: Wallet Permission
description: Understanding secure wallet permissions and delegation.

---

import {
Expand All @@ -17,7 +19,9 @@ The Wallet Permission Scope will enable granular delegation of all wallet operat

**Cold-Hot Key Behavior**

The Wallet Stake Permission enables cold-hot wallet behavior, where high-value secured keys can delegate stake operations to less secure keys utilized only for active protocol participation.

The Wallet Permission enables cold-hot wallet behavior, where high-value secured keys can delegate stake operations to less secure keys utilized only for active protocol participation.


**Tool for Key Security**

Expand All @@ -37,5 +41,5 @@ It's not a perfect security feature and as standard practice it will eventually
- **[Staking](https://docs.torus.network/explanations/holders/staking/)** - Understanding staking mechanics and rewards

<Aside type="tip" title="Ready to Set Up Wallet Delegation?">
Follow our [step-by-step guide to create wallet stake permissions](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) for practical implementation instructions.
Follow our [step-by-step guide to create wallet permissions](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) for practical implementation instructions.
</Aside>
1 change: 1 addition & 0 deletions src/content/docs/explanations/table-of-contents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Core system components and mechanisms:
- [Wallet Stake Permission](https://docs.torus.network/explanations/system/wallet-stake-permission/) — Secure cold-hot wallet staking delegation
- [Stream Permissions](https://docs.torus.network/explanations/system/emission-permissions/) — How emissions are allocated and controlled
- [Capability Permissions](https://docs.torus.network/explanations/system/capability-permissions/) — Fine-grained access control for agent endpoints
- [Wallet Permission](https://docs.torus.network/explanations/system/wallet-stake-permission/) — Secure cold-hot wallet staking delegation
Copy link

@coderabbitai coderabbitai bot Sep 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

🧩 Analysis chain

Duplicate item: consolidate “Wallet Stake Permission” and “Wallet Permission.”

Two entries point to the same slug. Replace the old label and remove the new duplicate.

- - [Wallet Stake Permission](https://docs.torus.network/explanations/system/wallet-stake-permission/) — Secure cold-hot wallet staking delegation
- - [Stream Permissions](https://docs.torus.network/explanations/system/emission-permissions/) — How emissions are allocated and controlled
- - [Capability Permissions](https://docs.torus.network/explanations/system/capability-permissions/) — Fine-grained access control for agent endpoints
- - [Wallet Permission](https://docs.torus.network/explanations/system/wallet-stake-permission/) — Secure cold-hot wallet staking delegation
+ - [Wallet Permission](https://docs.torus.network/explanations/system/wallet-stake-permission/) — Secure cold-hot wallet staking delegation
+ - [Stream Permissions](https://docs.torus.network/explanations/system/emission-permissions/) — How emissions are allocated and controlled
+ - [Capability Permissions](https://docs.torus.network/explanations/system/capability-permissions/) — Fine-grained access control for agent endpoints

To ensure no other duplicates remain:

🏁 Script executed:

#!/bin/bash
rg -nP 'Wallet Stake Permission|Create Wallet Stake Permission|Wallet Permission' -g '!**/node_modules/**'

Length of output: 148

🏁 Script executed:

#!/bin/bash
# Robust re-check for duplicate "Wallet Stake Permission"/"Wallet Permission" entries and show TOC snippet if present.

echo "PWD: $(pwd)"
echo

echo "== Locate likely TOC files =="
if command -v fd >/dev/null 2>&1; then
  fd -HI -e mdx -g '*table*contents*.mdx' || true
else
  echo "fd not installed"
fi
echo

echo "== ripgrep (ignore VCS ignores) =="
if command -v rg >/dev/null 2>&1; then
  rg -n --hidden -S --no-ignore-vcs 'Wallet Stake Permission|Wallet Permission' || true
else
  echo "rg not installed"
fi
echo

echo "== grep fallback =="
grep -nR --exclude-dir=node_modules -e 'Wallet Stake Permission' -e 'Wallet Permission' . || true
echo

TARGET="src/content/docs/explanations/table-of-contents.mdx"
echo "== Show snippet of $TARGET if exists =="
if [ -f "$TARGET" ]; then
  sed -n '1,120p' "$TARGET"
else
  echo "$TARGET not found"
fi

Length of output: 10283

Remove duplicate "Wallet Stake Permission" entries — keep canonical label "Wallet Permission"

  • src/content/docs/explanations/table-of-contents.mdx — delete the "- Wallet Stake Permission" entry (line ~28); keep "- Wallet Permission" (line ~31).
  • astro.config.mjs — remove the duplicate objects at lines 43 and 46; keep a single entry labeled "Wallet Permission" with slug "explanations/system/wallet-stake-permission".
  • src/content/docs/how-to-guides/table-of-contents.mdx — delete "- Create Wallet Stake Permission" (line ~29); keep "- Create Wallet Permission" (line ~31).
  • Verify page titles match the chosen labels: src/content/docs/explanations/system/wallet-stake-permission.mdx (title: "Wallet Permission") and src/content/docs/how-to-guides/system/create-wallet-stake-permission.mdx (title: "Create Wallet Permission").
🤖 Prompt for AI Agents 
In src/content/docs/explanations/table-of-contents.mdx around line 31, there is
a duplicate entry for the wallet permission pages; remove the "- [Wallet Stake
Permission](https://docs.torus.network/explanations/system/wallet-stake-permission/)"
entry and keep the canonical "- [Wallet Permission](...)" line, then in
astro.config.mjs remove the duplicate objects (keep a single object labeled
"Wallet Permission" with slug "explanations/system/wallet-stake-permission"),
delete the duplicate "- [Create Wallet Stake Permission](...)" entry from
src/content/docs/how-to-guides/table-of-contents.mdx (keep "- [Create Wallet
Permission](...)"), and verify/update the titles in
src/content/docs/explanations/system/wallet-stake-permission.mdx and
src/content/docs/how-to-guides/system/create-wallet-stake-permission.mdx so they
read "Wallet Permission" and "Create Wallet Permission" respectively.


---

Expand Down
32 changes: 20 additions & 12 deletions src/content/docs/how-to-guides/system/create-wallet-stake-permission.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Create Wallet Stake Permission
description: Step-by-step guide to creating wallet stake permissions to delegate staking operations while keeping your keys secure.
title: Create Wallet Permission
description: Step-by-step guide to creating wallet permissions to delegate staking operations while keeping your keys secure.
---

import {
Expand All @@ -12,18 +12,20 @@ import {

import RedText from '/src/components/RedText.astro';

In this guide, we'll walk through how to create wallet stake permissions in the Torus Portal.
Wallet stake permissions enable cold-hot wallet behavior, allowing you to delegate staking operations

In this guide, we'll walk through how to create wallet permissions in the Torus Portal.
Wallet permissions enable cold-hot wallet behavior, allowing you to delegate staking operations
to more accessible accounts while keeping your primary keys securely stored offline.

## Why Create Wallet Stake Permission?
## Why Create Wallet Permission?

You want to maintain high security for your primary wallet while still being able to manage staking operations efficiently.
Wallet stake permissions let you delegate staking management to hot wallets without exposing your principal funds to transfer risks.
Wallet permissions let you delegate staking management to hot wallets without exposing your principal funds to transfer risks.

#### What we will accomplish

- [Create wallet stake permission](#create-wallet-stake-permission)
- [Create wallet permission](#create-wallet-permission)


<Aside>
⏱️ **Estimated time to complete this guide: 3 minutes**
Expand All @@ -44,7 +46,9 @@ Wallet stake permissions let you delegate staking management to hot wallets with
</Card>
</CardGrid>

## Create Wallet Stake Permission

## Create Wallet Permission


<Steps>

Expand Down Expand Up @@ -85,18 +89,22 @@ Wallet stake permissions let you delegate staking management to hot wallets with
</Aside>

4. **Submit and Sign Transaction**
Click <RedText variant="light">**Create Wallet Stake Permission**</RedText>.

Click <RedText variant="light">**Create Wallet Permission**</RedText>.
Open SubWallet and <RedText variant="light">sign the transaction</RedText>.

5. **All Done**
You've successfully created the wallet stake permission.
You've successfully created the wallet permission.

The receiving account can now manage your staking operations within the limits you've set.

</Steps>

## What's Next?

Now that you've created wallet stake permission, you might want to:

Now that you've created wallet permission, you might want to:


- **Monitor your delegations**: Track delegation status in the [Manage Permissions tab](https://portal.torus.network/permissions/manage-permission)
- **Optimize your stakes**: Work with your hot wallet to [manage staking positions](https://docs.torus.network/how-to-guides/holders/stake-your-torus/) efficiently
Expand All @@ -108,5 +116,5 @@ Connect with the community:
- [Twitter](https://x.com/torus_network) — Updates and ecosystem news

<Aside type="tip" title="Want to Learn More?">
Learn about [wallet stake permission concepts](https://docs.torus.network/explanations/system/wallet-stake-permission/) and the security benefits of cold-hot wallet architecture.
Learn about [wallet permission concepts](https://docs.torus.network/explanations/system/wallet-stake-permission/) and the security benefits of cold-hot wallet architecture.
</Aside>
1 change: 1 addition & 0 deletions src/content/docs/how-to-guides/table-of-contents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ If you're managing permissions and system-level coordination:
- [Create Stream Permission](https://docs.torus.network/how-to-guides/system/create-stream-permission/) — Share token emission streams with other agents
- [Create Wallet Stake Permission](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) — Enable secure cold-hot wallet staking delegation
- [Manage Permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) — View, edit, and revoke existing permission delegations
- [Create Wallet Permission](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) — Enable secure cold-hot wallet staking delegation
Copy link

@coderabbitai coderabbitai bot Sep 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Duplicate TOC entry: keep one “Create Wallet Permission.”

Both “Create Wallet Stake Permission” (Line 29) and “Create Wallet Permission” (Line 31) point to the same slug. Remove the old label to avoid duplicate nav.

- - [Create Wallet Stake Permission](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) — Enable secure cold-hot wallet staking delegation
- - [Manage Permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) — View, edit, and revoke existing permission delegations
- - [Create Wallet Permission](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) — Enable secure cold-hot wallet staking delegation
+ - [Manage Permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) — View, edit, and revoke existing permission delegations
+ - [Create Wallet Permission](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) — Enable secure cold-hot wallet staking delegation
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- [Create Wallet Permission](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) — Enable secure cold-hot wallet staking delegation
- [Manage Permissions](https://docs.torus.network/how-to-guides/system/manage-permissions/) — View, edit, and revoke existing permission delegations
- [Create Wallet Permission](https://docs.torus.network/how-to-guides/system/create-wallet-stake-permission/) — Enable secure cold-hot wallet staking delegation
🤖 Prompt for AI Agents 
In src/content/docs/how-to-guides/table-of-contents.mdx around line 31, there is
a duplicate TOC entry that links to the same slug as the item on line 29; remove
the line at 31 (the old "[Create Wallet Permission]" entry) so only the intended
"Create Wallet Stake Permission" entry remains, ensuring no duplicate navigation
entries point to the same slug.


---

Expand Down