@dedot/chaintypes 0.239.0 → 0.241.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dedot/chaintypes",
3
- "version": "0.239.0",
3
+ "version": "0.241.0",
4
4
  "description": "Types for substrate-based chains",
5
5
  "author": "Thang X. Vu <thang@dedot.dev>",
6
6
  "homepage": "https://dedot.dev",
@@ -25,7 +25,7 @@
25
25
  "directory": "dist"
26
26
  },
27
27
  "license": "Apache-2.0",
28
- "gitHead": "7416ba7e713f1964fb04a876d9e0c210d3325f53",
28
+ "gitHead": "77e33dfd7ed0f001436caf93080b6f6a6c372c06",
29
29
  "module": "./index.js",
30
30
  "types": "./index.d.ts",
31
31
  "exports": {
@@ -918,6 +918,11 @@ export interface ChainConsts extends GenericChainConsts {
918
918
  **/
919
919
  defaultMaxRemoveLiquidityLimitPerBlock: [number, number] | undefined;
920
920
 
921
+ /**
922
+ * Time window for global withdraw accumulator in milliseconds (e.g., 86_400_000 for 24h).
923
+ **/
924
+ globalWithdrawWindow: bigint;
925
+
921
926
  /**
922
927
  * Generic pallet constant
923
928
  **/
@@ -1870,6 +1870,21 @@ export interface ChainErrors extends GenericChainErrors {
1870
1870
  **/
1871
1871
  DepositLimitExceededForWhitelistedAccount: GenericPalletError;
1872
1872
 
1873
+ /**
1874
+ * Global lockdown is active and withdrawals that participate in the global limit are blocked.
1875
+ **/
1876
+ WithdrawLockdownActive: GenericPalletError;
1877
+
1878
+ /**
1879
+ * Applying the increment would exceed the configured global limit -> lockdown is triggered and operation fails.
1880
+ **/
1881
+ GlobalWithdrawLimitExceeded: GenericPalletError;
1882
+
1883
+ /**
1884
+ * Asset to withdraw cannot be converted to reference currency.
1885
+ **/
1886
+ FailedToConvertAsset: GenericPalletError;
1887
+
1873
1888
  /**
1874
1889
  * Generic pallet error
1875
1890
  **/
@@ -35,6 +35,7 @@ import type {
35
35
  PalletClaimsEthereumAddress,
36
36
  PalletOmnipoolTradability,
37
37
  PalletLiquidityMiningLoyaltyCurve,
38
+ PalletCircuitBreakerGlobalAssetCategory,
38
39
  PalletDynamicFeesAssetFeeConfig,
39
40
  NonZeroU16,
40
41
  PalletStableswapPoolPegInfo,
@@ -2188,6 +2189,50 @@ export interface ChainEvents extends GenericChainEvents {
2188
2189
  **/
2189
2190
  DepositReleased: GenericPalletEvent<'CircuitBreaker', 'DepositReleased', { who: AccountId32; assetId: number }>;
2190
2191
 
2192
+ /**
2193
+ * Global lockdown triggered until given timestamp (ms).
2194
+ **/
2195
+ GlobalLockdownTriggered: GenericPalletEvent<'CircuitBreaker', 'GlobalLockdownTriggered', { until: bigint }>;
2196
+
2197
+ /**
2198
+ * Global lockdown was lifted (either automatically or by reset).
2199
+ **/
2200
+ GlobalLockdownLifted: GenericPalletEvent<'CircuitBreaker', 'GlobalLockdownLifted', null>;
2201
+
2202
+ /**
2203
+ * Global lockdown accumulator and state were reset by governance.
2204
+ **/
2205
+ GlobalLockdownReset: GenericPalletEvent<'CircuitBreaker', 'GlobalLockdownReset', null>;
2206
+
2207
+ /**
2208
+ * Global limit value updated by governance (in reference currency).
2209
+ **/
2210
+ GlobalLimitUpdated: GenericPalletEvent<'CircuitBreaker', 'GlobalLimitUpdated', { newLimit: bigint }>;
2211
+
2212
+ /**
2213
+ * Global withdraw lockdown was set by governance.
2214
+ **/
2215
+ GlobalLockdownSet: GenericPalletEvent<'CircuitBreaker', 'GlobalLockdownSet', { until: bigint }>;
2216
+
2217
+ /**
2218
+ * A number of egress accounts added to a list.
2219
+ **/
2220
+ EgressAccountsAdded: GenericPalletEvent<'CircuitBreaker', 'EgressAccountsAdded', { count: number }>;
2221
+
2222
+ /**
2223
+ * A number of egress accounts removed from a list.
2224
+ **/
2225
+ EgressAccountsRemoved: GenericPalletEvent<'CircuitBreaker', 'EgressAccountsRemoved', { count: number }>;
2226
+
2227
+ /**
2228
+ * Asset category override updated.
2229
+ **/
2230
+ AssetCategoryUpdated: GenericPalletEvent<
2231
+ 'CircuitBreaker',
2232
+ 'AssetCategoryUpdated',
2233
+ { assetId: number; category?: PalletCircuitBreakerGlobalAssetCategory | undefined }
2234
+ >;
2235
+
2191
2236
  /**
2192
2237
  * Generic pallet event
2193
2238
  **/
@@ -51,7 +51,7 @@ interface ChainKnownTypes extends GenericChainKnownTypes {
51
51
 
52
52
  /**
53
53
  * @name: PaseoHydrationApi
54
- * @specVersion: 394
54
+ * @specVersion: 396
55
55
  **/
56
56
  export interface PaseoHydrationApi extends GenericSubstrateApi {
57
57
  rpc: ChainJsonRpcApis;
@@ -71,6 +71,7 @@ import type {
71
71
  PalletCircuitBreakerTradeVolumeLimit,
72
72
  PalletCircuitBreakerLiquidityLimit,
73
73
  PalletCircuitBreakerLockdownStatus,
74
+ PalletCircuitBreakerGlobalAssetCategory,
74
75
  HydradxTraitsRouterTrade,
75
76
  HydradxTraitsRouterAssetPair,
76
77
  PalletDynamicFeesFeeEntry,
@@ -1550,6 +1551,53 @@ export interface ChainStorage extends GenericChainStorage {
1550
1551
  number
1551
1552
  >;
1552
1553
 
1554
+ /**
1555
+ * Configured global limit in reference currency
1556
+ *
1557
+ * @param {Callback<bigint | undefined> =} callback
1558
+ **/
1559
+ globalWithdrawLimit: GenericStorageQuery<() => bigint | undefined>;
1560
+
1561
+ /**
1562
+ * Tuple of (current_accumulator_in_ref, last_update_timestamp_ms)
1563
+ *
1564
+ * @param {Callback<[bigint, bigint]> =} callback
1565
+ **/
1566
+ withdrawLimitAccumulator: GenericStorageQuery<() => [bigint, bigint]>;
1567
+
1568
+ /**
1569
+ * If some, global lockdown is active until this timestamp.
1570
+ *
1571
+ * @param {Callback<bigint | undefined> =} callback
1572
+ **/
1573
+ withdrawLockdownUntil: GenericStorageQuery<() => bigint | undefined>;
1574
+
1575
+ /**
1576
+ * A map of accounts that are considered egress sinks.
1577
+ *
1578
+ * @param {AccountId32Like} arg
1579
+ * @param {Callback<[] | undefined> =} callback
1580
+ **/
1581
+ egressAccounts: GenericStorageQuery<(arg: AccountId32Like) => [] | undefined, AccountId32>;
1582
+
1583
+ /**
1584
+ * When set to true, egress accounting is skipped.
1585
+ *
1586
+ * @param {Callback<boolean> =} callback
1587
+ **/
1588
+ ignoreWithdrawLimit: GenericStorageQuery<() => boolean>;
1589
+
1590
+ /**
1591
+ * Overrides for global asset categorization.
1592
+ *
1593
+ * @param {number} arg
1594
+ * @param {Callback<PalletCircuitBreakerGlobalAssetCategory | undefined> =} callback
1595
+ **/
1596
+ globalAssetOverrides: GenericStorageQuery<
1597
+ (arg: number) => PalletCircuitBreakerGlobalAssetCategory | undefined,
1598
+ number
1599
+ >;
1600
+
1553
1601
  /**
1554
1602
  * Generic pallet storage query
1555
1603
  **/
@@ -50,6 +50,7 @@ import type {
50
50
  PalletOmnipoolTradability,
51
51
  PalletLiquidityMiningLoyaltyCurve,
52
52
  HydradxTraitsStableswapAssetAmount,
53
+ PalletCircuitBreakerGlobalAssetCategory,
53
54
  HydradxTraitsRouterTrade,
54
55
  HydradxTraitsRouterAssetPair,
55
56
  PalletDynamicFeesAssetFeeConfig,
@@ -7359,6 +7360,114 @@ export interface ChainTx<
7359
7360
  >
7360
7361
  >;
7361
7362
 
7363
+ /**
7364
+ * Set the global withdraw limit (reference currency units)
7365
+ * Can be called only by authority origin.
7366
+ *
7367
+ * @param {bigint} limit
7368
+ **/
7369
+ setGlobalWithdrawLimit: GenericTxCall<
7370
+ (limit: bigint) => ChainSubmittableExtrinsic<
7371
+ {
7372
+ pallet: 'CircuitBreaker';
7373
+ palletCall: {
7374
+ name: 'SetGlobalWithdrawLimit';
7375
+ params: { limit: bigint };
7376
+ };
7377
+ },
7378
+ ChainKnownTypes
7379
+ >
7380
+ >;
7381
+
7382
+ /**
7383
+ * Reset the global lockdown and accumulator to zero at current block.
7384
+ * Can be called only by authority origin.
7385
+ *
7386
+ **/
7387
+ resetWithdrawLockdown: GenericTxCall<
7388
+ () => ChainSubmittableExtrinsic<
7389
+ {
7390
+ pallet: 'CircuitBreaker';
7391
+ palletCall: {
7392
+ name: 'ResetWithdrawLockdown';
7393
+ };
7394
+ },
7395
+ ChainKnownTypes
7396
+ >
7397
+ >;
7398
+
7399
+ /**
7400
+ *
7401
+ * @param {Array<AccountId32Like>} accounts
7402
+ **/
7403
+ addEgressAccounts: GenericTxCall<
7404
+ (accounts: Array<AccountId32Like>) => ChainSubmittableExtrinsic<
7405
+ {
7406
+ pallet: 'CircuitBreaker';
7407
+ palletCall: {
7408
+ name: 'AddEgressAccounts';
7409
+ params: { accounts: Array<AccountId32Like> };
7410
+ };
7411
+ },
7412
+ ChainKnownTypes
7413
+ >
7414
+ >;
7415
+
7416
+ /**
7417
+ *
7418
+ * @param {Array<AccountId32Like>} accounts
7419
+ **/
7420
+ removeEgressAccounts: GenericTxCall<
7421
+ (accounts: Array<AccountId32Like>) => ChainSubmittableExtrinsic<
7422
+ {
7423
+ pallet: 'CircuitBreaker';
7424
+ palletCall: {
7425
+ name: 'RemoveEgressAccounts';
7426
+ params: { accounts: Array<AccountId32Like> };
7427
+ };
7428
+ },
7429
+ ChainKnownTypes
7430
+ >
7431
+ >;
7432
+
7433
+ /**
7434
+ *
7435
+ * @param {bigint} until
7436
+ **/
7437
+ setGlobalWithdrawLockdown: GenericTxCall<
7438
+ (until: bigint) => ChainSubmittableExtrinsic<
7439
+ {
7440
+ pallet: 'CircuitBreaker';
7441
+ palletCall: {
7442
+ name: 'SetGlobalWithdrawLockdown';
7443
+ params: { until: bigint };
7444
+ };
7445
+ },
7446
+ ChainKnownTypes
7447
+ >
7448
+ >;
7449
+
7450
+ /**
7451
+ *
7452
+ * @param {number} assetId
7453
+ * @param {PalletCircuitBreakerGlobalAssetCategory | undefined} category
7454
+ **/
7455
+ setAssetCategory: GenericTxCall<
7456
+ (
7457
+ assetId: number,
7458
+ category: PalletCircuitBreakerGlobalAssetCategory | undefined,
7459
+ ) => ChainSubmittableExtrinsic<
7460
+ {
7461
+ pallet: 'CircuitBreaker';
7462
+ palletCall: {
7463
+ name: 'SetAssetCategory';
7464
+ params: { assetId: number; category: PalletCircuitBreakerGlobalAssetCategory | undefined };
7465
+ };
7466
+ },
7467
+ ChainKnownTypes
7468
+ >
7469
+ >;
7470
+
7362
7471
  /**
7363
7472
  * Generic pallet tx call
7364
7473
  **/
@@ -8186,7 +8186,24 @@ export type PalletCircuitBreakerCall =
8186
8186
  *
8187
8187
  * Emits `DepositReleased` event when successful.
8188
8188
  **/
8189
- | { name: 'ReleaseDeposit'; params: { who: AccountId32; assetId: number } };
8189
+ | { name: 'ReleaseDeposit'; params: { who: AccountId32; assetId: number } }
8190
+ /**
8191
+ * Set the global withdraw limit (reference currency units)
8192
+ * Can be called only by authority origin.
8193
+ **/
8194
+ | { name: 'SetGlobalWithdrawLimit'; params: { limit: bigint } }
8195
+ /**
8196
+ * Reset the global lockdown and accumulator to zero at current block.
8197
+ * Can be called only by authority origin.
8198
+ **/
8199
+ | { name: 'ResetWithdrawLockdown' }
8200
+ | { name: 'AddEgressAccounts'; params: { accounts: Array<AccountId32> } }
8201
+ | { name: 'RemoveEgressAccounts'; params: { accounts: Array<AccountId32> } }
8202
+ | { name: 'SetGlobalWithdrawLockdown'; params: { until: bigint } }
8203
+ | {
8204
+ name: 'SetAssetCategory';
8205
+ params: { assetId: number; category?: PalletCircuitBreakerGlobalAssetCategory | undefined };
8206
+ };
8190
8207
 
8191
8208
  export type PalletCircuitBreakerCallLike =
8192
8209
  /**
@@ -8267,7 +8284,26 @@ export type PalletCircuitBreakerCallLike =
8267
8284
  *
8268
8285
  * Emits `DepositReleased` event when successful.
8269
8286
  **/
8270
- | { name: 'ReleaseDeposit'; params: { who: AccountId32Like; assetId: number } };
8287
+ | { name: 'ReleaseDeposit'; params: { who: AccountId32Like; assetId: number } }
8288
+ /**
8289
+ * Set the global withdraw limit (reference currency units)
8290
+ * Can be called only by authority origin.
8291
+ **/
8292
+ | { name: 'SetGlobalWithdrawLimit'; params: { limit: bigint } }
8293
+ /**
8294
+ * Reset the global lockdown and accumulator to zero at current block.
8295
+ * Can be called only by authority origin.
8296
+ **/
8297
+ | { name: 'ResetWithdrawLockdown' }
8298
+ | { name: 'AddEgressAccounts'; params: { accounts: Array<AccountId32Like> } }
8299
+ | { name: 'RemoveEgressAccounts'; params: { accounts: Array<AccountId32Like> } }
8300
+ | { name: 'SetGlobalWithdrawLockdown'; params: { until: bigint } }
8301
+ | {
8302
+ name: 'SetAssetCategory';
8303
+ params: { assetId: number; category?: PalletCircuitBreakerGlobalAssetCategory | undefined };
8304
+ };
8305
+
8306
+ export type PalletCircuitBreakerGlobalAssetCategory = 'External' | 'Local';
8271
8307
 
8272
8308
  /**
8273
8309
  * Contains a variant per dispatchable extrinsic that this pallet has.
@@ -15056,7 +15092,42 @@ export type PalletCircuitBreakerEvent =
15056
15092
  /**
15057
15093
  * All reserved amount of deposit was released
15058
15094
  **/
15059
- | { name: 'DepositReleased'; data: { who: AccountId32; assetId: number } };
15095
+ | { name: 'DepositReleased'; data: { who: AccountId32; assetId: number } }
15096
+ /**
15097
+ * Global lockdown triggered until given timestamp (ms).
15098
+ **/
15099
+ | { name: 'GlobalLockdownTriggered'; data: { until: bigint } }
15100
+ /**
15101
+ * Global lockdown was lifted (either automatically or by reset).
15102
+ **/
15103
+ | { name: 'GlobalLockdownLifted' }
15104
+ /**
15105
+ * Global lockdown accumulator and state were reset by governance.
15106
+ **/
15107
+ | { name: 'GlobalLockdownReset' }
15108
+ /**
15109
+ * Global limit value updated by governance (in reference currency).
15110
+ **/
15111
+ | { name: 'GlobalLimitUpdated'; data: { newLimit: bigint } }
15112
+ /**
15113
+ * Global withdraw lockdown was set by governance.
15114
+ **/
15115
+ | { name: 'GlobalLockdownSet'; data: { until: bigint } }
15116
+ /**
15117
+ * A number of egress accounts added to a list.
15118
+ **/
15119
+ | { name: 'EgressAccountsAdded'; data: { count: number } }
15120
+ /**
15121
+ * A number of egress accounts removed from a list.
15122
+ **/
15123
+ | { name: 'EgressAccountsRemoved'; data: { count: number } }
15124
+ /**
15125
+ * Asset category override updated.
15126
+ **/
15127
+ | {
15128
+ name: 'AssetCategoryUpdated';
15129
+ data: { assetId: number; category?: PalletCircuitBreakerGlobalAssetCategory | undefined };
15130
+ };
15060
15131
 
15061
15132
  /**
15062
15133
  * The `Event` enum of this pallet
@@ -18614,7 +18685,19 @@ export type PalletCircuitBreakerError =
18614
18685
  * Deposit limit would be exceeded for a whitelisted account.
18615
18686
  * Operation rejected to prevent funds being locked on system accounts.
18616
18687
  **/
18617
- | 'DepositLimitExceededForWhitelistedAccount';
18688
+ | 'DepositLimitExceededForWhitelistedAccount'
18689
+ /**
18690
+ * Global lockdown is active and withdrawals that participate in the global limit are blocked.
18691
+ **/
18692
+ | 'WithdrawLockdownActive'
18693
+ /**
18694
+ * Applying the increment would exceed the configured global limit -> lockdown is triggered and operation fails.
18695
+ **/
18696
+ | 'GlobalWithdrawLimitExceeded'
18697
+ /**
18698
+ * Asset to withdraw cannot be converted to reference currency.
18699
+ **/
18700
+ | 'FailedToConvertAsset';
18618
18701
 
18619
18702
  /**
18620
18703
  * The `Error` enum of this pallet.
@@ -2689,6 +2689,16 @@ export interface ChainEvents extends GenericChainEvents {
2689
2689
  { stash: AccountId32; update: PalletStakingAsyncAhClientSessionKeysUpdate }
2690
2690
  >;
2691
2691
 
2692
+ /**
2693
+ * Session key update from AssetHub failed on the relay chain.
2694
+ * Logged as an event for fail-safe observability.
2695
+ **/
2696
+ SessionKeysUpdateFailed: GenericPalletEvent<
2697
+ 'StakingAhClient',
2698
+ 'SessionKeysUpdateFailed',
2699
+ { stash: AccountId32; update: PalletStakingAsyncAhClientSessionKeysUpdate; error: DispatchError }
2700
+ >;
2701
+
2692
2702
  /**
2693
2703
  * Generic pallet event
2694
2704
  **/
@@ -52,7 +52,7 @@ interface ChainKnownTypes extends GenericChainKnownTypes {
52
52
 
53
53
  /**
54
54
  * @name: WestendApi
55
- * @specVersion: 1021002
55
+ * @specVersion: 1022000
56
56
  **/
57
57
  export interface WestendApi extends GenericSubstrateApi {
58
58
  rpc: ChainJsonRpcApis;
@@ -188,11 +188,13 @@ export interface ChainStorage extends GenericChainStorage {
188
188
  blockWeight: GenericStorageQuery<() => FrameSupportDispatchPerDispatchClass>;
189
189
 
190
190
  /**
191
- * Total length (in bytes) for all extrinsics put together, for the current block.
191
+ * Total size (in bytes) of the current block.
192
+ *
193
+ * Tracks the size of the header and all extrinsics.
192
194
  *
193
195
  * @param {Callback<number | undefined> =} callback
194
196
  **/
195
- allExtrinsicsLen: GenericStorageQuery<() => number | undefined>;
197
+ blockSize: GenericStorageQuery<() => number | undefined>;
196
198
 
197
199
  /**
198
200
  * Map of block numbers to block hashes.
@@ -76,6 +76,7 @@ import type {
76
76
  SpConsensusBabeAppPublic,
77
77
  SpConsensusSlotsEquivocationProof,
78
78
  SpAuthorityDiscoveryAppPublic,
79
+ SpSessionRuntimeApiOpaqueGeneratedSessionKeys,
79
80
  SpCoreCryptoKeyTypeId,
80
81
  PalletTransactionPaymentRuntimeDispatchInfo,
81
82
  PalletTransactionPaymentFeeDetails,
@@ -1097,9 +1098,12 @@ export interface RuntimeApis extends GenericRuntimeApis {
1097
1098
  * Returns the concatenated SCALE encoded public keys.
1098
1099
  *
1099
1100
  * @callname: SessionKeys_generate_session_keys
1101
+ * @param {BytesLike} owner
1100
1102
  * @param {BytesLike | undefined} seed
1101
1103
  **/
1102
- generateSessionKeys: GenericRuntimeApiMethod<(seed?: BytesLike | undefined) => Promise<Bytes>>;
1104
+ generateSessionKeys: GenericRuntimeApiMethod<
1105
+ (owner: BytesLike, seed?: BytesLike | undefined) => Promise<SpSessionRuntimeApiOpaqueGeneratedSessionKeys>
1106
+ >;
1103
1107
 
1104
1108
  /**
1105
1109
  * Decode the given public session keys.
package/westend/tx.d.ts CHANGED
@@ -1935,14 +1935,16 @@ export interface ChainTx<
1935
1935
  session: {
1936
1936
  /**
1937
1937
  * Sets the session key(s) of the function caller to `keys`.
1938
+ *
1938
1939
  * Allows an account to set its session key prior to becoming a validator.
1939
1940
  * This doesn't take effect until the next session.
1940
1941
  *
1941
- * The dispatch origin of this function must be signed.
1942
- *
1943
- * ## Complexity
1944
- * - `O(1)`. Actual cost depends on the number of length of `T::Keys::key_ids()` which is
1945
- * fixed.
1942
+ * - `origin`: The dispatch origin of this function must be signed.
1943
+ * - `keys`: The new session keys to set. These are the public keys of all sessions keys
1944
+ * setup in the runtime.
1945
+ * - `proof`: The proof that `origin` has access to the private keys of `keys`. See
1946
+ * [`impl_opaque_keys`](sp_runtime::impl_opaque_keys) for more information about the
1947
+ * proof format.
1946
1948
  *
1947
1949
  * @param {WestendRuntimeSessionKeys} keys
1948
1950
  * @param {BytesLike} proof
@@ -1973,10 +1975,6 @@ export interface ChainTx<
1973
1975
  * means being a controller account) or directly convertible into a validator ID (which
1974
1976
  * usually means being a stash account).
1975
1977
  *
1976
- * ## Complexity
1977
- * - `O(1)` in number of key types. Actual cost depends on the number of length of
1978
- * `T::Keys::key_ids()` which is fixed.
1979
- *
1980
1978
  **/
1981
1979
  purgeKeys: GenericTxCall<
1982
1980
  () => ChainSubmittableExtrinsic<
@@ -3538,7 +3536,10 @@ export interface ChainTx<
3538
3536
  >;
3539
3537
 
3540
3538
  /**
3541
- * Cancel an anonymously scheduled task.
3539
+ * Cancel a scheduled task (named or anonymous), by providing the block it is scheduled for
3540
+ * execution in, as well as the index of the task in that block's agenda.
3541
+ *
3542
+ * In the case of a named task, it will remove it from the lookup table as well.
3542
3543
  *
3543
3544
  * @param {number} when
3544
3545
  * @param {number} index
@@ -3690,6 +3691,8 @@ export interface ChainTx<
3690
3691
  * original task's configuration, but will have a lower value for `remaining` than the
3691
3692
  * original `total_retries`.
3692
3693
  *
3694
+ * This call **cannot** be used to set a retry configuration for a named task.
3695
+ *
3693
3696
  * @param {[number, number]} task
3694
3697
  * @param {number} retries
3695
3698
  * @param {number} period
@@ -3725,6 +3728,8 @@ export interface ChainTx<
3725
3728
  * original task's configuration, but will have a lower value for `remaining` than the
3726
3729
  * original `total_retries`.
3727
3730
  *
3731
+ * This is the only way to set a retry configuration for a named task.
3732
+ *
3728
3733
  * @param {FixedBytes<32>} id
3729
3734
  * @param {number} retries
3730
3735
  * @param {number} period
@@ -4437,7 +4442,9 @@ export interface ChainTx<
4437
4442
  * Register approval for a dispatch to be made from a deterministic composite account if
4438
4443
  * approved by a total of `threshold - 1` of `other_signatories`.
4439
4444
  *
4440
- * If there are enough, then dispatch the call.
4445
+ * **If the approval threshold is met (including the sender's approval), this will
4446
+ * immediately execute the call.** This is the only way to execute a multisig call -
4447
+ * `approve_as_multi` will never trigger execution.
4441
4448
  *
4442
4449
  * Payment: `DepositBase` will be reserved if this is the first approval, plus
4443
4450
  * `threshold` times `DepositFactor`. It is returned once this dispatch happens or
@@ -4453,8 +4460,9 @@ export interface ChainTx<
4453
4460
  * transaction index) of the first approval transaction.
4454
4461
  * - `call`: The call to be executed.
4455
4462
  *
4456
- * NOTE: Unless this is the final approval, you will generally want to use
4457
- * `approve_as_multi` instead, since it only requires a hash of the call.
4463
+ * NOTE: For intermediate approvals (not the final approval), you should generally use
4464
+ * `approve_as_multi` instead, since it only requires a hash of the call and is more
4465
+ * efficient.
4458
4466
  *
4459
4467
  * Result is equivalent to the dispatched result if `threshold` is exactly `1`. Otherwise
4460
4468
  * on success, result is `Ok` and the result from the interior call, if it was executed,
@@ -4509,6 +4517,13 @@ export interface ChainTx<
4509
4517
  * Register approval for a dispatch to be made from a deterministic composite account if
4510
4518
  * approved by a total of `threshold - 1` of `other_signatories`.
4511
4519
  *
4520
+ * **This function will NEVER execute the call, even if the approval threshold is
4521
+ * reached.** It only registers approval. To actually execute the call, `as_multi` must
4522
+ * be called with the full call data by any of the signatories.
4523
+ *
4524
+ * This function is more efficient than `as_multi` for intermediate approvals since it
4525
+ * only requires the call hash, not the full call data.
4526
+ *
4512
4527
  * Payment: `DepositBase` will be reserved if this is the first approval, plus
4513
4528
  * `threshold` times `DepositFactor`. It is returned once this dispatch happens or
4514
4529
  * is cancelled.
@@ -4523,7 +4538,8 @@ export interface ChainTx<
4523
4538
  * transaction index) of the first approval transaction.
4524
4539
  * - `call_hash`: The hash of the call to be executed.
4525
4540
  *
4526
- * NOTE: If this is the final approval, you will want to use `as_multi` instead.
4541
+ * NOTE: To execute the call after approvals are gathered, any signatory must call
4542
+ * `as_multi` with the full call data. This function cannot execute the call.
4527
4543
  *
4528
4544
  * ## Complexity
4529
4545
  * - `O(S)`.