How to Connect to Kusama Asset Hub

How to Access Kusama Asset Hub Credentials

📘

Info

If you haven't configured a node, learn how to deploy one here.

1. Log into the Blockdaemon app.
2. Select Nodes & RPC from the sidebar menu
3. Go to the My Nodes tab and select the Kusama node you want to connect to.
4. Under the Connect tab, you’ll find:
   1. Endpoint URL
   2. Auth String
   3. Auth Token

Please reach out to [email protected] or your Customer Success Manager for support.

1. How to Connect via cURL

curl \
  -H "Content-Type: application/json" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -d '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "RPC_METHOD"
  }' \
  YOUR_ENDPOINT_URL/assethub/http-rpc

• Replace YOUR_ENDPOINT_URL with the Endpoint URL in the Blockdaemon app.
• Replace YOUR_AUTH_TOKEN with the Auth Token in the Blockdaemon app.
• Replace RPC_METHOD with your chosen RPC method.

2. How to Connect via WebSocket

You can use the auth token or bearer token in the header for the WebSocket endpoint.

wscat -H "X-Auth-Token: YOUR_AUTH_TOKEN" -c wss:YOUR_ENDPOINT_URL/assethub/websocket

• Replace YOUR_ENDPOINT_URL with the Endpoint URL in the Blockdaemon app.
• Replace YOUR_AUTH_TOKEN with the Auth Token in the Blockdaemon app.

📘

Info

wscat is a tool that can connect over WebSocket(s) and may need to be installed. You can use your preferred tool of choice.

3. How to Connect via Sidecar API

🚧

Substrate API Sidecar is going to be deprecated

Sidecar is being replaced by the Polkadot REST API. The new API is not a drop-in replacement, endpoints now include a /v1/ prefix and some argument names have changed. See the migration guide to update your integration.

curl -X GET \
     -H 'Content-Type: application/json' \
     -H 'X-Auth-Token: YOUR_AUTH_TOKEN' \
     'YOUR_ENDPOINT_URL/assethub/SIDECAR_METHOD'

• Replace YOUR_ENDPOINT_URL with the Endpoint URL in the Blockdaemon app.
• Replace YOUR_AUTH_TOKEN with the Auth Token in the Blockdaemon app.
• Replace SIDECAR_METHOD with the supported substrate sidecar methods.

4. How to Connect via REST API

Use the Polkadot REST API to call native Kusama REST methods through your Blockdaemon-hosted node.

Making a request: Append the REST API method path after your endpoint URL:

YOUR_ENDPOINT_URL/assethub/rest/v1/YOUR_METHOD

Example — retrieve the most recently finalized block header on the Asset Hub:

curl -X GET \
  'YOUR_ENDPOINT_URL/assethub/rest/v1/blocks/head/header' \
  -H 'X-Auth-Token: YOUR_AUTH_TOKEN'

• Replace YOUR_ENDPOINT_URL with the Endpoint URL in the Blockdaemon app.
• Replace YOUR_AUTH_TOKEN with the Auth Token in the Blockdaemon app.
• Replace YOUR_METHOD with your chosen Kusama REST API method.

📘

Looking for more information?

You'll find plenty of useful resources in the Polkadot section, such as:

• Consensus Mechanisms
• Nominated Proof of Stake (NPoS)

Explore more here.