Shiden Network Upgrade: Asset Hub Migration

:open_mailbox_with_raised_flag: Introduction

Hello, Shiden Community!

On October 6, 2025, Shiden Network will undergo the Asset Hub Migration, a foundational upgrade that moves staking, governance, and KSM balance operations from the Kusama Relay Chain to the Kusama Asset Hub.

This shift will:

  • :badminton: Reduce KSM transaction fees by ~90%
  • :unlocked: Lower the minimum balance requirement up to 100x
  • :gear: Simplify all network interactions and cross-chain operations

For users, this means cheaper and easier KSM operations. For partners and developers, it introduces a unified, efficient platform to build on.

:spider_web: What This Means for Shiden?

The Asset Hub Migration transforms how Shiden Network operates within the Kusama ecosystem. Currently, when you interact with Shiden, certain operations like KSM transfers require communication with the Kusama Relay Chain. After the migration, these operations will route through Kusama Asset Hub instead, providing Shiden users and developers with a more efficient, cost-effective infrastructure.

For Shiden Network specifically, the migration involves three key changes. First, all KSM reserves move from the Kusama Relay Chain to Asset Hub, meaning cross-chain transfers involving KSM must use Asset Hub as the intermediary. Second, the sovereign account holding Shiden’s 170 KSM on Kusama will transfer to Asset Hub automatically. Third, XCM message routing for KSM operations will require configuration updates in all Shiden-integrated services.

Key Benefits:

  • 90% cheaper KSM fees
  • Minimum KSM balance reduced from 1 KSM → 0.000003333 KSM
  • Unified platform for KSM, USDT, USDC, and more

:spiral_calendar: Migration Timeline

The Shiden Network migration follows a carefully orchestrated three-day process coordinated by the Supervisor Pallet, a specialized component that manages the state transfer between chains.

During the migration window, this pallet orchestrates the atomic transfer of all KSM-related state from the Relay Chain to Asset Hub, ensuring no funds are lost and all balances are preserved exactly.

Date Action Impact
Oct 6, 2025 Runtime upgrade disables KSM transfers. 170 KSM moved from Relay Chain sovereign account → Asset Hub sovereign account. No KSM transfers between Kusama and Shiden. SDN & smart contracts unaffected.
Oct 7, 2025 Supervisor Pallet executes main migration (8–10 hrs). Atomic state transfer of balances, staking, governance. KSM transfers paused on Kusama. All other operations live.
Oct 8–9, 2025 Runtime upgrade re-enables all XCM/Xtokens with Asset Hub as reserve. Full functionality restored. New lower fees live.

:gear: What This Means for Users?

  • No action required → migration is automatic.
  • Funds are safe → balances, staking, and governance states preserved atomically.
  • SDN tokens unaffected only KSM operations migrate.
  • Temporary downtime KSM transfers paused between Kusama and Shiden for ~2-3 days starting Oct 6, 2025.
  • Post-migration benefits: drastically reduced fees + unified access to multiple assets.

:hammer_and_wrench: Guidance for Partners & Developers

The Asset Hub Migration on October 6, 2025, requires specific updates from some partners supporting Shiden Network. These changes are essential to maintain seamless operations for KSM and SDN users after the migration.

:bookmark: Wallet Providers

Action Before Migration After Migration
Balance queries Kusama Relay Chain Kusama Asset Hub
XCM reserve Parent location (Relay) Parachain ID 1000 (Asset Hub)
Transaction methods transfer_assets, reserve_transfer_assets transfer_assets_using_type_and_then
Migration detection Not needed Use pallet-rc-migrator + migration-stage
Error handling Normal Handle downtime Oct 7

:cloud: RPC & Node Operators

Requirement Pre-Migration Post-Migration
Nodes Shiden + Kusama Relay Shiden + Kusama Asset Hub
KSM queries wss://kusama-rpc.polkadot.io wss://kusama-asset-hub-rpc.polkadot.io
Load balancing Relay endpoints Asset Hub endpoints
Substrate Sidecar Default config `SAS_SUBSTRATE_URL=wss://kusama-asset-hub-rpc.polkadot.io
SAS_SUBSTRATE_MULTI_CHAIN_URL=‘[{“url”:“wss://kusama-rpc.polkadot.io”,“type”:“relay”}]’`
Response parsing Legacy Update for array returns (useRcBlock=true)

:laptop: Developers

  • XCM Config Update:
// Old
reserve: Location::parent(), // Kusama Relay Chain

// New
reserve: Location::new(1, [Parachain(1000)]), // Asset Hub
  • Smart Contracts (EVM):

    For contracts using precompile address 0x0000000000000000000000000000000000005004, change the destination parameter from parent location to Parachain ID 1000 (Asset Hub).

  • Migration Status Detection:

async function getMigrationStatus(api) {
    const metadata = await api.rpc.state.getMetadata();
    const hasMigrator = metadata.pallets.find(p => p.name === 'RcMigrator');

    if (!hasMigrator) return 'not_started';

    const stage = await api.query.rcMigrator.migrationStage();
    return stage.toString().toLowerCase();
}

:red_question_mark: User FAQs

Question Answer
Do I need to prepare? No. Funds migrate automatically. SDN unaffected. KSM accessible via Asset Hub.
Are my funds safe? Yes. Atomic execution preserves all balances. Migration only completes fully or not at all.
What about SDN tokens? Unaffected. Staking, transfers, and usage continue as normal.
When will KSM transfers pause? Oct 6, 2025 for ~2-3 days. SDN & contracts stay active.
What are the benefits? ~90% lower KSM fees, min balance drops 1 → 0.000003333 KSM, unified platform with stablecoins & assets.
Will wallets update automatically? Yes for most. Clear cache after Oct 8. Ledger: update Polkadot app v100.0.8+.
What if I’m staking SDN? Uninterrupted. Migration affects only KSM.
Can I transfer SDN during migration? Yes. Only KSM ops pause.
What if balances look wrong? Temporary display issues may occur during the window, resolved after migration.
Do I need to update Astar Portal? No. Portal auto-switches to Asset Hub.
What about DeFi protocols? KSM-related functions pause starting Oct 6, resume Oct 8 with cheaper fees.
How to track progress? Live dashboard: migration.paritytech.io.
How do I know it’s complete? By Oct 8–9, all services resume. Dashboard confirms.
Will KSM sent to old addresses work? Yes. Deposit addresses unchanged.
What are new fee levels? KSM fees ~90% lower, enabling microtransactions.

:seedling: Looking Ahead

The Asset Hub Migration is a pivotal step for Shiden, delivering:

  • :coin: Economic accessibility → cheaper fees, microtransactions possible
  • :high_voltage: Developer readiness → simplified XCM & contracts
  • :globe_with_meridians: Growth potential → broader adoption across Kusama

This positions Shiden as a leader in efficiency within the Kusama ecosystem.

:hammer_and_wrench: Technical Support and Resources

If you need support during the migration or would like more context on the action points directly from the Polkadot/Parity documentation, please refer to the links below:


:balloon: Together Toward the Future

With the Asset Hub Migration, Shiden strengthens its foundation for the future. This is not just an upgrade, it’s the start of a new chapter of growth, accessibility, and innovation.

Thank you for your trust and support. Let’s keep building web3 together. :astar:

5 Likes

It’s great to see Shiden truly showing its strength.

This migration is an important milestone for preparing to support Polkadot’s JAM, and testing it on Shiden first is also a crucial step for Astar.

Good update for the Shiden community! The Asset Hub Migration is a big step forward aka cheaper fees, easier access, and a smoother experience all around.

Truly great to see updates on Shiden as part of the Shiden community :slight_smile: