@atomicfinance/types 4.2.6 → 4.2.8

package/.yalc/@node-dlc/noise/lib/noise-state.ts

@@ -1,481 +0,0 @@
-import { ccpDecrypt, ccpEncrypt, ecdh, hkdf, sha256 } from '@node-dlc/crypto';
-import { getPublicKey } from '@node-dlc/crypto';
-import { ILogger } from '@node-dlc/logger';
-
-import { NoiseStateOptions } from './noise-state-options';
-
-export class NoiseState {
-  public logger: ILogger;
-
-  /**
-   * The official protocol name for the Lightning variant of Noise. This
-   * value is mixed into the iniitialiization function to start the
-   * handshake.
-   */
-  public protocolName = Buffer.from('Noise_XK_secp256k1_ChaChaPoly_SHA256');
-
-  /**
-   * Appended to the hash of the protocolName during initialization.
-   */
-  public prologue = Buffer.from('lightning');
-
-  /**
-   * Local secret is a 32-bit private key valid in elliptic curve
-   * secp256k1. This value is unique to the node and should be
-   * chosen with strong cryptographic randomness.
-   */
-  public ls: Buffer;
-
-  /**
-   * Local compressed public key derviced from the local secret `ls`.
-   * This value is stored as a 33-byte buffer.
-   */
-  public lpk: Buffer;
-
-  /**
-   * Ephemeral secret is a 32-bit private key valid in elliptic curve
-   * secp256k1. This value is generated by each node for each connection.
-   * This value must be generated with strong cryptographic randomness.
-   */
-  public es: Buffer;
-
-  /**
-   * Ephemeral compressed public key derived from the ephemeral secret
-   * `es`. This value is stored as a 33-byte buffer.
-   */
-  public epk: Buffer;
-
-  /**
-   * Remote compressed public key stored as a 33-byte buffer.
-   */
-  public rpk: Buffer;
-
-  /**
-   * Remote party's ephemeral public key as a 33-byte buffer storing
-   * the compressed public key. This value is extracted in act 2 where
-   * it is sent during act 1 to the opposing side.
-   */
-  public repk: Buffer;
-
-  /**
-   * Hanshake hash. This value is the accumulated hash of all handshake data that
-   * has been sent and received during the handshake process.
-   */
-  public h: Buffer;
-
-  /**
-   * Chaining key. This value is the accumulated hash of all previous ECDH outputs.
-   * At the end of the handshake, `ck` is used to dervice the encryption keys
-   * for messages.
-   */
-  public ck: Buffer;
-
-  /**
-   * The key used is the receiving key used to decrypt messages sent by the
-   * other side. It is generated in Act3.
-   */
-  public rk: Buffer;
-
-  /**
-   * The key used by the sender to encrypt messages to the receiver. This value
-   * is generated in Act3.
-   */
-  public sk: Buffer;
-
-  /**
-   * Nonce incremented when sending messages. Initialized to zero in Act3.
-   */
-  public sn: Buffer;
-
-  /**
-   * Nonce incremented when receiving messages. Initialized to zero in Act3.
-   */
-  public rn: Buffer;
-
-  /**
-   * Intermediate key 1. Used to encrypt or decrypt the zero-length AEAD
-   * payload in the corresponding initiator or receiver act.
-   */
-  public tempK1: Buffer;
-
-  /**
-   * Intermediate key 2. Used to encrypt or decrypt the zero-length AEAD
-   * payload in the corresponding initiator or receiver act.
-   */
-  public tempK2: Buffer;
-
-  /**
-   * Intermediate key 3. Used to encrypt or decrypt the zero-length AEAD
-   * payload in the corresponding initiator or receiver act.
-   */
-  public tempK3: Buffer;
-
-  /**
-   * State machine for perforing noise-protocol handshake, message
-   * encryption and decryption, and key rotation.
-   */
-  constructor({ ls, es, logger }: NoiseStateOptions) {
-    this.logger = logger;
-    this.ls = ls;
-    this.lpk = getPublicKey(ls);
-    this.es = es;
-    this.epk = getPublicKey(es);
-  }
-
-  /**
-   * Initiator Act1 is the starting point for the authenticated key exchange
-   * handshake. The initiator attempts to satisfy an implicit challenge by the
-   * responder: knowledge of the static public key of the responder. It also
-   * transmits the initiators ephemeral key.
-   * @param rpk remote public key
-   * @return Buffer that is 50 bytes
-   */
-  public initiatorAct1(rpk: Buffer): Buffer {
-    if (this.logger) this.logger.debug('initiator act1');
-    this.rpk = rpk;
-    this._initialize(this.rpk);
-
-    // 2. h = SHA-256(h || epk)
-    this.h = sha256(Buffer.concat([this.h, this.epk]));
-
-    // 3. es = ECDH(e.priv, rs)
-    const ss = ecdh(this.rpk, this.es);
-
-    // 4. ck, temp_k1 = HKDF(ck, es)
-    const tempK1 = hkdf(ss, 64, this.ck);
-    this.ck = tempK1.slice(0, 32);
-    this.tempK1 = tempK1.slice(32);
-
-    // 5. c = encryptWithAD(temp_k1, 0, h, zero)
-    const c = ccpEncrypt(
-      this.tempK1,
-      Buffer.alloc(12),
-      this.h,
-      Buffer.alloc(0),
-    );
-
-    // 6. h = SHA-256(h || c)
-    this.h = sha256(Buffer.concat([this.h, c]));
-
-    // 7. m = 0 || epk || c
-    const m = Buffer.concat([Buffer.alloc(1), this.epk, c]);
-    return m;
-  }
-
-  /**
-   * Initiator Act2 handles the response generated by the receiver's
-   * Act1, a 50-byte message. The responder's ephemeral key is extacted
-   * from the message during this phase.
-   *
-   * @param m 50-byte message from responder's act1
-   */
-  public initiatorAct2(m: Buffer): void {
-    if (this.logger) this.logger.debug('initiator act2');
-
-    // 1. read exactly 50 bytes off the stream
-    if (m.length !== 50) throw new Error('ACT2_READ_FAILED');
-
-    // 2. parse th read message m into v, re, and c
-    const v = m.slice(0, 1)[0];
-    const re = m.slice(1, 34);
-    const c = m.slice(34);
-
-    // 2a. convert re to public key
-    this.repk = re;
-
-    // 3. assert version is known version
-    if (v !== 0) throw new Error('ACT2_BAD_VERSION');
-
-    // 4. sha256(h || re.serializedCompressed');
-    this.h = sha256(Buffer.concat([this.h, this.repk]));
-
-    // 5. ss = ECDH(re, e.priv);
-    const ss = ecdh(this.repk, this.es);
-
-    // 6. ck, temp_k2 = HKDF(cd, ss)
-    const tempK2 = hkdf(ss, 64, this.ck);
-    this.ck = tempK2.slice(0, 32);
-    this.tempK2 = tempK2.slice(32);
-
-    // 7. p = decryptWithAD()
-    ccpDecrypt(this.tempK2, Buffer.alloc(12), this.h, c);
-
-    // 8. h = sha256(h || c)
-    this.h = sha256(Buffer.concat([this.h, c]));
-  }
-
-  /**
-   * Initiator Act3 is the final phase in the authenticated
-   * key agreement. This act is executed only if act 2
-   * was successful. The initiator transports its static public key
-   * to the responder.
-   */
-  public initiatorAct3(): Buffer {
-    if (this.logger) this.logger.debug('initiator act3');
-
-    // 1. c = encryptWithAD(temp_k2, 1, h, lpk)
-    const c = ccpEncrypt(
-      this.tempK2,
-      Buffer.from([0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0]),
-      this.h,
-      this.lpk,
-    );
-
-    // 2. h = sha256(h || c)
-    this.h = sha256(Buffer.concat([this.h, c]));
-
-    // 3. ss = ECDH(re, s.priv)
-    const ss = ecdh(this.repk, this.ls);
-
-    // 4. ck, temp_k3 = HKDF(ck, ss)
-    const tempK3 = hkdf(ss, 64, this.ck);
-    this.ck = tempK3.slice(0, 32);
-    this.tempK3 = tempK3.slice(32);
-
-    // 5. t = encryptWithAD(temp_k3, 0, h, zero)
-    const t = ccpEncrypt(
-      this.tempK3,
-      Buffer.alloc(12),
-      this.h,
-      Buffer.alloc(0),
-    );
-
-    // 6. sk, rk = hkdf(ck, zero)
-    const sk = hkdf(Buffer.alloc(0), 64, this.ck);
-    this.rk = sk.slice(32);
-    this.sk = sk.slice(0, 32);
-
-    // 7. rn = 0, sn = 0
-    this.sn = Buffer.alloc(12);
-    this.rn = Buffer.alloc(12);
-
-    // 8. send m = 0 || c || t
-    const m = Buffer.concat([Buffer.alloc(1), c, t]);
-    return m;
-  }
-
-  /**
-   * Receiver Act1 extracts the initiators ephemeral key. It also
-   * validates that the initiator knows the receivers public key.
-   * @param m 50-byte message sent by the initiator
-   */
-  public receiveAct1(m: Buffer): void {
-    this._initialize(this.lpk);
-
-    if (this.logger) this.logger.debug('receive act1');
-
-    // 1. read exactly 50 bytes off the stream
-    if (m.length !== 50) throw new Error('ACT1_READ_FAILED');
-
-    // 2. parse th read message m into v,re, and c
-    const v = m.slice(0, 1)[0];
-    const re = m.slice(1, 34);
-    const c = m.slice(34);
-    this.repk = re;
-
-    // 3. assert version is known version
-    if (v !== 0) throw new Error('ACT1_BAD_VERSION');
-
-    // 4. sha256(h || re.serializedCompressed');
-    this.h = sha256(Buffer.concat([this.h, re]));
-
-    // 5. ss = ECDH(re, ls.priv);
-    const ss = ecdh(re, this.ls);
-
-    // 6. ck, temp_k1 = HKDF(cd, ss)
-    const tempK1 = hkdf(ss, 64, this.ck);
-    this.ck = tempK1.slice(0, 32);
-    this.tempK1 = tempK1.slice(32);
-
-    // 7. p = decryptWithAD(temp_k1, 0, h, c)
-    ccpDecrypt(this.tempK1, Buffer.alloc(12), this.h, c);
-
-    // 8. h = sha256(h || c)
-    this.h = sha256(Buffer.concat([this.h, c]));
-  }
-
-  /**
-   * Receiver Act2 takes place only if Act1 was successful.
-   * This act sends responder's ephermeral key to the initiator.
-   */
-  public recieveAct2(): Buffer {
-    // 1. e = generateKey() => done in initialization
-
-    // 2. h = sha256(h || e.pub.compressed())
-    this.h = sha256(Buffer.concat([this.h, this.epk]));
-
-    // 3. ss = ecdh(re, e.priv)
-    const ss = ecdh(this.repk, this.es);
-
-    // 4. ck, temp_k2 = hkdf(ck, ss)
-    const tempK2 = hkdf(ss, 64, this.ck);
-    this.ck = tempK2.slice(0, 32);
-    this.tempK2 = tempK2.slice(32);
-
-    // 5. c = encryptWithAd(temp_k2, 0, h, zero)
-    const c = ccpEncrypt(
-      this.tempK2,
-      Buffer.alloc(12),
-      this.h,
-      Buffer.alloc(0),
-    );
-
-    // 6. h = sha256(h || c)
-    this.h = sha256(Buffer.concat([this.h, c]));
-
-    // 7. m = 0 || e.pub.compressed() Z|| c
-    const m = Buffer.concat([Buffer.alloc(1), this.epk, c]);
-    return m;
-  }
-
-  /**
-   * Receiver Act3 is the final phase in the authenticated key
-   * agreement. This act is executed only if act 2 was successful.
-   * The receiver extracts the public key of the initiator.
-   * @param m 66-byte message
-   */
-  public receiveAct3(m: Buffer): void {
-    // 1. read exactly 66 bytes from the network buffer
-    if (m.length !== 66) throw new Error('ACT3_READ_FAILED');
-
-    // 2. parse m into v, c, t
-    const v = m.slice(0, 1)[0];
-    const c = m.slice(1, 50);
-    const t = m.slice(50);
-
-    // 3. validate v is recognized
-    if (v !== 0) throw new Error('ACT3_BAD_VERSION');
-
-    // 4. rs = decryptWithAD(temp_k2, 1, h, c)
-    const rs = ccpDecrypt(
-      this.tempK2,
-      Buffer.from('000000000100000000000000', 'hex'),
-      this.h,
-      c,
-    );
-    this.rpk = rs;
-
-    // 5. h = sha256(h || c)
-    this.h = sha256(Buffer.concat([this.h, c]));
-
-    // 6. ss = ECDH(rs, e.priv)
-    const ss = ecdh(this.rpk, this.es);
-
-    // 7. ck, temp_k3 = hkdf(cs, ss)
-    const tempK3 = hkdf(ss, 64, this.ck);
-    this.ck = tempK3.slice(0, 32);
-    this.tempK3 = tempK3.slice(32);
-
-    // 8. p = decryptWithAD(temp_k3, 0, h, t)
-    ccpDecrypt(this.tempK3, Buffer.alloc(12), this.h, t);
-
-    // 9. rk, sk = hkdf(ck, zero)
-    const sk = hkdf(Buffer.alloc(0), 64, this.ck);
-    this.rk = sk.slice(0, 32);
-    this.sk = sk.slice(32);
-
-    // 10. rn = 0, sn = 0
-    this.rn = Buffer.alloc(12);
-    this.sn = Buffer.alloc(12);
-  }
-
-  /**
-   * Sends an encrypted message using the shared sending key and nonce.
-   * The nonce is rotated once the message is sent. The sending key is
-   * rotated every 1000 messages.
-   * @param m
-   */
-  public encryptMessage(m: Buffer): Buffer {
-    // step 1/2. serialize m length into int16
-    const l = Buffer.alloc(2);
-    l.writeUInt16BE(m.length, 0);
-
-    // step 3. encrypt l, using chachapoly1305, sn, sk)
-    const lc = ccpEncrypt(this.sk, this.sn, Buffer.alloc(0), l);
-
-    // step 3a: increment sn
-    if (this._incrementSendingNonce() >= 1000) this._rotateSendingKeys();
-
-    // step 4 encrypt m using chachapoly1305, sn, sk
-    const c = ccpEncrypt(this.sk, this.sn, Buffer.alloc(0), m);
-
-    // step 4a: increment sn
-    if (this._incrementSendingNonce() >= 1000) this._rotateSendingKeys();
-
-    // step 5 return m to be sent
-    return Buffer.concat([lc, c]);
-  }
-
-  /**
-   * Decrypts the length of the message using the receiving key and nonce.
-   * The receiving key is rotated every 1000 messages.
-   */
-  public decryptLength(lc: Buffer): number {
-    const l = ccpDecrypt(this.rk, this.rn, Buffer.alloc(0), lc);
-
-    if (this._incrementRecievingNonce() >= 1000) this._rotateRecievingKeys();
-
-    return l.readUInt16BE(0);
-  }
-
-  /**
-   * Decrypts the message using the receiving key and nonce. The receiving
-   * key is rotated every 1000 messages.
-   */
-  public decryptMessage(c: Buffer): Buffer {
-    const m = ccpDecrypt(this.rk, this.rn, Buffer.alloc(0), c);
-
-    if (this._incrementRecievingNonce() >= 1000) this._rotateRecievingKeys();
-
-    return m;
-  }
-
-  /////////////////////////////////////
-
-  /**
-   * Initializes the noise state prior to Act1.
-   */
-  private _initialize(pubkey: Buffer) {
-    if (this.logger) this.logger.debug('initialize noise state');
-
-    // 1. h = SHA-256(protocolName)
-    this.h = sha256(Buffer.from(this.protocolName));
-
-    // 2. ck = h
-    this.ck = this.h;
-
-    // 3. h = SHA-256(h || prologue)
-    this.h = sha256(Buffer.concat([this.h, this.prologue]));
-
-    // 4. h = SHA-256(h || pubkey)
-    this.h = sha256(Buffer.concat([this.h, pubkey]));
-  }
-
-  private _incrementSendingNonce() {
-    const newValue = this.sn.readUInt16LE(4) + 1;
-    this.sn.writeUInt16LE(newValue, 4);
-    return newValue;
-  }
-
-  private _incrementRecievingNonce() {
-    const newValue = this.rn.readUInt16LE(4) + 1;
-    this.rn.writeUInt16LE(newValue, 4);
-    return newValue;
-  }
-
-  private _rotateSendingKeys() {
-    if (this.logger) this.logger.debug('rotating sending key');
-    const result = hkdf(this.sk, 64, this.ck);
-    this.sk = result.slice(32);
-    this.ck = result.slice(0, 32);
-    this.sn = Buffer.alloc(12);
-  }
-
-  private _rotateRecievingKeys() {
-    if (this.logger) this.logger.debug('rotating receiving key');
-    const result = hkdf(this.rk, 64, this.ck);
-    this.rk = result.slice(32);
-    this.ck = result.slice(0, 32);
-    this.rn = Buffer.alloc(12);
-  }
-}

