sm-crypto-wasm 0.7.0 → 0.7.1

package/dist/asn1/types.d.ts

@@ -12,17 +12,46 @@
  * - `raw` 是对输入缓冲的**视图**（不拷贝），调用方不应假定其生命周期；
  *   需要长期持有时自行 `slice()`；
  * - 解析错误统一为 `Asn1Error`；上层（X.509/CMS）负责转换为各自的错误类型。
+ *
+ * Shared ASN.1 types and constants (a DER/BER subset).
+ *
+ * Relationship to the legacy `src/pem/asn1.ts`:
+ * - The old implementation only covered the minimal types used by PKCS#8 and did
+ *   not preserve the `constructed` bit;
+ * - This layer is the shared infrastructure for X.509 / CMS / WebCrypto: it covers
+ *   BOOLEAN, SET, string types, time, and context/application/private tags.
+ *
+ * Design notes:
+ * - Each node keeps `raw` (the original slice including tag + length + value).
+ *   X.509 TBS digests and CMS `signedAttrs` verification must hash the original
+ *   bytes, never a re-encoding;
+ * - `raw` is a **view** onto the input buffer (no copy); callers must not assume
+ *   its lifetime and should `slice()` when they need to keep it;
+ * - Parse errors are always `Asn1Error`; upper layers (X.509/CMS) map them to
+ *   their own error types.
+ */
+/**
+ * ASN.1 标签类别。
+ *
+ * ASN.1 tag class.
  */
-/** ASN.1 标签类别。 */
 export type Asn1Class = 0 | 1 | 2 | 3;
-/** ASN.1 标签类别常量。 */
+/**
+ * ASN.1 标签类别常量。
+ *
+ * ASN.1 tag class constants.
+ */
 export declare const Asn1Class: {
     readonly Universal: 0;
     readonly Application: 1;
     readonly ContextSpecific: 2;
     readonly Private: 3;
 };
