@aptos-labs/ts-sdk 6.3.1 → 7.0.1

package/dist/core/crypto/singleKey.d.ts

@@ -0,0 +1,175 @@
+import { Deserializer, Serializer } from "../../bcs/index.js";
+import { AnyPublicKeyVariant, HexInput } from "../../types/index.js";
+import { AuthenticationKey } from "../authenticationKey.js";
+import { Ed25519PrivateKey } from "./ed25519.js";
+import { AccountPublicKey, PublicKey } from "./publicKey.js";
+import { Secp256k1PrivateKey } from "./secp256k1.js";
+import { Signature } from "./signature.js";
+import { AptosConfig } from "../../api/aptosConfig.js";
+export type PrivateKeyInput = Ed25519PrivateKey | Secp256k1PrivateKey;
+/**
+ * Represents any public key supported by Aptos.
+ *
+ * Since [AIP-55](https://github.com/aptos-foundation/AIPs/pull/263) Aptos supports
+ * `Legacy` and `Unified` authentication keys.
+ *
+ * Any unified authentication key is represented in the SDK as `AnyPublicKey`.
+ * @group Implementation
+ * @category Serialization
+ */
+export declare class AnyPublicKey extends AccountPublicKey {
+    /**
+     * Reference to the inner public key
+     * @group Implementation
+     * @category Serialization
+     */
+    readonly publicKey: PublicKey;
+    /**
+     * Index of the underlying enum variant
+     * @group Implementation
+     * @category Serialization
+     */
+    readonly variant: AnyPublicKeyVariant;
+    /**
+     * Creates an instance of the signature class based on the provided signature type.
+     * This allows for the handling of different signature variants such as Ed25519, Secp256k1, and Keyless.
+     *
+     * @param publicKey - The publicKey object which determines the variant to be used.
+     * @throws Error if the provided signature type is unsupported.
+     * @group Implementation
+     * @category Serialization
+     */
+    constructor(publicKey: PublicKey, variant?: AnyPublicKeyVariant);
+    /**
+     * Verifies the provided signature against the given message.
+     * This function helps ensure the integrity and authenticity of the message by confirming that the signature is valid.
+     *
+     * @param args - The arguments for signature verification.
+     * @param args.message - The message that was signed.
+     * @param args.signature - The signature to verify, which must be an instance of AnySignature.
+     * @returns A boolean indicating whether the signature is valid for the given message.
+     * @group Implementation
+     * @category Serialization
+     */
+    verifySignature(args: {
+        message: HexInput;
+        signature: AnySignature;
+    }): boolean;
+    /**
+     * Verifies the provided signature against the given message.
+     * This function helps ensure the integrity and authenticity of the message by confirming that the signature is valid.
+     *
+     * @param args - The arguments for signature verification.
+     * @param args.aptosConfig - The configuration object for connecting to the Aptos network
+     * @param args.message - The message that was signed.
+     * @param args.signature - The signature to verify, which must be an instance of AnySignature.
+     * @returns A boolean indicating whether the signature is valid for the given message.
+     * @group Implementation
+     * @category Serialization
+     */
+    verifySignatureAsync(args: {
+        aptosConfig: AptosConfig;
+        message: HexInput;
+        signature: Signature;
+        options?: {
+            throwErrorWithReason?: boolean;
+        };
+    }): Promise<boolean>;
+    /**
+     * Generates an authentication key from the current instance's byte representation.
+     * This function is essential for creating a unique identifier for authentication purposes.
+     *
+     * @returns {AuthenticationKey} The generated authentication key.
+     * @group Implementation
+     * @category Serialization
+     */
+    authKey(): AuthenticationKey;
+    /**
+     * Get the signature in bytes (Uint8Array).
+     *
+     * This function is a warning that it will soon return the underlying signature bytes directly.
+     * Use AnySignature.bcsToBytes() instead.
+     *
+     * @returns Uint8Array representation of the signature.
+     * @group Implementation
+     * @category Serialization
+     */
+    toUint8Array(): Uint8Array;
+    /**
+     * Serializes the current object using the provided serializer.
+     * This function helps in converting the object into a format suitable for transmission or storage.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Serialization
+     */
+    serialize(serializer: Serializer): void;
+    /**
+     * Deserializes an AnySignature from the provided deserializer.
+     * This function helps in reconstructing the AnySignature object from its serialized form, allowing for further processing or validation.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Serialization
+     */
+    static deserialize(deserializer: Deserializer): AnyPublicKey;
+    /**
+     * Determines if the provided public key is an instance of AnyPublicKey.
+     *
+     * @param publicKey - The public key to check.
+     * @deprecated Use `instanceof AnyPublicKey` instead.
+     * @group Implementation
+     * @category Serialization
+     */
+    static isPublicKey(publicKey: AccountPublicKey): publicKey is AnyPublicKey;
+    /**
+     * Determines if the current public key is an instance of Ed25519PublicKey.
+     *
+     * @deprecated use `publicKey instanceof Ed25519PublicKey` instead.
+     * @group Implementation
+     * @category Serialization
+     */
+    isEd25519(): boolean;
+    /**
+     * Checks if the public key is an instance of Secp256k1PublicKey.
+     *
+     * @deprecated use `publicKey instanceof Secp256k1PublicKey` instead.
+     * @group Implementation
+     * @category Serialization
+     */
+    isSecp256k1PublicKey(): boolean;
+    /**
+     * Determines if the provided publicKey is an instance of a valid PublicKey object.
+     *
+     * @param publicKey - The publicKey to be checked for validity.
+     * @param publicKey.publicKey - The actual publicKey object that needs to be validated.
+     * @returns True if the signature is a valid instance; otherwise, false.
+     * @group Implementation
+     * @category Serialization
+     */
+    static isInstance(publicKey: PublicKey): publicKey is AnyPublicKey;
+}
+/**
+ * Represents a signature that utilizes the SingleKey authentication scheme.
+ * This class is designed to encapsulate various types of signatures, which can
+ * only be generated by a `SingleKeySigner` due to the shared authentication mechanism.
+ *
+ * @extends Signature
+ * @group Implementation
+ * @category Serialization
+ */
+export declare class AnySignature extends Signature {
+    readonly signature: Signature;
+    /**
+     * Index of the underlying enum variant
+     * @group Implementation
+     * @category Serialization
+     */
+    private readonly variant;
+    constructor(signature: Signature);
+    toUint8Array(): Uint8Array;
+    serialize(serializer: Serializer): void;
+    static deserialize(deserializer: Deserializer): AnySignature;
+    static isInstance(signature: Signature): signature is AnySignature;
+}
+//# sourceMappingURL=singleKey.d.ts.map