package/.yalc/@node-dlc/noise/lib/read-state.ts

@@ -1,5 +0,0 @@
-export enum READ_STATE {
-  READY_FOR_LEN = 2,
-  READY_FOR_BODY = 3,
-  BLOCKED = 4,
-}

package/.yalc/@node-dlc/noise/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "@node-dlc/noise",
-  "version": "1.0.1",
-  "description": "BOLT 8 Lightning Network Noise Protocol Socket",
-  "main": "dist/index.js",
-  "scripts": {
-    "test": "../../node_modules/.bin/nyc --reporter=lcov --reporter=text --extension=.ts --exclude \"__integration__\" --exclude \"__tests__\" ../../node_modules/.bin/mocha --require ts-node/register --recursive \"__tests__/**/*.spec.*\" --recursive \"__integration__/**/*.spec.*\"",
-    "lint": "../../node_modules/.bin/eslint lib/**/*",
-    "lint:fix": "../../node_modules/.bin/eslint lib/**/* --fix",
-    "build": "../../node_modules/.bin/tsc --project ./tsconfig-build.json"
-  },
-  "keywords": [
-    "lightning network",
-    "bolt-8",
-    "noise protocol",
-    "socket",
-    "server",
-    "bitcoin"
-  ],
-  "author": "Brian Mancini <bmancini@gmail.com>",
-  "homepage": "https://github.com/atomicfinance/node-dlc/tree/master/packages/noise",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/atomicfinance/node-dlc.git"
-  },
-  "dependencies": {
-    "@node-dlc/crypto": "^1.0.1",
-    "@node-dlc/logger": "^1.0.1"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "yalcSig": "c7b8a3d4f548fa3387f48afc06c9fb04"
-}

