@bsv/sdk 1.3.13 → 1.3.15

package/docs/auth.md

@@ -416,33 +416,34 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ```ts
 export class CompletedProtoWallet extends ProtoWallet implements WalletInterface {
+    keyDeriver: KeyDeriver;
     constructor(rootKeyOrKeyDeriver: PrivateKey | "anyone" | KeyDeriverApi) 
-    isAuthenticated(args: {}, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<AuthenticatedResult> 
-    waitForAuthentication(args: {}, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<AuthenticatedResult> 
-    getNetwork(args: {}, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<GetNetworkResult> 
-    getVersion(args: {}, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<GetVersionResult> 
-    async getPublicKey(args: GetPublicKeyArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<{
+    async isAuthenticated(): Promise<AuthenticatedResult> 
+    async waitForAuthentication(): Promise<AuthenticatedResult> 
+    async getNetwork(): Promise<GetNetworkResult> 
+    async getVersion(): Promise<GetVersionResult> 
+    async getPublicKey(args: GetPublicKeyArgs): Promise<{
         publicKey: PubKeyHex;
     }> 
-    async createAction(args: CreateActionArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<CreateActionResult> 
-    async signAction(args: SignActionArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<SignActionResult> 
-    async abortAction(args: AbortActionArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<AbortActionResult> 
-    async listActions(args: ListActionsArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<ListActionsResult> 
-    async internalizeAction(args: InternalizeActionArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<InternalizeActionResult> 
-    async listOutputs(args: ListOutputsArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<ListOutputsResult> 
-    async relinquishOutput(args: RelinquishOutputArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<RelinquishOutputResult> 
-    async acquireCertificate(args: AcquireCertificateArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<AcquireCertificateResult> 
-    async listCertificates(args: ListCertificatesArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<ListCertificatesResult> 
-    async proveCertificate(args: ProveCertificateArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<ProveCertificateResult> 
-    async relinquishCertificate(args: RelinquishCertificateArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<RelinquishCertificateResult> 
-    async discoverByIdentityKey(args: DiscoverByIdentityKeyArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<DiscoverCertificatesResult> 
-    async discoverByAttributes(args: DiscoverByAttributesArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<DiscoverCertificatesResult> 
-    async getHeight(args: {}, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<GetHeightResult> 
-    async getHeaderForHeight(args: GetHeaderArgs, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<GetHeaderResult> 
+    async createAction(): Promise<CreateActionResult> 
+    async signAction(): Promise<SignActionResult> 
+    async abortAction(): Promise<AbortActionResult> 
+    async listActions(): Promise<ListActionsResult> 
+    async internalizeAction(): Promise<InternalizeActionResult> 
+    async listOutputs(): Promise<ListOutputsResult> 
+    async relinquishOutput(): Promise<RelinquishOutputResult> 
+    async acquireCertificate(): Promise<AcquireCertificateResult> 
+    async listCertificates(): Promise<ListCertificatesResult> 
+    async proveCertificate(): Promise<ProveCertificateResult> 
+    async relinquishCertificate(): Promise<RelinquishCertificateResult> 
+    async discoverByIdentityKey(): Promise<DiscoverCertificatesResult> 
+    async discoverByAttributes(): Promise<DiscoverCertificatesResult> 
+    async getHeight(): Promise<GetHeightResult> 
+    async getHeaderForHeight(): Promise<GetHeaderResult> 
 }
 ```
 
