@notabene/javascript-sdk 2.15.0 → 2.16.0-next.4

package/dist/esm/notabene.d.ts

@@ -1,6 +1,3 @@
-import type { Agent as Agent_2 } from '@taprsvp/types';
-import type { DID as DID_2 } from '@taprsvp/types';
-
 /**
  * A blockchain account
  * @public
@@ -13,6 +10,26 @@ export declare interface Account {
     identifier?: string;
 }
 
+/**
+ * Additional Document Reference
+ * Reference to an additional document related to the invoice
+ */
+declare interface AdditionalDocumentReference {
+    /**
+     * Document identifier
+     */
+    id: string;
+    /**
+     * Type of document
+     * Uses UBL Document Type Code standard
+     */
+    documentType?: DocumentTypeCode;
+    /**
+     * URL where the document can be accessed
+     */
+    url?: string;
+}
+
 /**
  * Address
  * Represents a physical address
@@ -53,6 +70,59 @@ declare type Address = {
     country: ISOCountryCode;
 };
 
+/**
+ * Represents an address
+ *
+ * Per IVMS101 spec section 5.2.6.1, an address contains location information
+ * that can be expressed either as:
+ * - Structured fields (streetName, buildingNumber, etc.)
+ * - Unstructured addressLine array (free-form text)
+ *
+ * Constraint C8 requires at least one of:
+ * - addressLine OR
+ * - (streetName AND (buildingName OR buildingNumber))
+ */
+declare interface Address_2 {
+    /** Identifies the nature of the address */
+    addressType: AddressTypeCode_2;
+    /** Identification of a division of a large organisation or building */
+    department?: string;
+    /** Identification of a sub-division of a large organisation or building */
+    subDepartment?: string;
+    /** Name of a street or thoroughfare */
+    streetName?: string;
+    /** Number that identifies the position of a building on a street */
+    buildingNumber?: string;
+    /** Name of the building or house */
+    buildingName?: string;
+    /** Floor or storey within a building */
+    floor?: string;
+    /** Numbered box in a post office, assigned to a person or organisation, where letters are kept until called for */
+    postBox?: string;
+    /** Building room number */
+    room?: string;
+    /** Identifier consisting of a group of letters and/or numbers */
+    postcode?: string;
+    /** Name of a built-up area, with defined boundaries, and a local government */
+    townName: string;
+    /** Specific location name within the town */
+    townLocationName?: string;
+    /** Identifies a subdivision within a country subdivision */
+    districtName?: string;
+    /** Identifies a subdivision of a country */
+    countrySubDivision?: string;
+    /** Nation with its own government */
+    country: CountryCode;
+    /**
+     * Information that locates and identifies a specific address, as defined by postal services,
+     * presented in free format text.
+     *
+     * Array of 0 to 7 lines, each max 70 characters (Max70Text)
+     * @maxItems 7
+     */
+    addressLine?: string[];
+}
+
 /**
  * Address Type Code
  * Specifies the type of address
@@ -60,6 +130,9 @@ declare type Address = {
  */
 declare type AddressTypeCode = 'HOME' | 'BIZZ' | 'GEOG';
 
+/** Codes identifying the nature of an address */
+declare type AddressTypeCode_2 = "HOME" | "BIZZ" | "GEOG";
+
 /**
  * Who is the agent acting on behalf of the counterparty
  * @public
@@ -73,6 +146,76 @@ export declare interface Agent {
     verified?: boolean;
 }
 
+/**
+ * Agent Interface
+ * Represents software acting on behalf of participants in TAP transactions.
+ * Agents handle communication, compliance, and transaction processing.
+ *
+ * @example
+ * ```typescript
+ * const originatorAgent: Agent = {
+ *   "@id": "did:web:vasp.example.com",
+ *   role: "SourceAddress",
+ *   for: "did:example:customer123",
+ *   name: "Example VASP Agent",
+ *   leiCode: "969500KN90DZLPGW6898",
+ *   url: "https://vasp.example.com",
+ *   email: "compliance@vasp.example.com",
+ *   geographicAddress: [{
+ *     addressType: "HOME",
+ *     streetName: "123 Main St",
+ *     buildingNumber: "123",
+ *     postCode: "12345",
+ *     townName: "Example City",
+ *     country: "US"
+ *   }],
+ *   policies: [{
+ *     "@type": "RequireAuthorization",
+ *     purpose: "AML compliance verification"
+ *   }],
+ *   serviceUrl: "https://vasp.example.com/didcomm"
+ * };
+ * ```
+ */
+declare interface Agent_2 extends Partial<Organization> {
+    /**
+     * Unique identifier for the participant
+     * Can be either a DID or an IRI
+     */
+    "@id": DID_2 | IRI;
+    /**
+     * Role of the participant in the transaction
+     * Standard values for Agents are: "SettlementAddress", "SourceAddress", "CustodialService"
+     * All role values MUST use PascalCase
+     * Optional for all participant types
+     */
+    role?: AgentRoles;
+    /**
+     * DID of the party this participant acts for
+     * Used when participant is an agent acting on behalf of another party
+     * Required for type "Agent", optional for other types
+     * Can be a single DID or an array of DIDs representing multiple parties
+     */
+    for: DID_2 | DID_2[];
+    /**
+     * List of policies that apply to this participant
+     * Defines requirements and constraints on the participant's actions
+     */
+    policies?: Policies[];
+    /**
+     * Optional DIDComm service endpoint URL
+     * This field SHOULD only be used as a fallback when no DIDComm service endpoint
+     * is resolvable from the agent's DID document. Particularly useful for self-hosted
+     * and decentralized agents. For security purposes, this field SHOULD be ignored
+     * if a valid DIDComm service endpoint is already listed in the DID document.
+     *
+     * @example "https://agent.example.com/didcomm"
+     */
+    serviceUrl?: IRI;
+}
+
+declare type AgentRoles = "SettlementAddress" | "SourceAddress" | "CustodialService" | "EscrowAgent" | string;
+
 /**
  * Explicit layout configuration for the agent selection step.
  *
@@ -103,8 +246,8 @@ export declare enum AgentType {
 }
 
 declare interface BaseRequestConfig {
-    originatorId?: DID_2;
-    beneficiaryId?: DID_2;
+    originatorId?: IRI;
+    beneficiaryId?: IRI;
 }
 
 /**
@@ -129,7 +272,6 @@ declare type BeneficiaryFields = {
 
 declare type BeneficiaryV2 = {
     beneficiaryPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -677,6 +819,8 @@ export declare type CounterpartyAssistConfig = boolean | {
     identityVerification?: IdentityVerificationConfig;
 };
 
+declare type CountryCode = "AF" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BQ" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "CV" | "KH" | "CM" | "CA" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CD" | "CG" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "MP" | "NO" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "PR" | "QA" | "RO" | "RU" | "RW" | "RE" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "VC" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "SS" | "ES" | "LK" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "UM" | "US" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "AX" | "XX";
+
 /**
  * A crypto credential
  * @public
@@ -759,6 +903,45 @@ export declare type Destination = BlockchainAddress | CAIP10 | CryptoCredential
  */
 export declare type DID = `did:${string}:${string}`;
 