package/.yalc/@node-dlc/noise/tsconfig-build.json

@@ -1,7 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist"
-  },
-  "include": ["lib"]
-}

package/.yalc/@node-dlc/noise/tsconfig.json

@@ -1,4 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "include": ["lib", "__tests__"]
-}

package/.yalc/@node-dlc/noise/yalc.sig

@@ -1 +0,0 @@
-c7b8a3d4f548fa3387f48afc06c9fb04

package/dist/network-utils.d.ts

@@ -1,10 +0,0 @@
-import { BitcoinNetwork } from 'bitcoin-network';
-export type DdkNetworkString = 'bitcoin' | 'testnet' | 'regtest';
-/**
- * Convert BitcoinNetwork object to DDK-compatible network string
- */
-export declare function bitcoinNetworkToDdkString(network: BitcoinNetwork | string): DdkNetworkString;
-/**
- * Type guard to check if a network string is valid for DDK
- */
-export declare function isDdkNetworkString(value: string): value is DdkNetworkString;

package/dist/network-utils.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bitcoinNetworkToDdkString = bitcoinNetworkToDdkString;
-exports.isDdkNetworkString = isDdkNetworkString;
-/**
- * Convert BitcoinNetwork object to DDK-compatible network string
- */
-function bitcoinNetworkToDdkString(network) {
-    if (typeof network === 'string') {
-        if (!isDdkNetworkString(network)) {
-            throw new Error(`Invalid network string: ${network}. ` +
-                `Expected one of: bitcoin, testnet, regtest`);
-        }
-        return network;
-    }
-    const mapping = {
-        bitcoin: 'bitcoin',
-        bitcoin_testnet: 'testnet',
-        bitcoin_regtest: 'regtest',
-    };
-    const result = mapping[network.name];
-    if (!result) {
-        throw new Error(`Unsupported network: ${network.name}. ` +
-            `Expected one of: bitcoin, bitcoin_testnet, bitcoin_regtest`);
-    }
-    return result;
-}
-/**
- * Type guard to check if a network string is valid for DDK
- */
-function isDdkNetworkString(value) {
-    return ['bitcoin', 'testnet', 'regtest'].includes(value);
-}
-//# sourceMappingURL=network-utils.js.map