-/** UNIVERSAL 类常用标签编号。 */
+/**
+ * UNIVERSAL 类常用标签编号。
+ *
+ * Frequently used UNIVERSAL tag numbers.
+ */
 export declare const UniversalTag: {
     readonly EndOfContent: 0;
     readonly Boolean: 1;
@@ -45,32 +74,87 @@ export declare const UniversalTag: {
     readonly UniversalString: 28;
     readonly BmpString: 30;
 };
-/** ASN.1 节点。 */
+/**
+ * ASN.1 节点。
+ *
+ * An ASN.1 node.
+ */
 export interface Asn1Node {
-    /** 标签类别：UNIVERSAL=0、APPLICATION=1、CONTEXT=2、PRIVATE=3。 */
+    /**
+     * 标签类别：UNIVERSAL=0、APPLICATION=1、CONTEXT=2、PRIVATE=3。
+     *
+     * Tag class: UNIVERSAL=0, APPLICATION=1, CONTEXT=2, PRIVATE=3.
+     */
     readonly cls: Asn1Class;
-    /** 标签编号（高 tag number 已展开为数值，不含 0x1f 标志位）。 */
+    /**
+     * 标签编号（高 tag number 已展开为数值，不含 0x1f 标志位）。
+     *
+     * Tag number (high tag numbers are already decoded to a plain number, without
+     * the 0x1f marker bit).
+     */
     readonly tag: number;
-    /** 是否为 constructed 编码。 */
+    /**
+     * 是否为 constructed 编码。
+     *
+     * Whether the encoding is constructed.
+     */
     readonly constructed: boolean;
-    /** 是否使用 BER indefinite-length（`0x80` + EOC）。DER 节点恒为 false。 */
+    /**
+     * 是否使用 BER indefinite-length（`0x80` + EOC）。DER 节点恒为 false。
+     *
+     * Whether BER indefinite-length (`0x80` + EOC) is used; always false for DER.
+     */
     readonly indefinite: boolean;
-    /** 内容字节数（indefinite 时为实际内容长度，不含 EOC）。 */
+    /**
+     * 内容字节数（indefinite 时为实际内容长度，不含 EOC）。
+     *
+     * Content length in bytes (for indefinite nodes this is the real content length,
+     * excluding the EOC).
+     */
     readonly length: number;
-    /** primitive 的 value；constructed 为子节点编码拼接后的内容字节。 */
+    /**
+     * primitive 的 value；constructed 为子节点编码拼接后的内容字节。
+     *
+     * The value of a primitive node; for a constructed node, the concatenated
+     * encodings of its children.
+     */
     readonly value: Uint8Array;
-    /** constructed 节点的子节点；primitive 为 `undefined`。 */
+    /**
+     * constructed 节点的子节点；primitive 为 `undefined`。
+     *
+     * Children of a constructed node; `undefined` for primitive nodes.
+     */
     readonly children?: readonly Asn1Node[];
-    /** 节点原始字节（含 tag + length + value；indefinite 时含 EOC）。 */
+    /**
+     * 节点原始字节（含 tag + length + value；indefinite 时含 EOC）。
+     *
+     * Raw node bytes (tag + length + value; including the EOC when indefinite).
+     */
     readonly raw: Uint8Array;
 }
-/** ASN.1 解析/编码错误。 */
+/**
+ * ASN.1 解析/编码错误。
+ *
+ * ASN.1 parse/encode error.
+ */
 export declare class Asn1Error extends Error {
     readonly name = "Asn1Error";
 }
-/** 判断节点是否为指定 UNIVERSAL 类型。 */
+/**
+ * 判断节点是否为指定 UNIVERSAL 类型。
+ *
+ * Tests whether a node is the given UNIVERSAL type.
+ */
 export declare function isUniversal(node: Asn1Node, tag: number): boolean;
-/** 断言节点为指定 UNIVERSAL 类型，否则抛 `Asn1Error`。 */
+/**
+ * 断言节点为指定 UNIVERSAL 类型，否则抛 `Asn1Error`。
+ *
+ * Asserts that a node is the given UNIVERSAL type, otherwise throws `Asn1Error`.
+ */
 export declare function expectUniversal(node: Asn1Node | undefined, tag: number, what: string): Asn1Node;
-/** 断言节点为 constructed SEQUENCE 并返回子节点。 */
+/**
+ * 断言节点为 constructed SEQUENCE 并返回子节点。
+ *
+ * Asserts that a node is a constructed SEQUENCE and returns its children.
+ */
 export declare function expectSequence(node: Asn1Node | undefined, what: string): readonly Asn1Node[];

package/dist/asn1/types.js

@@ -12,15 +12,40 @@
  * - `raw` 是对输入缓冲的**视图**（不拷贝），调用方不应假定其生命周期；
  *   需要长期持有时自行 `slice()`；
  * - 解析错误统一为 `Asn1Error`；上层（X.509/CMS）负责转换为各自的错误类型。
+ *
+ * Shared ASN.1 types and constants (a DER/BER subset).
+ *
+ * Relationship to the legacy `src/pem/asn1.ts`:
+ * - The old implementation only covered the minimal types used by PKCS#8 and did
+ *   not preserve the `constructed` bit;
+ * - This layer is the shared infrastructure for X.509 / CMS / WebCrypto: it covers
+ *   BOOLEAN, SET, string types, time, and context/application/private tags.
+ *
+ * Design notes:
+ * - Each node keeps `raw` (the original slice including tag + length + value).
+ *   X.509 TBS digests and CMS `signedAttrs` verification must hash the original
+ *   bytes, never a re-encoding;
+ * - `raw` is a **view** onto the input buffer (no copy); callers must not assume
+ *   its lifetime and should `slice()` when they need to keep it;
+ * - Parse errors are always `Asn1Error`; upper layers (X.509/CMS) map them to
+ *   their own error types.
+ */
+/**
+ * ASN.1 标签类别常量。
+ *
+ * ASN.1 tag class constants.
  */
-/** ASN.1 标签类别常量。 */
 export const Asn1Class = {
     Universal: 0,
     Application: 1,
     ContextSpecific: 2,
     Private: 3,
 };
-/** UNIVERSAL 类常用标签编号。 */
+/**
+ * UNIVERSAL 类常用标签编号。
+ *
+ * Frequently used UNIVERSAL tag numbers.
+ */
 export const UniversalTag = {
     EndOfContent: 0,
     Boolean: 1,
@@ -43,15 +68,27 @@ export const UniversalTag = {
     UniversalString: 28,
     BmpString: 30,
 };
-/** ASN.1 解析/编码错误。 */
+/**
+ * ASN.1 解析/编码错误。
+ *
+ * ASN.1 parse/encode error.
+ */
 export class Asn1Error extends Error {
     name = 'Asn1Error';
 }
-/** 判断节点是否为指定 UNIVERSAL 类型。 */
+/**
+ * 判断节点是否为指定 UNIVERSAL 类型。
+ *
+ * Tests whether a node is the given UNIVERSAL type.
+ */
 export function isUniversal(node, tag) {
     return node.cls === Asn1Class.Universal && node.tag === tag;
 }
-/** 断言节点为指定 UNIVERSAL 类型，否则抛 `Asn1Error`。 */
+/**
+ * 断言节点为指定 UNIVERSAL 类型，否则抛 `Asn1Error`。
+ *
+ * Asserts that a node is the given UNIVERSAL type, otherwise throws `Asn1Error`.
+ */
 export function expectUniversal(node, tag, what) {
     if (node === undefined) {
         throw new Asn1Error(`${what}: missing element (expected tag ${tag})`);
@@ -61,7 +98,11 @@ export function expectUniversal(node, tag, what) {
     }
     return node;
 }
-/** 断言节点为 constructed SEQUENCE 并返回子节点。 */
+/**
+ * 断言节点为 constructed SEQUENCE 并返回子节点。
+ *
+ * Asserts that a node is a constructed SEQUENCE and returns its children.
+ */
 export function expectSequence(node, what) {
     const seq = expectUniversal(node, UniversalTag.Sequence, what);
     if (!seq.children) {

package/dist/cms/errors.d.ts

@@ -1,13 +1,23 @@
 /**
  * CMS（PKCS#7 SignedData）错误类型。
+ *
+ * CMS (PKCS#7 SignedData) error types.
  */
 import { SmCryptoError } from '../runtime/errors.js';
-/** CMS 解析/签名/验签失败。 */
+/**
+ * CMS 解析/签名/验签失败。
+ *
+ * CMS parse/sign/verify failure.
+ */
 export declare class CmsError extends SmCryptoError {
     readonly name: string;
     constructor(message: string, options?: {
         cause?: unknown;
     });
 }
-/** `verifySignedData` 的结构化失败原因。 */
+/**
+ * `verifySignedData` 的结构化失败原因。
+ *
+ * Structured failure reasons returned by `verifySignedData`.
+ */
 export type CmsVerifyErrorCode = 'NO_CERTIFICATE' | 'DIGEST_MISMATCH' | 'SIGNATURE_INVALID' | 'UNSUPPORTED_ALGORITHM' | 'MALFORMED';

package/dist/cms/errors.js

@@ -1,8 +1,14 @@
 /**
  * CMS（PKCS#7 SignedData）错误类型。
+ *
+ * CMS (PKCS#7 SignedData) error types.
  */
 import { SmCryptoError } from '../runtime/errors.js';
-/** CMS 解析/签名/验签失败。 */
+/**
+ * CMS 解析/签名/验签失败。
+ *
+ * CMS parse/sign/verify failure.
+ */
 export class CmsError extends SmCryptoError {
     name = 'CmsError';
     constructor(message, options) {

package/dist/cms/index.d.ts

@@ -2,6 +2,11 @@
  * CMS SignedData 子模块（`sm-crypto-wasm/cms`）。
  *
  * 只做签名/验签，不建立信任链；证书有效期/用途/链校验由调用方负责。
+ *
+ * CMS SignedData submodule (`sm-crypto-wasm/cms`).
+ *
+ * Signing/verification only, no trust chain building: certificate validity, key usage
+ * and chain validation are the caller's responsibility.
  */
 export { CmsError, type CmsVerifyErrorCode } from './errors.js';
 export * from './oids.js';

package/dist/cms/index.js

@@ -2,6 +2,11 @@
  * CMS SignedData 子模块（`sm-crypto-wasm/cms`）。
  *
  * 只做签名/验签，不建立信任链；证书有效期/用途/链校验由调用方负责。
+ *
+ * CMS SignedData submodule (`sm-crypto-wasm/cms`).
+ *
+ * Signing/verification only, no trust chain building: certificate validity, key usage
+ * and chain validation are the caller's responsibility.
  */
 export { CmsError } from './errors.js';
 export * from './oids.js';

package/dist/cms/oids.d.ts

@@ -1,17 +1,47 @@
 /**
  * CMS oid 常量。
+ *
+ * CMS OID constants.
+ */
+/**
+ * id-data（1.2.840.113549.1.7.1）。
+ *
+ * id-data (1.2.840.113549.1.7.1).
  */
-/** id-data（1.2.840.113549.1.7.1）。 */
 export declare const OID_CMS_DATA = "1.2.840.113549.1.7.1";
-/** id-signedData（1.2.840.113549.1.7.2）。 */
+/**
+ * id-signedData（1.2.840.113549.1.7.2）。
+ *
+ * id-signedData (1.2.840.113549.1.7.2).
+ */
 export declare const OID_CMS_SIGNED_DATA = "1.2.840.113549.1.7.2";
-/** contentType 签名属性（1.2.840.113549.1.9.3）。 */
+/**
+ * contentType 签名属性（1.2.840.113549.1.9.3）。
+ *
+ * The contentType signed attribute (1.2.840.113549.1.9.3).
+ */
 export declare const OID_CMS_CONTENT_TYPE = "1.2.840.113549.1.9.3";
-/** messageDigest 签名属性（1.2.840.113549.1.9.4）。 */
+/**
+ * messageDigest 签名属性（1.2.840.113549.1.9.4）。
+ *
+ * The messageDigest signed attribute (1.2.840.113549.1.9.4).
+ */
 export declare const OID_CMS_MESSAGE_DIGEST = "1.2.840.113549.1.9.4";
-/** signingTime 签名属性（1.2.840.113549.1.9.5）。 */
+/**
+ * signingTime 签名属性（1.2.840.113549.1.9.5）。
+ *
+ * The signingTime signed attribute (1.2.840.113549.1.9.5).
+ */
 export declare const OID_CMS_SIGNING_TIME = "1.2.840.113549.1.9.5";
-/** SM3 摘要算法（1.2.156.10197.1.401）。 */
+/**
+ * SM3 摘要算法（1.2.156.10197.1.401）。
+ *
+ * The SM3 digest algorithm (1.2.156.10197.1.401).
+ */
 export declare const OID_SM3 = "1.2.156.10197.1.401";
-/** SM3withSM2（1.2.156.10197.1.501）。 */
+/**
+ * SM3withSM2（1.2.156.10197.1.501）。
+ *
+ * SM3withSM2 (1.2.156.10197.1.501).
+ */
 export declare const OID_SM3_WITH_SM2 = "1.2.156.10197.1.501";

package/dist/cms/oids.js

@@ -1,17 +1,47 @@
 /**
  * CMS oid 常量。
+ *
+ * CMS OID constants.
+ */
+/**
+ * id-data（1.2.840.113549.1.7.1）。
+ *
+ * id-data (1.2.840.113549.1.7.1).
  */
-/** id-data（1.2.840.113549.1.7.1）。 */
 export const OID_CMS_DATA = '1.2.840.113549.1.7.1';
-/** id-signedData（1.2.840.113549.1.7.2）。 */
+/**
+ * id-signedData（1.2.840.113549.1.7.2）。
+ *
+ * id-signedData (1.2.840.113549.1.7.2).
+ */
 export const OID_CMS_SIGNED_DATA = '1.2.840.113549.1.7.2';
-/** contentType 签名属性（1.2.840.113549.1.9.3）。 */
+/**
+ * contentType 签名属性（1.2.840.113549.1.9.3）。
+ *
+ * The contentType signed attribute (1.2.840.113549.1.9.3).
+ */
 export const OID_CMS_CONTENT_TYPE = '1.2.840.113549.1.9.3';
-/** messageDigest 签名属性（1.2.840.113549.1.9.4）。 */
+/**
+ * messageDigest 签名属性（1.2.840.113549.1.9.4）。
+ *
+ * The messageDigest signed attribute (1.2.840.113549.1.9.4).
+ */
 export const OID_CMS_MESSAGE_DIGEST = '1.2.840.113549.1.9.4';
-/** signingTime 签名属性（1.2.840.113549.1.9.5）。 */
+/**
+ * signingTime 签名属性（1.2.840.113549.1.9.5）。
+ *
+ * The signingTime signed attribute (1.2.840.113549.1.9.5).
+ */
 export const OID_CMS_SIGNING_TIME = '1.2.840.113549.1.9.5';
-/** SM3 摘要算法（1.2.156.10197.1.401）。 */
+/**
+ * SM3 摘要算法（1.2.156.10197.1.401）。
+ *
+ * The SM3 digest algorithm (1.2.156.10197.1.401).
+ */
 export const OID_SM3 = '1.2.156.10197.1.401';
-/** SM3withSM2（1.2.156.10197.1.501）。 */
+/**
+ * SM3withSM2（1.2.156.10197.1.501）。
+ *
+ * SM3withSM2 (1.2.156.10197.1.501).
+ */
 export const OID_SM3_WITH_SM2 = '1.2.156.10197.1.501';

package/dist/cms/parse.d.ts

@@ -9,53 +9,173 @@
  * 除首字节外不做任何重编码，避免 SET 顺序/长度编码差异破坏合法签名。
  *
  * BER 只在 CMS 路径启用；证书本身仍按 DER 严格解析。
+ *
+ * CMS SignedData parsing (read-only).
+ *
+ * Key point (red line #1): the signing input of `signedAttrs` is the **original DER
+ * bytes** (a SET OF Attribute), not a re-encoding of the parsed form. This module keeps:
+ * - `raw`: the bytes obtained by replacing the leading byte of `[0] IMPLICIT` (0xA0)
+ *   with the SET tag (0x31);
+ * - for BER indefinite-length, the value is first encoded as definite-length and then
+ *   the leading byte is replaced.
+ * Nothing but the leading byte is re-encoded, so SET ordering or length-encoding
+ * differences can never break a valid signature.
+ *
+ * BER is enabled on the CMS path only; certificates themselves are still parsed as
+ * strict DER.
  */
 import { type Asn1Node } from '../asn1/index.js';
 import type { Certificate } from '../x509/types.js';
-/** 一个签名属性（Attribute ::= SEQUENCE { attrType, attrValues SET OF }). */
+/**
+ * 一个签名属性（Attribute ::= SEQUENCE { attrType, attrValues SET OF }).
+ *
+ * A single signed attribute (`Attribute ::= SEQUENCE { attrType, attrValues SET OF }`).
+ */
 export interface CmsAttribute {
+    /**
+     * 属性类型 OID。
+     *
+     * The attribute type OID.
+     */
     readonly oid: string;
-    /** AttributeValue 节点（原始视图）。 */
+    /**
+     * AttributeValue 节点（原始视图）。
+     *
+     * AttributeValue nodes (raw views).
+     */
     readonly values: readonly Asn1Node[];
-    /** 整个 Attribute 的原始 DER。 */
+    /**
+     * 整个 Attribute 的原始 DER。
+     *
+     * Raw DER of the whole Attribute.
+     */
     readonly raw: Uint8Array;
 }
-/** 签名者标识。 */
+/**
+ * 签名者标识。
+ *
+ * The signer identifier.
+ */
 export type CmsSignerIdentifier = {
     readonly type: 'issuerAndSerialNumber';
-    /** 签发者 Name 的原始 DER，用于按字节匹配证书。 */
+    /**
+     * 签发者 Name 的原始 DER，用于按字节匹配证书。
+     *
+     * Raw DER of the issuer Name, used to match certificates byte for byte.
+     */
     readonly issuerRaw: Uint8Array;
+    /**
+     * 证书序列号（ASN.1 INTEGER，无符号大整数）。
+     *
+     * The certificate serial number (an ASN.1 INTEGER held as a bigint).
+     */
     readonly serialNumber: bigint;
 } | {
     readonly type: 'subjectKeyIdentifier';
+    /**
+     * `subjectKeyIdentifier` 的原始字节。
+     *
+     * Raw bytes of the `subjectKeyIdentifier` extension value.
+     */
     readonly keyIdentifier: Uint8Array;
 };
-/** 解析后的 SignerInfo。 */
+/**
+ * 解析后的 SignerInfo。
+ *
+ * A parsed SignerInfo.
+ */
 export interface CmsSignerInfo {
+    /**
+     * SignerInfo 版本号（原样解析，不做校验）。
+     *
+     * The SignerInfo version, taken as parsed and not validated.
+     */
     readonly version: number;
+    /**
+     * 签名者标识（`issuerAndSerialNumber` 或 `subjectKeyIdentifier`）。
+     *
+     * The signer identifier (`issuerAndSerialNumber` or `subjectKeyIdentifier`).
+     */
     readonly sid: CmsSignerIdentifier;
+    /**
+     * 摘要算法 OID；验签层只接受 SM3（`OID_SM3`）。
+     *
+     * Digest algorithm OID; the verification layer only accepts SM3 (`OID_SM3`).
+     */
     readonly digestAlgorithm: string;
     /**
      * signedAttrs 的签名输入字节（SET tag 0x31）。
      * 没有 signedAttrs 时为 `undefined`（直接签内容）。
+     *
+     * The signing-input bytes of signedAttrs (SET tag 0x31).
+     * `undefined` when there are no signedAttrs (the content is signed directly).
      */
     readonly signedAttrs?: {
         readonly raw: Uint8Array;
         readonly attributes: readonly CmsAttribute[];
     };
+    /**
+     * 签名算法 OID；验签层只接受 SM3withSM2（`OID_SM3_WITH_SM2`）。
+     *
+     * Signature algorithm OID; the verification layer only accepts SM3withSM2
+     * (`OID_SM3_WITH_SM2`).
+     */
     readonly signatureAlgorithm: string;
+    /**
+     * 签名字节（DER 的 `SEQUENCE { r, s }`，验签前转成裸 `r || s`）。
+     *
+     * Signature bytes (a DER `SEQUENCE { r, s }`, converted to raw `r || s` before
+     * verification).
+     */
     readonly signature: Uint8Array;
 }
-/** 解析后的 SignedData。 */
+/**
+ * 解析后的 SignedData。
+ *
+ * A parsed SignedData.
+ */
 export interface ParsedSignedData {
+    /**
+     * SignedData 版本号（原样解析，不做校验）。
+     *
+     * The SignedData version, taken as parsed and not validated.
+     */
     readonly version: number;
+    /**
+     * `digestAlgorithms` 里的算法 OID 列表。
+     *
+     * The algorithm OIDs listed in `digestAlgorithms`.
+     */
     readonly digestAlgorithms: readonly string[];
+    /**
+     * 内容类型 OID（本仓库的签名路径固定输出 id-data）。
+     *
+     * The content type OID (the signing path here always emits id-data).
+     */
     readonly eContentType: string;
-    /** 内嵌内容；detached 时为 `undefined`。 */
+    /**
+     * 内嵌内容；detached 时为 `undefined`。
+     *
+     * The embedded content; `undefined` for detached signatures.
+     */
     readonly eContent?: Uint8Array;
+    /**
+     * 解析成功的 X.509 证书（无法解析的 CertificateChoices 已跳过）。
+     *
+     * Successfully parsed X.509 certificates (unparseable CertificateChoices skipped).
+     */
     readonly certificates: readonly Certificate[];
+    /**
+     * SignerInfo 列表，顺序与 CMS 中一致。
+     *
+     * The SignerInfo entries, in the order they appear in the CMS.
+     */
     readonly signerInfos: readonly CmsSignerInfo[];
-    /** 整个 ContentInfo 的原始 DER。 */
+    /**
+     * 整个 ContentInfo 的原始 DER。
+     *
+     * Raw DER of the whole ContentInfo.
+     */
     readonly raw: Uint8Array;
 }
 /**
@@ -63,13 +183,35 @@ export interface ParsedSignedData {
  *
  * @param input PEM（`CMS` / `PKCS7`）、base64、hex 或 DER/BER 字节。
  * @throws CmsError 结构非法、不是 SignedData、或尾部有多余字节。
+ *
+ * Parses a CMS ContentInfo (SignedData only).
+ *
+ * @param input PEM (`CMS` / `PKCS7`), base64, hex, or DER/BER bytes.
+ * @throws CmsError When the structure is invalid, is not SignedData, or has trailing
+ *   bytes.
  */
 export declare function parseSignedData(input: string | Uint8Array): ParsedSignedData;
-/** 读取签名属性中的时间值（供验签层使用）。 */
+/**
+ * 读取签名属性中的时间值（供验签层使用）。
+ *
+ * Reads the time value of a signed attribute (used by the verification layer).
+ */
 export declare function attributeTime(attribute: CmsAttribute | undefined): Date | undefined;
-/** 读取签名属性中的 OCTET STRING 值（messageDigest）。 */
+/**
+ * 读取签名属性中的 OCTET STRING 值（messageDigest）。
+ *
+ * Reads the OCTET STRING value of a signed attribute (messageDigest).
+ */
 export declare function attributeOctets(attribute: CmsAttribute | undefined): Uint8Array | undefined;
-/** 读取签名属性中的 OID 值（contentType）。 */
+/**
+ * 读取签名属性中的 OID 值（contentType）。
+ *
+ * Reads the OID value of a signed attribute (contentType).
+ */
 export declare function attributeOid(attribute: CmsAttribute | undefined): string | undefined;
-/** 十六进制便捷函数（供错误信息/调试使用）。 */
+/**
+ * 十六进制便捷函数（供错误信息/调试使用）。
+ *
+ * Hex convenience helper, for error messages and debugging.
+ */
 export declare function cmsHex(bytes: Uint8Array): string;