+/**
+ * Decentralized Identifier (DID)
+ * A globally unique persistent identifier that doesn't require a centralized registration authority.
+ *
+ * Format: `did:method:method-specific-id`
+ *
+ * @example "did:web:example.com"
+ * @example "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"
+ * @see {@link https://www.w3.org/TR/did-core/ | DID Core Specification}
+ */
+declare type DID_2 = `did:${string}:${string}`;
+
+/**
+ * UBL Document Type Code standard
+ * Based on UBL 2.1 document types
+ *
+ * @see {@link http://docs.oasis-open.org/ubl/os-UBL-2.1/cl/gc/default/DocumentTypeCode-2.1.gc | UBL Document Type Codes}
+ */
+declare enum DocumentTypeCode {
+    Order = "Order",
+    OrderResponse = "OrderResponse",
+    OrderChange = "OrderChange",
+    OrderCancellation = "OrderCancellation",
+    Quotation = "Quotation",
+    DespatchAdvice = "DespatchAdvice",
+    ReceiptAdvice = "ReceiptAdvice",
+    Invoice = "Invoice",
+    CreditNote = "CreditNote",
+    DebitNote = "DebitNote",
+    SelfBilledInvoice = "SelfBilledInvoice",
+    RemittanceAdvice = "RemittanceAdvice",
+    Statement = "Statement",
+    CertificateOfOrigin = "CertificateOfOrigin",
+    Contract = "Contract",
+    Timesheet = "Timesheet",
+    Waybill = "Waybill",
+    Manifest = "Manifest"
+}
+
 /**
  * Digital Token Identifier (DTI) following ISO 24165 standard
  *
@@ -1006,6 +1189,122 @@ export declare type InvalidValue<T> = {
     errors: ValidationError[];
 };
 
+/**
+ * Invoice
+ * Represents a detailed invoice as defined in TAIP-16
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-16.md | TAIP-16: Invoices}
+ */
+export declare interface Invoice {
+    /**
+     * Unique identifier for the invoice
+     *
+     * @example "INV001"
+     * @validation Must be a unique identifier for the invoice
+     */
+    id: string;
+    /**
+     * Date when the invoice was issued
+     * ISO 8601 date format (YYYY-MM-DD)
+     *
+     * @example "2025-04-22"
+     * @validation Must be a valid date in ISO 8601 format
+     */
+    issueDate: string;
+    /**
+     * Currency code for the invoice amounts
+     * ISO 4217 currency code
+     * Should be consistent with the currency field in the Payment Request if present
+     *
+     * @example "USD"
+     * @example "EUR"
+     * @validation Must be a valid ISO 4217 currency code
+     */
+    currencyCode: IsoCurrency;
+    /**
+     * Individual items being invoiced
+     *
+     * @validation Must be an array of LineItem objects
+     */
+    lineItems: LineItem[];
+    /**
+     * Aggregate tax information
+     *
+     * @validation Must be a TaxTotal object if present
+     */
+    taxTotal?: TaxTotal;
+    /**
+     * Total amount of the invoice, including taxes
+     * Must match the amount in the Payment Request body
+     *
+     * @validation Must be a positive number
+     */
+    total: number;
+    /**
+     * Sum of line totals before taxes
+     *
+     * @validation Must be a positive number if present
+     */
+    subTotal?: number;
+    /**
+     * Date when payment is due
+     * ISO 8601 date format (YYYY-MM-DD)
+     *
+     * @example "2025-05-22"
+     * @validation Must be a valid date in ISO 8601 format if present
+     */
+    dueDate?: string;
+    /**
+     * Additional notes or terms for the invoice
+     *
+     * @validation Must be a string if present
+     */
+    note?: string;
+    /**
+     * Terms of payment
+     *
+     * @example "Net 30"
+     * @validation Must be a string if present
+     */
+    paymentTerms?: string;
+    /**
+     * Buyer's accounting code
+     * Used to route costs to specific accounts
+     *
+     * @validation Must be a string if present
+     */
+    accountingCost?: string;
+    /**
+     * Reference to a related order
+     *
+     * @validation Must be an OrderReference object if present
+     */
+    orderReference?: OrderReference;
+    /**
+     * References to additional documents
+     *
+     * @validation Must be an array of AdditionalDocumentReference objects if present
+     */
+    additionalDocumentReference?: AdditionalDocumentReference[];
+}
+
+/** Output fields populated by the component on completion */
+export declare interface InvoiceReaderResponse {
+    /** TAIP-16 compliant invoice data (populated by the component after PDF parsing) */
+    invoice?: Invoice;
+    merchant?: Party;
+    customer?: Party;
+}
+
+/**
+ * Internationalized Resource Identifier (IRI)
+ * A unique identifier that may contain international characters.
+ * Used for identifying resources, particularly in JSON-LD contexts.
+ *
+ * @see {@link https://www.w3.org/TR/json-ld11/#iris | JSON-LD 1.1 IRIs}
+ */
+declare type IRI = `${string}:${string}`;
+
 /**
  * ISO-3166 Alpha-2 country code
  * @example "US" for United States, "GB" for United Kingdom
@@ -1019,6 +1318,326 @@ declare type ISOCountryCode = string;
  */
 declare type ISOCurrency = string;
 
