[CI Skip] release/stable 11.3.1

skip-checks: true

.codeclimate.yml

@@ -1,27 +0,0 @@
-checks:
-  argument-count:
-    config:
-      threshold: 5
-  method-complexity:
-    config:
-      threshold: 7
-  method-count:
-    config:
-      threshold: 25
-  method-lines:
-    config:
-      threshold: 30
-
-exclude_patterns:
-- "**/*.spec.js"
-- "**/*.spec.ts"
-- "**/*.test.js"
-- "**/*.test.ts"
-- "docs/**/*.js"
-- "docs/**/*.ts"
-- "packages/*-augment/"
-- "packages/*-augment-*/"
-- "packages/typegen/scripts"
-- "packages/typegen/src"
-- "packages/types/src/interfaces/"
-- "packages/types/src/augment/"

.eslintrc.cjs

@@ -1,24 +0,0 @@
-// Copyright 2017-2022 @polkadot/api authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-const base = require('@polkadot/dev/config/eslint.cjs');
-
-module.exports = {
-  ...base,
-  ignorePatterns: [
-    ...base.ignorePatterns
-  ],
-  parserOptions: {
-    ...base.parserOptions,
-    project: [
-      './tsconfig.eslint.json'
-    ]
-  },
-  rules: {
-    ...base.rules,
-    // add override for any (a metric ton of them, initial conversion)
-    '@typescript-eslint/no-explicit-any': 'off',
-    // this seems very broken atm, false positives
-    '@typescript-eslint/unbound-method': 'off'
-  }
-};

.github/workflows/auto-approve.yml

@@ -9,8 +9,8 @@ jobs:
     if: "! startsWith(github.event.head_commit.message, '[CI Skip]') && (!github.event.pull_request || github.event.pull_request.head.repo.full_name == github.repository)"
     runs-on: ubuntu-latest
     steps:
-      - uses: jacogr/action-approve@master
+      - uses: jacogr/action-approve@795afd1dd096a2071d7ec98740661af4e853b7da
         with:
-          authors: jacogr
+          authors: jacogr, TarikGul
           labels: -auto
           token: ${{ secrets.GH_PAT_BOT }}

.github/workflows/auto-merge.yml

@@ -8,9 +8,9 @@ jobs:
   merge:
     runs-on: ubuntu-latest
     steps:
-      - uses: jacogr/action-merge@master
+      - uses: jacogr/action-merge@d2d64b4545acd93b0a9575177d3d215ae3f92029
         with:
-          checks: build,lint,test
+          checks: pr (build),pr (lint),pr (test)
           labels: -auto
           strategy: squash
           token: ${{ secrets.GH_PAT_BOT }}

.github/workflows/lock.yml

@@ -10,16 +10,16 @@ jobs:
     env:
       YARN_ENABLE_SCRIPTS: false
     steps:
-      - uses: dessant/lock-threads@v2
+      - uses: dessant/lock-threads@c1b35aecc5cdb1a34539d14196df55838bb2f836
         with:
           github-token: ${{ secrets.GH_PAT_BOT }}
-          issue-lock-inactive-days: '7'
-          issue-lock-comment: >
+          issue-inactive-days: '7'
+          issue-comment: >
             This thread has been automatically locked since there has not been
             any recent activity after it was closed. Please open a new issue
             if you think you have a related problem or query.
-          pr-lock-inactive-days: '2'
-          pr-lock-comment: >
+          pr-inactive-days: '2'
+          pr-comment: >
             This pull request has been automatically locked since there
             has not been any recent activity after it was closed.
             Please open a new issue for related bugs.

.github/workflows/pr-any.yml

@@ -3,20 +3,23 @@ on: [pull_request]
 
 jobs:
   pr:
+    continue-on-error: true
     strategy:
       matrix:
         step: ['lint', 'test', 'build', 'deno']
-    name: ${{ matrix.step }}
     runs-on: ubuntu-latest
     env:
       YARN_ENABLE_SCRIPTS: false
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with:
+        node-version: 'lts/*'
     - uses: denoland/setup-deno@v1
       with:
         deno-version: vx.x.x
     - name: ${{ matrix.step }}
       if: always()
       run: |
-        yarn install --immutable | grep -v 'YN0013'
+        yarn install --immutable
         yarn ${{ matrix.step }}

.github/workflows/push-master.yml

@@ -10,20 +10,22 @@ jobs:
     strategy:
       matrix:
         step: ['build:release']
-    name: ${{ matrix.step }}
     runs-on: ubuntu-latest
     env:
       YARN_ENABLE_SCRIPTS: false
       CC_TEST_REPORTER_ID: ${{ secrets.CC_TEST_REPORTER_ID }}
-      GH_PAT: ${{ secrets.GH_PAT }}
-      GH_RELEASE_GITHUB_API_TOKEN: ${{ secrets.GH_PAT }}
+      GH_PAT: ${{ secrets.GH_PAT_BOT }}
+      GH_RELEASE_GITHUB_API_TOKEN: ${{ secrets.GH_PAT_BOT }}
       NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
-        token: ${{ secrets.GH_PAT }}
+        token: ${{ secrets.GH_PAT_BOT }}
+    - uses: actions/setup-node@v4
+      with:
+        node-version: 'lts/*'
     - name: ${{ matrix.step }}
       run: |
-        yarn install --immutable | grep -v 'YN0013'
+        yarn install --immutable
         yarn ${{ matrix.step }}

.github/workflows/semgrep.yml

@@ -1,20 +0,0 @@
-name: Semgrep
-on:
-  pull_request: {}
-  push:
-    branches:
-      - master
-
-jobs:
-  check:
-    if: "! startsWith(github.event.head_commit.message, '[CI Skip]') && (!github.event.pull_request || github.event.pull_request.head.repo.full_name == github.repository)"
-    runs-on: ubuntu-latest
-    env:
-      YARN_ENABLE_SCRIPTS: false
-    steps:
-      - uses: actions/checkout@v2
-      - uses: returntocorp/semgrep-action@v1
-        with:
-          auditOn: push
-          publishToken: ${{ secrets.SEMGREP_APP_TOKEN }}
-          publishDeployment: 1395

.github/workflows/stale.yml

@@ -1,19 +0,0 @@
-name: 'Close stale issues and PRs'
-on:
-  schedule:
-    - cron: '55 1/3 * * *'
-
-jobs:
-  stale:
-    runs-on: ubuntu-latest
-    env:
-      YARN_ENABLE_SCRIPTS: false
-    steps:
-      - uses: actions/stale@v3
-        with:
-          repo-token: ${{ secrets.GH_PAT_BOT }}
-          stale-issue-message: 'This issue has been open for 21 days with no activity and is not labelled as an enhancement. It will be closed in 7 days.'
-          stale-issue-label: 'stale'
-          exempt-issue-labels: '-size-l,-size-m,-size-s,-size-xl,-size-xs,[bug]'
-          days-before-stale: 21
-          days-before-close: 7

.gitignore

@@ -19,6 +19,7 @@ NOTES.md
 !.yarn/plugins
 .pnp.*
 .vscode/
+.idea/
 cc-test-reporter
 lerna-debug.log*
 npm-debug.log*

.nvmrc

@@ -1 +1 @@
-14
+v18.15

.prettierrc.cjs

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api authors & contributors
+// Copyright 2017-2024 @polkadot/api authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 module.exports = require('@polkadot/dev/config/prettier.cjs');

.yarnrc.yml

@@ -1,13 +1,15 @@
+compressionLevel: mixed
+
+enableGlobalCache: false
+
 enableImmutableInstalls: false
 
 enableProgressBars: false
 
+logFilters:
+  - code: YN0013
+    level: discard
+
 nodeLinker: node-modules
 
-plugins:
-  - path: .yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs
-    spec: "@yarnpkg/plugin-interactive-tools"
-  - path: .yarn/plugins/@yarnpkg/plugin-version.cjs
-    spec: "@yarnpkg/plugin-version"
-
-yarnPath: .yarn/releases/yarn-3.2.0.cjs
+yarnPath: .yarn/releases/yarn-4.2.2.cjs

CHANGELOG.md

@@ -1,7 +1,807 @@
 # CHANGELOG
 
