@xyo-network/payment-payload-plugins 2.91.5 → 2.91.6

package/src/Escrow/validators/escrow/appraisalAuthorities.ts

@@ -0,0 +1,37 @@
+import { asAddress } from '@xylabs/hex'
+import { ModuleIdentifier } from '@xyo-network/module-model'
+
+import { EscrowTerms } from '../../Terms'
+import { moduleIdentifiersContainsAllOf } from '../common'
+import { EscrowTermsValidationFunction } from '../types'
+
+const name = 'EscrowTerms.appraisalAuthorities'
+
+/**
+ * A function that validates the escrow terms for appraisalAuthorities
+ * @returns True if the escrow terms contain appraisalAuthorities, false otherwise
+ */
+export const appraisalAuthoritiesExistValidator: EscrowTermsValidationFunction = (terms: EscrowTerms) => {
+  // Validate we have appraisalAuthorities
+  const appraisalAuthorities = terms.appraisalAuthorities
+  if (!appraisalAuthorities || appraisalAuthorities.length === 0) {
+    console.log(`${name}: No appraisalAuthorities: ${terms.appraisalAuthorities}`)
+    return false
+  }
+  // Validate the authorities are addresses
+  if (appraisalAuthorities.map((x) => asAddress(x)).length !== appraisalAuthorities.length) {
+    console.log(`${name}: Invalid address: ${terms.appraisalAuthorities}`)
+    return false
+  }
+  return true
+}
+
+export const getAppraisalAuthoritiesAllowedValidator = (allowed: ModuleIdentifier[]): EscrowTermsValidationFunction => {
+  return (terms: EscrowTerms) => {
+    const result = moduleIdentifiersContainsAllOf(terms, (t) => t.appraisalAuthorities, allowed, true)
+    if (!result) {
+      console.log(`${name}: Appraisal authority not allowed: ${terms.appraisalAuthorities}`)
+    }
+    return result
+  }
+}

package/src/Escrow/validators/escrow/assets.ts

@@ -0,0 +1,18 @@
+import { EscrowTerms } from '../../Terms'
+import { EscrowTermsValidationFunction } from '../types'
+
+const name = 'EscrowTerms.assets'
+
+/**
+ * Returns a function that validates the escrow terms for assets
+ * @returns A function that validates the escrow terms for assets
+ */
+export const assetsExistValidator: EscrowTermsValidationFunction = (terms: EscrowTerms) => {
+  // Validate we have assets
+  const assets = terms.assets
+  if (!assets || assets.length === 0) {
+    console.log(`${name}: No assets: ${terms.assets}`)
+    return false
+  }
+  return true
+}

package/src/Escrow/validators/escrow/buyer.ts

@@ -0,0 +1,25 @@
+import { asAddress } from '@xylabs/hex'
+
+import { EscrowTerms } from '../../Terms'
+import { EscrowTermsValidationFunction } from '../types'
+
+const name = 'EscrowTerms.buyer'
+
+/**
+ * A function that validates the escrow terms for buyer
+ * @returns True if the escrow terms contain buyer, false otherwise
+ */
+export const buyerExistsValidator: EscrowTermsValidationFunction = (terms: EscrowTerms) => {
+  // Validate we have buyer
+  const buyer = terms.buyer
+  if (!buyer || buyer.length === 0) {
+    console.log(`${name}: No buyer: ${terms.buyer}`)
+    return false
+  }
+  // Validate the authorities are addresses
+  if (buyer.map((x) => asAddress(x)).length !== buyer.length) {
+    console.log(`${name}: Invalid address: ${terms.buyer}`)
+    return false
+  }
+  return true
+}

package/src/Escrow/validators/escrow/buyerSecret.ts