package/dist/core/crypto/singleKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleKey.d.ts","sourceRoot":"","sources":["../../../src/core/crypto/singleKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,mBAAmB,EAGnB,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAsC,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAA0C,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AASvD,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAEtE;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD;;;;OAIG;IACH,SAAgB,SAAS,EAAE,SAAS,CAAC;IAErC;;;;OAIG;IACH,SAAgB,OAAO,EAAE,mBAAmB,CAAC;IAI7C;;;;;;;;OAQG;gBACS,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,mBAAmB;IA0B/D;;;;;;;;;;OAUG;IACH,eAAe,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO;IAW9E;;;;;;;;;;;OAWG;IACG,oBAAoB,CAAC,IAAI,EAAE;QAC/B,WAAW,EAAE,WAAW,CAAC;QACzB,OAAO,EAAE,QAAQ,CAAC;QAClB,SAAS,EAAE,SAAS,CAAC;QACrB,OAAO,CAAC,EAAE;YAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC9C,GAAG,OAAO,CAAC,OAAO,CAAC;IAapB;;;;;;;OAOG;IACH,OAAO,IAAI,iBAAiB;IAO5B;;;;;;;;;OASG;IACH,YAAY,IAAI,UAAU;IAQ1B;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKvC;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;IA8B5D;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,IAAI,YAAY;IAI1E;;;;;;OAMG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;OAMG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,IAAI,YAAY;CAGnE;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,SAAS,EAAE,SAAS,CAAC;IAErC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAIlC,SAAS,EAAE,SAAS;IAyBhC,YAAY,IAAI,UAAU;IAa1B,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKvC,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;IA+B5D,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,IAAI,YAAY;CAQnE"}

package/dist/core/crypto/singleKey.js

