* fix(deps): Bump @polkadot/api to v1.15.0-beta.8

* withdrawUnbonded takes args

* docs

* docs: Make getRegistry docs clearer

* Docs

Co-authored-by: joe petrowski <[email protected]>

* Update examples/README.md to add fix pluralization in bash commands

* Replace kusama.ts example with polkadot.ts bc kusama example does not exist

BREAKING CHANGE:

`BaseTxInfo` now takes an additional `transactionVersion` field.

BREAKING CHANGE:

This refactor breaks compatibility with v1, as all functions now require a `{ metadataRpc?, registry }` last argument.

#### Rationale

In v1, by not passing any last argument, we implicitly used Kusama's most recent TypeRegistry. This was a handy shortcut, but might create hard-to-debug issues down the road (e.g. using another chain, or using Kusama with an incompatible spec version).

In v2, we never default to Kusama anymore, and always require the user passing the registry (and sometimes the metadata too, if needed, see docs for details).

Example 1:

```diff
+ // Get Kusama's registry at `specVersion`
+ const registry = getRegistry('Kusama', 'kusama', specVersion);

const unsigned = methods.balances.transfer(
  { dest: '1F...', value: 23 },
  {
    // other info about tx
-    metadataRpc: metadataRpc,
- }
+  }, {
+    metadataRpc: metadataRpc,
+    registry: registry
+  }
);
```

Example 2:

```diff
const unsigned = {...};
const signature = '...';

+ // Get Kusama's registry at `specVersion`
+ const registry = getRegistry('Kusama', 'kusama', unsigned.specVersion);

- const signed = createSigned(unsigned, signature);
+ const signed = createSigned(unsigned, signature, {
+    metadataRpc: unsigned.metadata,
+    registry,
+ });
```

Here is the full list of breaking changes:
- `decode` function taking 3 arguments was deprecated in v1, in favor or 2 arguments. In v2, `decode` takes exactly 2 arguments.
- `createSigningPayload`, `createSignedTx`, `methods.*.*` functions all take a mandatory last argument `{ metadataRpc?, registry }`. Note that the `metadata` field has been renamed to `metadataRpc`. Whether a function needs `metadataRpc` is documented for each function.
- `deriveAddress`'s 2nd argument `ss58Format` is now mandatory, and does not default to Kusama's prefix anymore.

* fix: Allow balance transfer value as string

* Add eraPeriod

* Add backwards compatibility

* Change comments

* Change default to 64

* Generate docs

* Add polkadot example

* fix: Use ss58 from chain properties

* docs

* Remove some functions from docs

* Add comment

* chore(release): 1.2.6

* Add kusama file

* chore: Add example with Kusama node

* Update readme

* rebase

* Refactor out utils

* fix: Add options parameter to all methods

* Add comments

* Docs

* no docs on example

* Small tweaks

Bumps [ts-jest](https://github.com/kulshekhar/ts-jest) from 25.3.1 to 25.4.0.
- [Release notes](https://github.com/kulshekhar/ts-jest/releases)
- [Changelog](https://github.com/kulshekhar/ts-jest/blob/master/CHANGELOG.md)
- [Commits](https://github.com/kulshekhar/ts-jest/compare/v25.3.1...v25.4.0)

Signed-off-by: dependabot-preview[bot] <[email protected]>

Co-authored-by: dependabot-preview[bot] <27856297+dependabot-preview[bot]@users.noreply.github.com>