+/**
+ * ISO 4217 Currency Codes
+ * Three-letter codes representing currencies according to the ISO 4217 standard.
+ *
+ * @see {@link https://www.iso.org/iso-4217-currency-codes.html | ISO 4217}
+ */
+declare type IsoCurrency = 
+/** United Arab Emirates Dirham */
+"AED"
+/** Afghan Afghani */
+| "AFN"
+/** Albanian Lek */
+| "ALL"
+/** Armenian Dram */
+| "AMD"
+/** Netherlands Antillean Guilder */
+| "ANG"
+/** Angolan Kwanza */
+| "AOA"
+/** Argentine Peso */
+| "ARS"
+/** Australian Dollar */
+| "AUD"
+/** Aruban Florin */
+| "AWG"
+/** Azerbaijani Manat */
+| "AZN"
+/** Bosnia and Herzegovina Convertible Mark */
+| "BAM"
+/** Barbados Dollar */
+| "BBD"
+/** Bangladeshi Taka */
+| "BDT"
+/** Bulgarian Lev */
+| "BGN"
+/** Bahraini Dinar */
+| "BHD"
+/** Burundian Franc */
+| "BIF"
+/** Bermudian Dollar */
+| "BMD"
+/** Brunei Dollar */
+| "BND"
+/** Boliviano */
+| "BOB"
+/** Brazilian Real */
+| "BRL"
+/** Bahamian Dollar */
+| "BSD"
+/** Bhutanese Ngultrum */
+| "BTN"
+/** Botswana Pula */
+| "BWP"
+/** Belarusian Ruble */
+| "BYN"
+/** Belize Dollar */
+| "BZD"
+/** Canadian Dollar */
+| "CAD"
+/** Congolese Franc */
+| "CDF"
+/** Swiss Franc */
+| "CHF"
+/** Chilean Peso */
+| "CLP"
+/** Chinese Yuan */
+| "CNY"
+/** Colombian Peso */
+| "COP"
+/** Costa Rican Colon */
+| "CRC"
+/** Cuban Peso */
+| "CUP"
+/** Cape Verde Escudo */
+| "CVE"
+/** Czech Koruna */
+| "CZK"
+/** Djiboutian Franc */
+| "DJF"
+/** Danish Krone */
+| "DKK"
+/** Dominican Peso */
+| "DOP"
+/** Algerian Dinar */
+| "DZD"
+/** Egyptian Pound */
+| "EGP"
+/** Eritrean Nakfa */
+| "ERN"
+/** Ethiopian Birr */
+| "ETB"
+/** Euro */
+| "EUR"
+/** Fiji Dollar */
+| "FJD"
+/** Falkland Islands Pound */
+| "FKP"
+/** Pound Sterling */
+| "GBP"
+/** Georgian Lari */
+| "GEL"
+/** Ghanaian Cedi */
+| "GHS"
+/** Gibraltar Pound */
+| "GIP"
+/** Gambian Dalasi */
+| "GMD"
+/** Guinean Franc */
+| "GNF"
+/** Guatemalan Quetzal */
+| "GTQ"
+/** Guyanese Dollar */
+| "GYD"
+/** Hong Kong Dollar */
+| "HKD"
+/** Honduran Lempira */
+| "HNL"
+/** Croatian Kuna */
+| "HRK"
+/** Haitian Gourde */
+| "HTG"
+/** Hungarian Forint */
+| "HUF"
+/** Indonesian Rupiah */
+| "IDR"
+/** Israeli New Shekel */
+| "ILS"
+/** Indian Rupee */
+| "INR"
+/** Iraqi Dinar */
+| "IQD"
+/** Iranian Rial */
+| "IRR"
+/** Icelandic Króna */
+| "ISK"
+/** Jamaican Dollar */
+| "JMD"
+/** Jordanian Dinar */
+| "JOD"
+/** Japanese Yen */
+| "JPY"
+/** Kenyan Shilling */
+| "KES"
+/** Kyrgyzstani Som */
+| "KGS"
+/** Cambodian Riel */
+| "KHR"
+/** Comoro Franc */
+| "KMF"
+/** North Korean Won */
+| "KPW"
+/** South Korean Won */
+| "KRW"
+/** Kuwaiti Dinar */
+| "KWD"
+/** Cayman Islands Dollar */
+| "KYD"
+/** Kazakhstani Tenge */
+| "KZT"
+/** Lao Kip */
+| "LAK"
+/** Lebanese Pound */
+| "LBP"
+/** Sri Lankan Rupee */
+| "LKR"
+/** Liberian Dollar */
+| "LRD"
+/** Lesotho Loti */
+| "LSL"
+/** Libyan Dinar */
+| "LYD"
+/** Moroccan Dirham */
+| "MAD"
+/** Moldovan Leu */
+| "MDL"
+/** Malagasy Ariary */
+| "MGA"
+/** Macedonian Denar */
+| "MKD"
+/** Myanmar Kyat */
+| "MMK"
+/** Mongolian Tugrik */
+| "MNT"
+/** Macanese Pataca */
+| "MOP"
+/** Mauritanian Ouguiya */
+| "MRU"
+/** Mauritian Rupee */
+| "MUR"
+/** Maldivian Rufiyaa */
+| "MVR"
+/** Malawian Kwacha */
+| "MWK"
+/** Mexican Peso */
+| "MXN"
+/** Malaysian Ringgit */
+| "MYR"
+/** Mozambican Metical */
+| "MZN"
+/** Namibian Dollar */
+| "NAD"
+/** Nigerian Naira */
+| "NGN"
+/** Nicaraguan Córdoba */
+| "NIO"
+/** Norwegian Krone */
+| "NOK"
+/** Nepalese Rupee */
+| "NPR"
+/** New Zealand Dollar */
+| "NZD"
+/** Omani Rial */
+| "OMR"
+/** Panamanian Balboa */
+| "PAB"
+/** Peruvian Sol */
+| "PEN"
+/** Papua New Guinean Kina */
+| "PGK"
+/** Philippine Peso */
+| "PHP"
+/** Pakistani Rupee */
+| "PKR"
+/** Polish Złoty */
+| "PLN"
+/** Paraguayan Guaraní */
+| "PYG"
+/** Qatari Riyal */
+| "QAR"
+/** Romanian Leu */
+| "RON"
+/** Serbian Dinar */
+| "RSD"
+/** Russian Ruble */
+| "RUB"
+/** Rwandan Franc */
+| "RWF"
+/** Saudi Riyal */
+| "SAR"
+/** Solomon Islands Dollar */
+| "SBD"
+/** Seychelles Rupee */
+| "SCR"
+/** Sudanese Pound */
+| "SDG"
+/** Swedish Krona */
+| "SEK"
+/** Singapore Dollar */
+| "SGD"
+/** Saint Helena Pound */
+| "SHP"
+/** Sierra Leonean Leone */
+| "SLL"
+/** Somali Shilling */
+| "SOS"
+/** Surinamese Dollar */
+| "SRD"
+/** South Sudanese Pound */
+| "SSP"
+/** São Tomé and Príncipe Dobra */
+| "STN"
+/** Salvadoran Colón */
+| "SVC"
+/** Syrian Pound */
+| "SYP"
+/** Swazi Lilangeni */
+| "SZL"
+/** Thai Baht */
+| "THB"
+/** Tajikistani Somoni */
+| "TJS"
+/** Turkmenistan Manat */
+| "TMT"
+/** Tunisian Dinar */
+| "TND"
+/** Tongan Paʻanga */
+| "TOP"
+/** Turkish Lira */
+| "TRY"
+/** Trinidad and Tobago Dollar */
+| "TTD"
+/** New Taiwan Dollar */
+| "TWD"
+/** Tanzanian Shilling */
+| "TZS"
+/** Ukrainian Hryvnia */
+| "UAH"
+/** Ugandan Shilling */
+| "UGX"
+/** United States Dollar */
+| "USD"
+/** Uruguayan Peso */
+| "UYU"
+/** Uzbekistan Som */
+| "UZS"
+/** Venezuelan Bolívar Soberano */
+| "VES"
+/** Vietnamese Đồng */
+| "VND"
+/** Vanuatu Vatu */
+| "VUV"
+/** Samoan Tala */
+| "WST"
+/** CFA Franc BEAC */
+| "XAF"
+/** East Caribbean Dollar */
+| "XCD"
+/** CFA Franc BCEAO */
+| "XOF"
+/** CFP Franc */
+| "XPF"
+/** Yemeni Rial */
+| "YER"
+/** South African Rand */
+| "ZAR"
+/** Zambian Kwacha */
+| "ZMW"
+/** Zimbabwean Dollar */
+| "ZWL";
+
 /**
  * A point in time, represented as a day within the calendar year. Compliant with ISO 8601.
  * Format: YYYY-MM-DD
@@ -1041,6 +1660,19 @@ export declare type IVMS101 = {
     payloadMetadata?: PayloadMetadata;
 };
 
+/**
+ * Base interface for JSON-LD objects
+ * Provides the core structure for JSON-LD compatible objects with type information.
+ *
+ * @template T - The type string that identifies the object type
+ */
+declare interface JsonLdObject<T extends string> {
+    "@context"?: IRI | Record<string, string>;
+    "@type": T;
+}
+
+declare type LegalEntityNationalIdentifierTypeCode = Omit<NationalIdentifierTypeCode_2, "ARNU" | "CCPT" | "DRLC" | "SOCS" | "IDCD">;
+
 /**
  * Interface representing a legal entity (organization/company) involved in a transaction
  *
@@ -1132,6 +1764,14 @@ declare type LegalPersonNameID = {
     legalPersonNameIdentifierType: LegalPersonNameTypeCode;
 };
 
+/** Represents a legal person's name identifier */
+declare interface LegalPersonNameId {
+    /** Name by which the legal person is known */
+    legalPersonName: string;
+    /** The nature of the name specified */
+    legalPersonNameIdentifierType: LegalPersonNameTypeCode_2;
+}
+
 /**
  * Legal Person Name Type Code
  * Specifies the type of name for a legal person
@@ -1139,12 +1779,87 @@ declare type LegalPersonNameID = {
  */
 declare type LegalPersonNameTypeCode = 'LEGL' | 'SHRT' | 'TRAD';
 