@@ -0,0 +1,324 @@
+import { AnyPublicKeyVariant, AnySignatureVariant, SigningScheme as AuthenticationKeyScheme, } from "../../types/index.js";
+import { AuthenticationKey } from "../authenticationKey.js";
+import { Ed25519PublicKey, Ed25519Signature } from "./ed25519.js";
+import { AccountPublicKey } from "./publicKey.js";
+import { Secp256k1PublicKey, Secp256k1Signature } from "./secp256k1.js";
+import { Signature } from "./signature.js";
+import { Secp256r1PublicKey, WebAuthnSignature } from "./secp256r1.js";
+import { detectPublicKeyVariant, detectSignatureVariant, getPublicKeyDeserializer, getSignatureDeserializer, } from "./anyKeyRegistry.js";
+/**
+ * Represents any public key supported by Aptos.
+ *
+ * Since [AIP-55](https://github.com/aptos-foundation/AIPs/pull/263) Aptos supports
+ * `Legacy` and `Unified` authentication keys.
+ *
+ * Any unified authentication key is represented in the SDK as `AnyPublicKey`.
+ * @group Implementation
+ * @category Serialization
+ */
+export class AnyPublicKey extends AccountPublicKey {
+    /**
+     * Reference to the inner public key
+     * @group Implementation
+     * @category Serialization
+     */
+    publicKey;
+    /**
+     * Index of the underlying enum variant
+     * @group Implementation
+     * @category Serialization
+     */
+    variant;
+    // region Constructors
+    /**
+     * Creates an instance of the signature class based on the provided signature type.
+     * This allows for the handling of different signature variants such as Ed25519, Secp256k1, and Keyless.
+     *
+     * @param publicKey - The publicKey object which determines the variant to be used.
+     * @throws Error if the provided signature type is unsupported.
+     * @group Implementation
+     * @category Serialization
+     */
+    constructor(publicKey, variant) {
+        super();
+        this.publicKey = publicKey;
+        if (variant !== undefined) {
+            this.variant = variant;
+        }
+        else if (publicKey instanceof Ed25519PublicKey) {
+            this.variant = AnyPublicKeyVariant.Ed25519;
+        }
+        else if (publicKey instanceof Secp256k1PublicKey) {
+            this.variant = AnyPublicKeyVariant.Secp256k1;
+        }
+        else if (publicKey instanceof Secp256r1PublicKey) {
+            this.variant = AnyPublicKeyVariant.Secp256r1;
+        }
+        else {
+            // Check registered variants (e.g., keyless, federated keyless)
+            const registeredVariant = detectPublicKeyVariant(publicKey);
+            if (registeredVariant !== undefined) {
+                this.variant = registeredVariant;
+            }
+            else {
+                throw new Error("Unsupported public key type");
+            }
+        }
+    }
+    // endregion
+    // region AccountPublicKey
+    /**
+     * Verifies the provided signature against the given message.
+     * This function helps ensure the integrity and authenticity of the message by confirming that the signature is valid.
+     *
+     * @param args - The arguments for signature verification.
+     * @param args.message - The message that was signed.
+     * @param args.signature - The signature to verify, which must be an instance of AnySignature.
+     * @returns A boolean indicating whether the signature is valid for the given message.
+     * @group Implementation
+     * @category Serialization
+     */
+    verifySignature(args) {
+        const { message, signature } = args;
+        if (this.variant === AnyPublicKeyVariant.Keyless || this.variant === AnyPublicKeyVariant.FederatedKeyless) {
+            throw new Error("Use verifySignatureAsync to verify Keyless signatures");
+        }
+        return this.publicKey.verifySignature({
+            message,
+            signature: signature.signature,
+        });
+    }
+    /**
+     * Verifies the provided signature against the given message.
+     * This function helps ensure the integrity and authenticity of the message by confirming that the signature is valid.
+     *
+     * @param args - The arguments for signature verification.
+     * @param args.aptosConfig - The configuration object for connecting to the Aptos network
+     * @param args.message - The message that was signed.
+     * @param args.signature - The signature to verify, which must be an instance of AnySignature.
+     * @returns A boolean indicating whether the signature is valid for the given message.
+     * @group Implementation
+     * @category Serialization
+     */
+    async verifySignatureAsync(args) {
+        if (!(args.signature instanceof AnySignature)) {
+            if (args.options?.throwErrorWithReason) {
+                throw new Error("Signature must be an instance of AnySignature");
+            }
+            return false;
+        }
+        return await this.publicKey.verifySignatureAsync({
+            ...args,
+            signature: args.signature.signature,
+        });
+    }
+    /**
+     * Generates an authentication key from the current instance's byte representation.
+     * This function is essential for creating a unique identifier for authentication purposes.
+     *
+     * @returns {AuthenticationKey} The generated authentication key.
+     * @group Implementation
+     * @category Serialization
+     */
+    authKey() {
+        return AuthenticationKey.fromSchemeAndBytes({
+            scheme: AuthenticationKeyScheme.SingleKey,
+            input: this.toUint8Array(),
+        });
+    }
+    /**
+     * Get the signature in bytes (Uint8Array).
+     *
+     * This function is a warning that it will soon return the underlying signature bytes directly.
+     * Use AnySignature.bcsToBytes() instead.
+     *
+     * @returns Uint8Array representation of the signature.
+     * @group Implementation
+     * @category Serialization
+     */
+    toUint8Array() {
+        return this.bcsToBytes();
+    }
+    // endregion
+    // region Serializable
+    /**
+     * Serializes the current object using the provided serializer.
+     * This function helps in converting the object into a format suitable for transmission or storage.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Serialization
+     */
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(this.variant);
+        this.publicKey.serialize(serializer);
+    }
+    /**
+     * Deserializes an AnySignature from the provided deserializer.
+     * This function helps in reconstructing the AnySignature object from its serialized form, allowing for further processing or validation.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Serialization
+     */
+    static deserialize(deserializer) {
+        const variantIndex = deserializer.deserializeUleb128AsU32();
+        let publicKey;
+        switch (variantIndex) {
+            case AnyPublicKeyVariant.Ed25519:
+                publicKey = Ed25519PublicKey.deserialize(deserializer);
+                break;
+            case AnyPublicKeyVariant.Secp256k1:
+                publicKey = Secp256k1PublicKey.deserialize(deserializer);
+                break;
+            case AnyPublicKeyVariant.Secp256r1:
+                publicKey = Secp256r1PublicKey.deserialize(deserializer);
+                break;
+            default: {
+                // Check registered variant deserializers (e.g., keyless, federated keyless)
+                const registeredDeserializer = getPublicKeyDeserializer(variantIndex);
+                if (registeredDeserializer) {
+                    publicKey = registeredDeserializer(deserializer);
+                    break;
+                }
+                throw new Error(`Unknown variant index for AnyPublicKey: ${variantIndex}. ` +
+                    "If this is a keyless key, ensure keyless support is imported.");
+            }
+        }
+        return new AnyPublicKey(publicKey);
+    }
+    // endregion
+    /**
+     * Determines if the provided public key is an instance of AnyPublicKey.
+     *
+     * @param publicKey - The public key to check.
+     * @deprecated Use `instanceof AnyPublicKey` instead.
+     * @group Implementation
+     * @category Serialization
+     */
+    static isPublicKey(publicKey) {
+        return publicKey instanceof AnyPublicKey;
+    }
+    /**
+     * Determines if the current public key is an instance of Ed25519PublicKey.
+     *
+     * @deprecated use `publicKey instanceof Ed25519PublicKey` instead.
+     * @group Implementation
+     * @category Serialization
+     */
+    isEd25519() {
+        return this.publicKey instanceof Ed25519PublicKey;
+    }
+    /**
+     * Checks if the public key is an instance of Secp256k1PublicKey.
+     *
+     * @deprecated use `publicKey instanceof Secp256k1PublicKey` instead.
+     * @group Implementation
+     * @category Serialization
+     */
+    isSecp256k1PublicKey() {
+        return this.publicKey instanceof Secp256k1PublicKey;
+    }
+    /**
+     * Determines if the provided publicKey is an instance of a valid PublicKey object.
+     *
+     * @param publicKey - The publicKey to be checked for validity.
+     * @param publicKey.publicKey - The actual publicKey object that needs to be validated.
+     * @returns True if the signature is a valid instance; otherwise, false.
+     * @group Implementation
+     * @category Serialization
+     */
+    static isInstance(publicKey) {
+        return "publicKey" in publicKey && "variant" in publicKey;
+    }
+}
+/**
+ * Represents a signature that utilizes the SingleKey authentication scheme.
+ * This class is designed to encapsulate various types of signatures, which can
+ * only be generated by a `SingleKeySigner` due to the shared authentication mechanism.
+ *
+ * @extends Signature
+ * @group Implementation
+ * @category Serialization
+ */
+export class AnySignature extends Signature {
+    signature;
+    /**
+     * Index of the underlying enum variant
+     * @group Implementation
+     * @category Serialization
+     */
+    variant;
+    // region Constructors
+    constructor(signature) {
+        super();
+        this.signature = signature;
+        if (signature instanceof Ed25519Signature) {
+            this.variant = AnySignatureVariant.Ed25519;
+        }
+        else if (signature instanceof Secp256k1Signature) {
+            this.variant = AnySignatureVariant.Secp256k1;
+        }
+        else if (signature instanceof WebAuthnSignature) {
+            this.variant = AnySignatureVariant.WebAuthn;
+        }
+        else {
+            // Check registered variants (e.g., keyless)
+            const registeredVariant = detectSignatureVariant(signature);
+            if (registeredVariant !== undefined) {
+                this.variant = registeredVariant;
+            }
+            else {
+                throw new Error("Unsupported signature type");
+            }
+        }
+    }
+    // endregion
+    // region AccountSignature
+    toUint8Array() {
+        // TODO: keep this warning around for a bit, and eventually change this to return `this.signature.toUint8Array()`.
+        console.warn("[Aptos SDK] Calls to AnySignature.toUint8Array() will soon return the underlying signature bytes. " +
+            "Use AnySignature.bcsToBytes() instead.");
+        return this.bcsToBytes();
+    }
+    // endregion
+    // region Serializable
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(this.variant);
+        this.signature.serialize(serializer);
+    }
+    static deserialize(deserializer) {
+        const variantIndex = deserializer.deserializeUleb128AsU32();
+        let signature;
+        switch (variantIndex) {
+            case AnySignatureVariant.Ed25519:
+                signature = Ed25519Signature.deserialize(deserializer);
+                break;
+            case AnySignatureVariant.Secp256k1:
+                signature = Secp256k1Signature.deserialize(deserializer);
+                break;
+            case AnySignatureVariant.WebAuthn:
+                signature = WebAuthnSignature.deserialize(deserializer);
+                break;
+            default: {
+                // Check registered variant deserializers (e.g., keyless)
+                const registeredDeserializer = getSignatureDeserializer(variantIndex);
+                if (registeredDeserializer) {
+                    signature = registeredDeserializer(deserializer);
+                    break;
+                }
+                throw new Error(`Unknown variant index for AnySignature: ${variantIndex}. ` +
+                    "If this is a keyless signature, ensure keyless support is imported.");
+            }
+        }
+        return new AnySignature(signature);
+    }
+    // endregion
+    static isInstance(signature) {
+        return ("signature" in signature &&
+            typeof signature.signature === "object" &&
+            signature.signature !== null &&
+            "toUint8Array" in signature.signature);
+    }
+}
+//# sourceMappingURL=singleKey.js.map

