polkadot-contracts

Polkadot Smart Contract Interactions

This skill covers the @polkadot-apps/contracts package for typed contract interactions on Asset Hub.

Quick Start: Size-Optimized Path (Recommended for Production)

The constructor + explicit createInkSdk path gives you full control over the InkSdk instance and avoids pulling @polkadot-api/sdk-ink as a transitive dependency of @polkadot-apps/contracts.

import { getChainAPI } from "@polkadot-apps/chain-client";
import { createInkSdk } from "@polkadot-api/sdk-ink";
import { ContractManager } from "@polkadot-apps/contracts";
import { SignerManager } from "@polkadot-apps/signer";
import cdmJson from "./cdm.json";

// Connect and create InkSdk from raw PolkadotClient
const client = await getChainAPI("paseo");
const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });

const signerManager = new SignerManager();
await signerManager.connect();

const manager = new ContractManager(cdmJson, inkSdk, { signerManager });
const counter = manager.getContract("@example/counter");

// Read (dry-run, no gas cost)
const { value } = await counter.getCount.query();

// Write (signs and submits via signerManager)
await counter.increment.tx();

BYOD Path (Bring Your Own Descriptors)

import { createChainClient } from "@polkadot-apps/chain-client";
import { createInkSdk } from "@polkadot-api/sdk-ink";
import { paseo_asset_hub } from "@polkadot-apps/descriptors/paseo-asset-hub";
import { ContractManager } from "@polkadot-apps/contracts";
import cdmJson from "./cdm.json";

const client = await createChainClient({
    chains: { assetHub: paseo_asset_hub },
    rpcs: { assetHub: ["wss://sys.ibp.network/asset-hub-paseo"] },
});
const inkSdk = createInkSdk(client.raw.assetHub, { atBest: true });

const manager = new ContractManager(cdmJson, inkSdk, { signerManager });