-See also: [AbortActionArgs](./wallet.md#interface-abortactionargs), [AbortActionResult](./wallet.md#interface-abortactionresult), [AcquireCertificateArgs](./wallet.md#interface-acquirecertificateargs), [AcquireCertificateResult](./wallet.md#interface-acquirecertificateresult), [AuthenticatedResult](./wallet.md#interface-authenticatedresult), [CreateActionArgs](./wallet.md#interface-createactionargs), [CreateActionResult](./wallet.md#interface-createactionresult), [DiscoverByAttributesArgs](./wallet.md#interface-discoverbyattributesargs), [DiscoverByIdentityKeyArgs](./wallet.md#interface-discoverbyidentitykeyargs), [DiscoverCertificatesResult](./wallet.md#interface-discovercertificatesresult), [GetHeaderArgs](./wallet.md#interface-getheaderargs), [GetHeaderResult](./wallet.md#interface-getheaderresult), [GetHeightResult](./wallet.md#interface-getheightresult), [GetNetworkResult](./wallet.md#interface-getnetworkresult), [GetPublicKeyArgs](./wallet.md#interface-getpublickeyargs), [GetVersionResult](./wallet.md#interface-getversionresult), [InternalizeActionArgs](./wallet.md#interface-internalizeactionargs), [InternalizeActionResult](./wallet.md#interface-internalizeactionresult), [KeyDeriverApi](./wallet.md#interface-keyderiverapi), [ListActionsArgs](./wallet.md#interface-listactionsargs), [ListActionsResult](./wallet.md#interface-listactionsresult), [ListCertificatesArgs](./wallet.md#interface-listcertificatesargs), [ListCertificatesResult](./wallet.md#interface-listcertificatesresult), [ListOutputsArgs](./wallet.md#interface-listoutputsargs), [ListOutputsResult](./wallet.md#interface-listoutputsresult), [OriginatorDomainNameStringUnder250Bytes](./wallet.md#type-originatordomainnamestringunder250bytes), [PrivateKey](./primitives.md#class-privatekey), [ProtoWallet](./wallet.md#class-protowallet), [ProveCertificateArgs](./wallet.md#interface-provecertificateargs), [ProveCertificateResult](./wallet.md#interface-provecertificateresult), [PubKeyHex](./wallet.md#type-pubkeyhex), [RelinquishCertificateArgs](./wallet.md#interface-relinquishcertificateargs), [RelinquishCertificateResult](./wallet.md#interface-relinquishcertificateresult), [RelinquishOutputArgs](./wallet.md#interface-relinquishoutputargs), [RelinquishOutputResult](./wallet.md#interface-relinquishoutputresult), [SignActionArgs](./wallet.md#interface-signactionargs), [SignActionResult](./wallet.md#interface-signactionresult), [WalletInterface](./wallet.md#interface-walletinterface)
+See also: [AbortActionResult](./wallet.md#interface-abortactionresult), [AcquireCertificateResult](./wallet.md#type-acquirecertificateresult), [AuthenticatedResult](./wallet.md#interface-authenticatedresult), [CreateActionResult](./wallet.md#interface-createactionresult), [DiscoverCertificatesResult](./wallet.md#interface-discovercertificatesresult), [GetHeaderResult](./wallet.md#interface-getheaderresult), [GetHeightResult](./wallet.md#interface-getheightresult), [GetNetworkResult](./wallet.md#interface-getnetworkresult), [GetPublicKeyArgs](./wallet.md#interface-getpublickeyargs), [GetVersionResult](./wallet.md#interface-getversionresult), [InternalizeActionResult](./wallet.md#interface-internalizeactionresult), [KeyDeriver](./wallet.md#class-keyderiver), [KeyDeriverApi](./wallet.md#interface-keyderiverapi), [ListActionsResult](./wallet.md#interface-listactionsresult), [ListCertificatesResult](./wallet.md#interface-listcertificatesresult), [ListOutputsResult](./wallet.md#interface-listoutputsresult), [PrivateKey](./primitives.md#class-privatekey), [ProtoWallet](./wallet.md#class-protowallet), [ProveCertificateResult](./wallet.md#interface-provecertificateresult), [PubKeyHex](./wallet.md#type-pubkeyhex), [RelinquishCertificateResult](./wallet.md#interface-relinquishcertificateresult), [RelinquishOutputResult](./wallet.md#interface-relinquishoutputresult), [SignActionResult](./wallet.md#interface-signactionresult), [WalletInterface](./wallet.md#interface-walletinterface)
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
@@ -466,20 +467,21 @@ export class MasterCertificate extends Certificate {
     declare signature?: HexString;
     masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>;
     constructor(type: Base64String, serialNumber: Base64String, subject: PubKeyHex, certifier: PubKeyHex, revocationOutpoint: OutpointString, fields: Record<CertificateFieldNameUnder50Bytes, Base64String>, masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, signature?: HexString) 
-    static async createCertificateFields(creatorWallet: ProtoWallet, certifierOrSubject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<CreateCertificateFieldsResult> 
-    static async createKeyringForVerifier(subjectWallet: ProtoWallet, certifier: WalletCounterparty, verifier: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, Base64String>, fieldsToReveal: string[], masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, serialNumber: Base64String, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<Record<CertificateFieldNameUnder50Bytes, string>> 
-    static async issueCertificateForSubject(certifierWallet: ProtoWallet, subject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>, certificateType: string, getRevocationOutpoint = async (serialNumber: string): Promise<string> => {
+    static async createCertificateFields(creatorWallet: ProtoWallet, certifierOrSubject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>): Promise<CreateCertificateFieldsResult> 
+    static async createKeyringForVerifier(subjectWallet: ProtoWallet, certifier: WalletCounterparty, verifier: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, Base64String>, fieldsToReveal: string[], masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, serialNumber: Base64String): Promise<Record<CertificateFieldNameUnder50Bytes, string>> 
+    static async issueCertificateForSubject(certifierWallet: ProtoWallet, subject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>, certificateType: string, getRevocationOutpoint = async (_serial: string): Promise<string> => {
+        void _serial;
         return "Certificate revocation not tracked.";
     }, serialNumber?: string): Promise<MasterCertificate> 
     static async decryptFields(subjectOrCertifierWallet: ProtoWallet, masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, fields: Record<CertificateFieldNameUnder50Bytes, Base64String>, counterparty: WalletCounterparty): Promise<Record<CertificateFieldNameUnder50Bytes, string>> 
-    static async decryptField(subjectOrCertifierWallet: ProtoWallet, masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, fieldName: Base64String, fieldValue: Base64String, counterparty: WalletCounterparty, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<{
+    static async decryptField(subjectOrCertifierWallet: ProtoWallet, masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, fieldName: Base64String, fieldValue: Base64String, counterparty: WalletCounterparty): Promise<{
         fieldRevelationKey: number[];
         decryptedFieldValue: string;
     }> 
 }
 ```
 
-See also: [Base64String](./wallet.md#type-base64string), [Certificate](./auth.md#class-certificate), [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [HexString](./wallet.md#type-hexstring), [OriginatorDomainNameStringUnder250Bytes](./wallet.md#type-originatordomainnamestringunder250bytes), [OutpointString](./wallet.md#type-outpointstring), [ProtoWallet](./wallet.md#class-protowallet), [PubKeyHex](./wallet.md#type-pubkeyhex), [WalletCounterparty](./wallet.md#type-walletcounterparty)
+See also: [Base64String](./wallet.md#type-base64string), [Certificate](./auth.md#class-certificate), [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [HexString](./wallet.md#type-hexstring), [OutpointString](./wallet.md#type-outpointstring), [ProtoWallet](./wallet.md#class-protowallet), [PubKeyHex](./wallet.md#type-pubkeyhex), [WalletCounterparty](./wallet.md#type-walletcounterparty)
 
 <details>
 
@@ -492,9 +494,9 @@ This method returns a master keyring tied to a specific certifier or subject who
 and sign off on the fields, along with the encrypted certificate fields.
 
 ```ts
-static async createCertificateFields(creatorWallet: ProtoWallet, certifierOrSubject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<CreateCertificateFieldsResult> 
+static async createCertificateFields(creatorWallet: ProtoWallet, certifierOrSubject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>): Promise<CreateCertificateFieldsResult> 
 ```
-See also: [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [OriginatorDomainNameStringUnder250Bytes](./wallet.md#type-originatordomainnamestringunder250bytes), [ProtoWallet](./wallet.md#class-protowallet), [WalletCounterparty](./wallet.md#type-walletcounterparty)
+See also: [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [ProtoWallet](./wallet.md#class-protowallet), [WalletCounterparty](./wallet.md#type-walletcounterparty)
 
 Returns
 
@@ -521,9 +523,9 @@ for the verifier's identity key. The result is a keyring containing the keys nec
 for the verifier to access the designated fields.
 
 ```ts
-static async createKeyringForVerifier(subjectWallet: ProtoWallet, certifier: WalletCounterparty, verifier: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, Base64String>, fieldsToReveal: string[], masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, serialNumber: Base64String, originator?: OriginatorDomainNameStringUnder250Bytes): Promise<Record<CertificateFieldNameUnder50Bytes, string>> 
+static async createKeyringForVerifier(subjectWallet: ProtoWallet, certifier: WalletCounterparty, verifier: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, Base64String>, fieldsToReveal: string[], masterKeyring: Record<CertificateFieldNameUnder50Bytes, Base64String>, serialNumber: Base64String): Promise<Record<CertificateFieldNameUnder50Bytes, string>> 
 ```
-See also: [Base64String](./wallet.md#type-base64string), [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [OriginatorDomainNameStringUnder250Bytes](./wallet.md#type-originatordomainnamestringunder250bytes), [ProtoWallet](./wallet.md#class-protowallet), [WalletCounterparty](./wallet.md#type-walletcounterparty)
+See also: [Base64String](./wallet.md#type-base64string), [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [ProtoWallet](./wallet.md#class-protowallet), [WalletCounterparty](./wallet.md#type-walletcounterparty)
 
 Returns
 
@@ -591,7 +593,8 @@ generated symmetric key, which is then encrypted for the subject. The certificat
 can also includes a revocation outpoint to manage potential revocation.
 
 ```ts
-static async issueCertificateForSubject(certifierWallet: ProtoWallet, subject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>, certificateType: string, getRevocationOutpoint = async (serialNumber: string): Promise<string> => {
+static async issueCertificateForSubject(certifierWallet: ProtoWallet, subject: WalletCounterparty, fields: Record<CertificateFieldNameUnder50Bytes, string>, certificateType: string, getRevocationOutpoint = async (_serial: string): Promise<string> => {
+    void _serial;
     return "Certificate revocation not tracked.";
 }, serialNumber?: string): Promise<MasterCertificate> 
 ```
@@ -646,8 +649,8 @@ export class Peer {
     stopListeningForCertificatesReceived(callbackID: number): void 
     listenForCertificatesRequested(callback: (senderPublicKey: string, requestedCertificates: RequestedCertificateSet) => void): number 
     stopListeningForCertificatesRequested(callbackID: number): void 
-    async processInitialRequest(message: AuthMessage) 
-    async sendCertificateResponse(verifierIdentityKey: string, certificates: VerifiableCertificate[]) 
+    async processInitialRequest(message: AuthMessage): Promise<void> 
+    async sendCertificateResponse(verifierIdentityKey: string, certificates: VerifiableCertificate[]): Promise<void> 
 }
 ```
 
@@ -764,7 +767,7 @@ Argument Details
 Processes an initial request message from a peer.
 
 ```ts
-async processInitialRequest(message: AuthMessage) 
+async processInitialRequest(message: AuthMessage): Promise<void> 
 ```
 See also: [AuthMessage](./auth.md#interface-authmessage)
 
@@ -806,7 +809,7 @@ Will throw an error if the peer session is not authenticated or if sending the r
 Sends a certificate response message containing the specified certificates to a peer.
 
 ```ts
-async sendCertificateResponse(verifierIdentityKey: string, certificates: VerifiableCertificate[]) 
+async sendCertificateResponse(verifierIdentityKey: string, certificates: VerifiableCertificate[]): Promise<void> 
 ```
 See also: [VerifiableCertificate](./auth.md#class-verifiablecertificate)
 
@@ -1061,7 +1064,7 @@ Argument Details
 
 #### Method onData
 
-Registers a callback to handle incoming messages.
+Registers a callback to handle incoming messages. 
 This must be called before sending any messages to ensure responses can be processed.
 
 ```ts
@@ -1274,6 +1277,9 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ```ts
 validateCertificates = async (verifierWallet: WalletInterface, message: AuthMessage, certificatesRequested?: RequestedCertificateSet): Promise<void> => {
+    if ((message.certificates == null) || message.certificates.length === 0) {
+        throw new Error("No certificates were provided in the AuthMessage.");
+    }
     await Promise.all(message.certificates.map(async (incomingCert: VerifiableCertificate) => {
         if (incomingCert.subject !== message.identityKey) {
             throw new Error(`The subject of one of your certificates ("${incomingCert.subject}") is not the same as the request sender ("${message.identityKey}").`);
@@ -1283,13 +1289,13 @@ validateCertificates = async (verifierWallet: WalletInterface, message: AuthMess
         if (!isValidCert) {
             throw new Error(`The signature for the certificate with serial number ${certToVerify.serialNumber} is invalid!`);
         }
-        if (certificatesRequested) {
+        if (certificatesRequested != null) {
             const { certifiers, types } = certificatesRequested;
             if (!certifiers.includes(certToVerify.certifier)) {
                 throw new Error(`Certificate with serial number ${certToVerify.serialNumber} has an unrequested certifier: ${certToVerify.certifier}`);
             }
             const requestedFields = types[certToVerify.type];
-            if (!requestedFields) {
+            if (requestedFields == null) {
                 throw new Error(`Certificate with type ${certToVerify.type} was not requested`);
             }
         }

package/docs/primitives.md

@@ -33,15 +33,15 @@ export default abstract class BasePoint {
     curve: Curve;
     type: "affine" | "jacobian";
     precomputed: {
-        doubles: {
+        doubles?: {
             step: number;
-            points: any[];
-        } | undefined;
-        naf: {
-            wnd: any;
-            points: any[];
-        } | undefined;
-        beta: BasePoint | null | undefined;
+            points: BasePoint[];
+        };
+        naf?: {
+            wnd: number;
+            points: BasePoint[];
+        };
+        beta?: BasePoint | null;
     } | null;
     constructor(type: "affine" | "jacobian") 
 }
@@ -3547,13 +3547,20 @@ export default class Curve {
     tinv: BigNumber;
     zeroA: boolean;
     threeA: boolean;
-    endo: any;
-    _endoWnafT1: any[];
-    _endoWnafT2: any[];
-    _wnafT1: any[];
-    _wnafT2: any[];
-    _wnafT3: any[];
-    _wnafT4: any[];
+    endo: {
+        beta: BigNumber;
+        lambda: BigNumber;
+        basis: Array<{
+            a: BigNumber;
+            b: BigNumber;
+        }>;
+    } | undefined;
+    _endoWnafT1: BigNumber[];
+    _endoWnafT2: BigNumber[];
+    _wnafT1: BigNumber[];
+    _wnafT2: BigNumber[];
+    _wnafT3: BigNumber[];
+    _wnafT4: BigNumber[];
     _bitLength: number;
     static assert(expression: unknown, message: string = "Elliptic curve assertion failed"): void 
     getNAF(num: BigNumber, w: number, bits: number): number[] 
@@ -4149,7 +4156,7 @@ export class KeyShares {
     integrity: string;
     constructor(points: PointInFiniteField[], threshold: number, integrity: string) 
     static fromBackupFormat(shares: string[]): KeyShares 
-    toBackupFormat() 
+    toBackupFormat(): string[] 
 }
 ```
 
@@ -5248,7 +5255,7 @@ export default class PrivateKey extends BigNumber {
         modN: BigNumber;
     } 
     isValid(): boolean 
-    sign(msg: number[] | string, enc?: "hex" | "utf8", forceLowS: boolean = true, customK?: Function | BigNumber): Signature 
+    sign(msg: number[] | string, enc?: "hex" | "utf8", forceLowS: boolean = true, customK?: ((iter: number) => BigNumber) | BigNumber): Signature 
     verify(msg: number[] | string, sig: Signature, enc?: "hex"): boolean 
     toPublicKey(): PublicKey 
     toWif(prefix: number[] = [128]): string 
@@ -5286,7 +5293,7 @@ Argument Details
 + **endian**
   + The endianness provided. By default is 'big endian'. Ignored if number is BigNumber.
 + **modN**
-  + Optional. Default 'apply. If 'apply', apply modN to input to guarantee a valid PrivateKey. If 'error', if input is out of field throw Error('Input is out of field'). If 'nocheck', assumes input is in field.
+  + Optional. Default 'apply. If 'apply', apply modN to input to guarantee a valid PrivateKey. If 'error', if input is out of field throw new Error('Input is out of field'). If 'nocheck', assumes input is in field.
 
 Example
 
@@ -5506,7 +5513,7 @@ true if the PrivateKey's current BigNumber value lies in the field limited by cu
 Signs a message using the private key.
 
 ```ts
-sign(msg: number[] | string, enc?: "hex" | "utf8", forceLowS: boolean = true, customK?: Function | BigNumber): Signature 
+sign(msg: number[] | string, enc?: "hex" | "utf8", forceLowS: boolean = true, customK?: ((iter: number) => BigNumber) | BigNumber): Signature 
 ```
 See also: [BigNumber](./primitives.md#class-bignumber), [Signature](./primitives.md#class-signature)
 
@@ -6979,10 +6986,10 @@ export class SHA512 extends BaseHash {
     W: number[];
     k: number[];
     constructor() 
-    _prepareBlock(msg, start) 
-    _update(msg, start) 
-    _digest() 
-    _digestHex() 
+    _prepareBlock(msg: number[], start: number): void 
+    _update(msg: any, start: number): void 
+    _digest(): number[] 
+    _digestHex(): number[] 
 }
 ```
 
@@ -7301,7 +7308,7 @@ export default class Signature {
     static fromCompact(data: number[] | string, enc?: "hex" | "base64"): Signature 
     constructor(r: BigNumber, s: BigNumber) 
     verify(msg: number[] | string, key: PublicKey, enc?: "hex"): boolean 
-    toString(enc?: "hex" | "base64") 
+    toString(enc?: "hex" | "base64"): number[] | string 
     toDER(enc?: "hex" | "base64"): number[] | string 
     toCompact(recovery: number, compressed: boolean, enc?: "hex" | "base64"): number[] | string 
     RecoverPublicKey(recovery: number, e: BigNumber): PublicKey 
@@ -7522,7 +7529,7 @@ If 'base64', it will return a base64 string.
 Otherwise, it will return an array of numbers.
 
 ```ts
-toString(enc?: "hex" | "base64") 
+toString(enc?: "hex" | "base64"): number[] | string 
 ```
 
 Returns
@@ -7987,19 +7994,19 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ```ts
 fromBase58 = (str: string): number[] => {
-    if (!str || typeof str !== "string") {
+    if (str === "" || typeof str !== "string") {
         throw new Error(`Expected base58 string but got “${str}”`);
     }
-    if (str.match(/[IOl0]/gmu)) {
-        throw new Error(`Invalid base58 character “${str.match(/[IOl0]/gmu)}”`);
+    const match: string[] | null = str.match(/[IOl0]/gmu);
+    if (match !== null) {
+        throw new Error(`Invalid base58 character “${match.join("")}”`);
     }
     const lz = str.match(/^1+/gmu);
-    const psz: number = lz ? lz[0].length : 0;
+    const psz: number = (lz !== null) ? lz[0].length : 0;
     const size = ((str.length - psz) * (Math.log(58) / Math.log(256)) + 1) >>> 0;
     const uint8 = new Uint8Array([
         ...new Uint8Array(psz),
-        ...str
-            .match(/./gmu)
+        ...(str.match(/./gmu) ?? [])
             .map((i) => base58chars.indexOf(i))
             .reduce((acc, i) => {
             acc = acc.map((j) => {
@@ -8022,7 +8029,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: fromBase58Check
 
 ```ts
-fromBase58Check = (str: string, enc?: "hex", prefixLength: number = 1) => {
+fromBase58Check = (str: string, enc?: "hex", prefixLength: number = 1): any => {
     const bin = fromBase58(str);
     let prefix: string | number[] = bin.slice(0, prefixLength);
     let data: string | number[] = bin.slice(prefixLength, -4);
@@ -8281,7 +8288,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: sign
 
 ```ts
-sign = (msg: BigNumber, key: BigNumber, forceLowS: boolean = false, customK?: BigNumber | Function): Signature => {
+sign = (msg: BigNumber, key: BigNumber, forceLowS: boolean = false, customK?: BigNumber | ((iter: number) => BigNumber)): Signature => {
     if (typeof BigInt === "function") {
         const zero = BigInt(0);
         const one = BigInt(1);
@@ -8324,19 +8331,19 @@ sign = (msg: BigNumber, key: BigNumber, forceLowS: boolean = false, customK?: Bi
                 return k;
             }
         }
-        function generateK(): bigint {
+        function generateK(customK?: BigNumber | ((iter: number) => BigNumber)): bigint {
             if (typeof customK === "function") {
-                const k_bn = customK(iter);
-                const k_str = k_bn.toString(16);
-                return BigInt("0x" + k_str);
+                const kbn = customK(iter);
+                const kstr = kbn.toString(16);
+                return BigInt("0x" + kstr);
             }
-            else if (BigNumber.isBN(customK)) {
-                const k_str = customK.toString(16);
-                return BigInt("0x" + k_str);
+            else if ((customK != null) && BigNumber.isBN(customK)) {
+                const kstr = customK.toString(16);
+                return BigInt("0x" + kstr);
             }
             else {
-                const k_hex = drbg.generate(bytes);
-                return BigInt("0x" + k_hex);
+                const khex = drbg.generate(bytes);
+                return BigInt("0x" + khex);
             }
         }
         function mod(a: bigint, m: bigint): bigint {
@@ -8399,21 +8406,30 @@ sign = (msg: BigNumber, key: BigNumber, forceLowS: boolean = false, customK?: Bi
         }): {
             x: bigint;
             y: bigint;
-        } | null {
+        } {
             let N = P;
-            let Q = null;
-            while (k > zero) {
-                if (k % two === one) {
-                    Q = pointAdd(Q, N);
+            let Q: {
+                x: bigint;
+                y: bigint;
+            } | null = null;
+            while (k > BigInt(0)) {
+                if (k % BigInt(2) === BigInt(1)) {
+                    Q = Q === null ? N : (pointAdd(Q, N) ?? Q);
                 }
-                N = pointAdd(N, N);
-                k >>= one;
+                N = pointAdd(N, N) ?? N;
+                k >>= BigInt(1);
+            }
+            if (Q === null) {
+                throw new Error("Scalar multiplication resulted in an invalid point.");
             }
             return Q;
         }
-        while (true) {
-            let k = generateK();
+        let validSignature = false;
+        while (!validSignature) {
             iter += 1;
+            validSignature = true;
+            iter += 1;
+            let k = generateK(customK);
             k = truncateToN(k, n, true);
             if (k <= one || k >= ns1) {
                 if (customK instanceof BigNumber) {
@@ -8455,9 +8471,9 @@ sign = (msg: BigNumber, key: BigNumber, forceLowS: boolean = false, customK?: Bi
             if (forceLowS && s > n / two) {
                 s = n - s;
             }
-            const r_bn = new BigNumber(r.toString(16), 16);
-            const s_bn = new BigNumber(s.toString(16), 16);
-            return new Signature(r_bn, s_bn);
+            const rbn = new BigNumber(r.toString(16), 16);
+            const sbn = new BigNumber(s.toString(16), 16);
+            return new Signature(rbn, sbn);
         }
     }
     else {
@@ -8474,7 +8490,12 @@ sign = (msg: BigNumber, key: BigNumber, forceLowS: boolean = false, customK?: Bi
                 : BigNumber.isBN(customK)
                     ? customK
                     : new BigNumber(drbg.generate(bytes), 16);
-            k = truncateToN(k, true);
+            if (k != null) {
+                k = truncateToN(k, true);
+            }
+            else {
+                throw new Error("k is undefined");
+            }
             if (k.cmpn(1) <= 0 || k.cmp(ns1) >= 0) {
                 if (BigNumber.isBN(customK)) {
                     throw new Error("Invalid fixed custom K value (must be more than 1 and less than N-1)");
@@ -8518,6 +8539,7 @@ sign = (msg: BigNumber, key: BigNumber, forceLowS: boolean = false, customK?: Bi
             return new Signature(r, s);
         }
     }
+    throw new Error("Failed to generate a valid signature");
 }
 ```
 
@@ -8532,7 +8554,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 toArray = (msg: any, enc?: "hex" | "utf8" | "base64"): any[] => {
     if (Array.isArray(msg))
         return msg.slice();
-    if (!msg)
+    if (msg === undefined)
         return [];
     if (typeof msg !== "string") {
         return Array.from(msg, (item: any) => item | 0);
@@ -8559,7 +8581,7 @@ toBase58 = (bin: number[]): string => {
     for (let i = 0; i < base58chars.length; ++i) {
         base58Map[base58chars.charCodeAt(i)] = i;
     }
-    const result = [];
+    const result: number[] = [];
     for (const byte of bin) {
         let carry = byte;
         for (let j = 0; j < result.length; ++j) {
@@ -8567,13 +8589,13 @@ toBase58 = (bin: number[]): string => {
             result[j] = base58chars.charCodeAt(x % 58);
             carry = (x / 58) | 0;
         }
-        while (carry) {
+        while (carry !== 0) {
             result.push(base58chars.charCodeAt(carry % 58));
             carry = (carry / 58) | 0;
         }
     }
     for (const byte of bin) {
-        if (byte)
+        if (byte !== 0)
             break;
         else
             result.push("1".charCodeAt(0));
@@ -8589,7 +8611,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: toBase58Check
 
 ```ts
-toBase58Check = (bin: number[], prefix: number[] = [0]) => {
+toBase58Check = (bin: number[], prefix: number[] = [0]): string => {
     let hash = hash256([...prefix, ...bin]);
     hash = [...prefix, ...bin, ...hash.slice(0, 4)];
     return toBase58(hash);
@@ -8684,20 +8706,19 @@ verify = (msg: BigNumber, sig: Signature, key: Point): boolean => {
         };
         const mod = (a: bigint, m: bigint): bigint => ((a % m) + m) % m;
         const modInv = (a: bigint, m: bigint): bigint => {
-            let [old_r, r] = [a, m];
-            let [old_s, s] = [BigInt(1), BigInt(0)];
+            let [oldr, r] = [a, m];
+            let [olds, s] = [BigInt(1), BigInt(0)];
             while (r !== zero) {
-                const q = old_r / r;
-                [old_r, r] = [r, old_r - q * r];
-                [old_s, s] = [s, old_s - q * s];
+                const q = oldr / r;
+                [oldr, r] = [r, oldr - q * r];
+                [olds, s] = [s, olds - q * s];
             }
-            if (old_r > one)
+            if (oldr > one)
                 return zero;
-            return mod(old_s, m);
+            return mod(olds, m);
         };
         const modMul = (a: bigint, b: bigint, m: bigint): bigint => mod(a * b, m);
         const modSub = (a: bigint, b: bigint, m: bigint): bigint => mod(a - b, m);
-        const modAdd = (a: bigint, b: bigint, m: bigint): bigint => mod(a + b, m);
         const four = BigInt(4);
         const eight = BigInt(8);
         interface JacobianPoint {
@@ -8710,11 +8731,11 @@ verify = (msg: BigNumber, sig: Signature, key: Point): boolean => {
             if (Y1 === zero) {
                 return { X: zero, Y: one, Z: zero };
             }
-            const Y1_sq = modMul(Y1, Y1, p);
-            const S = modMul(four, modMul(X1, Y1_sq, p), p);
+            const Y1sq = modMul(Y1, Y1, p);
+            const S = modMul(four, modMul(X1, Y1sq, p), p);
             const M = modMul(three, modMul(X1, X1, p), p);
             const X3 = modSub(modMul(M, M, p), modMul(two, S, p), p);
-            const Y3 = modSub(modMul(M, modSub(S, X3, p), p), modMul(eight, modMul(Y1_sq, Y1_sq, p), p), p);
+            const Y3 = modSub(modMul(M, modSub(S, X3, p), p), modMul(eight, modMul(Y1sq, Y1sq, p), p), p);
             const Z3 = modMul(two, modMul(Y1, Z1, p), p);
             return { X: X3, Y: Y3, Z: Z3 };
         };
@@ -8791,11 +8812,14 @@ verify = (msg: BigNumber, sig: Signature, key: Point): boolean => {
                 return false;
             }
             const ZInv2 = modMul(ZInv, ZInv, p);
-            const x1_affine = modMul(R.X, ZInv2, p);
-            const v = mod(x1_affine, n);
+            const x1affine = modMul(R.X, ZInv2, p);
+            const v = mod(x1affine, n);
             return v === r;
         };
         const hash = BigInt("0x" + msg.toString(16));
+        if ((key.x == null) || (key.y == null)) {
+            throw new Error("Invalid public key: missing coordinates.");
+        }
         const publicKey = {
             x: BigInt("0x" + key.x.toString(16)),
             y: BigInt("0x" + key.y.toString(16))

package/docs/script.md

@@ -31,8 +31,8 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ```ts
 export default interface ScriptTemplate {
-    lock: (...params: any) => LockingScript | Promise<LockingScript>;
-    unlock: (...params: any) => {
+    lock: (...params: unknown[]) => LockingScript | Promise<LockingScript>;
+    unlock: (...params: unknown[]) => {
         sign: (tx: Transaction, inputIndex: number) => Promise<UnlockingScript>;
         estimateLength: (tx: Transaction, inputIndex: number) => Promise<number>;
     };
@@ -50,7 +50,7 @@ See also: [LockingScript](./script.md#class-lockingscript), [Transaction](./tran
 Creates a locking script with the given parameters.
 
 ```ts
-lock: (...params: any) => LockingScript | Promise<LockingScript>
+lock: (...params: unknown[]) => LockingScript | Promise<LockingScript>
 ```
 See also: [LockingScript](./script.md#class-lockingscript)
 
@@ -63,7 +63,7 @@ This method returns an object containing two functions:
 2. `estimateLength` - A function that returns the estimated length of the unlocking script in bytes.
 
 ```ts
-unlock: (...params: any) => {
+unlock: (...params: unknown[]) => {
     sign: (tx: Transaction, inputIndex: number) => Promise<UnlockingScript>;
     estimateLength: (tx: Transaction, inputIndex: number) => Promise<number>;
 }

package/docs/swagger/dist/swagger-initializer.js

@@ -1,9 +1,9 @@
-window.onload = function() {
-  //<editor-fold desc="Changeable Configuration Block">
+window.onload = function () {
+  // <editor-fold desc="Changeable Configuration Block">
 
   // the following lines will be replaced by docker/configurator, when it runs in a docker-container
   window.ui = SwaggerUIBundle({
-    url: "swagger.yaml",
+    url: 'swagger.yaml',
     dom_id: '#swagger-ui',
     deepLinking: true,
     presets: [
@@ -13,8 +13,8 @@ window.onload = function() {
     plugins: [
       SwaggerUIBundle.plugins.DownloadUrl
     ],
-    layout: "StandaloneLayout"
-  });
+    layout: 'StandaloneLayout'
+  })
 
-  //</editor-fold>
-};
+  // </editor-fold>
+}