Skip to content

Conversation

@chideraao
Copy link

@chideraao chideraao commented Jan 7, 2026

Updating docs with new coldkey swap mechanism.

opentensor/subtensor#2251

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Jan 7, 2026

Deploying developer-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: bd208e4
Status: ✅  Deploy successful!
Preview URL: https://a39910eb.developer-docs-6uq.pages.dev
Branch Preview URL: https://coldkey-swap.developer-docs-6uq.pages.dev

View logs


# Rotate/Swap your Coldkey

This page describes how to _rotate_ or _swap_ the coldkey in your wallet. Because the coldkey controls your access to your wallet, this is the equivalent of 'changing your password', although it is more complex, due to the nature of blockchain cryptography.
Copy link

Choose a reason for hiding this comment

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

It sounds a bit confusing/inaccurate, because the coldkey in some way IS my wallet, the password of my coldkey is the mnemonic/seed phrase (private key).

Copy link

@MichaelTrestman MichaelTrestman Feb 5, 2026

Choose a reason for hiding this comment

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

Suggested change
This page describes how to _rotate_ or _swap_ the coldkey in your wallet. Because the coldkey controls your access to your wallet, this is the equivalent of 'changing your password', although it is more complex, due to the nature of blockchain cryptography.
This page describes how to _rotate_ or _swap_ the coldkey in your wallet. Because the coldkey private key controls your access to your wallet, this operation is the equivalent of 'changing your password', although it is more complex, due to the nature of blockchain cryptography.

how about this?

Copy link

@mcjkula mcjkula Feb 5, 2026

Choose a reason for hiding this comment

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

Instead of being the equivalent of changing the password, it's like creating a new user (because the user ID/public key will be different), while migrating all the data from the user onto the new one.

NOTE: Not that this should be used to describe the procedure.

Copy link

Choose a reason for hiding this comment

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

i mean the key rotation is like changing your password

Not really though, right? Because you don't keep the same user/"account" (as in wallet), you have to create a second one that you also control (that has it's own user ID/public key and password/private key) and then swap to that one.

Changing the password could be understood just changing the mnemonic/private key, because it got leaked, so then the question would be why I need a new coldkey etc.

Choose a reason for hiding this comment

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

It's not exactly like it, hence more complex due to the nature of blockchain. but it is the closest equivalent.
like if someone who doesn't know anything about blockchain says "how do you change your password on your wallet", the answer is, "actually, what you want to do is swap your coldkey, it's a little more complicated..."

but we want to acommodate/educate people who are asking the wrong question because they don't know how to ask the right question, so that's what i'm getting at. make sense or still too loosey goosey for ya?


This page describes how to _rotate_ or _swap_ the coldkey in your wallet. Because the coldkey controls your access to your wallet, this is the equivalent of 'changing your password', although it is more complex, due to the nature of blockchain cryptography.

It is *critical* to swap your coldkey if you think it has been leaked, as your coldkey secures your wallet's identity and assets.
Copy link

@mcjkula mcjkula Feb 5, 2026

Choose a reason for hiding this comment

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

It's not the "wallet" that has an identity, but the keys. I could have an identity on my coldkey (which would be arguably seen as the identity of my "wallet"), and each of my hotkeys could have a different identity.

chideraao and others added 2 commits February 9, 2026 11:27
Co-authored-by: Maciej Kula <github@mcjkula.com>
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.

3 participants