Skip to content

docs: update AI3 token wallet guides, resolve configs, and add FoxWallet#962

Closed
EmmanuelMarv wants to merge 9 commits into
autonomys:mainfrom
EmmanuelMarv:feat/node-security-hardening
Closed

docs: update AI3 token wallet guides, resolve configs, and add FoxWallet#962
EmmanuelMarv wants to merge 9 commits into
autonomys:mainfrom
EmmanuelMarv:feat/node-security-hardening

Conversation

@EmmanuelMarv

Copy link
Copy Markdown
Contributor

Overview

This pull request brings our documentation up to speed with the latest network tooling changes, hardens security messaging across all wallet resources, and completely updates our consensus-chain wallet ecosystem onboarding guides. It also cleanly resolves configuration file conflicts originating from recent upstream updates to main.

Key Changes

  • Added FoxWallet Support Guide: Introduced a comprehensive configuration workflow manual for the FoxWallet mobile infrastructure application (docs/ai3_token/wallets/foxwallet.md).
  • Polkadot{.js} Extension Overhaul: Refactored the guide to shift focus to a secure, modern account initialization paradigm. Rewrote troubleshooting pathways for clarity and added direct clipboard public address mapping steps (docs/ai3_token/wallets/polkadot.md).
  • SubWallet Documentation Upgrade: Standardized terminology and updated user documentation workflows, explicitly including custom node connections via native RPC configurations for both Mainnet and the Chronos Testnet (docs/ai3_token/wallets/subwallet.mdx).
  • Security Message Hardening: Inserted distinct, uniform cryptographic fallback warning blocks (:::warning Protect Your Cryptocurrency Recovery Phrase at All Costs:::) across all documentation files to guarantee maximum coverage for private seed phrase safety rules.
  • Unified Global Config: Cleaned up Git branch synchronization overlaps inside docusaurus.config.js to perfectly line up default routing parameters and client redirects with current repository indexing.

Verification Checklist

  • Ran localized docusaurus build without broken link warnings or syntax compilation errors.
  • Verified markdown image paths properly resolve to asset files inside /img/doc-imgs/.
  • Double-checked that both dark and light modes cleanly format custom tabs (<Tabs>) and syntax containers.

@netlify

netlify Bot commented Jun 20, 2026

Copy link
Copy Markdown

Deploy Preview for subspace-docs-staging ready!

Name Link
🔨 Latest commit 3a6ce83
🔍 Latest deploy log https://app.netlify.com/projects/subspace-docs-staging/deploys/6a3debe0886d420008b769ed
😎 Deploy Preview https://deploy-preview-962--subspace-docs-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@jim-counter jim-counter left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Hey @EmmanuelMarv this is not quite what I'm after here.

Rather than a full rewrite and steer towards being part of a staking guide I just wanted to make sure that the various wallet workflows and screenshots were still accurate. I've put a number of comments inline but not completed the review as I think it's worth going back to first principals on this PR.

  1. Are we adding value with the body rewrite? If they are only rewording changes let's not do them as they invalidate existing translations. We are looking for workflow corrections only.
  2. The hardening guide is not something we want to support. Please remove it.
  3. There are a lot of changes in the translation pages that should not be there.

Comment thread docs/ai3_token/wallets/foxwallet.md Outdated
1. Select `Create wallet` and you will need to agree with the Terms of Service.
To maintain clean accounting parameters before interfacing with network validation pipelines, choose the configuration path that matches your current cryptographic profile.

### Creating a New Account (Recommended for Staking)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
### Creating a New Account (Recommended for Staking)
### Creating a New Account

Comment thread docs/ai3_token/wallets/foxwallet.md Outdated

---

## 🚀 Next Steps: The Staking Journey

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
## 🚀 Next Steps: The Staking Journey
## Next Steps

Comment thread docs/ai3_token/wallets/foxwallet.md Outdated
- **Secure Core Balances:** Access your network token layout inside the application to fetch your public consensus tracking string and transfer your utility assets.
- **Advanced Portal Setup:** If your workflow requires hooking into full Polkadot apps dashboards, check out the [Polkadot.js Apps Guide](../../staking/additional-guides/polkadot-apps.mdx).
- **Launch Staking Positions:** Move directly into the main [Staking Guide](../../staking/staking.mdx) to pair your wallet details with the network framework and begin collecting block distribution incentives.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can we add a section about "Pay for Storage" linking the Pay with AI3 guide and mentioning that the first step is to XDM.

This comment and the section header change should be made on all pages in this PR.

Comment thread docs/ai3_token/wallets/polkadot.md Outdated
---

![step-3](/img/doc-imgs/polkadot/Polkadot-2.png)
## Managing Your Accounts

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can we remove this section please?

Comment thread docs/ai3_token/wallets/polkadot.md Outdated
To preserve deep chain validation integrity and track your staking operations easily, it is ideal to generate a fresh, unlinked account footprint.

:::danger
### Creating a New Account (Recommended for Staking)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
### Creating a New Account (Recommended for Staking)
### Creating a New Account

Comment thread docs/ai3_token/wallets/polkadot.md Outdated
---

![trouble-11](/img/doc-imgs/polkadot/trouble-11.png)
## 🚀 Next Steps: The Staking Journey

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
## 🚀 Next Steps: The Staking Journey
## Next Steps

And note comments on this section above.

Comment thread docs/ai3_token/wallets/subwallet.mdx Outdated
7. Enter a name for your account.
---

## Managing Your Accounts

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Remove this section.

Comment thread docs/ai3_token/wallets/subwallet.mdx Outdated

To maintain strict accounting precision while staking on the Autonomys Network, it is ideal to generate a fresh target account.

### Creating a New Account (Recommended for Staking)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
### Creating a New Account (Recommended for Staking)
### Creating a New Account

Comment thread docs/ai3_token/wallets/subwallet.mdx Outdated

### Creating a New Account (Recommended for Staking)

1. Provide an easily recognizable local name for your fresh account (e.g., "Autonomys Staking Pool").

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
1. Provide an easily recognizable local name for your fresh account (e.g., "Autonomys Staking Pool").
1. Provide an easily recognizable local name for your fresh account.

Comment thread docs/ai3_token/wallets/subwallet.mdx Outdated
![step-7](/img/doc-imgs/subwallet/Subwallet-5.png)

8. Write down your seed phrase in a secure place. You will need it if you ever forget your password, or decide to transfer the account to another PC.
2. Your unique 12-word seed phrase will be generated. Write it down carefully in physical format.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
2. Your unique 12-word seed phrase will be generated. Write it down carefully in physical format.
2. Your unique 12-word seed phrase will be generated. You will need it if you ever forget your password, or decide to transfer the account.

@EmmanuelMarv

EmmanuelMarv commented Jun 22, 2026

Copy link
Copy Markdown
Contributor Author

Hey @jim-counter thanks for the detailed review!
I completely understand your point regarding translation invalidation. I will revert the wording changes across the wallet guides to keep the existing translations intact and focus strictly on the workflow and screenshot updates.
I will also completely remove the node security hardening guide as requested, strip out the 'Managing Your Accounts' sections, and standardize the header down to simple ### Creating a New Account and ## Next Steps blocks.
For the next steps section, I will add a 'Pay for Storage' segment linking out to the Pay with AI3 guide and mention the initial XDM step across all relevant pages. I'll push an updated commit shortly to get this cleaned up from first principles.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants