@aptos-labs/ts-sdk 6.3.1 → 7.0.1

package/dist/core/crypto/secp256r1.js

@@ -0,0 +1,444 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { sha3_256 } from "@noble/hashes/sha3.js";
+import { p256 } from "@noble/curves/nist.js";
+import { Serializer } from "../../bcs/index.js";
+import { Hex } from "../hex.js";
+import { PrivateKeyVariants, SigningScheme as AuthenticationKeyScheme, AnyPublicKeyVariant, } from "../../types/index.js";
+import { PublicKey } from "./publicKey.js";
+import { PrivateKey } from "./privateKey.js";
+import { Signature } from "./signature.js";
+import { AuthenticationKey } from "../authenticationKey.js";
+/**
+ * Represents a Secp256r1 ECDSA public key.
+ *
+ * @extends PublicKey
+ * @property LENGTH - The length of the Secp256r1 public key in bytes.
+ * @group Implementation
+ * @category Serialization
+ */
+export class Secp256r1PublicKey extends PublicKey {
+    // Secp256r1 ecdsa public keys contain a prefix indicating compression and two 32-byte coordinates.
+    static LENGTH = 65;
+    // If it's compressed, it is only 33 bytes
+    static COMPRESSED_LENGTH = 33;
+    // Hex value of the public key
+    key;
+    // Identifier to distinguish from Secp256k1PublicKey
+    keyType = "secp256r1";
+    /**
+     * Create a new PublicKey instance from a HexInput, which can be a string or Uint8Array.
+     * This constructor validates the length of the provided public key data.
+     *
+     * @param hexInput - A HexInput (string or Uint8Array) representing the public key data.
+     * @throws Error if the length of the public key data is not equal to Secp256r1PublicKey.LENGTH or COMPRESSED_LENGTH.
+     * @group Implementation
+     * @category Serialization
+     */
+    constructor(hexInput) {
+        super();
+        const hex = Hex.fromHexInput(hexInput);
+        const keyLength = hex.toUint8Array().length;
+        if (keyLength !== Secp256r1PublicKey.LENGTH && keyLength !== Secp256r1PublicKey.COMPRESSED_LENGTH) {
+            throw new Error(`PublicKey length should be ${Secp256r1PublicKey.LENGTH} or ${Secp256r1PublicKey.COMPRESSED_LENGTH}, received ${keyLength}`);
+        }
+        if (keyLength === Secp256r1PublicKey.COMPRESSED_LENGTH) {
+            const point = p256.Point.fromBytes(hex.toUint8Array());
+            this.key = Hex.fromHexInput(point.toBytes(false));
+        }
+        else {
+            this.key = hex;
+        }
+    }
+    /**
+     * Get the data as a Uint8Array representation.
+     *
+     * @returns Uint8Array representation of the data.
+     * @group Implementation
+     * @category Serialization
+     */
+    toUint8Array() {
+        return this.key.toUint8Array();
+    }
+    /**
+     * Get the public key as a hex string with the 0x prefix.
+     *
+     * @returns string representation of the public key.
+     * @group Implementation
+     * @category Serialization
+     */
+    toString() {
+        return this.key.toString();
+    }
+    /**
+     * Converts the public key to BCS (Binary Canonical Serialization) bytes.
+     * This function serializes the public key data into a byte array format suitable for transmission or storage.
+     *
+     * @returns Uint8Array representation of the serialized public key.
+     * @group Implementation
+     * @category Serialization
+     */
+    bcsToBytes() {
+        const serializer = new Serializer();
+        this.serialize(serializer);
+        return serializer.toUint8Array();
+    }
+    /**
+     * Verifies a Secp256r1 signature against the public key.
+     *
+     * This function checks the validity of a signature for a given message.
+     *
+     * @param args - The arguments for verifying the signature.
+     * @param args.message - The message that was signed.
+     * @param args.signature - The signature to verify against the public key.
+     * @group Implementation
+     * @category Serialization
+     */
+    verifySignature(args) {
+        const { message, signature } = args;
+        const msgHex = Hex.fromHexInput(message).toUint8Array();
+        const sha3Message = sha3_256(msgHex);
+        const rawSignature = signature.toUint8Array();
+        return p256.verify(rawSignature, sha3Message, this.toUint8Array(), { prehash: false });
+    }
+    /**
+     * Note: Secp256r1Signatures can be verified synchronously.
+     *
+     * 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 Secp256r1Signature.
+     * @returns A boolean indicating whether the signature is valid for the given message.
+     * @group Implementation
+     * @category Serialization
+     */
+    async verifySignatureAsync(args) {
+        return this.verifySignature({ message: args.message, signature: args.signature });
+    }
+    /**
+     * Serializes the data into a byte array using the provided serializer.
+     * This function is essential for converting data into a format suitable for transmission or storage.
+     *
+     * @param serializer - The serializer instance used to convert the data.
+     * @group Implementation
+     * @category Serialization
+     */
+    serialize(serializer) {
+        serializer.serializeBytes(this.key.toUint8Array());
+    }
+    /**
+     * Deserializes a Secp256r1PublicKey from the provided deserializer.
+     * This function allows you to reconstruct a Secp256r1PublicKey object from its serialized byte representation.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Serialization
+     */
+    static deserialize(deserializer) {
+        const bytes = deserializer.deserializeBytes();
+        return new Secp256r1PublicKey(bytes);
+    }
+    /**
+     * Loads a Secp256r1PublicKey from the provided deserializer.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Serialization
+     */
+    static load(deserializer) {
+        const bytes = deserializer.deserializeBytes();
+        return new Secp256r1PublicKey(bytes);
+    }
+    /**
+     * Determines if the provided public key is a valid instance of a Secp256r1 public key.
+     * This function checks for the presence of a "key" property and validates the length of the key data.
+     *
+     * @param publicKey - The public key to validate.
+     * @returns A boolean indicating whether the public key is a valid Secp256r1 public key.
+     * @group Implementation
+     * @category Serialization
+     */
+    static isInstance(publicKey) {
+        return ("key" in publicKey &&
+            typeof publicKey.key === "object" &&
+            publicKey.key !== null &&
+            "data" in publicKey.key &&
+            typeof publicKey.key.data === "object" &&
+            publicKey.key.data !== null &&
+            "length" in publicKey.key.data &&
+            publicKey.key?.data?.length === Secp256r1PublicKey.LENGTH &&
+            "keyType" in publicKey &&
+            typeof publicKey === "object" &&
+            publicKey.keyType === "secp256r1");
+    }
+    /**
+     * Generates an authentication key from the public key using the Secp256r1 scheme.
+     * This function is essential for creating a secure authentication key that can be used for further cryptographic operations.
+     *
+     * @returns {AuthenticationKey} The generated authentication key.
+     * @group Implementation
+     * @category Serialization
+     */
+    authKey() {
+        const serializer = new Serializer();
+        serializer.serializeU32AsUleb128(AnyPublicKeyVariant.Secp256r1);
+        serializer.serializeFixedBytes(this.bcsToBytes());
+        return AuthenticationKey.fromSchemeAndBytes({
+            scheme: AuthenticationKeyScheme.SingleKey,
+            input: serializer.toUint8Array(),
+        });
+    }
+}
+/**
+ * Represents a Secp256r1 ECDSA private key, providing functionality to create, sign messages,
+ * derive public keys, and serialize/deserialize the key.
+ * @group Implementation
+ * @category Serialization
+ */
+export class Secp256r1PrivateKey extends PrivateKey {
+    /**
+     * Length of Secp256r1 ecdsa private key
+     * @group Implementation
+     * @category Serialization
+     */
+    static LENGTH = 32;
+    /**
+     * The private key bytes
+     * @private
+     * @group Implementation
+     * @category Serialization
+     */
+    key;
+    /**
+     * Create a new PrivateKey instance from a Uint8Array or String.
+     *
+     * [Read about AIP-80](https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-80.md)
+     *
+     * @param hexInput A HexInput (string or Uint8Array)
+     * @param strict If true, private key must AIP-80 compliant.
+     * @group Implementation
+     * @category Serialization
+     */
+    constructor(hexInput, strict) {
+        super();
+        const privateKeyHex = PrivateKey.parseHexInput(hexInput, PrivateKeyVariants.Secp256r1, strict);
+        const keyLength = privateKeyHex.toUint8Array().length;
+        if (keyLength !== Secp256r1PrivateKey.LENGTH) {
+            throw new Error(`PrivateKey length should be ${Secp256r1PrivateKey.LENGTH}, received ${keyLength}`);
+        }
+        this.key = privateKeyHex;
+    }
+    /**
+     * Get the private key in bytes (Uint8Array).
+     *
+     * @returns
+     * @group Implementation
+     * @category Serialization
+     */
+    toUint8Array() {
+        return this.key.toUint8Array();
+    }
+    /**
+     * Get the private key as a string representation.
+     *
+     * @returns string representation of the private key
+     * @group Implementation
+     * @category Serialization
+     */
+    toString() {
+        return PrivateKey.formatPrivateKey(this.key.toString(), PrivateKeyVariants.Secp256r1);
+    }
+    /**
+     * Get the private key as a hex string with the 0x prefix.
+     *
+     * @returns string representation of the private key.
+     */
+    toHexString() {
+        return this.key.toString();
+    }
+    /**
+     * Sign the given message with the private key.
+     * This function generates a cryptographic signature for the provided message.
+     *
+     * @param message - A message in HexInput format to be signed.
+     * @returns Signature - The generated signature for the provided message.
+     * @group Implementation
+     * @category Serialization
+     */
+    sign(message) {
+        const msgHex = Hex.fromHexInput(message);
+        const sha3Message = sha3_256(msgHex.toUint8Array());
+        const signature = p256.sign(sha3Message, this.key.toUint8Array(), { prehash: false });
+        return new Secp256r1Signature(signature);
+    }
+    /**
+     * Serializes the data into a byte array using the provided serializer.
+     * This function is essential for converting data into a format suitable for transmission or storage.
+     *
+     * @param serializer - The serializer instance used to convert the data.
+     * @group Implementation
+     * @category Serialization
+     */
+    serialize(serializer) {
+        serializer.serializeBytes(this.toUint8Array());
+    }
+    /**
+     * Deserializes a Secp256r1PrivateKey from the provided deserializer.
+     * This function allows you to reconstruct a Secp256r1PrivateKey object from its serialized byte representation.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Serialization
+     */
+    static deserialize(deserializer) {
+        const bytes = deserializer.deserializeBytes();
+        return new Secp256r1PrivateKey(bytes);
+    }
+    /**
+     * Generate a new random private key.
+     *
+     * @returns Secp256r1PrivateKey - A newly generated Secp256r1 private key.
+     * @group Implementation
+     * @category Serialization
+     */
+    static generate() {
+        const hexInput = p256.utils.randomSecretKey();
+        return new Secp256r1PrivateKey(hexInput);
+    }
+    /**
+     * Derive the Secp256r1PublicKey from this private key.
+     *
+     * @returns Secp256r1PublicKey The derived public key.
+     * @group Implementation
+     * @category Serialization
+     */
+    publicKey() {
+        const bytes = p256.getPublicKey(this.key.toUint8Array(), false);
+        return new Secp256r1PublicKey(bytes);
+    }
+}
+export class WebAuthnSignature extends Signature {
+    signature;
+    authenticatorData;
+    clientDataJSON;
+    constructor(signature, authenticatorData, clientDataJSON) {
+        super();
+        this.signature = Hex.fromHexInput(signature);
+        this.authenticatorData = Hex.fromHexInput(authenticatorData);
+        this.clientDataJSON = Hex.fromHexInput(clientDataJSON);
+    }
+    toUint8Array() {
+        return this.signature.toUint8Array();
+    }
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(0);
+        serializer.serializeBytes(this.signature.toUint8Array());
+        serializer.serializeBytes(this.authenticatorData.toUint8Array());
+        serializer.serializeBytes(this.clientDataJSON.toUint8Array());
+    }
+    bcsToBytes() {
+        const serializer = new Serializer();
+        this.serialize(serializer);
+        return serializer.toUint8Array();
+    }
+    bcsToHex() {
+        return Hex.fromHexInput(this.bcsToBytes());
+    }
+    toStringWithoutPrefix() {
+        return Hex.fromHexInput(this.bcsToBytes()).toString();
+    }
+    static deserialize(deserializer) {
+        const id = deserializer.deserializeUleb128AsU32();
+        if (id !== 0) {
+            throw new Error(`Invalid id for WebAuthnSignature: ${id}`);
+        }
+        const signature = deserializer.deserializeBytes();
+        const authenticatorData = deserializer.deserializeBytes();
+        const clientDataJSON = deserializer.deserializeBytes();
+        return new WebAuthnSignature(signature, authenticatorData, clientDataJSON);
+    }
+}
+/**
+ * Represents a signature of a message signed using a Secp256r1 ECDSA private key.
+ *
+ * @group Implementation
+ * @category Serialization
+ */
+export class Secp256r1Signature extends Signature {
+    /**
+     * Secp256r1 ecdsa signatures are 256-bit.
+     * @group Implementation
+     * @category Serialization
+     */
+    static LENGTH = 64;
+    /**
+     * The signature bytes
+     * @private
+     * @group Implementation
+     * @category Serialization
+     */
+    data;
+    /**
+     * Create a new Signature instance from a Uint8Array or String.
+     *
+     * @param hexInput A HexInput (string or Uint8Array)
+     * @group Implementation
+     * @category Serialization
+     */
+    constructor(hexInput) {
+        super();
+        const hex = Hex.fromHexInput(hexInput);
+        const signatureLength = hex.toUint8Array().length;
+        if (signatureLength !== Secp256r1Signature.LENGTH) {
+            throw new Error(`Signature length should be ${Secp256r1Signature.LENGTH}, received ${signatureLength}`);
+        }
+        const signature = p256.Signature.fromBytes(hex.toUint8Array());
+        this.data = Hex.fromHexInput(signature.toBytes());
+    }
+    /**
+     * Get the signature in bytes (Uint8Array).
+     *
+     * @returns Uint8Array representation of the signature
+     * @group Implementation
+     * @category Serialization
+     */
+    toUint8Array() {
+        return this.data.toUint8Array();
+    }
+    /**
+     * Get the signature as a hex string with the 0x prefix.
+     *
+     * @returns string representation of the signature
+     * @group Implementation
+     * @category Serialization
+     */
+    toString() {
+        return this.data.toString();
+    }
+    /**
+     * Serializes the data into a byte array using the provided serializer.
+     * This function is essential for converting data into a format suitable for transmission or storage.
+     *
+     * @param serializer - The serializer instance used to convert the data.
+     * @group Implementation
+     * @category Serialization
+     */
+    serialize(serializer) {
+        serializer.serializeBytes(this.data.toUint8Array());
+    }
+    /**
+     * Deserializes a Secp256r1Signature from the provided deserializer.
+     * This function allows you to reconstruct a Secp256r1Signature object from its serialized byte representation.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Serialization
+     */
+    static deserialize(deserializer) {
+        const hex = deserializer.deserializeBytes();
+        return new Secp256r1Signature(hex);
+    }
+}
+//# sourceMappingURL=secp256r1.js.map

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

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

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

@@ -0,0 +1,35 @@
+import { Serializable } from "../../bcs/index.js";
+/**
+ * An abstract representation of a crypto signature,
+ * associated with a specific signature scheme, e.g., Ed25519 or Secp256k1.
+ *
+ * This class represents the product of signing a message directly from a
+ * PrivateKey and can be verified against a CryptoPublicKey.
+ * @group Implementation
+ * @category Serialization
+ */
+export declare abstract class Signature extends Serializable {
+    /**
+     * Get the raw signature bytes
+     * @group Implementation
+     * @category Serialization
+     */
+    toUint8Array(): Uint8Array;
+    /**
+     * Get the signature as a hex string with a 0x prefix e.g. 0x123456...
+     * @returns The hex string representation of the signature.
+     * @group Implementation
+     * @category Serialization
+     */
+    toString(): string;
+}
+/**
+ * An abstract representation of an account signature,
+ * associated to a specific authentication scheme e.g. Ed25519 or SingleKey
+ *
+ * This is the product of signing a message through an account,
+ * and can be verified against an AccountPublicKey.
+ * @group Implementation
+ * @category Serialization
+ */
+//# sourceMappingURL=signature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../src/core/crypto/signature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;;;GAQG;AACH,8BAAsB,SAAU,SAAQ,YAAY;IAClD;;;;OAIG;IACH,YAAY,IAAI,UAAU;IAI1B;;;;;OAKG;IACH,QAAQ,IAAI,MAAM;CAInB;AAED;;;;;;;;GAQG"}

package/dist/core/crypto/signature.js

@@ -0,0 +1,55 @@
+import { Serializable } from "../../bcs/index.js";
+import { Hex } from "../hex.js";
+/**
+ * An abstract representation of a crypto signature,
+ * associated with a specific signature scheme, e.g., Ed25519 or Secp256k1.
+ *
+ * This class represents the product of signing a message directly from a
+ * PrivateKey and can be verified against a CryptoPublicKey.
+ * @group Implementation
+ * @category Serialization
+ */
+export class Signature extends Serializable {
+    /**
+     * Get the raw signature bytes
+     * @group Implementation
+     * @category Serialization
+     */
+    toUint8Array() {
+        return this.bcsToBytes();
+    }
+    /**
+     * Get the signature as a hex string with a 0x prefix e.g. 0x123456...
+     * @returns The hex string representation of the signature.
+     * @group Implementation
+     * @category Serialization
+     */
+    toString() {
+        const bytes = this.toUint8Array();
+        return Hex.fromHexInput(bytes).toString();
+    }
+}
+/**
+ * An abstract representation of an account signature,
+ * associated to a specific authentication scheme e.g. Ed25519 or SingleKey
+ *
+ * This is the product of signing a message through an account,
+ * and can be verified against an AccountPublicKey.
+ * @group Implementation
+ * @category Serialization
+ */
+// export abstract class AccountSignature extends Serializable {
+//   /**
+//    * Get the raw signature bytes
+//    */
+//   abstract toUint8Array(): Uint8Array;
+//
+//   /**
+//    * Get the signature as a hex string with a 0x prefix e.g. 0x123456...
+//    */
+//   toString(): string {
+//     const bytes = this.toUint8Array();
+//     return Hex.fromHexInput(bytes).toString();
+//   }
+// }
+//# sourceMappingURL=signature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../../src/core/crypto/signature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,OAAgB,SAAU,SAAQ,YAAY;IAClD;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,gEAAgE;AAChE,QAAQ;AACR,mCAAmC;AACnC,QAAQ;AACR,yCAAyC;AACzC,EAAE;AACF,QAAQ;AACR,2EAA2E;AAC3E,QAAQ;AACR,yBAAyB;AACzB,yCAAyC;AACzC,iDAAiD;AACjD,MAAM;AACN,IAAI"}