[CI Skip] release/stable 1.31.1

skip-checks: true
1.31 (#2551 )
2020-08-31 15:44:17 +00:00 · 2020-08-31 17:32:20 +02:00 · 2020-08-31 15:06:05 +00:00 · 2020-08-31 16:50:56 +02:00 · 2020-08-31 14:24:05 +00:00 · 2020-08-31 16:11:17 +02:00
77 changed files with 1418 additions and 673 deletions
@@ -13,6 +13,8 @@ module.exports = {
    // add override for any (a metric ton of them, initial conversion)
    '@typescript-eslint/no-explicit-any': 'off',
    // these should be removed, there are 8 of them as errors
-    '@typescript-eslint/no-non-null-assertion': 'off'
+    '@typescript-eslint/no-non-null-assertion': 'off',
+    // this seems very broken atm, false positives
+    '@typescript-eslint/unbound-method': 'off'
  }
 };
@@ -8,4 +8,4 @@ plugins:
  - path: .yarn/plugins/@yarnpkg/plugin-interactive-tools.js
    spec: "@yarnpkg/plugin-interactive-tools"

-yarnPath: .yarn/releases/yarn-2.1.1.js
+yarnPath: .yarn/releases/yarn-2.1.1.cjs
@@ -1,5 +1,31 @@
 # CHANGELOG