+/** Codes representing the nature of a legal person's name */
+declare type LegalPersonNameTypeCode_2 = "LEGL" | "SHRT" | "TRAD";
+
 /**
  * A LEI Legal Entity Identifier
  * @public
  */
 export declare type LEI = string;
 
+/**
+ * Legal Entity Identifier (LEI)
+ * A 20-character alphanumeric code that uniquely identifies legal entities globally.
+ *
+ * @example "969500KN90DZLPGW6898"
+ * @see {@link https://www.iso.org/standard/59771.html | ISO 17442}
+ */
+declare type LEICode = string;
+
+/**
+ * Line Item
+ * Represents an individual item in an invoice
+ */
+declare interface LineItem {
+    /**
+     * Unique identifier for the line item within the invoice
+     */
+    id: string;
+    /**
+     * Description of the item or service
+     */
+    description: string;
+    /**
+     * Product name
+     * Based on schema.org/Product
+     * If not provided, description serves as the display name
+     *
+     * @example "Premium Widget Model A"
+     */
+    name?: string;
+    /**
+     * URL to an image of the product
+     * Based on schema.org/Product
+     *
+     * @example "https://example.com/products/widget-a.jpg"
+     */
+    image?: string;
+    /**
+     * URL to the product page
+     * Based on schema.org/Product
+     *
+     * @example "https://example.com/products/widget-a"
+     */
+    url?: string;
+    /**
+     * Quantity of the item
+     */
+    quantity: number;
+    /**
+     * Unit of measure code
+     * Uses UBL Unit of Measure Code standard
+     *
+     * @example UnitCode.Each
+     * @example UnitCode.Kilogram
+     * @example UnitCode.Hour
+     */
+    unitCode?: UnitCode;
+    /**
+     * Price per unit
+     */
+    unitPrice: number;
+    /**
+     * Total amount for this line item
+     * Typically quantity × unitPrice
+     */
+    lineTotal: number;
+    /**
+     * Tax category information specific to this line item
+     */
+    taxCategory?: TaxCategory;
+}
+
 /**
  * Local Legal Person Name ID
  * Represents a local name identifier for a legal person
@@ -1209,6 +1924,18 @@ export declare type NationalIdentification = {
     registrationAuthority?: string;
 };
 
+/** Represents a national identification */
+declare interface NationalIdentification_2<C> {
+    /** An identifier issued by an appropriate issuing authority */
+    nationalIdentifier: string;
+    /** Specifies the type of identifier */
+    nationalIdentifierType: C;
+    /** Country of the issuing authority */
+    countryOfIssue?: CountryCode;
+    /** A code specifying the registration authority */
+    registrationAuthority?: string;
+}
+
 /**
  * National Identifier Type Code
  * Specifies the type of national identifier
@@ -1216,6 +1943,22 @@ export declare type NationalIdentification = {
  */
 declare type NationalIdentifierTypeCode = 'ARNU' | 'CCPT' | 'RAID' | 'DRLC' | 'FIIN' | 'TXID' | 'SOCS' | 'IDCD' | 'LEIX' | 'MISC';
 