@@ -0,0 +1,75 @@
+import { assertEx } from '@xylabs/assert'
+import { Hash } from '@xylabs/hex'
+import { isBoundWitnessWithMeta } from '@xyo-network/boundwitness-model'
+import { BoundWitnessValidator } from '@xyo-network/boundwitness-validator'
+import { Payload, WithMeta } from '@xyo-network/payload-model'
+
+import { EscrowTerms } from '../../Terms'
+import { EscrowTermsValidationFunction } from '../types'
+
+const name = 'EscrowTerms.buyerSecret'
+
+/**
+ * Returns a function that validates the escrow terms for buyerSecret
+ * @returns A function that validates the escrow terms for buyerSecret
+ */
+export const buyerSecretExistsValidator: EscrowTermsValidationFunction = (terms: EscrowTerms) => {
+  // Validate we have buyerSecret
+  const buyerSecret = terms.buyerSecret
+  if (!buyerSecret || buyerSecret.length === 0) {
+    console.log(`${name}: No buyerSecret: ${terms.buyerSecret}`)
+    return false
+  }
+  return true
+}
+
+/**
+ * Returns a function that validates the escrow terms for the existence of the buyerSecret in the dictionary
+ * @param dictionary Payload dictionary of the escrow terms
+ * @returns A function that validates the escrow terms for the existence of the buyerSecret in the dictionary
+ */
+export const getBuyerSecretSuppliedValidator = (dictionary: Record<Hash, WithMeta<Payload>>): EscrowTermsValidationFunction => {
+  return (terms: EscrowTerms) => {
+    const buyerSecret = assertEx(terms.buyerSecret, () => `${name}: No buyerSecret: ${terms.buyerSecret}`)
+    if (!dictionary[buyerSecret]) {
+      console.log(`${name}: Payload not supplied for buyerSecret: ${buyerSecret}`)
+      return false
+    }
+    return true
+  }
+}
+
+/**
+ * Returns a function that validates the escrow terms for the existence of the buyerSecret signed by the buyer
+ * @param dictionary Payload dictionary of the escrow terms
+ * @returns A function that validates the escrow terms for the existence of the buyerSecret signed by the buyer
+ */
+export const getBuyerSecretSignedValidator = (dictionary: Record<Hash, WithMeta<Payload>>): EscrowTermsValidationFunction => {
+  return async (terms: EscrowTerms) => {
+    const buyer = assertEx(terms.buyer, () => `${name}: No buyer: ${terms.buyer}`)
+    const buyerSecret = assertEx(terms.buyerSecret, () => `${name}: No buyerSecret: ${terms.buyerSecret}`)
+    // Buyer-signed buyer secrets
+    const buyerSecretBWs = Object.values(dictionary)
+      // Find all BoundWitnesses
+      .filter(isBoundWitnessWithMeta)
+      // That contain the buyer secret
+      .filter((bw) => bw.payload_hashes.includes(buyerSecret))
+      // That are signed by all the buyers
+      .filter((bw) => buyer.every((buyerAddress) => bw.addresses.includes(buyerAddress)))
+
+    // If there are no buyerSecret BWs, return false
+    if (buyerSecretBWs.length === 0) {
+      console.log(`${name}: No BoundWitnesses supplied for buyerSecret: ${buyerSecret}`)
+      return false
+    }
+
+    // Ensure each BW supplied for the buyerSecret is valid
+    const errors = await Promise.all(buyerSecretBWs.map((bw) => new BoundWitnessValidator(bw).validate()))
+    const validBoundWitnesses = errors.every((errors) => errors.length === 0)
+    if (!validBoundWitnesses) {
+      console.log(`${name}: Invalid BoundWitnesses supplied for buyerSecret: ${buyerSecret}`)
+      return false
+    }
+    return true
+  }
+}

package/src/Escrow/validators/escrow/index.ts

@@ -0,0 +1,9 @@
+export * from './agent'
+export * from './appraisal'
+export * from './appraisalAuthorities'
+export * from './assets'
+export * from './buyer'
+export * from './buyerSecret'
+export * from './nbfExp'
+export * from './paymentAuthorities'
+export * from './seller'

package/src/Escrow/validators/escrow/nbfExp.ts

