@dfns/sdk 0.8.7 → 0.8.8

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.
@@ -1096,7 +1096,7 @@ export type CreateUserBody = {
1096
1096
  /** Value that can be used to correlate the entity with an external system. */
1097
1097
  externalId?: string | undefined;
1098
1098
  /** If set to true, the user will have to authenticate via SSO */
1099
- isSSORequired?: boolean;
1099
+ isSSORequired?: boolean | undefined;
1100
1100
  };
1101
1101
  export type CreateUserResponse = {
1102
1102
  username: string;
@@ -2155,6 +2155,7 @@ export type RegisterEndUserResponse = {
2155
2155
  id: string;
2156
2156
  /** Key scheme. */
2157
2157
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
2158
+ /** Key curve. */
2158
2159
  curve: "ed25519" | "secp256k1" | "stark";
2159
2160
  /** Hex-encoded value of the public key. */
2160
2161
  publicKey: string;
@@ -105,10 +105,13 @@ export type GetFeeSponsorResponse = {
105
105
  };
106
106
  export type GetFeeSponsorRequest = GetFeeSponsorParams;
107
107
  export type ListFeeSponsorsQuery = {
108
- limit?: string | undefined;
108
+ /** Maximum number of items to return. */
109
+ limit?: number | undefined;
110
+ /** Opaque token used to retrieve the next page. Returned as `nextPageToken` from the previous request. */
109
111
  paginationToken?: string | undefined;
110
112
  };
111
113
  export type ListFeeSponsorsResponse = {
114
+ /** Current page items. */
112
115
  items: {
113
116
  /** Fee Sponsor id. */
114
117
  id: string;
@@ -124,6 +127,7 @@ export type ListFeeSponsorsResponse = {
124
127
  /** Defines whether EndUsers and their delegated wallets can use this Fee Sponsor. */
125
128
  allowEndUser?: boolean | undefined;
126
129
  }[];
130
+ /** token to use as `paginationToken` to request the next page. */
127
131
  nextPageToken?: string | undefined;
128
132
  };
129
133
  export type ListFeeSponsorsRequest = {
@@ -1,34 +1,54 @@
1
1
  export type CreateKeyBody = {
2
+ /** The cryptographic scheme for the key. */
2
3
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
4
+ /** The elliptic curve for the key. */
3
5
  curve: "ed25519" | "secp256k1" | "stark";
6
+ /** Nickname for the key. */
4
7
  name?: string | undefined;
8
+ /** Whether this key can be used as a master key for HD derivation. */
5
9
  masterKey?: boolean | undefined;
10
+ /** Options for hierarchical deterministic key derivation. */
6
11
  deriveFrom?: {
7
- /** Key id. */
12
+ /** The master key to derive from. */
8
13
  keyId: string;
9
14
  /** Use this to specify the derivation path of the signing key. One will be auto generated if left blank. */
10
15
  path?: string | undefined;
11
16
  } | undefined;
17
+ /** The key store to save the key to. */
12
18
  storeId?: string | undefined;
19
+ /** ID of the end user to delegate this key to. */
13
20
  delegateTo?: string | undefined;
21
+ /** Whether to delay delegation until explicitly triggered. */
14
22
  delayDelegation?: boolean | undefined;
15
23
  };
16
24
  export type CreateKeyResponse = {
25
+ /** Unique identifier for the key. */
17
26
  id: string;
27
+ /** The cryptographic scheme for the key. */
18
28
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
29
+ /** The elliptic curve for the key. */
19
30
  curve: "ed25519" | "secp256k1" | "stark";
31
+ /** Hex-encoded public key. */
20
32
  publicKey: string;
33
+ /** Whether this key can be used as a master key for HD derivation. */
21
34
  masterKey?: boolean | undefined;
35
+ /** Derivation info if this key was derived from a master key. */
22
36
  derivedFrom?: {
23
- /** Key id. */
37
+ /** The master key this key was derived from. */
24
38
  keyId: string;
39
+ /** The derivation path used. */
25
40
  path: string;
26
41
  } | undefined;
42
+ /** Nickname for the key. */
27
43
  name?: string | undefined;
44
+ /** Current status of the key. */
28
45
  status: "Active" | "Archived";
46
+ /** Whether the key is custodial (owned by organization) or non-custodial (delegated to end user). */
29
47
  custodial: boolean;
30
48
  dateCreated: string;
49
+ /** Whether this key was imported. */
31
50
  imported?: boolean | undefined;
51
+ /** Whether this key has been exported. */
32
52
  exported?: boolean | undefined;
33
53
  dateExported?: string | undefined;
34
54
  dateDeleted?: string | undefined;
@@ -53,21 +73,33 @@ export type DeleteKeyParams = {
53
73
  keyId: string;
54
74
  };
55
75
  export type DeleteKeyResponse = {
76
+ /** Unique identifier for the key. */
56
77
  id: string;
78
+ /** The cryptographic scheme for the key. */
57
79
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
80
+ /** The elliptic curve for the key. */
58
81
  curve: "ed25519" | "secp256k1" | "stark";
82
+ /** Hex-encoded public key. */
59
83
  publicKey: string;
84
+ /** Whether this key can be used as a master key for HD derivation. */
60
85
  masterKey?: boolean | undefined;
86
+ /** Derivation info if this key was derived from a master key. */
61
87
  derivedFrom?: {
62
- /** Key id. */
88
+ /** The master key this key was derived from. */
63
89
  keyId: string;
90
+ /** The derivation path used. */
64
91
  path: string;
65
92
  } | undefined;
93
+ /** Nickname for the key. */
66
94
  name?: string | undefined;
95
+ /** Current status of the key. */
67
96
  status: "Active" | "Archived";
97
+ /** Whether the key is custodial (owned by organization) or non-custodial (delegated to end user). */
68
98
  custodial: boolean;
69
99
  dateCreated: string;
100
+ /** Whether this key was imported. */
70
101
  imported?: boolean | undefined;
102
+ /** Whether this key has been exported. */
71
103
  exported?: boolean | undefined;
72
104
  dateExported?: string | undefined;
73
105
  dateDeleted?: string | undefined;
@@ -240,7 +272,7 @@ export type GenerateSignatureBody = {
240
272
  } | {
241
273
  kind: "SignerPayload";
242
274
  /** The unsigned Signer Payload formatted as JSON, or as a serialized hex-encoded buffer.
243
-
275
+
244
276
  Please refer to the original Polkadot definition for more details: [SignerPayloadJson](https://github.com/polkadot-js/api/blob/v16.2.2/packages/types/src/types/extrinsic.ts#L32). Note that additional fields will be rejected.
245
277
 
246
278
  | Field | Description | Type - Optional |
@@ -299,13 +331,18 @@ export type GenerateSignatureBody = {
299
331
  externalId?: string | undefined;
300
332
  };
301
333
  export type GenerateSignatureParams = {
334
+ /** The key to sign with. */
302
335
  keyId: string;
303
336
  };
304
337
  export type GenerateSignatureResponse = {
338
+ /** Signature id. */
305
339
  id: string;
340
+ /** Key id. */
306
341
  keyId: string;
307
342
  requester: {
343
+ /** User id. */
308
344
  userId: string;
345
+ /** Token id. */
309
346
  tokenId?: string | undefined;
310
347
  };
311
348
  requestBody: {
@@ -435,7 +472,7 @@ export type GenerateSignatureResponse = {
435
472
  } | {
436
473
  kind: "SignerPayload";
437
474
  /** The unsigned Signer Payload formatted as JSON, or as a serialized hex-encoded buffer.
438
-
475
+
439
476
  Please refer to the original Polkadot definition for more details: [SignerPayloadJson](https://github.com/polkadot-js/api/blob/v16.2.2/packages/types/src/types/extrinsic.ts#L32). Note that additional fields will be rejected.
440
477
 
441
478
  | Field | Description | Type - Optional |
@@ -522,48 +559,75 @@ export type GenerateSignatureRequest = GenerateSignatureParams & {
522
559
  body: GenerateSignatureBody;
523
560
  };
524
561
  export type GetKeyParams = {
562
+ /** The key to retrieve. */
525
563
  keyId: string;
526
564
  };
527
565
  export type GetKeyResponse = {
566
+ /** Unique identifier for the key. */
528
567
  id: string;
568
+ /** The cryptographic scheme for the key. */
529
569
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
570
+ /** The elliptic curve for the key. */
530
571
  curve: "ed25519" | "secp256k1" | "stark";
572
+ /** Hex-encoded public key. */
531
573
  publicKey: string;
574
+ /** Whether this key can be used as a master key for HD derivation. */
532
575
  masterKey?: boolean | undefined;
576
+ /** Derivation info if this key was derived from a master key. */
533
577
  derivedFrom?: {
534
- /** Key id. */
578
+ /** The master key this key was derived from. */
535
579
  keyId: string;
580
+ /** The derivation path used. */
536
581
  path: string;
537
582
  } | undefined;
583
+ /** Nickname for the key. */
538
584
  name?: string | undefined;
585
+ /** Current status of the key. */
539
586
  status: "Active" | "Archived";
587
+ /** Whether the key is custodial (owned by organization) or non-custodial (delegated to end user). */
540
588
  custodial: boolean;
541
589
  dateCreated: string;
590
+ /** Whether this key was imported. */
542
591
  imported?: boolean | undefined;
592
+ /** Whether this key has been exported. */
543
593
  exported?: boolean | undefined;
544
594
  dateExported?: string | undefined;
545
595
  dateDeleted?: string | undefined;
596
+ /** Wallets associated with this key. */
546
597
  wallets: {
598
+ /** The wallet id. */
547
599
  id: string;
600
+ /** The network of the wallet. */
548
601
  network: ("Algorand" | "AlgorandTestnet" | "Aptos" | "AptosTestnet" | "ArbitrumOne" | "ArbitrumGoerli" | "ArbitrumSepolia" | "ArcTestnet" | "AvalancheC" | "AvalancheCFuji" | "Adi" | "AdiTestnet" | "AdiTestnetAb" | "BabylonGenesis" | "BabylonTestnet5" | "Base" | "BaseGoerli" | "BaseSepolia" | "Berachain" | "BerachainBArtio" | "BerachainBepolia" | "Bitcoin" | "BitcoinSignet" | "BitcoinTestnet3" | "BitcoinCash" | "BitcoinCashTestnet" | "Bob" | "BobSepolia" | "Bsc" | "BscTestnet" | "Canton" | "CantonDevnet" | "CantonTestnet" | "Cardano" | "CardanoPreprod" | "Concordium" | "ConcordiumTestnet" | "Celo" | "CeloAlfajores" | "Codex" | "CodexSepolia" | "CosmosHub4" | "CosmosIcsTestnet" | "Dogecoin" | "DogecoinTestnet" | "Ethereum" | "EthereumClassic" | "EthereumClassicMordor" | "EthereumGoerli" | "EthereumSepolia" | "EthereumHolesky" | "EthereumHoodi" | "FantomOpera" | "FantomTestnet" | "FlareC" | "FlareCCoston2" | "FlowEvm" | "FlowEvmTestnet" | "Hedera" | "HederaTestnet" | "Ink" | "InkSepolia" | "InternetComputer" | "Ion" | "IonTestnet" | "Iota" | "IotaTestnet" | "IotaZodianet" | "Kaspa" | "KaspaTestnet11" | "Kusama" | "KusamaAssetHub" | "Litecoin" | "LitecoinTestnet" | "Near" | "NearTestnet" | "Optimism" | "OptimismGoerli" | "OptimismSepolia" | "Origyn" | "Plasma" | "PlasmaTestnet" | "Plume" | "PlumeSepolia" | "Paseo" | "PaseoAssetHub" | "Polkadot" | "PolkadotAssetHub" | "Polygon" | "PolygonAmoy" | "PolygonMumbai" | "Polymesh" | "PolymeshTestnet" | "Race" | "RaceSepolia" | "SeiAtlantic2" | "SeiPacific1" | "Solana" | "SolanaDevnet" | "Sonic" | "SonicTestnet" | "Starknet" | "StarknetSepolia" | "Stellar" | "StellarTestnet" | "Sui" | "SuiTestnet" | "Tezos" | "TezosGhostnet" | "TempoAndantino" | "Tsc" | "TscTestnet1" | "Ton" | "TonTestnet" | "Tron" | "TronNile" | "Westend" | "WestendAssetHub" | "XrpLedger" | "XrpLedgerTestnet") | ("KeyECDSA" | "KeyEdDSA" | "KeyECDSAStark");
549
602
  }[];
603
+ /** Key store details. */
550
604
  store: {
605
+ /** The key store id. */
551
606
  id: string;
607
+ /** The type of key store. */
552
608
  kind: "Hsm" | "Mpc";
609
+ /** The key id within the store. */
553
610
  keyId: string;
611
+ /** The HD derivation path if applicable. */
554
612
  derivationPath?: string | undefined;
555
613
  };
556
614
  };
557
615
  export type GetKeyRequest = GetKeyParams;
558
616
  export type GetSignatureParams = {
617
+ /** The key that was used for signing. */
559
618
  keyId: string;
619
+ /** The signature request to retrieve. */
560
620
  signatureId: string;
561
621
  };
562
622
  export type GetSignatureResponse = {
623
+ /** Signature id. */
563
624
  id: string;
625
+ /** Key id. */
564
626
  keyId: string;
565
627
  requester: {
628
+ /** User id. */
566
629
  userId: string;
630
+ /** Token id. */
567
631
  tokenId?: string | undefined;
568
632
  };
569
633
  requestBody: {
@@ -693,7 +757,7 @@ export type GetSignatureResponse = {
693
757
  } | {
694
758
  kind: "SignerPayload";
695
759
  /** The unsigned Signer Payload formatted as JSON, or as a serialized hex-encoded buffer.
696
-
760
+
697
761
  Please refer to the original Polkadot definition for more details: [SignerPayloadJson](https://github.com/polkadot-js/api/blob/v16.2.2/packages/types/src/types/extrinsic.ts#L32). Note that additional fields will be rejected.
698
762
 
699
763
  | Field | Description | Type - Optional |
@@ -790,21 +854,33 @@ export type ImportKeyBody = {
790
854
  masterKey?: boolean | undefined;
791
855
  };
792
856
  export type ImportKeyResponse = {
857
+ /** Unique identifier for the key. */
793
858
  id: string;
859
+ /** The cryptographic scheme for the key. */
794
860
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
861
+ /** The elliptic curve for the key. */
795
862
  curve: "ed25519" | "secp256k1" | "stark";
863
+ /** Hex-encoded public key. */
796
864
  publicKey: string;
865
+ /** Whether this key can be used as a master key for HD derivation. */
797
866
  masterKey?: boolean | undefined;
867
+ /** Derivation info if this key was derived from a master key. */
798
868
  derivedFrom?: {
799
- /** Key id. */
869
+ /** The master key this key was derived from. */
800
870
  keyId: string;
871
+ /** The derivation path used. */
801
872
  path: string;
802
873
  } | undefined;
874
+ /** Nickname for the key. */
803
875
  name?: string | undefined;
876
+ /** Current status of the key. */
804
877
  status: "Active" | "Archived";
878
+ /** Whether the key is custodial (owned by organization) or non-custodial (delegated to end user). */
805
879
  custodial: boolean;
806
880
  dateCreated: string;
881
+ /** Whether this key was imported. */
807
882
  imported?: boolean | undefined;
883
+ /** Whether this key has been exported. */
808
884
  exported?: boolean | undefined;
809
885
  dateExported?: string | undefined;
810
886
  dateDeleted?: string | undefined;
@@ -813,50 +889,74 @@ export type ImportKeyRequest = {
813
889
  body: ImportKeyBody;
814
890
  };
815
891
  export type ListKeysQuery = {
816
- limit?: string | undefined;
892
+ /** Maximum number of items to return. */
893
+ limit?: number | undefined;
894
+ /** Opaque token used to retrieve the next page. Returned as `nextPageToken` from the previous request. */
817
895
  paginationToken?: string | undefined;
896
+ /** Filter by owner id or username. */
818
897
  owner?: string | undefined;
819
898
  };
820
899
  export type ListKeysResponse = {
900
+ /** Current page items. */
821
901
  items: {
902
+ /** Unique identifier for the key. */
822
903
  id: string;
904
+ /** The cryptographic scheme for the key. */
823
905
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
906
+ /** The elliptic curve for the key. */
824
907
  curve: "ed25519" | "secp256k1" | "stark";
908
+ /** Hex-encoded public key. */
825
909
  publicKey: string;
910
+ /** Whether this key can be used as a master key for HD derivation. */
826
911
  masterKey?: boolean | undefined;
912
+ /** Derivation info if this key was derived from a master key. */
827
913
  derivedFrom?: {
828
- /** Key id. */
914
+ /** The master key this key was derived from. */
829
915
  keyId: string;
916
+ /** The derivation path used. */
830
917
  path: string;
831
918
  } | undefined;
919
+ /** Nickname for the key. */
832
920
  name?: string | undefined;
921
+ /** Current status of the key. */
833
922
  status: "Active" | "Archived";
923
+ /** Whether the key is custodial (owned by organization) or non-custodial (delegated to end user). */
834
924
  custodial: boolean;
835
925
  dateCreated: string;
926
+ /** Whether this key was imported. */
836
927
  imported?: boolean | undefined;
928
+ /** Whether this key has been exported. */
837
929
  exported?: boolean | undefined;
838
930
  dateExported?: string | undefined;
839
931
  dateDeleted?: string | undefined;
840
932
  }[];
933
+ /** token to use as `paginationToken` to request the next page. */
841
934
  nextPageToken?: string | undefined;
842
935
  };
843
936
  export type ListKeysRequest = {
844
937
  query?: ListKeysQuery;
845
938
  };
846
939
  export type ListSignaturesParams = {
940
+ /** The key to list signatures for. */
847
941
  keyId: string;
848
942
  };
849
943
  export type ListSignaturesQuery = {
850
- limit?: string | undefined;
944
+ /** Maximum number of items to return. */
945
+ limit?: number | undefined;
946
+ /** Opaque token used to retrieve the next page. Returned as `nextPageToken` from the previous request. */
851
947
  paginationToken?: string | undefined;
852
948
  };
853
949
  export type ListSignaturesResponse = {
854
- keyId: string;
950
+ /** Current page items. */
855
951
  items: {
952
+ /** Signature id. */
856
953
  id: string;
954
+ /** Key id. */
857
955
  keyId: string;
858
956
  requester: {
957
+ /** User id. */
859
958
  userId: string;
959
+ /** Token id. */
860
960
  tokenId?: string | undefined;
861
961
  };
862
962
  requestBody: {
@@ -986,7 +1086,7 @@ export type ListSignaturesResponse = {
986
1086
  } | {
987
1087
  kind: "SignerPayload";
988
1088
  /** The unsigned Signer Payload formatted as JSON, or as a serialized hex-encoded buffer.
989
-
1089
+
990
1090
  Please refer to the original Polkadot definition for more details: [SignerPayloadJson](https://github.com/polkadot-js/api/blob/v16.2.2/packages/types/src/types/extrinsic.ts#L32). Note that additional fields will be rejected.
991
1091
 
992
1092
  | Field | Description | Type - Optional |
@@ -1069,7 +1169,10 @@ export type ListSignaturesResponse = {
1069
1169
  dateConfirmed?: string | undefined;
1070
1170
  externalId?: string | undefined;
1071
1171
  }[];
1172
+ /** token to use as `paginationToken` to request the next page. */
1072
1173
  nextPageToken?: string | undefined;
1174
+ /** The key these signatures belong to. */
1175
+ keyId: string;
1073
1176
  };
1074
1177
  export type ListSignaturesRequest = ListSignaturesParams & {
1075
1178
  query?: ListSignaturesQuery;
@@ -1081,21 +1184,33 @@ export type UpdateKeyParams = {
1081
1184
  keyId: string;
1082
1185
  };
1083
1186
  export type UpdateKeyResponse = {
1187
+ /** Unique identifier for the key. */
1084
1188
  id: string;
1189
+ /** The cryptographic scheme for the key. */
1085
1190
  scheme: "DH" | "ECDSA" | "EdDSA" | "Schnorr";
1191
+ /** The elliptic curve for the key. */
1086
1192
  curve: "ed25519" | "secp256k1" | "stark";
1193
+ /** Hex-encoded public key. */
1087
1194
  publicKey: string;
1195
+ /** Whether this key can be used as a master key for HD derivation. */
1088
1196
  masterKey?: boolean | undefined;
1197
+ /** Derivation info if this key was derived from a master key. */
1089
1198
  derivedFrom?: {
1090
- /** Key id. */
1199
+ /** The master key this key was derived from. */
1091
1200
  keyId: string;
1201
+ /** The derivation path used. */
1092
1202
  path: string;
1093
1203
  } | undefined;
1204
+ /** Nickname for the key. */
1094
1205
  name?: string | undefined;
1206
+ /** Current status of the key. */
1095
1207
  status: "Active" | "Archived";
1208
+ /** Whether the key is custodial (owned by organization) or non-custodial (delegated to end user). */
1096
1209
  custodial: boolean;
1097
1210
  dateCreated: string;
1211
+ /** Whether this key was imported. */
1098
1212
  imported?: boolean | undefined;
1213
+ /** Whether this key has been exported. */
1099
1214
  exported?: boolean | undefined;
1100
1215
  dateExported?: string | undefined;
1101
1216
  dateDeleted?: string | undefined;
@@ -56,7 +56,7 @@ export type DeleteAssignmentParams = {
56
56
  assignmentId: string;
57
57
  };
58
58
  export type DeleteAssignmentQuery = {
59
- force?: boolean;
59
+ force?: boolean | undefined;
60
60
  };
61
61
  export type DeleteAssignmentResponse = void | undefined;
62
62
  export type DeleteAssignmentRequest = DeleteAssignmentParams & {