+/**
+ * Codes identifying the type of national identification
+ *
+ * - **ARNU**: Alien registration number - Number assigned by a government agency to identify foreign nationals
+ * - **CCPT**: Passport number - Number assigned by a passport authority
+ * - **RAID**: Registration authority identifier - Identifier of a legal entity as maintained by a registration authority
+ * - **DRLC**: Driver license number - Number assigned to a driver's license
+ * - **FIIN**: Foreign investment identity number - Number assigned to a foreign investor (other than the alien number)
+ * - **TXID**: Tax identification number - Number assigned by a tax authority to an entity
+ * - **SOCS**: Social security number - Number assigned by a social security agency
+ * - **IDCD**: Identity card number - Number assigned by a national authority to an identity card
+ * - **LEIX**: Legal Entity Identifier - Legal Entity Identifier (LEI) assigned in accordance with ISO 17442
+ * - **MISC**: Miscellaneous - Other types of national identification not covered by the above codes
+ */
+declare type NationalIdentifierTypeCode_2 = "ARNU" | "CCPT" | "RAID" | "DRLC" | "FIIN" | "TXID" | "SOCS" | "IDCD" | "LEIX" | "MISC";
+
 /**
  * Field properties for national identifier type selection
  * @public
@@ -1323,6 +2066,16 @@ declare type NaturalPersonNameID = {
     nameIdentifierType?: NaturalPersonNameTypeCode;
 };
 
+/** Represents a natural person's name identifier */
+declare interface NaturalPersonNameId {
+    /** This may be the family name, maiden name, or married name */
+    primaryIdentifier: string;
+    /** These may be forenames, given names, initials, or other secondary names */
+    secondaryIdentifier?: string;
+    /** The nature of the name specified */
+    naturalPersonNameIdentifierType: NaturalPersonNameTypeCode_2;
+}
+
 declare type NaturalPersonNameIDV2 = {
     primaryIdentifier?: string;
     secondaryIdentifier?: string;
@@ -1337,12 +2090,23 @@ declare type NaturalPersonNameIDV2 = {
  */
 declare type NaturalPersonNameTypeCode = 'ALIA' | 'BIRT' | 'MAID' | 'LEGL' | 'MISC';
 
+/**
+ * IVMS101 Core Types
+ * Shared type definitions used by both IVMS101.2020 and IVMS101.2023 versions
+ */
+
+/** Codes representing the nature of a natural person's name */
+declare type NaturalPersonNameTypeCode_2 = "ALIA" | "BIRT" | "MAID" | "LEGL" | "MISC";
+
 declare type NaturalPersonNameV2 = Omit<NaturalPersonName, 'nameIdentifier'> & {
     nameIdentifier?: NaturalPersonNameIDV2[];
 };
 
+declare type NaturalPersonNationalIdentifierTypeCode = Omit<NationalIdentifierTypeCode_2, "LEIX" | "RAID">;
+
 declare type NaturalPersonV2 = Omit<NaturalPerson_2, 'name'> & {
     name: NaturalPersonNameV2;
+    customerIdentification?: string;
 };
 
 /**
@@ -1417,6 +2181,17 @@ declare class Notabene {
      * @public
      */
     createDepositRequest(value: DepositRequest, options?: DepositRequestOptions, callbacks?: CallbackOptions): EmbeddedComponent<DepositRequest, DepositRequestOptions>;
+    /**
+     * Creates an invoice reader component for extracting TAIP-16 invoice data from PDF invoices
+     *
+     * The component provides a PDF drag-and-drop upload UI. On upload, the PDF is
+     * parsed and the extracted invoice data is returned. On completion,
+     * the response contains the TAIP-16 invoice data.
+     *
+     * @returns A new EmbeddedComponent instance for invoice reader creation
+     * @public
+     */
+    createInvoiceReader(): EmbeddedComponent<InvoiceReaderResponse, Record<string, never>>;
     /**
      * Creates a deposit assist component
      *
@@ -1478,6 +2253,171 @@ export declare interface NotabeneConfig {
     locale?: string;
 }
 
+/**
+ * Order Reference
+ * Reference to a related order
+ */
+declare interface OrderReference {
+    /**
+     * Order identifier
+     */
+    id: string;
+    /**
+     * Date when the order was issued
+     * ISO 8601 date format (YYYY-MM-DD)
+     */
+    issueDate?: string;
+}
+
+/**
+ * Organization Interface
+ * Represents a legal entity (company, institution, merchant) in TAP transactions.
+ * Supports both schema.org/Organization properties and IVMS101 identity data for compliance.
+ *
+ * Organizations typically have less privacy concerns than natural persons, making direct
+ * inclusion of IVMS101 data more common for transparency and compliance purposes.
+ *
+ * @example
+ * ```typescript
+ * // Basic organization with schema.org properties
+ * const basicOrg: Organization = {
+ *   "@id": "did:web:example.com",
+ *   "@type": "https://schema.org/Organization",
+ *   name: "Example Corp",
+ *   url: "https://example.com",
+ *   email: "contact@example.com"
+ * };
+ *
+ * // VASP with full compliance data
+ * const vasp: Organization = {
+ *   "@id": "did:web:vasp.example.com",
+ *   "@type": "https://schema.org/Organization",
+ *   name: "Example Virtual Asset Service Provider",
+ *   leiCode: "969500KN90DZLPGW6898",
+ *   url: "https://vasp.example.com",
+ *   logo: "https://vasp.example.com/logo.png",
+ *   description: "Licensed Virtual Asset Service Provider",
+ *   email: "compliance@vasp.example.com",
+ *   telephone: "+1-555-123-4567",
+ *   geographicAddress: [{
+ *     addressType: "BIZZ",
+ *     streetName: "456 Financial District",
+ *     buildingNumber: "456",
+ *     postCode: "10005",
+ *     townName: "New York",
+ *     country: "US"
+ *   }],
+ *   nationalIdentifier: {
+ *     nationalIdentifier: "12-3456789",
+ *     nationalIdentifierType: "TXID", // Tax ID
+ *     countryOfIssue: "US"
+ *   },
+ *   countryOfRegistration: "US"
+ * };
+ *
+ * // Merchant with MCC
+ * const merchant: Organization = {
+ *   "@id": "did:web:coffee.example.com",
+ *   "@type": "https://schema.org/Organization",
+ *   name: "Downtown Coffee Shop",
+ *   mcc: "5812", // Restaurant
+ *   url: "https://coffee.example.com",
+ *   geographicAddress: [{
+ *     addressType: "BIZZ",
+ *     streetName: "123 Main Street",
+ *     buildingNumber: "123",
+ *     postCode: "12345",
+ *     townName: "Anytown",
+ *     country: "US"
+ *   }]
+ * };
+ * ```
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-6.md | TAIP-6: Party Identification}
+ * @see {@link https://schema.org/Organization | schema.org/Organization}
+ */
+declare interface Organization extends Participant {
+    "@type": "https://schema.org/Organization";
+    /**
+     * Legal Entity Identifier (LEI) code
+     * 20-character alphanumeric code that uniquely identifies legal entities globally
+     * Used to uniquely identify legal entities involved in financial transactions
+     * @example "969500KN90DZLPGW6898"
+     * @see {@link https://www.iso.org/standard/59771.html | ISO 17442}
+     */
+    leiCode?: LEICode;
+    /**
+     * Legal name of the organization
+     * Can be a simple string or structured IVMS101 name identifiers
+     * For regulated entities, IVMS101 format may be required for compliance
+     * @example "Example Corporation Inc." // Simple string
+     * @example [{ legalPersonName: "Example Corp", legalPersonNameIdentifierType: "LEGL" }] // IVMS101
+     */
+    name?: string | LegalPersonNameId[];
+    /**
+     * Customer identification string
+     * Internal identifier used by the institution for this organization
+     * @example "CORP-789012"
+     */
+    customerIdentification?: string;
+    /**
+     * National identification documents
+     * Government-issued identifiers like tax ID, business registration number
+     * @example { nationalIdentifier: "12-3456789", nationalIdentifierType: "TXID", countryOfIssue: "US" }
+     */
+    nationalIdentifier?: NationalIdentification_2<LegalEntityNationalIdentifierTypeCode>;
+    /**
+     * Merchant Category Code (ISO 18245)
+     * Standard classification code for merchant types in payment transactions
+     * Used primarily for merchants in payment requests
+     *
+     * @example "5411" // Grocery stores and supermarkets
+     * @example "5812" // Restaurants
+     * @example "5734" // Computer software stores
+     * @example "6012" // Financial institutions
+     * @see {@link https://www.iso.org/standard/33365.html | ISO 18245}
+     */
+    mcc?: string;
+    /**
+     * URL pointing to the organization's website
+     * Based on schema.org/Organization
+     * @example "https://example.vasp.com"
+     * @example "https://merchant.example.com"
+     */
+    url?: string;
+    /**
+     * URL pointing to the organization's logo image
+     * Based on schema.org/Organization
+     * @example "https://example.vasp.com/logo.png"
+     * @example "https://cdn.example.com/assets/logo.svg"
+     */
+    logo?: string;
+    /**
+     * Description of the organization
+     * Based on schema.org/Organization
+     * @example "Licensed Virtual Asset Service Provider"
+     * @example "Online marketplace for digital assets and collectibles"
+     * @example "Full-service financial institution"
+     */
+    description?: string;
+    /**
+     * Physical addresses of the organization
+     * IVMS101 format addresses for regulatory compliance
+     * Supports multiple address types (BIZZ for business, etc.)
+     * @example [{ addressType: "BIZZ", streetName: "456 Business Ave", townName: "Finance City", country: "US" }]
+     */
+    geographicAddress?: Address_2[];
+    /**
+     * Country of registration/incorporation
+     * ISO 3166-1 alpha-2 country code where the organization is legally registered
+     * @example "US" // United States
+     * @example "GB" // United Kingdom
+     * @example "SG" // Singapore
+     * @example "CH" // Switzerland
+     */
+    countryOfRegistration?: CountryCode;
+}
+
 /**
  * Originating VASP
  * Represents the VASP which initiates the VA transfer
@@ -1510,7 +2450,6 @@ declare type OriginatorFields = {
 
 declare type OriginatorV2 = {
     originatorPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -1541,6 +2480,40 @@ export declare interface OwnershipProof {
     address: CAIP10;
 }
 
+/**
+ * Participant in a TAP transaction
+ * Represents either a party (originator/beneficiary) or an agent in the transaction.
+ * Can include verification methods and policies.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-5.md | TAIP-5: Agents}
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-6.md | TAIP-6: Party Identification}
+ */
+declare interface Participant {
+    /**
+     * Unique identifier for the participant
+     * Can be either a DID or an IRI
+     */
+    "@id": DID_2 | IRI;
+    "@context"?: string | string[];
+    "@type"?: string | string[];
+    /**
+     * Contact email address
+     * Based on schema.org/Organization and schema.org/Person
+     * @example "compliance@example.vasp.com"
+     */
+    email?: string;
+    /**
+     * Contact telephone number
+     * Based on schema.org/Organization and schema.org/Person
+     * @example "+1-555-123-4567"
+     */
+    telephone?: string;
+}
+
+declare type Party = Person_2 | Organization;
+
+declare type PartyType = "originator" | "beneficiary" | "customer" | "merchant" | "principal";
+
 /**
  * 6.7
  * Data describing the contents of the payload.
@@ -1574,6 +2547,115 @@ declare type Person = {
     legalPerson?: LegalPerson_2;
 };
 
+/**
+ * Person Interface
+ * Represents a natural person (individual) in TAP transactions.
+ * Supports both schema.org/Person properties and IVMS101 identity data for compliance.
+ *
+ * **Privacy Considerations**: For natural person information, consider using selective disclosure
+ * (TAIP-8) to protect sensitive data, especially when including IVMS101 fields like national
+ * identifiers and detailed addresses.
+ *
+ * @example
+ * ```typescript
+ * // Basic person with schema.org properties
+ * const basicPerson: Person = {
+ *   "@id": "did:example:alice",
+ *   "@type": "https://schema.org/Person",
+ *   name: "Alice Johnson",
+ *   email: "alice@example.com"
+ * };
+ *
+ * // Person with IVMS101 compliance data
+ * const compliancePerson: Person = {
+ *   "@id": "did:example:bob",
+ *   "@type": "https://schema.org/Person",
+ *   name: [{
+ *     primaryIdentifier: "Robert",
+ *     secondaryIdentifier: "Smith",
+ *     nameIdentifierType: "LEGL"
+ *   }],
+ *   geographicAddress: [{
+ *     addressType: "HOME",
+ *     streetName: "123 Main Street",
+ *     buildingNumber: "123",
+ *     postCode: "12345",
+ *     townName: "Example City",
+ *     country: "US"
+ *   }],
+ *   nationalIdentifier: {
+ *     nationalIdentifier: "123-45-6789",
+ *     nationalIdentifierType: "ARNU", // Social Security Number
+ *     countryOfIssue: "US"
+ *   },
+ *   dateAndPlaceOfBirth: {
+ *     dateOfBirth: "1990-01-15",
+ *     placeOfBirth: "New York, NY, US"
+ *   },
+ *   countryOfResidence: "US"
+ * };
+ * ```
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-6.md | TAIP-6: Party Identification}
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-8.md | TAIP-8: Selective Disclosure}
+ */
+declare interface Person_2 extends Participant {
+    "@type": "https://schema.org/Person";
+    /**
+     * SHA-256 hash of the normalized participant name
+     * Used for privacy-preserving name matching per TAIP-12
+     * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-12.md | TAIP-12: Privacy-Preserving Name Matching}
+     */
+    nameHash?: string;
+    /**
+     * Customer identification string
+     * Internal identifier used by the institution for this person
+     * @example "CUST-123456"
+     */
+    customerIdentification?: string;
+    /**
+     * Person's name
+     * Can be a simple string or structured IVMS101 name identifiers
+     * For compliance use cases, IVMS101 format provides more detailed name structure
+     * @example "Alice Johnson" // Simple string
+     * @example [{ primaryIdentifier: "Alice", secondaryIdentifier: "Johnson", nameIdentifierType: "LEGL" }] // IVMS101
+     */
+    name?: string | NaturalPersonNameId[];
+    /**
+     * Geographic addresses associated with the person
+     * IVMS101 format addresses for travel rule compliance
+     * Supports multiple address types (HOME, BIZZ, etc.)
+     * @example [{ addressType: "HOME", streetName: "123 Main St", townName: "City", country: "US" }]
+     */
+    geographicAddress?: Address_2[];
+    /**
+     * National identification documents
+     * Government-issued identifiers like passport, SSN, driver's license
+     * **Privacy**: Consider selective disclosure for sensitive ID information
+     * @example { nationalIdentifier: "123-45-6789", nationalIdentifierType: "ARNU", countryOfIssue: "US" }
+     */
+    nationalIdentifier?: NationalIdentification_2<NaturalPersonNationalIdentifierTypeCode>;
+    /**
+     * Date and place of birth information
+     * Used for identity verification and compliance
+     * **Privacy**: Highly sensitive data - recommend selective disclosure
+     */
+    dateAndPlaceOfBirth?: {
+        /** Date of birth in ISO 8601 format (YYYY-MM-DD) */
+        dateOfBirth: string;
+        /** Place of birth (city, state/province, country) */
+        placeOfBirth: string;
+    };
+    /**
+     * Country of residence
+     * ISO 3166-1 alpha-2 country code where the person resides
+     * @example "US"
+     * @example "CA"
+     * @example "GB"
+     */
+    countryOfResidence?: CountryCode;
+}
+
 /**
  * The type of counterparty. Either a natural person or a legal person. If the customer is the same as the counterparty then the counterparty is a self.
  * @public
@@ -1606,6 +2688,46 @@ declare type PersonV2 = Omit<Person, 'naturalPerson'> & {
     accountNumber?: string[];
 };
 
+/**
+ * Policy type definition
+ * Union type of all possible policy types in TAP.
+ */
+declare type Policies = RequireAuthorization | RequirePresentation | RequireRelationshipConfirmation | RequirePurpose;
+
+/**
+ * Base interface for all TAP policy types.
+ * Policies define requirements and constraints that must be satisfied during a transaction.
+ * Each specific policy type extends this base interface with its own requirements.
+ *
+ * @template T - The specific policy type identifier (e.g. "RequireAuthorization", "RequirePresentation")
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ */
+declare interface Policy<T extends string> extends JsonLdObject<T> {
+    /** The type identifier for this policy */
+    "@type": T;
+    /**
+     * Optional DID of the party or agent required to fulfill this policy
+     * Can be a single DID or an array of DIDs
+     */
+    from?: DID_2 | IRI;
+    /**
+     * Optional role of the party required to fulfill this policy
+     * E.g. 'SettlementAddress', 'SourceAddress', or 'CustodialService'
+     */
+    fromRole?: AgentRoles;
+    /**
+     * Optional agent representing a party required to fulfill this policy
+     * E.g. 'originator' or 'beneficiary' in TAIP-3
+     */
+    fromAgent?: PartyType;
+    /**
+     * Optional human-readable description of the policy's purpose
+     * Used to explain why this requirement exists
+     */
+    purpose?: string;
+}
+
 /**
  * Status of the ownership proof verification process
  *
@@ -1693,6 +2815,74 @@ export declare interface RefreshSource {
 
 declare type RequestID = UUID;
 
+/**
+ * Policy requiring authorization before proceeding
+ * Used to ensure specific agents authorize a transaction.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ */
+declare interface RequireAuthorization extends Policy<"RequireAuthorization"> {
+}
+
+/**
+ * Policy requiring presentation of verifiable credentials
+ * Used to request specific verifiable credentials from participants.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-8.md | TAIP-8: Verifiable Credentials}
+ */
+declare interface RequirePresentation extends Policy<"RequirePresentation"> {
+    /**
+     * Optional DID of the party the presentation is about
+     * Used when requesting credentials about a specific party
+     */
+    aboutParty?: DID_2 | IRI;
+    /**
+     * Optional DID of the agent the presentation is about
+     * Used when requesting credentials about a specific agent
+     */
+    aboutAgent?: DID_2 | IRI;
+    /**
+     * Presentation Exchange definition
+     * Specifies the required credentials and constraints
+     */
+    presentationDefinition: string;
+    /**
+     * Optional credential type shorthand
+     * Simplified way to request a specific credential type
+     */
+    credentialType?: string;
+}
+
+/**
+ * Policy requiring purpose codes for transactions
+ * Used to enforce the inclusion of ISO 20022 purpose codes.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-13.md | TAIP-13: Purpose Codes}
+ */
+declare interface RequirePurpose extends Policy<"RequirePurpose"> {
+    /**
+     * Required purpose code fields
+     * Specifies which purpose code types must be included
+     */
+    required: Array<"purpose" | "categoryPurpose">;
+}
+
+/**
+ * Policy requiring relationship confirmation
+ * Used to verify control of addresses and relationships between parties.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-9.md | TAIP-9: Proof of Relationship}
+ */
+declare interface RequireRelationshipConfirmation extends Policy<"RequireRelationshipConfirmation"> {
+    /**
+     * Required nonce for signature
+     * Prevents replay attacks
+     */
+    nonce: string;
+}
+
 /**
  * Represents a resize request component message. This is handled by the library.
  * @internal
@@ -1844,6 +3034,131 @@ export declare enum Status {
     BANNED = "banned"
 }
 
+/**
+ * Tax Category
+ * Represents a tax category with its rate and scheme
+ */
+declare interface TaxCategory {
+    /**
+     * Tax category identifier
+     * Uses UBL Tax Category Code standard
+     *
+     * @example TaxCategoryCode.StandardRate
+     * @example TaxCategoryCode.ZeroRated
+     * @example TaxCategoryCode.ExemptFromTax
+     */
+    id: TaxCategoryCode;
+    /**
+     * Tax rate percentage
+     *
+     * @example 20.0 // 20% VAT
+     * @example 0.0  // Zero rate
+     */
+    percent: number;
+    /**
+     * Tax scheme identifier
+     * Uses UBL Tax Scheme Code standard
+     *
+     * @example TaxSchemeCode.ValueAddedTax
+     * @example TaxSchemeCode.GoodsAndServicesTax
+     * @example TaxSchemeCode.SalesTax
+     */
+    taxScheme: TaxSchemeCode | string;
+}
+
+/**
+ * UBL Tax Category Code standard (UN/ECE 5305 Tax Category Code)
+ * Based on UN/CEFACT and EU tax categories
+ *
+ * @see {@link http://docs.oasis-open.org/ubl/os-UBL-2.1/cl/gc/default/TaxCategory-2.1.gc | UBL Tax Category Codes}
+ * @see {@link https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/ | PEPPOL BIS 3.0 Tax Category Codes}
+ */
+declare enum TaxCategoryCode {
+    StandardRate = "S",
+    ZeroRated = "Z",
+    ExemptFromTax = "E",
+    VATReverseCharge = "AE",
+    FreeExportItem = "G",
+    OutsideScopeOfTax = "O",
+    VATExemptIntraCommunity = "K",
+    CanaryIslandsIndirectTax = "L",
+    CeutaMelillaTax = "M",
+    HigherRate = "H",
+    LowerRate = "AA",
+    TransferredVAT = "B",
+    MixedTaxRate = "A",
+    ExemptForResale = "AB",
+    VATReverseChargeAlt = "AC",
+    VATExemptIntraCommunityAlt = "AD",
+    ExemptFromTaxDeprecated = "C",
+    ExemptArticle309 = "D"
+}
+
+/**
+ * UBL Tax Scheme Code standard (UN/ECE 5305 Tax Type Code)
+ * Based on UN/CEFACT tax types
+ *
+ * @see {@link http://docs.oasis-open.org/ubl/os-UBL-2.1/cl/gc/default/TaxScheme-2.1.gc | UBL Tax Scheme Codes}
+ */
+declare enum TaxSchemeCode {
+    ProfitTax = "AAA",
+    CorporateIncomeTax = "AAB",
+    PersonalIncomeTax = "AAC",
+    SocialSecurityTax = "AAD",
+    PropertyTax = "AAE",
+    InheritanceTax = "AAF",
+    GiftTax = "AAG",
+    CapitalGainsTax = "AAH",
+    WealthTax = "AAI",
+    StampDuty = "AAJ",
+    ConsumptionTax = "CST",
+    CustomsDuty = "CUS",
+    EnvironmentalTax = "ENV",
+    ExciseTax = "EXC",
+    ExportTax = "EXP",
+    FreightTax = "FRT",
+    GoodsAndServicesTax = "GST",
+    ImportTax = "IMP",
+    OtherTax = "OTH",
+    SalesTax = "SAL",
+    TurnoverTax = "TOT",
+    ValueAddedTax = "VAT"
+}
+
+/**
+ * Tax Subtotal
+ * Breakdown of taxes by category
+ */
+declare interface TaxSubtotal {
+    /**
+     * Amount subject to this tax
+     */
+    taxableAmount: number;
+    /**
+     * Tax amount for this category
+     */
+    taxAmount: number;
+    /**
+     * Tax category information
+     */
+    taxCategory: TaxCategory;
+}
+
+/**
+ * Tax Total
+ * Aggregate tax information for the invoice
+ */
+declare interface TaxTotal {
+    /**
+     * Total tax amount for the invoice
+     */
+    taxAmount: number;
+    /**
+     * Breakdown of taxes by category
+     */
+    taxSubtotal?: TaxSubtotal[];
+}
+
 /**
  * The theme of the Notabene SDK
  * @public
@@ -1972,6 +3287,7 @@ export declare interface TransactionOptions {
         microTransfer?: {
             destination: BlockchainAddress;
             amountSubunits: string;
+            requireHash?: boolean;
         };
         fallbacks?: ProofTypes[];
         deminimis?: ThresholdOptions;
@@ -2052,6 +3368,43 @@ declare type TransliterationMethodCode = 'arab' | 'aran' | 'armn' | 'cyrl' | 'de
 
  */ export declare type TravelAddress = `ta${string}`;
 
+/**
+ * UBL Unit of Measure Code standard
+ * Based on UN/CEFACT code list
+ *
+ * @see {@link http://docs.oasis-open.org/ubl/os-UBL-2.1/cl/gc/default/UnitOfMeasureCode-2.1.gc | UBL Unit of Measure Codes}
+ */
+declare enum UnitCode {
+    Kilogram = "KGM",
+    Gram = "GRM",
+    Milligram = "MGM",
+    Tonne = "TNE",
+    Liter = "LTR",
+    Milliliter = "MLT",
+    CubicMillimeter = "MMQ",
+    CubicCentimeter = "CMQ",
+    CubicDecimeter = "DMQ",
+    CubicMeter = "MTQ",
+    Millimeter = "MMT",
+    Centimeter = "CMT",
+    Decimeter = "DMT",
+    Meter = "MTR",
+    Kilometer = "KMT",
+    SquareMeter = "MTK",
+    Each = "EA",
+    Piece = "PCE",
+    NumberOfPairs = "NPR",
+    Second = "SEC",
+    Minute = "MIN",
+    Hour = "HUR",
+    Day = "DAY",
+    Week = "WEE",
+    Month = "MON",
+    Year = "ANN",
+    KilowattHour = "KWH",
+    NumberOfArticles = "NAR"
+}
+
 /**
  * Message type for updating component state and configuration from host application
  *
@@ -2079,6 +3432,7 @@ export declare type UpdateValue<T, O> = {
 
 /**
  * A Uniform Resource Identifier
+ * @remarks This type will be narrowed to `` `${string}:${string}` `` in the next major release.
  * @public
  */
 declare type URI = string;