@@ -0,0 +1,18 @@
+import { EscrowTerms } from '../../Terms'
+import { EscrowTermsValidationFunction } from '../types'
+
+export const getNbfExpValidator = (now: number, minRequiredDuration: number): EscrowTermsValidationFunction => {
+  const minExp = now + minRequiredDuration
+  return (terms: EscrowTerms) => {
+    const { exp, nbf } = terms
+    if (nbf === undefined || nbf < now) {
+      console.log(`EscrowTerms.nbf: invalid nbf ${terms.nbf}`)
+      return false
+    }
+    if (exp === undefined || exp < minExp || nbf > exp) {
+      console.log(`EscrowTerms.exp: invalid exp ${terms.exp}`)
+      return false
+    }
+    return true
+  }
+}

package/src/Escrow/validators/escrow/paymentAuthorities.ts

@@ -0,0 +1,17 @@
+import { ModuleIdentifier } from '@xyo-network/module-model'
+
+import { EscrowTerms } from '../../Terms'
+import { moduleIdentifiersContainsAllOf } from '../common'
+import { EscrowTermsValidationFunction } from '../types'
+
+const name = 'EscrowTerms.paymentAuthorities'
+
+export const getPaymentAuthoritiesAllowedValidator = (allowed: ModuleIdentifier[]): EscrowTermsValidationFunction => {
+  return (terms: EscrowTerms) => {
+    const result = moduleIdentifiersContainsAllOf(terms, (t) => t.paymentAuthorities, allowed, true)
+    if (!result) {
+      console.log(`${name}: Payment authority not allowed: ${terms.paymentAuthorities}`)
+    }
+    return result
+  }
+}

package/src/Escrow/validators/escrow/seller.ts

@@ -0,0 +1,25 @@
+import { asAddress } from '@xylabs/hex'
+
+import { EscrowTerms } from '../../Terms'
+import { EscrowTermsValidationFunction } from '../types'
+
+const name = 'EscrowTerms.seller'
+
+/**
+ * A function that validates the escrow terms for seller
+ * @returns True if the escrow terms contain seller, false otherwise
+ */
+export const sellerExistsValidator: EscrowTermsValidationFunction = (terms: EscrowTerms) => {
+  // Validate we have seller
+  const seller = terms.seller
+  if (!seller || seller.length === 0) {
+    console.log(`${name}: No seller: ${terms.seller}`)
+    return false
+  }
+  // Validate the authorities are addresses
+  if (seller.map((x) => asAddress(x)).length !== seller.length) {
+    console.log(`${name}: Invalid address: ${terms.seller}`)
+    return false
+  }
+  return true
+}

package/src/Escrow/validators/index.ts

@@ -0,0 +1,3 @@
+export * from './common'
+export * from './escrow'
+export * from './types'

package/src/Escrow/validators/types/escrowValidation.ts

@@ -0,0 +1,30 @@
+import { EscrowTerms } from '../../Terms'
+
+/**
+ * Type corresponding to the escrow terms properties
+ */
+export type EscrowTermsProperty = keyof EscrowTerms
+
+/**
+ * Type corresponding to the escrow terms property value
+ */
+export type EscrowTermsValue<K extends EscrowTermsProperty> = EscrowTerms[K]
+
+/**
+ * An expressions that selects a property value from the escrow terms
+ */
+export type EscrowTermsValueExpression<
+  /**
+   * The property of the escrow terms to select
+   */
+  K extends EscrowTermsProperty,
+  /**
+   * The type of the selected property's value
+   */
+  V = EscrowTermsValue<K>,
+> = (escrowTerms: EscrowTerms) => V
+
+/**
+ * A function that validates the supplied escrow terms
+ */
+export type EscrowTermsValidationFunction = (escrowTerms: EscrowTerms) => boolean | Promise<boolean>

package/src/Escrow/validators/types/index.ts

@@ -0,0 +1 @@
+export * from './escrowValidation'