@notabene/javascript-sdk 2.10.0-next.4 → 2.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (136) hide show
  1. package/dist/cjs/notabene.cjs +1 -1
  2. package/dist/cjs/notabene.d.ts +2 -4
  3. package/dist/cjs/package.json +1 -1
  4. package/dist/esm/notabene.d.ts +2 -4
  5. package/dist/esm/notabene.js +12 -12
  6. package/dist/esm/package.json +1 -1
  7. package/dist/notabene.d.ts +2 -4
  8. package/dist/notabene.js +12 -12
  9. package/docs/README.md +47 -218
  10. package/docs/_media/TransactionOptions.md +9 -9
  11. package/docs/ivms/types/enumerations/PayloadVersionCode.md +2 -2
  12. package/docs/ivms/types/interfaces/PayloadMetadata.md +2 -2
  13. package/docs/ivms/types/type-aliases/Address.md +1 -1
  14. package/docs/ivms/types/type-aliases/AddressTypeCode.md +1 -1
  15. package/docs/ivms/types/type-aliases/Beneficiary.md +1 -1
  16. package/docs/ivms/types/type-aliases/BeneficiaryVASP.md +1 -1
  17. package/docs/ivms/types/type-aliases/DateAndPlaceOfBirth.md +1 -1
  18. package/docs/ivms/types/type-aliases/ISOCountryCode.md +1 -1
  19. package/docs/ivms/types/type-aliases/ISODate.md +1 -1
  20. package/docs/ivms/types/type-aliases/IVMS101.md +1 -1
  21. package/docs/ivms/types/type-aliases/IntermediaryVASP.md +1 -1
  22. package/docs/ivms/types/type-aliases/LegalPerson.md +1 -1
  23. package/docs/ivms/types/type-aliases/LegalPersonName.md +1 -1
  24. package/docs/ivms/types/type-aliases/LegalPersonNameID.md +1 -1
  25. package/docs/ivms/types/type-aliases/LegalPersonNameTypeCode.md +1 -1
  26. package/docs/ivms/types/type-aliases/LocalLegalPersonNameID.md +1 -1
  27. package/docs/ivms/types/type-aliases/LocalNaturalPersonNameID.md +1 -1
  28. package/docs/ivms/types/type-aliases/NationalIdentification.md +1 -1
  29. package/docs/ivms/types/type-aliases/NationalIdentifierTypeCode.md +1 -1
  30. package/docs/ivms/types/type-aliases/NaturalPerson.md +1 -1
  31. package/docs/ivms/types/type-aliases/NaturalPersonName.md +1 -1
  32. package/docs/ivms/types/type-aliases/NaturalPersonNameID.md +1 -1
  33. package/docs/ivms/types/type-aliases/NaturalPersonNameTypeCode.md +1 -1
  34. package/docs/ivms/types/type-aliases/OriginatingVASP.md +1 -1
  35. package/docs/ivms/types/type-aliases/Originator.md +1 -1
  36. package/docs/ivms/types/type-aliases/Person.md +1 -1
  37. package/docs/ivms/types/type-aliases/TransferPath.md +1 -1
  38. package/docs/ivms/types/type-aliases/TransliterationMethodCode.md +1 -1
  39. package/docs/notabene/README.md +1 -7
  40. package/docs/notabene/classes/ConnectionManager.md +5 -19
  41. package/docs/notabene/classes/EmbeddedComponent.md +17 -17
  42. package/docs/notabene/classes/default.md +7 -7
  43. package/docs/notabene/functions/decodeFragmentToObject.md +1 -1
  44. package/docs/notabene/functions/getRefreshResult.md +3 -11
  45. package/docs/notabene/interfaces/ConnectionData.md +8 -8
  46. package/docs/notabene/interfaces/ConnectionMetadata.md +6 -6
  47. package/docs/notabene/interfaces/ConnectionResponse.md +12 -12
  48. package/docs/notabene/interfaces/ConnectionResult.md +61 -0
  49. package/docs/notabene/interfaces/NotabeneConfig.md +5 -5
  50. package/docs/notabene/type-aliases/ConnectionStatus.md +1 -1
  51. package/docs/notabene/type-aliases/MessageCallback.md +1 -1
  52. package/docs/notabene/type-aliases/TransactionType.md +1 -1
  53. package/docs/types/README.md +0 -1
  54. package/docs/types/enumerations/AgentType.md +2 -2
  55. package/docs/types/enumerations/CMType.md +7 -7
  56. package/docs/types/enumerations/ErrorIdentifierCode.md +4 -4
  57. package/docs/types/enumerations/HMType.md +2 -2
  58. package/docs/types/enumerations/PersonType.md +3 -3
  59. package/docs/types/enumerations/ProofStatus.md +4 -4
  60. package/docs/types/enumerations/ProofTypes.md +17 -27
  61. package/docs/types/enumerations/Status.md +5 -5
  62. package/docs/types/enumerations/VASPSearchControl.md +2 -2
  63. package/docs/types/enumerations/ValidationSections.md +4 -4
  64. package/docs/types/interfaces/Agent.md +6 -6
  65. package/docs/types/interfaces/CallbackOptions.md +2 -2
  66. package/docs/types/interfaces/ComponentRequest.md +2 -2
  67. package/docs/types/interfaces/ComponentResponse.md +4 -4
  68. package/docs/types/interfaces/ConnectionRecord.md +7 -7
  69. package/docs/types/interfaces/ConnectionRequest.md +3 -3
  70. package/docs/types/interfaces/Counterparty.md +10 -10
  71. package/docs/types/interfaces/DeclarationProof.md +6 -6
  72. package/docs/types/interfaces/Deposit.md +11 -25
  73. package/docs/types/interfaces/DepositRequest.md +9 -9
  74. package/docs/types/interfaces/DepositRequestOptions.md +1 -1
  75. package/docs/types/interfaces/DepositTransaction.md +9 -23
  76. package/docs/types/interfaces/LegalPerson.md +13 -13
  77. package/docs/types/interfaces/MicroTransferProof.md +9 -9
  78. package/docs/types/interfaces/NaturalPerson.md +13 -13
  79. package/docs/types/interfaces/OwnershipProof.md +4 -4
  80. package/docs/types/interfaces/RefreshSource.md +2 -2
  81. package/docs/types/interfaces/Refreshable.md +1 -1
  82. package/docs/types/interfaces/ScreenshotProof.md +5 -5
  83. package/docs/types/interfaces/SignatureProof.md +10 -10
  84. package/docs/types/interfaces/ThresholdOptions.md +3 -3
  85. package/docs/types/interfaces/Transaction.md +8 -18
  86. package/docs/types/interfaces/TransactionOptions.md +9 -9
  87. package/docs/types/interfaces/TransactionResponse.md +9 -9
  88. package/docs/types/interfaces/VASP.md +9 -9
  89. package/docs/types/interfaces/Wallet.md +8 -8
  90. package/docs/types/interfaces/Withdrawal.md +10 -24
  91. package/docs/types/type-aliases/BlockchainAddress.md +1 -1
  92. package/docs/types/type-aliases/CAIP10.md +1 -1
  93. package/docs/types/type-aliases/CAIP19.md +1 -1
  94. package/docs/types/type-aliases/CAIP2.md +1 -1
  95. package/docs/types/type-aliases/CAIP220.md +1 -1
  96. package/docs/types/type-aliases/Cancel.md +1 -1
  97. package/docs/types/type-aliases/Completed.md +1 -1
  98. package/docs/types/type-aliases/ComponentMessage.md +1 -1
  99. package/docs/types/type-aliases/ConnectionOptions.md +1 -1
  100. package/docs/types/type-aliases/CounterpartyAssistConfig.md +2 -2
  101. package/docs/types/type-aliases/CryptoCredential.md +1 -1
  102. package/docs/types/type-aliases/DID.md +1 -1
  103. package/docs/types/type-aliases/DTI.md +1 -1
  104. package/docs/types/type-aliases/Destination.md +1 -1
  105. package/docs/types/type-aliases/Error.md +1 -1
  106. package/docs/types/type-aliases/FieldOptions.md +1 -1
  107. package/docs/types/type-aliases/FieldTypes.md +1 -1
  108. package/docs/types/type-aliases/HostMessage.md +1 -1
  109. package/docs/types/type-aliases/ISOCurrency.md +1 -1
  110. package/docs/types/type-aliases/InvalidValue.md +1 -1
  111. package/docs/types/type-aliases/LEI.md +1 -1
  112. package/docs/types/type-aliases/LegalPersonFieldName.md +1 -1
  113. package/docs/types/type-aliases/LegalPersonFields.md +1 -1
  114. package/docs/types/type-aliases/NationalIdentifierTypeFieldOptions.md +1 -1
  115. package/docs/types/type-aliases/NaturalPersonFieldName.md +1 -1
  116. package/docs/types/type-aliases/NaturalPersonFields.md +1 -1
  117. package/docs/types/type-aliases/NotabeneAsset.md +1 -1
  118. package/docs/types/type-aliases/Ready.md +1 -1
  119. package/docs/types/type-aliases/ResizeRequest.md +1 -1
  120. package/docs/types/type-aliases/Source.md +1 -1
  121. package/docs/types/type-aliases/Theme.md +1 -1
  122. package/docs/types/type-aliases/TransactionAsset.md +1 -1
  123. package/docs/types/type-aliases/TravelAddress.md +1 -1
  124. package/docs/types/type-aliases/URI.md +1 -1
  125. package/docs/types/type-aliases/UUID.md +1 -1
  126. package/docs/types/type-aliases/UpdateValue.md +1 -1
  127. package/docs/types/type-aliases/V1Asset.md +1 -1
  128. package/docs/types/type-aliases/V1Transaction.md +1 -1
  129. package/docs/types/type-aliases/VASPOptions.md +1 -1
  130. package/docs/types/type-aliases/ValidationError.md +1 -1
  131. package/package.json +1 -1
  132. package/src/types.ts +0 -2
  133. package/src/utils/connections.ts +0 -1
  134. package/docs/_media/getRefreshResult.md +0 -35
  135. package/docs/notabene/type-aliases/ConnectionResult.md +0 -17
  136. package/docs/types/interfaces/Account.md +0 -59