+## 11.3.1 June 17, 2024
+
+Changes:
+
+- Fix period assumption on signingInfo (derive)
+- Bump dev to 0.79.3
+- Update {Polkadot, Kusama, Westend} types-known
+- Bump Substrate metadata to latest
+    - NOTE: Moving forward when bumping the metadata for {Polkadot, Kusama, Substrate} the version will
+    always be a minor bump since it can add, modify, remove augmented types.
+
+
+## 11.2.1 May 28, 2024
+
+Contributed:
+
+- fix: Re-subscribe to chain updates on reconnection if not a clone (Thanks to https://github.com/F-OBrien)
+
+Changes:
+
+- Add support for AuraUnincludedSegmentApi (Thanks to https://github.com/bee344)
+- Add support for ParachainHost v11 Api
+- Update Kusama and Westend block upgrades
+- Update Substrate metadata to latest
+
+
+## 11.1.1 May 21, 2024
+
+Changes
+
+- Dedupe nextElected accountIds in `api.derive.staking.nextElected`
+- Bump @polkadot/dev to 0.79.1 w/ topo sort
+- Bump yarn to 4.2.2
+- fix: updated extrinsics' assetId `toHuman` (Thanks to https://github.com/bee344)
+- fix `api.derive.accounts.{info && identity}`
+- feat: Add support for `CheckMetadataHash` signedExtension (Thanks to https://github.com/bee344)
+
+
+## 11.0.3 May 8, 2024
+
+Changes
+
+- Make `api.derive.staking.*` backwards compatible
+- Fix `claimedRewards` regression in `api.derive.staking.queryMulti`
+- Update Substrate to latest
+
+
+## 11.0.2 Apr 24, 2024
+
+Changes
+
+- Fix type for TAssetConversion in Polkadot Asset hub
+
+
+## 11.0.1 Apr 23, 2024
+
+Breaking Changes:
+
+Note! The following breaking changes only refer to `@polkadot/api-derive` calls under `api.derive.staking.*` due to the most recent breaking changes in runtime version v1.2. Please refer to the link next to the bullet points for more information.
+
+- Update` api.derive.staking` calls with breaking changes ([#5860](https://github.com/polkadot-js/api/pull/5860))
+- Add `claimedRewardsEra` to api.derive.staking.query for compatibility with legacyClaimedRewards ([#5862](https://github.com/polkadot-js/api/pull/5862))
+
+Contributed:
+
+- Bump @substrate/connect to 0.8.10 (Thanks to https://github.com/kratico)
+
+Changes:
+
+- Update polkadot types-known for latest runtime upgrades
+
+
+## 10.13.1 Apr 16, 2024
+
+Changes:
+
+- Update CI actions and setup_node to v4
+- Update substrate metadata to latest
+- Support ParachainHost runtime api v6, 7, 8, 9, 10
+- Resolve correct module for council derive
+- Update westend types-known for 1010000
+- Update kusama types-known for 1001003
+
+
+## 10.12.6 Apr 2, 2024
+
+**NOTE**: Because of a broken CI build for 10.12.5 -> 10.12.6 is a replacement
+
+Contributed:
+
+- chore: fix typos in error (Thanks to https://github.com/xiaoxianBoy)
+
+Changes:
+
+- Upgrade westend types-known for 1009000
+- Add `disableAscii` option for toHuman, and toPrimitive 
+- V14 Update substrate latest metadata
+- V15 Update substrate latest metadata
+- Bump yarn to 4.1.1
+- Add `assetId` getter field to to necessary ExtrinsicPayloads
+- Add Updated Runtime Defintions
+  - ValidateStatement
+  - MMRApi
+    - mmr_root
+    - mmr_leaf_count
+  - Core v5
+  - GenesisBuilder
+  - MixnetApi
+
+
+## 10.12.5 Apr 2, 2024
+
+Contributed:
+
+- chore: fix typos in error (Thanks to https://github.com/xiaoxianBoy)
+
+Changes:
+
+- Upgrade westend types-known for 1009000
+- Add `disableAscii` option for toHuman, and toPrimitive 
+- V14 Update substrate latest metadata
+- V15 Update substrate latest metadata
+- Bump yarn to 4.1.1
+- Add `assetId` getter field to to necessary ExtrinsicPayloads
+- Add Updated Runtime Defintions
+  - ValidateStatement
+  - MMRApi
+    - mmr_root
+    - mmr_leaf_count
+  - Core v5
+  - GenesisBuilder
+  - MixnetApi
+
+
+## 10.12.4 Mar 19, 2024
+
+Contributed:
+
+- Fix add muln(2) to signingInfo Derive (Thanks to https://github.com/pepoviola)
+
+
+## 10.12.3 Mar 18, 2024
+
+Contributed:
+
+- Bump @substrate/connect to 0.8.8 (Thanks to https://github.com/kratico)
+- Fix optional chaining operator in toHuman (Thanks to https://github.com/Imod7)
+- Fix check if minimumPeriod is zero (Thanks to https://github.com/pepoviola)
+
+Changes:
+
+- Fix api.derive.staking.eraExposure for compatibility
+- Fix invalid Lookup assignment on augmentation and update polkadot and kusama metadata
+- Update polkadot runtime upgrade per block
+- Update kusama runtime upgrade per block
+- Update westend runtime upgrade per block 
+
+## 10.12.2 Mar 11, 2024
+
+Contributed:
+
+- fix cache key (rpc-provider) (Thanks to https://github.com/ermalkaleci)
+
+Changes:
+
+- Update to latest Substrate metadata
+
+
+## 10.12.1 Mar 4, 2024
+
+Contributed:
+
+- Ink! V5 Support (Thanks to https://github.com/peetzweg)
+
+
+## 10.11.3 Feb 27, 2024
+
+Contributed:
+
+- Fix sorting of `Option` values and error on duplicates from BTreeSet/BTreeMap (Thanks to https://github.com/Neopallium)
+- Fix BEEFY compact signed commitment in versioned finality proofs (Thanks to https://github.com/mfornos)
+- Update @substrate/connect (Thanks to https://github.com/kratico)
+
+Changes:
+
+- Bump dev w/ packageDetect adjustments
+- Update copyright year
+- Bump nock, and dev deps
+- Allow `cacheCapacity` option for the `WsProvider`
+- Bump yarn
+
+
+## 10.11.2 Dec 18, 2023
+
+Contributed:
+
+- Add `chainIsEthereum` key to `Registry` interface (Thanks to https://github.com/fgamundi)
+- Adjust types for `ChargeAssetTxPayment` (Thanks to https://github.com/bee344)
+
+Changes:
+
+- Support `[8a;32]` types in known keys
+- Update to latest Substrate metadata
+
+
+## 10.11.1 Nov 18, 2023
+
+Contributed:
+
+- Support for latest `ChargeAssetTxPayment` (Thanks to https://github.com/bee344)
+- Support for latest `beefy::subscribeJustifications()` (Thanks to https://github.com/serban300)
+
+Changes:
+
+- Add known `intrablockEntropy` storage key
+- Add support for `SkipCheckIfFeeless` signed extension
+- Ensure all usages of `balances.transfer` (in tests) have been removed
+- Drop support for Node 16 (EOL 11 Sep 2023)
+
+
+## 10.10.1 Oct 14, 2023
+
+Contributed:
+
+- Add aliases for Noir type paths (Thanks to https://github.com/conr2d)
+- Add runtime `FungliblesApi` version 2 (Thanks to https://github.com/bkontur)
+- Add runtime `EthereumApi` version 5 (Thanks to https://github.com/timbrinded)
+- Add runtime `AssetConversionApi` (Thanks to https://github.com/jsidorenko)
+- Adjust types for runtime `AssetConversionApi` (Thanks to https://github.com/jsidorenko)
+- Expand test cases for `Int` conversions (Thanks to https://github.com/peetzweg)
+- Add `isEthereum` to chain properties (Thanks to https://github.com/fgamundi)
+- Allow RiscV contracts via check (Thanks to https://github.com/statictype)
+
+Changes:
+
+- Serialize any additional payload fields via `toJSON()`
+- Expose internal `rpc-core` stats on `api.stats` getter
+- Add support for latest/stable V15 metadata interfaces
+- Add runtime `BeefyApi` version 3
+- Add runtime `ParachainHost` version 5
+- Expose `chain.subscribeFinalizedBlocks` derive
+- Consistently use `import.meta.url` inside tests
+- Group `Uint/Int` tests for maintainability
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 10.9.1 Jun 12, 2023
+
+Changes:
+
+- Adjust object index access for stricter tsconfig settings
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 10.8.1 Jun 5, 2023
+
+Contributed:
+
+- Added support for extended Contracts ABI V4 definitions (Thanks to https://github.com/statictype)
+
+Changes:
+
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Cleanup (some) linting overrides
+
+
+## 10.7.3 May 28, 2023
+
+Changes:
+
+- Ensure that `.paymentInfo` never mutates the underlying/existing signature
+
+
+## 10.7.2 May 21, 2023
+
+Contributed:
+
+- Allow `api.setSigner(...)` to clear existing (Thanks to https://github.com/polymath-eric)
+
+Changes:
+
+- Adjust `@polkadot/types-create` exports with no duplicates
+
+
+## 10.7.1 May 13, 2023
+
+Changes:
+
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Add `module` to `package.json` export map (ESM-only)
+
+
+## 10.6.1 May 7, 2023
+
+Contributed:
+
+- Extract runtime details for custom documentation (Thanks to https://github.com/FlorianFranzen)
+
+Changes:
+
+- Apply historic `Scheduled` types for Kusama (as reported, non-comprehensive)
+- Adjust Deno types inside `WsProvider`
+- Allow parsing of (experimental) metadata v15
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 10.5.1 Apr 29, 2023
+
+Changes:
+
+- Default to hex-only in `Int/UInt.toJSON` for > 128-bit values
+- Allow for disabling of `isPedantic` storage checks in API options
+- Adjust usage of `objectSpread`, default to runtime as required
+- Adjust compilation output for `__internal__` class fields
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 10.4.1 Apr 22, 2023
+
+Contributed:
+
+- Apply `noInitWarn` flag to signed extension warnings (Thanks to https://github.com/xlc)
+
+Changes:
+
+- Adjust `AccountId20` detection with partial match
+- Cleanup block author extraction derives
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Drop support for Node 14 (EOL 30 Apr 2023)
+
+
+## 10.3.4 Apr 16, 2023
+
+Changes:
+
+- Ensure block author extract uses the correct as-at block construction state
+
+
+## 10.3.3 Apr 15, 2023
+
+Contributed:
+
+- Add support for Fungibles runtime api (Thanks to https://github.com/bkontur)
+- Update Nimbus Collator lookups (Thanks to https://github.com/grenade)
+
+Changes:
+
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Minimal support for a `@tsconfig/stricter` setup
+
+
+## 10.3.2 Apr 10, 2023
+
+Changes:
+
+- Revert throw on MSB BitVec (`toHuman()` output is still incorrect)
+
+
+## 10.3.1 Apr 9, 2023
+
+Changes:
+
+- Add `BitVec.toBoolArray()` helper function
+- Tie down `BitVec` from metadata to only allow (default) Lsb
+- Support for `TransactionPaymentApi/4`
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 10.2.2 Apr 1, 2023
+
+Contributed:
+
+- Support expanded Nimbus lookups to Collators (Thanks to https://github.com/grenade)
+
+Changes:
+
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 10.2.1 Mar 25, 2023
+
+Contributed:
+
+- Add support for new Frontier `AccountId20` mapping (Thanks to https://github.com/koushiro)
+- Adjust MMR RPCs & runtime calls to align with latest (Thanks to https://github.com/Lederstrumpf)
+
+Changes:
+
+- Use Promise resolve/reject to track state in typegen on-chain metadata retrievals
+- Adjust signing header retrieval, catering for discarded state fallbacks
+- Add support for `ParachainHost v4` runtime calls
+- Basic support for markdown generation for different chains (only Kusama & Polkadot currently added)
+- Add not-to-be-used `ISize` type support (same as `USize`, throwing on use - added for completeness)
+- Ensure `AccountId20.eq` does not fail on null/undefined inputs
+- Expand tests around `toU8a()` where the `isBare` flag is is being used
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 10.1.4 Mar 19, 2023
+
+Changes:
+
+- Add methods for v2 `Metadata_*` runtime calls
+
+
+## 10.1.3 Mar 15, 2023
+
+Changes:
+
+- Remove incorrect `.module.` specifiers in typegen code
+- Mark unsafe RPC methods (and include in `rpc.md` generation)
+
+
+## 10.1.2 Mar 11, 2023
+
+Changes:
+
+- Adjust type exports to remove invalid generated exports from `/src/`
+- Apply missing `/*#__PURE__*/` exports in `api-derive`
+
+
+## 10.1.1 Mar 11, 2023
+
+Contributed:
+
+- Fix yargs usage inside ESM modules (Thanks to https://github.com/conr2d)
+
+Changes:
+
+- Align runtime APIs with latest Substrate
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Use consistent `.js` imports in source files (TS moduleResolution)
+
+
+## 10.0.1 Mar 4, 2023
+
+Contributed:
+
+- Expose per-endpoint stats for providers (Thanks to https://github.com/jeluard)
+- Adjust ink! primitive extraction for v4 (Thanks to https://github.com/statictype)
+
+Changes:
+
+- Ensure that provider disconnect clears all subscriptions
+- Adjust typegen to internally use `import()` (catering for ESM provided types)
+- Swap TS -> JS compiler to use tsc (from babel)
+- Adjust all tests to use `node:test` runner (ESM variants)
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.14.2 Feb 19, 2023
+
+Changes:
+
+- Don't allow `WsProvider.connect()` on an open connection (creates resource leaks)
+- Adjust typegen to use metadata-defined aliases in query return decoration
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.14.1 Feb 12, 2023
+
+Changes:
+
+- Extract aliases for `*_runtime::Runtime{Call, Event}` from metadata
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.13.6 Feb 5, 2023
+
+Contributed:
+
+- Align `eth_getTransactionCount` with frontier (Thanks to https://github.com/alko89)
+
+Changes:
+
+- Additional override for `Compact<{ refTime: u64 }>` chains
+- Add script to retrieve local rpc, version & metadata for typegen
+
+
+## 9.13.5 Feb 2, 2023
+
+Changes:
+
+- Adjust `Weight` alias for 1.5 chains
+- Ensure correct registry is pass through for runtime TS generation
+
+
+## 9.13.4 Feb 1, 2023
+
+Changes:
+
+- None from 9.13.3 (The previous version had npm registry publishing issues)
+
+
+## 9.13.3 Feb 1, 2023
+
+Changes:
+
+- Adjust `Weight` alias detection to cater for `WeightV0/u32` overrides (e.g. early Kusama blocks)
+
+
+## 9.13.2 Jan 29, 2023
+
+Changes:
+
+- Allow null as valid param to Int/UInt
+
+
+## 9.13.1 Jan 29, 2023
+
+Contributed:
+
+- Add support for V3 of `TransactionPaymentApi` (Thanks to https://github.com/notlesh)
+
+Changes:
+
+- Adjust `Weight` alias detection (moved from `PortableRegistry` -> `Registry`)
+- Move default (typegen) weight alias to `WeightV2` (does not affect runtime detection)
+- Prepare metadata docs from chain generation for future cli arguments
+- Add base type object for (future) composite types
+- Apply additional JSDoc comments into `PortableRegistry`
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.12.1 Jan 22, 2023
+
+Changes:
+
+- Add `isStorageFallback` on the `Codec` interface. (`true` if entry was created from a metadata fallback value from an empty storage item)
+- Ensure `api.queryMulti` returns empty result when no keys are provided
+- Add explicit Array checks on `Vec/Tuple` inputs
+- Align `Struct.{toU8a/toPrimitive/toHuman/toJSON}` population of results
+- Apply memoization to batched API queries
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.11.3 Jan 15, 2023
+
+Changes:
+
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.11.2 Jan 13, 2023
+
+Changes:
+
+- Ensure `derive.democracy.preimages` retrieves correctly from (current-gen) `preimage`
+
+
+## 9.11.1 Jan 8, 2023
+
+- **Breaking change** For users of `ScProvider` you now need to explicitly pass `@substrate/connect` as a parameter. This means the code needs to be adjusted as follows -
+
+```js
+import { ScProvider } from '@polkadot/api';
+import * as Sc from '@substrate/connect';
+
+const provider = new ScProvider(Sc, Sc.WellKnownChain.polkadot);
+```
+
+Contributed:
+
+- Fix for typegen with nested tuples (Thanks to https://github.com/sander2)
+- Expose blockNumber on submittable results (Thanks to https://github.com/ken-centrality)
+
+Changes:
+
+- The `ScProvider` interface now needs receive an `@substrate/connect` instance
+- Along with the above `ScProvider.WellKnownChains` has been removed
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.10.5 Dec 27, 2022
+
+Changes:
+
+- Revert 9.10.4 paymentInfo changes (fallback only works on struct, not `Weight`)
+
+
+## 9.10.4 Dec 25, 2022
+
+Changes:
+
+- Align runtime `paymentInfo` calls with Substrate (w/ decoding fallbacks)
+
+
+## 9.10.3 Dec 17, 2022
+
+Changes:
+
+- Add override for Structs where `registry` appear as a field
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Kusama 9320/9340/9350 & Westend 9330/9340/9350 upgrade blocks
+
+
+## 9.10.2 Dec 9, 2022
+
+Changes:
+
+- Fix `derive.balances.account` detection for system vs balances
+
+
+## 9.10.1 Dec 4, 2022
+
+- **Important** Since [9.2.1](https://github.com/polkadot-js/api/releases/tag/v9.2.1) the recommended way of accessing `WellKnownChain` for light clients is via `ScProvider.WellKnownChain`. This release removes the explicit export from the `ScProvider` root.
+
+Changes:
+
+- Adjust payloads to use `BlockHash` types (as applicable)
+- Adjust type-only imports in `ScProvider`
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Update to `@polkadot/util` 10.2.1
+
+
+## 9.9.4 Nov 28, 2022
+
+Changes:
+
+- Fix dispatchQueue preimage retrieval in derives
+- No change from incorrectly published 9.9.3
+
+
+## 9.9.2 Nov 27, 2022
+
+Changes:
+
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.9.1 Nov 20, 2022
+
+Changes:
+
+- Update to latest Polkadot, Kusama & Substrate metadata
+- Adjust code for latest Eslint & TS released versions
+
+
+## 9.8.2 Nov 16, 2022
+
+Changes:
+
+- Adjust `api.rpc.payment.queryInfo` to always return `WeightV1` responses
+- Mark `api.rpc.payment.queryInfo` as deprecated (will be in a future Substrate version)
+
+
+## 9.8.1 Nov 13, 2022
+
+Contributed:
+
+- Params encoding fix for `api.rpc(...)` (Thanks to https://github.com/xlc)
+- Support for `WeightV2` contract interfaces (Thanks to https://github.com/jasl)
+
+Changes:
+
+- Cater for `TransactionPaymentApi/2` runtime calls
+- Add getters for `has{DryRun, PaymentInfo}` on submittables (feature detection)
+- Polkadot 9300, Kusama 9300 & Westend 9310/9320 upgrade blocks
+- Update to latest Polkadot, Kusama & Substrate metadata
+
+
+## 9.7.1 Nov 6, 2022
+
+Contributed:
+
+- Update `@substrate/connect` to latest (Thanks to https://github.com/wirednkod)
+- Add `api.rpc(method, ...params)` support (Thanks to https://github.com/xlc)
+
+Changes:
+
+- Align `ScProvider` code structure with other providers
+- Add `isClonable` getter on providers (some, e.g. sc doesn't support this)
+- Update to latest Substrate metadata
+
+
+## 9.6.2 Oct 30, 2022
+
+Changes:
+
+- Adjust historic `DispatchError` type for `statemint/statemine`
+
+
+## 9.6.1 Oct 23, 2022
+
+Contributed:
+
+- Update `@substrate/connect` to latest (Thanks to https://github.com/wirednkod)
+- Use `.?` operators in submittable class (Thanks to https://github.com/shunjizhan)
+
+Changes:
+
+- Cater for latest Substrate `DispatchError` (additional preimage statuses)
+- Adjust `api.derive.democracy.*` to return `imageHash` as `HexString` (as applicable, supports current-gen preimages)
+- Adjust `api.derive.preimages.*` to retrieve via `democracy` or `preimage` pallets
+- Ensure `apiAt.<section>.<method>.key(...)` passes through the correct arguments
+- Apply fallback for Weight downgrades (V2 >> V1 detection)
+- Update to latest Substrate metadata
+- Polkadot 9291 & Westend 9300 upgrade blocks
+
+
+## 9.5.2 Oct 16, 2022
+
+Changes:
+
+- Add `ParachainHost` version 3 runtime calls
+
+
+## 9.5.1 Oct 8, 2022
+
+- **Important** While the API witll detect and decorate the weight type based on V1 or V2, the default `Weight` type (used in runtime calls and RPCs) has not been swapped from the old `u64` variant. This means that on new chains using `WeightV2`, the TS decorated type will still reflect the old version.
+
+Changes:
+
+- Adjust handling of `Weight` type for V2 structures
+- Add alis definitions for `Weight{V1, V2}` (used for type overrides)
+- Cater for weight v2 (along with v1 pass-through) extrinsics in `api-contract`
+- Update to latest Substrate, Polkadot & Kusama metadata
+
+
+## 9.4.3 Oct 2, 2022
+
+Contributed:
+
+- Allow for new `ink_primitives` types (Thanks to https://github.com/statictype)
+- Fix contracts runtime `instantiate` call params (Thanks to https://github.com/statictype)
+
+Changes:
+
+- Align staking derive redeemableSum with Rust source (`currentEra` vs `activeEra` usage)
+- Add `@deprecated` flag to RPC interface generation (`contracts_*` & `state_get{Pairs/Keys}`)
+- Polkadot 9280/9281, Kusama 9291 upgrade blocks
+
+
+## 9.4.2 Sep 24, 2022
+
+Contributed:
+
+- Allow for re-subscriptions on `ScProvider` (Thanks to https://github.com/wirednkod)
+
+Changes:
+
+- Align derives to cater for latest (& previous) Substrate interfaces
+- Update to latest Substrate, Polkadot & Kusama metadata
+
+
+## 9.4.1 Sep 17, 2022
+
+Contributed:
+
+- Update `@substrate/connect` to latest (Thanks to https://github.com/wirednkod)
+
+Changes:
+
+- Cater for v1.5 Weight JSON representation (via RPC)
+- Polkadot 9270, Kusama 9280 & Westend 9290 upgrade blocks
+- Update to latest Substrate, Polkadot & Kusama metadata
+
+
+## 9.3.3 Sep 6, 2022
+
+Contributed:
+
+- Ensure JS reserved words are aliassed in types (Thanks to https://github.com/dqbd)
+
+Changes:
+
+- Fix and adjust tests for `AccountId{32, 33}`
+
+
+## 9.3.2 Sep 4, 2022
+
+Changes:
+
+- Cater for v1.5 Weight types (structure to inner value)
+- Westend 9280 & Kusama 9271 upgrade blocks
+- Update to latest Substrate, Polkadot & Kusama metadata
+
+
+## 9.3.1 Sep 3, 2022
+
+Changes:
+
+- Support for ink! v4 metadata
+- Adjust pool runtime call `pendingRewards` return type
+- Support for `AccountId33` (raw/compressed 33-byte ecdsa)
+- Update to latest Substrate, Polkadot & Kusama metadata
+
+
+## 9.2.4 Aug 27, 2022
+
+Changes:
+
+- Remove extra error logging in internal rpc-core Observable
+- Allow for embebbed `Enum` in `Struct` typegen (no `lookupName`)
+
+
 ## 9.2.3 Aug 21, 2022
 
+Contributed:
+
+- Update `@substrate/connect` to latest (Thanks to https://github.com/wirednkod)
+
 Changes:
 
 - Adjust `StakingLedger` with fallback for Kusama 1050 (2 different structures on-chain)

CONTRIBUTORS

@@ -1,15 +1,20 @@
-    3199	Jaco                          	9.2.3 (#5177)
+    3512	Jaco                          	Bump deps (#5785)
       83	Amaury Martiny                	StatementKind: Regular and Saft (#2303)
+      61	Tarik Gul                     	11.3.1 (#5909)
       37	Keith Ingram                  	Update contract types and rpc (#4541)
       35	Stefanie Doll                 	Updated child storage parameters (#1709)
       20	Luke Schoen                   	fix: Fixes TypeError: Cannot read property 'vesting' of undefined (#1970)
-      16	Xiliang Chen                  	implement entriesPaged and keysPages for query at (#4701)
+      19	Xiliang Chen                  	no warm for unknown signed extensions (#5601)
       15	Jeremías Díaz                 	feat(types): add correct tuple type to storage key (#3054)
+      14	Nikos Kontakis                	Bump substrate connect to 0.7.16 (#5307)
       11	Ian He                        	HttpProvider support clone() (#3949)
       10	Axel Chalon                   	Make Enum/Tuple constructor use value directly if instance (#1954)
-       9	Nikos Kontakis                	Bump substrate-connect to 0.7.11 (#5173)
+       6	Andreea Eftene                	Update check for contract instantiation (#5699)
        5	Chevdor                       	Fix metadata package link (#3458)
        5	Jake Naviasky                 	Fixing approvalFlagsToBools. (#1250)
+       5	Julien Eluard                 	General WsProvider extensibility improvements (#5467)
+       5	Matias Volpe                  	Bump @substrate/connect to 0.8.10 (#5863)
+       4	Alberto Nicolas Penayo        	fix: add support for `AuraUnincludedSegmentApi` (#5891)
        4	Alex D                        	Use derive customAccount and customLocks for balance overrides (#3248)
        4	Alex Wang                     	fix issue that creates duplicate providers (#983)
        4	Alexander Popiak              	Add asset id in signing (#4009)
@@ -20,11 +25,11 @@
        3	André Silva                   	add support for ValidationCodeHash (#3640)
        3	Antoine Estienne              	Adapted to display moonbeam author (#3108)
        3	Arjan Zijderveld              	Added `Emergency` to `ElectionPhase` (#3707)
+       3	Branislav Kontur              	Added FungiblesApi version 2 (#5687)
        3	Ewa Kowalska                  	Handle no council for bounties proposals (#3062)
        3	hamidra                       	add support for n key entries for NMaps (#3886)
        3	Hamza Tokuchi                 	more typos (#2532)
        3	Josep M Sobrepere             	docs: improve rpc-provider README (#4719)
-       3	Julien Eluard                 	Fixed typos about module balances (#1402)
        3	KarishmaBothara               	Backward compatibility thing (#3511)
        3	Miguel Hervas                 	Adding RT4 Types (#3007)
        3	Shawn Tabrizi                 	Add `isReadyOrError` when connecting to API (#2577)
@@ -32,12 +37,18 @@
        2	Alexander Krupenkin           	Add [u8; 33] type width for U8aFixed type (#2391)
        2	Branan Riley                  	Add proxy type for Centrifuge (#3940)
        2	Caio                          	Add `Range` and `RangeInclusive` types (#3791)
+       2	Francisco Gamundi             	Add chainIsEthereum prop to Registry interface (#5761)
        2	HackFisher                    	Update maxExtrinsic definition (#4703)
        2	Jakub Pánik                   	All heads subscription (#1899)
        2	James Lefrère                 	Add `.eq()` usage to docs and fix docs typos (#1405)
+       2	Javier Viola                  	add muln(2), as was in the old code (#5829)
+       2	Jeeyong Um                    	Alias for Noir types (#5678)
+       2	Jegor Sidorenko               	Use Box<XcmV3MultiLocation> instead of MultiAssetId (#5700)
        2	Keith Yeung                   	Allow keyPrefix to accept an additional argument for double maps (#2230)
        2	MOZGIII                       	Follow-up fix after #4665 (#4666)
        2	Paweł Nguyen                  	Fix a minor typo in cookbook blocks docs (#2294)
+       2	peetzweg/                     	feat: ink! v5 (#5791)
+       2	rob thijssen                  	nimbus author mapping correction (#5590)
        2	sung wu                       	Update tx.md (#2485)
        2	Veliko                        	Abi constructor takes different parameters (#3347)
        2	Wei Tang                      	Use /usr/bin/env bash instead of /bin/bash (#2053)
@@ -45,7 +56,7 @@
        2	Zannis Kalampoukis            	fix: Typegen handles structs and vectors of structs without erroring (#4743)
        2	扩散性百万甜面包                      	Typo, deocrateMethod -> decorateMethod (#1594)
        1	Alan Sapede                   	Adds Eth feeHistory & maxPriorityFeePerGas rpc (#4956)
-       1	Andreea Eftene                	Add storage deposit support (#4304)
+       1	Aleš Ferlan                   	fix: use H160 for address in getTransactionCount (#5472)
        1	Brad Larson                   	[NEW] Support for custom headers with providers (#2423)
        1	Btwiuse Arch                  	Add side effect check workaround (#4994) (#5009)
        1	chriswmercer                  	little readme tweak (#279)
@@ -55,11 +66,16 @@
        1	Daniel Maricic                	Fixed typo in README (#2402)
        1	Daniel Savu                   	fix: Generate custom type definitions (#4224)
        1	David                         	Don't log full error (#2952)
+       1	David Duong                   	Avoid reserved words during named enum fields augmentation (#5203)
        1	Denis Tsai                    	realign AccountKey20Junction to polkadot xcm's Junction enum (#3770)
        1	djuanito.eth                  	Update fees to current constants (#2320)
+       1	Dominique                     	fix: add optional chaining operator in `toHuman` (#5825)
        1	Drew Stone                    	Update evm definitions to include vicinity (#2279)
        1	Dylan Galea                   	Updated users of the polkadot-js/api (#2027)
+       1	Ermal Kaleci                  	fix cache key (rpc-provider) (#5745)
        1	flex                          	Change BeefySignedCommitment signatures type to EcdsaSignature (#4204)
+       1	Florian Franzen               	metadataMd: use endpoint for rpc and runtime details too (#5628)
+       1	Francis O'Brien               	fix: Re-subscribe to chain updates on reconnection if not a clone (#5794)
        1	Furqan A                      	fix: fixed 404 to the docs from the api readme (#3985)
        1	Gérard Dethier                	Fix LRUCache memory leak. (#4520)
        1	Gerben van de Wiel            	Adding some extra notes on changes in the specname (#2329)
@@ -72,11 +88,15 @@
        1	Joey                          	don't throw error at `onSocketClose` (#4363)
        1	Jordan                        	Allow typegen for custom RPCs (#2876)
        1	JQQQ                          	Allow rpc expose definition/ metadata (#3488)
+       1	Jun Jiang                     	Update contract' gas to Weight type (#5324)
+       1	Ken Vu                        	Expose `blockNumber` via filterEvents function (#5394)
        1	Kian Paimani                  	Update definitions.ts (#2514)
        1	Krzysztof Jelski              	Derive for bounties and descriptions (#2925)
        1	Lae                           	Make sure awaiting on an api object won't stuck forever on error (#1763)
+       1	Lauro Gripa                   	Fix multi call of `defenderVotes` and `isDefenderVoter` flag in `society.members` derivation (#5834)
        1	Lezek123                      	BTreeSet and BTreeMap - encoding and serialization fixes (#3789)
        1	Lovesh Harchandani            	Fix name of "getBlock" in package "api-derive" and export it in "index.ts" (#2857)
+       1	Marc Fornós                   	add beefy compact signed commitment definition (#5781)
        1	Mario Neises                  	fix usage with typescript (#405)
        1	Mario Pino                    	Add PolkaStats to API users (#1593)
        1	Mark Robert Henderson         	Update warnings.ts to have the latest URLs (#2720)
@@ -90,18 +110,29 @@
        1	Paul M Fox                    	Basic BTreeMaps codec support (#1474)
        1	philipstanislaus              	Update types for centrifuge chain v1.2.0 (#2424)
        1	Pierre Krieger                	Update substrate/connect to 0.7.6 (#4940)
+       1	polymath-eric                 	Allow unset external signer (#5649)
+       1	Qinxuan Chen                  	Add fp_account::AccountId20 mapping (#5551)
        1	qiuhao                        	update DeriveCustom type (#2581)
        1	r0t0r-r0t0r                   	Fix memory leak on raw rpc call (#4505)
        1	Raphael Flechtner             	fix: typegen disconnect ws on success (#4901)
+       1	Robert Gabriel Jakabosky      	Fix sorting of `Option` values and error on duplicates from BTreeSet/BTreeMap. (#5731)
+       1	Robert Hambrock               	update MMR API (#5479)
        1	Rocco Musolino                	remove broken link (#2671)
+       1	sander2                       	fix: type generation for nested tuples (#5395)
        1	satellitex                    	Add BTreeSet<V> Codec (#1639)
        1	satellitex                    	Add traits replace rules. for invalid cases `::<type>` and `<type>::`. (#885)
        1	Satyam Agrawal                	update as per the 0.97.0-beta.38 release (#1617)
        1	Sean Young                    	Solang requires u256 and i256 types (#2752)
+       1	Serban Iorga                  	Fix `beefy::subscribeJustifications()` return type (#5740)
        1	serge                         	make WS provider timeout configurable (#4758)
        1	Sergei Pepyakin               	INK! -> ink! (#1347)
+       1	Shunji Zhan                   	small polish (#5276)
+       1	Snoppy                        	chore: fix typos (#5835)
+       1	Stephen Shelton               	Add transaction-payment runtime API V3 (#5430)
+       1	Tim B                         	added EthRTApiV5 ifaces (#5680)
        1	WoeOm                         	adapt Darwinia, Crab Network types (#3498)
        1	Xat_MassacrE                  	Fix packages/types/src/codec/utils/encodeTypes.ts encodeSubTypes bug (#1544)
+       1	xiaolou86                     	Fix typos (#5747)
        1	yjh                           	fix MetadataVersioned.asV12 (#2983)
        1	Yuri                          	fixes #3693 Fix uniques return types (#3694)
        1	Zeke Mostov                   	fix: Allow sudo for polkadot indexed proxy enum (#3286)

README.md

@@ -1,15 +1,8 @@
-[![polkadotjs](https://img.shields.io/badge/polkadot-js-orange?style=flat-square)](https://polkadot.js.org)
-![license](https://img.shields.io/badge/License-Apache%202.0-blue?logo=apache&style=flat-square)
-[![npm](https://img.shields.io/npm/v/@polkadot/api?logo=npm&style=flat-square)](https://www.npmjs.com/package/@polkadot/api)
-[![beta](https://img.shields.io/npm/v/@polkadot/api/beta?label=beta&logo=npm&&style=flat-square)](https://www.npmjs.com/package/@polkadot/api)
-[![maintainability](https://img.shields.io/codeclimate/maintainability-percentage/polkadot-js/api?logo=code-climate&style=flat-square)](https://codeclimate.com/github/polkadot-js/api)
-[![coverage](https://img.shields.io/codeclimate/coverage/polkadot-js/api?logo=code-climate&style=flat-square)](https://codeclimate.com/github/polkadot-js/api)
-
 # @polkadot/api
 
-This library provides a clean wrapper around all the methods exposed by a Polkadot/Substrate network client and defines all the types exposed by a node. For complete documentation around the classes, interfaces and their use, visit the [documentation portal](https://polkadot.js.org/docs/api/).
+This library provides a clean wrapper around all the methods exposed by a Polkadot/Substrate network client and defines all the types exposed by a node. For complete documentation around the interfaces and their use, visit the [documentation portal](https://polkadot.js.org/docs/api/).
 
-If you are an existing user, please be sure to track the [CHANGELOG](CHANGELOG.md) and [UPGRADING](UPGRADING.md) guides when changing versions.
+If you are an existing user, please be sure to track the [CHANGELOG](CHANGELOG.md) when changing versions.
 
 ## tutorials
 

UPGRADING.md

@@ -1,201 +0,0 @@
-# Upgrade guide
-
-This is an upgrade guide for users of the API. It does not attempt to detail each version (the [CHANGELOG](CHANGELOG.md) has all the changes between versions), but rather tries to explain the rationale behind major breaking changes and how users of the API should handle this.
-
-While we try to keep the user-facing interfaces as stable as possible, sometimes you just need to make additions to move forward and improve things down the road, as painful as they may be. Like you, we are also users of the API, and eat our own dog food - and as such, feel any pains introduced first.
-
-
-## 0.97.1 (and newer)
-
-The 0.97 series lays the groundwork to allow type registration  to be ties to a specific chain and a specific Api instance. In the past, 2 Api instances in the same process would share types, which mean that you could not connect to 2 independent chains with different types. This is very problematic for Polkadot chains, where the idea is to connect to multiple chains.
-
-When using the Api, a new `Registry` will be created on using `new Api(...)` or `Api.create(...)` and this will be transparently passed when creating types. In the cases where you create type instances explicitly or create type classes for injection, you would need to make adjustments.
-
-### Type classes
-
-In a number of instances, developers are creating classes and making these available for interacting with their chains. For instance, an example of a custom type could be -
-
-```js
-import { Struct, Text, u32 } from '@polkadot/types';
-
-export class Preferences extends Struct {
-  constructor (value?: ahy) {
-    super({
-      name: Text,
-      id: u32
-    }, value);
-  }
-
-  ...
-}
-```
-
-In the current iteration, the underlying `@polkadot/types` bases structures now require a `Registry` to be passed as the first parameter. This means that the above signature would be adjusted to -
-
-```js
-// the next import is only required for TypeScript
-import { Registry } from '@polkadot/types/types';
-import { Struct, Text, u32 } from '@polkadot/types';
-
-export class Preferences extends Struct {
-  constructor (registry: Registry, value?: ahy) {
-    super(registry, {
-      name: Text,
-      id: u32
-    }, value);
-  }
-
-  ...
-}
-```
-
-Where the type is used or returned from the API, the `Registry` will be automatically passed to class creation.
-
-### createType
-
-Previously, when creating a type instance such as `BlockNumber`, you would do `api.createType('BlockNumber', <initValue>)`, this is unchanged. In the cases where you directly import from `@polkadot/types`, the following pattern is required -
-
-```js
-import { createType } from '@polkadot/types';
-
-...
-const blockNumber = createType(api.registry, 'BlockNumber', 12345);
-```
-
-In some cases, you would want to explicitly pass a `Registry` interface to the API, instead of relying on it explicitly. This is generally applicable in the cases where you want to use the `createType` independently from the API -
-
-```js
-import { ApiPromise } from '@polkadot/api';
-import { TypeRegistry, createType } from '@polkadot/types';
-
-...
-const registry = new TypeRegistry();
-const blockNumber = createType(registry, 'BlockNumber', 12345);
-const api = await ApiPromise.create({ registry });
-```
-
-### Extrinsic metadata
-
-In some applications, the undocumented `findFunction` has been used to determine the Api has the metadata for a specific extrinsic. The has been exposed on top of `GenericCall`, and it typically used in applications such as signers. Along with the compulsory registry, the above functions have been moved to the `Registry` itself, so if you previously had -
-
-```js
-const { meta, method, section } = GenericCall.findFunction(extrinsic.callIndex);
-```
-
-You need to change it to -
-
-```js
-const { meta, method, section } = registry.findMetaCall(extrinsic.callIndex);
-```
-
-## 0.90.1 (and newer), from 0.81.1 (and older)
-
-The 0.90.1 release caters for the [Kusama network](https://kusama.network/) and pulls in all the changes to support [Substrate 2.x](https://github.com/paritytech/substrate), all while maintaining backwards compatibility to allow operation on networks such as [Polkadot's Alexander](https://polkadot.network/).
-
-To support the network and the new transaction formats, a number of changes were made to how extrinsics are handled and signed. In addition, as support for ongoing work where type definitions are to be supplied by the actual node metadata, the foundation has been laid to move to type definitions as opposed to classes for runtime types.
-
-### Modules
-
-The first thing to be aware of is breakages when connecting to any new network, here older networks such as Alex are unaffected - the node metadata defines exactly what is available to the chain, so endpoints that worked yesterday still works today.
-
-There will no doubt be breakages in using calls to now non-existent endpoints (as populated by the metadata) if you are upgrading your nodes to Substrate 2.x. Substrate 2.x has had a number of internal changes, where new modules and features are introduced (such as `babe` and `technicalCommittee`), some modules have been renamed (such as `contract` -> `contracts`) and modules such as `session` has been reworked to a large degree.
-
-To cater for both 1.x and 2.x support, the [@polkadot/api-derive](packages/api-derive) endpoints, do feature detection for the node type and should continue working as-is. Additionally, a number of new derives have been added, specifically around elections.
-
-### Type renames
-
-To better align with the actual types from the metadata, and avoid (too much) context switching, some types from the `@polkadot/types` have been renamed. These include -
-
-- `Vector` -> `Vec`
-- `U{8|16|32|64|128|256}` have been removed, only the lowercase version of these remain, i.e. `u32`.
-
-### Type usage
-
-The [@polkadot/api](packages/api) has always handled the conversion of types for parameters when making calls or queries. For example, when making a transfer to `BOB` (address), any of the following is valid -
-
-- `api.tx.balances.transfer(BOB, 12345)` - value specified as a number
-- `api.tx.balances.transfer(BOB, '12345')` - value specified as a string
-- `api.tx.balances.transfer(BOB, '0x3039')` - value specified as a hex
-- `api.tx.balances.transfer(BOB, new BN(12345))` - value specified as a [BN](https://github.com/indutny/bn.js/)
-
-Internally the API will take the input and convert the value into a `Balance`, serialize it using the SCALE codec and transfer it to the node. In some cases users would construct the `Balance` type manually, by importing the class and calling `new` on it. This last approach has now been removed, and where classes are still available (limited reach), discouraged.
-
-First the rationale behind this - in all cases Substrate is very flexible, so while Polkadot (and the Substrate base), define `type Balance = u128`, this can be different between chains. (This also applies to the majority of built-in supported types). As such, type construction should be done via the actual registered types.
-
-```js
-// this is applicable everywhere, import the type creator, using the registry
-import { createType } from '@polkadot/types';
-
-// construct the Balance, of type Balance (type is inferred and available with TS)
-const value = createType('Balance', 12345);
-
-// use value here as you normally would
-...
-```
-
-The impact of this will be noticeable, if you have been importing the old-style type classes from `@polkadot/types`, those imports are not available anymore. For creation, just pass everything through the `createType`.
-
-If a TypeScript user, you can find the updated type (it is a type definition only, not a class), under `@polkadot/types/interfaces`. To do type casting, using interfaces -
-
-```js
-// import the TypeScript runtime interfaces we wish to use
-import { Balance, Hash } from '@polkadot/types/interfaces';
-
-// import the primitives we wish to use
-import { createType, Compact, Vec, u32 } from '@polkadot/types';
-
-// define an interface we want to use inside our code
-interface MyProps {
-  balance: Compact<Balance>;
-  changes: Vec<Hash>;
-  counter?: u32;
-}
-
-// assign something to this structure
-const props = {
-  balance: createType('Compact<Balance>', 12345),
-  changes: createType('Vec<Hash>', []) // empty for now
-};
-```
-
-### Type definitions
-
-One of the major pain points in working with a custom Substrate node is the definition of types to cater for chains. There are 2 approaches: defining types via a JSON format or extending your own classes in TypeScript (or JS) and injecting these. For the latter category, there are some impacts in the way you define these.
-
-If using JSON definitions, nothing changes, your types are still defined as -
-
-```json
-{
-  "MyStruct": {
-    "balance": "Compact<Balance>",
-    "values": "Vec<AccountId>",
-    "counter": "u32"
-  }
-}
-```
-
-For the definition of any structures using the Substrate specific types as classes, some adjustments are needed. Since the base modules types are now not available in classes, however it is needed for definitions, the following approach is encouraged -
-
-```js
-// import the ClassOf, it works the same as `createType` (along with type detection)
-// and acts as a replacement for the direct import and use of specific classes
-import { ClassOf, Struct, u32 } from '@polkadot/types';
-
-export class MyStruct extends Struct {
-  constructor (value?: any) {
-    super({
-      balance: ClassOf('Compact<Balance>'),
-      values: ClassOf('Vec<AccountId>'),
-      counter: u32
-    }, value);
-  }
-}
-```
-
-Internally the [@polkadot/types](packages/types) package now only defines classes where there are specific encoding logic applied. For all other types, the definitions are done via a JSON-like format and then the TypeScript definitions are generated from these. (In a world where nodes inject types and the type definitions are not needed, this functionality will be useful to allow TS developers to auto-generate type definitions based on what the node defines.)
-
-### Signing transactions (Signer interface)
-
-For users of the API signer interfaces (such as extensions and mobile signers), the interfaces have undergone some changes to cater for the extrinsic v2 format as defined by Substrate. If you are only supporting current chains (e.g. Alexander), no changes are required, however the old `sign` interface does not support chains such as Kusama, so all users are encouraged to upgrade to the new `signPayload` interface.
-
-This has already been implemented in both the [polkadot-js extension](https://github.com/polkadot-js/extension/blob/5f22f67d558655c605eb6f6beecef6826ed6c159/packages/extension/src/page/Signer.ts#L16v) as well as the [simple single signer](https://github.com/polkadot-js/api/blob/d56905d1b566be6f17eb570ac01448378fc91b67/packages/api/test/util/SingleAccountSigner.ts#L37).

babel.config.cjs

@@ -1,4 +0,0 @@
-// Copyright 2017-2022 @polkadot/api authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-module.exports = require('@polkadot/dev/config/babel-config-cjs.cjs');

eslint.config.js

@@ -0,0 +1,23 @@
+// Copyright 2017-2024 @polkadot/api authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import baseConfig from '@polkadot/dev/config/eslint';
+
+export default [
+  {
+    ignores: [
+      // see the tsconfig.eslint.json for explanation
+      'packages/api-augment/src/kusama/*.ts',
+      'packages/api-augment/src/polkadot/*.ts'
+    ]
+  },
+  ...baseConfig,
+  {
+    rules: {
+      // add override for any (a metric ton of them, initial conversion)
+      '@typescript-eslint/no-explicit-any': 'off',
+      // we generally use this in isFunction, not via calling
+      '@typescript-eslint/unbound-method': 'off'
+    }
+  }
+];

jest.config.cjs

@@ -1,19 +0,0 @@
-// Copyright 2017-2022 @polkadot/api authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-const config = require('@polkadot/dev/config/jest.cjs');
-
-module.exports = {
-  ...config,
-  moduleNameMapper: {
-    '@polkadot/api-(augment|base|contract|derive)(.*)$': '<rootDir>/packages/api-$1/src/$2',
-    // eslint-disable-next-line sort-keys
-    '@polkadot/api(.*)$': '<rootDir>/packages/api/src/$1',
-    '@polkadot/rpc-(augment|core|provider)(.*)$': '<rootDir>/packages/rpc-$1/src/$2',
-    '@polkadot/typegen(.*)$': '<rootDir>/packages/typegen/src/$1',
-    '@polkadot/types-(augment|codec|create|known|support)(.*)$': '<rootDir>/packages/types-$1/src/$2',
-    // eslint-disable-next-line sort-keys
-    '@polkadot/types(.*)$': '<rootDir>/packages/types/src/$1'
-  },
-  testTimeout: 30000
-};

package.json

@@ -1,9 +1,12 @@
 {
   "author": "Jaco Greeff <jacogr@gmail.com>",
   "bugs": "https://github.com/polkadot-js/api/issues",
+  "engines": {
+    "node": ">=18.14"
+  },
   "homepage": "https://github.com/polkadot-js/api#readme",
   "license": "Apache-2.0",
-  "packageManager": "yarn@3.2.0",
+  "packageManager": "yarn@4.2.2",
   "private": true,
   "repository": {
     "type": "git",
@@ -11,39 +14,37 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "9.2.3",
+  "version": "11.3.1",
   "versions": {
-    "git": "9.2.3",
-    "npm": "9.2.3"
+    "git": "11.3.1",
+    "npm": "11.3.1"
   },
   "workspaces": [
     "packages/*"
   ],
   "scripts": {
     "build": "yarn build:interfaces && polkadot-dev-build-ts",
-    "build:extra": "(cd packages/typegen && copyfiles scripts/* build)",
-    "build:interfaces": "polkadot-types-internal-interfaces",
-    "build:metadata": "yarn build:interfaces && yarn test:one packages/types/src/metadata/v14",
+    "build:before": "polkadot-dev-copy-dir --cd packages/typegen scripts build",
+    "build:interfaces": "node --loader @polkadot/dev-ts packages/typegen/scripts/polkadot-types-internal-interfaces.mjs",
+    "build:metadata": "yarn build:interfaces && polkadot-dev-run-test packages/types/src/metadata/v14",
     "build:release": "polkadot-ci-ghact-build",
     "build:rollup": "polkadot-exec-rollup --config",
+    "build:upgrades": "polkadot-dev-run-test upgrades/e2e",
     "chain:info": "polkadot-types-chain-info",
     "clean": "polkadot-dev-clean-build",
     "deno": "yarn polkadot-dev-deno-map && yarn build && deno check --import-map=import_map.json mod.ts",
     "lint": "polkadot-dev-run-lint",
     "postinstall": "polkadot-dev-yarn-only",
-    "test": "NODE_OPTIONS=--experimental-vm-modules polkadot-dev-run-test --coverage --forceExit --runInBand --testPathIgnorePatterns e2e",
-    "test:one": "NODE_OPTIONS=--experimental-vm-modules polkadot-dev-run-test --detectOpenHandles --forceExit"
+    "test": "polkadot-dev-run-test --env node ^e2e",
+    "test:node": "polkadot-dev-run-test --env node ^e2e",
+    "test:one": "polkadot-dev-run-test --env node"
   },
   "devDependencies": {
-    "@babel/core": "^7.18.10",
-    "@babel/register": "^7.18.9",
-    "@babel/runtime": "^7.18.9",
-    "@polkadot/dev": "^0.67.113",
+    "@polkadot/dev": "^0.79.3",
     "@polkadot/typegen": "workspace:packages/typegen",
-    "@types/jest": "^28.1.7",
-    "copyfiles": "^2.4.1"
+    "@types/node": "^20.11.6"
   },
   "resolutions": {
-    "typescript": "^4.7.4"
+    "typescript": "^5.3.3"
   }
 }

packages/api-augment/LICENSE

@@ -1,201 +0,0 @@
-                              Apache License
-                        Version 2.0, January 2004
-                    http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-  "License" shall mean the terms and conditions for use, reproduction,
-  and distribution as defined by Sections 1 through 9 of this document.
-
-  "Licensor" shall mean the copyright owner or entity authorized by
-  the copyright owner that is granting the License.
-
-  "Legal Entity" shall mean the union of the acting entity and all
-  other entities that control, are controlled by, or are under common
-  control with that entity. For the purposes of this definition,
-  "control" means (i) the power, direct or indirect, to cause the
-  direction or management of such entity, whether by contract or
-  otherwise, or (ii) ownership of fifty percent (50%) or more of the
-  outstanding shares, or (iii) beneficial ownership of such entity.
-
-  "You" (or "Your") shall mean an individual or Legal Entity
-  exercising permissions granted by this License.
-
-  "Source" form shall mean the preferred form for making modifications,
-  including but not limited to software source code, documentation
-  source, and configuration files.
-
-  "Object" form shall mean any form resulting from mechanical
-  transformation or translation of a Source form, including but
-  not limited to compiled object code, generated documentation,
-  and conversions to other media types.
-
-  "Work" shall mean the work of authorship, whether in Source or
-  Object form, made available under the License, as indicated by a
-  copyright notice that is included in or attached to the work
-  (an example is provided in the Appendix below).
-
-  "Derivative Works" shall mean any work, whether in Source or Object
-  form, that is based on (or derived from) the Work and for which the
-  editorial revisions, annotations, elaborations, or other modifications
-  represent, as a whole, an original work of authorship. For the purposes
-  of this License, Derivative Works shall not include works that remain
-  separable from, or merely link (or bind by name) to the interfaces of,
-  the Work and Derivative Works thereof.
-
-  "Contribution" shall mean any work of authorship, including
-  the original version of the Work and any modifications or additions
-  to that Work or Derivative Works thereof, that is intentionally
-  submitted to Licensor for inclusion in the Work by the copyright owner
-  or by an individual or Legal Entity authorized to submit on behalf of
-  the copyright owner. For the purposes of this definition, "submitted"
-  means any form of electronic, verbal, or written communication sent
-  to the Licensor or its representatives, including but not limited to
-  communication on electronic mailing lists, source code control systems,
-  and issue tracking systems that are managed by, or on behalf of, the
-  Licensor for the purpose of discussing and improving the Work, but
-  excluding communication that is conspicuously marked or otherwise
-  designated in writing by the copyright owner as "Not a Contribution."
-
-  "Contributor" shall mean Licensor and any individual or Legal Entity
-  on behalf of whom a Contribution has been received by Licensor and
-  subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  copyright license to reproduce, prepare Derivative Works of,
-  publicly display, publicly perform, sublicense, and distribute the
-  Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  (except as stated in this section) patent license to make, have made,
-  use, offer to sell, sell, import, and otherwise transfer the Work,
-  where such license applies only to those patent claims licensable
-  by such Contributor that are necessarily infringed by their
-  Contribution(s) alone or by combination of their Contribution(s)
-  with the Work to which such Contribution(s) was submitted. If You
-  institute patent litigation against any entity (including a
-  cross-claim or counterclaim in a lawsuit) alleging that the Work
-  or a Contribution incorporated within the Work constitutes direct
-  or contributory patent infringement, then any patent licenses
-  granted to You under this License for that Work shall terminate
-  as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the
-  Work or Derivative Works thereof in any medium, with or without
-  modifications, and in Source or Object form, provided that You
-  meet the following conditions:
-
-  (a) You must give any other recipients of the Work or
-      Derivative Works a copy of this License; and
-
-  (b) You must cause any modified files to carry prominent notices
-      stating that You changed the files; and
-
-  (c) You must retain, in the Source form of any Derivative Works
-      that You distribute, all copyright, patent, trademark, and
-      attribution notices from the Source form of the Work,
-      excluding those notices that do not pertain to any part of
-      the Derivative Works; and
-
-  (d) If the Work includes a "NOTICE" text file as part of its
-      distribution, then any Derivative Works that You distribute must
-      include a readable copy of the attribution notices contained
-      within such NOTICE file, excluding those notices that do not
-      pertain to any part of the Derivative Works, in at least one
-      of the following places: within a NOTICE text file distributed
-      as part of the Derivative Works; within the Source form or
-      documentation, if provided along with the Derivative Works; or,
-      within a display generated by the Derivative Works, if and
-      wherever such third-party notices normally appear. The contents
-      of the NOTICE file are for informational purposes only and
-      do not modify the License. You may add Your own attribution
-      notices within Derivative Works that You distribute, alongside
-      or as an addendum to the NOTICE text from the Work, provided
-      that such additional attribution notices cannot be construed
-      as modifying the License.
-
-  You may add Your own copyright statement to Your modifications and
-  may provide additional or different license terms and conditions
-  for use, reproduction, or distribution of Your modifications, or
-  for any such Derivative Works as a whole, provided Your use,
-  reproduction, and distribution of the Work otherwise complies with
-  the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise,
-  any Contribution intentionally submitted for inclusion in the Work
-  by You to the Licensor shall be under the terms and conditions of
-  this License, without any additional terms or conditions.
-  Notwithstanding the above, nothing herein shall supersede or modify
-  the terms of any separate license agreement you may have executed
-  with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade
-  names, trademarks, service marks, or product names of the Licensor,
-  except as required for reasonable and customary use in describing the
-  origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or
-  agreed to in writing, Licensor provides the Work (and each
-  Contributor provides its Contributions) on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-  implied, including, without limitation, any warranties or conditions
-  of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-  PARTICULAR PURPOSE. You are solely responsible for determining the
-  appropriateness of using or redistributing the Work and assume any
-  risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory,
-  whether in tort (including negligence), contract, or otherwise,
-  unless required by applicable law (such as deliberate and grossly
-  negligent acts) or agreed to in writing, shall any Contributor be
-  liable to You for damages, including any direct, indirect, special,
-  incidental, or consequential damages of any character arising as a
-  result of this License or out of the use or inability to use the
-  Work (including but not limited to damages for loss of goodwill,
-  work stoppage, computer failure or malfunction, or any and all
-  other commercial damages or losses), even if such Contributor
-  has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing
-  the Work or Derivative Works thereof, You may choose to offer,
-  and charge a fee for, acceptance of support, warranty, indemnity,
-  or other liability obligations and/or rights consistent with this
-  License. However, in accepting such obligations, You may act only
-  on Your own behalf and on Your sole responsibility, not on behalf
-  of any other Contributor, and only if You agree to indemnify,
-  defend, and hold each Contributor harmless for any liability
-  incurred by, or claims asserted against, such Contributor by reason
-  of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work.
-
-  To apply the Apache License to your work, attach the following
-  boilerplate notice, with the fields enclosed by brackets "[]"
-  replaced with your own identifying information. (Don't include
-  the brackets!)  The text should be enclosed in the appropriate
-  comment syntax for the file format. We also recommend that a
-  file or class name and description of purpose be included on the
-  same "printed page" as the copyright notice for easier
-  identification within third-party archives.
-
-Copyright [yyyy] [name of copyright owner]
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.

packages/api-augment/package.json

@@ -1,14 +1,12 @@
 {
   "author": "Jaco Greeff <jacogr@gmail.com>",
   "bugs": "https://github.com/polkadot-js/api/issues",
-  "contributors": [],
   "description": "API generated augmentation",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18"
   },
   "homepage": "https://github.com/polkadot-js/api/tree/master/packages/api-augment#readme",
   "license": "Apache-2.0",
-  "maintainers": [],
   "name": "@polkadot/api-augment",
   "repository": {
     "directory": "packages/api-augment",
@@ -16,22 +14,19 @@
     "url": "https://github.com/polkadot-js/api.git"
   },
   "sideEffects": [
-    "./detectPackage.js",
-    "./detectPackage.cjs"
+    "./packageDetect.js",
+    "./packageDetect.cjs"
   ],
   "type": "module",
-  "version": "9.2.3",
+  "version": "11.3.1",
   "main": "index.js",
   "dependencies": {
-    "@babel/runtime": "^7.18.9",
-    "@polkadot/api-base": "9.2.3",
-    "@polkadot/rpc-augment": "9.2.3",
-    "@polkadot/types": "9.2.3",
-    "@polkadot/types-augment": "9.2.3",
-    "@polkadot/types-codec": "9.2.3",
-    "@polkadot/util": "^10.1.5"
-  },
-  "devDependencies": {
-    "@polkadot/types-support": "9.2.3"
+    "@polkadot/api-base": "11.3.1",
+    "@polkadot/rpc-augment": "11.3.1",
+    "@polkadot/types": "11.3.1",
+    "@polkadot/types-augment": "11.3.1",
+    "@polkadot/types-codec": "11.3.1",
+    "@polkadot/util": "^12.6.2",
+    "tslib": "^2.6.2"
   }
 }

packages/api-augment/src/base.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 // for the API, we decorate not only the endpoints, but all types

packages/api-augment/src/bundle.ts

@@ -1,6 +1,6 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import './substrate';
+import './substrate/index.js';
 
-export { packageInfo } from './packageInfo';
+export { packageInfo } from './packageInfo.js';

packages/api-augment/src/detectOther.ts

@@ -1,8 +0,0 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-import { packageInfo as baseInfo } from '@polkadot/api-base/packageInfo';
-import { packageInfo as typesInfo } from '@polkadot/types/packageInfo';
-import { packageInfo as codecInfo } from '@polkadot/types-codec/packageInfo';
-
-export default [baseInfo, typesInfo, codecInfo];

packages/api-augment/src/detectPackage.ts

@@ -1,11 +0,0 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-// Do not edit, auto-generated by @polkadot/dev
-
-import { detectPackage } from '@polkadot/util';
-
-import others from './detectOther';
-import { packageInfo } from './packageInfo';
-
-detectPackage(packageInfo, null, others);

packages/api-augment/src/index.ts

@@ -1,6 +1,6 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import './detectPackage';
+import './packageDetect.js';
 
-export * from './bundle';
+export * from './bundle.js';

packages/api-augment/src/kusama/consts.ts

@@ -6,10 +6,10 @@
 import '@polkadot/api-base/types/consts';
 
 import type { ApiTypes, AugmentedConst } from '@polkadot/api-base/types';
-import type { Bytes, Option, U8aFixed, Vec, bool, u128, u16, u32, u64, u8 } from '@polkadot/types-codec';
-import type { Codec } from '@polkadot/types-codec/types';
-import type { Perbill, Percent, Permill } from '@polkadot/types/interfaces/runtime';
-import type { FrameSupportPalletId, FrameSupportWeightsRuntimeDbWeight, FrameSystemLimitsBlockLength, FrameSystemLimitsBlockWeights, SpVersionRuntimeVersion } from '@polkadot/types/lookup';
+import type { Bytes, Option, Vec, u128, u16, u32, u64, u8 } from '@polkadot/types-codec';
+import type { Codec, ITuple } from '@polkadot/types-codec/types';
+import type { Perbill, Permill, Perquintill } from '@polkadot/types/interfaces/runtime';
+import type { FrameSupportPalletId, FrameSystemLimitsBlockLength, FrameSystemLimitsBlockWeights, PalletReferendaTrackInfo, SpVersionRuntimeVersion, SpWeightsRuntimeDbWeight, SpWeightsWeightV2Weight } from '@polkadot/types/lookup';
 
 export type __AugmentedConst<ApiType extends ApiTypes> = AugmentedConst<ApiType>;
 
@@ -33,18 +33,6 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    authorship: {
-      /**
-       * The number of blocks back we should accept uncles.
-       * This means that we will deal with uncle-parents that are
-       * `UncleGenerations + 1` before `now`.
-       **/
-      uncleGenerations: u32 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
     babe: {
       /**
        * The amount of time, in slots, that each epoch should last.
@@ -64,6 +52,10 @@ declare module '@polkadot/api-base/types/consts' {
        * Max number of authorities allowed
        **/
       maxAuthorities: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of nominators for each validator.
+       **/
+      maxNominators: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -71,9 +63,20 @@ declare module '@polkadot/api-base/types/consts' {
     };
     balances: {
       /**
-       * The minimum amount required to keep an account open.
+       * The minimum amount required to keep an account open. MUST BE GREATER THAN ZERO!
+       * 
+       * If you *really* need it to be zero, you can enable the feature `insecure_zero_ed` for
+       * this pallet. However, you do so at your own risk: this will open up a major DoS vector.
+       * In case you have multiple sources of provider references, you may also get unexpected
+       * behaviour if you set this to zero.
+       * 
+       * Bottom line: Do yourself a favour and make it at least one!
        **/
       existentialDeposit: u128 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of individual freeze locks that can exist on an account at any time.
+       **/
+      maxFreezes: u32 & AugmentedConst<ApiType>;
       /**
        * The maximum number of locks that should exist on an account.
        * Not strictly enforced, but used for weight estimation.
@@ -88,6 +91,29 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    beefy: {
+      /**
+       * The maximum number of authorities that can be added.
+       **/
+      maxAuthorities: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of nominators for each validator.
+       **/
+      maxNominators: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of entries to keep in the set id to session index mapping.
+       * 
+       * Since the `SetIdSession` map is only used for validating equivocations this
+       * value should relate to the bonding duration of whatever staking system is
+       * being used (if any). If equivocation handling is not enabled then this value
+       * can be zero.
+       **/
+      maxSetIdSessionEntries: u64 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     bounties: {
       /**
        * The amount held on deposit for placing a bounty proposal.
@@ -156,71 +182,14 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    crowdloan: {
+    convictionVoting: {
       /**
-       * The minimum amount that may be contributed into a crowdloan. Should almost certainly be at
-       * least `ExistentialDeposit`.
-       **/
-      minContribution: u128 & AugmentedConst<ApiType>;
-      /**
-       * `PalletId` for the crowdloan pallet. An appropriate value could be `PalletId(*b"py/cfund")`
-       **/
-      palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
-      /**
-       * Max number of storage keys to remove per extrinsic call.
-       **/
-      removeKeysLimit: u32 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
-    democracy: {
-      /**
-       * Period in blocks where an external proposal may not be re-submitted after being vetoed.
-       **/
-      cooloffPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * The period between a proposal being approved and enacted.
+       * The maximum number of concurrent votes an account may have.
        * 
-       * It should generally be a little more than the unstake period to ensure that
-       * voting stakers have an opportunity to remove themselves from the system in the case
-       * where they are on the losing side of a vote.
-       **/
-      enactmentPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * Minimum voting period allowed for a fast-track referendum.
-       **/
-      fastTrackVotingPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * Indicator for whether an emergency origin is even allowed to happen. Some chains may
-       * want to set this permanently to `false`, others may want to condition it on things such
-       * as an upgrade having happened recently.
-       **/
-      instantAllowed: bool & AugmentedConst<ApiType>;
-      /**
-       * How often (in blocks) new public referenda are launched.
-       **/
-      launchPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of public proposals that can exist at any time.
-       **/
-      maxProposals: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of votes for an account.
-       * 
-       * Also used to compute weight, an overly big value can
-       * lead to extrinsic with very big weight: see `delegate` for instance.
+       * Also used to compute weight, an overly large value can lead to extrinsics with large
+       * weight estimation: see `delegate` for instance.
        **/
       maxVotes: u32 & AugmentedConst<ApiType>;
-      /**
-       * The minimum amount to be used as a deposit for a public referendum proposal.
-       **/
-      minimumDeposit: u128 & AugmentedConst<ApiType>;
-      /**
-       * The amount of balance that must be deposited per byte of preimage stored.
-       **/
-      preimageByteDeposit: u128 & AugmentedConst<ApiType>;
       /**
        * The minimum period of vote locking.
        * 
@@ -229,9 +198,35 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       voteLockingPeriod: u32 & AugmentedConst<ApiType>;
       /**
-       * How often (in blocks) to check for new votes.
+       * Generic const
        **/
-      votingPeriod: u32 & AugmentedConst<ApiType>;
+      [key: string]: Codec;
+    };
+    coretime: {
+      /**
+       * The ParaId of the broker system parachain.
+       **/
+      brokerId: u32 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
+    crowdloan: {
+      /**
+       * The minimum amount that may be contributed into a crowdloan. Should almost certainly be
+       * at least `ExistentialDeposit`.
+       **/
+      minContribution: u128 & AugmentedConst<ApiType>;
+      /**
+       * `PalletId` for the crowdloan pallet. An appropriate value could be
+       * `PalletId(*b"py/cfund")`
+       **/
+      palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
+      /**
+       * Max number of storage keys to remove per extrinsic call.
+       **/
+      removeKeysLimit: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -244,20 +239,16 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       betterSignedThreshold: Perbill & AugmentedConst<ApiType>;
       /**
-       * The minimum amount of improvement to the solution score that defines a solution as
-       * "better" in the Unsigned phase.
+       * The maximum number of winners that can be elected by this `ElectionProvider`
+       * implementation.
+       * 
+       * Note: This must always be greater or equal to `T::DataProvider::desired_targets()`.
        **/
-      betterUnsignedThreshold: Perbill & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of electable targets to put in the snapshot.
-       **/
-      maxElectableTargets: u16 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of electing voters to put in the snapshot. At the moment, snapshots
-       * are only over a single block, but once multi-block elections are introduced they will
-       * take place over multiple blocks.
-       **/
-      maxElectingVoters: u32 & AugmentedConst<ApiType>;
+      maxWinners: u32 & AugmentedConst<ApiType>;
+      minerMaxLength: u32 & AugmentedConst<ApiType>;
+      minerMaxVotesPerVoter: u32 & AugmentedConst<ApiType>;
+      minerMaxWeight: SpWeightsWeightV2Weight & AugmentedConst<ApiType>;
+      minerMaxWinners: u32 & AugmentedConst<ApiType>;
       /**
        * The priority of the unsigned transaction submitted in the unsigned-phase
        **/
@@ -269,10 +260,6 @@ declare module '@polkadot/api-base/types/consts' {
        * to submit the worker's solution.
        **/
       offchainRepeat: u32 & AugmentedConst<ApiType>;
-      /**
-       * Base deposit for a signed solution.
-       **/
-      signedDepositBase: u128 & AugmentedConst<ApiType>;
       /**
        * Per-byte deposit for a signed solution.
        **/
@@ -302,7 +289,7 @@ declare module '@polkadot/api-base/types/consts' {
        * this pallet), then [`MinerConfig::solution_weight`] is used to compare against
        * this value.
        **/
-      signedMaxWeight: u64 & AugmentedConst<ApiType>;
+      signedMaxWeight: SpWeightsWeightV2Weight & AugmentedConst<ApiType>;
       /**
        * Duration of the signed phase.
        **/
@@ -320,50 +307,41 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    gilt: {
+    fastUnstake: {
       /**
-       * Portion of the queue which is free from ordering and just a FIFO.
-       * 
-       * Must be no greater than `MaxQueueLen`.
+       * Deposit to take for unstaking, to make sure we're able to slash the it in order to cover
+       * the costs of resources on unsuccessful unstake.
        **/
-      fifoQueueLen: u32 & AugmentedConst<ApiType>;
+      deposit: u128 & AugmentedConst<ApiType>;
       /**
-       * The number of blocks between consecutive attempts to issue more gilts in an effort to
-       * get to the target amount to be frozen.
-       * 
-       * A larger value results in fewer storage hits each block, but a slower period to get to
-       * the target.
+       * Generic const
        **/
-      intakePeriod: u32 & AugmentedConst<ApiType>;
+      [key: string]: Codec;
+    };
+    fellowshipReferenda: {
       /**
-       * The maximum amount of bids that can be turned into issued gilts each block. A larger
-       * value here means less of the block available for transactions should there be a glut of
-       * bids to make into gilts to reach the target.
+       * Quantization level for the referendum wakeup scheduler. A higher number will result in
+       * fewer storage reads/writes needed for smaller voters, but also result in delays to the
+       * automatic referendum status changes. Explicit servicing instructions are unaffected.
        **/
-      maxIntakeBids: u32 & AugmentedConst<ApiType>;
+      alarmInterval: u32 & AugmentedConst<ApiType>;
       /**
-       * Maximum number of items that may be in each duration queue.
+       * Maximum size of the referendum queue for a single track.
        **/
-      maxQueueLen: u32 & AugmentedConst<ApiType>;
+      maxQueued: u32 & AugmentedConst<ApiType>;
       /**
-       * The minimum amount of funds that may be offered to freeze for a gilt. Note that this
-       * does not actually limit the amount which may be frozen in a gilt since gilts may be
-       * split up in order to satisfy the desired amount of funds under gilts.
-       * 
-       * It should be at least big enough to ensure that there is no possible storage spam attack
-       * or queue-filling attack.
+       * The minimum amount to be used as a deposit for a public referendum proposal.
        **/
-      minFreeze: u128 & AugmentedConst<ApiType>;
+      submissionDeposit: u128 & AugmentedConst<ApiType>;
       /**
-       * The base period for the duration queues. This is the common multiple across all
-       * supported freezing durations that can be bid upon.
+       * Information concerning the different referendum tracks.
        **/
-      period: u32 & AugmentedConst<ApiType>;
+      tracks: Vec<ITuple<[u16, PalletReferendaTrackInfo]>> & AugmentedConst<ApiType>;
       /**
-       * Number of duration queues in total. This sets the maximum duration supported, which is
-       * this value multiplied by `Period`.
+       * The number of blocks after submission that a referendum must begin being decided by.
+       * Once this passes, then anyone may cancel the referendum.
        **/
-      queueCount: u32 & AugmentedConst<ApiType>;
+      undecidingTimeout: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -374,6 +352,19 @@ declare module '@polkadot/api-base/types/consts' {
        * Max Authorities in use
        **/
       maxAuthorities: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of nominators for each validator.
+       **/
+      maxNominators: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of entries to keep in the set id to session index mapping.
+       * 
+       * Since the `SetIdSession` map is only used for validating equivocations this
+       * value should relate to the bonding duration of whatever staking system is
+       * being used (if any). If equivocation handling is not enabled then this value
+       * can be zero.
+       **/
+      maxSetIdSessionEntries: u64 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -381,18 +372,13 @@ declare module '@polkadot/api-base/types/consts' {
     };
     identity: {
       /**
-       * The amount held on deposit for a registered identity
+       * The amount held on deposit for a registered identity.
        **/
       basicDeposit: u128 & AugmentedConst<ApiType>;
       /**
-       * The amount held on deposit per additional field for a registered identity.
+       * The amount held on deposit per encoded byte for a registered identity.
        **/
-      fieldDeposit: u128 & AugmentedConst<ApiType>;
-      /**
-       * Maximum number of additional fields that may be stored in an ID. Needed to bound the I/O
-       * required to access an identity, but can be pretty high.
-       **/
-      maxAdditionalFields: u32 & AugmentedConst<ApiType>;
+      byteDeposit: u128 & AugmentedConst<ApiType>;
       /**
        * Maxmimum number of registrars allowed in the system. Needed to bound the complexity
        * of, e.g., updating judgements.
@@ -402,6 +388,18 @@ declare module '@polkadot/api-base/types/consts' {
        * The maximum number of sub-accounts allowed per identified account.
        **/
       maxSubAccounts: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum length of a suffix.
+       **/
+      maxSuffixLength: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum length of a username, including its suffix and any system-added delimiters.
+       **/
+      maxUsernameLength: u32 & AugmentedConst<ApiType>;
+      /**
+       * The number of blocks within which a username grant must be accepted.
+       **/
+      pendingUsernameExpiration: u32 & AugmentedConst<ApiType>;
       /**
        * The amount held on deposit for a registered subaccount. This should account for the fact
        * that one storage item's value will increase by the size of an account ID, and there will
@@ -413,19 +411,6 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    imOnline: {
-      /**
-       * A configuration for base priority of unsigned transactions.
-       * 
-       * This is exposed so that it can be tuned for particular runtime, when
-       * multiple pallets send unsigned transactions.
-       **/
-      unsignedPriority: u64 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
     indices: {
       /**
        * The deposit needed for reserving an index.
@@ -436,6 +421,34 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    messageQueue: {
+      /**
+       * The size of the page; this implies the maximum message size which can be sent.
+       * 
+       * A good value depends on the expected message sizes, their weights, the weight that is
+       * available for processing them and the maximal needed message size. The maximal message
+       * size is slightly lower than this as defined by [`MaxMessageLenOf`].
+       **/
+      heapSize: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of stale pages (i.e. of overweight messages) allowed before culling
+       * can happen. Once there are more stale pages than this, then historical pages may be
+       * dropped, even if they contain unprocessed overweight messages.
+       **/
+      maxStale: u32 & AugmentedConst<ApiType>;
+      /**
+       * The amount of weight (if any) which should be provided to the message queue for
+       * servicing enqueued items.
+       * 
+       * This may be legitimately `None` in the case that you will call
+       * `ServiceQueues::service_queues` manually.
+       **/
+      serviceWeight: Option<SpWeightsWeightV2Weight> & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     multisig: {
       /**
        * The base amount of currency needed to reserve for creating a multisig execution or to
@@ -455,7 +468,100 @@ declare module '@polkadot/api-base/types/consts' {
       /**
        * The maximum amount of signatories allowed in the multisig.
        **/
-      maxSignatories: u16 & AugmentedConst<ApiType>;
+      maxSignatories: u32 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
+    nis: {
+      /**
+       * The base period for the duration queues. This is the common multiple across all
+       * supported freezing durations that can be bid upon.
+       **/
+      basePeriod: u32 & AugmentedConst<ApiType>;
+      /**
+       * Portion of the queue which is free from ordering and just a FIFO.
+       * 
+       * Must be no greater than `MaxQueueLen`.
+       **/
+      fifoQueueLen: u32 & AugmentedConst<ApiType>;
+      /**
+       * The number of blocks between consecutive attempts to dequeue bids and create receipts.
+       * 
+       * A larger value results in fewer storage hits each block, but a slower period to get to
+       * the target.
+       **/
+      intakePeriod: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum amount of bids that can consolidated into receipts in a single intake. A
+       * larger value here means less of the block available for transactions should there be a
+       * glut of bids.
+       **/
+      maxIntakeWeight: SpWeightsWeightV2Weight & AugmentedConst<ApiType>;
+      /**
+       * Maximum number of items that may be in each duration queue.
+       * 
+       * Must be larger than zero.
+       **/
+      maxQueueLen: u32 & AugmentedConst<ApiType>;
+      /**
+       * The minimum amount of funds that may be placed in a bid. Note that this
+       * does not actually limit the amount which may be represented in a receipt since bids may
+       * be split up by the system.
+       * 
+       * It should be at least big enough to ensure that there is no possible storage spam attack
+       * or queue-filling attack.
+       **/
+      minBid: u128 & AugmentedConst<ApiType>;
+      /**
+       * The minimum amount of funds which may intentionally be left remaining under a single
+       * receipt.
+       **/
+      minReceipt: Perquintill & AugmentedConst<ApiType>;
+      /**
+       * The treasury's pallet id, used for deriving its sovereign account ID.
+       **/
+      palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
+      /**
+       * Number of duration queues in total. This sets the maximum duration supported, which is
+       * this value multiplied by `Period`.
+       **/
+      queueCount: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum proportion which may be thawed and the period over which it is reset.
+       **/
+      thawThrottle: ITuple<[Perquintill, u32]> & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
+    nisCounterpartBalances: {
+      /**
+       * The minimum amount required to keep an account open. MUST BE GREATER THAN ZERO!
+       * 
+       * If you *really* need it to be zero, you can enable the feature `insecure_zero_ed` for
+       * this pallet. However, you do so at your own risk: this will open up a major DoS vector.
+       * In case you have multiple sources of provider references, you may also get unexpected
+       * behaviour if you set this to zero.
+       * 
+       * Bottom line: Do yourself a favour and make it at least one!
+       **/
+      existentialDeposit: u128 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of individual freeze locks that can exist on an account at any time.
+       **/
+      maxFreezes: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of locks that should exist on an account.
+       * Not strictly enforced, but used for weight estimation.
+       **/
+      maxLocks: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of named reserves that can exist on an account.
+       **/
+      maxReserves: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -477,6 +583,10 @@ declare module '@polkadot/api-base/types/consts' {
        * Such a scenario would also be the equivalent of the pool being 90% slashed.
        **/
       maxPointsToBalance: u8 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of simultaneous unbonding chunks that can exist per member.
+       **/
+      maxUnbonding: u32 & AugmentedConst<ApiType>;
       /**
        * The nomination pool's pallet id.
        **/
@@ -486,62 +596,18 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    paras: {
-      unsignedPriority: u64 & AugmentedConst<ApiType>;
+    onDemandAssignmentProvider: {
+      /**
+       * The default value for the spot traffic multiplier.
+       **/
+      trafficDefaultValue: u128 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
       [key: string]: Codec;
     };
-    phragmenElection: {
-      /**
-       * How much should be locked up in order to submit one's candidacy.
-       **/
-      candidacyBond: u128 & AugmentedConst<ApiType>;
-      /**
-       * Number of members to elect.
-       **/
-      desiredMembers: u32 & AugmentedConst<ApiType>;
-      /**
-       * Number of runners_up to keep.
-       **/
-      desiredRunnersUp: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of candidates in a phragmen election.
-       * 
-       * Warning: The election happens onchain, and this value will determine
-       * the size of the election. When this limit is reached no more
-       * candidates are accepted in the election.
-       **/
-      maxCandidates: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of voters to allow in a phragmen election.
-       * 
-       * Warning: This impacts the size of the election which is run onchain.
-       * When the limit is reached the new voters are ignored.
-       **/
-      maxVoters: u32 & AugmentedConst<ApiType>;
-      /**
-       * Identifier for the elections-phragmen pallet's lock
-       **/
-      palletId: U8aFixed & AugmentedConst<ApiType>;
-      /**
-       * How long each seat is kept. This defines the next block number at which an election
-       * round will happen. If set to zero, no elections are ever triggered and the module will
-       * be in passive mode.
-       **/
-      termDuration: u32 & AugmentedConst<ApiType>;
-      /**
-       * Base deposit associated with voting.
-       * 
-       * This should be sensibly high to economically ensure the pallet cannot be attacked by
-       * creating a gigantic number of votes.
-       **/
-      votingBondBase: u128 & AugmentedConst<ApiType>;
-      /**
-       * The amount of bond that need to be locked for each vote (32 bytes).
-       **/
-      votingBondFactor: u128 & AugmentedConst<ApiType>;
+    paras: {
+      unsignedPriority: u64 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -630,13 +696,42 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    referenda: {
+      /**
+       * Quantization level for the referendum wakeup scheduler. A higher number will result in
+       * fewer storage reads/writes needed for smaller voters, but also result in delays to the
+       * automatic referendum status changes. Explicit servicing instructions are unaffected.
+       **/
+      alarmInterval: u32 & AugmentedConst<ApiType>;
+      /**
+       * Maximum size of the referendum queue for a single track.
+       **/
+      maxQueued: u32 & AugmentedConst<ApiType>;
+      /**
+       * The minimum amount to be used as a deposit for a public referendum proposal.
+       **/
+      submissionDeposit: u128 & AugmentedConst<ApiType>;
+      /**
+       * Information concerning the different referendum tracks.
+       **/
+      tracks: Vec<ITuple<[u16, PalletReferendaTrackInfo]>> & AugmentedConst<ApiType>;
+      /**
+       * The number of blocks after submission that a referendum must begin being decided by.
+       * Once this passes, then anyone may cancel the referendum.
+       **/
+      undecidingTimeout: u32 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     registrar: {
       /**
        * The deposit to be paid per byte stored on chain.
        **/
       dataDepositPerByte: u128 & AugmentedConst<ApiType>;
       /**
-       * The deposit to be paid to run a parathread.
+       * The deposit to be paid to run a on-demand parachain.
        * This should include the cost for storing the genesis head and validation code.
        **/
       paraDeposit: u128 & AugmentedConst<ApiType>;
@@ -647,13 +742,15 @@ declare module '@polkadot/api-base/types/consts' {
     };
     scheduler: {
       /**
-       * The maximum weight that may be scheduled per block for any dispatchables of less
-       * priority than `schedule::HARD_DEADLINE`.
+       * The maximum weight that may be scheduled per block for any dispatchables.
        **/
-      maximumWeight: u64 & AugmentedConst<ApiType>;
+      maximumWeight: SpWeightsWeightV2Weight & AugmentedConst<ApiType>;
       /**
        * The maximum number of scheduled calls in the queue for a single block.
-       * Not strictly enforced, but used for weight estimation.
+       * 
+       * NOTE:
+       * + Dependent pallets' benchmarks might require a higher limit for the setting. Set a
+       * higher limit under `runtime-benchmarks` feature.
        **/
       maxScheduledPerBlock: u32 & AugmentedConst<ApiType>;
       /**
@@ -676,27 +773,31 @@ declare module '@polkadot/api-base/types/consts' {
       [key: string]: Codec;
     };
     society: {
-      /**
-       * The minimum amount of a deposit required for a bid to be made.
-       **/
-      candidateDeposit: u128 & AugmentedConst<ApiType>;
       /**
        * The number of blocks between membership challenges.
        **/
       challengePeriod: u32 & AugmentedConst<ApiType>;
       /**
-       * The maximum number of candidates that we accept per round.
+       * The number of blocks on which new candidates can claim their membership and be the
+       * named head.
        **/
-      maxCandidateIntake: u32 & AugmentedConst<ApiType>;
+      claimPeriod: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of strikes before a member gets funds slashed.
+       **/
+      graceStrikes: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of bids at once.
+       **/
+      maxBids: u32 & AugmentedConst<ApiType>;
       /**
        * The maximum duration of the payout lock.
        **/
       maxLockDuration: u32 & AugmentedConst<ApiType>;
       /**
-       * The number of times a member may vote the wrong way (or not at all, when they are a
-       * skeptic) before they become suspended.
+       * The maximum number of payouts a member may have waiting unclaimed.
        **/
-      maxStrikes: u32 & AugmentedConst<ApiType>;
+      maxPayouts: u32 & AugmentedConst<ApiType>;
       /**
        * The societies's pallet id
        **/
@@ -706,14 +807,10 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       periodSpend: u128 & AugmentedConst<ApiType>;
       /**
-       * The number of blocks between candidate/membership rotation periods.
+       * The number of blocks on which new candidates should be voted on. Together with
+       * `ClaimPeriod`, this sums to the number of blocks between candidate intake periods.
        **/
-      rotationPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * The amount of the unpaid reward that gets deducted in the case that either a skeptic
-       * doesn't vote or someone votes in the wrong way.
-       **/
-      wrongSideDeduction: u128 & AugmentedConst<ApiType>;
+      votingPeriod: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -725,19 +822,53 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       bondingDuration: u32 & AugmentedConst<ApiType>;
       /**
-       * Maximum number of nominations per nominator.
-       **/
-      maxNominations: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of nominators rewarded for each validator.
+       * Number of eras to keep in history.
        * 
-       * For each validator only the `$MaxNominatorRewardedPerValidator` biggest stakers can
-       * claim their reward. This used to limit the i/o cost for the nominator payout.
+       * Following information is kept for eras in `[current_era -
+       * HistoryDepth, current_era]`: `ErasStakers`, `ErasStakersClipped`,
+       * `ErasValidatorPrefs`, `ErasValidatorReward`, `ErasRewardPoints`,
+       * `ErasTotalStake`, `ErasStartSessionIndex`, `ClaimedRewards`, `ErasStakersPaged`,
+       * `ErasStakersOverview`.
+       * 
+       * Must be more than the number of eras delayed by session.
+       * I.e. active era must always be in history. I.e. `active_era >
+       * current_era - history_depth` must be guaranteed.
+       * 
+       * If migrating an existing pallet from storage value to config value,
+       * this should be set to same value or greater as in storage.
+       * 
+       * Note: `HistoryDepth` is used as the upper bound for the `BoundedVec`
+       * item `StakingLedger.legacy_claimed_rewards`. Setting this value lower than
+       * the existing value can lead to inconsistencies in the
+       * `StakingLedger` and will need to be handled properly in a migration.
+       * The test `reducing_history_depth_abrupt` shows this effect.
        **/
-      maxNominatorRewardedPerValidator: u32 & AugmentedConst<ApiType>;
+      historyDepth: u32 & AugmentedConst<ApiType>;
       /**
-       * The maximum number of `unlocking` chunks a [`StakingLedger`] can have. Effectively
-       * determines how many unique eras a staker may be unbonding in.
+       * The maximum size of each `T::ExposurePage`.
+       * 
+       * An `ExposurePage` is weakly bounded to a maximum of `MaxExposurePageSize`
+       * nominators.
+       * 
+       * For older non-paged exposure, a reward payout was restricted to the top
+       * `MaxExposurePageSize` nominators. This is to limit the i/o cost for the
+       * nominator payout.
+       * 
+       * Note: `MaxExposurePageSize` is used to bound `ClaimedRewards` and is unsafe to reduce
+       * without handling it in a migration.
+       **/
+      maxExposurePageSize: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of `unlocking` chunks a [`StakingLedger`] can
+       * have. Effectively determines how many unique eras a staker may be
+       * unbonding in.
+       * 
+       * Note: `MaxUnlockingChunks` is used as the upper bound for the
+       * `BoundedVec` item `StakingLedger.unlocking`. Setting this value
+       * lower than the existing value can lead to inconsistencies in the
+       * `StakingLedger` and will need to be handled properly in a runtime
+       * migration. The test `reducing_max_unlocking_chunks_abrupt` shows
+       * this effect.
        **/
       maxUnlockingChunks: u32 & AugmentedConst<ApiType>;
       /**
@@ -756,6 +887,36 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    stateTrieMigration: {
+      /**
+       * Maximal number of bytes that a key can have.
+       * 
+       * FRAME itself does not limit the key length.
+       * The concrete value must therefore depend on your storage usage.
+       * A [`frame_support::storage::StorageNMap`] for example can have an arbitrary number of
+       * keys which are then hashed and concatenated, resulting in arbitrarily long keys.
+       * 
+       * Use the *state migration RPC* to retrieve the length of the longest key in your
+       * storage: <https://github.com/paritytech/substrate/issues/11642>
+       * 
+       * The migration will halt with a `Halted` event if this value is too small.
+       * Since there is no real penalty from over-estimating, it is advised to use a large
+       * value. The default is 512 byte.
+       * 
+       * Some key lengths for reference:
+       * - [`frame_support::storage::StorageValue`]: 32 byte
+       * - [`frame_support::storage::StorageMap`]: 64 byte
+       * - [`frame_support::storage::StorageDoubleMap`]: 96 byte
+       * 
+       * For more info see
+       * <https://www.shawntabrizi.com/blog/substrate/querying-substrate-storage-via-rpc/>
+       **/
+      maxKeyLen: u32 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     system: {
       /**
        * Maximum number of block number to block hash mappings to keep (oldest pruned first).
@@ -772,9 +933,9 @@ declare module '@polkadot/api-base/types/consts' {
       /**
        * The weight of runtime database operations the runtime can invoke.
        **/
-      dbWeight: FrameSupportWeightsRuntimeDbWeight & AugmentedConst<ApiType>;
+      dbWeight: SpWeightsRuntimeDbWeight & AugmentedConst<ApiType>;
       /**
-       * The designated SS85 prefix of this chain.
+       * The designated SS58 prefix of this chain.
        * 
        * This replaces the "ss58Format" property declared in the chain spec. Reason is
        * that the runtime should know about the prefix in order to make use of it as
@@ -792,10 +953,12 @@ declare module '@polkadot/api-base/types/consts' {
     };
     timestamp: {
       /**
-       * The minimum period between blocks. Beware that this is different to the *expected*
-       * period that the block production apparatus provides. Your chosen consensus system will
-       * generally work with this to determine a sensible block time. e.g. For Aura, it will be
-       * double this period on default settings.
+       * The minimum period between blocks.
+       * 
+       * Be aware that this is different to the *expected* period that the block production
+       * apparatus provides. Your chosen consensus system will generally work with this to
+       * determine a sensible block time. For example, in the Aura pallet it will be double this
+       * period on default settings.
        **/
       minimumPeriod: u64 & AugmentedConst<ApiType>;
       /**
@@ -803,40 +966,12 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    tips: {
-      /**
-       * The amount held on deposit per byte within the tip report reason or bounty description.
-       **/
-      dataDepositPerByte: u128 & AugmentedConst<ApiType>;
-      /**
-       * Maximum acceptable reason length.
-       * 
-       * Benchmarks depend on this value, be sure to update weights file when changing this value
-       **/
-      maximumReasonLength: u32 & AugmentedConst<ApiType>;
-      /**
-       * The period for which a tip remains open after is has achieved threshold tippers.
-       **/
-      tipCountdown: u32 & AugmentedConst<ApiType>;
-      /**
-       * The percent of the final tip which goes to the original reporter of the tip.
-       **/
-      tipFindersFee: Percent & AugmentedConst<ApiType>;
-      /**
-       * The amount held on deposit for placing a tip report.
-       **/
-      tipReportDepositBase: u128 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
     transactionPayment: {
       /**
-       * A fee mulitplier for `Operational` extrinsics to compute "virtual tip" to boost their
+       * A fee multiplier for `Operational` extrinsics to compute "virtual tip" to boost their
        * `priority`
        * 
-       * This value is multipled by the `final_fee` to obtain a "virtual tip" that is later
+       * This value is multiplied by the `final_fee` to obtain a "virtual tip" that is later
        * added to a tip component in regular `priority` calculations.
        * It means that a `Normal` transaction can front-run a similarly-sized `Operational`
        * extrinsic (with no tip), by including a tip value greater than the virtual tip.
@@ -876,6 +1011,10 @@ declare module '@polkadot/api-base/types/consts' {
        * The treasury's pallet id, used for deriving its sovereign account ID.
        **/
       palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
+      /**
+       * The period during which an approved treasury spend has to be claimed.
+       **/
+      payoutPeriod: u32 & AugmentedConst<ApiType>;
       /**
        * Fraction of a proposal's value that should be bonded in order to place the proposal.
        * An accepted proposal gets these back. A rejected proposal does not.

packages/api-augment/src/kusama/events.spec.ts

@@ -1,43 +0,0 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-import '@polkadot/api-augment/kusama';
-
-import type { PolkadotRuntimeParachainsUmpPalletEvent, XcmV2TraitsOutcome } from '@polkadot/types/lookup';
-
-import { Metadata, TypeRegistry } from '@polkadot/types';
-import metadataStatic from '@polkadot/types-support/metadata/static-kusama';
-
-const registry = new TypeRegistry();
-const metadata = new Metadata(registry, metadataStatic);
-
-registry.setMetadata(metadata);
-
-describe('correct types', (): void => {
-  it('correctly creates XcmV2TraitsOutcome', (): void => {
-    const test = registry.createType<XcmV2TraitsOutcome>('XcmV2TraitsOutcome', {
-      Incomplete: [3_000_000_000, 'BadOrigin']
-    });
-
-    expect(test.toHuman()).toEqual({
-      Incomplete: [
-        '3,000,000,000',
-        'BadOrigin'
-      ]
-    });
-    expect(test.isIncomplete).toEqual(true);
-    expect(test.asIncomplete.toHuman()).toEqual([
-      '3,000,000,000',
-      'BadOrigin'
-    ]);
-  });
-
-  it('correctly creates PolkadotRuntimeParachainsUmpPalletEvent', (): void => {
-    const test = registry.createType<PolkadotRuntimeParachainsUmpPalletEvent>('PolkadotRuntimeParachainsUmpPalletEvent', '0x02112233445566778811223344556677881122334455667788112233445566778801005ed0b20000000006');
-
-    expect(test.asExecutedUpward[1].asIncomplete.toHuman()).toEqual([
-      '3,000,000,000',
-      'BadOrigin'
-    ]);
-  });
-});

packages/api-augment/src/kusama/index.ts

@@ -1,11 +1,11 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import '../base';
-import './consts';
-import './errors';
-import './events';
-import './query';
-import './registry';
-import './runtime';
-import './tx';
+import '../base.js';
+import './consts.js';
+import './errors.js';
+import './events.js';
+import './query.js';
+import './registry.js';
+import './runtime.js';
+import './tx.js';

packages/api-augment/src/kusama/registry.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import '@polkadot/types-augment/registry/substrate';

packages/api-augment/src/kusama/runtime.ts

@@ -6,22 +6,24 @@
 import '@polkadot/api-base/types/calls';
 
 import type { ApiTypes, AugmentedCall, DecoratedCallBase } from '@polkadot/api-base/types';
-import type { Bytes, Null, Option, Result, Vec, bool, u32 } from '@polkadot/types-codec';
+import type { Bytes, Null, Option, Result, U64, Vec, bool, u32 } from '@polkadot/types-codec';
 import type { AnyNumber, IMethod, ITuple } from '@polkadot/types-codec/types';
 import type { BabeEquivocationProof, BabeGenesisConfiguration, Epoch, OpaqueKeyOwnershipProof } from '@polkadot/types/interfaces/babe';
-import type { ValidatorSet } from '@polkadot/types/interfaces/beefy';
+import type { BeefyAuthoritySet, BeefyEquivocationProof, BeefyNextAuthoritySet, ValidatorSet, ValidatorSetId } from '@polkadot/types/interfaces/beefy';
 import type { CheckInherentsResult, InherentData } from '@polkadot/types/interfaces/blockbuilder';
 import type { BlockHash } from '@polkadot/types/interfaces/chain';
 import type { AuthorityId } from '@polkadot/types/interfaces/consensus';
 import type { Extrinsic } from '@polkadot/types/interfaces/extrinsics';
+import type { GenesisBuildErr } from '@polkadot/types/interfaces/genesisBuilder';
 import type { AuthorityList, GrandpaEquivocationProof, SetId } from '@polkadot/types/interfaces/grandpa';
 import type { OpaqueMetadata } from '@polkadot/types/interfaces/metadata';
-import type { MmrBatchProof, MmrEncodableOpaqueLeaf, MmrError, MmrLeafIndex, MmrProof } from '@polkadot/types/interfaces/mmr';
-import type { NpApiError } from '@polkadot/types/interfaces/nompools';
-import type { CandidateCommitments, CandidateEvent, CommittedCandidateReceipt, CoreState, GroupRotationInfo, InboundDownwardMessage, InboundHrmpMessage, OccupiedCoreAssumption, ParaId, ParaValidatorIndex, PersistedValidationData, PvfCheckStatement, ScrapedOnChainVotes, SessionInfo, ValidationCode, ValidationCodeHash, ValidatorSignature } from '@polkadot/types/interfaces/parachains';
+import type { MmrBatchProof, MmrEncodableOpaqueLeaf, MmrError } from '@polkadot/types/interfaces/mmr';
+import type { NpPoolId } from '@polkadot/types/interfaces/nompools';
+import type { ApprovalVotingParams, AsyncBackingParams, BackingState, CandidateCommitments, CandidateEvent, CandidateHash, CommittedCandidateReceipt, CoreState, DisputeProof, DisputeState, ExecutorParams, GroupRotationInfo, InboundDownwardMessage, InboundHrmpMessage, NodeFeatures, OccupiedCoreAssumption, ParaId, ParaValidatorIndex, PendingSlashes, PersistedValidationData, PvfCheckStatement, ScrapedOnChainVotes, SessionInfo, ValidationCode, ValidationCodeHash, ValidatorSignature } from '@polkadot/types/interfaces/parachains';
 import type { FeeDetails, RuntimeDispatchInfo } from '@polkadot/types/interfaces/payment';
-import type { AccountId, Balance, Block, Call, Hash, Header, Index, KeyTypeId, Slot, ValidatorId } from '@polkadot/types/interfaces/runtime';
+import type { AccountId, Balance, Block, BlockNumber, Call, Hash, Header, Index, KeyTypeId, Slot, ValidatorId, Weight } from '@polkadot/types/interfaces/runtime';
 import type { SessionIndex } from '@polkadot/types/interfaces/session';
+import type { ValidatorIndex } from '@polkadot/types/interfaces/staking';
 import type { RuntimeVersion } from '@polkadot/types/interfaces/state';
 import type { ApplyExtrinsicResult } from '@polkadot/types/interfaces/system';
 import type { TransactionSource, TransactionValidity } from '@polkadot/types/interfaces/txqueue';
@@ -85,8 +87,20 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x49eaaf1b548a0cb0/1 */
+    /** 0x49eaaf1b548a0cb0/3 */
     beefyApi: {
+      /**
+       * Return the block number where BEEFY consensus is enabled/started
+       **/
+      beefyGenesis: AugmentedCall<ApiType, () => Observable<Option<BlockNumber>>>;
+      /**
+       * Generates a proof of key ownership for the given authority in the given set.
+       **/
+      generateKeyOwnershipProof: AugmentedCall<ApiType, (setId: ValidatorSetId | AnyNumber | Uint8Array, authorityId: AuthorityId | string | Uint8Array) => Observable<Option<OpaqueKeyOwnershipProof>>>;
+      /**
+       * Submits an unsigned extrinsic to report an equivocation.
+       **/
+      submitReportEquivocationUnsignedExtrinsic: AugmentedCall<ApiType, (equivocationProof: BeefyEquivocationProof | { first?: any; second?: any } | string | Uint8Array, keyOwnerProof: OpaqueKeyOwnershipProof | string | Uint8Array) => Observable<Option<Null>>>;
       /**
        * Return the current active BEEFY validator set
        **/
@@ -96,6 +110,21 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0x2a5e924655399e60/1 */
+    beefyMmrApi: {
+      /**
+       * Return the currently active BEEFY authority set proof.
+       **/
+      authoritySetProof: AugmentedCall<ApiType, () => Observable<BeefyAuthoritySet>>;
+      /**
+       * Return the next/queued BEEFY authority set proof.
+       **/
+      nextAuthoritySetProof: AugmentedCall<ApiType, () => Observable<BeefyNextAuthoritySet>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0x40fe3ad401f8959a/6 */
     blockBuilder: {
       /**
@@ -138,6 +167,21 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0xfbc577b9d747efd6/1 */
+    genesisBuilder: {
+      /**
+       * Build `RuntimeGenesisConfig` from a JSON blob not using any defaults and store it in the storage.
+       **/
+      buildConfig: AugmentedCall<ApiType, (json: Bytes | string | Uint8Array) => Observable<Result<ITuple<[]>, GenesisBuildErr>>>;
+      /**
+       * Creates the default `RuntimeGenesisConfig` and returns it as a JSON blob.
+       **/
+      createDefaultConfig: AugmentedCall<ApiType, () => Observable<Bytes>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0xed99c5acb25eedf5/3 */
     grandpaApi: {
       /**
@@ -161,47 +205,47 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x37e397fc7c91f5e4/1 */
+    /** 0x37e397fc7c91f5e4/2 */
     metadata: {
       /**
        * Returns the metadata of a runtime
        **/
       metadata: AugmentedCall<ApiType, () => Observable<OpaqueMetadata>>;
+      /**
+       * Returns the metadata at a given version.
+       **/
+      metadataAtVersion: AugmentedCall<ApiType, (version: u32 | AnyNumber | Uint8Array) => Observable<Option<OpaqueMetadata>>>;
+      /**
+       * Returns the supported metadata versions.
+       **/
+      metadataVersions: AugmentedCall<ApiType, () => Observable<Vec<u32>>>;
       /**
        * Generic call
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x91d5df18b0d2cf58/1 */
+    /** 0x91d5df18b0d2cf58/2 */
     mmrApi: {
       /**
-       * Generate MMR proof for a series of leaves under given indices.
+       * Generate MMR proof for the given block numbers.
        **/
-      generateBatchProof: AugmentedCall<ApiType, (leafIndices: Vec<MmrLeafIndex> | (MmrLeafIndex | AnyNumber | Uint8Array)[]) => Observable<Result<ITuple<[Vec<MmrEncodableOpaqueLeaf>, MmrBatchProof]>, MmrError>>>;
+      generateProof: AugmentedCall<ApiType, (blockNumbers: Vec<BlockNumber> | (BlockNumber | AnyNumber | Uint8Array)[], bestKnownBlockNumber: Option<BlockNumber> | null | Uint8Array | BlockNumber | AnyNumber) => Observable<Result<ITuple<[Vec<MmrEncodableOpaqueLeaf>, MmrBatchProof]>, MmrError>>>;
       /**
-       * Generate MMR proof for a leaf under given index.
+       * Return the number of MMR blocks in the chain.
        **/
-      generateProof: AugmentedCall<ApiType, (leafIndex: MmrLeafIndex | AnyNumber | Uint8Array) => Observable<Result<ITuple<[MmrEncodableOpaqueLeaf, MmrProof]>, MmrError>>>;
+      mmrLeafCount: AugmentedCall<ApiType, () => Observable<Result<U64, MmrError>>>;
       /**
        * Return the on-chain MMR root hash.
        **/
       mmrRoot: AugmentedCall<ApiType, () => Observable<Result<Hash, MmrError>>>;
-      /**
-       * Verify MMR proof against on-chain MMR for a batch of leaves.
-       **/
-      verifyBatchProof: AugmentedCall<ApiType, (leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
-      /**
-       * Verify MMR proof against given root hash or a batch of leaves.
-       **/
-      verifyBatchProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
       /**
        * Verify MMR proof against on-chain MMR.
        **/
-      verifyProof: AugmentedCall<ApiType, (leaf: MmrEncodableOpaqueLeaf | string | Uint8Array, proof: MmrProof | { leafIndex?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      verifyProof: AugmentedCall<ApiType, (leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
       /**
        * Verify MMR proof against given root hash.
        **/
-      verifyProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaf: MmrEncodableOpaqueLeaf | string | Uint8Array, proof: MmrProof | { leafIndex?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      verifyProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
       /**
        * Generic call
        **/
@@ -209,10 +253,18 @@ declare module '@polkadot/api-base/types/calls' {
     };
     /** 0x17a6bc0d0062aeb3/1 */
     nominationPoolsApi: {
+      /**
+       * Returns the equivalent points of `new_funds` for a given pool.
+       **/
+      balanceToPoints: AugmentedCall<ApiType, (poolId: NpPoolId | AnyNumber | Uint8Array, newFunds: Balance | AnyNumber | Uint8Array) => Observable<Balance>>;
       /**
        * Returns the pending rewards for the given member.
        **/
-      pendingRewards: AugmentedCall<ApiType, (member: AccountId | string | Uint8Array) => Observable<Result<Balance, NpApiError>>>;
+      pendingRewards: AugmentedCall<ApiType, (member: AccountId | string | Uint8Array) => Observable<Balance>>;
+      /**
+       * Returns the equivalent balance of `points` for a given pool.
+       **/
+      pointsToBalance: AugmentedCall<ApiType, (poolId: NpPoolId | AnyNumber | Uint8Array, points: Balance | AnyNumber | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/
@@ -229,12 +281,20 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0xaf2c0297a23e6d3d/2 */
+    /** 0xaf2c0297a23e6d3d/10 */
     parachainHost: {
+      /**
+       * Approval voting configuration parameters
+       **/
+      approvalVotingParams: AugmentedCall<ApiType, () => Observable<ApprovalVotingParams>>;
       /**
        * Returns the persisted validation data for the given `ParaId` along with the corresponding validation code hash.
        **/
       assumedValidationData: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array, hash: Hash | string | Uint8Array) => Observable<Option<ITuple<[PersistedValidationData, ValidationCodeHash]>>>>;
+      /**
+       * Returns candidate's acceptance limitations for asynchronous backing for a relay parent
+       **/
+      asyncBackingParams: AugmentedCall<ApiType, () => Observable<AsyncBackingParams>>;
       /**
        * Yields information on all availability cores as relevant to the child block.
        **/
@@ -251,6 +311,14 @@ declare module '@polkadot/api-base/types/calls' {
        * Checks if the given validation outputs pass the acceptance criteria.
        **/
       checkValidationOutputs: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array, outputs: CandidateCommitments | { upwardMessages?: any; horizontalMessages?: any; newValidationCode?: any; headData?: any; processedDownwardMessages?: any; hrmpWatermark?: any } | string | Uint8Array) => Observable<bool>>;
+      /**
+       * Returns a list of all disabled validators at the given block
+       **/
+      disabledValidators: AugmentedCall<ApiType, () => Observable<ValidatorIndex>>;
+      /**
+       * Returns all onchain disputes.
+       **/
+      disputes: AugmentedCall<ApiType, () => Observable<Vec<ITuple<[SessionIndex, CandidateHash, DisputeState]>>>>;
       /**
        * Get all the pending inbound messages in the downward message queue for a para.
        **/
@@ -259,10 +327,26 @@ declare module '@polkadot/api-base/types/calls' {
        * Get the contents of all channels addressed to the given recipient.
        **/
       inboundHrmpChannelsContents: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array) => Observable<Vec<InboundHrmpMessage>>>;
+      /**
+       * Returns a merkle proof of a validator session key
+       **/
+      keyOwnershipProof: AugmentedCall<ApiType, (validatorId: ValidatorId | string | Uint8Array) => Observable<Option<OpaqueKeyOwnershipProof>>>;
+      /**
+       * Get the minimum number of backing votes for a parachain candidate. This is a staging method! Do not use on production runtimes!
+       **/
+      minimumBackingVotes: AugmentedCall<ApiType, () => Observable<u32>>;
+      /**
+       * Get node features. This is a staging method! Do not use on production runtimes!
+       **/
+      nodeFeatures: AugmentedCall<ApiType, () => Observable<NodeFeatures>>;
       /**
        * Scrape dispute relevant from on-chain, backing votes and resolved disputes.
        **/
       onChainVotes: AugmentedCall<ApiType, () => Observable<Option<ScrapedOnChainVotes>>>;
+      /**
+       * Returns the state of parachain backing for a given para
+       **/
+      paraBackingState: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array) => Observable<Option<BackingState>>>;
       /**
        * Yields the persisted validation data for the given `ParaId` along with an assumption that should be used if the para currently occupies a core.
        **/
@@ -271,6 +355,10 @@ declare module '@polkadot/api-base/types/calls' {
        * Returns code hashes of PVFs that require pre-checking by validators in the active set.
        **/
       pvfsRequirePrecheck: AugmentedCall<ApiType, () => Observable<Vec<ValidationCodeHash>>>;
+      /**
+       * Returns execution parameters for the session.
+       **/
+      sessionExecutorParams: AugmentedCall<ApiType, (sessionIndex: SessionIndex | AnyNumber | Uint8Array) => Observable<Option<ExecutorParams>>>;
       /**
        * Returns the session index expected at a child of the block.
        **/
@@ -283,10 +371,18 @@ declare module '@polkadot/api-base/types/calls' {
        * Submits a PVF pre-checking statement into the transaction pool.
        **/
       submitPvfCheckStatement: AugmentedCall<ApiType, (stmt: PvfCheckStatement | { accept?: any; subject?: any; sessionIndex?: any; validatorIndex?: any } | string | Uint8Array, signature: ValidatorSignature | string | Uint8Array) => Observable<Null>>;
+      /**
+       * Submit an unsigned extrinsic to slash validators who lost a dispute about a candidate of a past session
+       **/
+      submitReportDisputeLost: AugmentedCall<ApiType, (disputeProof: DisputeProof | { timeSlot?: any; kind?: any; validatorIndex?: any; validatorId?: any } | string | Uint8Array, keyOwnershipProof: OpaqueKeyOwnershipProof | string | Uint8Array) => Observable<Option<Null>>>;
+      /**
+       * Returns a list of validators that lost a past session dispute and need to be slashed
+       **/
+      unappliedSlashes: AugmentedCall<ApiType, () => Observable<Vec<ITuple<[SessionIndex, CandidateHash, PendingSlashes]>>>>;
       /**
        * Fetch the validation code used by a para, making the given `OccupiedCoreAssumption`.
        **/
-      validationCode: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array, assumption: OccupiedCoreAssumption | 'Included,' | 'TimedOut' | 'Free' | number | Uint8Array) => Observable<ValidationCode>>;
+      validationCode: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array, assumption: OccupiedCoreAssumption | 'Included,' | 'TimedOut' | 'Free' | number | Uint8Array) => Observable<Option<ValidationCode>>>;
       /**
        * Get the validation code from its hash.
        **/
@@ -323,6 +419,17 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0x18ef58a3b67ba770/1 */
+    stakingApi: {
+      /**
+       * Returns the nominations quota for a nominator with a given balance.
+       **/
+      nominationsQuota: AugmentedCall<ApiType, (balance: Balance | AnyNumber | Uint8Array) => Observable<u32>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0xd2bc9897eed08f15/3 */
     taggedTransactionQueue: {
       /**
@@ -334,7 +441,7 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x37c8bb1350a9a2a8/1 */
+    /** 0x37c8bb1350a9a2a8/4 */
     transactionPaymentApi: {
       /**
        * The transaction fee details
@@ -344,12 +451,20 @@ declare module '@polkadot/api-base/types/calls' {
        * The transaction info
        **/
       queryInfo: AugmentedCall<ApiType, (uxt: Extrinsic | IExtrinsic | string | Uint8Array, len: u32 | AnyNumber | Uint8Array) => Observable<RuntimeDispatchInfo>>;
+      /**
+       * Query the output of the current LengthToFee given some input
+       **/
+      queryLengthToFee: AugmentedCall<ApiType, (length: u32 | AnyNumber | Uint8Array) => Observable<Balance>>;
+      /**
+       * Query the output of the current WeightToFee given some input
+       **/
+      queryWeightToFee: AugmentedCall<ApiType, (weight: Weight | { refTime?: any; proofSize?: any } | string | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0xf3ff14d5ab527059/1 */
+    /** 0xf3ff14d5ab527059/3 */
     transactionPaymentCallApi: {
       /**
        * The call fee details
@@ -359,6 +474,14 @@ declare module '@polkadot/api-base/types/calls' {
        * The call info
        **/
       queryCallInfo: AugmentedCall<ApiType, (call: Call | IMethod | string | Uint8Array, len: u32 | AnyNumber | Uint8Array) => Observable<RuntimeDispatchInfo>>;
+      /**
+       * Query the output of the current LengthToFee given some input
+       **/
+      queryLengthToFee: AugmentedCall<ApiType, (length: u32 | AnyNumber | Uint8Array) => Observable<Balance>>;
+      /**
+       * Query the output of the current WeightToFee given some input
+       **/
+      queryWeightToFee: AugmentedCall<ApiType, (weight: Weight | { refTime?: any; proofSize?: any } | string | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/

packages/api-augment/src/mod.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-export * from './index';
+export * from './index.js';

packages/api-augment/src/packageDetect.ts

@@ -0,0 +1,14 @@
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// Do not edit, auto-generated by @polkadot/dev
+// (packageInfo imports will be kept as-is, user-editable)
+
+import { packageInfo as baseInfo } from '@polkadot/api-base/packageInfo';
+import { packageInfo as typesInfo } from '@polkadot/types/packageInfo';
+import { packageInfo as codecInfo } from '@polkadot/types-codec/packageInfo';
+import { detectPackage } from '@polkadot/util';
+
+import { packageInfo } from './packageInfo.js';
+
+detectPackage(packageInfo, null, [baseInfo, codecInfo, typesInfo]);

packages/api-augment/src/packageInfo.ts

@@ -1,6 +1,6 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 // Do not edit, auto-generated by @polkadot/dev
 
-export const packageInfo = { name: '@polkadot/api-augment', path: 'auto', type: 'auto', version: '9.2.3' };
+export const packageInfo = { name: '@polkadot/api-augment', path: 'auto', type: 'auto', version: '11.3.1' };

packages/api-augment/src/polkadot/consts.ts

@@ -6,10 +6,10 @@
 import '@polkadot/api-base/types/consts';
 
 import type { ApiTypes, AugmentedConst } from '@polkadot/api-base/types';
-import type { Bytes, Option, U8aFixed, Vec, bool, u128, u16, u32, u64, u8 } from '@polkadot/types-codec';
-import type { Codec } from '@polkadot/types-codec/types';
-import type { Perbill, Percent, Permill } from '@polkadot/types/interfaces/runtime';
-import type { FrameSupportPalletId, FrameSupportWeightsRuntimeDbWeight, FrameSystemLimitsBlockLength, FrameSystemLimitsBlockWeights, SpVersionRuntimeVersion } from '@polkadot/types/lookup';
+import type { Bytes, Option, Vec, u128, u16, u32, u64, u8 } from '@polkadot/types-codec';
+import type { Codec, ITuple } from '@polkadot/types-codec/types';
+import type { Perbill, Permill } from '@polkadot/types/interfaces/runtime';
+import type { FrameSupportPalletId, FrameSystemLimitsBlockLength, FrameSystemLimitsBlockWeights, PalletReferendaTrackInfo, SpVersionRuntimeVersion, SpWeightsRuntimeDbWeight, SpWeightsWeightV2Weight } from '@polkadot/types/lookup';
 
 export type __AugmentedConst<ApiType extends ApiTypes> = AugmentedConst<ApiType>;
 
@@ -33,18 +33,6 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    authorship: {
-      /**
-       * The number of blocks back we should accept uncles.
-       * This means that we will deal with uncle-parents that are
-       * `UncleGenerations + 1` before `now`.
-       **/
-      uncleGenerations: u32 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
     babe: {
       /**
        * The amount of time, in slots, that each epoch should last.
@@ -64,6 +52,10 @@ declare module '@polkadot/api-base/types/consts' {
        * Max number of authorities allowed
        **/
       maxAuthorities: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of nominators for each validator.
+       **/
+      maxNominators: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -71,9 +63,20 @@ declare module '@polkadot/api-base/types/consts' {
     };
     balances: {
       /**
-       * The minimum amount required to keep an account open.
+       * The minimum amount required to keep an account open. MUST BE GREATER THAN ZERO!
+       * 
+       * If you *really* need it to be zero, you can enable the feature `insecure_zero_ed` for
+       * this pallet. However, you do so at your own risk: this will open up a major DoS vector.
+       * In case you have multiple sources of provider references, you may also get unexpected
+       * behaviour if you set this to zero.
+       * 
+       * Bottom line: Do yourself a favour and make it at least one!
        **/
       existentialDeposit: u128 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of individual freeze locks that can exist on an account at any time.
+       **/
+      maxFreezes: u32 & AugmentedConst<ApiType>;
       /**
        * The maximum number of locks that should exist on an account.
        * Not strictly enforced, but used for weight estimation.
@@ -88,6 +91,29 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    beefy: {
+      /**
+       * The maximum number of authorities that can be added.
+       **/
+      maxAuthorities: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of nominators for each validator.
+       **/
+      maxNominators: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of entries to keep in the set id to session index mapping.
+       * 
+       * Since the `SetIdSession` map is only used for validating equivocations this
+       * value should relate to the bonding duration of whatever staking system is
+       * being used (if any). If equivocation handling is not enabled then this value
+       * can be zero.
+       **/
+      maxSetIdSessionEntries: u64 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     bounties: {
       /**
        * The amount held on deposit for placing a bounty proposal.
@@ -156,71 +182,14 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    crowdloan: {
+    convictionVoting: {
       /**
-       * The minimum amount that may be contributed into a crowdloan. Should almost certainly be at
-       * least `ExistentialDeposit`.
-       **/
-      minContribution: u128 & AugmentedConst<ApiType>;
-      /**
-       * `PalletId` for the crowdloan pallet. An appropriate value could be `PalletId(*b"py/cfund")`
-       **/
-      palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
-      /**
-       * Max number of storage keys to remove per extrinsic call.
-       **/
-      removeKeysLimit: u32 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
-    democracy: {
-      /**
-       * Period in blocks where an external proposal may not be re-submitted after being vetoed.
-       **/
-      cooloffPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * The period between a proposal being approved and enacted.
+       * The maximum number of concurrent votes an account may have.
        * 
-       * It should generally be a little more than the unstake period to ensure that
-       * voting stakers have an opportunity to remove themselves from the system in the case
-       * where they are on the losing side of a vote.
-       **/
-      enactmentPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * Minimum voting period allowed for a fast-track referendum.
-       **/
-      fastTrackVotingPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * Indicator for whether an emergency origin is even allowed to happen. Some chains may
-       * want to set this permanently to `false`, others may want to condition it on things such
-       * as an upgrade having happened recently.
-       **/
-      instantAllowed: bool & AugmentedConst<ApiType>;
-      /**
-       * How often (in blocks) new public referenda are launched.
-       **/
-      launchPeriod: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of public proposals that can exist at any time.
-       **/
-      maxProposals: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of votes for an account.
-       * 
-       * Also used to compute weight, an overly big value can
-       * lead to extrinsic with very big weight: see `delegate` for instance.
+       * Also used to compute weight, an overly large value can lead to extrinsics with large
+       * weight estimation: see `delegate` for instance.
        **/
       maxVotes: u32 & AugmentedConst<ApiType>;
-      /**
-       * The minimum amount to be used as a deposit for a public referendum proposal.
-       **/
-      minimumDeposit: u128 & AugmentedConst<ApiType>;
-      /**
-       * The amount of balance that must be deposited per byte of preimage stored.
-       **/
-      preimageByteDeposit: u128 & AugmentedConst<ApiType>;
       /**
        * The minimum period of vote locking.
        * 
@@ -229,9 +198,25 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       voteLockingPeriod: u32 & AugmentedConst<ApiType>;
       /**
-       * How often (in blocks) to check for new votes.
+       * Generic const
        **/
-      votingPeriod: u32 & AugmentedConst<ApiType>;
+      [key: string]: Codec;
+    };
+    crowdloan: {
+      /**
+       * The minimum amount that may be contributed into a crowdloan. Should almost certainly be
+       * at least `ExistentialDeposit`.
+       **/
+      minContribution: u128 & AugmentedConst<ApiType>;
+      /**
+       * `PalletId` for the crowdloan pallet. An appropriate value could be
+       * `PalletId(*b"py/cfund")`
+       **/
+      palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
+      /**
+       * Max number of storage keys to remove per extrinsic call.
+       **/
+      removeKeysLimit: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -244,20 +229,16 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       betterSignedThreshold: Perbill & AugmentedConst<ApiType>;
       /**
-       * The minimum amount of improvement to the solution score that defines a solution as
-       * "better" in the Unsigned phase.
+       * The maximum number of winners that can be elected by this `ElectionProvider`
+       * implementation.
+       * 
+       * Note: This must always be greater or equal to `T::DataProvider::desired_targets()`.
        **/
-      betterUnsignedThreshold: Perbill & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of electable targets to put in the snapshot.
-       **/
-      maxElectableTargets: u16 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of electing voters to put in the snapshot. At the moment, snapshots
-       * are only over a single block, but once multi-block elections are introduced they will
-       * take place over multiple blocks.
-       **/
-      maxElectingVoters: u32 & AugmentedConst<ApiType>;
+      maxWinners: u32 & AugmentedConst<ApiType>;
+      minerMaxLength: u32 & AugmentedConst<ApiType>;
+      minerMaxVotesPerVoter: u32 & AugmentedConst<ApiType>;
+      minerMaxWeight: SpWeightsWeightV2Weight & AugmentedConst<ApiType>;
+      minerMaxWinners: u32 & AugmentedConst<ApiType>;
       /**
        * The priority of the unsigned transaction submitted in the unsigned-phase
        **/
@@ -269,10 +250,6 @@ declare module '@polkadot/api-base/types/consts' {
        * to submit the worker's solution.
        **/
       offchainRepeat: u32 & AugmentedConst<ApiType>;
-      /**
-       * Base deposit for a signed solution.
-       **/
-      signedDepositBase: u128 & AugmentedConst<ApiType>;
       /**
        * Per-byte deposit for a signed solution.
        **/
@@ -302,7 +279,7 @@ declare module '@polkadot/api-base/types/consts' {
        * this pallet), then [`MinerConfig::solution_weight`] is used to compare against
        * this value.
        **/
-      signedMaxWeight: u64 & AugmentedConst<ApiType>;
+      signedMaxWeight: SpWeightsWeightV2Weight & AugmentedConst<ApiType>;
       /**
        * Duration of the signed phase.
        **/
@@ -320,11 +297,35 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    fastUnstake: {
+      /**
+       * Deposit to take for unstaking, to make sure we're able to slash the it in order to cover
+       * the costs of resources on unsuccessful unstake.
+       **/
+      deposit: u128 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     grandpa: {
       /**
        * Max Authorities in use
        **/
       maxAuthorities: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of nominators for each validator.
+       **/
+      maxNominators: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of entries to keep in the set id to session index mapping.
+       * 
+       * Since the `SetIdSession` map is only used for validating equivocations this
+       * value should relate to the bonding duration of whatever staking system is
+       * being used (if any). If equivocation handling is not enabled then this value
+       * can be zero.
+       **/
+      maxSetIdSessionEntries: u64 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -332,18 +333,13 @@ declare module '@polkadot/api-base/types/consts' {
     };
     identity: {
       /**
-       * The amount held on deposit for a registered identity
+       * The amount held on deposit for a registered identity.
        **/
       basicDeposit: u128 & AugmentedConst<ApiType>;
       /**
-       * The amount held on deposit per additional field for a registered identity.
+       * The amount held on deposit per encoded byte for a registered identity.
        **/
-      fieldDeposit: u128 & AugmentedConst<ApiType>;
-      /**
-       * Maximum number of additional fields that may be stored in an ID. Needed to bound the I/O
-       * required to access an identity, but can be pretty high.
-       **/
-      maxAdditionalFields: u32 & AugmentedConst<ApiType>;
+      byteDeposit: u128 & AugmentedConst<ApiType>;
       /**
        * Maxmimum number of registrars allowed in the system. Needed to bound the complexity
        * of, e.g., updating judgements.
@@ -353,6 +349,18 @@ declare module '@polkadot/api-base/types/consts' {
        * The maximum number of sub-accounts allowed per identified account.
        **/
       maxSubAccounts: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum length of a suffix.
+       **/
+      maxSuffixLength: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum length of a username, including its suffix and any system-added delimiters.
+       **/
+      maxUsernameLength: u32 & AugmentedConst<ApiType>;
+      /**
+       * The number of blocks within which a username grant must be accepted.
+       **/
+      pendingUsernameExpiration: u32 & AugmentedConst<ApiType>;
       /**
        * The amount held on deposit for a registered subaccount. This should account for the fact
        * that one storage item's value will increase by the size of an account ID, and there will
@@ -364,19 +372,6 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    imOnline: {
-      /**
-       * A configuration for base priority of unsigned transactions.
-       * 
-       * This is exposed so that it can be tuned for particular runtime, when
-       * multiple pallets send unsigned transactions.
-       **/
-      unsignedPriority: u64 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
     indices: {
       /**
        * The deposit needed for reserving an index.
@@ -387,6 +382,34 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    messageQueue: {
+      /**
+       * The size of the page; this implies the maximum message size which can be sent.
+       * 
+       * A good value depends on the expected message sizes, their weights, the weight that is
+       * available for processing them and the maximal needed message size. The maximal message
+       * size is slightly lower than this as defined by [`MaxMessageLenOf`].
+       **/
+      heapSize: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of stale pages (i.e. of overweight messages) allowed before culling
+       * can happen. Once there are more stale pages than this, then historical pages may be
+       * dropped, even if they contain unprocessed overweight messages.
+       **/
+      maxStale: u32 & AugmentedConst<ApiType>;
+      /**
+       * The amount of weight (if any) which should be provided to the message queue for
+       * servicing enqueued items.
+       * 
+       * This may be legitimately `None` in the case that you will call
+       * `ServiceQueues::service_queues` manually.
+       **/
+      serviceWeight: Option<SpWeightsWeightV2Weight> & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     multisig: {
       /**
        * The base amount of currency needed to reserve for creating a multisig execution or to
@@ -406,7 +429,7 @@ declare module '@polkadot/api-base/types/consts' {
       /**
        * The maximum amount of signatories allowed in the multisig.
        **/
-      maxSignatories: u16 & AugmentedConst<ApiType>;
+      maxSignatories: u32 & AugmentedConst<ApiType>;
       /**
        * Generic const
        **/
@@ -428,6 +451,10 @@ declare module '@polkadot/api-base/types/consts' {
        * Such a scenario would also be the equivalent of the pool being 90% slashed.
        **/
       maxPointsToBalance: u8 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of simultaneous unbonding chunks that can exist per member.
+       **/
+      maxUnbonding: u32 & AugmentedConst<ApiType>;
       /**
        * The nomination pool's pallet id.
        **/
@@ -444,60 +471,6 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    phragmenElection: {
-      /**
-       * How much should be locked up in order to submit one's candidacy.
-       **/
-      candidacyBond: u128 & AugmentedConst<ApiType>;
-      /**
-       * Number of members to elect.
-       **/
-      desiredMembers: u32 & AugmentedConst<ApiType>;
-      /**
-       * Number of runners_up to keep.
-       **/
-      desiredRunnersUp: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of candidates in a phragmen election.
-       * 
-       * Warning: The election happens onchain, and this value will determine
-       * the size of the election. When this limit is reached no more
-       * candidates are accepted in the election.
-       **/
-      maxCandidates: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of voters to allow in a phragmen election.
-       * 
-       * Warning: This impacts the size of the election which is run onchain.
-       * When the limit is reached the new voters are ignored.
-       **/
-      maxVoters: u32 & AugmentedConst<ApiType>;
-      /**
-       * Identifier for the elections-phragmen pallet's lock
-       **/
-      palletId: U8aFixed & AugmentedConst<ApiType>;
-      /**
-       * How long each seat is kept. This defines the next block number at which an election
-       * round will happen. If set to zero, no elections are ever triggered and the module will
-       * be in passive mode.
-       **/
-      termDuration: u32 & AugmentedConst<ApiType>;
-      /**
-       * Base deposit associated with voting.
-       * 
-       * This should be sensibly high to economically ensure the pallet cannot be attacked by
-       * creating a gigantic number of votes.
-       **/
-      votingBondBase: u128 & AugmentedConst<ApiType>;
-      /**
-       * The amount of bond that need to be locked for each vote (32 bytes).
-       **/
-      votingBondFactor: u128 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
     proxy: {
       /**
        * The base amount of currency needed to reserve for creating an announcement.
@@ -541,13 +514,42 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
+    referenda: {
+      /**
+       * Quantization level for the referendum wakeup scheduler. A higher number will result in
+       * fewer storage reads/writes needed for smaller voters, but also result in delays to the
+       * automatic referendum status changes. Explicit servicing instructions are unaffected.
+       **/
+      alarmInterval: u32 & AugmentedConst<ApiType>;
+      /**
+       * Maximum size of the referendum queue for a single track.
+       **/
+      maxQueued: u32 & AugmentedConst<ApiType>;
+      /**
+       * The minimum amount to be used as a deposit for a public referendum proposal.
+       **/
+      submissionDeposit: u128 & AugmentedConst<ApiType>;
+      /**
+       * Information concerning the different referendum tracks.
+       **/
+      tracks: Vec<ITuple<[u16, PalletReferendaTrackInfo]>> & AugmentedConst<ApiType>;
+      /**
+       * The number of blocks after submission that a referendum must begin being decided by.
+       * Once this passes, then anyone may cancel the referendum.
+       **/
+      undecidingTimeout: u32 & AugmentedConst<ApiType>;
+      /**
+       * Generic const
+       **/
+      [key: string]: Codec;
+    };
     registrar: {
       /**
        * The deposit to be paid per byte stored on chain.
        **/
       dataDepositPerByte: u128 & AugmentedConst<ApiType>;
       /**
-       * The deposit to be paid to run a parathread.
+       * The deposit to be paid to run a on-demand parachain.
        * This should include the cost for storing the genesis head and validation code.
        **/
       paraDeposit: u128 & AugmentedConst<ApiType>;
@@ -558,13 +560,15 @@ declare module '@polkadot/api-base/types/consts' {
     };
     scheduler: {
       /**
-       * The maximum weight that may be scheduled per block for any dispatchables of less
-       * priority than `schedule::HARD_DEADLINE`.
+       * The maximum weight that may be scheduled per block for any dispatchables.
        **/
-      maximumWeight: u64 & AugmentedConst<ApiType>;
+      maximumWeight: SpWeightsWeightV2Weight & AugmentedConst<ApiType>;
       /**
        * The maximum number of scheduled calls in the queue for a single block.
-       * Not strictly enforced, but used for weight estimation.
+       * 
+       * NOTE:
+       * + Dependent pallets' benchmarks might require a higher limit for the setting. Set a
+       * higher limit under `runtime-benchmarks` feature.
        **/
       maxScheduledPerBlock: u32 & AugmentedConst<ApiType>;
       /**
@@ -592,19 +596,53 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       bondingDuration: u32 & AugmentedConst<ApiType>;
       /**
-       * Maximum number of nominations per nominator.
-       **/
-      maxNominations: u32 & AugmentedConst<ApiType>;
-      /**
-       * The maximum number of nominators rewarded for each validator.
+       * Number of eras to keep in history.
        * 
-       * For each validator only the `$MaxNominatorRewardedPerValidator` biggest stakers can
-       * claim their reward. This used to limit the i/o cost for the nominator payout.
+       * Following information is kept for eras in `[current_era -
+       * HistoryDepth, current_era]`: `ErasStakers`, `ErasStakersClipped`,
+       * `ErasValidatorPrefs`, `ErasValidatorReward`, `ErasRewardPoints`,
+       * `ErasTotalStake`, `ErasStartSessionIndex`, `ClaimedRewards`, `ErasStakersPaged`,
+       * `ErasStakersOverview`.
+       * 
+       * Must be more than the number of eras delayed by session.
+       * I.e. active era must always be in history. I.e. `active_era >
+       * current_era - history_depth` must be guaranteed.
+       * 
+       * If migrating an existing pallet from storage value to config value,
+       * this should be set to same value or greater as in storage.
+       * 
+       * Note: `HistoryDepth` is used as the upper bound for the `BoundedVec`
+       * item `StakingLedger.legacy_claimed_rewards`. Setting this value lower than
+       * the existing value can lead to inconsistencies in the
+       * `StakingLedger` and will need to be handled properly in a migration.
+       * The test `reducing_history_depth_abrupt` shows this effect.
        **/
-      maxNominatorRewardedPerValidator: u32 & AugmentedConst<ApiType>;
+      historyDepth: u32 & AugmentedConst<ApiType>;
       /**
-       * The maximum number of `unlocking` chunks a [`StakingLedger`] can have. Effectively
-       * determines how many unique eras a staker may be unbonding in.
+       * The maximum size of each `T::ExposurePage`.
+       * 
+       * An `ExposurePage` is weakly bounded to a maximum of `MaxExposurePageSize`
+       * nominators.
+       * 
+       * For older non-paged exposure, a reward payout was restricted to the top
+       * `MaxExposurePageSize` nominators. This is to limit the i/o cost for the
+       * nominator payout.
+       * 
+       * Note: `MaxExposurePageSize` is used to bound `ClaimedRewards` and is unsafe to reduce
+       * without handling it in a migration.
+       **/
+      maxExposurePageSize: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of `unlocking` chunks a [`StakingLedger`] can
+       * have. Effectively determines how many unique eras a staker may be
+       * unbonding in.
+       * 
+       * Note: `MaxUnlockingChunks` is used as the upper bound for the
+       * `BoundedVec` item `StakingLedger.unlocking`. Setting this value
+       * lower than the existing value can lead to inconsistencies in the
+       * `StakingLedger` and will need to be handled properly in a runtime
+       * migration. The test `reducing_max_unlocking_chunks_abrupt` shows
+       * this effect.
        **/
       maxUnlockingChunks: u32 & AugmentedConst<ApiType>;
       /**
@@ -639,9 +677,9 @@ declare module '@polkadot/api-base/types/consts' {
       /**
        * The weight of runtime database operations the runtime can invoke.
        **/
-      dbWeight: FrameSupportWeightsRuntimeDbWeight & AugmentedConst<ApiType>;
+      dbWeight: SpWeightsRuntimeDbWeight & AugmentedConst<ApiType>;
       /**
-       * The designated SS85 prefix of this chain.
+       * The designated SS58 prefix of this chain.
        * 
        * This replaces the "ss58Format" property declared in the chain spec. Reason is
        * that the runtime should know about the prefix in order to make use of it as
@@ -659,10 +697,12 @@ declare module '@polkadot/api-base/types/consts' {
     };
     timestamp: {
       /**
-       * The minimum period between blocks. Beware that this is different to the *expected*
-       * period that the block production apparatus provides. Your chosen consensus system will
-       * generally work with this to determine a sensible block time. e.g. For Aura, it will be
-       * double this period on default settings.
+       * The minimum period between blocks.
+       * 
+       * Be aware that this is different to the *expected* period that the block production
+       * apparatus provides. Your chosen consensus system will generally work with this to
+       * determine a sensible block time. For example, in the Aura pallet it will be double this
+       * period on default settings.
        **/
       minimumPeriod: u64 & AugmentedConst<ApiType>;
       /**
@@ -670,40 +710,12 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       [key: string]: Codec;
     };
-    tips: {
-      /**
-       * The amount held on deposit per byte within the tip report reason or bounty description.
-       **/
-      dataDepositPerByte: u128 & AugmentedConst<ApiType>;
-      /**
-       * Maximum acceptable reason length.
-       * 
-       * Benchmarks depend on this value, be sure to update weights file when changing this value
-       **/
-      maximumReasonLength: u32 & AugmentedConst<ApiType>;
-      /**
-       * The period for which a tip remains open after is has achieved threshold tippers.
-       **/
-      tipCountdown: u32 & AugmentedConst<ApiType>;
-      /**
-       * The percent of the final tip which goes to the original reporter of the tip.
-       **/
-      tipFindersFee: Percent & AugmentedConst<ApiType>;
-      /**
-       * The amount held on deposit for placing a tip report.
-       **/
-      tipReportDepositBase: u128 & AugmentedConst<ApiType>;
-      /**
-       * Generic const
-       **/
-      [key: string]: Codec;
-    };
     transactionPayment: {
       /**
-       * A fee mulitplier for `Operational` extrinsics to compute "virtual tip" to boost their
+       * A fee multiplier for `Operational` extrinsics to compute "virtual tip" to boost their
        * `priority`
        * 
-       * This value is multipled by the `final_fee` to obtain a "virtual tip" that is later
+       * This value is multiplied by the `final_fee` to obtain a "virtual tip" that is later
        * added to a tip component in regular `priority` calculations.
        * It means that a `Normal` transaction can front-run a similarly-sized `Operational`
        * extrinsic (with no tip), by including a tip value greater than the virtual tip.
@@ -743,6 +755,10 @@ declare module '@polkadot/api-base/types/consts' {
        * The treasury's pallet id, used for deriving its sovereign account ID.
        **/
       palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
+      /**
+       * The period during which an approved treasury spend has to be claimed.
+       **/
+      payoutPeriod: u32 & AugmentedConst<ApiType>;
       /**
        * Fraction of a proposal's value that should be bonded in order to place the proposal.
        * An accepted proposal gets these back. A rejected proposal does not.

packages/api-augment/src/polkadot/index.ts

@@ -1,11 +1,11 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import '../base';
-import './consts';
-import './errors';
-import './events';
-import './query';
-import './registry';
-import './runtime';
-import './tx';
+import '../base.js';
+import './consts.js';
+import './errors.js';
+import './events.js';
+import './query.js';
+import './registry.js';
+import './runtime.js';
+import './tx.js';

packages/api-augment/src/polkadot/registry.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import '@polkadot/types-augment/registry/substrate';

packages/api-augment/src/polkadot/runtime.ts

@@ -6,20 +6,22 @@
 import '@polkadot/api-base/types/calls';
 
 import type { ApiTypes, AugmentedCall, DecoratedCallBase } from '@polkadot/api-base/types';
-import type { Bytes, Null, Option, Result, Vec, bool, u32 } from '@polkadot/types-codec';
+import type { Bytes, Null, Option, Result, U64, Vec, bool, u32 } from '@polkadot/types-codec';
 import type { AnyNumber, IMethod, ITuple } from '@polkadot/types-codec/types';
 import type { BabeEquivocationProof, BabeGenesisConfiguration, Epoch, OpaqueKeyOwnershipProof } from '@polkadot/types/interfaces/babe';
-import type { ValidatorSet } from '@polkadot/types/interfaces/beefy';
+import type { BeefyAuthoritySet, BeefyEquivocationProof, BeefyNextAuthoritySet, ValidatorSet, ValidatorSetId } from '@polkadot/types/interfaces/beefy';
 import type { CheckInherentsResult, InherentData } from '@polkadot/types/interfaces/blockbuilder';
 import type { BlockHash } from '@polkadot/types/interfaces/chain';
 import type { AuthorityId } from '@polkadot/types/interfaces/consensus';
 import type { Extrinsic } from '@polkadot/types/interfaces/extrinsics';
+import type { GenesisBuildErr } from '@polkadot/types/interfaces/genesisBuilder';
 import type { AuthorityList, GrandpaEquivocationProof, SetId } from '@polkadot/types/interfaces/grandpa';
 import type { OpaqueMetadata } from '@polkadot/types/interfaces/metadata';
-import type { MmrBatchProof, MmrEncodableOpaqueLeaf, MmrError, MmrLeafIndex, MmrProof } from '@polkadot/types/interfaces/mmr';
-import type { CandidateCommitments, CandidateEvent, CommittedCandidateReceipt, CoreState, GroupRotationInfo, InboundDownwardMessage, InboundHrmpMessage, OccupiedCoreAssumption, ParaId, ParaValidatorIndex, PersistedValidationData, PvfCheckStatement, ScrapedOnChainVotes, SessionInfo, ValidationCode, ValidationCodeHash, ValidatorSignature } from '@polkadot/types/interfaces/parachains';
+import type { MmrBatchProof, MmrEncodableOpaqueLeaf, MmrError } from '@polkadot/types/interfaces/mmr';
+import type { NpPoolId } from '@polkadot/types/interfaces/nompools';
+import type { CandidateCommitments, CandidateEvent, CandidateHash, CommittedCandidateReceipt, CoreState, DisputeProof, DisputeState, ExecutorParams, GroupRotationInfo, InboundDownwardMessage, InboundHrmpMessage, OccupiedCoreAssumption, ParaId, ParaValidatorIndex, PendingSlashes, PersistedValidationData, PvfCheckStatement, ScrapedOnChainVotes, SessionInfo, ValidationCode, ValidationCodeHash, ValidatorSignature } from '@polkadot/types/interfaces/parachains';
 import type { FeeDetails, RuntimeDispatchInfo } from '@polkadot/types/interfaces/payment';
-import type { AccountId, Block, Call, Hash, Header, Index, KeyTypeId, Slot, ValidatorId } from '@polkadot/types/interfaces/runtime';
+import type { AccountId, Balance, Block, BlockNumber, Call, Hash, Header, Index, KeyTypeId, Slot, ValidatorId, Weight } from '@polkadot/types/interfaces/runtime';
 import type { SessionIndex } from '@polkadot/types/interfaces/session';
 import type { RuntimeVersion } from '@polkadot/types/interfaces/state';
 import type { ApplyExtrinsicResult } from '@polkadot/types/interfaces/system';
@@ -84,8 +86,20 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x49eaaf1b548a0cb0/1 */
+    /** 0x49eaaf1b548a0cb0/3 */
     beefyApi: {
+      /**
+       * Return the block number where BEEFY consensus is enabled/started
+       **/
+      beefyGenesis: AugmentedCall<ApiType, () => Observable<Option<BlockNumber>>>;
+      /**
+       * Generates a proof of key ownership for the given authority in the given set.
+       **/
+      generateKeyOwnershipProof: AugmentedCall<ApiType, (setId: ValidatorSetId | AnyNumber | Uint8Array, authorityId: AuthorityId | string | Uint8Array) => Observable<Option<OpaqueKeyOwnershipProof>>>;
+      /**
+       * Submits an unsigned extrinsic to report an equivocation.
+       **/
+      submitReportEquivocationUnsignedExtrinsic: AugmentedCall<ApiType, (equivocationProof: BeefyEquivocationProof | { first?: any; second?: any } | string | Uint8Array, keyOwnerProof: OpaqueKeyOwnershipProof | string | Uint8Array) => Observable<Option<Null>>>;
       /**
        * Return the current active BEEFY validator set
        **/
@@ -95,6 +109,21 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0x2a5e924655399e60/1 */
+    beefyMmrApi: {
+      /**
+       * Return the currently active BEEFY authority set proof.
+       **/
+      authoritySetProof: AugmentedCall<ApiType, () => Observable<BeefyAuthoritySet>>;
+      /**
+       * Return the next/queued BEEFY authority set proof.
+       **/
+      nextAuthoritySetProof: AugmentedCall<ApiType, () => Observable<BeefyNextAuthoritySet>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0x40fe3ad401f8959a/6 */
     blockBuilder: {
       /**
@@ -137,6 +166,21 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0xfbc577b9d747efd6/1 */
+    genesisBuilder: {
+      /**
+       * Build `RuntimeGenesisConfig` from a JSON blob not using any defaults and store it in the storage.
+       **/
+      buildConfig: AugmentedCall<ApiType, (json: Bytes | string | Uint8Array) => Observable<Result<ITuple<[]>, GenesisBuildErr>>>;
+      /**
+       * Creates the default `RuntimeGenesisConfig` and returns it as a JSON blob.
+       **/
+      createDefaultConfig: AugmentedCall<ApiType, () => Observable<Bytes>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0xed99c5acb25eedf5/3 */
     grandpaApi: {
       /**
@@ -160,47 +204,66 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x37e397fc7c91f5e4/1 */
+    /** 0x37e397fc7c91f5e4/2 */
     metadata: {
       /**
        * Returns the metadata of a runtime
        **/
       metadata: AugmentedCall<ApiType, () => Observable<OpaqueMetadata>>;
+      /**
+       * Returns the metadata at a given version.
+       **/
+      metadataAtVersion: AugmentedCall<ApiType, (version: u32 | AnyNumber | Uint8Array) => Observable<Option<OpaqueMetadata>>>;
+      /**
+       * Returns the supported metadata versions.
+       **/
+      metadataVersions: AugmentedCall<ApiType, () => Observable<Vec<u32>>>;
       /**
        * Generic call
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x91d5df18b0d2cf58/1 */
+    /** 0x91d5df18b0d2cf58/2 */
     mmrApi: {
       /**
-       * Generate MMR proof for a series of leaves under given indices.
+       * Generate MMR proof for the given block numbers.
        **/
-      generateBatchProof: AugmentedCall<ApiType, (leafIndices: Vec<MmrLeafIndex> | (MmrLeafIndex | AnyNumber | Uint8Array)[]) => Observable<Result<ITuple<[Vec<MmrEncodableOpaqueLeaf>, MmrBatchProof]>, MmrError>>>;
+      generateProof: AugmentedCall<ApiType, (blockNumbers: Vec<BlockNumber> | (BlockNumber | AnyNumber | Uint8Array)[], bestKnownBlockNumber: Option<BlockNumber> | null | Uint8Array | BlockNumber | AnyNumber) => Observable<Result<ITuple<[Vec<MmrEncodableOpaqueLeaf>, MmrBatchProof]>, MmrError>>>;
       /**
-       * Generate MMR proof for a leaf under given index.
+       * Return the number of MMR blocks in the chain.
        **/
-      generateProof: AugmentedCall<ApiType, (leafIndex: MmrLeafIndex | AnyNumber | Uint8Array) => Observable<Result<ITuple<[MmrEncodableOpaqueLeaf, MmrProof]>, MmrError>>>;
+      mmrLeafCount: AugmentedCall<ApiType, () => Observable<Result<U64, MmrError>>>;
       /**
        * Return the on-chain MMR root hash.
        **/
       mmrRoot: AugmentedCall<ApiType, () => Observable<Result<Hash, MmrError>>>;
-      /**
-       * Verify MMR proof against on-chain MMR for a batch of leaves.
-       **/
-      verifyBatchProof: AugmentedCall<ApiType, (leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
-      /**
-       * Verify MMR proof against given root hash or a batch of leaves.
-       **/
-      verifyBatchProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
       /**
        * Verify MMR proof against on-chain MMR.
        **/
-      verifyProof: AugmentedCall<ApiType, (leaf: MmrEncodableOpaqueLeaf | string | Uint8Array, proof: MmrProof | { leafIndex?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      verifyProof: AugmentedCall<ApiType, (leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
       /**
        * Verify MMR proof against given root hash.
        **/
-      verifyProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaf: MmrEncodableOpaqueLeaf | string | Uint8Array, proof: MmrProof | { leafIndex?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      verifyProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
+    /** 0x17a6bc0d0062aeb3/1 */
+    nominationPoolsApi: {
+      /**
+       * Returns the equivalent points of `new_funds` for a given pool.
+       **/
+      balanceToPoints: AugmentedCall<ApiType, (poolId: NpPoolId | AnyNumber | Uint8Array, newFunds: Balance | AnyNumber | Uint8Array) => Observable<Balance>>;
+      /**
+       * Returns the pending rewards for the given member.
+       **/
+      pendingRewards: AugmentedCall<ApiType, (member: AccountId | string | Uint8Array) => Observable<Balance>>;
+      /**
+       * Returns the equivalent balance of `points` for a given pool.
+       **/
+      pointsToBalance: AugmentedCall<ApiType, (poolId: NpPoolId | AnyNumber | Uint8Array, points: Balance | AnyNumber | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/
@@ -217,7 +280,7 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0xaf2c0297a23e6d3d/2 */
+    /** 0xaf2c0297a23e6d3d/5 */
     parachainHost: {
       /**
        * Returns the persisted validation data for the given `ParaId` along with the corresponding validation code hash.
@@ -239,6 +302,10 @@ declare module '@polkadot/api-base/types/calls' {
        * Checks if the given validation outputs pass the acceptance criteria.
        **/
       checkValidationOutputs: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array, outputs: CandidateCommitments | { upwardMessages?: any; horizontalMessages?: any; newValidationCode?: any; headData?: any; processedDownwardMessages?: any; hrmpWatermark?: any } | string | Uint8Array) => Observable<bool>>;
+      /**
+       * Returns all onchain disputes.
+       **/
+      disputes: AugmentedCall<ApiType, () => Observable<Vec<ITuple<[SessionIndex, CandidateHash, DisputeState]>>>>;
       /**
        * Get all the pending inbound messages in the downward message queue for a para.
        **/
@@ -247,6 +314,10 @@ declare module '@polkadot/api-base/types/calls' {
        * Get the contents of all channels addressed to the given recipient.
        **/
       inboundHrmpChannelsContents: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array) => Observable<Vec<InboundHrmpMessage>>>;
+      /**
+       * Returns a merkle proof of a validator session key
+       **/
+      keyOwnershipProof: AugmentedCall<ApiType, (validatorId: ValidatorId | string | Uint8Array) => Observable<Option<OpaqueKeyOwnershipProof>>>;
       /**
        * Scrape dispute relevant from on-chain, backing votes and resolved disputes.
        **/
@@ -259,6 +330,10 @@ declare module '@polkadot/api-base/types/calls' {
        * Returns code hashes of PVFs that require pre-checking by validators in the active set.
        **/
       pvfsRequirePrecheck: AugmentedCall<ApiType, () => Observable<Vec<ValidationCodeHash>>>;
+      /**
+       * Returns execution parameters for the session.
+       **/
+      sessionExecutorParams: AugmentedCall<ApiType, (sessionIndex: SessionIndex | AnyNumber | Uint8Array) => Observable<Option<ExecutorParams>>>;
       /**
        * Returns the session index expected at a child of the block.
        **/
@@ -271,10 +346,18 @@ declare module '@polkadot/api-base/types/calls' {
        * Submits a PVF pre-checking statement into the transaction pool.
        **/
       submitPvfCheckStatement: AugmentedCall<ApiType, (stmt: PvfCheckStatement | { accept?: any; subject?: any; sessionIndex?: any; validatorIndex?: any } | string | Uint8Array, signature: ValidatorSignature | string | Uint8Array) => Observable<Null>>;
+      /**
+       * Submit an unsigned extrinsic to slash validators who lost a dispute about a candidate of a past session
+       **/
+      submitReportDisputeLost: AugmentedCall<ApiType, (disputeProof: DisputeProof | { timeSlot?: any; kind?: any; validatorIndex?: any; validatorId?: any } | string | Uint8Array, keyOwnershipProof: OpaqueKeyOwnershipProof | string | Uint8Array) => Observable<Option<Null>>>;
+      /**
+       * Returns a list of validators that lost a past session dispute and need to be slashed
+       **/
+      unappliedSlashes: AugmentedCall<ApiType, () => Observable<Vec<ITuple<[SessionIndex, CandidateHash, PendingSlashes]>>>>;
       /**
        * Fetch the validation code used by a para, making the given `OccupiedCoreAssumption`.
        **/
-      validationCode: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array, assumption: OccupiedCoreAssumption | 'Included,' | 'TimedOut' | 'Free' | number | Uint8Array) => Observable<ValidationCode>>;
+      validationCode: AugmentedCall<ApiType, (paraId: ParaId | AnyNumber | Uint8Array, assumption: OccupiedCoreAssumption | 'Included,' | 'TimedOut' | 'Free' | number | Uint8Array) => Observable<Option<ValidationCode>>>;
       /**
        * Get the validation code from its hash.
        **/
@@ -311,6 +394,17 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0x18ef58a3b67ba770/1 */
+    stakingApi: {
+      /**
+       * Returns the nominations quota for a nominator with a given balance.
+       **/
+      nominationsQuota: AugmentedCall<ApiType, (balance: Balance | AnyNumber | Uint8Array) => Observable<u32>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0xd2bc9897eed08f15/3 */
     taggedTransactionQueue: {
       /**
@@ -322,7 +416,7 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x37c8bb1350a9a2a8/1 */
+    /** 0x37c8bb1350a9a2a8/4 */
     transactionPaymentApi: {
       /**
        * The transaction fee details
@@ -332,12 +426,20 @@ declare module '@polkadot/api-base/types/calls' {
        * The transaction info
        **/
       queryInfo: AugmentedCall<ApiType, (uxt: Extrinsic | IExtrinsic | string | Uint8Array, len: u32 | AnyNumber | Uint8Array) => Observable<RuntimeDispatchInfo>>;
+      /**
+       * Query the output of the current LengthToFee given some input
+       **/
+      queryLengthToFee: AugmentedCall<ApiType, (length: u32 | AnyNumber | Uint8Array) => Observable<Balance>>;
+      /**
+       * Query the output of the current WeightToFee given some input
+       **/
+      queryWeightToFee: AugmentedCall<ApiType, (weight: Weight | { refTime?: any; proofSize?: any } | string | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0xf3ff14d5ab527059/1 */
+    /** 0xf3ff14d5ab527059/3 */
     transactionPaymentCallApi: {
       /**
        * The call fee details
@@ -347,6 +449,14 @@ declare module '@polkadot/api-base/types/calls' {
        * The call info
        **/
       queryCallInfo: AugmentedCall<ApiType, (call: Call | IMethod | string | Uint8Array, len: u32 | AnyNumber | Uint8Array) => Observable<RuntimeDispatchInfo>>;
+      /**
+       * Query the output of the current LengthToFee given some input
+       **/
+      queryLengthToFee: AugmentedCall<ApiType, (length: u32 | AnyNumber | Uint8Array) => Observable<Balance>>;
+      /**
+       * Query the output of the current WeightToFee given some input
+       **/
+      queryWeightToFee: AugmentedCall<ApiType, (weight: Weight | { refTime?: any; proofSize?: any } | string | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/

packages/api-augment/src/substrate/index.ts

@@ -1,11 +1,11 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import '../base';
-import './consts';
-import './errors';
-import './events';
-import './query';
-import './registry';
-import './runtime';
-import './tx';
+import '../base.js';
+import './consts.js';
+import './errors.js';
+import './events.js';
+import './query.js';
+import './registry.js';
+import './runtime.js';
+import './tx.js';

packages/api-augment/src/substrate/registry.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-augment authors & contributors
+// Copyright 2017-2024 @polkadot/api-augment authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import '@polkadot/types-augment/registry/substrate';

packages/api-augment/src/substrate/runtime.ts

@@ -6,23 +6,30 @@
 import '@polkadot/api-base/types/calls';
 
 import type { ApiTypes, AugmentedCall, DecoratedCallBase } from '@polkadot/api-base/types';
-import type { Bytes, Null, Option, Result, Vec, u32, u64 } from '@polkadot/types-codec';
+import type { Bytes, Null, Option, Result, U64, Vec, bool, u128, u32 } from '@polkadot/types-codec';
 import type { AnyNumber, IMethod, ITuple } from '@polkadot/types-codec/types';
+import type { TAssetBalance } from '@polkadot/types/interfaces/assets';
 import type { BabeEquivocationProof, BabeGenesisConfiguration, Epoch, OpaqueKeyOwnershipProof } from '@polkadot/types/interfaces/babe';
+import type { BeefyEquivocationProof, ValidatorSet, ValidatorSetId } from '@polkadot/types/interfaces/beefy';
 import type { CheckInherentsResult, InherentData } from '@polkadot/types/interfaces/blockbuilder';
 import type { BlockHash } from '@polkadot/types/interfaces/chain';
 import type { AuthorityId } from '@polkadot/types/interfaces/consensus';
-import type { CodeUploadResult, ContractExecResult, ContractInstantiateResult } from '@polkadot/types/interfaces/contracts';
+import type { CodeSource, CodeUploadResult, ContractExecResult, ContractInstantiateResult } from '@polkadot/types/interfaces/contracts';
 import type { Extrinsic } from '@polkadot/types/interfaces/extrinsics';
+import type { GenesisBuildErr } from '@polkadot/types/interfaces/genesisBuilder';
 import type { AuthorityList, GrandpaEquivocationProof, SetId } from '@polkadot/types/interfaces/grandpa';
 import type { OpaqueMetadata } from '@polkadot/types/interfaces/metadata';
-import type { MmrBatchProof, MmrEncodableOpaqueLeaf, MmrError, MmrLeafIndex, MmrProof } from '@polkadot/types/interfaces/mmr';
-import type { NpApiError } from '@polkadot/types/interfaces/nompools';
+import type { Mixnode, MixnodesErr, SessionStatus } from '@polkadot/types/interfaces/mixnet';
+import type { MmrBatchProof, MmrEncodableOpaqueLeaf, MmrError } from '@polkadot/types/interfaces/mmr';
+import type { NftCollectionId, NftItemId } from '@polkadot/types/interfaces/nfts';
+import type { NpPoolId } from '@polkadot/types/interfaces/nompools';
 import type { FeeDetails, RuntimeDispatchInfo } from '@polkadot/types/interfaces/payment';
-import type { AccountId, Balance, Block, Call, Hash, Header, Index, KeyTypeId, Slot } from '@polkadot/types/interfaces/runtime';
+import type { AccountId, Balance, Block, BlockNumber, Call, ExtrinsicInclusionMode, Hash, Header, Index, KeyTypeId, Slot, Weight, WeightV2 } from '@polkadot/types/interfaces/runtime';
 import type { RuntimeVersion } from '@polkadot/types/interfaces/state';
+import type { StatementStoreInvalidStatement, StatementStoreStatementSource, StatementStoreValidStatement } from '@polkadot/types/interfaces/statement';
 import type { ApplyExtrinsicResult } from '@polkadot/types/interfaces/system';
 import type { TransactionSource, TransactionValidity } from '@polkadot/types/interfaces/txqueue';
+import type { SpStatementStoreStatement, StagingXcmV3MultiLocation } from '@polkadot/types/lookup';
 import type { IExtrinsic, Observable } from '@polkadot/types/types';
 
 export type __AugmentedCall<ApiType extends ApiTypes> = AugmentedCall<ApiType>;
@@ -41,6 +48,36 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0x8a8047a53a8277ec/1 */
+    assetConversionApi: {
+      /**
+       * Get pool reserves
+       **/
+      getReserves: AugmentedCall<ApiType, (asset1: StagingXcmV3MultiLocation, asset2: StagingXcmV3MultiLocation) => Observable<Option<ITuple<[Balance, Balance]>>>>;
+      /**
+       * Quote price: exact tokens for tokens
+       **/
+      quotePriceExactTokensForTokens: AugmentedCall<ApiType, (asset1: StagingXcmV3MultiLocation, asset2: StagingXcmV3MultiLocation, amount: u128 | AnyNumber | Uint8Array, include_fee: bool | boolean | Uint8Array) => Observable<Option<Balance>>>;
+      /**
+       * Quote price: tokens for exact tokens
+       **/
+      quotePriceTokensForExactTokens: AugmentedCall<ApiType, (asset1: StagingXcmV3MultiLocation, asset2: StagingXcmV3MultiLocation, amount: u128 | AnyNumber | Uint8Array, include_fee: bool | boolean | Uint8Array) => Observable<Option<Balance>>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
+    /** 0x8453b50b22293977/1 */
+    assetsApi: {
+      /**
+       * Return the current set of authorities.
+       **/
+      accountBalances: AugmentedCall<ApiType, (account: AccountId | string | Uint8Array) => Observable<Vec<ITuple<[u32, TAssetBalance]>>>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0x687ad44ad37f03c2/1 */
     authorityDiscoveryApi: {
       /**
@@ -83,6 +120,29 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0x49eaaf1b548a0cb0/3 */
+    beefyApi: {
+      /**
+       * Return the block number where BEEFY consensus is enabled/started
+       **/
+      beefyGenesis: AugmentedCall<ApiType, () => Observable<Option<BlockNumber>>>;
+      /**
+       * Generates a proof of key ownership for the given authority in the given set.
+       **/
+      generateKeyOwnershipProof: AugmentedCall<ApiType, (setId: ValidatorSetId | AnyNumber | Uint8Array, authorityId: AuthorityId | string | Uint8Array) => Observable<Option<OpaqueKeyOwnershipProof>>>;
+      /**
+       * Submits an unsigned extrinsic to report an equivocation.
+       **/
+      submitReportEquivocationUnsignedExtrinsic: AugmentedCall<ApiType, (equivocationProof: BeefyEquivocationProof | { first?: any; second?: any } | string | Uint8Array, keyOwnerProof: OpaqueKeyOwnershipProof | string | Uint8Array) => Observable<Option<Null>>>;
+      /**
+       * Return the current active BEEFY validator set
+       **/
+      validatorSet: AugmentedCall<ApiType, () => Observable<Option<ValidatorSet>>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0x40fe3ad401f8959a/6 */
     blockBuilder: {
       /**
@@ -106,12 +166,12 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x68b66ba122c93fa7/1 */
+    /** 0x68b66ba122c93fa7/2 */
     contractsApi: {
       /**
        * Perform a call from a specified account to a given contract.
        **/
-      call: AugmentedCall<ApiType, (origin: AccountId | string | Uint8Array, dest: AccountId | string | Uint8Array, value: Balance | AnyNumber | Uint8Array, gasLimit: u64 | AnyNumber | Uint8Array, storageDepositLimit: Option<Balance> | null | Uint8Array | Balance | AnyNumber, inputData: Bytes | string | Uint8Array) => Observable<ContractExecResult>>;
+      call: AugmentedCall<ApiType, (origin: AccountId | string | Uint8Array, dest: AccountId | string | Uint8Array, value: Balance | AnyNumber | Uint8Array, gasLimit: Option<WeightV2> | null | Uint8Array | WeightV2 | { refTime?: any; proofSize?: any } | string, storageDepositLimit: Option<Balance> | null | Uint8Array | Balance | AnyNumber, inputData: Bytes | string | Uint8Array) => Observable<ContractExecResult>>;
       /**
        * Query a given storage key in a given contract.
        **/
@@ -119,7 +179,7 @@ declare module '@polkadot/api-base/types/calls' {
       /**
        * Instantiate a new contract.
        **/
-      instantiate: AugmentedCall<ApiType, (origin: AccountId | string | Uint8Array, value: Balance | AnyNumber | Uint8Array, gasLimit: u64 | AnyNumber | Uint8Array, storageDepositLimit: Option<Balance> | null | Uint8Array | Balance | AnyNumber, code: Bytes | string | Uint8Array, data: Bytes | string | Uint8Array, salt: Bytes | string | Uint8Array) => Observable<ContractInstantiateResult>>;
+      instantiate: AugmentedCall<ApiType, (origin: AccountId | string | Uint8Array, value: Balance | AnyNumber | Uint8Array, gasLimit: Option<WeightV2> | null | Uint8Array | WeightV2 | { refTime?: any; proofSize?: any } | string, storageDepositLimit: Option<Balance> | null | Uint8Array | Balance | AnyNumber, code: CodeSource | { Upload: any } | { Existing: any } | string | Uint8Array, data: Bytes | string | Uint8Array, salt: Bytes | string | Uint8Array) => Observable<ContractInstantiateResult>>;
       /**
        * Upload new code without instantiating a contract from it.
        **/
@@ -129,7 +189,7 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0xdf6acb689907609b/4 */
+    /** 0xdf6acb689907609b/5 */
     core: {
       /**
        * Execute the given block.
@@ -138,7 +198,7 @@ declare module '@polkadot/api-base/types/calls' {
       /**
        * Initialize a block with the given header.
        **/
-      initializeBlock: AugmentedCall<ApiType, (header: Header | { parentHash?: any; number?: any; stateRoot?: any; extrinsicsRoot?: any; digest?: any } | string | Uint8Array) => Observable<Null>>;
+      initializeBlock: AugmentedCall<ApiType, (header: Header | { parentHash?: any; number?: any; stateRoot?: any; extrinsicsRoot?: any; digest?: any } | string | Uint8Array) => Observable<ExtrinsicInclusionMode>>;
       /**
        * Returns the version of the runtime.
        **/
@@ -148,6 +208,21 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0xfbc577b9d747efd6/1 */
+    genesisBuilder: {
+      /**
+       * Build `RuntimeGenesisConfig` from a JSON blob not using any defaults and store it in the storage.
+       **/
+      buildConfig: AugmentedCall<ApiType, (json: Bytes | string | Uint8Array) => Observable<Result<ITuple<[]>, GenesisBuildErr>>>;
+      /**
+       * Creates the default `RuntimeGenesisConfig` and returns it as a JSON blob.
+       **/
+      createDefaultConfig: AugmentedCall<ApiType, () => Observable<Bytes>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0xed99c5acb25eedf5/3 */
     grandpaApi: {
       /**
@@ -171,47 +246,101 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x37e397fc7c91f5e4/1 */
+    /** 0x37e397fc7c91f5e4/2 */
     metadata: {
       /**
        * Returns the metadata of a runtime
        **/
       metadata: AugmentedCall<ApiType, () => Observable<OpaqueMetadata>>;
+      /**
+       * Returns the metadata at a given version.
+       **/
+      metadataAtVersion: AugmentedCall<ApiType, (version: u32 | AnyNumber | Uint8Array) => Observable<Option<OpaqueMetadata>>>;
+      /**
+       * Returns the supported metadata versions.
+       **/
+      metadataVersions: AugmentedCall<ApiType, () => Observable<Vec<u32>>>;
       /**
        * Generic call
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x91d5df18b0d2cf58/1 */
+    /** 0x6fd7c327202e4a8d/1 */
+    mixnetApi: {
+      /**
+       * Get the index and phase of the current session.
+       **/
+      currentMixnodes: AugmentedCall<ApiType, () => Observable<Result<Mixnode, MixnodesErr>>>;
+      /**
+       * Try to register a mixnode for the next session.
+       **/
+      maybeRegister: AugmentedCall<ApiType, (session_index: u32 | AnyNumber | Uint8Array, mixnode: Mixnode | { externalAddresses?: any; kxPublic?: any; peerId?: any } | string | Uint8Array) => Observable<bool>>;
+      /**
+       * Get the index and phase of the current session.
+       **/
+      prevMixnodes: AugmentedCall<ApiType, () => Observable<Result<Mixnode, MixnodesErr>>>;
+      /**
+       * Get the index and phase of the current session.
+       **/
+      sessionStatus: AugmentedCall<ApiType, () => Observable<SessionStatus>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
+    /** 0x91d5df18b0d2cf58/2 */
     mmrApi: {
       /**
-       * Generate MMR proof for a series of leaves under given indices.
+       * Generate MMR proof for the given block numbers.
        **/
-      generateBatchProof: AugmentedCall<ApiType, (leafIndices: Vec<MmrLeafIndex> | (MmrLeafIndex | AnyNumber | Uint8Array)[]) => Observable<Result<ITuple<[Vec<MmrEncodableOpaqueLeaf>, MmrBatchProof]>, MmrError>>>;
+      generateProof: AugmentedCall<ApiType, (blockNumbers: Vec<BlockNumber> | (BlockNumber | AnyNumber | Uint8Array)[], bestKnownBlockNumber: Option<BlockNumber> | null | Uint8Array | BlockNumber | AnyNumber) => Observable<Result<ITuple<[Vec<MmrEncodableOpaqueLeaf>, MmrBatchProof]>, MmrError>>>;
       /**
-       * Generate MMR proof for a leaf under given index.
+       * Return the number of MMR blocks in the chain.
        **/
-      generateProof: AugmentedCall<ApiType, (leafIndex: MmrLeafIndex | AnyNumber | Uint8Array) => Observable<Result<ITuple<[MmrEncodableOpaqueLeaf, MmrProof]>, MmrError>>>;
+      mmrLeafCount: AugmentedCall<ApiType, () => Observable<Result<U64, MmrError>>>;
       /**
        * Return the on-chain MMR root hash.
        **/
       mmrRoot: AugmentedCall<ApiType, () => Observable<Result<Hash, MmrError>>>;
-      /**
-       * Verify MMR proof against on-chain MMR for a batch of leaves.
-       **/
-      verifyBatchProof: AugmentedCall<ApiType, (leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
-      /**
-       * Verify MMR proof against given root hash or a batch of leaves.
-       **/
-      verifyBatchProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
       /**
        * Verify MMR proof against on-chain MMR.
        **/
-      verifyProof: AugmentedCall<ApiType, (leaf: MmrEncodableOpaqueLeaf | string | Uint8Array, proof: MmrProof | { leafIndex?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      verifyProof: AugmentedCall<ApiType, (leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
       /**
        * Verify MMR proof against given root hash.
        **/
-      verifyProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaf: MmrEncodableOpaqueLeaf | string | Uint8Array, proof: MmrProof | { leafIndex?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      verifyProofStateless: AugmentedCall<ApiType, (root: Hash | string | Uint8Array, leaves: Vec<MmrEncodableOpaqueLeaf> | (MmrEncodableOpaqueLeaf | string | Uint8Array)[], proof: MmrBatchProof | { leafIndices?: any; leafCount?: any; items?: any } | string | Uint8Array) => Observable<Result<ITuple<[]>, MmrError>>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
+    /** 0x899a250cbe84f250/1 */
+    nftsApi: {
+      /**
+       * An attribute
+       **/
+      attribute: AugmentedCall<ApiType, (collection: NftCollectionId | AnyNumber | Uint8Array, item: NftItemId | AnyNumber | Uint8Array, key: Bytes | string | Uint8Array) => Observable<Option<Bytes>>>;
+      /**
+       * A collection attribute
+       **/
+      collectionAttribute: AugmentedCall<ApiType, (collection: NftCollectionId | AnyNumber | Uint8Array, key: Bytes | string | Uint8Array) => Observable<Option<Bytes>>>;
+      /**
+       * A collection owner
+       **/
+      collectionOwner: AugmentedCall<ApiType, (collection: NftCollectionId | AnyNumber | Uint8Array) => Observable<Option<AccountId>>>;
+      /**
+       * A custom attribute
+       **/
+      customAttribute: AugmentedCall<ApiType, (account: AccountId | string | Uint8Array, collection: NftCollectionId | AnyNumber | Uint8Array, item: NftItemId | AnyNumber | Uint8Array, key: Bytes | string | Uint8Array) => Observable<Option<Bytes>>>;
+      /**
+       * Collection owner
+       **/
+      owner: AugmentedCall<ApiType, (collection: NftCollectionId | AnyNumber | Uint8Array, item: NftItemId | AnyNumber | Uint8Array) => Observable<Option<AccountId>>>;
+      /**
+       * System attribute
+       **/
+      systemAttribute: AugmentedCall<ApiType, (collection: NftCollectionId | AnyNumber | Uint8Array, item: NftItemId | AnyNumber | Uint8Array, key: Bytes | string | Uint8Array) => Observable<Option<Bytes>>>;
       /**
        * Generic call
        **/
@@ -219,10 +348,18 @@ declare module '@polkadot/api-base/types/calls' {
     };
     /** 0x17a6bc0d0062aeb3/1 */
     nominationPoolsApi: {
+      /**
+       * Returns the equivalent points of `new_funds` for a given pool.
+       **/
+      balanceToPoints: AugmentedCall<ApiType, (poolId: NpPoolId | AnyNumber | Uint8Array, newFunds: Balance | AnyNumber | Uint8Array) => Observable<Balance>>;
       /**
        * Returns the pending rewards for the given member.
        **/
-      pendingRewards: AugmentedCall<ApiType, (member: AccountId | string | Uint8Array) => Observable<Result<Balance, NpApiError>>>;
+      pendingRewards: AugmentedCall<ApiType, (member: AccountId | string | Uint8Array) => Observable<Balance>>;
+      /**
+       * Returns the equivalent balance of `points` for a given pool.
+       **/
+      pointsToBalance: AugmentedCall<ApiType, (poolId: NpPoolId | AnyNumber | Uint8Array, points: Balance | AnyNumber | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/
@@ -254,6 +391,17 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
+    /** 0x18ef58a3b67ba770/1 */
+    stakingApi: {
+      /**
+       * Returns the nominations quota for a nominator with a given balance.
+       **/
+      nominationsQuota: AugmentedCall<ApiType, (balance: Balance | AnyNumber | Uint8Array) => Observable<u32>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
     /** 0xd2bc9897eed08f15/3 */
     taggedTransactionQueue: {
       /**
@@ -265,7 +413,7 @@ declare module '@polkadot/api-base/types/calls' {
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0x37c8bb1350a9a2a8/1 */
+    /** 0x37c8bb1350a9a2a8/4 */
     transactionPaymentApi: {
       /**
        * The transaction fee details
@@ -275,12 +423,20 @@ declare module '@polkadot/api-base/types/calls' {
        * The transaction info
        **/
       queryInfo: AugmentedCall<ApiType, (uxt: Extrinsic | IExtrinsic | string | Uint8Array, len: u32 | AnyNumber | Uint8Array) => Observable<RuntimeDispatchInfo>>;
+      /**
+       * Query the output of the current LengthToFee given some input
+       **/
+      queryLengthToFee: AugmentedCall<ApiType, (length: u32 | AnyNumber | Uint8Array) => Observable<Balance>>;
+      /**
+       * Query the output of the current WeightToFee given some input
+       **/
+      queryWeightToFee: AugmentedCall<ApiType, (weight: Weight | { refTime?: any; proofSize?: any } | string | Uint8Array) => Observable<Balance>>;
       /**
        * Generic call
        **/
       [key: string]: DecoratedCallBase<ApiType>;
     };
-    /** 0xf3ff14d5ab527059/1 */
+    /** 0xf3ff14d5ab527059/3 */
     transactionPaymentCallApi: {
       /**
        * The call fee details
@@ -290,6 +446,25 @@ declare module '@polkadot/api-base/types/calls' {
        * The call info
        **/
       queryCallInfo: AugmentedCall<ApiType, (call: Call | IMethod | string | Uint8Array, len: u32 | AnyNumber | Uint8Array) => Observable<RuntimeDispatchInfo>>;
+      /**
+       * Query the output of the current LengthToFee given some input
+       **/
+      queryLengthToFee: AugmentedCall<ApiType, (length: u32 | AnyNumber | Uint8Array) => Observable<Balance>>;
+      /**
+       * Query the output of the current WeightToFee given some input
+       **/
+      queryWeightToFee: AugmentedCall<ApiType, (weight: Weight | { refTime?: any; proofSize?: any } | string | Uint8Array) => Observable<Balance>>;
+      /**
+       * Generic call
+       **/
+      [key: string]: DecoratedCallBase<ApiType>;
+    };
+    /** 0xbe9fb0c91a8046cf/1 */
+    validateStatement: {
+      /**
+       * Validate the statement.
+       **/
+      valdateStatement: AugmentedCall<ApiType, (source: StatementStoreStatementSource | 'Chain' | 'Network' | 'Local' | number | Uint8Array, statement: SpStatementStoreStatement | { proof?: any; decryptionKey?: any; channel?: any; priority?: any; numTopics?: any; topics?: any; data?: any } | string | Uint8Array) => Observable<Result<StatementStoreValidStatement, StatementStoreInvalidStatement>>>;
       /**
        * Generic call
        **/

packages/api-augment/tsconfig.build.json

@@ -7,6 +7,7 @@
   },
   "exclude": [
     "**/*.spec.ts",
+    "**/mod.ts",
     "**/kusama/*.ts",
     "**/polkadot/*.ts"
   ],
@@ -15,7 +16,6 @@
     { "path": "../rpc-augment/tsconfig.build.json" },
     { "path": "../types/tsconfig.build.json" },
     { "path": "../types-codec/tsconfig.build.json" },
-    { "path": "../types-augment/tsconfig.build.json" },
-    { "path": "../types-support/tsconfig.build.json" }
+    { "path": "../types-augment/tsconfig.build.json" }
   ]
 }

packages/api-augment/tsconfig.kusama.spec.json

@@ -1,22 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "baseUrl": "..",
-    "outDir": "./build",
-    "rootDir": "./src",
-    "emitDeclarationOnly": false,
-    "noEmit": true
-  },
-  "include": [
-    "**/kusama/*.spec.ts"
-  ],
-  "references": [
-    { "path": "../api-augment/tsconfig.build.json" },
-    { "path": "../api-augment/tsconfig.kusama.json" },
-    { "path": "../api-base/tsconfig.build.json" },
-    { "path": "../rpc-augment/tsconfig.build.json" },
-    { "path": "../types/tsconfig.build.json" },
-    { "path": "../types-augment/tsconfig.build.json" },
-    { "path": "../types-support/tsconfig.build.json" }
-  ]
-}

packages/api-base/LICENSE

@@ -1,201 +0,0 @@
-                              Apache License
-                        Version 2.0, January 2004
-                    http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-  "License" shall mean the terms and conditions for use, reproduction,
-  and distribution as defined by Sections 1 through 9 of this document.
-
-  "Licensor" shall mean the copyright owner or entity authorized by
-  the copyright owner that is granting the License.
-
-  "Legal Entity" shall mean the union of the acting entity and all
-  other entities that control, are controlled by, or are under common
-  control with that entity. For the purposes of this definition,
-  "control" means (i) the power, direct or indirect, to cause the
-  direction or management of such entity, whether by contract or
-  otherwise, or (ii) ownership of fifty percent (50%) or more of the
-  outstanding shares, or (iii) beneficial ownership of such entity.
-
-  "You" (or "Your") shall mean an individual or Legal Entity
-  exercising permissions granted by this License.
-
-  "Source" form shall mean the preferred form for making modifications,
-  including but not limited to software source code, documentation
-  source, and configuration files.
-
-  "Object" form shall mean any form resulting from mechanical
-  transformation or translation of a Source form, including but
-  not limited to compiled object code, generated documentation,
-  and conversions to other media types.
-
-  "Work" shall mean the work of authorship, whether in Source or
-  Object form, made available under the License, as indicated by a
-  copyright notice that is included in or attached to the work
-  (an example is provided in the Appendix below).
-
-  "Derivative Works" shall mean any work, whether in Source or Object
-  form, that is based on (or derived from) the Work and for which the
-  editorial revisions, annotations, elaborations, or other modifications
-  represent, as a whole, an original work of authorship. For the purposes
-  of this License, Derivative Works shall not include works that remain
-  separable from, or merely link (or bind by name) to the interfaces of,
-  the Work and Derivative Works thereof.
-
-  "Contribution" shall mean any work of authorship, including
-  the original version of the Work and any modifications or additions
-  to that Work or Derivative Works thereof, that is intentionally
-  submitted to Licensor for inclusion in the Work by the copyright owner
-  or by an individual or Legal Entity authorized to submit on behalf of
-  the copyright owner. For the purposes of this definition, "submitted"
-  means any form of electronic, verbal, or written communication sent
-  to the Licensor or its representatives, including but not limited to
-  communication on electronic mailing lists, source code control systems,
-  and issue tracking systems that are managed by, or on behalf of, the
-  Licensor for the purpose of discussing and improving the Work, but
-  excluding communication that is conspicuously marked or otherwise
-  designated in writing by the copyright owner as "Not a Contribution."
-
-  "Contributor" shall mean Licensor and any individual or Legal Entity
-  on behalf of whom a Contribution has been received by Licensor and
-  subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  copyright license to reproduce, prepare Derivative Works of,
-  publicly display, publicly perform, sublicense, and distribute the
-  Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  (except as stated in this section) patent license to make, have made,
-  use, offer to sell, sell, import, and otherwise transfer the Work,
-  where such license applies only to those patent claims licensable
-  by such Contributor that are necessarily infringed by their
-  Contribution(s) alone or by combination of their Contribution(s)
-  with the Work to which such Contribution(s) was submitted. If You
-  institute patent litigation against any entity (including a
-  cross-claim or counterclaim in a lawsuit) alleging that the Work
-  or a Contribution incorporated within the Work constitutes direct
-  or contributory patent infringement, then any patent licenses
-  granted to You under this License for that Work shall terminate
-  as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the
-  Work or Derivative Works thereof in any medium, with or without
-  modifications, and in Source or Object form, provided that You
-  meet the following conditions:
-
-  (a) You must give any other recipients of the Work or
-      Derivative Works a copy of this License; and
-
-  (b) You must cause any modified files to carry prominent notices
-      stating that You changed the files; and
-
-  (c) You must retain, in the Source form of any Derivative Works
-      that You distribute, all copyright, patent, trademark, and
-      attribution notices from the Source form of the Work,
-      excluding those notices that do not pertain to any part of
-      the Derivative Works; and
-
-  (d) If the Work includes a "NOTICE" text file as part of its
-      distribution, then any Derivative Works that You distribute must
-      include a readable copy of the attribution notices contained
-      within such NOTICE file, excluding those notices that do not
-      pertain to any part of the Derivative Works, in at least one
-      of the following places: within a NOTICE text file distributed
-      as part of the Derivative Works; within the Source form or
-      documentation, if provided along with the Derivative Works; or,
-      within a display generated by the Derivative Works, if and
-      wherever such third-party notices normally appear. The contents
-      of the NOTICE file are for informational purposes only and
-      do not modify the License. You may add Your own attribution
-      notices within Derivative Works that You distribute, alongside
-      or as an addendum to the NOTICE text from the Work, provided
-      that such additional attribution notices cannot be construed
-      as modifying the License.
-
-  You may add Your own copyright statement to Your modifications and
-  may provide additional or different license terms and conditions
-  for use, reproduction, or distribution of Your modifications, or
-  for any such Derivative Works as a whole, provided Your use,
-  reproduction, and distribution of the Work otherwise complies with
-  the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise,
-  any Contribution intentionally submitted for inclusion in the Work
-  by You to the Licensor shall be under the terms and conditions of
-  this License, without any additional terms or conditions.
-  Notwithstanding the above, nothing herein shall supersede or modify
-  the terms of any separate license agreement you may have executed
-  with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade
-  names, trademarks, service marks, or product names of the Licensor,
-  except as required for reasonable and customary use in describing the
-  origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or
-  agreed to in writing, Licensor provides the Work (and each
-  Contributor provides its Contributions) on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-  implied, including, without limitation, any warranties or conditions
-  of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-  PARTICULAR PURPOSE. You are solely responsible for determining the
-  appropriateness of using or redistributing the Work and assume any
-  risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory,
-  whether in tort (including negligence), contract, or otherwise,
-  unless required by applicable law (such as deliberate and grossly
-  negligent acts) or agreed to in writing, shall any Contributor be
-  liable to You for damages, including any direct, indirect, special,
-  incidental, or consequential damages of any character arising as a
-  result of this License or out of the use or inability to use the
-  Work (including but not limited to damages for loss of goodwill,
-  work stoppage, computer failure or malfunction, or any and all
-  other commercial damages or losses), even if such Contributor
-  has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing
-  the Work or Derivative Works thereof, You may choose to offer,
-  and charge a fee for, acceptance of support, warranty, indemnity,
-  or other liability obligations and/or rights consistent with this
-  License. However, in accepting such obligations, You may act only
-  on Your own behalf and on Your sole responsibility, not on behalf
-  of any other Contributor, and only if You agree to indemnify,
-  defend, and hold each Contributor harmless for any liability
-  incurred by, or claims asserted against, such Contributor by reason
-  of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work.
-
-  To apply the Apache License to your work, attach the following
-  boilerplate notice, with the fields enclosed by brackets "[]"
-  replaced with your own identifying information. (Don't include
-  the brackets!)  The text should be enclosed in the appropriate
-  comment syntax for the file format. We also recommend that a
-  file or class name and description of purpose be included on the
-  same "printed page" as the copyright notice for easier
-  identification within third-party archives.
-
-Copyright [yyyy] [name of copyright owner]
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.

packages/api-base/package.json

@@ -1,14 +1,12 @@
 {
   "author": "Jaco Greeff <jacogr@gmail.com>",
   "bugs": "https://github.com/polkadot-js/api/issues",
-  "contributors": [],
   "description": "Interfaces for interacting with contracts and contract ABIs",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18"
   },
   "homepage": "https://github.com/polkadot-js/api/tree/master/packages/api-base#readme",
   "license": "Apache-2.0",
-  "maintainers": [],
   "name": "@polkadot/api-base",
   "repository": {
     "directory": "packages/api-base",
@@ -16,17 +14,17 @@
     "url": "https://github.com/polkadot-js/api.git"
   },
   "sideEffects": [
-    "./detectPackage.js",
-    "./detectPackage.cjs"
+    "./packageDetect.js",
+    "./packageDetect.cjs"
   ],
   "type": "module",
-  "version": "9.2.3",
+  "version": "11.3.1",
   "main": "index.js",
   "dependencies": {
-    "@babel/runtime": "^7.18.9",
-    "@polkadot/rpc-core": "9.2.3",
-    "@polkadot/types": "9.2.3",
-    "@polkadot/util": "^10.1.5",
-    "rxjs": "^7.5.6"
+    "@polkadot/rpc-core": "11.3.1",
+    "@polkadot/types": "11.3.1",
+    "@polkadot/util": "^12.6.2",
+    "rxjs": "^7.8.1",
+    "tslib": "^2.6.2"
   }
 }

packages/api-base/src/bundle.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-export { packageInfo } from './packageInfo';
+export { packageInfo } from './packageInfo.js';

packages/api-base/src/detectOther.ts

@@ -1,7 +0,0 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-import { packageInfo as rpcInfo } from '@polkadot/rpc-core/packageInfo';
-import { packageInfo as typesInfo } from '@polkadot/types/packageInfo';
-
-export default [rpcInfo, typesInfo];

packages/api-base/src/detectPackage.ts

@@ -1,11 +0,0 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-// Do not edit, auto-generated by @polkadot/dev
-
-import { detectPackage } from '@polkadot/util';
-
-import others from './detectOther';
-import { packageInfo } from './packageInfo';
-
-detectPackage(packageInfo, null, others);

packages/api-base/src/index.ts

@@ -1,6 +1,6 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import './detectPackage';
+import './packageDetect.js';
 
-export * from './bundle';
+export * from './bundle.js';

packages/api-base/src/mod.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-export * from './index';
+export * from './index.js';

packages/api-base/src/packageDetect.ts

@@ -0,0 +1,13 @@
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// Do not edit, auto-generated by @polkadot/dev
+// (packageInfo imports will be kept as-is, user-editable)
+
+import { packageInfo as rpcInfo } from '@polkadot/rpc-core/packageInfo';
+import { packageInfo as typesInfo } from '@polkadot/types/packageInfo';
+import { detectPackage } from '@polkadot/util';
+
+import { packageInfo } from './packageInfo.js';
+
+detectPackage(packageInfo, null, [rpcInfo, typesInfo]);

packages/api-base/src/packageInfo.ts

@@ -1,6 +1,6 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 // Do not edit, auto-generated by @polkadot/dev
 
-export const packageInfo = { name: '@polkadot/api-base', path: 'auto', type: 'auto', version: '9.2.3' };
+export const packageInfo = { name: '@polkadot/api-base', path: 'auto', type: 'auto', version: '11.3.1' };

packages/api-base/src/types/api.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Observable } from 'rxjs';
@@ -13,7 +13,7 @@ export interface ApiInterfaceRx {
   call: QueryableCalls<'rxjs'>;
   consts: QueryableConsts<'rxjs'>;
   extrinsicType: number;
-  genesisHash?: Hash;
+  genesisHash?: Hash | undefined;
   hasSubscriptions: boolean;
   registry: Registry;
   runtimeMetadata: Metadata;
@@ -22,7 +22,7 @@ export interface ApiInterfaceRx {
   queryMulti: QueryableStorageMulti<'rxjs'>;
   rpc: DecoratedRpc<'rxjs', RpcInterface>;
   tx: SubmittableExtrinsics<'rxjs'>;
-  signer?: Signer;
+  signer?: Signer | undefined;
 
   callAt: (blockHash: Uint8Array | string, knownVersion?: RuntimeVersion) => Observable<QueryableCalls<'rxjs'>>;
   queryAt: (blockHash: Uint8Array | string, knownVersion?: RuntimeVersion) => Observable<QueryableStorage<'rxjs'>>;

packages/api-base/src/types/base.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Observable } from 'rxjs';
@@ -62,12 +62,17 @@ export interface PaginationOptions<A = unknown> {
   startKey?: string;
 }
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export type DecorateMethod<ApiType extends ApiTypes, T = any> =
+export type DecorateMethod<_ApiType extends ApiTypes, T = any> =
   <M extends (...args: any[]) => Observable<any>>(method: M, options?: DecorateMethodOptions) => T;
 
-type AsCodec<R extends Codec | any> = R extends Codec
+type AsCodec<R> = R extends Codec
   ? R
   : Codec;
 
 export type ReturnCodec<F extends AnyFunction> = AsCodec<ObsInnerType<ReturnType<F>>>;
+
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface EmptyBase<_> {
+  // this is use to allow use to have unused vars in augmented interfaces,
+  // so intentionally left empty
+}

packages/api-base/src/types/calls.ts

@@ -1,31 +1,31 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Observable } from 'rxjs';
 import type { AnyFunction, Codec, DefinitionCallNamed } from '@polkadot/types/types';
-import type { ApiTypes, ReturnCodec } from './base';
+import type { ApiTypes, EmptyBase, ReturnCodec } from './base.js';
 
 export type DecoratedCallBase<ApiType extends ApiTypes, F extends AnyFunction = (...args: any[]) => Observable<Codec>> =
   ApiType extends 'rxjs'
-    ? <T extends Codec | any = ReturnCodec<F>> (...args: Parameters<F>) => Observable<T>
-    : <T extends Codec | any = ReturnCodec<F>> (...args: Parameters<F>) => Promise<T>;
+    ? <T = ReturnCodec<F>> (...args: Parameters<F>) => Observable<T>
+    : <T = ReturnCodec<F>> (...args: Parameters<F>) => Promise<T>;
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export type AugmentedCall<ApiType extends ApiTypes, F extends AnyFunction = (...args: any[]) => Observable<Codec>> =
-DecoratedCallBase<ApiType, F> & { meta: DefinitionCallNamed };
+export type AugmentedCall<ApiType extends ApiTypes, F extends AnyFunction = (...args: any[]) => Observable<Codec>> = DecoratedCallBase<ApiType, F> & {
+  /** The metadata/description/definition for this method */
+  meta: DefinitionCallNamed
+};
 
 // augmented interfaces
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars,@typescript-eslint/no-empty-interface
-export interface AugmentedCalls<ApiType extends ApiTypes> {
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface AugmentedCalls<ApiType extends ApiTypes> extends EmptyBase<ApiType> {
   // augmented
 }
 
+// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 export interface QueryableCalls<ApiType extends ApiTypes> extends AugmentedCalls<ApiType> {
   // when non-augmented, we need to at least have Codec results
   [key: string]: QueryableModuleCalls<ApiType>;
 }
 
-export interface QueryableModuleCalls<ApiType extends ApiTypes> {
-  [key: string]: DecoratedCallBase<ApiType>;
-}
+export type QueryableModuleCalls<ApiType extends ApiTypes> = Record<string, DecoratedCallBase<ApiType>>;

packages/api-base/src/types/consts.ts

@@ -1,27 +1,25 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { PalletConstantMetadataLatest } from '@polkadot/types/interfaces';
 import type { Codec } from '@polkadot/types/types';
-import type { ApiTypes } from './base';
+import type { ApiTypes, EmptyBase } from './base.js';
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export interface AugmentedConst<ApiType extends ApiTypes> {
+export interface AugmentedConst<_ extends ApiTypes> {
   meta: PalletConstantMetadataLatest;
 }
 
 // augmented interfaces
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars,@typescript-eslint/no-empty-interface
-export interface AugmentedConsts<ApiType extends ApiTypes> {
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface AugmentedConsts<ApiType extends ApiTypes> extends EmptyBase<ApiType> {
   // augmented
 }
 
+// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 export interface QueryableConsts<ApiType extends ApiTypes> extends AugmentedConsts<ApiType> {
   // when non-augmented, we need to at least have Codec results
   [key: string]: QueryableModuleConsts;
 }
 
-export interface QueryableModuleConsts {
-  [key: string]: Codec;
-}
+export type QueryableModuleConsts = Record<string, Codec>;

packages/api-base/src/types/derive.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Observable } from 'rxjs';

packages/api-base/src/types/errors.ts

@@ -1,24 +1,22 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { IsError } from '@polkadot/types/metadata/decorate/types';
-import type { ApiTypes } from './base';
+import type { ApiTypes, EmptyBase } from './base.js';
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export type AugmentedError<ApiType extends ApiTypes> = IsError;
+export type AugmentedError<_ extends ApiTypes> = IsError;
 
 // augmented interfaces
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars,@typescript-eslint/no-empty-interface
-export interface AugmentedErrors<ApiType extends ApiTypes> {
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface AugmentedErrors<ApiType extends ApiTypes> extends EmptyBase<ApiType> {
   // augmented
 }
 
+// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 export interface DecoratedErrors<ApiType extends ApiTypes> extends AugmentedErrors<ApiType> {
   // when non-augmented, we need to at least have Codec results
   [key: string]: ModuleErrors<ApiType>;
 }
 
-export interface ModuleErrors<ApiType extends ApiTypes> {
-  [key: string]: AugmentedError<ApiType>;
-}
+export type ModuleErrors<ApiType extends ApiTypes> = Record<string, AugmentedError<ApiType>>;

packages/api-base/src/types/events.ts

@@ -1,25 +1,23 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { IsEvent } from '@polkadot/types/metadata/decorate/types';
 import type { AnyTuple } from '@polkadot/types/types';
-import type { ApiTypes } from './base';
+import type { ApiTypes, EmptyBase } from './base.js';
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export type AugmentedEvent<ApiType extends ApiTypes, T extends AnyTuple = AnyTuple, N = unknown> = IsEvent<T, N>;
+export type AugmentedEvent<_ extends ApiTypes, T extends AnyTuple = AnyTuple, N = unknown> = IsEvent<T, N>;
 
 // augmented interfaces
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars,@typescript-eslint/no-empty-interface
-export interface AugmentedEvents<ApiType extends ApiTypes> {
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface AugmentedEvents<ApiType extends ApiTypes> extends EmptyBase<ApiType> {
   // augmented
 }
 
+// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 export interface DecoratedEvents<ApiType extends ApiTypes> extends AugmentedEvents<ApiType> {
   // when non-augmented, we need to at least have Codec results
   [key: string]: ModuleEvents<ApiType>;
 }
 
-export interface ModuleEvents<ApiType extends ApiTypes> {
-  [key: string]: AugmentedEvent<ApiType>;
-}
+export type ModuleEvents<ApiType extends ApiTypes> = Record<string, AugmentedEvent<ApiType>>;

packages/api-base/src/types/index.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api authors & contributors
+// Copyright 2017-2024 @polkadot/api authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 // These are augmented, do an augmentation export
@@ -10,7 +10,7 @@ export * from '@polkadot/api-base/types/storage';
 export * from '@polkadot/api-base/types/submittable';
 
 // normal exports
-export * from './api';
-export * from './base';
-export * from './derive';
-export * from './rpc';
+export * from './api.js';
+export * from './base.js';
+export * from './derive.js';
+export * from './rpc.js';

packages/api-base/src/types/rpc.ts

@@ -1,10 +1,9 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Observable } from 'rxjs';
-import type { AnyFunction, Callback, DefinitionRpc } from '@polkadot/types/types';
-
-import { ApiTypes, PromiseResult, Push, RxResult, UnsubscribePromise } from './base';
+import type { AnyFunction, AnyJson, Callback, DefinitionRpc } from '@polkadot/types/types';
+import type { ApiTypes, PromiseResult, Push, RxResult, UnsubscribePromise } from './base.js';
 
 export type { AugmentedRpc } from '@polkadot/rpc-core/types';
 
@@ -29,6 +28,8 @@ export type DecoratedRpcSection<ApiType extends ApiTypes, Section> = {
     : never
 }
 
+export type RawRpcType<ApiType extends ApiTypes> = (method: string, ...params: unknown[]) => ApiType extends 'rxjs' ? Observable<AnyJson> : Promise<AnyJson>;
+
 export type DecoratedRpc<ApiType extends ApiTypes, AllSections> = {
   [S in keyof AllSections]: DecoratedRpcSection<ApiType, AllSections[S]>
-}
+} & RawRpcType<ApiType>

packages/api-base/src/types/storage.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Observable } from 'rxjs';
@@ -6,15 +6,13 @@ import type { StorageKey, u64 } from '@polkadot/types';
 import type { Hash } from '@polkadot/types/interfaces';
 import type { StorageEntry } from '@polkadot/types/primitive/types';
 import type { AnyFunction, AnyTuple, Callback, Codec, IStorageKey } from '@polkadot/types/types';
-import type { ApiTypes, DropLast, MethodResult, PaginationOptions, PromiseOrObs, ReturnCodec, UnsubscribePromise } from './base';
+import type { ApiTypes, DropLast, EmptyBase, MethodResult, PaginationOptions, PromiseOrObs, ReturnCodec, UnsubscribePromise } from './base.js';
 
-interface StorageEntryObservableMulti<R extends Codec = Codec> {
-  <T extends Codec = R>(args: (unknown[] | unknown)[]): Observable<T[]>;
-}
+type StorageEntryObservableMulti<R extends Codec = Codec> = <T extends Codec = R>(args: unknown[]) => Observable<T[]>;
 
 interface StorageEntryPromiseMulti<R extends Codec = Codec> {
-  <T extends Codec = R>(args: (unknown[] | unknown)[]): Promise<T[]>;
-  <T extends Codec = R>(args: (unknown[] | unknown)[], callback: Callback<T[]>): UnsubscribePromise;
+  <T extends Codec = R>(args: unknown[]): Promise<T[]>;
+  <T extends Codec = R>(args: unknown[], callback: Callback<T[]>): UnsubscribePromise;
 }
 
 export interface StorageEntryPromiseOverloads {
@@ -48,12 +46,12 @@ export interface StorageEntryBase<ApiType extends ApiTypes, F extends AnyFunctio
   /**
    * @deprecated Use api.at(<blockHash>)
    */
-  at: <T extends Codec | any = ReturnCodec<F>>(hash: Hash | Uint8Array | string, ...args: Parameters<F>) => PromiseOrObs<ApiType, T>;
+  at: <T = ReturnCodec<F>>(hash: Hash | Uint8Array | string, ...args: Parameters<F>) => PromiseOrObs<ApiType, T>;
   creator: StorageEntry;
   /**
    * @deprecated Use api.at(<blockHash>)
    */
-  entriesAt: <T extends Codec | any = ReturnCodec<F>, K extends AnyTuple = A>(hash: Hash | Uint8Array | string, ...args: DropLast<Parameters<F>>) => PromiseOrObs<ApiType, [StorageKey<K>, T][]>;
+  entriesAt: <T = ReturnCodec<F>, K extends AnyTuple = A>(hash: Hash | Uint8Array | string, ...args: DropLast<Parameters<F>>) => PromiseOrObs<ApiType, [StorageKey<K>, T][]>;
   /**
    * @deprecated Use api.at(<blockHash>)
    */
@@ -68,8 +66,8 @@ export interface StorageEntryBase<ApiType extends ApiTypes, F extends AnyFunctio
 }
 
 export interface StorageEntryBaseAt<ApiType extends ApiTypes, F extends AnyFunction, A extends AnyTuple = AnyTuple> {
-  entries: <T extends Codec | any = ReturnCodec<F>, K extends AnyTuple = A>(...args: DropLast<Parameters<F>>) => PromiseOrObs<ApiType, [StorageKey<K>, T][]>;
-  entriesPaged: <T extends Codec | any = ReturnCodec<F>, K extends AnyTuple = A>(opts: PaginationOptions<Parameters<F>[0]>) => PromiseOrObs<ApiType, [StorageKey<K>, T][]>;
+  entries: <T = ReturnCodec<F>, K extends AnyTuple = A>(...args: DropLast<Parameters<F>>) => PromiseOrObs<ApiType, [StorageKey<K>, T][]>;
+  entriesPaged: <T = ReturnCodec<F>, K extends AnyTuple = A>(opts: PaginationOptions<Parameters<F>[0]>) => PromiseOrObs<ApiType, [StorageKey<K>, T][]>;
   hash: (...args: Parameters<F>) => PromiseOrObs<ApiType, Hash>;
   is: (key: IStorageKey<AnyTuple>) => key is IStorageKey<A>;
   key: (...args: Parameters<F>) => string;
@@ -79,21 +77,15 @@ export interface StorageEntryBaseAt<ApiType extends ApiTypes, F extends AnyFunct
   size: (...args: Parameters<F>) => PromiseOrObs<ApiType, u64>;
 }
 
-export interface QueryableModuleStorage<ApiType extends ApiTypes> {
-  [key: string]: QueryableStorageEntry<ApiType, AnyTuple>;
-}
+export type QueryableModuleStorage<ApiType extends ApiTypes> = Record<string, QueryableStorageEntry<ApiType, AnyTuple>>;
 
-export interface QueryableModuleStorageAt<ApiType extends ApiTypes> {
-  [key: string]: QueryableStorageEntryAt<ApiType, AnyTuple>;
-}
+export type QueryableModuleStorageAt<ApiType extends ApiTypes> = Record<string, QueryableStorageEntryAt<ApiType, AnyTuple>>;
 
 export type QueryableStorageMultiArg<ApiType extends ApiTypes> =
   QueryableStorageEntry<ApiType> |
   [QueryableStorageEntry<ApiType>, ...unknown[]];
 
-export interface QueryableStorageMultiBase<ApiType extends ApiTypes> {
-  <T extends Codec[]>(calls: QueryableStorageMultiArg<ApiType>[]): Observable<T>;
-}
+export type QueryableStorageMultiBase<ApiType extends ApiTypes> = <T extends Codec[]>(calls: QueryableStorageMultiArg<ApiType>[]) => Observable<T>;
 
 export interface QueryableStorageMultiPromise<ApiType extends ApiTypes> {
   <T extends Codec[]>(calls: QueryableStorageMultiArg<ApiType>[], callback: Callback<T>): UnsubscribePromise;
@@ -114,16 +106,18 @@ export type AugmentedQueryDoubleMap<ApiType extends ApiTypes, F extends AnyFunct
 
 // augmented interfaces
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars,@typescript-eslint/no-empty-interface
-export interface AugmentedQueries<ApiType extends ApiTypes> {
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface AugmentedQueries<ApiType extends ApiTypes> extends EmptyBase<ApiType> {
   // augmented
 }
 
+// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 export interface QueryableStorage<ApiType extends ApiTypes> extends AugmentedQueries<ApiType> {
   // when non-augmented, we need to at least have Codec results
   [key: string]: QueryableModuleStorage<ApiType>;
 }
 
+// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 export interface QueryableStorageAt<ApiType extends ApiTypes> extends AugmentedQueries<ApiType> {
   [key: string]: QueryableModuleStorageAt<ApiType>;
 }

packages/api-base/src/types/submittable.ts

@@ -1,10 +1,10 @@
-// Copyright 2017-2022 @polkadot/api-base authors & contributors
+// Copyright 2017-2024 @polkadot/api-base authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Observable } from 'rxjs';
-import type { AccountId, Address, ApplyExtrinsicResult, Call, DispatchError, DispatchInfo, EventRecord, Extrinsic, ExtrinsicStatus, Hash, RuntimeDispatchInfo } from '@polkadot/types/interfaces';
-import type { AnyFunction, AnyNumber, AnyTuple, Callback, CallBase, Codec, IExtrinsicEra, IKeyringPair, ISubmittableResult, Signer } from '@polkadot/types/types';
-import type { ApiTypes, PromiseOrObs } from './base';
+import type { AccountId, Address, ApplyExtrinsicResult, BlockNumber, Call, DispatchError, DispatchInfo, EventRecord, Extrinsic, ExtrinsicStatus, Hash, RuntimeDispatchInfo } from '@polkadot/types/interfaces';
+import type { AnyFunction, AnyNumber, AnyTuple, AnyU8a, Callback, CallBase, Codec, IExtrinsicEra, IKeyringPair, ISubmittableResult, Signer } from '@polkadot/types/types';
+import type { ApiTypes, EmptyBase, PromiseOrObs } from './base.js';
 
 export type AugmentedSubmittable<T extends AnyFunction, A extends AnyTuple = AnyTuple> = T & CallBase<A>;
 
@@ -16,7 +16,9 @@ export interface SignerOptions {
   nonce: AnyNumber | Codec;
   signer?: Signer;
   tip?: AnyNumber;
-  assetId?: AnyNumber;
+  assetId?: AnyNumber | object;
+  mode?: AnyNumber;
+  metadataHash?: AnyU8a;
 }
 
 export type SubmittableDryRunResult<ApiType extends ApiTypes> =
@@ -40,16 +42,22 @@ export type SubmittablePaymentResult<ApiType extends ApiTypes> =
     : Promise<RuntimeDispatchInfo>;
 
 export interface SubmittableResultValue {
-  dispatchError?: DispatchError;
-  dispatchInfo?: DispatchInfo;
+  dispatchError?: DispatchError | undefined;
+  dispatchInfo?: DispatchInfo | undefined;
   events?: EventRecord[];
-  internalError?: Error;
+  internalError?: Error | undefined;
   status: ExtrinsicStatus;
   txHash: Hash;
-  txIndex?: number;
+  txIndex?: number | undefined;
+  blockNumber?: BlockNumber;
 }
 
 export interface SubmittableExtrinsic<ApiType extends ApiTypes, R extends ISubmittableResult = ISubmittableResult> extends Extrinsic {
+  /** true if api.rpc.system.dryRun is available, enabling dryRun(...) */
+  hasDryRun: boolean;
+  /** true if api.call.transactionPaymentApi.queryInfo is available, enabling paymentInfo(...)  */
+  hasPaymentInfo: boolean;
+
   dryRun (account: AddressOrPair, options?: Partial<SignerOptions>): SubmittableDryRunResult<ApiType>;
 
   paymentInfo (account: AddressOrPair, options?: Partial<SignerOptions>): SubmittablePaymentResult<ApiType>;
@@ -75,8 +83,8 @@ export interface SubmittableExtrinsicFunction<ApiType extends ApiTypes, A extend
 
 // augmented interfaces
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars,@typescript-eslint/no-empty-interface
-export interface AugmentedSubmittables<ApiType extends ApiTypes> {
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface AugmentedSubmittables<ApiType extends ApiTypes> extends EmptyBase<ApiType> {
   // augmented
 }
 
@@ -86,7 +94,4 @@ export interface SubmittableExtrinsics<ApiType extends ApiTypes> extends Augment
   [key: string]: SubmittableModuleExtrinsics<ApiType>;
 }
 
-export interface SubmittableModuleExtrinsics<ApiType extends ApiTypes> {
-  // only with is<Type> augmentation
-  [key: string]: SubmittableExtrinsicFunction<ApiType>;
-}
+export type SubmittableModuleExtrinsics<ApiType extends ApiTypes> = Record<string, SubmittableExtrinsicFunction<ApiType>>;

packages/api-base/tsconfig.build.json

@@ -5,6 +5,9 @@
     "outDir": "./build",
     "rootDir": "./src"
   },
+  "exclude": [
+    "**/mod.ts"
+  ],
   "references": [
     { "path": "../rpc-core/tsconfig.build.json" },
     { "path": "../types/tsconfig.build.json" }

packages/api-contract/LICENSE

@@ -1,201 +0,0 @@
-                              Apache License
-                        Version 2.0, January 2004
-                    http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-  "License" shall mean the terms and conditions for use, reproduction,
-  and distribution as defined by Sections 1 through 9 of this document.
-
-  "Licensor" shall mean the copyright owner or entity authorized by
-  the copyright owner that is granting the License.
-
-  "Legal Entity" shall mean the union of the acting entity and all
-  other entities that control, are controlled by, or are under common
-  control with that entity. For the purposes of this definition,
-  "control" means (i) the power, direct or indirect, to cause the
-  direction or management of such entity, whether by contract or
-  otherwise, or (ii) ownership of fifty percent (50%) or more of the
-  outstanding shares, or (iii) beneficial ownership of such entity.
-
-  "You" (or "Your") shall mean an individual or Legal Entity
-  exercising permissions granted by this License.
-
-  "Source" form shall mean the preferred form for making modifications,
-  including but not limited to software source code, documentation
-  source, and configuration files.
-
-  "Object" form shall mean any form resulting from mechanical
-  transformation or translation of a Source form, including but
-  not limited to compiled object code, generated documentation,
-  and conversions to other media types.
-
-  "Work" shall mean the work of authorship, whether in Source or
-  Object form, made available under the License, as indicated by a
-  copyright notice that is included in or attached to the work
-  (an example is provided in the Appendix below).
-
-  "Derivative Works" shall mean any work, whether in Source or Object
-  form, that is based on (or derived from) the Work and for which the
-  editorial revisions, annotations, elaborations, or other modifications
-  represent, as a whole, an original work of authorship. For the purposes
-  of this License, Derivative Works shall not include works that remain
-  separable from, or merely link (or bind by name) to the interfaces of,
-  the Work and Derivative Works thereof.
-
-  "Contribution" shall mean any work of authorship, including
-  the original version of the Work and any modifications or additions
-  to that Work or Derivative Works thereof, that is intentionally
-  submitted to Licensor for inclusion in the Work by the copyright owner
-  or by an individual or Legal Entity authorized to submit on behalf of
-  the copyright owner. For the purposes of this definition, "submitted"
-  means any form of electronic, verbal, or written communication sent
-  to the Licensor or its representatives, including but not limited to
-  communication on electronic mailing lists, source code control systems,
-  and issue tracking systems that are managed by, or on behalf of, the
-  Licensor for the purpose of discussing and improving the Work, but
-  excluding communication that is conspicuously marked or otherwise
-  designated in writing by the copyright owner as "Not a Contribution."
-
-  "Contributor" shall mean Licensor and any individual or Legal Entity
-  on behalf of whom a Contribution has been received by Licensor and
-  subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  copyright license to reproduce, prepare Derivative Works of,
-  publicly display, publicly perform, sublicense, and distribute the
-  Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  (except as stated in this section) patent license to make, have made,
-  use, offer to sell, sell, import, and otherwise transfer the Work,
-  where such license applies only to those patent claims licensable
-  by such Contributor that are necessarily infringed by their
-  Contribution(s) alone or by combination of their Contribution(s)
-  with the Work to which such Contribution(s) was submitted. If You
-  institute patent litigation against any entity (including a
-  cross-claim or counterclaim in a lawsuit) alleging that the Work
-  or a Contribution incorporated within the Work constitutes direct
-  or contributory patent infringement, then any patent licenses
-  granted to You under this License for that Work shall terminate
-  as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the
-  Work or Derivative Works thereof in any medium, with or without
-  modifications, and in Source or Object form, provided that You
-  meet the following conditions:
-
-  (a) You must give any other recipients of the Work or
-      Derivative Works a copy of this License; and
-
-  (b) You must cause any modified files to carry prominent notices
-      stating that You changed the files; and
-
-  (c) You must retain, in the Source form of any Derivative Works
-      that You distribute, all copyright, patent, trademark, and
-      attribution notices from the Source form of the Work,
-      excluding those notices that do not pertain to any part of
-      the Derivative Works; and
-
-  (d) If the Work includes a "NOTICE" text file as part of its
-      distribution, then any Derivative Works that You distribute must
-      include a readable copy of the attribution notices contained
-      within such NOTICE file, excluding those notices that do not
-      pertain to any part of the Derivative Works, in at least one
-      of the following places: within a NOTICE text file distributed
-      as part of the Derivative Works; within the Source form or
-      documentation, if provided along with the Derivative Works; or,
-      within a display generated by the Derivative Works, if and
-      wherever such third-party notices normally appear. The contents
-      of the NOTICE file are for informational purposes only and
-      do not modify the License. You may add Your own attribution
-      notices within Derivative Works that You distribute, alongside
-      or as an addendum to the NOTICE text from the Work, provided
-      that such additional attribution notices cannot be construed
-      as modifying the License.
-
-  You may add Your own copyright statement to Your modifications and
-  may provide additional or different license terms and conditions
-  for use, reproduction, or distribution of Your modifications, or
-  for any such Derivative Works as a whole, provided Your use,
-  reproduction, and distribution of the Work otherwise complies with
-  the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise,
-  any Contribution intentionally submitted for inclusion in the Work
-  by You to the Licensor shall be under the terms and conditions of
-  this License, without any additional terms or conditions.
-  Notwithstanding the above, nothing herein shall supersede or modify
-  the terms of any separate license agreement you may have executed
-  with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade
-  names, trademarks, service marks, or product names of the Licensor,
-  except as required for reasonable and customary use in describing the
-  origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or
-  agreed to in writing, Licensor provides the Work (and each
-  Contributor provides its Contributions) on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-  implied, including, without limitation, any warranties or conditions
-  of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-  PARTICULAR PURPOSE. You are solely responsible for determining the
-  appropriateness of using or redistributing the Work and assume any
-  risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory,
-  whether in tort (including negligence), contract, or otherwise,
-  unless required by applicable law (such as deliberate and grossly
-  negligent acts) or agreed to in writing, shall any Contributor be
-  liable to You for damages, including any direct, indirect, special,
-  incidental, or consequential damages of any character arising as a
-  result of this License or out of the use or inability to use the
-  Work (including but not limited to damages for loss of goodwill,
-  work stoppage, computer failure or malfunction, or any and all
-  other commercial damages or losses), even if such Contributor
-  has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing
-  the Work or Derivative Works thereof, You may choose to offer,
-  and charge a fee for, acceptance of support, warranty, indemnity,
-  or other liability obligations and/or rights consistent with this
-  License. However, in accepting such obligations, You may act only
-  on Your own behalf and on Your sole responsibility, not on behalf
-  of any other Contributor, and only if You agree to indemnify,
-  defend, and hold each Contributor harmless for any liability
-  incurred by, or claims asserted against, such Contributor by reason
-  of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work.
-
-  To apply the Apache License to your work, attach the following
-  boilerplate notice, with the fields enclosed by brackets "[]"
-  replaced with your own identifying information. (Don't include
-  the brackets!)  The text should be enclosed in the appropriate
-  comment syntax for the file format. We also recommend that a
-  file or class name and description of purpose be included on the
-  same "printed page" as the copyright notice for easier
-  identification within third-party archives.
-
-Copyright [yyyy] [name of copyright owner]
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.

packages/api-contract/package.json

@@ -1,14 +1,12 @@
 {
   "author": "Jaco Greeff <jacogr@gmail.com>",
   "bugs": "https://github.com/polkadot-js/api/issues",
-  "contributors": [],
   "description": "Interfaces for interacting with contracts and contract ABIs",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18"
   },
   "homepage": "https://github.com/polkadot-js/api/tree/master/packages/api-contract#readme",
   "license": "Apache-2.0",
-  "maintainers": [],
   "name": "@polkadot/api-contract",
   "repository": {
     "directory": "packages/api-contract",
@@ -16,24 +14,26 @@
     "url": "https://github.com/polkadot-js/api.git"
   },
   "sideEffects": [
-    "./detectPackage.js",
-    "./detectPackage.cjs"
+    "./packageDetect.js",
+    "./packageDetect.cjs"
   ],
   "type": "module",
-  "version": "9.2.3",
+  "version": "11.3.1",
   "main": "index.js",
   "dependencies": {
-    "@babel/runtime": "^7.18.9",
-    "@polkadot/api": "9.2.3",
-    "@polkadot/types": "9.2.3",
-    "@polkadot/types-codec": "9.2.3",
-    "@polkadot/types-create": "9.2.3",
-    "@polkadot/util": "^10.1.5",
-    "@polkadot/util-crypto": "^10.1.5",
-    "rxjs": "^7.5.6"
+    "@polkadot/api": "11.3.1",
+    "@polkadot/api-augment": "11.3.1",
+    "@polkadot/types": "11.3.1",
+    "@polkadot/types-codec": "11.3.1",
+    "@polkadot/types-create": "11.3.1",
+    "@polkadot/util": "^12.6.2",
+    "@polkadot/util-crypto": "^12.6.2",
+    "rxjs": "^7.8.1",
+    "tslib": "^2.6.2"
   },
   "devDependencies": {
-    "@polkadot/api-augment": "9.2.3",
-    "@polkadot/keyring": "^10.1.5"
+    "@polkadot/api-augment": "11.3.1",
+    "@polkadot/keyring": "^12.6.2",
+    "@polkadot/types-support": "11.3.1"
   }
 }

packages/api-contract/src/Abi/Abi.spec.ts

@@ -1,16 +1,20 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
+/// <reference types="@polkadot/dev-test/globals.d.ts" />
+
 import type { Registry } from '@polkadot/types/types';
 
-import fs from 'fs';
-import path from 'path';
+import fs from 'node:fs';
+import process from 'node:process';
 
 import { TypeDefInfo } from '@polkadot/types/types';
+import rpcMetadata from '@polkadot/types-support/metadata/static-substrate-contracts-node';
 import { blake2AsHex } from '@polkadot/util-crypto';
 
-import abis from '../test/contracts';
-import { Abi } from '.';
+import { Metadata, TypeRegistry } from '../../../types/src/bundle.js';
+import abis from '../test/contracts/index.js';
+import { Abi } from './index.js';
 
 interface SpecDef {
   messages: {
@@ -35,12 +39,15 @@ interface JSONAbi {
   },
   V3: {
     spec: SpecDef;
+  },
+  V4: {
+    spec: SpecDef;
   }
 }
 
 function stringifyInfo (key: string, value: unknown): unknown {
-  return key === 'info'
-    ? TypeDefInfo[value as number]
+  return key === 'info' && typeof value === 'number'
+    ? TypeDefInfo[value]
     : value;
 }
 
@@ -59,7 +66,7 @@ describe('Abi', (): void => {
 
       it(`initializes from a contract ABI (${abiName})`, (): void => {
         try {
-          const messageIds = (abi.V3 || abi.V2 || abi.V1 || abi).spec.messages.map(({ label, name }) =>
+          const messageIds = (abi.V4 || abi.V3 || abi.V2 || abi.V1 || abi).spec.messages.map(({ label, name }) =>
             label || (
               Array.isArray(name)
                 ? name.join('::')
@@ -79,31 +86,34 @@ describe('Abi', (): void => {
   });
 
   describe('TypeDef', (): void => {
-    Object.keys(abis).forEach((abiName) => {
-      it(`initializes from a contract ABI (${abiName})`, (): void => {
-        const abi = new Abi(abis[abiName]);
-        const json = stringifyJson(abi.registry);
-        const cmpPath = path.join(__dirname, `../test/compare/${abiName}.test.json`);
+    for (const [abiName, abiJson] of Object.entries(abis)) {
+      it(`initializes from a contract ABI: ${abiName}`, (): void => {
+        const abi = new Abi(abiJson);
+        const registryJson = stringifyJson(abi.registry);
+        const cmpFile = new URL(`../test/compare/${abiName}.test.json`, import.meta.url);
 
         try {
-          // eslint-disable-next-line @typescript-eslint/no-var-requires
-          expect(JSON.parse(json)).toEqual(require(cmpPath));
+          expect(
+            JSON.parse(registryJson)
+          ).toEqual(
+            JSON.parse(fs.readFileSync(cmpFile, 'utf-8'))
+          );
         } catch (error) {
-          if (process.env.GITHUB_REPOSITORY) {
-            console.error(json);
+          if (process.env['GITHUB_REPOSITORY']) {
+            console.error(registryJson);
 
             throw error;
           }
 
-          fs.writeFileSync(cmpPath, json, { flag: 'w' });
+          fs.writeFileSync(cmpFile, registryJson, { flag: 'w' });
         }
       });
-    });
+    }
   });
 
   it('has the correct hash for the source', (): void => {
-    const abi = new Abi(abis.ink_v0_flipperBundle);
-    const bundle = abis.ink_v0_flipperBundle as unknown as JSONAbi;
+    const abi = new Abi(abis['ink_v0_flipperBundle']);
+    const bundle = abis['ink_v0_flipperBundle'] as unknown as JSONAbi;
 
     // manual
     expect(bundle.source.hash).toEqual(blake2AsHex(bundle.source.wasm));
@@ -114,4 +124,112 @@ describe('Abi', (): void => {
     // the hash as per the actual Abi
     expect(bundle.source.hash).toEqual(abi.info.source.wasmHash.toHex());
   });
+
+  describe('Events', (): void => {
+    const registry = new TypeRegistry();
+
+    beforeAll((): void => {
+      const metadata = new Metadata(registry, rpcMetadata);
+
+      registry.setMetadata(metadata);
+    });
+
+    it('decoding <=ink!v4 event', (): void => {
+      const abiJson = abis['ink_v4_erc20Metadata'];
+
+      expect(abiJson).toBeDefined();
+      const abi = new Abi(abiJson);
+
+      const eventRecordHex =
+      '0x0001000000080360951b8baf569bca905a279c12d6ce17db7cdce23a42563870ef585129ce5dc64d010001d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d018eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a4800505a4f7e9f4eb106000000000000000c0045726332303a3a5472616e7366657200000000000000000000000000000000da2d695d3b5a304e0039e7fc4419c34fa0c1f239189c99bb72a6484f1634782b2b00c7d40fe6d84d660f3e6bed90f218e022a0909f7e1a7ea35ada8b6e003564';
+      const record = registry.createType('EventRecord', eventRecordHex);
+
+      const decodedEvent = abi.decodeEvent(record);
+
+      expect(decodedEvent.event.args.length).toEqual(3);
+      expect(decodedEvent.args.length).toEqual(3);
+      expect(decodedEvent.event.identifier).toEqual('Transfer');
+
+      const decodedEventHuman = decodedEvent.event.args.reduce((prev, cur, index) => {
+        return {
+          ...prev,
+          [cur.name]: decodedEvent.args[index].toHuman()
+        };
+      }, {});
+
+      const expectedEvent = {
+        from: '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY',
+        to: '5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty',
+        value: '123.4567 MUnit'
+      };
+
+      expect(decodedEventHuman).toEqual(expectedEvent);
+    });
+
+    it('decoding >=ink!v5 event', (): void => {
+      const abiJson = abis['ink_v5_erc20Metadata'];
+
+      expect(abiJson).toBeDefined();
+      const abi = new Abi(abiJson);
+
+      const eventRecordHex =
+    '0x00010000000803da17150e96b3955a4db6ad35ddeb495f722f9c1d84683113bfb096bf3faa30f2490101d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d018eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a4800505a4f7e9f4eb106000000000000000cb5b61a3e6a21a16be4f044b517c28ac692492f73c5bfd3f60178ad98c767f4cbd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a48';
+      const record = registry.createType('EventRecord', eventRecordHex);
+
+      const decodedEvent = abi.decodeEvent(record);
+
+      expect(decodedEvent.event.args.length).toEqual(3);
+      expect(decodedEvent.args.length).toEqual(3);
+      expect(decodedEvent.event.identifier).toEqual('erc20::erc20::Transfer');
+
+      const decodedEventHuman = decodedEvent.event.args.reduce((prev, cur, index) => {
+        return {
+          ...prev,
+          [cur.name]: decodedEvent.args[index].toHuman()
+        };
+      }, {});
+
+      const expectedEvent = {
+        from: '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY',
+        to: '5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty',
+        value: '123.4567 MUnit'
+      };
+
+      expect(decodedEventHuman).toEqual(expectedEvent);
+    });
+
+    it('decoding >=ink!v5 anonymous event', (): void => {
+      const abiJson = abis['ink_v5_erc20AnonymousTransferMetadata'];
+
+      expect(abiJson).toBeDefined();
+      const abi = new Abi(abiJson);
+
+      expect(abi.events[0].identifier).toEqual('erc20::erc20::Transfer');
+      expect(abi.events[0].signatureTopic).toEqual(null);
+
+      const eventRecordWithAnonymousEventHex = '0x00010000000803538e726248a9c155911e7d99f4f474c3408630a2f6275dd501d4471c7067ad2c490101d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d018eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a4800505a4f7e9f4eb1060000000000000008d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a48';
+      const record = registry.createType('EventRecord', eventRecordWithAnonymousEventHex);
+
+      const decodedEvent = abi.decodeEvent(record);
+
+      expect(decodedEvent.event.args.length).toEqual(3);
+      expect(decodedEvent.args.length).toEqual(3);
+      expect(decodedEvent.event.identifier).toEqual('erc20::erc20::Transfer');
+
+      const decodedEventHuman = decodedEvent.event.args.reduce((prev, cur, index) => {
+        return {
+          ...prev,
+          [cur.name]: decodedEvent.args[index].toHuman()
+        };
+      }, {});
+
+      const expectedEvent = {
+        from: '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY',
+        to: '5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty',
+        value: '123.4567 MUnit'
+      };
+
+      expect(decodedEventHuman).toEqual(expectedEvent);
+    });
+  });
 });

packages/api-contract/src/Abi/index.ts

@@ -1,16 +1,26 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import type { Bytes } from '@polkadot/types';
-import type { ChainProperties, ContractConstructorSpecLatest, ContractEventSpecLatest, ContractMessageParamSpecLatest, ContractMessageSpecLatest, ContractMetadata, ContractMetadataLatest, ContractProjectInfo } from '@polkadot/types/interfaces';
-import type { Codec, Registry } from '@polkadot/types/types';
-import type { AbiConstructor, AbiEvent, AbiMessage, AbiParam, DecodedEvent, DecodedMessage } from '../types';
+import type { Bytes, Vec } from '@polkadot/types';
+import type { ChainProperties, ContractConstructorSpecLatest, ContractEventParamSpecLatest, ContractMessageParamSpecLatest, ContractMessageSpecLatest, ContractMetadata, ContractMetadataV4, ContractMetadataV5, ContractProjectInfo, ContractTypeSpec, EventRecord } from '@polkadot/types/interfaces';
+import type { Codec, Registry, TypeDef } from '@polkadot/types/types';
+import type { AbiConstructor, AbiEvent, AbiEventParam, AbiMessage, AbiMessageParam, AbiParam, DecodedEvent, DecodedMessage } from '../types.js';
 
-import { TypeRegistry } from '@polkadot/types';
+import { Option, TypeRegistry } from '@polkadot/types';
 import { TypeDefInfo } from '@polkadot/types-create';
-import { assertReturn, compactAddLength, compactStripLength, isNumber, isObject, isString, logger, stringCamelCase, stringify, u8aConcat, u8aToHex } from '@polkadot/util';
+import { assertReturn, compactAddLength, compactStripLength, isBn, isNumber, isObject, isString, isUndefined, logger, stringCamelCase, stringify, u8aConcat, u8aToHex } from '@polkadot/util';
 
-import { convertVersions, enumVersions } from './toLatest';
+import { convertVersions, enumVersions } from './toLatestCompatible.js';
+
+interface AbiJson {
+  version?: string;
+
+  [key: string]: unknown;
+}
+
+type EventOf<M> = M extends {spec: { events: Vec<infer E>}} ? E : never
+export type ContractMetadataSupported = ContractMetadataV4 | ContractMetadataV5;
+type ContractEventSupported = EventOf<ContractMetadataSupported>;
 
 const l = logger('Abi');
 
@@ -26,27 +36,41 @@ function findMessage <T extends AbiMessage> (list: T[], messageOrId: T | string
   return assertReturn(message, () => `Attempted to call an invalid contract interface, ${stringify(messageOrId)}`);
 }
 
-function getLatestMeta (registry: Registry, json: Record<string, unknown>): ContractMetadataLatest {
+function getMetadata (registry: Registry, json: AbiJson): ContractMetadataSupported {
+  // this is for V1, V2, V3
   const vx = enumVersions.find((v) => isObject(json[v]));
-  const metadata = registry.createType('ContractMetadata',
+
+  // this was added in V4
+  const jsonVersion = json.version;
+
+  if (!vx && jsonVersion && !enumVersions.find((v) => v === `V${jsonVersion}`)) {
+    throw new Error(`Unable to handle version ${jsonVersion}`);
+  }
+
+  const metadata = registry.createType<ContractMetadata>('ContractMetadata',
     vx
       ? { [vx]: json[vx] }
-      : { V0: json }
-  ) as unknown as ContractMetadata;
+      : jsonVersion
+        ? { [`V${jsonVersion}`]: json }
+        : { V0: json }
+  );
+
   const converter = convertVersions.find(([v]) => metadata[`is${v}`]);
 
   if (!converter) {
-    throw new Error(`Unable to convert ABI with version ${metadata.type} to latest`);
+    throw new Error(`Unable to convert ABI with version ${metadata.type} to a supported version`);
   }
 
-  return converter[1](registry, metadata[`as${converter[0]}`]);
+  const upgradedMetadata = converter[1](registry, metadata[`as${converter[0]}`]);
+
+  return upgradedMetadata;
 }
 
-function parseJson (json: Record<string, unknown>, chainProperties?: ChainProperties): [Record<string, unknown>, Registry, ContractMetadataLatest, ContractProjectInfo] {
+function parseJson (json: Record<string, unknown>, chainProperties?: ChainProperties): [Record<string, unknown>, Registry, ContractMetadataSupported, ContractProjectInfo] {
   const registry = new TypeRegistry();
   const info = registry.createType('ContractProjectInfo', json) as unknown as ContractProjectInfo;
-  const latest = getLatestMeta(registry, json);
-  const lookup = registry.createType('PortableRegistry', { types: latest.types }, true);
+  const metadata = getMetadata(registry, json as unknown as AbiJson);
+  const lookup = registry.createType('PortableRegistry', { types: metadata.types }, true);
 
   // attach the lookup to the registry - now the types are known
   registry.setLookup(lookup);
@@ -60,23 +84,34 @@ function parseJson (json: Record<string, unknown>, chainProperties?: ChainProper
     lookup.getTypeDef(id)
   );
 
-  return [json, registry, latest, info];
+  return [json, registry, metadata, info];
+}
+
+/**
+ * @internal
+ * Determines if the given input value is a ContractTypeSpec
+ */
+function isTypeSpec (value: Codec): value is ContractTypeSpec {
+  return !!value && value instanceof Map && !isUndefined((value as ContractTypeSpec).type) && !isUndefined((value as ContractTypeSpec).displayName);
+}
+
+/**
+ * @internal
+ * Determines if the given input value is an Option
+ */
+function isOption (value: Codec): value is Option<Codec> {
+  return !!value && value instanceof Option;
 }
 
 export class Abi {
-  public readonly events: AbiEvent[];
-
-  public readonly constructors: AbiConstructor[];
-
-  public readonly info: ContractProjectInfo;
-
-  public readonly json: Record<string, unknown>;
-
-  public readonly messages: AbiMessage[];
-
-  public readonly metadata: ContractMetadataLatest;
-
-  public readonly registry: Registry;
+  readonly events: AbiEvent[];
+  readonly constructors: AbiConstructor[];
+  readonly info: ContractProjectInfo;
+  readonly json: Record<string, unknown>;
+  readonly messages: AbiMessage[];
+  readonly metadata: ContractMetadataSupported;
+  readonly registry: Registry;
+  readonly environment = new Map<string, TypeDef | Codec>();
 
   constructor (abiJson: Record<string, unknown> | string, chainProperties?: ChainProperties) {
     [this.json, this.registry, this.metadata, this.info] = parseJson(
@@ -88,29 +123,105 @@ export class Abi {
     this.constructors = this.metadata.spec.constructors.map((spec: ContractConstructorSpecLatest, index) =>
       this.#createMessage(spec, index, {
         isConstructor: true,
-        isPayable: spec.payable.isTrue
+        isDefault: spec.default.isTrue,
+        isPayable: spec.payable.isTrue,
+        returnType: spec.returnType.isSome
+          ? this.registry.lookup.getTypeDef(spec.returnType.unwrap().type)
+          : null
       })
     );
-    this.events = this.metadata.spec.events.map((spec: ContractEventSpecLatest, index) =>
-      this.#createEvent(spec, index)
+    this.events = this.metadata.spec.events.map((_: ContractEventSupported, index: number) =>
+      this.#createEvent(index)
     );
-    this.messages = this.metadata.spec.messages.map((spec: ContractMessageSpecLatest, index): AbiMessage => {
-      const typeSpec = spec.returnType.unwrapOr(null);
-
-      return this.#createMessage(spec, index, {
+    this.messages = this.metadata.spec.messages.map((spec: ContractMessageSpecLatest, index): AbiMessage =>
+      this.#createMessage(spec, index, {
+        isDefault: spec.default.isTrue,
         isMutating: spec.mutates.isTrue,
         isPayable: spec.payable.isTrue,
-        returnType: typeSpec
-          ? this.registry.lookup.getTypeDef(typeSpec.type)
+        returnType: spec.returnType.isSome
+          ? this.registry.lookup.getTypeDef(spec.returnType.unwrap().type)
           : null
-      });
-    });
+      })
+    );
+
+    // NOTE See the rationale for having Option<...> values in the actual
+    // ContractEnvironmentV4 structure definition in interfaces/contractsAbi
+    // (Due to conversions, the fields may not exist)
+    for (const [key, opt] of this.metadata.spec.environment.entries()) {
+      if (isOption(opt)) {
+        if (opt.isSome) {
+          const value = opt.unwrap();
+
+          if (isBn(value)) {
+            this.environment.set(key, value);
+          } else if (isTypeSpec(value)) {
+            this.environment.set(key, this.registry.lookup.getTypeDef(value.type));
+          } else {
+            throw new Error(`Invalid environment definition for ${key}:: Expected either Number or ContractTypeSpec`);
+          }
+        }
+      } else {
+        throw new Error(`Expected Option<*> definition for ${key} in ContractEnvironment`);
+      }
+    }
   }
 
   /**
    * Warning: Unstable API, bound to change
    */
-  public decodeEvent (data: Bytes | Uint8Array): DecodedEvent {
+  public decodeEvent (record: EventRecord): DecodedEvent {
+    switch (this.metadata.version.toString()) {
+      // earlier version are hoisted to v4
+      case '4':
+        return this.#decodeEventV4(record);
+      // Latest
+      default:
+        return this.#decodeEventV5(record);
+    }
+  }
+
+  #decodeEventV5 = (record: EventRecord): DecodedEvent => {
+    // Find event by first topic, which potentially is the signature_topic
+    const signatureTopic = record.topics[0];
+    const data = record.event.data[1] as Bytes;
+
+    if (signatureTopic) {
+      const event = this.events.find((e) => e.signatureTopic !== undefined && e.signatureTopic !== null && e.signatureTopic === signatureTopic.toHex());
+
+      // Early return if event found by signature topic
+      if (event) {
+        return event.fromU8a(data);
+      }
+    }
+
+    // If no event returned yet, it might be anonymous
+    const amountOfTopics = record.topics.length;
+    const potentialEvents = this.events.filter((e) => {
+      // event can't have a signature topic
+      if (e.signatureTopic !== null && e.signatureTopic !== undefined) {
+        return false;
+      }
+
+      // event should have same amount of indexed fields as emitted topics
+      const amountIndexed = e.args.filter((a) => a.indexed).length;
+
+      if (amountIndexed !== amountOfTopics) {
+        return false;
+      }
+
+      // If all conditions met, it's a potential event
+      return true;
+    });
+
+    if (potentialEvents.length === 1) {
+      return potentialEvents[0].fromU8a(data);
+    }
+
+    throw new Error('Unable to determine event');
+  };
+
+  #decodeEventV4 = (record: EventRecord): DecodedEvent => {
+    const data = record.event.data[1] as Bytes;
     const index = data[0];
     const event = this.events[index];
 
@@ -119,7 +230,7 @@ export class Abi {
     }
 
     return event.fromU8a(data.subarray(1));
-  }
+  };
 
   /**
    * Warning: Unstable API, bound to change
@@ -143,7 +254,7 @@ export class Abi {
     return findMessage(this.messages, messageOrId);
   }
 
-  #createArgs = (args: ContractMessageParamSpecLatest[], spec: unknown): AbiParam[] => {
+  #createArgs = (args: ContractMessageParamSpecLatest[] | ContractEventParamSpecLatest[], spec: unknown): AbiParam[] => {
     return args.map(({ label, type }, index): AbiParam => {
       try {
         if (!isObject(type)) {
@@ -181,8 +292,47 @@ export class Abi {
     });
   };
 
-  #createEvent = (spec: ContractEventSpecLatest, index: number): AbiEvent => {
-    const args = this.#createArgs(spec.args, spec);
+  #createMessageParams = (args: ContractMessageParamSpecLatest[], spec: unknown): AbiMessageParam[] => {
+    return this.#createArgs(args, spec);
+  };
+
+  #createEventParams = (args: ContractEventParamSpecLatest[], spec: unknown): AbiEventParam[] => {
+    const params = this.#createArgs(args, spec);
+
+    return params.map((p, index): AbiEventParam => ({ ...p, indexed: args[index].indexed.toPrimitive() }));
+  };
+
+  #createEvent = (index: number): AbiEvent => {
+    // TODO TypeScript would narrow this type to the correct version,
+    // but version is `Text` so I need to call `toString()` here,
+    // which breaks the type inference.
+    switch (this.metadata.version.toString()) {
+      case '4':
+        return this.#createEventV4((this.metadata as ContractMetadataV4).spec.events[index], index);
+      default:
+        return this.#createEventV5((this.metadata as ContractMetadataV5).spec.events[index], index);
+    }
+  };
+
+  #createEventV5 = (spec: EventOf<ContractMetadataV5>, index: number): AbiEvent => {
+    const args = this.#createEventParams(spec.args, spec);
+    const event = {
+      args,
+      docs: spec.docs.map((d) => d.toString()),
+      fromU8a: (data: Uint8Array): DecodedEvent => ({
+        args: this.#decodeArgs(args, data),
+        event
+      }),
+      identifier: [spec.module_path, spec.label].join('::'),
+      index,
+      signatureTopic: spec.signature_topic.isSome ? spec.signature_topic.unwrap().toHex() : null
+    };
+
+    return event;
+  };
+
+  #createEventV4 = (spec: EventOf<ContractMetadataV4>, index: number): AbiEvent => {
+    const args = this.#createEventParams(spec.args, spec);
     const event = {
       args,
       docs: spec.docs.map((d) => d.toString()),
@@ -198,7 +348,7 @@ export class Abi {
   };
 
   #createMessage = (spec: ContractMessageSpecLatest | ContractConstructorSpecLatest, index: number, add: Partial<AbiMessage> = {}): AbiMessage => {
-    const args = this.#createArgs(spec.args, spec);
+    const args = this.#createMessageParams(spec.args, spec);
     const identifier = spec.label.toString();
     const message = {
       ...add,
@@ -210,11 +360,12 @@ export class Abi {
       }),
       identifier,
       index,
+      isDefault: spec.default.isTrue,
       method: stringCamelCase(identifier),
       path: identifier.split('::').map((s) => stringCamelCase(s)),
       selector: spec.selector,
       toU8a: (params: unknown[]) =>
-        this.#encodeArgs(spec, args, params)
+        this.#encodeMessageArgs(spec, args, params)
     };
 
     return message;
@@ -246,7 +397,7 @@ export class Abi {
     return message.fromU8a(trimmed.subarray(4));
   };
 
-  #encodeArgs = ({ label, selector }: ContractMessageSpecLatest | ContractConstructorSpecLatest, args: AbiParam[], data: unknown[]): Uint8Array => {
+  #encodeMessageArgs = ({ label, selector }: ContractMessageSpecLatest | ContractConstructorSpecLatest, args: AbiMessageParam[], data: unknown[]): Uint8Array => {
     if (data.length !== args.length) {
       throw new Error(`Expected ${args.length} arguments to contract message '${label.toString()}', found ${data.length}`);
     }

packages/api-contract/src/Abi/toLatest.ts

@@ -1,38 +0,0 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
-// SPDX-License-Identifier: Apache-2.0
-
-import type { ContractMetadataLatest, ContractMetadataV3 } from '@polkadot/types/interfaces';
-import type { Registry } from '@polkadot/types/types';
-
-import { v0ToV1 } from './toV1';
-import { v1ToV2 } from './toV2';
-import { v2ToV3 } from './toV3';
-
-// The versions where an enum is used, aka V0 is missing
-// (Order from newest, i.e. we expect more on newest vs oldest)
-export const enumVersions = <const> ['V3', 'V2', 'V1'];
-
-type Versions = typeof enumVersions[number] | 'V0';
-
-type Converter = (registry: Registry, vx: any) => ContractMetadataLatest;
-
-// Helper to convert metadata from one step to the next
-function createConverter <I, O> (next: (registry: Registry, input: O) => ContractMetadataLatest, step: (registry: Registry, input: I) => O): (registry: Registry, input: I) => ContractMetadataLatest {
-  return (registry: Registry, input: I): ContractMetadataLatest =>
-    next(registry, step(registry, input));
-}
-
-export function v3ToLatest (registry: Registry, v3: ContractMetadataV3): ContractMetadataLatest {
-  return v3;
-}
-
-export const v2ToLatest = createConverter(v3ToLatest, v2ToV3);
-export const v1ToLatest = createConverter(v2ToLatest, v1ToV2);
-export const v0ToLatest = createConverter(v1ToLatest, v0ToV1);
-
-export const convertVersions: [Versions, Converter][] = [
-  ['V3', v3ToLatest],
-  ['V2', v2ToLatest],
-  ['V1', v1ToLatest],
-  ['V0', v0ToLatest]
-];

packages/api-contract/src/Abi/toLatestCompatible.spec.ts

@@ -1,15 +1,17 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import { v0ToLatest, v1ToLatest, v2ToLatest, v3ToLatest } from '@polkadot/api-contract/Abi/toLatest';
+/// <reference types="@polkadot/dev-test/globals.d.ts" />
+
 import { TypeRegistry } from '@polkadot/types';
 
-import abis from '../test/contracts';
+import abis from '../test/contracts/index.js';
+import { v0ToLatestCompatible, v1ToLatestCompatible, v2ToLatestCompatible, v3ToLatestCompatible, v4ToLatestCompatible, v5ToLatestCompatible } from './toLatestCompatible.js';
 
-describe('v0ToLatest', (): void => {
+describe('v0ToLatestCompatible', (): void => {
   const registry = new TypeRegistry();
-  const contract = registry.createType('ContractMetadata', { V0: abis.ink_v0_erc20 });
-  const latest = v0ToLatest(registry, contract.asV0);
+  const contract = registry.createType('ContractMetadata', { V0: abis['ink_v0_erc20'] });
+  const latest = v0ToLatestCompatible(registry, contract.asV0);
 
   it('has the correct constructors', (): void => {
     expect(
@@ -46,12 +48,16 @@ describe('v0ToLatest', (): void => {
       latest.spec.events[0].args.map(({ label }) => label.toString())
     ).toEqual(['from', 'to', 'value']);
   });
+
+  it('has the latest compatible version number', (): void => {
+    expect(latest.version.toString()).toEqual('4');
+  });
 });
 
-describe('v1ToLatest', (): void => {
+describe('v1ToLatestCompatible', (): void => {
   const registry = new TypeRegistry();
-  const contract = registry.createType('ContractMetadata', { V1: abis.ink_v1_flipper.V1 });
-  const latest = v1ToLatest(registry, contract.asV1);
+  const contract = registry.createType('ContractMetadata', { V1: abis['ink_v1_flipper']['V1'] });
+  const latest = v1ToLatestCompatible(registry, contract.asV1);
 
   it('has the correct constructors', (): void => {
     expect(
@@ -66,8 +72,8 @@ describe('v1ToLatest', (): void => {
   });
 
   it('has the correct messages with namespaced method name', (): void => {
-    const contract = registry.createType('ContractMetadata', { V1: abis.ink_v1_psp22.V1 });
-    const latest = v1ToLatest(registry, contract.asV1);
+    const contract = registry.createType('ContractMetadata', { V1: abis['ink_v1_psp22']['V1'] });
+    const latest = v1ToLatestCompatible(registry, contract.asV1);
 
     expect(
       latest.spec.messages.map(({ label }) => label.toString())
@@ -81,24 +87,32 @@ describe('v1ToLatest', (): void => {
       latest.spec.constructors[0].args.map(({ label }) => label.toString())
     ).toEqual(['init_value']);
   });
+
+  it('has the latest compatible version number', (): void => {
+    expect(latest.version.toString()).toEqual('4');
+  });
 });
 
-describe('v2ToLatest', (): void => {
+describe('v2ToLatestCompatible', (): void => {
   const registry = new TypeRegistry();
-  const contract = registry.createType('ContractMetadata', { V2: abis.ink_v2_flipper.V2 });
-  const latest = v2ToLatest(registry, contract.asV2);
+  const contract = registry.createType('ContractMetadata', { V2: abis['ink_v2_flipper']['V2'] });
+  const latest = v2ToLatestCompatible(registry, contract.asV2);
 
   it('has the correct constructor flag', (): void => {
     expect(
       latest.spec.constructors[0].payable.isTrue
     ).toEqual(true);
   });
+
+  it('has the latest compatible version number', (): void => {
+    expect(latest.version.toString()).toEqual('4');
+  });
 });
 
-describe('v3ToLatest', (): void => {
+describe('v3ToLatestCompatible', (): void => {
   const registry = new TypeRegistry();
-  const contract = registry.createType('ContractMetadata', { V3: abis.ink_v3_flipper.V3 });
-  const latest = v3ToLatest(registry, contract.asV3);
+  const contract = registry.createType('ContractMetadata', { V3: abis['ink_v3_flipper']['V3'] });
+  const latest = v3ToLatestCompatible(registry, contract.asV3);
 
   it('has the correct constructor flags', (): void => {
     expect(
@@ -110,8 +124,8 @@ describe('v3ToLatest', (): void => {
   });
 
   it('has the correct messages', (): void => {
-    const contract = registry.createType('ContractMetadata', { V3: abis.ink_v3_traitErc20.V3 });
-    const latest = v3ToLatest(registry, contract.asV3);
+    const contract = registry.createType('ContractMetadata', { V3: abis['ink_v3_traitErc20']['V3'] });
+    const latest = v3ToLatestCompatible(registry, contract.asV3);
 
     expect(
       latest.spec.messages.map(({ label }) => label.toString())
@@ -119,4 +133,61 @@ describe('v3ToLatest', (): void => {
       'BaseErc20::total_supply', 'BaseErc20::balance_of', 'BaseErc20::allowance', 'BaseErc20::transfer', 'BaseErc20::approve', 'BaseErc20::transfer_from'
     ]);
   });
+
+  it('has the latest compatible version number', (): void => {
+    expect(latest.version.toString()).toEqual('4');
+  });
+});
+
+describe('v4ToLatestCompatible', (): void => {
+  const registry = new TypeRegistry();
+  const contract = registry.createType('ContractMetadata', { V4: abis['ink_v4_flipperContract'] });
+  const latest = v4ToLatestCompatible(registry, contract.asV4);
+
+  it('has the correct constructor flags', (): void => {
+    expect(
+      latest.spec.constructors[0].payable.isTrue
+    ).toEqual(false);
+    expect(
+      latest.spec.constructors[1].payable.isTrue
+    ).toEqual(false);
+  });
+
+  it('has the latest compatible version number', (): void => {
+    expect(latest.version.toString()).toEqual('4');
+  });
+});
+
+describe('v5ToLatestCompatible', (): void => {
+  const registry = new TypeRegistry();
+  const contract = registry.createType('ContractMetadata', { V5: abis['ink_v5_erc20Metadata'] });
+  const latest = v5ToLatestCompatible(registry, contract.asV5);
+
+  it('has the correct messages', (): void => {
+    expect(
+      latest.spec.messages.map(({ label }) => label.toString())
+    ).toEqual(['total_supply', 'balance_of', 'allowance', 'transfer', 'approve', 'transfer_from']);
+  });
+
+  it('has new event fields', (): void => {
+    expect(
+      latest.spec.events.length
+    ).toEqual(2);
+
+    expect(
+      latest.spec.events.every((e) => e.has('module_path'))
+    ).toEqual(true);
+
+    expect(latest.spec.events[0].module_path.toString()).toEqual('erc20::erc20');
+
+    expect(
+      latest.spec.events.every((e) => e.has('signature_topic'))
+    ).toEqual(true);
+
+    expect(latest.spec.events[0].signature_topic.toHex()).toEqual('0xb5b61a3e6a21a16be4f044b517c28ac692492f73c5bfd3f60178ad98c767f4cb');
+  });
+
+  it('has the latest compatible version number', (): void => {
+    expect(latest.version.toString()).toEqual('5');
+  });
 });

packages/api-contract/src/Abi/toLatestCompatible.ts

@@ -0,0 +1,47 @@
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import type { ContractMetadataV4, ContractMetadataV5 } from '@polkadot/types/interfaces';
+import type { Registry } from '@polkadot/types/types';
+import type { ContractMetadataSupported } from './index.js';
+
+import { v0ToV1 } from './toV1.js';
+import { v1ToV2 } from './toV2.js';
+import { v2ToV3 } from './toV3.js';
+import { v3ToV4 } from './toV4.js';
+
+// The versions where an enum is used, aka V0 is missing
+// (Order from newest, i.e. we expect more on newest vs oldest)
+export const enumVersions = ['V5', 'V4', 'V3', 'V2', 'V1'] as const;
+
+type Versions = typeof enumVersions[number] | 'V0';
+
+type Converter = (registry: Registry, vx: any) => ContractMetadataSupported;
+
+// Helper to convert metadata from one step to the next
+function createConverter <I, O> (next: (registry: Registry, input: O) => ContractMetadataSupported, step: (registry: Registry, input: I) => O): (registry: Registry, input: I) => ContractMetadataSupported {
+  return (registry: Registry, input: I): ContractMetadataSupported =>
+    next(registry, step(registry, input));
+}
+
+export function v5ToLatestCompatible (_registry: Registry, v5: ContractMetadataV5): ContractMetadataV5 {
+  return v5;
+}
+
+export function v4ToLatestCompatible (_registry: Registry, v4: ContractMetadataV4): ContractMetadataV4 {
+  return v4;
+}
+
+export const v3ToLatestCompatible = /*#__PURE__*/ createConverter(v4ToLatestCompatible, v3ToV4);
+export const v2ToLatestCompatible = /*#__PURE__*/ createConverter(v3ToLatestCompatible, v2ToV3);
+export const v1ToLatestCompatible = /*#__PURE__*/ createConverter(v2ToLatestCompatible, v1ToV2);
+export const v0ToLatestCompatible = /*#__PURE__*/ createConverter(v1ToLatestCompatible, v0ToV1);
+
+export const convertVersions: [Versions, Converter][] = [
+  ['V5', v5ToLatestCompatible],
+  ['V4', v4ToLatestCompatible],
+  ['V3', v3ToLatestCompatible],
+  ['V2', v2ToLatestCompatible],
+  ['V1', v1ToLatestCompatible],
+  ['V0', v0ToLatestCompatible]
+];

packages/api-contract/src/Abi/toV1.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { ContractMetadataV0, ContractMetadataV1 } from '@polkadot/types/interfaces';
@@ -21,6 +21,10 @@ function v0ToV1Names (all: Named[]): unknown[] {
 }
 
 export function v0ToV1 (registry: Registry, v0: ContractMetadataV0): ContractMetadataV1 {
+  if (!v0.metadataVersion.length) {
+    throw new Error('Invalid format for V0 (detected) contract metadata');
+  }
+
   return registry.createType('ContractMetadataV1', objectSpread({}, v0, {
     spec: objectSpread({}, v0.spec, {
       constructors: v0ToV1Names(v0.spec.constructors),

packages/api-contract/src/Abi/toV2.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { Text } from '@polkadot/types';
@@ -23,11 +23,11 @@ interface ArgsEntry <T extends WithArgs> extends NamedEntry {
   args: GetArgsType<T>['args'][0][];
 }
 
-const ARG_TYPES = <const> {
+const ARG_TYPES = {
   ContractConstructorSpec: 'ContractMessageParamSpecV2',
   ContractEventSpec: 'ContractEventParamSpecV2',
   ContractMessageSpec: 'ContractMessageParamSpecV2'
-};
+} as const;
 
 function v1ToV2Label (entry: NamedEntry): { label: Text } {
   return objectSpread({}, entry, {

packages/api-contract/src/Abi/toV3.ts

@@ -1,4 +1,4 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
 import type { ContractMetadataV2, ContractMetadataV3 } from '@polkadot/types/interfaces';

packages/api-contract/src/Abi/toV4.ts

@@ -0,0 +1,21 @@
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import type { ContractMetadataV3, ContractMetadataV4 } from '@polkadot/types/interfaces';
+import type { Registry } from '@polkadot/types/types';
+
+import { objectSpread } from '@polkadot/util';
+
+export function v3ToV4 (registry: Registry, v3: ContractMetadataV3): ContractMetadataV4 {
+  return registry.createType('ContractMetadataV4', objectSpread({}, v3, {
+    spec: objectSpread({}, v3.spec, {
+      constructors: v3.spec.constructors.map((c) =>
+        registry.createType('ContractConstructorSpecV4', objectSpread({}, c))
+      ),
+      messages: v3.spec.messages.map((m) =>
+        registry.createType('ContractMessageSpecV3', objectSpread({}, m))
+      )
+    }),
+    version: registry.createType('Text', '4')
+  }));
+}

packages/api-contract/src/augment.ts

@@ -0,0 +1,4 @@
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import '@polkadot/api-augment';

packages/api-contract/src/base/Base.ts

@@ -1,29 +1,23 @@
-// Copyright 2017-2022 @polkadot/api authors & contributors
+// Copyright 2017-2024 @polkadot/api authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
+import type { ApiBase } from '@polkadot/api/base';
 import type { ApiTypes, DecorateMethod } from '@polkadot/api/types';
+import type { WeightV2 } from '@polkadot/types/interfaces';
 import type { Registry } from '@polkadot/types/types';
 
-import { ApiBase } from '@polkadot/api/base';
 import { isFunction } from '@polkadot/util';
 
-import { Abi } from '../Abi';
+import { Abi } from '../Abi/index.js';
 
 export abstract class Base<ApiType extends ApiTypes> {
-  public readonly abi: Abi;
-
-  public readonly api: ApiBase<ApiType>;
+  readonly abi: Abi;
+  readonly api: ApiBase<ApiType>;
 
   protected readonly _decorateMethod: DecorateMethod<ApiType>;
+  protected readonly _isWeightV1: boolean;
 
   constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, decorateMethod: DecorateMethod<ApiType>) {
-    this.abi = abi instanceof Abi
-      ? abi
-      : new Abi(abi, api.registry.getChainProperties());
-    this.api = api;
-
-    this._decorateMethod = decorateMethod;
-
     if (!api || !api.isConnected || !api.tx) {
       throw new Error('Your API has not been initialized correctly and is not connected to a chain');
     } else if (!api.tx.contracts || !isFunction(api.tx.contracts.instantiateWithCode) || api.tx.contracts.instantiateWithCode.meta.args.length !== 6) {
@@ -31,6 +25,13 @@ export abstract class Base<ApiType extends ApiTypes> {
     } else if (!api.call.contractsApi || !isFunction(api.call.contractsApi.call)) {
       throw new Error('Your runtime does not expose the api.call.contractsApi.call runtime interfaces');
     }
+
+    this.abi = abi instanceof Abi
+      ? abi
+      : new Abi(abi, api.registry.getChainProperties());
+    this.api = api;
+    this._decorateMethod = decorateMethod;
+    this._isWeightV1 = !api.registry.createType<WeightV2>('Weight').proofSize;
   }
 
   public get registry (): Registry {

packages/api-contract/src/base/Blueprint.ts

@@ -1,29 +1,27 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
+import type { ApiBase } from '@polkadot/api/base';
 import type { SubmittableExtrinsic } from '@polkadot/api/submittable/types';
 import type { ApiTypes, DecorateMethod } from '@polkadot/api/types';
 import type { AccountId, EventRecord, Hash } from '@polkadot/types/interfaces';
 import type { ISubmittableResult } from '@polkadot/types/types';
-import type { AbiConstructor, BlueprintOptions } from '../types';
-import type { MapConstructorExec } from './types';
+import type { Abi } from '../Abi/index.js';
+import type { AbiConstructor, BlueprintOptions } from '../types.js';
+import type { MapConstructorExec } from './types.js';
 
 import { SubmittableResult } from '@polkadot/api';
-import { ApiBase } from '@polkadot/api/base';
 import { BN_ZERO, isUndefined } from '@polkadot/util';
 
-import { Abi } from '../Abi';
-import { applyOnEvent } from '../util';
-import { Base } from './Base';
-import { Contract } from './Contract';
-import { createBluePrintTx, encodeSalt } from './util';
+import { applyOnEvent } from '../util.js';
+import { Base } from './Base.js';
+import { Contract } from './Contract.js';
+import { convertWeight, createBluePrintTx, encodeSalt } from './util.js';
 
-export interface BlueprintConstructor<ApiType extends ApiTypes> {
-  new(api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, codeHash: string | Hash | Uint8Array): Blueprint<ApiType>;
-}
+export type BlueprintConstructor<ApiType extends ApiTypes> = new(api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, codeHash: string | Hash | Uint8Array) => Blueprint<ApiType>;
 
 export class BlueprintSubmittableResult<ApiType extends ApiTypes> extends SubmittableResult {
-  public readonly contract?: Contract<ApiType>;
+  readonly contract?: Contract<ApiType> | undefined;
 
   constructor (result: ISubmittableResult, contract?: Contract<ApiType>) {
     super(result);
@@ -36,7 +34,7 @@ export class Blueprint<ApiType extends ApiTypes> extends Base<ApiType> {
   /**
    * @description The on-chain code hash for this blueprint
    */
-  public readonly codeHash: Hash;
+  readonly codeHash: Hash;
 
   readonly #tx: MapConstructorExec<ApiType> = {};
 
@@ -57,16 +55,22 @@ export class Blueprint<ApiType extends ApiTypes> extends Base<ApiType> {
   }
 
   #deploy = (constructorOrId: AbiConstructor | string | number, { gasLimit = BN_ZERO, salt, storageDepositLimit = null, value = BN_ZERO }: BlueprintOptions, params: unknown[]): SubmittableExtrinsic<ApiType, BlueprintSubmittableResult<ApiType>> => {
-    const encParams = this.abi.findConstructor(constructorOrId).toU8a(params);
-    const encSalt = encodeSalt(salt);
-
-    return this.api.tx.contracts
-      .instantiate(value, gasLimit, storageDepositLimit, this.codeHash, encParams, encSalt)
-      .withResultTransform((result: ISubmittableResult) =>
-        new BlueprintSubmittableResult(result, applyOnEvent(result, ['Instantiated'], ([record]: EventRecord[]) =>
-          new Contract<ApiType>(this.api, this.abi, record.event.data[1] as AccountId, this._decorateMethod)
-        ))
-      );
+    return this.api.tx.contracts.instantiate(
+      value,
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore jiggle v1 weights, metadata points to latest
+      this._isWeightV1
+        ? convertWeight(gasLimit).v1Weight
+        : convertWeight(gasLimit).v2Weight,
+      storageDepositLimit,
+      this.codeHash,
+      this.abi.findConstructor(constructorOrId).toU8a(params),
+      encodeSalt(salt)
+    ).withResultTransform((result: ISubmittableResult) =>
+      new BlueprintSubmittableResult(result, applyOnEvent(result, ['Instantiated'], ([record]: EventRecord[]) =>
+        new Contract<ApiType>(this.api, this.abi, record.event.data[1] as AccountId, this._decorateMethod)
+      ))
+    );
   };
 }
 

packages/api-contract/src/base/Code.spec.ts

@@ -1,18 +1,19 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
-import fs from 'fs';
-import path from 'path';
+/// <reference types="@polkadot/dev-test/globals.d.ts" />
+
+import fs from 'node:fs';
 
 import { toPromiseMethod } from '@polkadot/api';
 
 import v0contractFlipper from '../test/contracts/ink/v0/flipper.contract.json' assert { type: 'json' };
 import v0abiFlipper from '../test/contracts/ink/v0/flipper.json' assert { type: 'json' };
 import v1contractFlipper from '../test/contracts/ink/v1/flipper.contract.json' assert { type: 'json' };
-import { Code } from './Code';
-import { mockApi } from './mock';
+import { Code } from './Code.js';
+import { mockApi } from './mock.js';
 
-const v0wasmFlipper = fs.readFileSync(path.join(__dirname, '../test/contracts/ink/v0/flipper.wasm'));
+const v0wasmFlipper = fs.readFileSync(new URL('../test/contracts/ink/v0/flipper.wasm', import.meta.url), 'utf-8');
 
 describe('Code', (): void => {
   it('can construct with an individual ABI/WASM combo', (): void => {
@@ -27,7 +28,7 @@ describe('Code', (): void => {
     ).not.toThrow();
   });
 
-  it.only('can construct with an .contract ABI (v1)', (): void => {
+  it('can construct with an .contract ABI (v1)', (): void => {
     expect(
       () => new Code(mockApi, v1contractFlipper as Record<string, unknown>, null, toPromiseMethod)
     ).not.toThrow();

packages/api-contract/src/base/Code.ts

@@ -1,34 +1,32 @@
-// Copyright 2017-2022 @polkadot/api-contract authors & contributors
+// Copyright 2017-2024 @polkadot/api-contract authors & contributors
 // SPDX-License-Identifier: Apache-2.0
 
+import type { ApiBase } from '@polkadot/api/base';
 import type { SubmittableExtrinsic } from '@polkadot/api/submittable/types';
 import type { ApiTypes, DecorateMethod } from '@polkadot/api/types';
 import type { AccountId, EventRecord } from '@polkadot/types/interfaces';
 import type { ISubmittableResult } from '@polkadot/types/types';
 import type { Codec } from '@polkadot/types-codec/types';
-import type { AbiConstructor, BlueprintOptions } from '../types';
-import type { MapConstructorExec } from './types';
+import type { Abi } from '../Abi/index.js';
+import type { AbiConstructor, BlueprintOptions } from '../types.js';
+import type { MapConstructorExec } from './types.js';
 
 import { SubmittableResult } from '@polkadot/api';
-import { ApiBase } from '@polkadot/api/base';
-import { BN_ZERO, compactAddLength, isUndefined, isWasm, u8aToU8a } from '@polkadot/util';
+import { BN_ZERO, compactAddLength, isRiscV, isUndefined, isWasm, u8aToU8a } from '@polkadot/util';
 
-import { Abi } from '../Abi';
-import { applyOnEvent } from '../util';
-import { Base } from './Base';
-import { Blueprint } from './Blueprint';
-import { Contract } from './Contract';
-import { createBluePrintTx, encodeSalt } from './util';
+import { applyOnEvent } from '../util.js';
+import { Base } from './Base.js';
+import { Blueprint } from './Blueprint.js';
+import { Contract } from './Contract.js';
+import { convertWeight, createBluePrintTx, encodeSalt } from './util.js';
 
-export interface CodeConstructor<ApiType extends ApiTypes> {
-  new(api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, wasm: Uint8Array | string | Buffer | null | undefined): Code<ApiType>;
-}
+export type CodeConstructor<ApiType extends ApiTypes> = new(api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, wasm: Uint8Array | string | Buffer | null | undefined) => Code<ApiType>;
 
 export class CodeSubmittableResult<ApiType extends ApiTypes> extends SubmittableResult {
-  public readonly blueprint?: Blueprint<ApiType>;
-  public readonly contract?: Contract<ApiType>;
+  readonly blueprint?: Blueprint<ApiType> | undefined;
+  readonly contract?: Contract<ApiType> | undefined;
 
-  constructor (result: ISubmittableResult, blueprint?: Blueprint<ApiType>, contract?: Contract<ApiType>) {
+  constructor (result: ISubmittableResult, blueprint?: Blueprint<ApiType> | undefined, contract?: Contract<ApiType> | undefined) {
     super(result);
 
     this.blueprint = blueprint;
@@ -36,20 +34,26 @@ export class CodeSubmittableResult<ApiType extends ApiTypes> extends Submittable
   }
 }
 
+// checks to see if the code (or at least the header)
+// is a valid/supported format
+function isValidCode (code: Uint8Array): boolean {
+  return isWasm(code) || isRiscV(code);
+}
+
 export class Code<ApiType extends ApiTypes> extends Base<ApiType> {
-  public readonly code: Uint8Array;
+  readonly code: Uint8Array;
 
   readonly #tx: MapConstructorExec<ApiType> = {};
 
   constructor (api: ApiBase<ApiType>, abi: string | Record<string, unknown> | Abi, wasm: Uint8Array | string | Buffer | null | undefined, decorateMethod: DecorateMethod<ApiType>) {
     super(api, abi, decorateMethod);
 
-    this.code = isWasm(this.abi.info.source.wasm)
+    this.code = isValidCode(this.abi.info.source.wasm)
       ? this.abi.info.source.wasm
       : u8aToU8a(wasm);
 
-    if (!isWasm(this.code)) {
-      throw new Error('No WASM code provided');
+    if (!isValidCode(this.code)) {
+      throw new Error('Invalid code provided');
     }
 
     this.abi.constructors.forEach((c): void => {
@@ -64,23 +68,28 @@ export class Code<ApiType extends ApiTypes> extends Base<ApiType> {
   }
 
   #instantiate = (constructorOrId: AbiConstructor | string | number, { gasLimit = BN_ZERO, salt, storageDepositLimit = null, value = BN_ZERO }: BlueprintOptions, params: unknown[]): SubmittableExtrinsic<ApiType, CodeSubmittableResult<ApiType>> => {
-    const encCode = compactAddLength(this.code);
-    const encParams = this.abi.findConstructor(constructorOrId).toU8a(params);
-    const encSalt = encodeSalt(salt);
-
-    return this.api.tx.contracts
-      .instantiateWithCode(value, gasLimit, storageDepositLimit, encCode, encParams, encSalt)
-      .withResultTransform((result: ISubmittableResult) =>
-        new CodeSubmittableResult(result, ...(applyOnEvent(result, ['CodeStored', 'Instantiated'], (records: EventRecord[]) =>
-          records.reduce<[Blueprint<ApiType>?, Contract<ApiType>?]>(([blueprint, contract], { event }) =>
-            this.api.events.contracts.Instantiated.is(event)
-              ? [blueprint, new Contract<ApiType>(this.api, this.abi, (event as unknown as { data: [Codec, AccountId] }).data[1], this._decorateMethod)]
-              : this.api.events.contracts.CodeStored.is(event)
-                ? [new Blueprint<ApiType>(this.api, this.abi, (event as unknown as { data: [AccountId] }).data[0], this._decorateMethod), contract]
-                : [blueprint, contract],
-          [])
-        ) || []))
-      );
+    return this.api.tx.contracts.instantiateWithCode(
+      value,
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore jiggle v1 weights, metadata points to latest
+      this._isWeightV1
+        ? convertWeight(gasLimit).v1Weight
+        : convertWeight(gasLimit).v2Weight,
+      storageDepositLimit,
+      compactAddLength(this.code),
+      this.abi.findConstructor(constructorOrId).toU8a(params),
+      encodeSalt(salt)
+    ).withResultTransform((result: ISubmittableResult) =>
+      new CodeSubmittableResult(result, ...(applyOnEvent(result, ['CodeStored', 'Instantiated'], (records: EventRecord[]) =>
+        records.reduce<[Blueprint<ApiType> | undefined, Contract<ApiType> | undefined]>(([blueprint, contract], { event }) =>
+          this.api.events.contracts.Instantiated.is(event)
+            ? [blueprint, new Contract<ApiType>(this.api, this.abi, (event as unknown as { data: [Codec, AccountId] }).data[1], this._decorateMethod)]
+            : this.api.events.contracts.CodeStored.is(event)
+              ? [new Blueprint<ApiType>(this.api, this.abi, (event as unknown as { data: [AccountId] }).data[0], this._decorateMethod), contract]
+              : [blueprint, contract],
+        [undefined, undefined])
+      ) || [undefined, undefined]))
+    );
   };
 }