@polkadot-apps/descriptors

Pre-generated Polkadot API descriptors for Asset Hub, Bulletin, and Individuality chains.

Install

pnpm add @polkadot-apps/descriptors
Copy

Peer dependency: polkadot-api (>=1.23.0)

pnpm add polkadot-api
Copy

Quick start

Import descriptors per chain — each subpath is a separate papi build, so you only bundle the chain metadata you actually use:

import { bulletin } from "@polkadot-apps/descriptors/bulletin";
import { createClient } from "polkadot-api";

const client = createClient(/* transport */);
const api = client.getTypedApi(bulletin);

// Full type safety for all calls, queries, and events
const fee = await api.query.TransactionStorage.ByteFee.getValue();
Copy

Available chain descriptors

import { polkadot_asset_hub } from "@polkadot-apps/descriptors/polkadot-asset-hub";
import { kusama_asset_hub } from "@polkadot-apps/descriptors/kusama-asset-hub";
import { paseo_asset_hub } from "@polkadot-apps/descriptors/paseo-asset-hub";
import { bulletin } from "@polkadot-apps/descriptors/bulletin";
import { individuality } from "@polkadot-apps/descriptors/individuality";
Copy

Regenerating descriptors

This package contains generated code. To regenerate from chain metadata:

pnpm generate-descriptors
Copy

This fetches current chain metadata and runs papi generate once per chain, producing isolated per-chain builds.

Adding a new chain

1. Add the chain's metadata: update scripts/generate.sh with a papi add command.
2. Create chains/<name>/.papi/polkadot-api.json with the chain config and a minimal package.json.
3. Add the chain to the CHAINS list in scripts/build.sh.
4. Add a subpath export in the root package.json.

License

Apache-2.0