package/docs/README.md CHANGED
@@ -47,11 +47,6 @@ This library is the JavaScript SDK for loading the Notabene UX components in the
47
47
  - [Parameters](#parameters-2)
48
48
  - [Deposit Assist](#deposit-assist)
49
49
  - [Parameters](#parameters-3)
50
- - [Counterparty Assist](#counterparty-assist)
51
- - [Use Cases](#use-cases)
52
- - [Counterparty Assist Configuration](#counterparty-assist-configuration)
53
- - [Component Response](#component-response)
54
- - [Retrieving Completed Data](#retrieving-completed-data)
55
50
  - [Error handling](#error-handling)
56
51
  - [Error reference](#error-reference)
57
52
  - [Transaction parameters](#transaction-parameters)
@@ -72,7 +67,6 @@ This library is the JavaScript SDK for loading the Notabene UX components in the
72
67
  - [Counterparty Field Properties](#counterparty-field-properties)
73
68
  - [Full Example](#full-example)
74
69
  - [Field reference](#field-reference)
75
- - [Configure Counterparty Assist](#counterparty-assist-configuration)
76
70
  - [Locales](#locales)
77
71
  - [Theming](#theming)
78
72
  - [License](#license)
@@ -307,10 +301,6 @@ const withdrawal = notabene.createWithdrawalAssist({
307
301
  currency: 'USD', // ISO currency code
308
302
  price: 1700.12, // Asset price
309
303
  },
310
- customer: {
311
- name: 'John Smith',
312
- email: "john.smith@domain.com",
313
- },
314
304
  });
315
305
  ```
316
306
 
@@ -320,7 +310,6 @@ const withdrawal = notabene.createWithdrawalAssist({
320
310
  - `destination`: The destination or blockchain address for the withdrawal. See [Destination](#destination)
321
311
  - `amountDecimal`: The amount to transfer in decimal format. See [Transaction Amount](#transaction-amount)
322
312
  - `assetPrice`: Optional price information in a fiat currency. See [Asset Price](#asset-price)
323
- - `customer`: Optional Customer object containing their name and email
324
313
 
325
314
  If any of the required parameters are missing the component will just show the Notabene badge.
326
315
 
@@ -338,10 +327,6 @@ const withdrawal = notabene.createWithdrawalAssist(
338
327
  currency: 'USD', // ISO currency code
339
328
  price: 1700.12, // Asset price
340
329
  },
341
- customer: {
342
- name: 'John Smith',
343
- email: "john.smith@domain.com",
344
- },
345
330
  },
346
331
  {
347
332
  proofs: {
@@ -361,10 +346,6 @@ See [Transaction Options](#transaction-options)
361
346
 
362
347
  The Connect Wallet component helps you collect and verify the address of your users self-hosted wallet in one go.
363
348
 
364
- ### Parameters
365
-
366
- - `asset`: The cryptocurrency or token being transferred. See [Asset Specification](#asset-specification)
367
-
368
349
  ```js
369
350
  const connect = notabene.createConnectWallet({
370
351
  asset: 'ETH',
@@ -373,12 +354,37 @@ const connect = notabene.createConnectWallet({
373
354
  const { proof, txCreate } = await connect.openModal();
374
355
  ```
375
356
 
357
+ ### Parameters
358
+
359
+ - `asset`: The cryptocurrency or token being transferred. See [Asset Specification](#asset-specification)
360
+
361
+ ### Configuration Options
362
+
363
+ Include configuration Options as a second optional parameter:
364
+
365
+ ```js
366
+ const connect = notabene.createConnectWallet(
367
+ {
368
+ asset: 'ETH',
369
+ },
370
+ {
371
+ proofs: {
372
+ microTransfer: {
373
+ destination: '0x...',
374
+ amountSubunits: '12344',
375
+ timeout: 86440,
376
+ },
377
+ },
378
+ },
379
+ );
380
+ ```
381
+
376
382
  ## Deposit Request
377
383
 
378
384
  The Deposit Request lets your customers request deposits that are fully Travel Rule compliant.
379
385
 
380
386
  ```js
381
- const depositRequest = notabene.createDepositRequest({
387
+ const withdrawal = notabene.createDepositRequest({
382
388
  asset: 'ETH',
383
389
  destination: '0x...',
384
390
  amountDecimal: 1.23,
@@ -392,7 +398,7 @@ const depositRequest = notabene.createDepositRequest({
392
398
 
393
399
  - `asset`: The cryptocurrency or token being transferred. See [Asset Specification](#asset-specification)
394
400
  - `destination`: The destination or blockchain address for the withdrawal. See [Destination](#destination)
395
- - `amountDecimal`: Optional amount to deposit in decimal format. See [Transaction Amount](#transaction-amount)
401
+ - `amountDecimal`: The amount to deposit in decimal format. See [Transaction Amount](#transaction-amount)
396
402
  - `customer`: Optional Customer object containing their name
397
403
 
398
404
  If any of the required parameters are missing the component will just show the Notabene badge.
@@ -419,7 +425,7 @@ const deposit = notabene.createDepositAssist(
419
425
  ### Parameters
420
426
 
421
427
  - `asset`: The cryptocurrency or token being transferred. See [Asset Specification](#asset-specification)
422
- - `source`: The source or blockchain address for the deposit. See [Origin](#origin)
428
+ - `source`: The source or blockchain address for the deposit. See [Source](#source)
423
429
  - `destination`: The destination or blockchain address for the deposit. See [Destination](#destination)
424
430
  - `amountDecimal`: Optional amount to deposit in decimal format. See [Transaction Amount](#transaction-amount)
425
431
  - `transactionId`: Optional transactionId of a Notabene transaction. Will be returned with the payload to assist updating the Transaction
@@ -428,186 +434,6 @@ If any of the required parameters are missing the component will just show the N
428
434
 
429
435
  ---
430
436
 
431
- ## Counterparty Handoff
432
-
433
- **Counterparty Assist** is a feature built into the existing **Withdrawal** and **Deposit Assist** components. When enabled, it allows users to hand off data collection to a counterparty — or to another device — by sharing a secure link. This helps ensure more accurate and complete information, especially when the counterparty is best suited to provide the required data.
434
-
435
- This feature does not function as a standalone component. Instead, it augments the Withdrawal and Deposit flows when configured.
436
-
437
- ### Use Cases
438
-
439
- #### Third Parties (`natural`, `legal`)
440
-
441
- During the counterparty data collection step, users can generate and share a link to allow third-party counterparties (individuals or organizations) to enter their own data. This ensures data accuracy and supports robust address verification by allowing the rightful owner to provide the necessary information.
442
-
443
- #### First Parties (`self`)
444
-
445
- During the address verification step, users can share a link to complete self-hosted wallet proof submissions on another device. This is especially useful if the original device used to initiate the process doesn't support signing or wallet access.
446
-
447
- ### Counterparty Assist Configuration
448
-
449
- You can enable **Counterparty Assist** by specifying the counterparty types you want the feature to apply to using the counterpartyAssist configuration field.
450
-
451
- - `false`: Disable the feature explicitly
452
- - `undefined` (not configured): Feature is disabled by default
453
- - `{ counterpartyTypes: [PersonType.SELF, PersonType.NATURAL, PersonType.LEGAL] }`: Enable for specific counterparty types
454
-
455
- **Example Config**
456
-
457
- ```js
458
- import Notabene, {
459
- PersonType,
460
- } from '@notabene/javascript-sdk';
461
-
462
- // Counterparty assist is enabled for specific counterparty types
463
- const options: TransactionOptions = {
464
- ...
465
- counterpartyAssist: {
466
- counterpartyTypes: [
467
- PersonType.LEGAL, // JS: 'legal'
468
- PersonType.NATURAL, // JS: 'natural'
469
- PersonType.SELF, // JS: 'self'
470
- ],
471
- }
472
- };
473
- ```
474
-
475
- ### Component Response
476
-
477
- The component emits a response once a participant has completed their portion of the process. Depending on the party type — **Third Party** (`natural`, `legal`) or **First Party** (`self`) — the behavior and expectations differ slightly.
478
-
479
- #### Third Parties (`natural`, `legal`)
480
-
481
- When a third party completes their step after following the shared link, the host application will receive a **`COMPLETE`** message from the component. However, because not all required data may be available at this point, the `response` object will include the information gathered so far, along with a `refreshSource` field. This allows the host to fetch the latest encrypted data once it's available.
482
-
483
- ##### Refresh Source Fields
484
-
485
- | Field | Type | Description |
486
- |-------|--------|--------------------------------------------------------------------------------------------------|
487
- | `url` | URI | The endpoint where the host can retrieve the encrypted data. |
488
- | `key` | string | The encryption key used to decrypt the PII (Personally Identifiable Information). Not stored by Notabene. |
489
-
490
- **Example Response**
491
-
492
- ```js
493
- {
494
- type: CMType.COMPLETE, // 'complete'
495
- response: { // transaciton data + refresh source
496
- destination: "0xFf9A04788972C3803959454ECAE1ed327826a216",
497
- asset: "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
498
- customer: {
499
- type: "natural",
500
- name: "sdfsd",
501
- email: "sdjlf@sdlfj.com"
502
- },
503
- amountDecimal: 100,
504
- counterparty: {
505
- type: "natural"
506
- },
507
- account: {
508
- caip10: "eip155:1:0xFf9A04788972C3803959454ECAE1ed327826a216",
509
- blockchainAddress: "0xFf9A04788972C3803959454ECAE1ed327826a216",
510
- chain: "eip155:1",
511
- did: "did:pkh:eip155:1:0xFf9A04788972C3803959454ECAE1ed327826a216",
512
- valid: true
513
- },
514
- refreshSource: {
515
- url: "https://safe-connections.notabene.id/17f76e4c-9a2a-4c34-afcb-b4868e609a96", // endpoint to retreive data
516
- key: "1Lcp5SFhaMHH7CAEILrS8IWA6BXS4tFZunPx08WU5Ok=" // key that can be used to decrypt data
517
- }
518
- }
519
- }
520
- ```
521
-
522
- #### First Parties (`self`)
523
-
524
- When the user is the originator (i.e., acting on their own behalf), they complete the verification process via a shared link and are then prompted to return to the original page to continue.
525
-
526
- Upon completion, the component emits a **`COMPLETE`** response. In this case, the component handles all necessary data updates internally, so **no additional action is required from the host** to retrieve updated data. The host can directly proceed to submit the transfer to the Notabene API.
527
-
528
- ### Retrieving Completed Data
529
- **(Third Parties Only: `natural`, `legal`)**
530
-
531
- When data submission is handed off to third parties, we cannot predict how long it will take them to complete the process. For this reason, we provide the host with all the information needed to retrieve the data and allow them to design how the user experiences this flow.
532
-
533
- To simplify retrieval and decryption, we provide an asynchronous [`getRefreshResult`](_media/getRefreshResult.md) function. It accepts a `refreshSource` and returns information about the associated transaction.
534
-
535
- **Example**
536
-
537
- ```js
538
- import { getRefreshResult } from "@notabene/javascript-sdk";
539
-
540
- const transaction = await getRefreshResult({
541
- url: "https://safe-connections.notabene.id/17f76e4c-9a2a-4c34-afcb-b4868e609a96",
542
- key: "1Lcp5SFhaMHH7CAEILrS8IWA6BXS4tFZunPx08WU5Ok="
543
- })
544
- ```
545
-
546
- #### Response from `getRefreshResult`
547
-
548
- | **Property** | **Type** | **Optional?** | **Description** |
549
- |--------------|---------------------------------------|---------------|---------------------------------------------------------------------------------|
550
- | `id` | `UUID` | No | Unique identifier for the transaction. |
551
- | `metadata` | `ConnectionMetadata` | No | Metadata associated with the transaction. |
552
- | `status` | `'active'` \| `'completed'` \| `'closed'` | No | Current status of the transaction’s data collection. |
553
- | `tx` | `T` | Yes | Ongoing transaction data (available when status is `active`). |
554
- | `result` | `TransactionResponse<T>` | Yes | Finalized transaction data (available when status is `completed`). |
555
-
556
- **Example Active Transaction Data**
557
-
558
- ```js
559
- {
560
- "id": "17f76e4c-9a2a-4c34-afcb-b4868e609a96",
561
- "metadata": {
562
- "participants": [
563
- "did:ethr:0x54b75d2a0925508682e65194cccb6f1e8eaafb2c"
564
- ],
565
- "nodeUrl": "https://api-qa.eu.notabene.id",
566
- "transactionType": "withdraw"
567
- },
568
- "status": "active",
569
- "tx": {
570
- //...
571
- }
572
- }
573
- ```
574
-
575
- **Example Completed Transaction Data**
576
-
577
- ```js
578
- {
579
- "id": "17f76e4c-9a2a-4c34-afcb-b4868e609a96",
580
- "metadata": {
581
- "participants": [
582
- "did:ethr:0x54b75d2a0925508682e65194cccb6f1e8eaafb2c" // DID of transaction participants
583
- ],
584
- "nodeUrl": "https://api-qa.eu.notabene.dev",
585
- "transactionType": "withdraw"
586
- },
587
- "status": "completed",
588
- "result": { // the response returned from the embedded component when all information is successfully collected
589
- "proof": {
590
- //...
591
- },
592
- "txCreate": {
593
- //...
594
- },
595
- "errors": [],
596
- "status": "pending",
597
- "valid": true,
598
- "value": {
599
- //...
600
- },
601
- "ivms101": {
602
- //...
603
- }
604
- }
605
- }
606
-
607
- ```
608
-
609
- Once the host has retrieved the completed data, they can finalize the transaction by submitting it to the Notabene API.
610
-
611
437
  ## Error handling
612
438
 
613
439
  If any error occurs, the `error` event is passed containing a message.
@@ -658,6 +484,7 @@ The `asset` field the following types of assets specified:
658
484
 
659
485
  - `notabene_asset` code passed as a`string`. See [Notabene Assets Service](https://devx.notabene.id/docs/coins-decimals#assets-service-api).
660
486
  - [CAIP-19](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md_) is a chain agnostic format allows you to support the widest amount of assets and blockchains including NFTs.
487
+ - [DTI](https://www.iso.org/standard/80601.html) is the ISO Digital Token Identifier format. See [DTI registry](https://dtif.org/registry-search/) for supported tokens.
661
488
 
662
489
  ### Transaction amount
663
490
 
@@ -674,9 +501,18 @@ Specify the beneficiary address as `destination` using one of the following form
674
501
  - [BIP-21](https://en.bitcoin.it/wiki/BIP_0021) Bitcoin URI
675
502
  - Native blockchain address
676
503
 
504
+ ### Origin
505
+
506
+ Specify the originator address as `origin` using one of the following formats:
507
+
508
+ - [CAIP-10](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-10.md_) is a chain agnostic format allows you to specify the specific blockchain and address
509
+ - [EIP-3770](https://eips.ethereum.org/EIPS/eip-3770) EVM URI
510
+ - [BIP-21](https://en.bitcoin.it/wiki/BIP_0021) Bitcoin URI
511
+ - Native blockchain address
512
+
677
513
  ### Source
678
514
 
679
- Specify the originator address as `source` using one of the following formats:
515
+ Specify the source address as `source` using one of the following formats:
680
516
 
681
517
  - [CAIP-10](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-10.md_) is a chain agnostic format allows you to specify the specific blockchain and address
682
518
  - [EIP-3770](https://eips.ethereum.org/EIPS/eip-3770) EVM URI
@@ -752,23 +588,16 @@ const options: TransactionOptions = {
752
588
  nationalIdentification: false,
753
589
  countryOfRegistration: true,
754
590
  },
591
+ vasps: {
592
+ addUnknown: true, // Allow users to add a missing VASP - Defaults to false
593
+ onlyActive: true, // Only list active VASPs - Default false
594
+ searchable: [
595
+ VASPSearchControl.ALLOWED, // JS: 'allowed'
596
+ VASPSearchControl.PENDING, // JS: 'pending'
597
+ ], // Control searches for VASPs - Defaults to undefined
598
+ },
755
599
  hide: [ValidationSections.ASSET, ValidationSections.DESTINATION], // Don't show specific sections of component
756
600
  },
757
- vasps: {
758
- addUnknown: true, // Allow users to add a missing VASP - Defaults to false
759
- onlyActive: true, // Only list active VASPs - Default false
760
- searchable: [
761
- VASPSearchControl.ALLOWED, // JS: 'allowed'
762
- VASPSearchControl.PENDING, // JS: 'pending'
763
- ], // Control searches for VASPs - Defaults to undefined
764
- },
765
- counterpartyAssist: { // Allows users to share a link to collect counterparty data
766
- counterpartyTypes: [
767
- PersonType.LEGAL, // JS: 'legal'
768
- PersonType.NATURAL, // JS: 'natural'
769
- PersonType.SELF, // JS: 'self'
770
- ],
771
- }
772
601
  };
773
602
  const withdrawal = notabene.createWithdrawalAssist(tx, options);
774
603
  ```
@@ -16,7 +16,7 @@ Configuration options for Transaction components
16
16
 
17
17
  #### Defined in
18
18
 
19
- [types.ts:853](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/types.ts#L853)
19
+ [types.ts:844](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/types.ts#L844)
20
20
 
21
21
  ***
22
22
 
@@ -26,17 +26,17 @@ Configuration options for Transaction components
26
26
 
27
27
  #### Defined in
28
28
 
29
- [types.ts:854](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/types.ts#L854)
29
+ [types.ts:845](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/types.ts#L845)
30
30
 
31
31
  ***
32
32
 
33
- ### counterpartyAssist?
33
+ ### counterpartyAssistConfig?
34
34
 
35
- > `optional` **counterpartyAssist**: [`CounterpartyAssistConfig`](../type-aliases/CounterpartyAssistConfig.md)
35
+ > `optional` **counterpartyAssistConfig**: [`CounterpartyAssistConfig`](../type-aliases/CounterpartyAssistConfig.md)
36
36
 
37
37
  #### Defined in
38
38
 
39
- [types.ts:858](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/types.ts#L858)
39
+ [types.ts:849](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/types.ts#L849)
40
40
 
41
41
  ***
42
42
 
@@ -46,7 +46,7 @@ Configuration options for Transaction components
46
46
 
47
47
  #### Defined in
48
48
 
49
- [types.ts:855](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/types.ts#L855)
49
+ [types.ts:846](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/types.ts#L846)
50
50
 
51
51
  ***
52
52
 
@@ -56,7 +56,7 @@ Configuration options for Transaction components
56
56
 
57
57
  #### Defined in
58
58
 
59
- [types.ts:857](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/types.ts#L857)
59
+ [types.ts:848](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/types.ts#L848)
60
60
 
61
61
  ***
62
62
 
@@ -94,7 +94,7 @@ Configuration options for Transaction components
94
94
 
95
95
  #### Defined in
96
96
 
97
- [types.ts:843](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/types.ts#L843)
97
+ [types.ts:834](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/types.ts#L834)
98
98
 
99
99
  ***
100
100
 
@@ -104,4 +104,4 @@ Configuration options for Transaction components
104
104
 
105
105
  #### Defined in
106
106
 
107
- [types.ts:856](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/types.ts#L856)
107
+ [types.ts:847](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/types.ts#L847)
@@ -18,7 +18,7 @@ Published May 2020
18
18
 
19
19
  #### Defined in
20
20
 
21
- [ivms/types.ts:365](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L365)
21
+ [ivms/types.ts:365](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L365)
22
22
 
23
23
  ***
24
24
 
@@ -30,4 +30,4 @@ Published August 2023
30
30
 
31
31
  #### Defined in
32
32
 
33
- [ivms/types.ts:367](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L367)
33
+ [ivms/types.ts:367](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L367)
@@ -19,7 +19,7 @@ The version of IVMS 101 to which the payload complies.
19
19
 
20
20
  #### Defined in
21
21
 
22
- [ivms/types.ts:358](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L358)
22
+ [ivms/types.ts:358](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L358)
23
23
 
24
24
  ***
25
25
 
@@ -31,4 +31,4 @@ The method used to map from a national system of writing to Latin script.
31
31
 
32
32
  #### Defined in
33
33
 
34
- [ivms/types.ts:356](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L356)
34
+ [ivms/types.ts:356](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L356)
@@ -111,4 +111,4 @@ Name of a built-up area, with defined boundaries, and a local government.
111
111
 
112
112
  ## Defined in
113
113
 
114
- [ivms/types.ts:119](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L119)
114
+ [ivms/types.ts:119](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L119)
@@ -13,4 +13,4 @@ Specifies the type of address
13
13
 
14
14
  ## Defined in
15
15
 
16
- [ivms/types.ts:44](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L44)
16
+ [ivms/types.ts:44](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L44)
@@ -27,4 +27,4 @@ Array of persons associated with the beneficiary
27
27
 
28
28
  ## Defined in
29
29
 
30
- [ivms/types.ts:313](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L313)
30
+ [ivms/types.ts:313](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L313)
@@ -21,4 +21,4 @@ The beneficiary VASP information
21
21
 
22
22
  ## Defined in
23
23
 
24
- [ivms/types.ts:335](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L335)
24
+ [ivms/types.ts:335](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L335)
@@ -27,4 +27,4 @@ Place of birth (max 70 characters)
27
27
 
28
28
  ## Defined in
29
29
 
30
- [ivms/types.ts:107](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L107)
30
+ [ivms/types.ts:107](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L107)
@@ -19,4 +19,4 @@ ISO-3166 Alpha-2 country code
19
19
 
20
20
  ## Defined in
21
21
 
22
- [ivms/types.ts:6](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L6)
22
+ [ivms/types.ts:6](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L6)
@@ -20,4 +20,4 @@ Format: YYYY-MM-DD
20
20
 
21
21
  ## Defined in
22
22
 
23
- [ivms/types.ts:14](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L14)
23
+ [ivms/types.ts:14](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L14)
@@ -38,4 +38,4 @@ IVMS101 definition
38
38
 
39
39
  ## Defined in
40
40
 
41
- [ivms/types.ts:375](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L375)
41
+ [ivms/types.ts:375](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L375)
@@ -27,4 +27,4 @@ The sequence number of this VASP in the transfer path
27
27
 
28
28
  ## Defined in
29
29
 
30
- [ivms/types.ts:289](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L289)
30
+ [ivms/types.ts:289](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L289)
@@ -45,4 +45,4 @@ A distinct identifier used by governments to uniquely identify a legal person
45
45
 
46
46
  ## Defined in
47
47
 
48
- [ivms/types.ts:259](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L259)
48
+ [ivms/types.ts:259](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L259)
@@ -33,4 +33,4 @@ Array of phonetic name identifiers
33
33
 
34
34
  ## Defined in
35
35
 
36
- [ivms/types.ts:245](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L245)
36
+ [ivms/types.ts:245](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L245)
@@ -27,4 +27,4 @@ The nature of the name specified
27
27
 
28
28
  ## Defined in
29
29
 
30
- [ivms/types.ts:233](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L233)
30
+ [ivms/types.ts:233](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L233)
@@ -13,4 +13,4 @@ Specifies the type of name for a legal person
13
13
 
14
14
  ## Defined in
15
15
 
16
- [ivms/types.ts:34](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L34)
16
+ [ivms/types.ts:34](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L34)
@@ -27,4 +27,4 @@ Type of legal person name identifier
27
27
 
28
28
  ## Defined in
29
29
 
30
- [ivms/types.ts:221](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L221)
30
+ [ivms/types.ts:221](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L221)
@@ -33,4 +33,4 @@ Secondary identifier, maximum 100 characters in local format
33
33
 
34
34
  ## Defined in
35
35
 
36
- [ivms/types.ts:159](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L159)
36
+ [ivms/types.ts:159](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L159)
@@ -39,4 +39,4 @@ Registration authority (format: RA followed by 6 digits)
39
39
 
40
40
  ## Defined in
41
41
 
42
- [ivms/types.ts:91](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L91)
42
+ [ivms/types.ts:91](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L91)
@@ -13,4 +13,4 @@ Specifies the type of national identifier
13
13
 
14
14
  ## Defined in
15
15
 
16
- [ivms/types.ts:54](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L54)
16
+ [ivms/types.ts:54](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L54)
@@ -51,4 +51,4 @@ A distinct identifier used by governments to uniquely identify a natural person
51
51
 
52
52
  ## Defined in
53
53
 
54
- [ivms/types.ts:201](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L201)
54
+ [ivms/types.ts:201](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L201)
@@ -33,4 +33,4 @@ Array of phonetic name identifiers
33
33
 
34
34
  ## Defined in
35
35
 
36
- [ivms/types.ts:187](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L187)
36
+ [ivms/types.ts:187](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L187)
@@ -33,4 +33,4 @@ Secondary identifier, maximum 100 characters
33
33
 
34
34
  ## Defined in
35
35
 
36
- [ivms/types.ts:173](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L173)
36
+ [ivms/types.ts:173](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L173)
@@ -13,4 +13,4 @@ Specifies the type of name for a natural person
13
13
 
14
14
  ## Defined in
15
15
 
16
- [ivms/types.ts:22](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L22)
16
+ [ivms/types.ts:22](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L22)
@@ -21,4 +21,4 @@ The originating VASP information
21
21
 
22
22
  ## Defined in
23
23
 
24
- [ivms/types.ts:325](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L325)
24
+ [ivms/types.ts:325](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L325)
@@ -27,4 +27,4 @@ Array of persons associated with the originator
27
27
 
28
28
  ## Defined in
29
29
 
30
- [ivms/types.ts:301](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L301)
30
+ [ivms/types.ts:301](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L301)
@@ -27,4 +27,4 @@ Natural person information
27
27
 
28
28
  ## Defined in
29
29
 
30
- [ivms/types.ts:277](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L277)
30
+ [ivms/types.ts:277](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L277)
@@ -21,4 +21,4 @@ Array of intermediary VASPs involved in the transfer
21
21
 
22
22
  ## Defined in
23
23
 
24
- [ivms/types.ts:345](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/b3b58dde23d9780aa680a2d943b97074d4e49921/src/ivms/types.ts#L345)
24
+ [ivms/types.ts:345](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/f6a0825d098b61a3bc31d6c197072643eb78a452/src/ivms/types.ts#L345)