⛓️Multichain Migrations

Swarms can operate on multiple chains at once

About Multichain Migrations / Yanking

The Kadena blockchain is unique because it consists of many other chains.

Sometimes you may find an app you like on Kadena that only exists on Chain 1, or Chain 2, or Chain 8, and that you would like your Swarm to be able to manage assets on those chains and interact with those apps on those chains.

Currently Kadena consists of 20 chains, and a Swarm can exists on as many as you would like.

All Swarms by default start on Chain 1, but you can Migrate your Swarm to new chains, allowing it to exist on multiple chains at once.

Migrate your Swarm to multiple chains to begin managing assets on other chains, and creating vaults on other chains, and interacting with other Kadena DAPPs on other chains.

You can view which chains the Swarm is currently active on by clicking on it's ID, which will expand a little menu displaying which chains the Swarm is currently operating on:

  1. Clicking the ID of a Swarm will expand it's multichain options.

From this menu you can view which chains the Swarm is currently active on, as well as yank it to new chains by clicking the + Icon.

Migrating to new Chains

You can manually force your DAO to migrate to a new chain by clicking the + Icon from a Swarms Multichain Menu, which will ask you to pick which new chain you would like to copy your DAO over to:

  1. Select a chain you wish to migrate the Swarm to and click "Copy DAO to Chain"

All Multichain Migrations perform a Kadena Crosschain Transaction, which can take several minutes on the Kadena blockchain, as shown below.

Crosschain transactions are special transactions on the Kadena Blockchain and can sometimes take 5-10 minutes to complete! Please do NOT leave this screen while your Swarm is migrating.

Once your Swarm has migrated to a new chain, it exists on multiple chains at once and you can begin creating Vaults on that new chain and managing assets on that new chain.

Crosschain Sync Warnings

When your Swarm exists on multiple chains, there are often times you will have to update the Swarm on those other chains when you make changes to your Swarm.

Whenever Swarms.Finance detects your DAO is different on 1 chain from another (Such as when you add a new member to your DAO) someone will need to update the DAO on the new chain, so the new chain is aware of the new member.

Whenever your DAO's become out of sync across multiple chains, your Swarm will notify you with a little red broken link icon next to your Swarms ID:

This red warning icon is to notify you that the Swarm has changed and needs to be synced on a new chain.

Click on the Red Chains to update them.

Chains become out of sync when:

  • A new member is added to the Swarm

  • A old member is removed from the Swarm

  • The swarms consensus thresholds change

Whenever one of these actions is performed at the Swarm, you will need to update all the other chains before using them.

Swarms will automatically notify the next person who attempts to use the DAO on an un-synced chain, and get them to update it before they can perform their action.

The choice to manually sync your Swarm is always available from a Swarm's multichain menu by clicking on it's ID, and manually clicking on the un-synced chains- Any member of the Swarm may perform crosschain syncs.

You may change your name whenever you like.

Last updated