+## 1.31.1 Aug 31, 2020
+
+Upgrade priority: Medium, especially for staking users on Polkadot, Kusama & Westend (type updates applied for v23 onwards) or if transparent `.at(hash)` queries are required/used
+
+- **Important** Substrate changed the `RewardDestination` enum with an extra field for payout-to-any account for staking preferences. If on an older chain consider adding `RewardDestination: 'RewardDestinationTo257'`
+- **Important** Substrate changed the `CompactAssignment` type enhanced types for session solution submissions. If on an older chain consider adding `CompactAssignments: 'CompactAssignmentsTo257'`
+
+- Fix documentation language and typos (Thanks to https://github.com/Meuko)
+- Add missing `TransactionPriority` type (Thanks to https://github.com/aniiantt)
+- Update definitions for new `CompactAssignments`, including tests (Thanks to https://github.com/kianenigma)
+
+- Add transparent support for types/metadata, i.e. hash queries such as `rpc.chain.getBlock(<hash>)` & `query.system.events.at(<hash>)` now works out-of-the-box injecting the correct metadata & types.
+- Optimize RPC-layer calls with detection of short-term cacheable calls (in the same way subscriptions are done)
+- Additional checks on `AccountId` for valid sizes
+- Add `toBigInt()` (JS built-in `BigInt`) on `Int/Uint`, & `Compact<*>` types
+- Support for `.concat` on Codec arrays
+- Support for serialization with `isBare` flag on enums
+- Add `api.getBlockRegistry(blockHash?)` to create registry/types for a specific block
+- `derive.democracy.locks` now returns delegated locks for an account as well
+- Adjust unlocking derives with appropriate in-place additions (less object allocations)
+- `.sign` on submittables is marked deprecated (not due for removal, but rather use `.signAsync` for consistency with `.signAndSend`)
+- Adjust types for `CompactAssignments` & `RewardDestination` for Polkadot, Kusama & Westend
+- `@polkadot/util` 3.4
+- `@polkadot/wasm-crypto` 1.4
+
+
 ## 1.30.1 Aug 24, 2020

 Upgrade priority: Low, unless using the `proposeParachain` module.
@@ -11,56 +37,68 @@ Upgrade priority: Low, unless using the `proposeParachain` module.
 - Allow for configurable hashers via `registry.setHasher(...)` (defaults to `blake2AsU8a`)
 - `@polkadot/util` 3.3

+
 ## 1.29.1 Aug 17, 2020

 Upgrade priority: Low, unless on bleeding-edge chain with new compact `CompactAssignments`.

 - **Important** The Substrate `CompactAssignments` type has changed for better space utilization. On older chains, supply `CompactAssignments: 'CompactAssignmentsTo257'`
+
 - Clean tx cookbook param expansion (Thanks to https://github.com/swswsw)
+
 - Add additional `Fixed{I,U}{64,128}` and `{I,U}32F32` types
 - Add `desiredRunnersUp` to council derives
 - Cleanup indices/AccountId combination derive lookups
 - `@polkadot/util` 3.2

+
 ## 1.28.1 Aug 10, 2020

 Upgrade priority: Low, unless using Centrifuge or parachains

 - Update Centrifuge types to latest (Thanks to https://github.com/mikiquantum)
+
 - Add cookbook entry for viewing block extrinsics
 - Support types for time-delay proxies
 - Update types for parachains
 - `@polkadot/util` 3.1
 - `@polkadot/wasm-crypto` 1.3

+
 ## 1.27.1 Aug 3, 2020

 Upgrade priority: Low, unless using the Rococo chain

 - Remove outdated example poc-3 RPC reference (Thanks to https://github.com/swswsw)
+
 - Raw/Bytes `toHuman` detects ASCII sequence for text output
 - Add know types for the Rococo chain

+
 ## 1.26.1 Jul 27, 2020

 Upgrade priority: Low

 - Update docs for the new `system.accountNextIndex` (Thanks to https://github.com/shawntabrizi)
 - Update contracts call parameter typing (Thanks to https://github.com/kwingram25)
+
 - Adjust votingBalance to only return `freeBalance` (only council voting is free + reserved)
 - Additional checks for referenced Vec sub-type deconstruction in typegen
 - Allow for API `typesBundle` option to inject a group of chain versions types
 - Update metadata static tests for latest Substrate
 - `@polkadot/util` 3.0

+
 ## 1.25.1 Jul 20, 2020

 Upgrade priority: Medium, especially if using contracts.

 - **Important** Contract RPC result updated on Substrate, on older chains supply `ContractExecResult: 'ContractExecResultTo255'`
+
 - Support for custom HTTP headers in providers (Thanks to https://github.com/brad-larson)
 - Update known types for Centrifuge (Thanks to https://github.com/philipstanislaus)
 - Update API users with Registrar #1 (Thanks to https://github.com/chevdor)
+
 - Raw/Bytes `toHuman()` displays utf-8 as available
 - Add fallback for `setImmediate` when not polyfilled
 - Update `NetworkState` reputation type for `system_networkState` RPC
@@ -68,15 +106,18 @@ Upgrade priority: Medium, especially if using contracts.
 - Fix class prototype for (basically-deprecated) Linkage type
 - Add Polkadot types for `purchase` pallet

+
 ## 1.24.1 Jul 13, 2020

 - Added `isAscii` & `isUtf8` getters to `Bytes` & `Raw` types
 - Added `toUtf8()` helper to `Bytes` & `Raw` types
 - `@polkadot/util` 2.18

+
 ## 1.23.1 Jul 6, 2020

 - Small README typo fix (Thanks to https://github.com/woss)
+
 - Add latest Substrate master types
 - Adjust `<Codec>.toRawType()` to use registry name as available
 - Update `ProxyType` for Kusama, Polkadot & Westend with `IdentityJudgement`
@@ -84,27 +125,34 @@ Upgrade priority: Medium, especially if using contracts.
 - Remove core codec dependencies on Base class (with proper TS encapsulation)
 - `@polkadot/util` 2.17

+
 ## 1.22.1 Jun 30, 2020

 - **Important** Substrate changed the treasury tip structure, on older chains supply `OpenTip: 'OpenTipTo225'`
+
 - Allow for `[u8; 33]` in U8aFixed (Thanks to https://github.com/akru)
+
 - Improve derive accountId -> accountIndex lookups (optimize entries queries)
 - Vesting balance calculations via `derive.balances.all` has been updated for locks
 - Add derive for multi staking rewards with specified eras
 - `@polkadot/util` 2.16

+
 ## 1.21.1 Jun 23, 2020

 - Fix subscriptions never unsubscribing after the id swap in 1.18.1 (Thanks to https://github.com/dillu24 for testing iterations)
+
 - Add support for `CheckMortality` signed extension (old `CheckEra` is now an alias)
 - Promise API will default to using `getStorage` on non-subscription calls, reducing RPC overhead
 - Optimize derive BN allocations, using in-place operators as applicable
 - Add new Substrate types for Babe `EquivocationProof`
 - Adjust `Releases` enum to use a shared instance

+
 ## 1.20.1 Jun 22, 2020

 - **Important** RPC for `account_nextIndex` has been moved to `system_accountNextIndex` (Aligning with Substrate as a primary alias)
+
 - Cleanup map entries support with only Substrate 2.0-era RPCs (when introduced)
 - Add `system_dryRun` RPC
 - Optimize `derive.staking.queryMulti` retrievals with additional per-type batching
@@ -112,33 +160,40 @@ Upgrade priority: Medium, especially if using contracts.
 - Adjust types & metadata for latest Substrate
 - `@polkadot/util` 2.15

+
 ## 1.19.1 Jun 16, 2020

 - Improve typing on `.entries()` queries (Thanks to https://github.com/monitz87)
+
 - Align metadata and types with latest Substrate
 - Update Polkadot types for current evolution of parachains
 - Allow for type aliasing on events (aligning with calls & queries)
 - `@polkadot/util` 2.14

+
 ## 1.18.1 Jun 8, 2020

 - Expand docs on node-template types (Thanks to https://github.com/g2udevelopment)
 - Update contract fees to current impl. (Thanks to https://github.com/djuanit0x)
 - Allow `Option` types in enum/Result type generation (Thanks to http://github.com/xlc)
 - Add `.entriesPaged` and `.keysPaged` methods for state maps (https://github.com/monitz87)
+
 - Add types for new Substrate proxy module
 - Adjust types for new Substrate (renamed) npos-elections module
 - `Call` now exposes `method` & `section` fields (aligned with `toHuman()` representation)
 - Cater for new Substrate string subscription ids (with backwards compatibility)
 - `@polkadot/util` 2.13

+
 ## 1.17.2 Jun 2, 2020

 - Ensure subscription promise resolves before first result

+
 ## 1.17.1 Jun 2, 2020

 - Fix `ElectionSize` type (Thanks to https://github.com/arjanz)
+
 - Allow `BTreeSet` decoding from Array/JSON inputs
 - Adjust Call-only metadata output to trim documentation to first full line
 - Safeguard against divide-by-zero for total era points (expired reward eras)
@@ -146,6 +201,7 @@ Upgrade priority: Medium, especially if using contracts.
 - Support for latest Substrate types & metadata
 - `@polkadot/util` 2.12

+
 ## 1.16.1 May 26, 2020

 - Support for Polkadot CC1 types & signed extensions
@@ -155,6 +211,7 @@ Upgrade priority: Medium, especially if using contracts.
 - Update to latest TypeScript, eslint & typescript-eslint
 - `@polkadot/util` 2.11

+
 ## 1.15.1 May 23, 2020

 - Adjust `keyPrefix()` with DoubleMap args (Thanks to https://github.com/KiChjang)
@@ -162,17 +219,20 @@ Upgrade priority: Medium, especially if using contracts.
 - Spelling fixes for console logs (Thanks to https://github.com/JoshOrndorff)
 - Spelling fixes in cookbook (Thanks to https://github.com/pawelnguyen)
 - Add `transactionVersion` getter in payloads (Thanks to https://github.com/amaurymartiny)
+
 - Adjust `stakerRewards` derive ordering for improved on-payout refreshes
 - Baseline implementation for derive caching infrastructure
 - Adjust `Multiplier` type to `Fixed128` (as per latest Substrate)
 - Updated to latest Substrate metadata & add new types

+
 ## 1.14.1 May 14, 2020

 - **Important** `DispatchInfo` changed `paysFee` to an enum, if using an older version use, `DispatchInfo: 'DispatchInfoTo244'`
+
 - Align imOnline `Heartbeat` with Substrate (Thanks to https://github.com/arjanz)
 - Adust EVM types to include `Vicinity` (Thanks to https://github.com/drewstone)
- Add `derive.democracy.locks` to return extended lock info based on votes
+
 - Ensure metadata is only requested once upon startup (bypass on upgrade subscriptions)
 - Expand testing around `ExtrinsicEra` construction
 - Expand `Registry` to direct access to available signed extensions (in addition to exposed types)
@@ -184,6 +244,7 @@ Upgrade priority: Medium, especially if using contracts.
 - Extends types for Polkadot claims
 - Update `@polkadot/util` to 2.10

+
 ## 1.13.1 May 6, 2020

 - Add support for ECDSA keypairs in extrinsic signers (Thanks to https://github.com/akru)
@@ -191,38 +252,46 @@ Upgrade priority: Medium, especially if using contracts.
 - Adjust extrinsic `sign/signAsync` signature to optional options (Thanks to https://github.com/KiChjang)
 - Support round-robin endpoints in the `WsProvider` with array of urls (Thanks to https://github.com/hoani)
 - Remove static test-only metadata for Polkadot dev chains (not updated regularly, Substrate dev to remain)
+
 - Revert error swallow for wrong preimage data (temp. override for Kusama upgrade with no migration)
 - Fix `.encodedLength` calculation on `[Type; N]` types
 - Add new `rpc.grandpa.roundState` RPC
 - Update types & metadata as per latest Substrate master
 - Adjust Centrifuge starting version

+
 ## 1.12.2 Apr 30, 2020

 - Update `@polkadot/util` to stable 2.9.1 (sadly missed in the previous version, stable should match to stable)

+
 ## 1.12.1 Apr 29, 2020

 - Fix `CompactAssignments` types (Thanks to https://github.com/arjanz)
 - Provider ayo-connect now allows for interval config (Thanks to https://github.com/jnaviask)
 - Cleanup generation for c-like enums (Thanks to https://github.com/monitz87)
 - Allow subscription to all storage keys, alignment with Substrate (Thanks to https://github.com/xlc)
+
 - Cater for vote delegations in democracy derives
 - Cleanup account derive flags where to allow for optional council modules
 - Allow generic types in ApiPromise.combineLatest
 - Update to latest substrate metadata

+
 ## 1.11.2 Apr 22, 2020

 - Small patch to add missing Polkadot master types (will be in next Kusama update)

+
 ## 1.11.1 Apr 21, 2020

 - **Important** Substrate master has an updated `Weight` (to `u64`), on older chains apply `Weight: 'u32'` (This does affect event decoding if wrongly set)
+
 - Allow user type augmentation to work with different versions of rxjs (Thanks to https://github.com/monitz87)
 - Align augmented generation with camelCase (Thanks to https://github.com/monitz87)
 - Fix bitfield endian encoding (Thanks to investigation by https://github.com/xlc)
 - Add account flag derives via `accounts.flags(accountId)` (Thanks to https://github.com/kwingram25)
+
 - Fix entries decoding for `Option<Number>` (& simplify, decoding correctly on rpc layer)
 - Add `system.{localPeerId, localListenAddresses}` & `state.getReadProof` RPCs
 - Ensure proper propagation of `api.runtimeVersion` (used for signing) after upgrade
@@ -235,9 +304,11 @@ Upgrade priority: Medium, especially if using contracts.
 - Enhance API support for non-subscription providers (skip subscription to runtimeVersion)
 - Adjust types for Kusama 1057 (notably the new `StakingLedger`)

+
 ## 1.10.1 Apr 13, 2020

 - **Important** Substrate master has updated staking, on older chains apply `StakingLedger: 'StakingLedgerTo240'`
+
 - Add `rpc.system.chainType` to retrieve the chain type (Development. Local, Live & Custom)
 - Adjust types for Westend after the reset
 - Adjust democracy derives, including the support of the frame-scheduler for scheduled deployments
@@ -248,10 +319,12 @@ Upgrade priority: Medium, especially if using contracts.
 - Internally all private/protected methods/variables are now `_` prefixed (Aligning with the `private/protected` indicators in the TS definitions)
 - Update metadata/docs-from-metadata to the latest Substrate

+
 ## 1.9.1 Apr 1, 2020

 - **Breaking change** (TypeScript with derives only) The return type names for `api.derive.*` have been adjusted for consistency, all starting with `Derive*` (previously a mixture of `Derived*` and `Derive*`)
 - **Breaking change** (derives only) Additional cleanups of democracy proposal & referenda derives, including support for new Polkadot/Substrate vote retrievals
+
 - Tx signing via `signAndSend` & `signAsync` now tries to use the last finalized block (depending on finalized drift)
 - Add support for `api.rpc.childstate.*` Substrate RPCs, older nodes with still populate `api.rpc.state.*` with the child methods
 - Adjust `Error.message` on RPC failures to not include the (already known) method signature
@@ -263,11 +336,13 @@ Upgrade priority: Medium, especially if using contracts.
 - Fix encoding for `Vec<u8>`-related types as part of constants
 - Internal adjustment of interface type locations (no impact on imports via `@polkadot/types/interfaces`)

+
 ## 1.8.1 Mar 22, 2020

 - **Breaking change** The format for any custom RPCs have been changed (alongside API-internal changes) to allow for better RPC management. If you are currently using custom RPCs (or planning to do so), look at the [updated documentation](https://polkadot.js.org/api/start/rpc.custom.html)
 - **Breaking change** Alongside API RPC changes, the `@polkadot/jsonrpc` package has been removed. Since it was never documented and only used internally, this should not have adverse impacts. All RPC definitions itself has now been moved to the relevant modules inside `@polkadot/types/interfaces`
 - **Important** Substrate has an updated democracy module. If using an older chain add the `ReferendumInfo: 'ReferendumInfoTo239'` type when using referendums
+
 - The `isRetracted` Extrinsic status is now a warning, not a fatal error, correctly aligning with Polkadot/Substrate
 - The Substrate extrinsic phase definitions has been expanded with `Initialization` to align with the latest versions
 - Add support for all known substrate RPC methods
@@ -275,9 +350,11 @@ Upgrade priority: Medium, especially if using contracts.
 - Adjusted referendum derives to cater for bot new/old democracy. Derived `referendumInfo` now includes `status` field, not `info`
 - Add `initWasm` flag to API options. When set to `false` does not init the WASM portion (leaving it to the user elsewhere)

+
 ## 1.7.1 Mar 17, 2020

 - **Important** Current versions of Polkadot/Substrate have dropped support for linked maps on storage entries. If you are using these queries to retrieve all entries, for instance `staking.{nominators,validators}()` and using an upgraded chain, you need to swap to retrieving entries via `.entries()` or `.keys()` for the keys.
+
 - Pull in support and types for latest Polkadot/Substrate
 - Add support for the new Substrate `state_getKeysPaged` RPC, including use in storage keys
 - Move `derive.staking.controllers` to `derive.staking.stashes`, reflecting actual content
@@ -285,13 +362,16 @@ Upgrade priority: Medium, especially if using contracts.
 - Expanded `derive.staking.*` derives, including addition of `derive.staking.own*`
 - Re-add fixed (with tests) checks for query args, previously disabled in 1.6.2

+
 ## 1.6.2 Mar 12, 2020

 - Revert checks for query args, not working on `.at()` queries (proper fix in next version)

+
 ## 1.6.1 Mar 12, 2020

 - **Breaking change** `api.rpc.state.queryStorage(...)` now fully decodes the `Vec<StorageChangeSet>` and returns a decoded `[Hash, Codec[]][]` when using this RPC.
+
 - `StorageKey` now has an `.args` property, decoded from meta where `twox64_concat` or `blake128_concat` are used on maps
 - Fix `api.query.*.*.entries` type conversions to return exact types (not `Option` in some cases)
 - Add `api.query.*.*.keys` to retrieve only the storage keys, similar to `.entries`
@@ -303,13 +383,16 @@ Upgrade priority: Medium, especially if using contracts.
 - Add runtime validation for map arguments to `api.query.*`
 - TypeScript interfaces for linked maps now correctly generates as `[Type, Linkage<Next>]`

+
 ## 1.5.1 Mar 06, 2020

 - **Important** Substrate master has updated staking, on older chains supply `StakingLedger: 'StakingLedgerTo223'`
 - **Important** Substrate master has updated collective, on older chains supply `Votes: 'VotesTo230'`
+
 - Add proper support for type generation with an Enum containing an Tuple (Thanks to https://github.com/monitz87)
 - Fix storage parsing not resulting in rejected Promises (Fix from https://github.com/aniiantt applied)
 - Remove use of deprecated `Observable.create` (Thanks to https://github.com/Himself65)
+
 - Add types & metadata for the latest Polkadot/Substrate runtime versions (master branches)
 - Type extraction will now allow the same sub-module name across packages, i.e. `@polkadot/types/interfaces/runtime` & `@mine/interfaces/runtime` will be valid
 - Add `.range([from, to]: [Hash, Hash?], ...args: any[]): [Hash, Codec][]` on all storage entries
@@ -323,17 +406,21 @@ Upgrade priority: Medium, especially if using contracts.
 - Add additional derives to `api.derive.staking` to handle lazy-payout retrievals
 - Update `@polkadot/{util, util-crypto, keyring}` to 1.6.1 & `@polkadot/wasm` to 1.2.1

+
 ## 1.4.2 Feb 27, 2020

 - Fix `api.tx(<extrinsic>): Submittable` decoration (non-working in 1.4.1, now with proper test)

+
 ## 1.4.1 Feb 26, 2020

 - **Breaking change** (TypeScript only) The `*.d.ts` files now contain TypeScript 3.8 features (specifically `#private`), which is not usable in TS versions < 3.8
 - **Breaking change** - `api.derive.staking.*` has updated result types and detects support for lazy payouts queries
+
 - Rework type generation for `api.{query, tx}` to properly handle complex type inputs (Thanks to https://github.com/monitz87)
 - Rework metadata `--strict` mode to effectively decorate chain metadata (Thanks to https://github.com/monitz87)
 - Add `api.rpc.chain.subscribeAllHeads` (not just best) (Thanks to https://github.com/jak-pan)
+
 - Add `api.rpc.engine.*` for manual seal support
 - Add `api.injectMetadata(metadata)` to initialize API with a specific metadata version
 - The api now checks for runtime upgrades, augmenting the interfaces with new metadata when found
@@ -353,18 +440,23 @@ Upgrade priority: Medium, especially if using contracts.
 - Cleanup augmentation and generation scripts for type definitions, aligning with api augmentation
 - Bump to `@polkadot/{util, util-crypto, keyring}` 2.5.1

+
 ## 1.3.1 Feb 18, 2020

 - Add `@types/bn.js` as a normal dependency, exposed in `*.d.ts` (Thanks to https://github.com/monitz87)
+
 - Type generation scripts (including `polkadot-types-from-{chain,defs}`) has been moved to the `@polkadot/typegen` package
 - The `@polkadot/types/codec/create` has been moved to `@polkadot/types/create`, imports from `@polkadot/types` are unaffected
 - Expose chain properties on registry (and use for API type formatting)
 - Add `toHuman(isExtended?: boolean)` to all codec types, formatting into a human-readable structure

+
 ## 1.2.1 Feb 16, 2020

 - **Important** Update RPC status codes (latest Substrate 2), with the `isInBlock` (`isFinalized` now indicates finality)
+
 - Storage `.entries(arg?: any)` now has the correct argument type for DoubleMap (Thanks to https://github.com/monitz87)
+
 - Swap Kusama and Polkadot aliases for `Address` to `AccountId` (future update)
 - Add `LookupSource` and `LookupTarget` types instead of mapping these directly for aliasing
 - Add `BitVec` type primitive
@@ -379,9 +471,11 @@ Upgrade priority: Medium, especially if using contracts.
 - Cleanup `codec/Date` tests to make it run properly on all timezones
 - Add explicit dependencies to all packages and move TypeScript `@types/*` to dev deps

+
 ## 1.1.1 Feb 06, 2020

 - **Important** Chains without `balances.account` or `system.account` should supply `"BalanceLock": "BalanceLockTo212"` to their types to use the previous-generation `BalanceLock` (when querying locks)
+
 - Add support for `balances.account` in all applicable derives (incl. `vesting` module)
 - Inject and use SignedExtensions by name from V11 metadata (V4 extrinsics only)
 - Add typings for `api.tx.*.*` - the `polkadot-types-from-chain` now also generates these
@@ -393,11 +487,14 @@ Upgrade priority: Medium, especially if using contracts.
 - Adjust balances fees derivation with optional transfer and creation fees (removed in Substrate)
 - Adjust enum `.toJSON()` to return type name as specified

+
 ## 1.0.1 Jan 30, 2020

 - **Breaking change** Drop support for Substrate v1 chain in all derives
+
 - Return unsub functions from provider .on emitters (Thanks to https://github.com/jak-pan)
 - `ApiPromise.isReady` now rejects on unrecoverable errors (Thanks to https://github.com/laec)
+
 - Add `polkadot-types-from-chain` & `polkadot-types-from-defs` TypeScript generators to `@polkadot/types`
 - Only decorate derives where relevant parent `api.query.*` is available
 - Support `.entries(arg?: any)` lookups on DoubleMaps (in addition to previously supported maps)
@@ -412,9 +509,11 @@ Upgrade priority: Medium, especially if using contracts.
 - Remove support for un-deployed metadata
 - Remove old known types for Substrate V1

+
 ## 0.100.1 Jan 13, 2020

 - **Important** This will the the last API version with Substrate 1.x support. Although you will still be able to use subsequent versions with older chains, dependent libraries such as sr25519 may not be compatible.
+
 - Add support for the Substrate identity module
 - Remove the `codec/Data` type, to remove a conflict with Substrate. This type is now named `Raw`
 - Fix for linked maps using `Option`
@@ -423,36 +522,43 @@ Upgrade priority: Medium, especially if using contracts.
 - Add support for latest Polkadot/Substrate types
 - Add `paymentInfo` to submittables to calculate fees

+
 ## 0.99.1 Dec 13, 2019

 - **Breaking change** The `Data` and `U8a` type has been renamed and just replaced with the `Raw` type
 - **Breaking change** The `api.derive.staking.info` has been split into 2 - `staking.query` for non-balance related information (more effective) and `staking.account` that enhances query for all the information previously found `.info`
+
 - Cleanup `DoubleMap` hashing to always hash over the full value (in the case of `Vec<T>`, this includes the length)
 - Update democracy derives to take care of nextTally and lowestUnbaked
 - Add additional derives for both council & treasury
 - Alignment with latest Polkadot/Substrate master branch types

+
 ## 0.98.1 Dec 04, 2019

 - Make the TypeScript generation script mor re-usable (Thanks to https://github.com/xlc)
 - Add `.entries()` for all map-types, returning storage keys and values
 - Add `.signAsync` to submittable extrinsics (Thanks to https://github.com/c410-f3r)
+
 - Cleanup circular references between internal dependencies
 - Support for new Substrate democracy with preimages in derive
 - Alignment of types with Substrate/Polkadot master branches

+
 ## 0.97.1 Nov 29, 2019

 - **Breaking change** Add the passing on an explicit `Registry` to all calls to `createType` as well as all codec classes. If you are upgrading form an older version, use the [migration guide](UPGRADING.md) to walk through the changes required.
 - **Breaking change** The metadata classes have been moved from `@polkadot/types` into `@polkadot/metadata`. If you explicitly create `Metadata` classes, you now would need to do so with the `import Metadata from '@polkadot/metadata';` This is a decorated class, where the previous metadata is now available on `Metadata.metadata`, alongside decorated `consts.*`', `tx.*` and `query.*`.
 - **Breaking change** Session `Keys` defaults to 4 keys now (Substrate master), depending on your node config, you would want to override with e.g. `Keys: 'SessionKeys3'` (1, 2, 3, 4, 5 & 6)
 - **Breaking change** `ValidatorPrefs` now default to the new percentage commission model, to use the previous `validatorPayment`, you can override with `ValidatorPrefs: 'ValidatorPrefsTo196'`
+
 - `api.derive.*` now has built-in memomization
 - Various fixes and cleanups to `api.derive.*` including era length progress and vesting calculations
 - Aligned all types with the latest Polkadot & Substrate, including Kusama CC3
 - Support for Metadata V9, which adjusts the hashing methods of storage entries
 - Support for Metadata V10 (still un-released), which includes prefixed map support

+
 ## 0.96.1 Nov 09, 2019

 - Updated types for latest Kusama
@@ -463,10 +569,12 @@ Upgrade priority: Medium, especially if using contracts.
 - Update council derives for the latest Substrate master support (with constants)
 - Derive cleanups, including sharing of instances between the API and internal to derives

+
 ## 0.95.2 Oct 25, 2019

 - Temporary removal of `account_nextIndex` use, will be re-added in a future release

+
 ## 0.95.1 Oct 25, 2019

 - Support Extrinsic V4 with additional signature indicator (Latest Polkadot/Substrate/Kusama)
@@ -477,6 +585,7 @@ Upgrade priority: Medium, especially if using contracts.
 - All latest Polkadot & Substrate types (as per master branches)
 - **Breaking change** `Call.injectMethods` is moved to `Call.injectMetadata` to align with `Events` (This _should_ not be used externally, however mentioned as breaking here)

+
 ## 0.94.1 Oct 07, 2019

 - Add handling of `Result<Ok, Error>` definitions
@@ -489,6 +598,7 @@ Upgrade priority: Medium, especially if using contracts.
 - Add documentation for custom extrinsic formats (advanced chains)
 - Update to latest substrate master metadata

+
 ## 0.93.1 Sep 26, 2019

 - Support for Kusama CC2
@@ -499,6 +609,7 @@ Upgrade priority: Medium, especially if using contracts.
 - Support recursive type registration (self-referencing via `Box`) in addition to better sanitation of user-defined-types
 - Documentation and example updates (thanks mostly to contributions)

+
 ## 0.92.1 Sep 12, 2019

 - The API now correctly sets the ss58 prefix as retrieved from the chain properties via `ss58Format`
@@ -507,6 +618,7 @@ Upgrade priority: Medium, especially if using contracts.
 - Support the latest Polkadot & Substrate master branches (incl. metadata updates)
 - Getting started documentation has been made available

+
 ## 0.91.1 Sep 09, 2019

 - This release was focussed on stability, with a number of cleanups and bug-fixes
@@ -521,6 +633,7 @@ Upgrade priority: Medium, especially if using contracts.
  - **Breaking change** `SignerPayload` is renamed to `SignerPayloadJSON`
  - **Breaking change** `SignerPayloadJSON`, `SignerPayloadRawBase` and `SignerPayloadRaw` are all moved to `@polkadot/types`

+
 ## 0.90.1 Aug 24, 2019

 If you are upgrading form an older version, use the CHANGELOG hand-in-hand with the [migration guide](UPGRADING.md).
@@ -534,6 +647,7 @@ If you are upgrading form an older version, use the CHANGELOG hand-in-hand with
  - For creation of types, it is recommended to use `createType(<TypeName>, <value>)` instead of e.g. `new Proposal(...)`. When passing these to methods/queries, construction should not be needed, the raw value can be passed.
  - For moved types, a previous import would have been from `@polkadot/types`, i.e. `import { SetIndex } from '@polkadot/types`, now just the interfaces (TypeScript) are available via `import { SetIndex } from '@polkadot/types/interfaces`
  - `usize` is now a blacklisted type that will throw on construction. Since it is platform-specific, it creates incompatibilities between native (generally `u64`) and WASM (always `u32`) code. Use one of the `u32` or `u64` types explicitly.
+
 - Support substrate v7 metadata
 - The `Method.findFunction(callIndex)` (allowing decoding of raw data), is now available on `api.findCall(callIndex)`. To keep backwards compatibility, it is still available on `GenericCall.findMethod` but the `api.findCall` is recommended and suggested.
 - The `types/codec/createType` has been moved to `types/codec/create` with the same exports. If you explicitly imported from here (and not doing the suggested `import { createType } from '@polkadot/types`), the reference needs to be updated
@@ -635,7 +749,6 @@ If you are upgrading form an older version, use the CHANGELOG hand-in-hand with
 - Change spelling to US English as per substrate master (1.0-rc1). Breaking changes as a result:
  - For extrinsic status results, if you have checked the type returns, i.e. `result.type === 'Finalised'` now check on the status for `result.status.isFinalized` or `result.status.isBroadcast`, ... (the `type` property is now accessible only on `result.status.type`)
  - If using `subscribeFinalisedHeads` update this to `subscribeFinalizedHeads` (likewise `getFinalisedHead` should be updated to `getFinalizedHead` and `derive.bestNumberFinalized`)
-
 - The underlying ss58 address checksums have changed
  - The updated keyring with support for this has been made available
  - All examples have been updated with sr25519 addresses (with the new checksums)
@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+function copy_folder () {
+  SRC="packages/$1/build"
+  DST="../test/js-test/node_modules/@polkadot/$1"
+
+  echo "** Copying $SRC to $DST"
+
+  rm -rf $DST
+  cp -r $SRC $DST
+}
+
+yarn polkadot-dev-build-ts
+
+copy_folder "api"
+copy_folder "api-contract"
+copy_folder "api-derive"
+copy_folder "metadata"
+copy_folder "rpc-core"
+copy_folder "rpc-provider"
+copy_folder "types"
+copy_folder "types-known"
+copy_folder "typegen"
@@ -90,7 +90,7 @@ Looking at the example in this repo, it also has `augment*`, `index.ts` and `typ

 ## Generating

-Now that both the metadata nd types setup is completed, we just run the build command via `yarn build` and magically (assuming you didn't have the `augment*` and other generated files), these files will be added. When running this command, the console should display something like -
+Now that both the metadata and types setup is completed, we just run the build command via `yarn build` and magically (assuming you didn't have the `augment*` and other generated files), these files will be added. When running this command, the console should display something like -

 ```
 > yarn build
@@ -166,7 +166,7 @@ As mentioned earlier, here you will notice the `import { VoteStage }`, the gener

 ## TypeScript config

-Now that we have files generated, it is time to make TypeScript aware of the types and add an explicit override into out `tsconfig.json`. After some changes, the paths in the config looks as follow (comments are in teh actual config file here) -
+Now that we have files generated, it is time to make TypeScript aware of the types and add an explicit override into out `tsconfig.json`. After some changes, the paths in the config looks as follow (comments are in the actual config file here) -

 ```json
 {
@@ -22,7 +22,6 @@ To fix this, you should look at the specific `api.tx.*` params and adjust the ty

 If you are using a node-template based version of substrate and you changed the specName you need to add these typings(In addition to other custom types) `{"Address": "AccountId","LookupSource": "AccountId"}`. This is also the case when you use [polkadot-js/apps](https://github.com/polkadot-js/apps) to connect to your node. When the specName stays node-template the API is smart enough to add the custom typings.

-
 ## I would like to sign transactions offline

 The API itself is independent on where the signature comes from and how it is injected. Additionally it implements a signer interface, that can be used for external signing - an example of this is the [polkadot-js/apps](https://github.com/polkadot-js/apps) support for signing via extensions and even the [polkadot-js/extension](https://github.com/polkadot-js/extension) support for tools such as the [Parity Signer](https://github.com/paritytech/parity-signer).
@@ -66,16 +65,3 @@ Due to these customizations and differences that bleed through to the transactio
 Recently Substrate master updated the `Weight` type from `u32` -> `u64`. This type is used in the `DispatchInfo` struct in the `system.ExtrinsicSuccess` events, to return the applied call weights as well as the resulting fees. Since the API master branch tracks Substrate master, this means the change has been applied by default, with the default set to `u64`.

 If you are on a chain that has not been upgraded yet, you need to add `Weight: 'u32'` to your types to allow for successful parsing of all events. Without this override, parsing will fail. As soon as one event in the `Vec<EventRecord>` structure from `system.events` fails to parse, all subsequent events are affected and the decoding will return an error.
-
-## When querying older blocks & events, it fails on parsing
-
-Upon initialization, the API is decorated with the [current on-chain metadata](basics.md#metadata) and (if [available](https://github.com/polkadot-js/api/tree/master/packages/types-known/src)) the specific types for the runtime version is added. This allows the API to decode all current (as per the on-chain info) state and extrinsics.
-
-When the chain is upgraded, new metadata (indicating new events, storage and extrinsics) is added on-chain. Additionally this generally goes hand in-hand with changes in types, i.e. fields may be addedd or removed or state that was used could now be migrated to new locations. In most cases, this would mean that the current chain information cannot be used to parse older entries pre-upgrade. A typical consequence of this is that any `.at(...)` or `.range(...)` queries pre-upgrade may fail.
-
-As of the current time, there is no automatic injection of older metadata (based on the runtime version at a specific block) nor decoration of older types if they are available. It can be emulated with what the API will do to handle these cases when it adds a `.historic(...)` query type -
-
- querying the runtime version at the parent of older block you wish to retrieve
- retrieving and injecting the metadata from the parent block (if the runtime version has changed)
- inject any specific older types for the state at that point
- finally retrieve the actual entry via an `.at(...)` query
@@ -42,7 +42,7 @@ Be aware that while defined, the method will only appear on the API if it is in

 ## Definition breakdown

-While the above example should be self-explanatory, it is important to understand teh structure. The `rpc: { ... }` definitions are keyed first and foremost by the name of the module exposing the RPC. This means that when we have 2 modules `firstModule` & `testModule`, the first-level structure would follow the following pattern,
+While the above example should be self-explanatory, it is important to understand the structure. The `rpc: { ... }` definitions are keyed first and foremost by the name of the module exposing the RPC. This means that when we have 2 modules `firstModule` & `testModule`, the first-level structure would follow the following pattern,

 ```js
 ...
@@ -20,7 +20,7 @@ With the conversions done in the API, there are limited reasons to create types
 import type { Balance } from '@polkadot/types/interfaces';

 ...
-// unwrap out option into a zero Balance whn not found
+// unwrap out option into a zero Balance when not found
 // (This can be done via `.unwrapOrDefault()`, which does the same underlying)
 const balance: Balance = balanceOpt.unwrapOr(api.createType('Balance'));
 ```
@@ -6,7 +6,7 @@ Therefore to cater for all types, a mapping in done on the [@polkadot/types libr

 Additionally, the API contains some logic for chain type detection, for instance in the case of Substrate 1.x based chains, it will define `BlockNumber` & `Index` (nonce) as a `u64`, while for current-generation chains, these will be defined as `u32`. Some of the work in maintaining the API for Polkadot/Substrate is the addition of types as they appear and gets used in the Rust codebase.

-There is a the [recommendation](install.md#betas) to use a `@polkadot/api@beta` should you wish to track the master branches of Polkadot or Substrate, since master changes for the addition of new types do not make it into a stable release immediately.
+There is the [recommendation](install.md#betas) to use a `@polkadot/api@beta` should you wish to track the master branches of Polkadot or Substrate, since master changes for the addition of new types do not make it into a stable release immediately.

 ## Extension

@@ -87,7 +87,7 @@ Document: {

 ## User-defined enum

-One form of types that appear regularly is enums, these can be defined as follow -
+One form of types that appear regularly is enums, these can be defined as follows -

 ```js
 ...
@@ -212,4 +212,4 @@ Always look at customization and understand the impacts, replicating these chang

 ## Custom RPC

-In addition to customizing modules and types on your node, you can also add custom RPC definitions. Like the type definitions in ths section, [these can be defined and passed to the API](rpc.custom.md) for decoration.
+In addition to customizing your node's modules and types, you can also add custom RPC definitions. Like the type definitions in this section, [these can be defined and passed to the API](rpc.custom.md) for decoration.
@@ -1,6 +1,6 @@
 # TypeScript user generated

-In the previous section we looked at the TypeScript definitions that are available and is generated from both the chain and definitions. Here we will expand upon the use of the infrastructure created to define types as part of the `@polkadot/types` library and see how to use them to generate your own definitions and chain types.
+In the previous section we looked at the TypeScript definitions that are available and are generated from both the chain and definitions. Here we will expand upon the use of the infrastructure created to define types as part of the `@polkadot/types` library and see how to use them to generate your own definitions and chain types.

 ## Definitions

@@ -17,7 +17,7 @@ In the root of your project (with the `@polkadot/typegen` package installed), yo

 ## Chain modules

-In the same way as the type library provides defaults from a substrate-base chain, you can also, directly from chain from metadata, generate a complete `api.{consts,query}.*` definition for your specific chain. The command will create 2 files, `{consts, query}.types.ts` which you can either use to augment the TypeScript definitions, or replace those in `@polkadot/api/*` with your versions (copy, TypeScript replacement or browser/node aliasing).
+In the same way as the type library provides defaults from a substrate-base chain, you can also, directly from the chain's metadata, generate a complete `api.{consts,query}.*` definition for your specific chain. The command will create 2 files, `{consts, query}.types.ts` which you can either use to augment the TypeScript definitions, or replace those in `@polkadot/api/*` with your versions (copy, TypeScript replacement or browser/node aliasing).

 In the root of your project, you can run `yarn polkadot-types-from-chain --endpoint wss://<url> --output ./stuff` and it will create the required output. (Here you can specify an optional `--package @MeInc/stuff` to read definitions for the targeted output folder with the specified package name.)

@@ -27,4 +27,4 @@ The [TypeScript augmentation example](../examples/promise/90_typegen/) example p

 ## And that's a wrap

-This brings us to the end of our overview and jump through the API. While the documentation is still very much and ever evolving item, we can encourage you to try out what you have learned with some [examples](../examples). As we [indicated right at the start of this journey](README.md#help-us-help-others), if there are areas for improvement, let us know.
+This brings us to the end of our overview and jump through the API. While the documentation is still very much an ever evolving item, we can encourage you to try out what you have learned with some [examples](../examples). As we [indicated right at the start of this journey](README.md#help-us-help-others), if there are areas for improvement, let us know.
@@ -9,5 +9,5 @@
  "packages": [
    "packages/*"
  ],
-  "version": "1.30.1"
+  "version": "1.31.1"
 }
@@ -27,12 +27,15 @@
    "@babel/core": "^7.11.4",
    "@babel/register": "^7.10.5",
    "@babel/runtime": "^7.11.2",
-    "@polkadot/dev": "^0.55.39",
-    "@polkadot/ts": "^0.3.39",
+    "@polkadot/dev": "^0.55.43",
+    "@polkadot/ts": "^0.3.40",
    "@polkadot/typegen": "workspace:packages/typegen",
    "@types/jest": "^26.0.10",
    "@vuepress/plugin-search": "^1.5.4",
-    "copyfiles": "^2.3.0"
+    "copyfiles": "^2.3.0",
+    "typedoc": "^0.18.0",
+    "typedoc-plugin-markdown": "^2.4.2",
+    "typedoc-plugin-no-inherit": "^1.1.10"
  },
-  "version": "1.30.1"
+  "version": "1.31.1"
 }
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/api-contract",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "Interfaces for interacting with contracts and contract ABIs",
  "main": "index.js",
  "keywords": [
@@ -27,10 +27,10 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/api-contract#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/api": "1.30.1",
-    "@polkadot/rpc-core": "1.30.1",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/util": "^3.3.1",
+    "@polkadot/api": "1.31.1",
+    "@polkadot/rpc-core": "1.31.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/util": "^3.4.1",
    "bn.js": "^5.1.3",
    "rxjs": "^6.6.2"
  }
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/api-derive",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "Common functions used across Polkadot, derived from RPC calls and storage queries.",
  "main": "index.js",
  "keywords": [
@@ -28,17 +28,17 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/api-derive#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/api": "1.30.1",
-    "@polkadot/rpc-core": "1.30.1",
-    "@polkadot/rpc-provider": "1.30.1",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/util": "^3.3.1",
-    "@polkadot/util-crypto": "^3.3.1",
+    "@polkadot/api": "1.31.1",
+    "@polkadot/rpc-core": "1.31.1",
+    "@polkadot/rpc-provider": "1.31.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/util": "^3.4.1",
+    "@polkadot/util-crypto": "^3.4.1",
    "bn.js": "^5.1.3",
    "memoizee": "^0.4.14",
    "rxjs": "^6.6.2"
  },
  "devDependencies": {
-    "@polkadot/keyring": "^3.3.1"
+    "@polkadot/keyring": "^3.4.1"
  }
 }
@@ -17,6 +17,8 @@ import { memo } from '../util';
 type ResultBalance = [VestingInfo | null, (BalanceLock | BalanceLockTo212)[]];
 type Result = [DeriveBalancesAccount, BlockNumber, ResultBalance];

+const VESTING_ID = '0x76657374696e6720';
+
 function calcBalances (api: ApiInterfaceRx, [{ accountId, accountNonce, freeBalance, frozenFee, frozenMisc, reservedBalance, votingBalance }, bestNumber, [vesting, locks]]: Result): DeriveBalancesAll {
  let lockedBalance = api.registry.createType('Balance');
  let lockedBreakdown: (BalanceLock | BalanceLockTo212)[] = [];
@@ -30,7 +32,7 @@ function calcBalances (api: ApiInterfaceRx, [{ accountId, accountNonce, freeBala
    const notAll = lockedBreakdown.filter(({ amount }) => !amount.isMax());

    allLocked = lockedBreakdown.some(({ amount }) => amount.isMax());
-    vestingLocked = api.registry.createType('Balance', lockedBreakdown.filter(({ id }) => id.eq('0x76657374696e6720')).reduce((result: BN, { amount }) => result.iadd(amount), new BN(0)));
+    vestingLocked = api.registry.createType('Balance', lockedBreakdown.filter(({ id }) => id.eq(VESTING_ID)).reduce((result: BN, { amount }) => result.iadd(amount), new BN(0)));

    // get the maximum of the locks according to https://github.com/paritytech/substrate/blob/master/srml/balances/src/lib.rs#L699
    if (notAll.length) {
@@ -11,7 +11,7 @@ import { HeaderExtended } from '../type';
 import { memo } from '../util';

 /**
- * @name bestNumberFinalized
+ * @name getHeader
 * @param {( Uint8Array | string )} hash - A block hash as U8 array or string.
 * @returns An array containing the block header and the block author
 * @description Get a specific block header and extend it with the author
@@ -2,7 +2,7 @@
 // This software may be modified and distributed under the terms
 // of the Apache-2.0 license. See the LICENSE file for details.

-import { AccountId, ReferendumInfo, ReferendumInfoTo239, VotingDirect, VotingDirectVote } from '@polkadot/types/interfaces';
+import { AccountId, ReferendumInfo, ReferendumInfoTo239, VotingDelegating, VotingDirect, VotingDirectVote } from '@polkadot/types/interfaces';
 import { ApiInterfaceRx } from '@polkadot/api/types';
 import { DeriveDemocracyLock } from '../types';

@@ -20,16 +20,37 @@ const ZERO = new BN(0);
 function parseLock (api: ApiInterfaceRx, [referendumId, accountVote]: VotingDirectVote, referendum: ReferendumInfo): DeriveDemocracyLock {
  const { balance, vote } = accountVote.asStandard;
  let unlockAt = ZERO;
+  let referendumEnd = ZERO;

  if (referendum.isFinished) {
    const { approved, end } = referendum.asFinished;

+    referendumEnd = end;
+
    if ((approved.isTrue && vote.isAye) || (approved.isFalse && vote.isNay)) {
      unlockAt = end.add(api.consts.democracy.enactmentPeriod.muln(LOCKUPS[vote.conviction.index]));
    }
  }

-  return { balance, isFinished: referendum.isFinished, referendumId, unlockAt, vote };
+  return { balance, isDelegated: false, isFinished: referendum.isFinished, referendumEnd, referendumId, unlockAt, vote };
+}
+
+function delegateLocks (api: ApiInterfaceRx, { balance, conviction, target }: VotingDelegating): Observable<DeriveDemocracyLock[]> {
+  return api.derive.democracy.locks(target).pipe(
+    map((available): DeriveDemocracyLock[] =>
+      available.map(({ isFinished, referendumEnd, referendumId, unlockAt, vote }): DeriveDemocracyLock => ({
+        balance,
+        isDelegated: true,
+        isFinished,
+        referendumEnd,
+        referendumId,
+        unlockAt: unlockAt.isZero()
+          ? unlockAt
+          : referendumEnd.add(api.consts.democracy.enactmentPeriod.muln(LOCKUPS[conviction.index])),
+        vote: api.registry.createType('Vote', { aye: vote.isAye, conviction })
+      }))
+    )
+  );
 }

 function directLocks (api: ApiInterfaceRx, { votes }: VotingDirect): Observable<DeriveDemocracyLock[]> {
@@ -59,7 +80,9 @@ export function locks (api: ApiInterfaceRx): (accountId: string | AccountId) =>
      switchMap((voting): Observable<DeriveDemocracyLock[]> =>
        voting.isDirect
          ? directLocks(api, voting.asDirect)
-          : of([])
+          : voting.isDelegating
+            ? delegateLocks(api, voting.asDelegating)
+            : of([])
      )
    )
  );
@@ -9,7 +9,9 @@ import { Vec } from '@polkadot/types';

 export interface DeriveDemocracyLock {
  balance: Balance;
+  isDelegated: boolean;
  isFinished: boolean;
+  referendumEnd: BN;
  referendumId: ReferendumIndex;
  unlockAt: BN;
  vote: Vote;
@@ -9,6 +9,7 @@ import { Observable, of, combineLatest } from 'rxjs';
 import { map, switchMap } from 'rxjs/operators';
 import { ApiInterfaceRx } from '@polkadot/api/types';
 import { Bytes, Option, u32 } from '@polkadot/types';
+import { BN_ZERO } from '@polkadot/util';

 import { memo } from '../util';

@@ -34,7 +35,7 @@ export function receivedHeartbeats (api: ApiInterfaceRx): () => Observable<Deriv
            [validator.toString()]: {
              blockCount: numBlocks[index],
              hasMessage: !heartbeats[index].isEmpty,
-              isOnline: !heartbeats[index].isEmpty || numBlocks[index].gtn(0)
+              isOnline: !heartbeats[index].isEmpty || numBlocks[index].gt(BN_ZERO)
            }
          }), {})
        )
@@ -9,43 +9,29 @@ import { DeriveSessionInfo, DeriveStakingAccount, DeriveStakingQuery, DeriveUnlo
 import BN from 'bn.js';
 import { Observable } from 'rxjs';
 import { map, switchMap } from 'rxjs/operators';
-
-import { isUndefined } from '@polkadot/util';
+import { BN_ZERO } from '@polkadot/util';

 import { memo } from '../util';

-// groups the supplied chunks by era, i.e. { [era]: BN(total of values) }
 function groupByEra (list: UnlockChunk[]): Record<string, BN> {
  return list.reduce((map: Record<string, BN>, { era, value }): Record<string, BN> => {
    const key = era.toString();

-    map[key] = !map[key]
-      ? value.unwrap()
-      : map[key].iadd(value.unwrap());
+    map[key] = (map[key] || BN_ZERO).add(value.unwrap());

    return map;
  }, {});
 }

 function calculateUnlocking (api: ApiInterfaceRx, stakingLedger: StakingLedger | undefined, sessionInfo: DeriveSessionInfo): DeriveUnlocking[] | undefined {
-  if (isUndefined(stakingLedger)) {
-    return undefined;
-  }
-
-  const unlockingChunks = stakingLedger.unlocking.filter(({ era }) =>
-    era.unwrap().gt(sessionInfo.activeEra)
-  );
-
-  if (!unlockingChunks.length) {
-    return undefined;
-  }
-
-  // group the unlock chunks that have the same era and sum their values
-  const groupedResult = groupByEra(unlockingChunks);
-  const results = Object.entries(groupedResult).map(([eraString, value]): DeriveUnlocking => ({
-    remainingEras: new BN(eraString).isub(sessionInfo.activeEra),
-    value: api.registry.createType('Balance', value)
-  }));
+  const results = Object
+    .entries(groupByEra(
+      (stakingLedger?.unlocking || []).filter(({ era }) => era.unwrap().gt(sessionInfo.activeEra))
+    ))
+    .map(([eraString, value]): DeriveUnlocking => ({
+      remainingEras: new BN(eraString).isub(sessionInfo.activeEra),
+      value: api.registry.createType('Balance', value)
+    }));

  return results.length
    ? results
@@ -53,11 +39,7 @@ function calculateUnlocking (api: ApiInterfaceRx, stakingLedger: StakingLedger |
 }

 function redeemableSum (api: ApiInterfaceRx, stakingLedger: StakingLedger | undefined, sessionInfo: DeriveSessionInfo): Balance {
-  if (isUndefined(stakingLedger)) {
-    return api.registry.createType('Balance');
-  }
-
-  return api.registry.createType('Balance', stakingLedger.unlocking.reduce((total, { era, value }): BN => {
+  return api.registry.createType('Balance', (stakingLedger?.unlocking || [] as UnlockChunk[]).reduce((total, { era, value }): BN => {
    return sessionInfo.activeEra.gte(era.unwrap())
      ? total.iadd(value.unwrap())
      : total;
@@ -8,6 +8,7 @@ import { DeriveEraPoints, DeriveEraValPoints } from '../types';

 import { Observable, of } from 'rxjs';
 import { map, switchMap } from 'rxjs/operators';
+import { BN_ZERO } from '@polkadot/util';

 import { deriveCache, memo } from '../util';

@@ -15,7 +16,7 @@ const CACHE_KEY = 'eraPoints';

 function mapValidators ({ individual }: EraRewardPoints): DeriveEraValPoints {
  return [...individual.entries()]
-    .filter(([, points]): boolean => points.gtn(0))
+    .filter(([, points]) => points.gt(BN_ZERO))
    .reduce((result: DeriveEraValPoints, [validatorId, points]): DeriveEraValPoints => {
      result[validatorId.toString()] = points;

@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/api",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "Promise and RxJS wrappers around the Polkadot JS RPC",
  "main": "index.js",
  "keywords": [
@@ -27,20 +27,20 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/api#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/api-derive": "1.30.1",
-    "@polkadot/keyring": "^3.3.1",
-    "@polkadot/metadata": "1.30.1",
-    "@polkadot/rpc-core": "1.30.1",
-    "@polkadot/rpc-provider": "1.30.1",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/types-known": "1.30.1",
-    "@polkadot/util": "^3.3.1",
-    "@polkadot/util-crypto": "^3.3.1",
+    "@polkadot/api-derive": "1.31.1",
+    "@polkadot/keyring": "^3.4.1",
+    "@polkadot/metadata": "1.31.1",
+    "@polkadot/rpc-core": "1.31.1",
+    "@polkadot/rpc-provider": "1.31.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/types-known": "1.31.1",
+    "@polkadot/util": "^3.4.1",
+    "@polkadot/util-crypto": "^3.4.1",
    "bn.js": "^5.1.3",
-    "eventemitter3": "^4.0.5",
+    "eventemitter3": "^4.0.6",
    "rxjs": "^6.6.2"
  },
  "devDependencies": {
-    "@polkadot/keyring": "^3.3.1"
+    "@polkadot/keyring": "^3.4.1"
  }
 }
@@ -2240,7 +2240,7 @@ declare module '@polkadot/api/types/submittable' {
       * - Write: Bonded, Payee, [Origin Account], Locks, Ledger
       * # </weight>
       **/
-      bond: AugmentedSubmittable<(controller: LookupSource | Address | AccountId | AccountIndex | LookupSource | string | Uint8Array, value: Compact<BalanceOf> | AnyNumber | Uint8Array, payee: RewardDestination | 'Staked'|'Stash'|'Controller' | number | Uint8Array) => SubmittableExtrinsic<ApiType>>;
+      bond: AugmentedSubmittable<(controller: LookupSource | Address | AccountId | AccountIndex | LookupSource | string | Uint8Array, value: Compact<BalanceOf> | AnyNumber | Uint8Array, payee: RewardDestination | { Staked: any } | { Stash: any } | { Controller: any } | { Account: any } | string | Uint8Array) => SubmittableExtrinsic<ApiType>>;
      /**
       * Add some extra amount that have appeared in the stash `free_balance` into the balance up
       * for staking.
@@ -2535,7 +2535,7 @@ declare module '@polkadot/api/types/submittable' {
       * - Write: Payee
       * # </weight>
       **/
-      setPayee: AugmentedSubmittable<(payee: RewardDestination | 'Staked'|'Stash'|'Controller' | number | Uint8Array) => SubmittableExtrinsic<ApiType>>;
+      setPayee: AugmentedSubmittable<(payee: RewardDestination | { Staked: any } | { Stash: any } | { Controller: any } | { Account: any } | string | Uint8Array) => SubmittableExtrinsic<ApiType>>;
      /**
       * Sets the ideal number of validators.
       * 
@@ -45,7 +45,7 @@ const PAGE_SIZE_VALS = PAGE_SIZE_KEYS;
 const l = logger('api/init');

 export default abstract class Decorate<ApiType extends ApiTypes> extends Events {
-  public readonly registry: Registry;
+  #registry: Registry;

  // HACK Use BN import so decorateDerive works... yes, wtf.
  protected __phantom = new BN(0);
@@ -127,7 +127,7 @@ export default abstract class Decorate<ApiType extends ApiTypes> extends Events
  constructor (options: ApiOptions, type: ApiTypes, decorateMethod: DecorateMethod<ApiType>) {
    super();

-    this.registry = options.registry || new TypeRegistry();
+    this.#registry = options.registry || new TypeRegistry();

    const thisProvider = options.source
      ? options.source._rpcCore.provider.clone()
@@ -136,24 +136,31 @@ export default abstract class Decorate<ApiType extends ApiTypes> extends Events
    this._decorateMethod = decorateMethod;
    this._options = options;
    this._type = type;
-    this._rpcCore = new RpcCore(this.registry, thisProvider, this._options.rpc);
+    this._rpcCore = new RpcCore(this.#registry, thisProvider, this._options.rpc);
    this._isConnected = new BehaviorSubject(this._rpcCore.provider.isConnected());
    this._rx.hasSubscriptions = this._rpcCore.provider.hasSubscriptions;
-    this._rx.registry = this.registry;
+    this._rx.registry = this.#registry;
+  }
+
+  /**
+   * @description Return the current used registry
+   */
+  public get registry (): Registry {
+    return this.#registry;
  }

  /**
   * @description Creates an instance of a type as registered
   */
  public createType <K extends keyof InterfaceTypes> (type: K, ...params: unknown[]): InterfaceTypes[K] {
-    return this.registry.createType(type, ...params);
+    return this.#registry.createType(type, ...params);
  }

  /**
   * @description Register additional user-defined of chain-specific types in the type registry
   */
  public registerTypes (types?: RegistryTypes): void {
-    types && this.registry.register(types);
+    types && this.#registry.register(types);
  }

  /**
@@ -163,8 +170,8 @@ export default abstract class Decorate<ApiType extends ApiTypes> extends Events
    return this._rpcCore.provider.hasSubscriptions;
  }

-  public injectMetadata (metadata: Metadata, fromEmpty?: boolean): void {
-    const decoratedMeta = new DecoratedMeta(this.registry, metadata);
+  public injectMetadata (metadata: Metadata, fromEmpty?: boolean, registry?: Registry): void {
+    const decoratedMeta = new DecoratedMeta(registry || this.#registry, metadata);

    if (fromEmpty || !this._extrinsics) {
      this._extrinsics = this._decorateExtrinsics(decoratedMeta.tx, this._decorateMethod);
@@ -461,8 +468,8 @@ export default abstract class Decorate<ApiType extends ApiTypes> extends Events
          }

          const nextResult = vals.length
-            ? new LinkageResult(this.registry, [keys[0].constructor as any, keys], [vals[0].constructor as any, vals])
-            : new LinkageResult(this.registry, [Null, []], [Null, []]);
+            ? new LinkageResult(this.#registry, [keys[0].constructor as any, keys], [vals[0].constructor as any, vals])
+            : new LinkageResult(this.#registry, [Null, []], [Null, []]);

          // we set our result into a subject so we have a single observable for
          // which the value changes over time. Initially create, follow-up next
@@ -3,25 +3,37 @@
 // of the Apache-2.0 license. See the LICENSE file for details.

 import { SignedBlock, RuntimeVersion } from '@polkadot/types/interfaces';
+import { Registry } from '@polkadot/types/types';
 import { ApiBase, ApiOptions, ApiTypes, DecorateMethod } from '../types';

+import BN from 'bn.js';
 import { Observable, Subscription, of } from 'rxjs';
 import { map, switchMap } from 'rxjs/operators';
-import { Metadata, Text } from '@polkadot/types';
+import { Metadata, Text, TypeRegistry } from '@polkadot/types';
 import { LATEST_EXTRINSIC_VERSION } from '@polkadot/types/extrinsic/Extrinsic';
-import { getMetadataTypes, getSpecAlias, getSpecTypes } from '@polkadot/types-known';
-import { logger } from '@polkadot/util';
+import { getMetadataTypes, getSpecAlias, getSpecTypes, getUpgradeVersion } from '@polkadot/types-known';
+import { BN_ZERO, assert, logger, u8aEq, u8aToU8a } from '@polkadot/util';
 import { cryptoWaitReady } from '@polkadot/util-crypto';

 import Decorate from './Decorate';

+interface VersionedRegistry {
+  isDefault: boolean;
+  lastBlockHash: Uint8Array | null;
+  registry: Registry;
+  specVersion: BN;
+}
+
 const KEEPALIVE_INTERVAL = 15000;
+const DEFAULT_BLOCKNUMBER = { unwrap: () => BN_ZERO };

 const l = logger('api/init');

 export default abstract class Init<ApiType extends ApiTypes> extends Decorate<ApiType> {
  #healthTimer: NodeJS.Timeout | null = null;

+  #registries: VersionedRegistry[] = [];
+
  #updateSub?: Subscription;

  constructor (options: ApiOptions, type: ApiTypes, decorateMethod: DecorateMethod<ApiType>) {
@@ -32,13 +44,7 @@ export default abstract class Init<ApiType extends ApiTypes> extends Decorate<Ap
    }

    // all injected types added to the registry for overrides
-    this.registry.setKnownTypes({
-      types: options.types,
-      typesAlias: options.typesAlias,
-      typesBundle: options.typesBundle,
-      typesChain: options.typesChain,
-      typesSpec: options.typesSpec
-    });
+    this.registry.setKnownTypes(options);

    // We only register the types (global) if this is not a cloned instance.
    // Do right up-front, so we get in the user types before we are actually
@@ -55,6 +61,7 @@ export default abstract class Init<ApiType extends ApiTypes> extends Decorate<Ap
    this._rx.queryMulti = this._decorateMulti(this._rxDecorateMethod);
    this._rx.signer = options.signer;

+    this._rpcCore.setRegistrySwap((hash?: string | Uint8Array | null) => this.getBlockRegistry(hash));
    this._rpcCore.provider.on('disconnected', this.#onProviderDisconnect);
    this._rpcCore.provider.on('error', this.#onProviderError);
    this._rpcCore.provider.on('connected', this.#onProviderConnect);
@@ -68,6 +75,71 @@ export default abstract class Init<ApiType extends ApiTypes> extends Decorate<Ap
    }
  }

+  /**
+   * @description Sets up a registry based on the block hash defined
+   */
+  public async getBlockRegistry (blockHash?: string | Uint8Array | null): Promise<Registry> {
+    if (!blockHash) {
+      return this.registry;
+    }
+
+    // shortcut in the case where we have an immediate-same request
+    const lastBlockHash = u8aToU8a(blockHash);
+    const existingViaHash = this.#registries.find((r) => r.lastBlockHash && u8aEq(lastBlockHash, r.lastBlockHash));
+
+    if (existingViaHash) {
+      return existingViaHash.registry;
+    }
+
+    // ensure we have everything required
+    assert(this._genesisHash && this._runtimeVersion, 'Cannot retrieve data on an uninitialized chain');
+
+    // We have to assume that on the RPC layer the calls used here does not call back into
+    // the registry swap, so getHeader & getRuntimeVersion should not be historic
+    const header = this._genesisHash.eq(blockHash)
+      ? { number: DEFAULT_BLOCKNUMBER, parentHash: this._genesisHash }
+      : await this._rpcCore.chain.getHeader(blockHash).toPromise();
+
+    assert(header?.parentHash && !header.parentHash.isEmpty, 'Unable to retrieve header and parent from supplied hash');
+
+    // get the runtime version, either on-chain or via an known upgrade history
+    const [firstVersion, lastVersion] = getUpgradeVersion(this._genesisHash, header.number.unwrap());
+    const version = (firstVersion && (lastVersion || firstVersion.specVersion.eq(this._runtimeVersion.specVersion)))
+      ? { specName: this._runtimeVersion.specName, specVersion: firstVersion.specVersion }
+      : await this._rpcCore.state.getRuntimeVersion(header.parentHash).toPromise();
+
+    // check for pre-existing registries
+    const existingViaVersion = this.#registries.find((r) => r.specVersion.eq(version.specVersion));
+
+    if (existingViaVersion) {
+      existingViaVersion.lastBlockHash = lastBlockHash;
+
+      return existingViaVersion.registry;
+    }
+
+    // nothing has been found, construct new
+    const registry = new TypeRegistry();
+
+    registry.setChainProperties(this.registry.getChainProperties());
+    registry.setKnownTypes(this._options);
+    registry.register(getSpecTypes(registry, this._runtimeChain as Text, version.specName, version.specVersion));
+
+    if (registry.knownTypes.typesBundle) {
+      this._adjustBundleTypes(registry, this._runtimeChain as Text, version.specName);
+    }
+
+    // retrieve the metadata now that we have all types set
+    const metadata = await this._rpcCore.state.getMetadata(header.parentHash).toPromise();
+
+    // TODO: Not convinced (yet) that we really want to re-decorate, keep on ice since it does muddle-up
+    // this.injectMetadata(metadata, false);
+    registry.setMetadata(metadata);
+
+    this.#registries.push({ isDefault: false, lastBlockHash, registry, specVersion: version.specVersion });
+
+    return registry;
+  }
+
  protected async _loadMeta (): Promise<boolean> {
    const genesisHash = await this._rpcCore.chain.getBlockHash(0).toPromise();

@@ -138,8 +210,14 @@ export default abstract class Init<ApiType extends ApiTypes> extends Decorate<Ap
              this._runtimeVersion = version;
              this._rx.runtimeVersion = version;

-              this.registerTypes(getSpecTypes(this.registry, this._runtimeChain as Text, version.specName, version.specVersion));
-              this.injectMetadata(metadata, false);
+              // update the default registry version
+              const thisRegistry = this.#registries.find(({ isDefault }) => isDefault);
+
+              assert(thisRegistry, 'Initialization error, cannot find the default registry');
+
+              thisRegistry.specVersion = version.specVersion;
+              thisRegistry.registry.register(getSpecTypes(thisRegistry.registry, this._runtimeChain as Text, version.specName, version.specVersion));
+              this.injectMetadata(metadata, false, thisRegistry.registry);

              return true;
            })
@@ -148,9 +226,9 @@ export default abstract class Init<ApiType extends ApiTypes> extends Decorate<Ap
    ).subscribe();
  }

-  private _adjustBundleTypes (chain: Text, specName: Text): void {
+  private _adjustBundleTypes (registry: Registry, chain: Text, specName: Text): void {
    // adjust known type aliases
-    this.registry.knownTypes.typesAlias = getSpecAlias(this.registry, chain, specName);
+    registry.knownTypes.typesAlias = getSpecAlias(registry, chain, specName);

    // FIXME For the first round, we are not adjusting the user-injected RPCs
    // inject any user-level RPCs now that we have the chain/spec
@@ -187,9 +265,14 @@ export default abstract class Init<ApiType extends ApiTypes> extends Decorate<Ap
    this._runtimeVersion = runtimeVersion;
    this._rx.runtimeVersion = runtimeVersion;

+    // setup the initial registry, when we have none
+    if (!this.#registries.length) {
+      this.#registries.push({ isDefault: true, lastBlockHash: null, registry: this.registry, specVersion: runtimeVersion.specVersion });
+    }
+
    // adjust types based on bundled info
    if (this.registry.knownTypes.typesBundle) {
-      this._adjustBundleTypes(chain, runtimeVersion.specName);
+      this._adjustBundleTypes(this.registry, chain, runtimeVersion.specName);
    }

    // do the setup for the specific chain
@@ -219,7 +302,7 @@ export default abstract class Init<ApiType extends ApiTypes> extends Decorate<Ap
    const metaExtrinsic = metadata.asLatest.extrinsic;

    // only inject if we are not a clone (global init)
-    if (metaExtrinsic.version.gtn(0)) {
+    if (metaExtrinsic.version.gt(BN_ZERO)) {
      this._extrinsicType = metaExtrinsic.version.toNumber();
    } else if (!this._options.source) {
      // detect the extrinsic version in-use based on the last block
@@ -60,16 +60,19 @@ export default function createClass <ApiType extends ApiTypes> ({ api, apiType,
      )();
    }

-    // sign a transaction, returning the this to allow chaining, i.e. .sign(...).send()
+    /**
+     * @description Sign a transaction, returning the this to allow chaining, i.e. .sign(...).send(). When options, e.g. nonce/blockHash are not specified, it will be inferred. To retrieve eg. nonce use `signAsync` (the preferred interface, this is provided for backwards compatibility)
+     * @deprecated
+     */
    public sign (account: IKeyringPair, optionsOrNonce?: Partial<SignerOptions>): this {
      super.sign(account, this.#makeSignOptions(this.#optionsOrNonce(optionsOrNonce), {}));

      return this;
    }

-    // signs a transaction, returning `this` to allow chaining. E.g.: `sign(...).send()`
-    //
-    // also supports signing through external signers
+    /**
+     * @description Signs a transaction, returning `this` to allow chaining. E.g.: `sign(...).send()`. Like `.signAndSend` this will retrieve the nonce and blockHash to send the tx with.
+     */
    public signAsync (account: AddressOrPair, optionsOrNonce?: Partial<SignerOptions>): SubmittableThis<ApiType, this> {
      // eslint-disable-next-line @typescript-eslint/no-unsafe-return,@typescript-eslint/no-unsafe-call
      return decorateMethod(
@@ -50,6 +50,9 @@ export interface SubmittableExtrinsic<ApiType extends ApiTypes> extends Extrinsi

  send(statusCb: Callback<ISubmittableResult>): SubmittableResultSubscription<ApiType>;

+  /**
+   * @deprecated
+   */
  sign(account: IKeyringPair, _options?: Partial<SignerOptions>): this;

  signAsync(account: AddressOrPair, _options?: Partial<SignerOptions>): SubmittableThis<ApiType, this>;
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/metadata",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "Helpers to extract information from runtime metadata",
  "main": "index.js",
  "publishConfig": {
@@ -27,13 +27,13 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/type-metadata#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/types-known": "1.30.1",
-    "@polkadot/util": "^3.3.1",
-    "@polkadot/util-crypto": "^3.3.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/types-known": "1.31.1",
+    "@polkadot/util": "^3.4.1",
+    "@polkadot/util-crypto": "^3.4.1",
    "bn.js": "^5.1.3"
  },
  "devDependencies": {
-    "@polkadot/keyring": "^3.3.1"
+    "@polkadot/keyring": "^3.4.1"
  }
 }
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/rpc-core",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "A JavaScript wrapper for the Polkadot JsonRPC interface",
  "main": "index.js",
  "keywords": [
@@ -27,14 +27,14 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/rpc-core#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/metadata": "1.30.1",
-    "@polkadot/rpc-provider": "1.30.1",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/util": "^3.3.1",
+    "@polkadot/metadata": "1.31.1",
+    "@polkadot/rpc-provider": "1.31.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/util": "^3.4.1",
    "memoizee": "^0.4.14",
    "rxjs": "^6.6.2"
  },
  "devDependencies": {
-    "@polkadot/keyring": "^3.3.1"
+    "@polkadot/keyring": "^3.4.1"
  }
 }
@@ -91,10 +91,25 @@ describe('Cached Observables', (): void => {
    expect(observable2).not.toBe(observable1);
  });

-  it('creates multiple observables for one-shots', (): void => {
+  it('creates single observables for subsequent one-shots', (): void => {
    const observable1 = rpc.chain.getBlockHash(123);
    const observable2 = rpc.chain.getBlockHash(123);

-    expect(observable2).not.toBe(observable1);
+    expect(observable2).toBe(observable1);
+  });
+
+  it('creates multiple observables for subsequent one-shots delayed', (done): void => {
+    const observable1 = rpc.chain.getBlockHash(123);
+
+    const sub = observable1.subscribe((): void => {
+      sub.unsubscribe();
+    });
+
+    expect(rpc.chain.getBlockHash(123)).toBe(observable1);
+
+    setTimeout((): void => {
+      expect(rpc.chain.getBlockHash(123)).not.toBe(observable1);
+      done();
+    }, 3500);
  });
 });
@@ -8,13 +8,13 @@ import { AnyJson, Codec, DefinitionRpc, DefinitionRpcExt, DefinitionRpcSub, Regi
 import { RpcInterface, RpcInterfaceMethod } from './types';

 import memoizee from 'memoizee';
-import { combineLatest, from, Observable, Observer, of, throwError } from 'rxjs';
-import { catchError, map, publishReplay, refCount, switchMap } from 'rxjs/operators';
+import { Observable, Observer } from 'rxjs';
+import { publishReplay, refCount } from 'rxjs/operators';
 import jsonrpc from '@polkadot/types/interfaces/jsonrpc';
 import { Option, StorageKey, Vec, createClass, createTypeUnsafe } from '@polkadot/types';
 import { assert, hexToU8a, isFunction, isNull, isUndefined, logger, u8aToU8a } from '@polkadot/util';

-import { drr } from './rxjs';
+import { drr, refCountDelay } from './rxjs';

 interface StorageChangeSetJSON {
  block: string;
@@ -66,14 +66,16 @@ function logErrorMessage (method: string, { params, type }: DefinitionRpc, error
 * ```
 */
 export default class Rpc implements RpcInterface {
+  #registryDefault: Registry;
+
+  #getBlockRegistry?: (blockHash?: string | Uint8Array | null) => Promise<Registry>;
+
  readonly #storageCache = new Map<string, string | null>();

  public readonly mapping = new Map<string, DefinitionRpcExt>();

  public readonly provider: ProviderInterface;

-  public readonly registry: Registry;
-
  public readonly sections: string[] = [];

  // Ok, this is quite horrible - we really should not be using the ! here, but we are actually assigning
@@ -113,7 +115,7 @@ export default class Rpc implements RpcInterface {
    // eslint-disable-next-line @typescript-eslint/unbound-method
    assert(provider && isFunction(provider.send), 'Expected Provider to API create');

-    this.registry = registry;
+    this.#registryDefault = registry;
    this.provider = provider;

    const sectionNames = Object.keys(jsonrpc);
@@ -131,6 +133,13 @@ export default class Rpc implements RpcInterface {
    this.provider.disconnect();
  }

+  /**
+   * @description Sets a registry swap (typically from Api)
+   */
+  public setRegistrySwap (registrySwap: (blockHash?: string | Uint8Array | null) => Promise<Registry>): void {
+    this.#getBlockRegistry = registrySwap;
+  }
+
  public addUserInterfaces<Section extends keyof RpcInterface> (userRpc: Record<string, Record<string, DefinitionRpc | DefinitionRpcSub>>): void {
    // add any extra user-defined sections
    this.sections.push(...Object.keys(userRpc).filter((key) => !this.sections.includes(key)));
@@ -192,41 +201,60 @@ export default class Rpc implements RpcInterface {

  private _createMethodSend (section: string, method: string, def: DefinitionRpc): RpcInterfaceMethod {
    const rpcName = `${section}_${method}`;
+    const hashIndex = def.params.findIndex(({ isHistoric }) => isHistoric);
+    const cacheIndex = def.params.findIndex(({ isCached }) => isCached);
+    let memoized: null | RpcInterfaceMethod & memoizee.Memoized<RpcInterfaceMethod> = null;
+
+    // execute the RPC call, doing a registry swap for historic as applicable
+    const callWithRegistry = async (isRaw: boolean, values: any[]): Promise<Codec | Codec[]> => {
+      const hash = hashIndex === -1
+        ? undefined
+        : values[hashIndex] as Uint8Array;
+      const registry = hash && this.#getBlockRegistry
+        ? await this.#getBlockRegistry(hash)
+        : this.#registryDefault;
+      const params = this._formatInputs(registry, def, values);
+      const data = await this.provider.send(rpcName, params.map((param): AnyJson => param.toJSON())) as AnyJson;
+
+      return isRaw
+        ? registry.createType('Raw', data)
+        : this._formatOutput(registry, method, def, params, data);
+    };

    const creator = (isRaw: boolean) => (...values: any[]): Observable<any> => {
-      // Here, logically, it should be `of(this.formatInputs(method, values))`.
-      // However, formatInputs can throw, and when it does, the above way
-      // doesn't throw in the "Observable loop" (which is internally wrapped in
-      // a try/catch block). So we:
-      // - first do `of(1)` - won't throw
-      // - then do `map(()=>this.formatInputs)` - might throw, but inside Observable.
-      return of(1).pipe(
-        map(() => this._formatInputs(def, values)),
-        switchMap((params): Observable<[Codec[], any]> =>
-          combineLatest([
-            of(params),
-            from(this.provider.send(rpcName, params.map((param): AnyJson => param.toJSON())))
-          ])
-        ),
-        map(([params, result]) =>
-          isRaw
-            ? this.registry.createType('Raw', result)
-            : this._formatOutput(method, def, params, result)
-        ),
-        catchError((error): any => {
-          logErrorMessage(method, def, error);
+      const isDelayed = (hashIndex !== -1 && !!values[hashIndex]) || (cacheIndex !== -1 && !!values[cacheIndex]);

-          return throwError(error);
-        }),
+      return new Observable((observer: Observer<any>): VoidCallback => {
+        callWithRegistry(isRaw, values)
+          .then((value): void => {
+            observer.next(value);
+            observer.complete();
+          })
+          .catch((error): void => {
+            logErrorMessage(method, def, error);
+
+            observer.error(error);
+            observer.complete();
+          });
+
+        return (): void => {
+          // delete old results from cache
+          memoized?.delete(...values);
+        };
+      }).pipe(
        publishReplay(1), // create a Replay(1)
-        refCount() // Unsubscribe WS when there are no more subscribers
+        isDelayed
+          ? refCountDelay() // Unsubscribe after delay
+          : refCount()
      );
    };

-    // We voluntarily don't cache the "one-shot" RPC calls. For example,
-    // `getStorage('123')` returns the current value, but this value can change
-    // over time, so we wouldn't want to cache the Observable.
-    return this._createMethodWithRaw(creator);
+    memoized = memoizee(this._createMethodWithRaw(creator), {
+      length: false,
+      normalizer: JSON.stringify
+    });
+
+    return memoized;
  }

  // create a subscriptor, it subscribes once and resolves with the id as subscribe
@@ -253,6 +281,7 @@ export default class Rpc implements RpcInterface {
      return new Observable((observer: Observer<any>): VoidCallback => {
        // Have at least an empty promise, as used in the unsubscribe
        let subscriptionPromise: Promise<number | string | null> = Promise.resolve(null);
+        const registry = this.#registryDefault;

        const errorHandler = (error: Error): void => {
          logErrorMessage(method, def, error);
@@ -261,7 +290,7 @@ export default class Rpc implements RpcInterface {
        };

        try {
-          const params = this._formatInputs(def, values);
+          const params = this._formatInputs(registry, def, values);
          const paramsJson = params.map((param): AnyJson => param.toJSON());

          const update = (error?: Error | null, result?: any): void => {
@@ -274,8 +303,8 @@ export default class Rpc implements RpcInterface {
            try {
              observer.next(
                isRaw
-                  ? this.registry.createType('Raw', result)
-                  : this._formatOutput(method, def, params, result)
+                  ? registry.createType('Raw', result)
+                  : this._formatOutput(registry, method, def, params, result)
              );
            } catch (error) {
              observer.error(error);
@@ -289,16 +318,8 @@ export default class Rpc implements RpcInterface {

        // Teardown logic
        return (): void => {
-          // Delete from cache
-          // Reason:
-          // ```
-          //    const s = api.query.system.account(addr1).subscribe(); // let's say it's 6
-          //    s.unsubscribe();
-          //    // wait a bit, for the nonce to increase to 7
-          //    api.query.system.account(addr1).subscribe(); // will output 6 instead of 7 if we don't clear cache
-          //    // that's because all our observables are replay(1)
-          // ```
-          memoized && memoized.delete(...values);
+          // Delete from cache, so old results don't hang around
+          memoized?.delete(...values);

          // Unsubscribe from provider
          subscriptionPromise
@@ -325,7 +346,7 @@ export default class Rpc implements RpcInterface {
    return memoized;
  }

-  private _formatInputs (def: DefinitionRpc, inputs: any[]): Codec[] {
+  private _formatInputs (registry: Registry, def: DefinitionRpc, inputs: any[]): Codec[] {
    const reqArgCount = def.params.filter(({ isOptional }): boolean => !isOptional).length;
    const optText = reqArgCount === def.params.length
      ? ''
@@ -334,7 +355,7 @@ export default class Rpc implements RpcInterface {
    assert(inputs.length >= reqArgCount && inputs.length <= def.params.length, `Expected ${def.params.length} parameters${optText}, ${inputs.length} found instead`);

    return inputs.map((input, index): Codec =>
-      createTypeUnsafe(this.registry, def.params[index].type, [input])
+      createTypeUnsafe(registry, def.params[index].type, [input])
    );
  }

@@ -344,12 +365,12 @@ export default class Rpc implements RpcInterface {
    return ['0x3a636f6465'].includes(key.toHex());
  }

-  private _formatOutput (method: string, rpc: DefinitionRpc, params: Codec[], result?: any): Codec | Codec[] {
+  private _formatOutput (registry: Registry, method: string, rpc: DefinitionRpc, params: Codec[], result?: any): Codec | Codec[] {
    if (rpc.type === 'StorageData') {
      const key = params[0] as StorageKey;

      try {
-        return this._formatStorageData(key, result);
+        return this._formatStorageData(registry, key, result);
      } catch (error) {
        console.error(`Unable to decode storage ${key.section || 'unknown'}.${key.method || 'unknown'}:`, (error as Error).message);

@@ -359,12 +380,12 @@ export default class Rpc implements RpcInterface {
      const keys = params[0] as Vec<StorageKey>;

      return keys
-        ? this._formatStorageSet(keys, (result as StorageChangeSetJSON).changes)
-        : this.registry.createType('StorageChangeSet', result);
+        ? this._formatStorageSet(registry, keys, (result as StorageChangeSetJSON).changes)
+        : registry.createType('StorageChangeSet', result);
    } else if (rpc.type === 'Vec<StorageChangeSet>') {
      const mapped = (result as StorageChangeSetJSON[]).map(({ block, changes }): [Hash, Codec[]] => [
-        this.registry.createType('Hash', block),
-        this._formatStorageSet(params[0] as Vec<StorageKey>, changes)
+        registry.createType('Hash', block),
+        this._formatStorageSet(registry, params[0] as Vec<StorageKey>, changes)
      ]);

      // we only query at a specific block, not a range - flatten
@@ -373,10 +394,10 @@ export default class Rpc implements RpcInterface {
        : mapped as unknown as Codec[];
    }

-    return createTypeUnsafe(this.registry, rpc.type, [result]);
+    return createTypeUnsafe(registry, rpc.type, [result]);
  }

-  private _formatStorageData (key: StorageKey, value: string | null): Codec {
+  private _formatStorageData (registry: Registry, key: StorageKey, value: string | null): Codec {
    // single return value (via state.getStorage), decode the value based on the
    // outputType that we have specified. Fallback to Raw on nothing
    const type = key.outputType || 'Raw';
@@ -393,15 +414,15 @@ export default class Rpc implements RpcInterface {

    if (meta.modifier.isOptional) {
      return new Option(
-        this.registry,
-        createClass(this.registry, type),
+        registry,
+        createClass(registry, type),
        isEmpty
          ? null
-          : createTypeUnsafe(this.registry, type, [input], true)
+          : createTypeUnsafe(registry, type, [input], true)
      );
    }

-    return createTypeUnsafe(this.registry, type, [
+    return createTypeUnsafe(registry, type, [
      isEmpty
        ? meta.fallback
          ? hexToU8a(meta.fallback.toHex())
@@ -410,7 +431,7 @@ export default class Rpc implements RpcInterface {
    ], true);
  }

-  private _formatStorageSet (keys: Vec<StorageKey>, changes: [string, string | null][]): Codec[] {
+  private _formatStorageSet (registry: Registry, keys: Vec<StorageKey>, changes: [string, string | null][]): Codec[] {
    // For StorageChangeSet, the changes has the [key, value] mappings
    const withCache = keys.length !== 1;

@@ -420,7 +441,7 @@ export default class Rpc implements RpcInterface {
    //   - null - The storage key is empty
    return keys.reduce((results: Codec[], key: StorageKey): Codec[] => {
      try {
-        results.push(this._formatStorageSetEntry(key, changes, withCache));
+        results.push(this._formatStorageSetEntry(registry, key, changes, withCache));
      } catch (error) {
        console.error(`Unable to decode storage ${key.section || 'unknown'}.${key.method || 'unknown'}:`, (error as Error).message);

@@ -431,7 +452,7 @@ export default class Rpc implements RpcInterface {
    }, []);
  }

-  private _formatStorageSetEntry (key: StorageKey, changes: [string, string | null][], witCache: boolean): Codec {
+  private _formatStorageSetEntry (registry: Registry, key: StorageKey, changes: [string, string | null][], witCache: boolean): Codec {
    // Fallback to Raw (i.e. just the encoding) if we don't have a specific type
    const type = key.outputType || 'Raw';
    const hexKey = key.toHex();
@@ -457,15 +478,15 @@ export default class Rpc implements RpcInterface {

    if (meta.modifier.isOptional) {
      return new Option(
-        this.registry,
-        createClass(this.registry, type),
+        registry,
+        createClass(registry, type),
        isEmpty
          ? null
-          : createTypeUnsafe(this.registry, type, [input], true)
+          : createTypeUnsafe(registry, type, [input], true)
      );
    }

-    return createTypeUnsafe(this.registry, type, [
+    return createTypeUnsafe(registry, type, [
      isEmpty
        ? meta.fallback
          ? hexToU8a(meta.fallback.toHex())
@@ -12,6 +12,7 @@ import { refCountDelay } from './refCountDelay';
 export type DrrResult = <T> (source$: Observable<T>) => Observable<T>;

 interface Options {
+  delay?: number;
  skipChange?: boolean;
  skipTimeout?: boolean;
 }
@@ -35,7 +36,7 @@ const NOOP = (): void => undefined;
 * @ignore
 * @internal
 */
-export const drr = ({ skipChange = false, skipTimeout = false }: Options = {}): DrrResult => <T> (source$: Observable<T>): Observable<T> =>
+export const drr = ({ delay, skipChange = false, skipTimeout = false }: Options = {}): DrrResult => <T> (source$: Observable<T>): Observable<T> =>
  source$.pipe(
    catchError(ERR),
    skipChange
@@ -44,5 +45,5 @@ export const drr = ({ skipChange = false, skipTimeout = false }: Options = {}):
    publishReplay(1),
    skipTimeout
      ? refCount()
-      : refCountDelay()
+      : refCountDelay(delay)
  );
@@ -4,45 +4,40 @@

 import { asapScheduler, ConnectableObservable, MonoTypeOperatorFunction, Observable, Subscription, TeardownLogic } from 'rxjs';

-const DELAY = 1750;
-
 /** @internal */
-function refCountDelayInner <T> (source: Observable<T>): Observable<T> {
-  // state: 0 = disconnected, 1 = disconnecting, 2 = connecting, 3 = connected
-  let [state, refCount, connection, scheduler] = [0, 0, Subscription.EMPTY, Subscription.EMPTY];
+export function refCountDelay <T> (delay = 1750): MonoTypeOperatorFunction<T> {
+  return (source: Observable<T>): Observable<T> => {
+    // state: 0 = disconnected, 1 = disconnecting, 2 = connecting, 3 = connected
+    let [state, refCount, connection, scheduler] = [0, 0, Subscription.EMPTY, Subscription.EMPTY];

-  return new Observable((ob): TeardownLogic => {
-    source.subscribe(ob);
+    return new Observable((ob): TeardownLogic => {
+      source.subscribe(ob);

-    if (refCount++ === 0) {
-      if (state === 1) {
-        scheduler.unsubscribe();
-      } else {
-        connection = (source as ConnectableObservable<T>).connect();
-      }
-
-      state = 3;
-    }
-
-    return (): void => {
-      if (--refCount === 0) {
-        if (state === 2) {
-          state = 0;
+      if (refCount++ === 0) {
+        if (state === 1) {
          scheduler.unsubscribe();
        } else {
-          // state === 3
-          state = 1;
-          scheduler = asapScheduler.schedule((): void => {
-            state = 0;
-            connection.unsubscribe();
-          }, DELAY);
+          connection = (source as ConnectableObservable<T>).connect();
        }
-      }
-    };
-  });
-}

-/** @internal */
-export function refCountDelay <T> (): MonoTypeOperatorFunction<T> {
-  return refCountDelayInner;
+        state = 3;
+      }
+
+      return (): void => {
+        if (--refCount === 0) {
+          if (state === 2) {
+            state = 0;
+            scheduler.unsubscribe();
+          } else {
+            // state === 3
+            state = 1;
+            scheduler = asapScheduler.schedule((): void => {
+              state = 0;
+              connection.unsubscribe();
+            }, delay);
+          }
+        }
+      };
+    });
+  };
 }
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/rpc-provider",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "Transport providers for the API",
  "main": "index.js",
  "keywords": [
@@ -27,17 +27,17 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/rpc-provider#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/metadata": "1.30.1",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/util": "^3.3.1",
-    "@polkadot/util-crypto": "^3.3.1",
+    "@polkadot/metadata": "1.31.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/util": "^3.4.1",
+    "@polkadot/util-crypto": "^3.4.1",
    "bn.js": "^5.1.3",
-    "eventemitter3": "^4.0.5",
+    "eventemitter3": "^4.0.6",
    "isomorphic-fetch": "^2.2.1",
    "websocket": "^1.0.31"
  },
  "devDependencies": {
-    "@polkadot/keyring": "^3.3.1",
+    "@polkadot/keyring": "^3.4.1",
    "mock-socket": "^9.0.3",
    "nock": "^13.0.4"
  }
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/typegen",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "Type generation scripts",
  "main": "index.js",
  "bin": {
@@ -36,11 +36,11 @@
    "@babel/core": "^7.11.4",
    "@babel/register": "^7.10.5",
    "@babel/runtime": "^7.11.2",
-    "@polkadot/api": "1.30.1",
-    "@polkadot/metadata": "1.30.1",
-    "@polkadot/rpc-provider": "1.30.1",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/util": "^3.3.1",
+    "@polkadot/api": "1.31.1",
+    "@polkadot/metadata": "1.31.1",
+    "@polkadot/rpc-provider": "1.31.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/util": "^3.4.1",
    "handlebars": "^4.7.6",
    "websocket": "^1.0.31",
    "yargs": "^15.4.1"
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/types-known",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "A JavaScript wrapper for the Polkadot JsonRPC interface",
  "main": "index.js",
  "keywords": [
@@ -27,8 +27,8 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/types-known#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/types": "1.30.1",
-    "@polkadot/util": "^3.3.1",
+    "@polkadot/types": "1.31.1",
+    "@polkadot/util": "^3.4.1",
    "bn.js": "^5.1.3"
  },
  "devDependencies": {
@@ -3,7 +3,8 @@
 // of the Apache-2.0 license. See the LICENSE file for details.

 import type BN from 'bn.js';
-import { DefinitionRpc, DefinitionRpcSub, Registry, RegistryTypes, OverrideModuleType, OverrideVersionedType } from '@polkadot/types/types';
+import { Hash } from '@polkadot/types/interfaces';
+import { ChainUpgradeVersion, DefinitionRpc, DefinitionRpcSub, Registry, RegistryTypes, OverrideModuleType, OverrideVersionedType } from '@polkadot/types/types';

 import { Text } from '@polkadot/types';
 import { bnToBn, isUndefined } from '@polkadot/util';
@@ -12,6 +13,7 @@ import typesChain from './chain';
 import typesMeta from './metadata';
 import typesModules from './modules';
 import typesSpec from './spec';
+import upgrades from './upgrades';
 import warnings from './warnings';

 // flatten a VersionedType[] into a Record<string, string>
@@ -91,3 +93,21 @@ export function getSpecAlias ({ knownTypes }: Registry, chainName: Text | string
    ...(knownTypes.typesBundle?.chain?.[_chainName]?.alias || {})
  };
 }
+
+/**
+ * @description Returns a version record for known chains where upgrades are being tracked
+ */
+export function getUpgradeVersion (genesisHash: Hash, blockNumber: BN): [ChainUpgradeVersion | undefined, ChainUpgradeVersion | undefined] {
+  const known = upgrades.find((u) => genesisHash.eq(u.genesisHash));
+
+  return known
+    ? [
+      known.versions.reduce((last: ChainUpgradeVersion | undefined, version): ChainUpgradeVersion | undefined => {
+        return blockNumber.gt(version.blockNumber)
+          ? version
+          : last;
+      }, undefined),
+      known.versions.find((version) => blockNumber.lte(version.blockNumber))
+    ]
+    : [undefined, undefined];
+}
@@ -27,6 +27,7 @@ const versioned: OverrideVersionedType[] = [
      Multiplier: 'Fixed64',
      OpenTip: 'OpenTipTo225',
      ReferendumInfo: 'ReferendumInfoTo239',
+      RewardDestination: 'RewardDestinationTo257',
      SlashingSpans: 'SlashingSpansTo204',
      StakingLedger: 'StakingLedgerTo223',
      Votes: 'VotesTo230',
@@ -44,6 +45,7 @@ const versioned: OverrideVersionedType[] = [
      Multiplier: 'Fixed64',
      OpenTip: 'OpenTipTo225',
      ReferendumInfo: 'ReferendumInfoTo239',
+      RewardDestination: 'RewardDestinationTo257',
      SlashingSpans: 'SlashingSpansTo204',
      StakingLedger: 'StakingLedgerTo223',
      Votes: 'VotesTo230',
@@ -62,6 +64,7 @@ const versioned: OverrideVersionedType[] = [
      Multiplier: 'Fixed64',
      OpenTip: 'OpenTipTo225',
      ReferendumInfo: 'ReferendumInfoTo239',
+      RewardDestination: 'RewardDestinationTo257',
      StakingLedger: 'StakingLedgerTo223',
      Votes: 'VotesTo230',
      Weight: 'u32'
@@ -77,6 +80,7 @@ const versioned: OverrideVersionedType[] = [
      Multiplier: 'Fixed64',
      OpenTip: 'OpenTipTo225',
      ReferendumInfo: 'ReferendumInfoTo239',
+      RewardDestination: 'RewardDestinationTo257',
      StakingLedger: 'StakingLedgerTo240',
      Weight: 'u32'
    }
@@ -89,6 +93,7 @@ const versioned: OverrideVersionedType[] = [
      DispatchInfo: 'DispatchInfoTo244',
      Multiplier: 'Fixed64',
      OpenTip: 'OpenTipTo225',
+      RewardDestination: 'RewardDestinationTo257',
      StakingLedger: 'StakingLedgerTo240',
      Weight: 'u32'
    }
@@ -99,7 +104,8 @@ const versioned: OverrideVersionedType[] = [
      ...sharedTypes,
      CompactAssignments: 'CompactAssignmentsTo257',
      DispatchInfo: 'DispatchInfoTo244',
-      OpenTip: 'OpenTipTo225'
+      OpenTip: 'OpenTipTo225',
+      RewardDestination: 'RewardDestinationTo257'
    }
  },
  {
@@ -107,14 +113,22 @@ const versioned: OverrideVersionedType[] = [
    types: {
      ...sharedTypes,
      CompactAssignments: 'CompactAssignmentsTo257',
-      OpenTip: 'OpenTipTo225'
+      OpenTip: 'OpenTipTo225',
+      RewardDestination: 'RewardDestinationTo257'
    }
  },
  {
-    minmax: [2013, undefined],
+    minmax: [2013, 2022],
    types: {
      ...sharedTypes,
-      CompactAssignments: 'CompactAssignmentsTo257'
+      CompactAssignments: 'CompactAssignmentsTo257',
+      RewardDestination: 'RewardDestinationTo257'
+    }
+  },
+  {
+    minmax: [2023, undefined],
+    types: {
+      ...sharedTypes
    }
  }
 ];
@@ -9,7 +9,8 @@ const sharedTypes = {
  Keys: 'SessionKeys5',
  LookupSource: 'AccountId',
  ProxyType: {
-    _enum: ['Any', 'NonTransfer', 'Governance', 'Staking', 'SudoBalances', 'IdentityJudgement']
+    // was: SudoBalances
+    _enum: ['Any', 'NonTransfer', 'Governance', 'Staking', 'Unused', 'IdentityJudgement']
  }
 };

@@ -20,14 +21,22 @@ const versioned: OverrideVersionedType[] = [
    types: {
      ...sharedTypes,
      CompactAssignments: 'CompactAssignmentsTo257',
-      OpenTip: 'OpenTipTo225'
+      OpenTip: 'OpenTipTo225',
+      RewardDestination: 'RewardDestinationTo257'
    }
  },
  {
-    minmax: [13, undefined],
+    minmax: [13, 22],
    types: {
      ...sharedTypes,
-      CompactAssignments: 'CompactAssignmentsTo257'
+      CompactAssignments: 'CompactAssignmentsTo257',
+      RewardDestination: 'RewardDestinationTo257'
+    }
+  },
+  {
+    minmax: [23, undefined],
+    types: {
+      ...sharedTypes
    }
  }
 ];
@@ -7,7 +7,8 @@ import { OverrideVersionedType } from '@polkadot/types/types';
 const sharedTypes = {
  Address: 'AccountId',
  Keys: 'SessionKeys5',
-  LookupSource: 'AccountId'
+  LookupSource: 'AccountId',
+  RewardDestination: 'RewardDestinationTo257'
 };

 const versioned: OverrideVersionedType[] = [
@@ -9,7 +9,8 @@ const sharedTypes = {
  Keys: 'SessionKeys5',
  LookupSource: 'AccountId',
  ProxyType: {
-    _enum: ['Any', 'NonTransfer', 'Staking', 'SudoBalances', 'IdentityJudgement']
+    // was: SudoBalances
+    _enum: ['Any', 'NonTransfer', 'Staking', 'Unused', 'IdentityJudgement']
  }
 };

@@ -21,6 +22,7 @@ const versioned: OverrideVersionedType[] = [
      CompactAssignments: 'CompactAssignmentsTo257',
      Multiplier: 'Fixed64',
      OpenTip: 'OpenTipTo225',
+      RewardDestination: 'RewardDestinationTo257',
      Weight: 'u32'
    }
  },
@@ -29,14 +31,22 @@ const versioned: OverrideVersionedType[] = [
    types: {
      ...sharedTypes,
      CompactAssignments: 'CompactAssignmentsTo257',
-      OpenTip: 'OpenTipTo225'
+      OpenTip: 'OpenTipTo225',
+      RewardDestination: 'RewardDestinationTo257'
    }
  },
  {
-    minmax: [23, undefined],
+    minmax: [23, 42],
    types: {
      ...sharedTypes,
-      CompactAssignments: 'CompactAssignmentsTo257'
+      CompactAssignments: 'CompactAssignmentsTo257',
+      RewardDestination: 'RewardDestinationTo257'
+    }
+  },
+  {
+    minmax: [43, undefined],
+    types: {
+      ...sharedTypes
    }
  }
 ];
@@ -0,0 +1,18 @@
+// Copyright 2017-2020 @polkadot/types-known authors & contributors
+// This software may be modified and distributed under the terms
+// of the Apache-2.0 license. See the LICENSE file for details.
+
+import { ChainUpgrades } from '@polkadot/types/types';
+
+import kusama from './kusama';
+import polkadot from './polkadot';
+import westend from './westend';
+
+// Type overrides for specific spec types & versions as given in runtimeVersion
+const upgrades: ChainUpgrades[] = [
+  kusama,
+  polkadot,
+  westend
+];
+
+export default upgrades;
@@ -0,0 +1,26 @@
+// Copyright 2017-2020 @polkadot/types-known authors & contributors
+// This software may be modified and distributed under the terms
+// of the Apache-2.0 license. See the LICENSE file for details.
+
+import { ChainUpgrades } from '@polkadot/types/types';
+
+import BN from 'bn.js';
+import { hexToU8a } from '@polkadot/util';
+
+const upgrades: ChainUpgrades = {
+  genesisHash: hexToU8a('0xb0a8d493285c2df73290dfb7e61f870f17b41801197a149ca93654499ea3dafe'),
+  versions: [
+    [0, 1020], [26669, 1021], [38245, 1022], [54248, 1023], [59659, 1024],
+    [67651, 1025], [82191, 1027], [83238, 1028], [101503, 1029], [203466, 1030],
+    [295787, 1031], [461692, 1032], [504329, 1033], [569327, 1038], [587687, 1039],
+    [653183, 1040], [693488, 1042], [901442, 1045], [1375086, 1050], [1445458, 1051],
+    [1472960, 1052], [1475648, 1053], [1491596, 1054], [1574408, 1055], [2064961, 1058],
+    [2201991, 1062], [2671528, 2005], [2704202, 2007], [2728002, 2008], [2832534, 2011],
+    [2962294, 2012], [3240000, 2013], [3274408, 2015], [3323565, 2019], [3534175, 2022]
+  ].map(([blockNumber, specVersion]) => ({
+    blockNumber: new BN(blockNumber),
+    specVersion: new BN(specVersion)
+  }))
+};
+
+export default upgrades;
@@ -0,0 +1,23 @@
+// Copyright 2017-2020 @polkadot/types-known authors & contributors
+// This software may be modified and distributed under the terms
+// of the Apache-2.0 license. See the LICENSE file for details.
+
+import { ChainUpgrades } from '@polkadot/types/types';
+
+import BN from 'bn.js';
+import { hexToU8a } from '@polkadot/util';
+
+const upgrades: ChainUpgrades = {
+  genesisHash: hexToU8a('0x91b171bb158e2d3848fa23a9f1c25182fb8e20313b2c1eb49219da7a70ce90c3'),
+  versions: [
+    [0, 0], [29231, 1], [188836, 5], [199405, 6], [214264, 7],
+    [244358, 8], [303079, 9], [314201, 10], [342400, 11], [443963, 12],
+    [528470, 13], [687751, 14], [746085, 15], [787923, 16], [799302, 17],
+    [1205128, 18]
+  ].map(([blockNumber, specVersion]) => ({
+    blockNumber: new BN(blockNumber),
+    specVersion: new BN(specVersion)
+  }))
+};
+
+export default upgrades;
@@ -0,0 +1,23 @@
+// Copyright 2017-2020 @polkadot/types-known authors & contributors
+// This software may be modified and distributed under the terms
+// of the Apache-2.0 license. See the LICENSE file for details.
+
+import { ChainUpgrades } from '@polkadot/types/types';
+
+import BN from 'bn.js';
+import { hexToU8a } from '@polkadot/util';
+
+const upgrades: ChainUpgrades = {
+  genesisHash: hexToU8a('0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e'),
+  versions: [
+    [214356, 4], [392764, 7], [409740, 8], [809976, 20], [877581, 24],
+    [879238, 25], [889472, 26], [902937, 27], [932751, 28], [991142, 29],
+    [1030162, 31], [1119657, 32], [1199282, 33], [1342534, 34], [1392263, 35],
+    [1431703, 36], [1433369, 37], [1490972, 41]
+  ].map(([blockNumber, specVersion]) => ({
+    blockNumber: new BN(blockNumber),
+    specVersion: new BN(specVersion)
+  }))
+};
+
+export default upgrades;
@@ -1,6 +1,6 @@
 {
  "name": "@polkadot/types",
-  "version": "1.30.1",
+  "version": "1.31.1",
  "description": "Implementation of the Parity codec",
  "main": "index.js",
  "keywords": [
@@ -27,16 +27,16 @@
  "homepage": "https://github.com/polkadot-js/api/tree/master/packages/types#readme",
  "dependencies": {
    "@babel/runtime": "^7.11.2",
-    "@polkadot/metadata": "1.30.1",
-    "@polkadot/util": "^3.3.1",
-    "@polkadot/util-crypto": "^3.3.1",
+    "@polkadot/metadata": "1.31.1",
+    "@polkadot/util": "^3.4.1",
+    "@polkadot/util-crypto": "^3.4.1",
    "@types/bn.js": "^4.11.6",
    "bn.js": "^5.1.3",
    "memoizee": "^0.4.14",
    "rxjs": "^6.6.2"
  },
  "devDependencies": {
-    "@polkadot/keyring": "^3.3.1",
+    "@polkadot/keyring": "^3.4.1",
    "@types/memoizee": "^0.4.4"
  }
 }
@@ -35,11 +35,11 @@ import { ProxyAnnouncement, ProxyDefinition, ProxyType } from '@polkadot/types/i
 import { AccountStatus, AccountValidity } from '@polkadot/types/interfaces/purchase';
 import { ActiveRecovery, RecoveryConfig } from '@polkadot/types/interfaces/recovery';
 import { RpcMethods } from '@polkadot/types/interfaces/rpc';
-import { AccountId, AccountIdOf, AccountIndex, Address, AssetId, Balance, BalanceOf, Block, BlockNumber, Call, CallHash, CallHashOf, ChangesTrieConfiguration, Consensus, ConsensusEngineId, Digest, DigestItem, ExtrinsicsWeight, Fixed128, Fixed64, FixedI128, FixedI64, FixedU128, FixedU64, GenericAddress, H160, H256, H512, Hash, Header, I32F32, Index, Justification, KeyTypeId, KeyValue, LockIdentifier, LookupSource, LookupTarget, ModuleId, Moment, OpaqueCall, Origin, Pays, PerU16, Perbill, Percent, Permill, Perquintill, Phantom, PhantomData, PreRuntime, Releases, RuntimeDbWeight, Seal, SealV0, SignedBlock, StorageData, U32F32, ValidatorId, Weight, WeightMultiplier } from '@polkadot/types/interfaces/runtime';
+import { AccountId, AccountIdOf, AccountIndex, Address, AssetId, Balance, BalanceOf, Block, BlockNumber, Call, CallHash, CallHashOf, ChangesTrieConfiguration, Consensus, ConsensusEngineId, Digest, DigestItem, ExtrinsicsWeight, Fixed128, Fixed64, FixedI128, FixedI64, FixedU128, FixedU64, GenericAddress, H160, H256, H512, Hash, Header, I32F32, Index, Justification, KeyTypeId, KeyValue, LockIdentifier, LookupSource, LookupTarget, ModuleId, Moment, OpaqueCall, Origin, Pays, PerU16, Perbill, Percent, Permill, Perquintill, Phantom, PhantomData, PreRuntime, Releases, RuntimeDbWeight, Seal, SealV0, SignedBlock, StorageData, TransactionPriority, U32F32, ValidatorId, Weight, WeightMultiplier } from '@polkadot/types/interfaces/runtime';
 import { Period, Priority, SchedulePeriod, SchedulePriority, Scheduled, TaskAddress } from '@polkadot/types/interfaces/scheduler';
 import { FullIdentification, IdentificationTuple, Keys, MembershipProof, SessionIndex, SessionKeys1, SessionKeys2, SessionKeys3, SessionKeys4, SessionKeys5, SessionKeys6, ValidatorCount } from '@polkadot/types/interfaces/session';
 import { Bid, BidKind, SocietyJudgement, SocietyVote, StrikeCount, VouchingStatus } from '@polkadot/types/interfaces/society';
-import { ActiveEraInfo, CompactAssignments, CompactAssignmentsTo257, CompactScore, CompactScoreCompact, ElectionCompute, ElectionResult, ElectionScore, ElectionSize, ElectionStatus, EraIndex, EraPoints, EraRewardPoints, EraRewards, Exposure, Forcing, IndividualExposure, KeyType, MomentOf, Nominations, NominatorIndex, NominatorIndexCompact, OffchainAccuracy, OffchainAccuracyCompact, PhragmenScore, Points, RewardDestination, RewardPoint, SlashJournalEntry, SlashingSpans, SlashingSpansTo204, SpanIndex, SpanRecord, StakingLedger, StakingLedgerTo223, StakingLedgerTo240, UnappliedSlash, UnappliedSlashOther, UnlockChunk, ValidatorIndex, ValidatorIndexCompact, ValidatorPrefs, ValidatorPrefsTo145, ValidatorPrefsTo196 } from '@polkadot/types/interfaces/staking';
+import { ActiveEraInfo, CompactAssignments, CompactAssignmentsTo257, CompactScore, CompactScoreCompact, ElectionCompute, ElectionResult, ElectionScore, ElectionSize, ElectionStatus, EraIndex, EraPoints, EraRewardPoints, EraRewards, Exposure, Forcing, IndividualExposure, KeyType, MomentOf, Nominations, NominatorIndex, NominatorIndexCompact, OffchainAccuracy, OffchainAccuracyCompact, PhragmenScore, Points, RewardDestination, RewardDestinationTo257, RewardPoint, SlashJournalEntry, SlashingSpans, SlashingSpansTo204, SpanIndex, SpanRecord, StakingLedger, StakingLedgerTo223, StakingLedgerTo240, UnappliedSlash, UnappliedSlashOther, UnlockChunk, ValidatorIndex, ValidatorIndexCompact, ValidatorPrefs, ValidatorPrefsTo145, ValidatorPrefsTo196 } from '@polkadot/types/interfaces/staking';
 import { ApiId, KeyValueOption, ReadProof, RuntimeVersion, RuntimeVersionApi, StorageChangeSet } from '@polkadot/types/interfaces/state';
 import { WeightToFeeCoefficient } from '@polkadot/types/interfaces/support';
 import { AccountInfo, ApplyExtrinsicResult, ChainProperties, ChainType, DigestOf, DispatchClass, DispatchError, DispatchErrorModule, DispatchErrorTo198, DispatchInfo, DispatchInfoTo190, DispatchInfoTo244, DispatchOutcome, DispatchResult, DispatchResultOf, DispatchResultTo198, Event, EventId, EventIndex, EventRecord, EventRecordTo76, Health, InvalidTransaction, Key, LastRuntimeUpgradeInfo, NetworkState, NetworkStatePeerset, NetworkStatePeersetInfo, NodeRole, NotConnectedPeer, Peer, PeerEndpoint, PeerEndpointAddr, PeerInfo, PeerPing, Phase, RefCount, TransactionValidityError, UnknownTransaction } from '@polkadot/types/interfaces/system';
@@ -303,6 +303,10 @@ declare module '@polkadot/types/types/registry' {
    StorageData: StorageData;
    'Option<StorageData>': Option<StorageData>;
    'Vec<StorageData>': Vec<StorageData>;
+    TransactionPriority: TransactionPriority;
+    'Compact<TransactionPriority>': Compact<TransactionPriority>;
+    'Option<TransactionPriority>': Option<TransactionPriority>;
+    'Vec<TransactionPriority>': Vec<TransactionPriority>;
    ValidatorId: ValidatorId;
    'Option<ValidatorId>': Option<ValidatorId>;
    'Vec<ValidatorId>': Vec<ValidatorId>;
@@ -994,6 +998,9 @@ declare module '@polkadot/types/types/registry' {
    RewardDestination: RewardDestination;
    'Option<RewardDestination>': Option<RewardDestination>;
    'Vec<RewardDestination>': Vec<RewardDestination>;
+    RewardDestinationTo257: RewardDestinationTo257;
+    'Option<RewardDestinationTo257>': Option<RewardDestinationTo257>;
+    'Vec<RewardDestinationTo257>': Vec<RewardDestinationTo257>;
    RewardPoint: RewardPoint;
    'Compact<RewardPoint>': Compact<RewardPoint>;
    'Option<RewardPoint>': Option<RewardPoint>;
@@ -135,10 +135,15 @@ export default abstract class AbstractArray<T extends Codec> extends Array<T> im
  // we want it to return an Array. We only override the methods that return a
  // new instance.

+  /**
+   * @description Concatenates two arrays
+   */
+  public concat (other: T[]): T[] {
+    return this.toArray().concat(other instanceof AbstractArray ? other.toArray() : other);
+  }
+
  /**
   * @description Filters the array with the callback
-   * @param callbackfn The filter function
-   * @param thisArg The `this` object to apply the result to
   */
  public filter (callbackfn: (value: T, index: number, array: T[]) => boolean, thisArg?: unknown): T[] {
    return this.toArray().filter(callbackfn, thisArg);
@@ -146,8 +151,6 @@ export default abstract class AbstractArray<T extends Codec> extends Array<T> im

  /**
   * @description Maps the array with the callback
-   * @param callbackfn The mapping function
-   * @param thisArg The `this` onject to apply the result to
   */
  public map<U> (callbackfn: (value: T, index: number, array: T[]) => U, thisArg?: unknown): U[] {
    return this.toArray().map(callbackfn, thisArg);
@@ -138,6 +138,13 @@ export default abstract class AbstractInt extends BN implements Codec {
    return u8a.length === (this.#bitLength / 8);
  }

+  /**
+   * @description Returns a BigInt representation of the number
+   */
+  public toBigInt (): BigInt {
+    return BigInt(this.toString());
+  }
+
  /**
   * @description Returns the BN representation of the number. (Compatibility)
   */
@@ -162,6 +162,14 @@ describe('Compact', (): void => {
    it('unwraps to the wrapped value', (): void => {
      expect(new (Compact.with(U32))(registry, 12345).unwrap() instanceof U32).toBe(true);
    });
+
+    it('has a valid toBn interface', (): void => {
+      expect(new (Compact.with('u128'))(registry, '12345678987654321').toBn().eq(new BN('12345678987654321'))).toBe(true);
+    });
+
+    it('has a valid toBigInt interface', (): void => {
+      expect(new (Compact.with('u128'))(registry, 12345678987654321n).toBigInt() === 12345678987654321n).toBe(true);
+    });
  });

  describe('helpers', (): void => {
@@ -117,6 +117,13 @@ export default class Compact<T extends CompactEncodable> implements ICompact<T>
    );
  }

+  /**
+   * @description Returns a BigInt representation of the number
+   */
+  public toBigInt (): BigInt {
+    return BigInt(this.toString());
+  }
+
  /**
   * @description Returns the BN representation of the number
   */
@@ -26,11 +26,12 @@ describe('Date', (): void => {
  });

  describe('encode', (): void => {
-    const testEncode = (to: 'toBn' | 'toISOString' | 'toNumber' | CodecTo, expected: BN | number | string | Uint8Array): void =>
+    const testEncode = (to: 'toBigInt' | 'toBn' | 'toISOString' | 'toNumber' | CodecTo, expected: BigInt | BN | number | string | Uint8Array): void =>
      it(`can encode ${to}`, (): void => {
        expect(new CodecDate(registry, 421)[to]()).toEqual(expected);
      });

+    testEncode('toBigInt', 421n);
    testEncode('toBn', new BN(421));
    testEncode('toJSON', 421);
    testEncode('toISOString', '1970-01-01T00:07:01.000Z');
@@ -81,6 +81,13 @@ export default class CodecDate extends Date implements Codec {
    return BITLENGTH;
  }

+  /**
+   * @description Returns a BigInt representation of the number
+   */
+  public toBigInt (): BigInt {
+    return BigInt(this.toNumber());
+  }
+
  /**
   * @description Returns the BN representation of the timestamp
   */
@@ -149,6 +149,8 @@ describe('Enum', (): void => {

      expect(new Test(registry).toJSON()).toEqual({ A: null });
      expect(new Test(registry, 1234, 1).toJSON()).toEqual({ B: 1234 });
+      expect(new Test(registry, 0x1234, 1).toU8a()).toEqual(new Uint8Array([1, 0x34, 0x12, 0x00, 0x00]));
+      expect(new Test(registry, 0x1234, 1).toU8a(true)).toEqual(new Uint8Array([0x34, 0x12, 0x00, 0x00]));
    });

    it('allows accessing the type and value', (): void => {
@@ -338,10 +338,8 @@ export default class Enum implements Codec {
   * @param isBare true when the value has none of the type-specific prefixes (internal)
   */
  public toU8a (isBare?: boolean): Uint8Array {
-    const index = this.#indexes[this.#index];
-
    return u8aConcat(
-      new Uint8Array([index]),
+      new Uint8Array(isBare ? [] : [this.#indexes[this.#index]]),
      this.#raw.toU8a(isBare)
    );
  }
@@ -8,6 +8,12 @@ import Int from './Int';
 describe('Int', (): void => {
  const registry = new TypeRegistry();

+  it('provides a toBigInt interface', (): void => {
+    expect(
+      new Int(registry, -1234).toBigInt()
+    ).toEqual(-1234n);
+  });
+
  it('provides a toBn interface', (): void => {
    expect(
      new Int(registry, -1234).toBn().toNumber()
@@ -28,6 +28,12 @@ describe('UInt', (): void => {
    ).toEqual('123,456,789,123,456,789,123,456,789');
  });

+  it('provides a toBigInt interface', (): void => {
+    expect(
+      new UInt(registry, 9876543210123456789n).toBigInt()
+    ).toEqual(9876543210123456789n);
+  });
+
  it('provides a toBn interface', (): void => {
    expect(
      new UInt(registry, 987).toBn().toNumber()
@@ -110,6 +110,12 @@ describe('Vec', (): void => {
      });
    });

+    it('exposes a working concat', (): void => {
+      expect(
+        vector.concat(new Vec(registry, Text, ['987', '654'])).toString()
+      ).toEqual('1,23,345,4567,56789,987,654');
+    });
+
    it('exposes a working filter', (): void => {
      expect(
        vector.filter((e, i): boolean => i >= 3).toString()
@@ -8,7 +8,7 @@ import { ChainProperties, DispatchErrorModule } from '../interfaces/types';
 import { CallFunction, Codec, Constructor, InterfaceTypes, RegistryError, RegistryTypes, Registry, RegistryMetadata, RegisteredTypes, TypeDef } from '../types';

 import extrinsicsFromMeta from '@polkadot/metadata/Decorated/extrinsics/fromMetadata';
-import { assert, formatBalance, isFunction, isString, isU8a, isUndefined, stringCamelCase, u8aToHex } from '@polkadot/util';
+import { BN_ZERO, assert, formatBalance, isFunction, isString, isU8a, isUndefined, stringCamelCase, u8aToHex } from '@polkadot/util';
 import { blake2AsU8a } from '@polkadot/util-crypto';

 import Raw from '../codec/Raw';
@@ -341,7 +341,7 @@ export class TypeRegistry implements Registry {
    // setup the available extensions
    this.setSignedExtensions(
      signedExtensions || (
-        metadata.asLatest.extrinsic.version.gtn(0)
+        metadata.asLatest.extrinsic.version.gt(BN_ZERO)
          ? metadata.asLatest.extrinsic.signedExtensions.map((key) => key.toString())
          : defaultExtensions
      )
@@ -26,6 +26,12 @@ describe('AccountId', (): void => {
    it('equals the empty address', (): void => {
      expect(id.eq('5C4hrfjw9DjXZTzV3MwzrrAr9P1MJhSrvWGWqi1eSuyUpnhM')).toBe(true);
    });
+
+    it('allows decoding from null', (): void => {
+      expect(
+        registry.createType('AccountId', null).eq('5C4hrfjw9DjXZTzV3MwzrrAr9P1MJhSrvWGWqi1eSuyUpnhM')
+      ).toBe(true);
+    });
  });

  describe('decoding', (): void => {
@@ -36,6 +42,12 @@ describe('AccountId', (): void => {
        expect(a.toString()).toBe(expected);
      });

+    it('fails with non-32-byte lengths', (): void => {
+      expect(
+        () => registry.createType('AccountId', '0x1234')
+      ).toThrow(/Invalid AccountId provided, expected 32 bytes/);
+    });
+
    testDecode(
      'AccountId',
      registry.createType('AccountId', '0x0102030405060708010203040506070801020304050607080102030405060708'),
@@ -72,7 +84,7 @@ describe('AccountId', (): void => {
    testEncode('toHex', '0x0102030405060708010203040506070801020304050607080102030405060708');
    testEncode('toJSON', '5C62W7ELLAAfix9LYrcx5smtcffbhvThkM5x7xfMeYXCtGwF');
    testEncode('toString', '5C62W7ELLAAfix9LYrcx5smtcffbhvThkM5x7xfMeYXCtGwF');
-    testEncode('toString', '5C4hrfjw9DjXZTzV3MwzrrAr9P1MJhSrvWGWqi1eSuyUpnhM', '0x00');
+    testEncode('toString', '5C4hrfjw9DjXZTzV3MwzrrAr9P1MJhSrvWGWqi1eSuyUpnhM', '0x0000000000000000000000000000000000000000000000000000000000000000');
    testEncode('toU8a', Uint8Array.from([
      1, 2, 3, 4, 5, 6, 7, 8, 1, 2, 3, 4, 5, 6, 7, 8,
      1, 2, 3, 4, 5, 6, 7, 8, 1, 2, 3, 4, 5, 6, 7, 8
@@ -92,7 +104,7 @@ describe('AccountId', (): void => {
      );

      const data = registry.createType('StorageData', jsonVec.params.result.changes[0][1]);
-      const list = registry.createType('Vec<AccountId>', data).map((accountId): string => accountId.toString());
+      const list = registry.createType('Vec<AccountId>', data).map((accountId) => accountId.toString());

      expect(list).toEqual([
        '7qVJujLF3EDbZt5WfQXWvueFedMS4Vfk2Hb4GyR8jwksTLup',
@@ -4,14 +4,16 @@

 import { AnyString, AnyU8a, Registry } from '../types';

-import { hexToU8a, isHex, isString, isU8a, u8aToU8a } from '@polkadot/util';
+import { hexToU8a, isHex, isString, isU8a, u8aToU8a, assert } from '@polkadot/util';
 import { decodeAddress, encodeAddress } from '@polkadot/util-crypto';

 import U8aFixed from '../codec/U8aFixed';

 /** @internal */
-function decodeAccountId (value: AnyU8a | AnyString): AnyU8a {
-  if (isU8a(value) || Array.isArray(value)) {
+function decodeAccountId (value?: AnyU8a | AnyString): Uint8Array {
+  if (!value) {
+    return new Uint8Array();
+  } else if (isU8a(value) || Array.isArray(value)) {
    return u8aToU8a(value);
  } else if (isHex(value)) {
    return hexToU8a(value.toString());
@@ -19,7 +21,7 @@ function decodeAccountId (value: AnyU8a | AnyString): AnyU8a {
    return decodeAddress((value as string).toString());
  }

-  return value;
+  throw new Error('Unknown type passed to AccountId constructor');
 }

 /**
@@ -30,8 +32,13 @@ function decodeAccountId (value: AnyU8a | AnyString): AnyU8a {
 * just a Uint8Array wrapper with a fixed length.
 */
 export default class AccountId extends U8aFixed {
-  constructor (registry: Registry, value: AnyU8a = new Uint8Array()) {
-    super(registry, decodeAccountId(value), 256);
+  constructor (registry: Registry, value?: AnyU8a) {
+    const decoded = decodeAccountId(value);
+
+    // Part of stream containing >= 32 bytes or a all empty (defaults)
+    assert(decoded.length >= 32 || !decoded.some((b) => b), `Invalid AccountId provided, expected 32 bytes, found ${decoded.length}`);
+
+    super(registry, decoded, 256);
  }

  public static encode (value: Uint8Array, ss58Format?: number): string {
@@ -16,6 +16,7 @@ export default {
        {
          name: 'hash',
          type: 'BlockHash',
+          isCached: true,
          isOptional: true
        }
      ],
@@ -27,6 +28,7 @@ export default {
        {
          name: 'hash',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -23,6 +23,7 @@ export default {
        {
          name: 'at',
          type: 'Hash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -42,6 +43,7 @@ export default {
        {
          name: 'at',
          type: 'Hash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -61,6 +63,7 @@ export default {
        {
          name: 'at',
          type: 'Hash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -80,6 +83,7 @@ export default {
        {
          name: 'at',
          type: 'Hash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -19,6 +19,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -38,6 +39,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -53,6 +55,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -19,6 +19,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -102,6 +102,7 @@ export default {
      justification: 'Justification'
    },
    StorageData: 'Bytes',
+    TransactionPriority: 'u64',
    ValidatorId: 'AccountId',
    Weight: 'u64',
    WeightMultiplier: 'Fixed64',
@@ -228,6 +228,9 @@ export interface SignedBlock extends Struct {
 /** @name StorageData */
 export interface StorageData extends Bytes {}

+/** @name TransactionPriority */
+export interface TransactionPriority extends u64 {}
+
 /** @name U32F32 */
 export interface U32F32 extends UInt {}

@@ -24,8 +24,8 @@ export default {
      start: 'Option<Moment>'
    },
    CompactAssignments: {
-      votes1: 'Vec<(NominatorIndexCompact, [CompactScoreCompact; 0], ValidatorIndexCompact)>',
-      votes2: 'Vec<(NominatorIndexCompact, [CompactScoreCompact; 1], ValidatorIndexCompact)>',
+      votes1: 'Vec<(NominatorIndexCompact, ValidatorIndexCompact)>',
+      votes2: 'Vec<(NominatorIndexCompact, CompactScoreCompact, ValidatorIndexCompact)>',
      votes3: 'Vec<(NominatorIndexCompact, [CompactScoreCompact; 2], ValidatorIndexCompact)>',
      votes4: 'Vec<(NominatorIndexCompact, [CompactScoreCompact; 3], ValidatorIndexCompact)>',
      votes5: 'Vec<(NominatorIndexCompact, [CompactScoreCompact; 4], ValidatorIndexCompact)>',
@@ -121,6 +121,14 @@ export default {
    PhragmenScore: '[u128; 3]',
    Points: 'u32',
    RewardDestination: {
+      _enum: {
+        Staked: 'Null',
+        Stash: 'Null',
+        Controller: 'Null',
+        Account: 'AccountId'
+      }
+    },
+    RewardDestinationTo257: {
      _enum: [
        'Staked',
        'Stash',
@@ -14,8 +14,8 @@ export interface ActiveEraInfo extends Struct {

 /** @name CompactAssignments */
 export interface CompactAssignments extends Struct {
-  readonly votes1: Vec<ITuple<[NominatorIndexCompact, Vec<CompactScoreCompact>, ValidatorIndexCompact]>>;
-  readonly votes2: Vec<ITuple<[NominatorIndexCompact, Vec<CompactScoreCompact>, ValidatorIndexCompact]>>;
+  readonly votes1: Vec<ITuple<[NominatorIndexCompact, ValidatorIndexCompact]>>;
+  readonly votes2: Vec<ITuple<[NominatorIndexCompact, CompactScoreCompact, ValidatorIndexCompact]>>;
  readonly votes3: Vec<ITuple<[NominatorIndexCompact, Vec<CompactScoreCompact>, ValidatorIndexCompact]>>;
  readonly votes4: Vec<ITuple<[NominatorIndexCompact, Vec<CompactScoreCompact>, ValidatorIndexCompact]>>;
  readonly votes5: Vec<ITuple<[NominatorIndexCompact, Vec<CompactScoreCompact>, ValidatorIndexCompact]>>;
@@ -167,6 +167,15 @@ export interface RewardDestination extends Enum {
  readonly isStaked: boolean;
  readonly isStash: boolean;
  readonly isController: boolean;
+  readonly isAccount: boolean;
+  readonly asAccount: AccountId;
+}
+
+/** @name RewardDestinationTo257 */
+export interface RewardDestinationTo257 extends Enum {
+  readonly isStaked: boolean;
+  readonly isStash: boolean;
+  readonly isController: boolean;
 }

 /** @name RewardPoint */
@@ -24,6 +24,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -39,6 +40,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -54,6 +56,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -79,6 +82,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -95,6 +99,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -111,6 +116,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -127,6 +133,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -154,6 +161,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -181,6 +189,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -208,6 +217,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -235,6 +245,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -246,6 +257,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isCached: true,
          isOptional: true
        }
      ],
@@ -258,6 +270,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isCached: true,
          isOptional: true
        }
      ],
@@ -292,6 +305,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -307,6 +321,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -31,6 +31,7 @@ export default {
        {
          name: 'at',
          type: 'BlockHash',
+          isHistoric: true,
          isOptional: true
        }
      ],
@@ -13,6 +13,8 @@ export type DefinitionTypeStruct = Record<string, DefinitionTypeType> | { _alias
 export type DefinitionType = string | DefinitionTypeEnum | DefinitionTypeSet | DefinitionTypeStruct;

 export interface DefinitionRpcParam {
+  isCached?: boolean;
+  isHistoric?: boolean;
  isOptional?: boolean;
  name: string;
  type: DefinitionTypeType;
@@ -9,6 +9,7 @@ import { FunctionMetadataLatest } from '../interfaces/metadata';
 import { ArgsDef, Codec } from './codec';

 export interface ICompact<T> extends Codec {
+  toBigInt (): BigInt;
  toBn (): BN;
  toNumber (): number;
  unwrap (): T;
@@ -18,6 +18,16 @@ export interface OverrideVersionedType {
  types: RegistryTypes;
 }

+export interface ChainUpgradeVersion {
+  blockNumber: BN;
+  specVersion: BN;
+}
+
+export interface ChainUpgrades {
+  genesisHash: Uint8Array;
+  versions: ChainUpgradeVersion[];
+}
+
 export type OverrideModuleType = Record<string, string>;

 export interface OverrideBundleDefinition {
Author	SHA1	Message	Date
Github Actions	d958ef8f15	[CI Skip] release/stable 1.31.1 skip-checks: true	2020-08-31 15:44:17 +00:00
Jaco Greeff	97527871d6	1.31 (#2551 )	2020-08-31 17:32:20 +02:00
Github Actions	0317f28e5a	[CI Skip] release/beta 1.31.0-beta.26 skip-checks: true	2020-08-31 15:06:05 +00:00
Jaco Greeff	ebe6d03762	Update types for Polkadot runtime 23 (#2550 ) * Update types for Polkadot runtime 23 * Expand change info * version upgrades * Linting	2020-08-31 16:50:56 +02:00
Github Actions	59e92fa344	[CI Skip] release/beta 1.31.0-beta.25 skip-checks: true	2020-08-31 14:24:05 +00:00
Jaco Greeff	cab338e26d	CHANGELOG (#2549 )	2020-08-31 16:11:17 +02:00
Github Actions	743ea431b4	[CI Skip] release/beta 1.31.0-beta.24 skip-checks: true	2020-08-31 13:32:50 +00:00
Jaco Greeff	533f9ce249	Explicit delay for per-hash single queries (#2548 ) * Explicit delay for per-hash single queries * Expand delay * Update packages/rpc-core/src/index.ts	2020-08-31 15:20:06 +02:00
Github Actions	797ee9c24a	[CI Skip] release/beta 1.31.0-beta.23 skip-checks: true	2020-08-31 12:44:38 +00:00
Jaco Greeff	2f5e2537a3	Align single-shot memoization (#2546 ) * Align single-shot memoization * Small tweaks * Test for delayed creates * With actual sub * Expand delay test * Bump delay	2020-08-31 14:31:44 +02:00
Github Actions	dd52ea4b32	[CI Skip] release/beta 1.31.0-beta.22 skip-checks: true	2020-08-31 12:27:52 +00:00
Jaco Greeff	5e8ae793c3	Westend known upgrades (#2547 )	2020-08-31 14:16:45 +02:00
Github Actions	8713a1f2b6	[CI Skip] release/beta 1.31.0-beta.21 skip-checks: true	2020-08-31 11:22:44 +00:00
Jaco Greeff	6e6fa4a97c	Known upgrade points for on-chain version skip (#2545 ) * Known upgrade points for on-chain version skip * Update packages/types-known/src/index.ts * Update packages/api/src/base/Init.ts * Actual known upgrade blocks for Polkadot & Kusama * Update with known Kusama upgrade history * linting	2020-08-31 13:09:52 +02:00
Github Actions	ac2a0a34ca	[CI Skip] release/beta 1.31.0-beta.20 skip-checks: true	2020-08-31 07:51:33 +00:00
Jaco Greeff	45fb6d44ad	Bump deps (#2544 )	2020-08-31 09:38:21 +02:00
Github Actions	6d2265d4ff	[CI Skip] release/beta 1.31.0-beta.19 skip-checks: true	2020-08-31 07:11:57 +00:00
Jaco Greeff	4ec42f1750	Ensure non-destructive registry swap (#2543 ) * Ensure non-destructive registry swap * Update packages/api/src/base/Init.ts	2020-08-31 08:59:20 +02:00
Github Actions	01166b9684	[CI Skip] release/beta 1.31.0-beta.18 skip-checks: true	2020-08-30 19:24:47 +00:00
Jaco Greeff	0075dce720	Remove outdated historic query FAQ (#2540 )	2020-08-30 21:11:15 +02:00
Github Actions	7fbb30066e	[CI Skip] release/beta 1.31.0-beta.17 skip-checks: true	2020-08-30 18:41:28 +00:00
Jaco Greeff	637069d723	Shortcut registry for subsequent same-hash queries (#2539 )	2020-08-30 20:28:37 +02:00
Github Actions	d639a7ee8c	[CI Skip] release/beta 1.31.0-beta.16 skip-checks: true	2020-08-30 18:17:47 +00:00
Jaco Greeff	28ef291c40	Mark submittable .sign as deprecated (#2538 )	2020-08-30 20:06:42 +02:00
Github Actions	48ddd0b0d4	[CI Skip] release/beta 1.31.0-beta.15 skip-checks: true	2020-08-30 10:52:55 +00:00
Jaco Greeff	e88ebf7b2e	Support Vec .concat (#2537 ) * Support Vec .concat * CHANGELOG	2020-08-30 12:40:20 +02:00
Github Actions	72700e6baf	[CI Skip] release/beta 1.31.0-beta.14 skip-checks: true	2020-08-30 10:36:12 +00:00
Hamza Tokuchi	f748fcd46d	more typos (#2532 )	2020-08-30 12:24:50 +02:00
Jaco Greeff	7876bb9ced	Add isHistoric flags to RPC with hash params (#2535 ) * Add isHistoric flags to RPC with hash params * Update packages/types/src/interfaces/chain/definitions.ts * Apply suggestions from code review * Transparently swap registry on RPC layer * Simplify (& linting fixes) * Cleanups * CHANGELOG	2020-08-30 12:12:18 +02:00
Github Actions	a83980b213	[CI Skip] release/beta 1.31.0-beta.13 skip-checks: true	2020-08-29 13:59:29 +00:00
Jaco Greeff	c4323d5e94	Add swapRegistry(hash?) to initlize clean registry (#2534 ) * Add swapRegistry(hash?) to initlize clean registry * Cater for genesisHash queries	2020-08-29 15:46:42 +02:00
Github Actions	11694f1393	[CI Skip] release/beta 1.31.0-beta.12 skip-checks: true	2020-08-29 12:31:27 +00:00
Jaco Greeff	3989ae67b2	Bump deps (#2533 )	2020-08-29 14:19:56 +02:00
Github Actions	b78df57907	[CI Skip] release/beta 1.31.0-beta.11 skip-checks: true	2020-08-28 12:35:54 +00:00
Jaco Greeff	2f78329738	Return democracy locks for delegations (#2531 )	2020-08-28 14:23:05 +02:00
Github Actions	6063054712	[CI Skip] release/beta 1.31.0-beta.10 skip-checks: true	2020-08-28 10:15:36 +00:00
Jaco Greeff	e42af97928	Bump deps (#2530 )	2020-08-28 12:03:49 +02:00
Hamza Tokuchi	d05ccdb5d7	small typos (#2529 )	2020-08-28 12:03:13 +02:00
Github Actions	c33334b72b	[CI Skip] release/beta 1.31.0-beta.9 skip-checks: true	2020-08-28 08:50:51 +00:00
Jaco Greeff	94e9fd2b17	Fix for in-place unlocking (#2528 )	2020-08-28 10:40:53 +02:00
Github Actions	9c1327ea22	[CI Skip] release/beta 1.31.0-beta.8 skip-checks: true	2020-08-26 16:56:17 +00:00
Jaco Greeff	9f195e9402	Update RewardDesitination enum (any payout) (#2474 )	2020-08-26 18:43:51 +02:00
Github Actions	3e5e089c68	[CI Skip] release/beta 1.31.0-beta.7 skip-checks: true	2020-08-26 11:00:13 +00:00
Jaco Greeff	35c37aa66c	Allow AccountId null in constructor	2020-08-26 12:47:15 +02:00
Github Actions	f1aeb564e3	[CI Skip] release/beta 1.31.0-beta.6 skip-checks: true	2020-08-26 10:41:27 +00:00
Kian Paimani	c2ff1b32ae	Update definitions.ts (#2514 ) * Update definitions.ts Will fix the decoding of these types. Sadly cannot provide a compact test case. * Add more tests. * Make the tests work. * Fix linting as well.	2020-08-26 12:29:27 +02:00
Github Actions	288427cbb8	[CI Skip] release/beta 1.31.0-beta.5 skip-checks: true	2020-08-26 09:40:00 +00:00
Jaco Greeff	d099ccedad	Additional AccountId length check (protect users against themselves) (#2520 ) * Additional AccountId length check * Allow all-0 * Spaceing.	2020-08-26 11:27:57 +02:00
Github Actions	79c7983199	[CI Skip] release/beta 1.31.0-beta.4 skip-checks: true	2020-08-26 09:26:32 +00:00
Jaco Greeff	80c578fe76	Bump deps (#2521 ) * Bump deps * Rewrite yarn.lock * Debump markdown plugin * Explicit add of typedoc plugins * Bump dev typedoc exec * Bump md * Common bump	2020-08-26 11:15:23 +02:00
Github Actions	de90c048bf	[CI Skip] release/beta 1.31.0-beta.3 skip-checks: true	2020-08-26 05:12:55 +00:00
aniiantt	01a36a994d	add TransactionPriority def (#2519 )	2020-08-26 07:03:20 +02:00
Github Actions	b1ce22d51d	[CI Skip] release/beta 1.31.0-beta.2 skip-checks: true	2020-08-25 22:01:24 +00:00
Jaco Greeff	fe951c2645	Support bare flag on enums (#2518 ) * Support bare flag on enums * Remove extra var allocation	2020-08-25 23:50:30 +02:00
Github Actions	5a17c542a7	[CI Skip] release/beta 1.31.0-beta.1 skip-checks: true	2020-08-25 21:35:20 +00:00
Jaco Greeff	59bb5f864f	Add toBigInt to number types (#2517 ) * Add toBigInt to number types * Update packages/types/src/codec/UInt.spec.ts * Update packages/types/src/codec/Compact.spec.ts * Update packages/types/src/codec/Compact.ts	2020-08-25 23:24:02 +02:00
Github Actions	abcba20f90	[CI Skip] release/beta 1.31.0-beta.0 skip-checks: true	2020-08-25 13:48:28 +00:00
Hamza Tokuchi	014f08c7cc	Small typo (#2515 ) teh -> the	2020-08-25 15:36:59 +02:00