UNPKG

lightningdevkit

Version:
173 lines 6.76 kB
import { Result_NoneNoneZ } from '../structs/Result_NoneNoneZ.mjs'; import { Result_BlindedHopFeaturesDecodeErrorZ } from '../structs/Result_BlindedHopFeaturesDecodeErrorZ.mjs'; import { CommonBase } from './CommonBase.mjs'; import * as bindings from '../bindings.mjs'; /** * Features used within BOLT 4 encrypted_data_tlv and BOLT 12 blinded_payinfo */ export class BlindedHopFeatures extends CommonBase { /* @internal */ constructor(_dummy, ptr) { super(ptr, bindings.BlindedHopFeatures_free); } /** * Serialize the BlindedHopFeatures object into a byte array which can be read by BlindedHopFeatures_read */ write() { const ret = bindings.BlindedHopFeatures_write(this.ptr); const ret_conv = bindings.decodeUint8Array(ret); return ret_conv; } /** * Read a BlindedHopFeatures from a byte array, created by BlindedHopFeatures_write */ static constructor_read(ser) { const ret = bindings.BlindedHopFeatures_read(bindings.encodeUint8Array(ser)); const ret_hu_conv = Result_BlindedHopFeaturesDecodeErrorZ.constr_from_ptr(ret); return ret_hu_conv; } /** * Checks if two BlindedHopFeaturess contain equal inner contents. * This ignores pointers and is_owned flags and looks at the values in fields. * Two objects with NULL inner values will be considered "equal" here. */ eq(b) { const ret = bindings.BlindedHopFeatures_eq(this.ptr, CommonBase.get_ptr_of(b)); CommonBase.add_ref_from(this, b); return ret; } clone_ptr() { const ret = bindings.BlindedHopFeatures_clone_ptr(this.ptr); return ret; } /** * Creates a copy of the BlindedHopFeatures */ clone() { const ret = bindings.BlindedHopFeatures_clone(this.ptr); const ret_hu_conv = new BlindedHopFeatures(null, ret); CommonBase.add_ref_from(ret_hu_conv, this); return ret_hu_conv; } /** * Generates a non-cryptographic 64-bit hash of the BlindedHopFeatures. */ hash() { const ret = bindings.BlindedHopFeatures_hash(this.ptr); return ret; } /** * Create a blank Features with no features set */ static constructor_empty() { const ret = bindings.BlindedHopFeatures_empty(); const ret_hu_conv = new BlindedHopFeatures(null, ret); CommonBase.add_ref_from(ret_hu_conv, ret_hu_conv); return ret_hu_conv; } /** * Returns the feature set as a list of bytes, in little-endian. This is in reverse byte order * from most on-the-wire encodings. */ le_flags() { const ret = bindings.BlindedHopFeatures_le_flags(this.ptr); const ret_conv = bindings.decodeUint8Array(ret); return ret_conv; } /** * Returns true if this `Features` has any optional flags set */ supports_any_optional_bits() { const ret = bindings.BlindedHopFeatures_supports_any_optional_bits(this.ptr); return ret; } /** * Returns true if this `Features` object contains required features unknown by `other`. */ requires_unknown_bits_from(other) { const ret = bindings.BlindedHopFeatures_requires_unknown_bits_from(this.ptr, CommonBase.get_ptr_of(other)); CommonBase.add_ref_from(this, other); return ret; } /** * Returns the set of required features unknown by `other`, as their bit position. */ required_unknown_bits_from(other) { const ret = bindings.BlindedHopFeatures_required_unknown_bits_from(this.ptr, CommonBase.get_ptr_of(other)); const ret_conv = bindings.decodeUint64Array(ret); CommonBase.add_ref_from(this, other); return ret_conv; } /** * Returns true if this `Features` object contains unknown feature flags which are set as * \"required\". */ requires_unknown_bits() { const ret = bindings.BlindedHopFeatures_requires_unknown_bits(this.ptr); return ret; } /** * Returns true if this `Features` supports any bits which we do not know of */ supports_unknown_bits() { const ret = bindings.BlindedHopFeatures_supports_unknown_bits(this.ptr); return ret; } /** * Sets a required feature bit. Errors if `bit` is outside the feature range as defined * by [BOLT 9]. * * Note: Required bits are even. If an odd bit is given, then the corresponding even bit will * be set instead (i.e., `bit - 1`). * * [BOLT 9]: https://github.com/lightning/bolts/blob/master/09-features.md */ set_required_feature_bit(bit) { const ret = bindings.BlindedHopFeatures_set_required_feature_bit(this.ptr, bit); const ret_hu_conv = Result_NoneNoneZ.constr_from_ptr(ret); return ret_hu_conv; } /** * Sets an optional feature bit. Errors if `bit` is outside the feature range as defined * by [BOLT 9]. * * Note: Optional bits are odd. If an even bit is given, then the corresponding odd bit will be * set instead (i.e., `bit + 1`). * * [BOLT 9]: https://github.com/lightning/bolts/blob/master/09-features.md */ set_optional_feature_bit(bit) { const ret = bindings.BlindedHopFeatures_set_optional_feature_bit(this.ptr, bit); const ret_hu_conv = Result_NoneNoneZ.constr_from_ptr(ret); return ret_hu_conv; } /** * Sets a required custom feature bit. Errors if `bit` is outside the custom range as defined * by [bLIP 2] or if it is a known `T` feature. * * Note: Required bits are even. If an odd bit is given, then the corresponding even bit will * be set instead (i.e., `bit - 1`). * * [bLIP 2]: https://github.com/lightning/blips/blob/master/blip-0002.md#feature-bits */ set_required_custom_bit(bit) { const ret = bindings.BlindedHopFeatures_set_required_custom_bit(this.ptr, bit); const ret_hu_conv = Result_NoneNoneZ.constr_from_ptr(ret); return ret_hu_conv; } /** * Sets an optional custom feature bit. Errors if `bit` is outside the custom range as defined * by [bLIP 2] or if it is a known `T` feature. * * Note: Optional bits are odd. If an even bit is given, then the corresponding odd bit will be * set instead (i.e., `bit + 1`). * * [bLIP 2]: https://github.com/lightning/blips/blob/master/blip-0002.md#feature-bits */ set_optional_custom_bit(bit) { const ret = bindings.BlindedHopFeatures_set_optional_custom_bit(this.ptr, bit); const ret_hu_conv = Result_NoneNoneZ.constr_from_ptr(ret); return ret_hu_conv; } } //# sourceMappingURL=BlindedHopFeatures.mjs.map