package/dist/network-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-utils.js","sourceRoot":"","sources":["../lib/network-utils.ts"],"names":[],"mappings":";;AAOA,8DA4BC;AAKD,gDAEC;AAtCD;;GAEG;AACH,SAAgB,yBAAyB,CACvC,OAAgC;IAEhC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,2BAA2B,OAAO,IAAI;gBACpC,4CAA4C,CAC/C,CAAC;QACJ,CAAC;QACD,OAAO,OAA2B,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,GAAqC;QAChD,OAAO,EAAE,SAAS;QAClB,eAAe,EAAE,SAAS;QAC1B,eAAe,EAAE,SAAS;KAC3B,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,CAAC,IAAI,IAAI;YACtC,4DAA4D,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/yalc.lock

@@ -1,20 +0,0 @@
-{
-  "version": "v1",
-  "packages": {
-    "@node-dlc/messaging": {
-      "signature": "096986a299c0e254d195d2828e2b038a",
-      "file": true,
-      "replaced": "1.0.1"
-    },
-    "@node-dlc/bitcoin": {
-      "signature": "66e5ab6938272fbda17f5a659e259926",
-      "file": true,
-      "replaced": "1.0.1"
-    },
-    "@node-dlc/noise": {
-      "signature": "c7b8a3d4f548fa3387f48afc06c9fb04",
-      "file": true,
-      "replaced": "1.0.1"
-    }
-  }
-}