package/dist/core/crypto/singleKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleKey.js","sourceRoot":"","sources":["../../../src/core/crypto/singleKey.ts"],"names":[],"mappings":"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"}

package/dist/core/crypto/types.d.ts

@@ -0,0 +1,6 @@
+import { AnyPublicKey } from "./singleKey.js";
+import { Ed25519PublicKey } from "./ed25519.js";
+import { MultiKey } from "./multiKey.js";
+import { MultiEd25519PublicKey } from "./multiEd25519.js";
+export type BaseAccountPublicKey = Ed25519PublicKey | AnyPublicKey | MultiKey | MultiEd25519PublicKey;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/crypto/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/crypto/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,YAAY,GAAG,QAAQ,GAAG,qBAAqB,CAAC"}

package/dist/core/crypto/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/crypto/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/crypto/types.ts"],"names":[],"mappings":""}

package/dist/core/crypto/utils.d.ts

@@ -0,0 +1,16 @@
+import { HexInput, SigningScheme } from "../../types/index.js";
+import { AccountPublicKey } from "./publicKey.js";
+import { BaseAccountPublicKey } from "./types.js";
+/**
+ * Helper function to convert a message to sign or to verify to a valid message input
+ *
+ * @param message a message as a string or Uint8Array
+ *
+ * @returns a valid HexInput - string or Uint8Array
+ * @group Implementation
+ * @category Serialization
+ */
+export declare const convertSigningMessage: (message: HexInput) => HexInput;
+export declare const accountPublicKeyToBaseAccountPublicKey: (publicKey: AccountPublicKey) => BaseAccountPublicKey;
+export declare const accountPublicKeyToSigningScheme: (publicKey: AccountPublicKey) => SigningScheme;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/crypto/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/crypto/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,QAAQ,KAAG,QAazD,CAAC;AAEF,eAAO,MAAM,sCAAsC,GAAI,WAAW,gBAAgB,KAAG,oBAiBpF,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,WAAW,gBAAgB,KAAG,aAe7E,CAAC"}

