Asset Hub Kusama RPC Endpoint: How to Connect and Use It

Asset Hub Kusama Decision Checklist

Before integrating with Asset Hub Kusama, consider the following criteria to choose the right RPC infrastructure:

---

Asset Hub Kusama Overview

Asset Hub Kusama is a system parachain on the Kusama network designed for low-cost asset creation, transfer, and NFT management. It replaces the earlier Statemine parachain and serves as the primary hub for holding and transacting both fungible and non-fungible assets on Kusama. As a common-good parachain, it leverages Kusama's security and provides seamless XCM (Cross-Consensus Messaging) integration with other parachains.

---

Chain Settings and Configuration

When connecting to Asset Hub Kusama, you need the following network parameters:

Note: Public endpoints are rate-limited. For production applications, consider using a dedicated RPC provider like OnFinality to get higher throughput and reliable access.

---

Available RPC Methods

Asset Hub Kusama uses Substrate-based JSON-RPC. Key method groups include:

• Chain: chain_getBlock, chain_getHeader, chain_getBlockHash
• State: state_getStorage, state_getMetadata, state_getRuntimeVersion
• System: system_chain, system_name, system_version
• Author: author_submitExtrinsic, author_pendingExtrinsics (for transactions)

A full list is available in the Substrate JSON-RPC specification.

---

Connecting to Asset Hub Kusama

You can interact with Asset Hub Kusama using any JSON-RPC client. Below are examples using curl and WebSocket.

curl Example

curl -X POST https://api.onfinality.io/rpc?apikey=YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "chain_getBlock",
    "params": []
  }'

Replace YOUR_API_KEY with a valid API key from OnFinality. For WebSocket, use a library like ws in Node.js:

const WebSocket = require('ws');
const ws = new WebSocket('wss://api.onfinality.io/public-ws/asset-hub-kusama?apikey=YOUR_API_KEY');

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 2,
    method: 'chain_subscribeNewHeads',
    params: []
  }));
});

ws.on('message', (data) => {
  console.log('New head:', data);
});

---

Common Pitfalls and Troubleshooting

---

Key Takeaways

• Asset Hub Kusama is a system parachain for low-cost asset and NFT operations on Kusama.
• Use the chain ID 420420418 and para ID 1000 for configuration.
• Public RPC endpoints are available but have rate limits; for production, use a reliable provider like OnFinality with dedicated nodes.
• Archive node support is essential for historical data queries.
• WebSocket subscriptions enable real-time updates but require proper reconnection handling.

---

Frequently Asked Questions

What is the difference between Asset Hub Kusama and Statemine? Statemine was the previous name; Asset Hub Kusama is the updated version with enhanced asset and NFT functionality.

Can I deploy smart contracts on Asset Hub Kusama? Yes, Asset Hub Kusama supports EVM smart contracts via the EVM pallet. Check the network's runtime version for specific capabilities.

How do I get KSM for gas fees? KSM can be transferred from the Kusama relay chain via XCM or acquired on centralized exchanges. Ensure you have at least 0.001 KSM for basic operations.

What RPC provider do you recommend? Evaluate providers based on uptime, archive support, and rate limits. OnFinality offers scalable dedicated nodes; see RPC pricing and supported networks for details.

---

For more details on RPC provider selection, read our guide on how to choose an RPC provider.