feat: high-level did helper api

package.json

@@ -69,6 +69,6 @@
     "typedoc": "^0.24.8",
     "typescript": "^4.8.3"
   },
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.2",
   "packageManager": "yarn@4.1.1"
 }

packages/asset-credentials/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiltprotocol/asset-credentials",
-  "version": "0.100.0-alpha.1",
+  "version": "0.100.0-alpha.2",
   "description": "",
   "main": "./lib/cjs/index.js",
   "module": "./lib/esm/index.js",

packages/chain-helpers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiltprotocol/chain-helpers",
-  "version": "0.100.0-alpha.1",
+  "version": "0.100.0-alpha.2",
   "description": "",
   "main": "./lib/cjs/index.js",
   "module": "./lib/esm/index.js",

packages/chain-helpers/src/blockchain/Blockchain.ts

@@ -5,25 +5,22 @@
  * found in the LICENSE file in the root directory of this source tree.
  */
 
-import type { ApiPromise } from '@polkadot/api'
+import { ApiPromise, SubmittableResult } from '@polkadot/api'
 import type { TxWithEvent } from '@polkadot/api-derive/types'
 import type { Vec } from '@polkadot/types'
 import type { Call, Extrinsic } from '@polkadot/types/interfaces'
 import type { AnyNumber, IMethod } from '@polkadot/types/types'
 import type { BN } from '@polkadot/util'
+
 // eslint-disable-next-line @typescript-eslint/no-unused-vars -- doing this instead of import '@kiltprotocol/augment-api' to avoid creating an import at runtime
 import type * as _ from '@kiltprotocol/augment-api'
 import type {
   ISubmittableResult,
   KeyringPair,
-  KiltAddress,
-  SignerInterface,
   SubmittableExtrinsic,
   SubscriptionPromise,
+  TransactionSigner,
 } from '@kiltprotocol/types'
-
-import { SubmittableResult } from '@polkadot/api'
-
 import { ConfigService } from '@kiltprotocol/config'
 import { SDKErrors, Signers } from '@kiltprotocol/utils'
 
@@ -170,10 +167,29 @@ export async function submitSignedTx(
 
 export const dispatchTx = submitSignedTx
 
-export type TransactionSigner = SignerInterface<
-  'Ecrecover-Secp256k1-Blake2b' | 'Sr25519' | 'Ed25519',
-  KiltAddress
->
+/**
+ * Signs a SubmittableExtrinsic.
+ *
+ * @param tx An unsigned SubmittableExtrinsic.
+ * @param signer The {@link KeyringPair} used to sign the tx.
+ * @param opts Additional options.
+ * @param opts.tip Optional amount of Femto-KILT to tip the validator.
+ * @returns A signed {@link SubmittableExtrinsic}.
+ */
+export async function signTx(
+  tx: SubmittableExtrinsic,
+  signer: KeyringPair | TransactionSigner,
+  { tip }: { tip?: AnyNumber } = {}
+): Promise<SubmittableExtrinsic> {
+  if ('address' in signer) {
+    return tx.signAsync(signer, { tip })
+  }
+
+  return tx.signAsync(signer.id, {
+    tip,
+    signer: Signers.getPolkadotSigner([signer]),
+  })
+}
 
 /**
  * Signs and submits the SubmittableExtrinsic with optional resolution and rejection criteria.
@@ -192,13 +208,7 @@ export async function signAndSubmitTx(
     ...opts
   }: Partial<SubscriptionPromise.Options> & Partial<{ tip: AnyNumber }> = {}
 ): Promise<ISubmittableResult> {
-  const signedTx =
-    'address' in signer
-      ? await tx.signAsync(signer, { tip })
-      : await tx.signAsync(signer.id, {
-          tip,
-          signer: Signers.getPolkadotSigner([signer]),
-        })
+  const signedTx = await signTx(tx, signer, { tip })
   return submitSignedTx(signedTx, opts)
 }
 

packages/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiltprotocol/config",
-  "version": "0.100.0-alpha.1",
+  "version": "0.100.0-alpha.2",
   "description": "",
   "type": "commonjs",
   "main": "./lib/index.js",

packages/credentials/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiltprotocol/credentials",
-  "version": "0.100.0-alpha.1",
+  "version": "0.100.0-alpha.2",
   "description": "",
   "main": "./lib/cjs/index.js",
   "module": "./lib/esm/index.js",
@@ -41,10 +41,10 @@
     "@kiltprotocol/chain-helpers": "workspace:*",
     "@kiltprotocol/config": "workspace:*",
     "@kiltprotocol/did": "workspace:*",
-    "@kiltprotocol/eddsa-jcs-2022": "0.1.0-rc.3",
-    "@kiltprotocol/es256k-jcs-2023": "0.1.0-rc.3",
-    "@kiltprotocol/jcs-data-integrity-proofs-common": "0.1.0-rc.3",
-    "@kiltprotocol/sr25519-jcs-2023": "0.1.0-rc.3",
+    "@kiltprotocol/eddsa-jcs-2022": "0.1.0-rc.4",
+    "@kiltprotocol/es256k-jcs-2023": "0.1.0-rc.4",
+    "@kiltprotocol/jcs-data-integrity-proofs-common": "0.1.0-rc.4",
+    "@kiltprotocol/sr25519-jcs-2023": "0.1.0-rc.4",
     "@kiltprotocol/types": "workspace:*",
     "@kiltprotocol/utils": "workspace:*",
     "@polkadot/api": "^12.0.0",