@bsv/sdk 1.8.13 → 1.9.0

package/docs/reference/primitives.md

@@ -4,6 +4,15 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ## Interfaces
 
+| |
+| --- |
+| [JacobianPointBI](#interface-jacobianpointbi) |
+| [SignatureHashCache](#interface-signaturehashcache) |
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---
+
 ### Interface: JacobianPointBI
 
 ```ts
@@ -16,6 +25,20 @@ export interface JacobianPointBI {
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
+---
+### Interface: SignatureHashCache
+
+```ts
+export interface SignatureHashCache {
+    hashPrevouts?: number[];
+    hashSequence?: number[];
+    hashOutputsAll?: number[];
+    hashOutputsSingle?: Map<number, number[]>;
+}
+```
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
 ---
 ## Classes
 
@@ -3898,7 +3921,7 @@ const sha256 = new SHA256();
 ```ts
 export class SHA256 {
     constructor() 
-    update(msg: number[] | string, enc?: "hex" | "utf8"): this 
+    update(msg: Uint8Array | number[] | string, enc?: "hex" | "utf8"): this 
     digest(): number[] 
     digestHex(): string 
 }
@@ -3919,8 +3942,8 @@ This class also uses the SHA-256 cryptographic hash algorithm that produces a 25
 export class SHA256HMAC {
     blockSize = 64;
     outSize = 32;
-    constructor(key: number[] | string) 
-    update(msg: number[] | string, enc?: "hex"): SHA256HMAC 
+    constructor(key: Uint8Array | number[] | string) 
+    update(msg: Uint8Array | number[] | string, enc?: "hex"): SHA256HMAC 
     digest(): number[] 
     digestHex(): string 
 }
@@ -3935,7 +3958,7 @@ If the key size is larger than the blockSize, it is digested using SHA-256.
 If the key size is less than the blockSize, it is padded with zeroes.
 
 ```ts
-constructor(key: number[] | string) 
+constructor(key: Uint8Array | number[] | string) 
 ```
 
 Argument Details
@@ -4006,7 +4029,7 @@ let hashedMessage = myHMAC.digestHex();
 Updates the `SHA256HMAC` object with part of the message to be hashed.
 
 ```ts
-update(msg: number[] | string, enc?: "hex"): SHA256HMAC 
+update(msg: Uint8Array | number[] | string, enc?: "hex"): SHA256HMAC 
 ```
 See also: [SHA256HMAC](./primitives.md#class-sha256hmac)
 
@@ -4067,8 +4090,8 @@ This class also uses the SHA-512 cryptographic hash algorithm that produces a 51
 export class SHA512HMAC {
     blockSize = 128;
     outSize = 32;
-    constructor(key: number[] | string) 
-    update(msg: number[] | string, enc?: "hex" | "utf8"): SHA512HMAC 
+    constructor(key: Uint8Array | number[] | string) 
+    update(msg: Uint8Array | number[] | string, enc?: "hex" | "utf8"): SHA512HMAC 
     digest(): number[] 
     digestHex(): string 
 }
@@ -4083,7 +4106,7 @@ If the key size is larger than the blockSize, it is digested using SHA-512.
 If the key size is less than the blockSize, it is padded with zeroes.
 
 ```ts
-constructor(key: number[] | string) 
+constructor(key: Uint8Array | number[] | string) 
 ```
 
 Argument Details
@@ -4154,7 +4177,7 @@ let hashedMessage = myHMAC.digestHex();
 Updates the `SHA512HMAC` object with part of the message to be hashed.
 
 ```ts
-update(msg: number[] | string, enc?: "hex" | "utf8"): SHA512HMAC 
+update(msg: Uint8Array | number[] | string, enc?: "hex" | "utf8"): SHA512HMAC 
 ```
 See also: [SHA512HMAC](./primitives.md#class-sha512hmac)
 
@@ -4682,19 +4705,8 @@ export default class TransactionSignature extends Signature {
     public static readonly SIGHASH_FORKID = 64;
     public static readonly SIGHASH_ANYONECANPAY = 128;
     scope: number;
-    static format(params: {
-        sourceTXID: string;
-        sourceOutputIndex: number;
-        sourceSatoshis: number;
-        transactionVersion: number;
-        otherInputs: TransactionInput[];
-        outputs: TransactionOutput[];
-        inputIndex: number;
-        subscript: Script;
-        inputSequence: number;
-        lockTime: number;
-        scope: number;
-    }): number[] 
+    static format(params: TransactionSignatureFormatParams): number[] 
+    static formatBytes(params: TransactionSignatureFormatParams): Uint8Array 
     static fromChecksigFormat(buf: number[]): TransactionSignature 
     constructor(r: BigNumber, s: BigNumber, scope: number) 
     public hasLowS(): boolean 
@@ -4702,7 +4714,41 @@ export default class TransactionSignature extends Signature {
 }
 ```
 
-See also: [BigNumber](./primitives.md#class-bignumber), [Script](./script.md#class-script), [Signature](./primitives.md#class-signature), [TransactionInput](./transaction.md#interface-transactioninput), [TransactionOutput](./transaction.md#interface-transactionoutput)
+See also: [BigNumber](./primitives.md#class-bignumber), [Signature](./primitives.md#class-signature)
+
+#### Method format
+
+Formats the SIGHASH preimage for the targeted input, optionally using a cache to skip recomputing shared hash prefixes.
+
+```ts
+static format(params: TransactionSignatureFormatParams): number[] 
+```
+
+Argument Details
+
++ **params**
+  + Context for the signing input plus transaction metadata.
++ **params.cache**
+  + Optional cache storing previously computed `hashPrevouts`, `hashSequence`, or `hashOutputs*` values; it will be populated if present.
+
+#### Method formatBytes
+
+Formats the same SIGHASH preimage bytes as `format`, supporting the optional cache for hash reuse.
+
+```ts
+static formatBytes(params: TransactionSignatureFormatParams): Uint8Array 
+```
+
+Returns
+
+Bytes for signing.
+
+Argument Details
+
++ **params**
+  + Context for the signing operation.
++ **params.cache**
+  + Optional `SignatureHashCache` that may already contain hashed prefixes and is populated during formatting.
 
 #### Method hasLowS
 
@@ -4721,11 +4767,12 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ```ts
 export class Writer {
-    public bufs: number[][];
-    constructor(bufs?: number[][]) 
+    public bufs: WriterChunk[];
+    constructor(bufs?: WriterChunk[]) 
     getLength(): number 
+    toUint8Array(): Uint8Array 
     toArray(): number[] 
-    write(buf: number[]): this 
+    write(buf: WriterChunk): this 
     writeReverse(buf: number[]): this 
     writeUInt8(n: number): this 
     writeInt8(n: number): this 
@@ -5309,7 +5356,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: hash160
 
 ```ts
-hash160 = (msg: number[] | string, enc?: "hex" | "utf8"): number[] => {
+hash160 = (msg: Uint8Array | number[] | string, enc?: "hex" | "utf8"): number[] => {
     const first = new SHA256().update(msg, enc).digest();
     return new RIPEMD160().update(first).digest();
 }
@@ -5323,7 +5370,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: hash256
 
 ```ts
-hash256 = (msg: number[] | string, enc?: "hex" | "utf8"): number[] => {
+hash256 = (msg: Uint8Array | number[] | string, enc?: "hex" | "utf8"): number[] => {
     const first = new SHA256().update(msg, enc).digest();
     return new SHA256().update(first).digest();
 }
@@ -5655,7 +5702,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: sha256
 
 ```ts
-sha256 = (msg: number[] | string, enc?: "hex" | "utf8"): number[] => {
+sha256 = (msg: Uint8Array | number[] | string, enc?: "hex" | "utf8"): number[] => {
     return new SHA256().update(msg, enc).digest();
 }
 ```
@@ -5668,7 +5715,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: sha256hmac
 
 ```ts
-sha256hmac = (key: number[] | string, msg: number[] | string, enc?: "hex"): number[] => {
+sha256hmac = (key: Uint8Array | number[] | string, msg: Uint8Array | number[] | string, enc?: "hex"): number[] => {
     return new SHA256HMAC(key).update(msg, enc).digest();
 }
 ```
@@ -5694,7 +5741,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Variable: sha512hmac
 
 ```ts
-sha512hmac = (key: number[] | string, msg: number[] | string, enc?: "hex"): number[] => {
+sha512hmac = (key: Uint8Array | number[] | string, msg: Uint8Array | number[] | string, enc?: "hex"): number[] => {
     return new SHA512HMAC(key).update(msg, enc).digest();
 }
 ```
@@ -5851,16 +5898,19 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ```ts
 toHex = (msg: number[]): string => {
-    let res = "";
-    for (const num of msg) {
-        res += zero2(num.toString(16));
+    if (CAN_USE_BUFFER) {
+        return BufferCtor.from(msg).toString("hex");
     }
-    return res;
+    if (msg.length === 0)
+        return "";
+    const out = new Array(msg.length);
+    for (let i = 0; i < msg.length; i++) {
+        out[i] = HEX_BYTE_STRINGS[msg[i] & 255];
+    }
+    return out.join("");
 }
 ```
 
-See also: [zero2](./primitives.md#variable-zero2)
-
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
 ---

package/docs/reference/script.md

@@ -418,20 +418,18 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ---
 ### Class: Script
 
-The Script class represents a script in a Bitcoin SV transaction,
-encapsulating the functionality to construct, parse, and serialize
-scripts used in both locking (output) and unlocking (input) scripts.
-
 ```ts
 export default class Script {
-    chunks: ScriptChunk[];
     static fromASM(asm: string): Script 
     static fromHex(hex: string): Script 
     static fromBinary(bin: number[]): Script 
-    constructor(chunks: ScriptChunk[] = []) 
+    constructor(chunks: ScriptChunk[] = [], rawBytesCache?: Uint8Array, hexCache?: string, parsed: boolean = true) 
+    get chunks(): ScriptChunk[] 
+    set chunks(value: ScriptChunk[]) 
     toASM(): string 
     toHex(): string 
     toBinary(): number[] 
+    toUint8Array(): Uint8Array 
     writeScript(script: Script): Script 
     writeOpCode(op: number): Script 
     setChunkOpCode(i: number, op: number): Script 
@@ -451,7 +449,7 @@ See also: [BigNumber](./primitives.md#class-bignumber), [ScriptChunk](./script.m
 #### Constructor
 
 ```ts
-constructor(chunks: ScriptChunk[] = []) 
+constructor(chunks: ScriptChunk[] = [], rawBytesCache?: Uint8Array, hexCache?: string, parsed: boolean = true) 
 ```
 See also: [ScriptChunk](./script.md#interface-scriptchunk)
 
@@ -459,6 +457,12 @@ Argument Details
 
 + **chunks**
   + =[] - An array of script chunks to directly initialize the script.
++ **rawBytesCache**
+  + Optional serialized bytes that can be reused instead of reserializing `chunks`.
++ **hexCache**
+  + Optional lowercase hex string that matches the serialized bytes, used to satisfy `toHex` quickly.
++ **parsed**
+  + When false the script defers parsing `rawBytesCache` until `chunks` is accessed; defaults to true.
 
 #### Method findAndDelete
 

package/docs/reference/transaction.md

@@ -589,6 +589,7 @@ export class Beef {
     } 
     toWriter(writer: Writer): void 
     toBinary(): number[] 
+    toUint8Array(): Uint8Array 
     toBinaryAtomic(txid: string): number[] 
     toHex(): string 
     static fromReader(br: Reader): Beef 
@@ -1594,6 +1595,7 @@ export default class Transaction {
     async sign(): Promise<void> 
     async broadcast(broadcaster: Broadcaster = defaultBroadcaster()): Promise<BroadcastResponse | BroadcastFailure> 
     toBinary(): number[] 
+    toUint8Array(): Uint8Array 
     toEF(): number[] 
     toHexEF(): string 
     toHex(): string 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/sdk",
-  "version": "1.8.13",
+  "version": "1.9.0",
   "type": "module",
   "description": "BSV Blockchain Software Development Kit",
   "main": "dist/cjs/mod.js",

package/src/auth/Peer.ts

@@ -17,6 +17,8 @@ import * as Utils from '../primitives/utils.js'
 import { OriginatorDomainNameStringUnder250Bytes, WalletInterface } from '../wallet/Wallet.interfaces.js'
 
 const AUTH_VERSION = '0.1'
+const BufferCtor =
+  typeof globalThis !== 'undefined' ? (globalThis as any).Buffer : undefined
 
 /**
  * Represents a peer capable of performing mutual authentication.
@@ -63,6 +65,7 @@ export class Peer {
   private lastInteractedWithPeer: string | undefined
 
   private readonly originator?: OriginatorDomainNameStringUnder250Bytes
+  private identityPublicKey?: string
 
   /**
    * Creates a new Peer instance
@@ -136,8 +139,7 @@ export class Peer {
     const generalMessage: AuthMessage = {
       version: AUTH_VERSION,
       messageType: 'general',
-      identityKey: (await this.wallet.getPublicKey({ identityKey: true }, this.originator))
-        .publicKey,
+      identityKey: await this.getIdentityPublicKey(),
       nonce: requestNonce,
       yourNonce: peerSession.peerNonce,
       payload: message,
@@ -186,7 +188,7 @@ export class Peer {
     // Prepare the message
     const requestNonce = Utils.toBase64(Random(32))
     const { signature } = await this.wallet.createSignature({
-      data: Utils.toArray(JSON.stringify(certificatesToRequest), 'utf8'),
+      data: Peer.utf8ToBytes(JSON.stringify(certificatesToRequest)),
       protocolID: [2, 'auth message signature'],
       keyID: `${requestNonce} ${peerSession.peerNonce ?? ''}`,
       counterparty: peerSession.peerIdentityKey
@@ -195,8 +197,7 @@ export class Peer {
     const certRequestMessage: AuthMessage = {
       version: AUTH_VERSION,
       messageType: 'certificateRequest',
-      identityKey: (await this.wallet.getPublicKey({ identityKey: true }, this.originator))
-        .publicKey,
+      identityKey: await this.getIdentityPublicKey(),
       nonce: requestNonce,
       initialNonce: peerSession.sessionNonce,
       yourNonce: peerSession.peerNonce,
@@ -352,8 +353,7 @@ export class Peer {
     const initialRequest: AuthMessage = {
       version: AUTH_VERSION,
       messageType: 'initialRequest',
-      identityKey: (await this.wallet.getPublicKey({ identityKey: true }, this.originator))
-        .publicKey,
+      identityKey: await this.getIdentityPublicKey(),
       initialNonce: sessionNonce,
       requestedCertificates: this.certificatesToRequest
     }
@@ -525,7 +525,7 @@ export class Peer {
 
     // Create signature
     const { signature } = await this.wallet.createSignature({
-      data: Utils.toArray(message.initialNonce + sessionNonce, 'base64'),
+      data: Peer.base64ToBytes(message.initialNonce + sessionNonce),
       protocolID: [2, 'auth message signature'],
       keyID: `${message.initialNonce} ${sessionNonce}`,
       counterparty: message.identityKey
@@ -534,8 +534,7 @@ export class Peer {
     const initialResponseMessage: AuthMessage = {
       version: AUTH_VERSION,
       messageType: 'initialResponse',
-      identityKey: (await this.wallet.getPublicKey({ identityKey: true }, this.originator))
-        .publicKey,
+      identityKey: await this.getIdentityPublicKey(),
       initialNonce: sessionNonce,
       yourNonce: message.initialNonce,
       certificates: certificatesToInclude,
@@ -574,9 +573,8 @@ export class Peer {
     }
 
     // Validate message signature
-    const dataToVerify = Utils.toArray(
-      (peerSession.sessionNonce ?? '') + (message.initialNonce ?? ''),
-      'base64'
+    const dataToVerify = Peer.base64ToBytes(
+      (peerSession.sessionNonce ?? '') + (message.initialNonce ?? '')
     )
     const { valid } = await this.wallet.verifySignature({
       data: dataToVerify,
@@ -668,7 +666,7 @@ export class Peer {
     }
 
     const { valid } = await this.wallet.verifySignature({
-      data: Utils.toArray(JSON.stringify(message.requestedCertificates), 'utf8'),
+      data: Peer.utf8ToBytes(JSON.stringify(message.requestedCertificates)),
       signature: message.signature as number[],
       protocolID: [2, 'auth message signature'],
       keyID: `${message.nonce ?? ''} ${peerSession.sessionNonce ?? ''}`,
@@ -721,7 +719,7 @@ export class Peer {
     const peerSession = await this.getAuthenticatedSession(verifierIdentityKey)
     const requestNonce = Utils.toBase64(Random(32))
     const { signature } = await this.wallet.createSignature({
-      data: Utils.toArray(JSON.stringify(certificates), 'utf8'),
+      data: Peer.utf8ToBytes(JSON.stringify(certificates)),
       protocolID: [2, 'auth message signature'],
       keyID: `${requestNonce} ${peerSession.peerNonce ?? ''}`,
       counterparty: peerSession.peerIdentityKey
@@ -730,8 +728,7 @@ export class Peer {
     const certificateResponse: AuthMessage = {
       version: AUTH_VERSION,
       messageType: 'certificateResponse',
-      identityKey: (await this.wallet.getPublicKey({ identityKey: true }, this.originator))
-        .publicKey,
+      identityKey: await this.getIdentityPublicKey(),
       nonce: requestNonce,
       initialNonce: peerSession.sessionNonce,
       yourNonce: peerSession.peerNonce,
@@ -772,7 +769,7 @@ export class Peer {
 
     // Validate message signature
     const { valid } = await this.wallet.verifySignature({
-      data: Utils.toArray(JSON.stringify(message.certificates), 'utf8'),
+      data: Peer.utf8ToBytes(JSON.stringify(message.certificates)),
       signature: message.signature as number[],
       protocolID: [2, 'auth message signature'],
       keyID: `${message.nonce ?? ''} ${peerSession.sessionNonce ?? ''}`,
@@ -846,4 +843,33 @@ export class Peer {
       cb(message.identityKey, message.payload ?? [])
     })
   }
+
+  private async getIdentityPublicKey (): Promise<string> {
+    if (this.identityPublicKey != null) {
+      return this.identityPublicKey
+    }
+    const { publicKey } = await this.wallet.getPublicKey(
+      { identityKey: true },
+      this.originator
+    )
+    this.identityPublicKey = publicKey
+    return publicKey
+  }
+
+  private static utf8ToBytes (data: string): number[] {
+    if (BufferCtor != null) {
+      return Array.from(BufferCtor.from(data, 'utf8'))
+    }
+    if (typeof TextEncoder !== 'undefined') {
+      return Array.from(new TextEncoder().encode(data))
+    }
+    return Utils.toArray(data, 'utf8')
+  }
+
+  private static base64ToBytes (data: string): number[] {
+    if (BufferCtor != null) {
+      return Array.from(BufferCtor.from(data, 'base64'))
+    }
+    return Utils.toArray(data, 'base64')
+  }
 }

package/src/primitives/BigNumber.ts

@@ -1,6 +1,19 @@
 // @ts-nocheck
 import ReductionContext from './ReductionContext.js'
 
+const BufferCtor =
+  typeof globalThis !== 'undefined' ? (globalThis as any).Buffer : undefined
+const CAN_USE_BUFFER =
+  BufferCtor != null && typeof BufferCtor.from === 'function'
+const HEX_CHAR_TO_VALUE = new Int8Array(256).fill(-1)
+for (let i = 0; i < 10; i++) {
+  HEX_CHAR_TO_VALUE[48 + i] = i // '0'-'9'
+}
+for (let i = 0; i < 6; i++) {
+  HEX_CHAR_TO_VALUE[65 + i] = 10 + i // 'A'-'F'
+  HEX_CHAR_TO_VALUE[97 + i] = 10 + i // 'a'-'f'
+}
+
 /**
  * JavaScript numbers are only precise up to 53 bits. Since Bitcoin relies on
  * 256-bit cryptography, this BigNumber class enables operations on larger
@@ -1059,31 +1072,30 @@ export default class BigNumber {
   static fromSm (bytes: number[], endian: 'big' | 'little' = 'big'): BigNumber {
     if (bytes.length === 0) return new BigNumber(0n)
 
+    const beBytes = bytes.slice()
+    if (endian === 'little') {
+      beBytes.reverse()
+    }
     let sign: 0 | 1 = 0
-    let hex = ''
+    if (beBytes.length > 0 && (beBytes[0] & 0x80) !== 0) {
+      sign = 1
+      beBytes[0] &= 0x7f
+    }
 
-    if (endian === 'little') {
-      const last = bytes.length - 1
-      let firstByte = bytes[last]
-      if ((firstByte & 0x80) !== 0) { sign = 1; firstByte &= 0x7f }
-      hex += (firstByte < 16 ? '0' : '') + firstByte.toString(16)
-      for (let i = last - 1; i >= 0; i--) {
-        const b = bytes[i]
-        hex += (b < 16 ? '0' : '') + b.toString(16)
-      }
+    let magnitude = 0n
+    if (CAN_USE_BUFFER) {
+      const hex = BufferCtor.from(beBytes).toString('hex') as string
+      magnitude = hex.length === 0 ? 0n : BigInt('0x' + hex)
     } else {
-      let firstByte = bytes[0]
-      if ((firstByte & 0x80) !== 0) { sign = 1; firstByte &= 0x7f }
-      hex += (firstByte < 16 ? '0' : '') + firstByte.toString(16)
-      for (let i = 1; i < bytes.length; i++) {
-        const b = bytes[i]
-        hex += (b < 16 ? '0' : '') + b.toString(16)
+      let hex = ''
+      for (const byte of beBytes) {
+        hex += byte < 16 ? '0' + byte.toString(16) : byte.toString(16)
       }
+      magnitude = hex.length === 0 ? 0n : BigInt('0x' + hex)
     }
 
-    const mag = hex === '' ? 0n : BigInt('0x' + hex)
     const r = new BigNumber(0n)
-    r._initializeState(mag, sign)
+    r._initializeState(magnitude, sign)
     return r
   }
 
@@ -1105,17 +1117,26 @@ export default class BigNumber {
     const byteLen = hex.length / 2
     const bytes = new Array(byteLen)
     for (let i = 0, j = 0; i < hex.length; i += 2) {
-      bytes[j++] = parseInt(hex.slice(i, i + 2), 16)
+      const high = HEX_CHAR_TO_VALUE[hex.charCodeAt(i)]
+      const low = HEX_CHAR_TO_VALUE[hex.charCodeAt(i + 1)]
+      bytes[j++] = ((high & 0xf) << 4) | (low & 0xf)
     }
 
+    let result: number[]
     if (this._sign === 1) {
-      if ((bytes[0] & 0x80) !== 0) bytes.unshift(0x80)
-      else bytes[0] |= 0x80
+      if ((bytes[0] & 0x80) !== 0) {
+        result = [0x80, ...bytes]
+      } else {
+        result = bytes.slice()
+        result[0] |= 0x80
+      }
     } else if ((bytes[0] & 0x80) !== 0) {
-      bytes.unshift(0x00)
+      result = [0x00, ...bytes]
+    } else {
+      result = bytes.slice()
     }
 
-    return endian === 'little' ? bytes.reverse() : bytes
+    return endian === 'little' ? result.reverse() : result
   }
 
   /**