package/dist/core/crypto/utils.js

@@ -0,0 +1,64 @@
+import { SigningScheme } from "../../types/index.js";
+import { TEXT_ENCODER } from "../../utils/const.js";
+import { Hex } from "../hex.js";
+import { Ed25519PublicKey } from "./ed25519.js";
+import { MultiEd25519PublicKey } from "./multiEd25519.js";
+import { MultiKey } from "./multiKey.js";
+import { AnyPublicKey } from "./singleKey.js";
+import { detectPublicKeyVariant } from "./anyKeyRegistry.js";
+/**
+ * Helper function to convert a message to sign or to verify to a valid message input
+ *
+ * @param message a message as a string or Uint8Array
+ *
+ * @returns a valid HexInput - string or Uint8Array
+ * @group Implementation
+ * @category Serialization
+ */
+export const convertSigningMessage = (message) => {
+    // if message is of type string, verify it is a valid Hex string
+    if (typeof message === "string") {
+        const isValid = Hex.isValid(message);
+        // If message is not a valid Hex string, convert it
+        if (!isValid.valid) {
+            return TEXT_ENCODER.encode(message);
+        }
+        // If message is a valid Hex string, return it
+        return message;
+    }
+    // message is a Uint8Array
+    return message;
+};
+export const accountPublicKeyToBaseAccountPublicKey = (publicKey) => {
+    if (publicKey instanceof Ed25519PublicKey ||
+        publicKey instanceof AnyPublicKey ||
+        publicKey instanceof MultiEd25519PublicKey ||
+        publicKey instanceof MultiKey) {
+        return publicKey;
+    }
+    // Keyless / FederatedKeyless public keys register themselves in the variant
+    // registry when imported. Using the registry lets us wrap them in
+    // `AnyPublicKey` here without a compile-time dependency on the keyless
+    // module (which would pull poseidon-lite into the `/account` sub-path).
+    if (detectPublicKeyVariant(publicKey) !== undefined) {
+        return new AnyPublicKey(publicKey);
+    }
+    throw new Error(`Unknown account public key: ${publicKey}`);
+};
+export const accountPublicKeyToSigningScheme = (publicKey) => {
+    const baseAccountPublicKey = accountPublicKeyToBaseAccountPublicKey(publicKey);
+    if (baseAccountPublicKey instanceof Ed25519PublicKey) {
+        return SigningScheme.Ed25519;
+    }
+    if (baseAccountPublicKey instanceof AnyPublicKey) {
+        return SigningScheme.SingleKey;
+    }
+    if (baseAccountPublicKey instanceof MultiEd25519PublicKey) {
+        return SigningScheme.MultiEd25519;
+    }
+    if (baseAccountPublicKey instanceof MultiKey) {
+        return SigningScheme.MultiKey;
+    }
+    throw new Error(`Unknown signing scheme: ${baseAccountPublicKey}`);
+};
+//# sourceMappingURL=utils.js.map

package/dist/core/crypto/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/crypto/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAiB,EAAY,EAAE;IACnE,gEAAgE;IAChE,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,mDAAmD;QACnD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,8CAA8C;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,0BAA0B;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,SAA2B,EAAwB,EAAE;IAC1G,IACE,SAAS,YAAY,gBAAgB;QACrC,SAAS,YAAY,YAAY;QACjC,SAAS,YAAY,qBAAqB;QAC1C,SAAS,YAAY,QAAQ,EAC7B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,4EAA4E;IAC5E,kEAAkE;IAClE,uEAAuE;IACvE,wEAAwE;IACxE,IAAI,sBAAsB,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;QACpD,OAAO,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,SAA2B,EAAiB,EAAE;IAC5F,MAAM,oBAAoB,GAAG,sCAAsC,CAAC,SAAS,CAAC,CAAC;IAC/E,IAAI,oBAAoB,YAAY,gBAAgB,EAAE,CAAC;QACrD,OAAO,aAAa,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,IAAI,oBAAoB,YAAY,YAAY,EAAE,CAAC;QACjD,OAAO,aAAa,CAAC,SAAS,CAAC;IACjC,CAAC;IACD,IAAI,oBAAoB,YAAY,qBAAqB,EAAE,CAAC;QAC1D,OAAO,aAAa,CAAC,YAAY,CAAC;IACpC,CAAC;IACD,IAAI,oBAAoB,YAAY,QAAQ,EAAE,CAAC;QAC7C,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,oBAAoB,EAAE,CAAC,CAAC;AACrE,CAAC,CAAC"}