@storagehub/api-augment 0.1.0 → 0.2.1

package/src/{interfaces → parachain/interfaces}/augment-api-tx.ts

@@ -19,7 +19,10 @@ import type {
   CumulusPrimitivesParachainInherentParachainInherentData,
   PalletBalancesAdjustmentDirection,
   PalletFileSystemBucketMoveRequestResponse,
-  PalletFileSystemMspStorageRequestResponse,
+  PalletFileSystemFileKeyWithProof,
+  PalletFileSystemFileOperationIntention,
+  PalletFileSystemReplicationTarget,
+  PalletFileSystemStorageRequestMspBucketResponse,
   PalletNftsAttributeNamespace,
   PalletNftsCancelAttributesApprovalWitness,
   PalletNftsCollectionConfig,
@@ -32,15 +35,13 @@ import type {
   PalletNftsPreSignedMint,
   PalletNftsPriceWithDirection,
   PalletProofsDealerProof,
-  PalletStorageProvidersValueProposition,
-  ShpFileKeyVerifierFileKeyProof,
+  ShParachainRuntimeConfigsRuntimeParamsRuntimeParameters,
+  ShParachainRuntimeSessionKeys,
   SpRuntimeMultiSignature,
   SpTrieStorageProofCompactProof,
   SpWeightsWeightV2Weight,
   StagingXcmExecutorAssetTransferTransferType,
-  StagingXcmV4Location,
-  StorageHubRuntimeConfigsRuntimeParamsRuntimeParameters,
-  StorageHubRuntimeSessionKeys,
+  StagingXcmV5Location,
   XcmV3WeightLimit,
   XcmVersionedAssetId,
   XcmVersionedAssets,
@@ -420,13 +421,6 @@ declare module "@polkadot/api-base/types/submittable" {
       [key: string]: SubmittableExtrinsicFunction<ApiType>;
     };
     fileSystem: {
-      /**
-       * Add yourself as a data server for providing the files of the bucket requested to be moved.
-       **/
-      bspAddDataServerForMoveBucketRequest: AugmentedSubmittable<
-        (bucketId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
-        [H256]
-      >;
       /**
        * Executed by a BSP to confirm to stop storing a file.
        *
@@ -456,18 +450,15 @@ declare module "@polkadot/api-base/types/submittable" {
             | string
             | Uint8Array,
           fileKeysAndProofs:
-            | Vec<ITuple<[H256, ShpFileKeyVerifierFileKeyProof]>>
-            | [
-                H256 | string | Uint8Array,
-                (
-                  | ShpFileKeyVerifierFileKeyProof
-                  | { fileMetadata?: any; proof?: any }
-                  | string
-                  | Uint8Array
-                )
-              ][]
+            | Vec<PalletFileSystemFileKeyWithProof>
+            | (
+                | PalletFileSystemFileKeyWithProof
+                | { fileKey?: any; proof?: any }
+                | string
+                | Uint8Array
+              )[]
         ) => SubmittableExtrinsic<ApiType>,
-        [SpTrieStorageProofCompactProof, Vec<ITuple<[H256, ShpFileKeyVerifierFileKeyProof]>>]
+        [SpTrieStorageProofCompactProof, Vec<PalletFileSystemFileKeyWithProof>]
       >;
       /**
        * Executed by a BSP to request to stop storing a file.
@@ -519,26 +510,82 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           mspId: H256 | string | Uint8Array,
           name: Bytes | string | Uint8Array,
-          private: bool | boolean | Uint8Array
+          private: bool | boolean | Uint8Array,
+          valuePropId: H256 | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [H256, Bytes, bool]
+        [H256, Bytes, bool, H256]
       >;
+      /**
+       * Dispatchable extrinsic that allows a User to delete any of their buckets if it is currently empty.
+       * This way, the User is allowed to remove now unused buckets to recover their deposit for them.
+       *
+       * The User must provide the BucketId of the bucket they want to delete, which should correspond to a
+       * bucket that is both theirs and currently empty.
+       *
+       * To check if a bucket is empty, we compare its current root with the one of an empty trie.
+       **/
+      deleteBucket: AugmentedSubmittable<
+        (bucketId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [H256]
+      >;
+      /**
+       * Deletes a file from a provider's forest, changing its root
+       *
+       * This extrinsic allows any actor to execute file deletion based on signed intentions
+       * from the `FileDeletionRequested` event. It requires a valid forest proof showing that the
+       * file exists in the specified provider's forest before allowing deletion.
+       *
+       * If `bsp_id` is `None`, the file will be deleted from the bucket forest.
+       * If `bsp_id` is `Some(id)`, the file will be deleted from the specified BSP's forest.
+       **/
       deleteFile: AugmentedSubmittable<
         (
+          fileOwner: AccountId32 | string | Uint8Array,
+          signedIntention:
+            | PalletFileSystemFileOperationIntention
+            | { fileKey?: any; operation?: any }
+            | string
+            | Uint8Array,
+          signature:
+            | SpRuntimeMultiSignature
+            | { Ed25519: any }
+            | { Sr25519: any }
+            | { Ecdsa: any }
+            | string
+            | Uint8Array,
           bucketId: H256 | string | Uint8Array,
-          fileKey: H256 | string | Uint8Array,
           location: Bytes | string | Uint8Array,
           size: u64 | AnyNumber | Uint8Array,
           fingerprint: H256 | string | Uint8Array,
-          maybeInclusionForestProof:
-            | Option<SpTrieStorageProofCompactProof>
-            | null
-            | Uint8Array
-            | SpTrieStorageProofCompactProof
-            | { encodedNodes?: any }
-            | string
+          bspId: Option<H256> | null | Uint8Array | H256 | string,
+          forestProof: SpTrieStorageProofCompactProof | { encodedNodes?: any } | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [H256, H256, Bytes, u64, H256, Option<SpTrieStorageProofCompactProof>]
+        [
+          AccountId32,
+          PalletFileSystemFileOperationIntention,
+          SpRuntimeMultiSignature,
+          H256,
+          Bytes,
+          u64,
+          H256,
+          Option<H256>,
+          SpTrieStorageProofCompactProof
+        ]
+      >;
+      /**
+       * Delete a file from an incomplete (rejected, expired or revoked) storage request.
+       *
+       * This extrinsic allows fisherman nodes to delete files from providers when an IncompleteStorageRequestMetadata for the given file_key
+       * exist in the IncompleteStorageRequests mapping. It validates that the IncompleteStorageRequestMetadata exists,
+       * that the provider has the file in its Merkle Patricia Forest, and verifies the file key matches the metadata.
+       **/
+      deleteFileForIncompleteStorageRequest: AugmentedSubmittable<
+        (
+          fileKey: H256 | string | Uint8Array,
+          bspId: Option<H256> | null | Uint8Array | H256 | string,
+          forestProof: SpTrieStorageProofCompactProof | { encodedNodes?: any } | string | Uint8Array
+        ) => SubmittableExtrinsic<ApiType>,
+        [H256, Option<H256>, SpTrieStorageProofCompactProof]
       >;
       /**
        * Issue a new storage request for a file
@@ -550,9 +597,19 @@ declare module "@polkadot/api-base/types/submittable" {
           fingerprint: H256 | string | Uint8Array,
           size: u64 | AnyNumber | Uint8Array,
           mspId: H256 | string | Uint8Array,
-          peerIds: Vec<Bytes> | (Bytes | string | Uint8Array)[]
+          peerIds: Vec<Bytes> | (Bytes | string | Uint8Array)[],
+          replicationTarget:
+            | PalletFileSystemReplicationTarget
+            | { Basic: any }
+            | { Standard: any }
+            | { HighSecurity: any }
+            | { SuperHighSecurity: any }
+            | { UltraHighSecurity: any }
+            | { Custom: any }
+            | string
+            | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [H256, Bytes, H256, u64, H256, Vec<Bytes>]
+        [H256, Bytes, H256, u64, H256, Vec<Bytes>, PalletFileSystemReplicationTarget]
       >;
       mspRespondMoveBucketRequest: AugmentedSubmittable<
         (
@@ -579,35 +636,76 @@ declare module "@polkadot/api-base/types/submittable" {
        **/
       mspRespondStorageRequestsMultipleBuckets: AugmentedSubmittable<
         (
-          fileKeyResponsesInput:
-            | Vec<ITuple<[H256, PalletFileSystemMspStorageRequestResponse]>>
-            | [
-                H256 | string | Uint8Array,
-                (
-                  | PalletFileSystemMspStorageRequestResponse
-                  | { accept?: any; reject?: any }
-                  | string
-                  | Uint8Array
-                )
-              ][]
+          storageRequestMspResponse:
+            | Vec<PalletFileSystemStorageRequestMspBucketResponse>
+            | (
+                | PalletFileSystemStorageRequestMspBucketResponse
+                | { bucketId?: any; accept?: any; reject?: any }
+                | string
+                | Uint8Array
+              )[]
         ) => SubmittableExtrinsic<ApiType>,
-        [Vec<ITuple<[H256, PalletFileSystemMspStorageRequestResponse]>>]
+        [Vec<PalletFileSystemStorageRequestMspBucketResponse>]
+      >;
+      mspStopStoringBucket: AugmentedSubmittable<
+        (bucketId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [H256]
+      >;
+      /**
+       * Executed by a MSP to stop storing a bucket from an insolvent user.
+       *
+       * This is used when a user has become insolvent and the MSP needs to stop storing the buckets of that user, since
+       * it won't be getting paid for them anymore.
+       * It validates that:
+       * - The sender is the MSP that's currently storing the bucket, and the bucket exists.
+       * - That the user is currently insolvent OR
+       * - That the payment stream between the MSP and user doesn't exist (which would occur as a consequence of the MSP previously
+       * having deleted another bucket it was storing for this user through this extrinsic).
+       * And then completely removes the bucket from the system.
+       *
+       * If there was a storage request pending for the bucket, it will eventually expire without being fulfilled (because the MSP can't
+       * accept storage requests for insolvent users and BSPs can't volunteer nor confirm them either) and afterwards any BSPs that
+       * had confirmed the file can just call `sp_stop_storing_for_insolvent_user` to get rid of it.
+       **/
+      mspStopStoringBucketForInsolventUser: AugmentedSubmittable<
+        (bucketId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [H256]
       >;
-      pendingFileDeletionRequestSubmitProof: AugmentedSubmittable<
+      /**
+       * Request deletion of a file using a signed delete intention.
+       *
+       * The origin must be signed and the signature must be valid for the given delete intention.
+       * The delete intention must contain the file key and the delete operation.
+       * File metadata is provided separately for ownership verification.
+       **/
+      requestDeleteFile: AugmentedSubmittable<
         (
-          user: AccountId32 | string | Uint8Array,
-          fileKey: H256 | string | Uint8Array,
+          signedIntention:
+            | PalletFileSystemFileOperationIntention
+            | { fileKey?: any; operation?: any }
+            | string
+            | Uint8Array,
+          signature:
+            | SpRuntimeMultiSignature
+            | { Ed25519: any }
+            | { Sr25519: any }
+            | { Ecdsa: any }
+            | string
+            | Uint8Array,
           bucketId: H256 | string | Uint8Array,
-          forestProof: SpTrieStorageProofCompactProof | { encodedNodes?: any } | string | Uint8Array
+          location: Bytes | string | Uint8Array,
+          size: u64 | AnyNumber | Uint8Array,
+          fingerprint: H256 | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [AccountId32, H256, H256, SpTrieStorageProofCompactProof]
+        [PalletFileSystemFileOperationIntention, SpRuntimeMultiSignature, H256, Bytes, u64, H256]
       >;
       requestMoveBucket: AugmentedSubmittable<
         (
           bucketId: H256 | string | Uint8Array,
-          newMspId: H256 | string | Uint8Array
+          newMspId: H256 | string | Uint8Array,
+          newValuePropId: H256 | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [H256, H256]
+        [H256, H256, H256]
       >;
       /**
        * Revoke storage request
@@ -616,13 +714,6 @@ declare module "@polkadot/api-base/types/submittable" {
         (fileKey: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
         [H256]
       >;
-      setGlobalParameters: AugmentedSubmittable<
-        (
-          replicationTarget: Option<u32> | null | Uint8Array | u32 | AnyNumber,
-          tickRangeToMaximumThreshold: Option<u32> | null | Uint8Array | u32 | AnyNumber
-        ) => SubmittableExtrinsic<ApiType>,
-        [Option<u32>, Option<u32>]
-      >;
       /**
        * Executed by a SP to stop storing a file from an insolvent user.
        *
@@ -1845,38 +1936,6 @@ declare module "@polkadot/api-base/types/submittable" {
       [key: string]: SubmittableExtrinsicFunction<ApiType>;
     };
     parachainSystem: {
-      /**
-       * Authorize an upgrade to a given `code_hash` for the runtime. The runtime can be supplied
-       * later.
-       *
-       * The `check_version` parameter sets a boolean flag for whether or not the runtime's spec
-       * version and name should be verified on upgrade. Since the authorization only has a hash,
-       * it cannot actually perform the verification.
-       *
-       * This call requires Root origin.
-       **/
-      authorizeUpgrade: AugmentedSubmittable<
-        (
-          codeHash: H256 | string | Uint8Array,
-          checkVersion: bool | boolean | Uint8Array
-        ) => SubmittableExtrinsic<ApiType>,
-        [H256, bool]
-      >;
-      /**
-       * Provide the preimage (runtime binary) `code` for an upgrade that has been authorized.
-       *
-       * If the authorization required a version check, this call will ensure the spec name
-       * remains unchanged and that the spec version has increased.
-       *
-       * Note that this function will not apply the new `code`, but only attempt to schedule the
-       * upgrade with the Relay Chain.
-       *
-       * All origins are allowed.
-       **/
-      enactAuthorizedUpgrade: AugmentedSubmittable<
-        (code: Bytes | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
-        [Bytes]
-      >;
       /**
        * Set the current validation data.
        *
@@ -1922,12 +1981,12 @@ declare module "@polkadot/api-base/types/submittable" {
       setParameter: AugmentedSubmittable<
         (
           keyValue:
-            | StorageHubRuntimeConfigsRuntimeParamsRuntimeParameters
+            | ShParachainRuntimeConfigsRuntimeParamsRuntimeParameters
             | { RuntimeConfig: any }
             | string
             | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [StorageHubRuntimeConfigsRuntimeParamsRuntimeParameters]
+        [ShParachainRuntimeConfigsRuntimeParamsRuntimeParameters]
       >;
       /**
        * Generic tx
@@ -1935,6 +1994,44 @@ declare module "@polkadot/api-base/types/submittable" {
       [key: string]: SubmittableExtrinsicFunction<ApiType>;
     };
     paymentStreams: {
+      /**
+       * Dispatchable extrinsic that allows Providers to charge multiple User's payment streams.
+       *
+       * The dispatch origin for this call must be Signed.
+       * The origin must be the Provider that has at least one type of payment stream with each of the Users.
+       *
+       * Parameters:
+       * - `user_accounts`: The array of User Account IDs that have payment streams with the Provider.
+       *
+       * This extrinsic will perform the following checks and logic:
+       * 1. Check that the extrinsic was signed and get the signer.
+       * 2. Check that the array of Users is not bigger than the maximum allowed.
+       * 3. Execute a for loop for each User in the array of User Account IDs, in which it:
+       * a. Checks that a payment stream between the signer (Provider) and the User exists
+       * b. If there is a fixed-rate payment stream:
+       * 1. Get the rate of the payment stream
+       * 2. Get the difference between the last charged tick number and the last chargeable tick number of the stream
+       * 3. Calculate the amount to charge doing `rate * difference`
+       * 4. Charge the user (if the user does not have enough funds, it gets flagged and a `UserWithoutFunds` event is emitted)
+       * 5. Update the last charged tick number of the payment stream
+       * c. If there is a dynamic-rate payment stream:
+       * 1. Get the amount provided by the Provider
+       * 2. Get the difference between price index when the stream was last charged and the price index at the last chargeable tick
+       * 3. Calculate the amount to charge doing `amount_provided * difference`
+       * 4. Charge the user (if the user does not have enough funds, it gets flagged and a `UserWithoutFunds` event is emitted)
+       * 5. Update the price index when the stream was last charged of the payment stream
+       *
+       * Emits a `PaymentStreamCharged` per User that had to pay and a `UsersCharged` event when successful.
+       *
+       * Notes: a Provider could have both a fixed-rate and a dynamic-rate payment stream with a User. If that's the case, this extrinsic
+       * will try to charge both and the amount charged will be the sum of the amounts charged for each payment stream.
+       **/
+      chargeMultipleUsersPaymentStreams: AugmentedSubmittable<
+        (
+          userAccounts: Vec<AccountId32> | (AccountId32 | string | Uint8Array)[]
+        ) => SubmittableExtrinsic<ApiType>,
+        [Vec<AccountId32>]
+      >;
       /**
        * Dispatchable extrinsic that allows Providers to charge a payment stream from a User.
        *
@@ -1971,7 +2068,7 @@ declare module "@polkadot/api-base/types/submittable" {
       >;
       /**
        * Dispatchable extrinsic that allows a user flagged as without funds long ago enough to clear this flag from its account,
-       * allowing it to begin contracting and paying for services again. If there's any outstanding debt, it will be charged and cleared.
+       * allowing it to begin contracting and paying for services again. It should have previously paid all its outstanding debt.
        *
        * The dispatch origin for this call must be Signed.
        * The origin must be the User that has been flagged as without funds.
@@ -1980,18 +2077,10 @@ declare module "@polkadot/api-base/types/submittable" {
        * 1. Check that the extrinsic was signed and get the signer.
        * 2. Check that the user has been flagged as without funds.
        * 3. Check that the cooldown period has passed since the user was flagged as without funds.
-       * 4. Check if there's any outstanding debt and charge it. This is done by:
-       * a. Releasing any remaining funds held as a deposit for each payment stream.
-       * b. Getting all payment streams of the user and charging them, paying the Providers for the services.
-       * c. Returning the User any remaining funds.
-       * d. Deleting all payment streams of the user.
+       * 4. Check that there's no remaining outstanding debt.
        * 5. Unflag the user as without funds.
        *
        * Emits a 'UserSolvent' event when successful.
-       *
-       * Notes: this extrinsic iterates over all remaining payment streams of the user and charges them, so it can be expensive in terms of weight.
-       * The fee to execute it should be high enough to compensate for the weight of the extrinsic, without being too high that the user
-       * finds more convenient to wait for Providers to get its deposits one by one instead.
        **/
       clearInsolventFlag: AugmentedSubmittable<() => SubmittableExtrinsic<ApiType>, []>;
       /**
@@ -2099,8 +2188,8 @@ declare module "@polkadot/api-base/types/submittable" {
         [H256, AccountId32]
       >;
       /**
-       * Dispatchable extrinsic that allows a user flagged as without funds to pay all remaining payment streams to be able to recover
-       * its deposits.
+       * Dispatchable extrinsic that allows a user flagged as without funds to pay the Providers that still have payment streams
+       * with it, in order to recover as much of its deposits as possible.
        *
        * The dispatch origin for this call must be Signed.
        * The origin must be the User that has been flagged as without funds.
@@ -2108,17 +2197,23 @@ declare module "@polkadot/api-base/types/submittable" {
        * This extrinsic will perform the following checks and logic:
        * 1. Check that the extrinsic was signed and get the signer.
        * 2. Check that the user has been flagged as without funds.
-       * 3. Release the user's funds that were held as a deposit for each payment stream.
-       * 4. Get all payment streams of the user and charge them, paying the Providers for the services.
-       * 5. Delete all payment streams of the user.
+       * 3. Release the user's funds that were held as a deposit for each payment stream to be paid.
+       * 4. Get the payment streams that the user has with the provided list of Providers, and pay them for the services.
+       * 5. Delete the charged payment streams of the user.
        *
-       * Emits a 'UserPaidDebts' event when successful.
+       * Emits a 'UserPaidSomeDebts' event when successful if the user has remaining debts. If the user has successfully paid all its debts,
+       * it emits a 'UserPaidAllDebts' event.
        *
-       * Notes: this extrinsic iterates over all payment streams of the user and charges them, so it can be expensive in terms of weight.
-       * The fee to execute it should be high enough to compensate for the weight of the extrinsic, without being too high that the user
-       * finds more convenient to wait for Providers to get its deposits one by one instead.
+       * Notes: this extrinsic iterates over the provided list of Providers, getting the payment streams they have with the user and charging
+       * them, so the execution could get expensive. It's recommended to provide a list of Providers that the user actually has payment streams with,
+       * which can be obtained by calling the `get_providers_with_payment_streams_with_user` runtime API.
+       * There was an idea to limit the amount of Providers that can be received by this extrinsic using a constant in the configuration of this pallet,
+       * but the correct benchmarking of this extrinsic should be enough to avoid any potential abuse.
        **/
-      payOutstandingDebt: AugmentedSubmittable<() => SubmittableExtrinsic<ApiType>, []>;
+      payOutstandingDebt: AugmentedSubmittable<
+        (providers: Vec<H256> | (H256 | string | Uint8Array)[]) => SubmittableExtrinsic<ApiType>,
+        [Vec<H256>]
+      >;
       /**
        * Dispatchable extrinsic that allows root to update an existing dynamic-rate payment stream between a User and a Provider.
        *
@@ -2189,16 +2284,16 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           assets:
             | XcmVersionedAssets
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           beneficiary:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
@@ -2216,7 +2311,7 @@ declare module "@polkadot/api-base/types/submittable" {
        **/
       execute: AugmentedSubmittable<
         (
-          message: XcmVersionedXcm | { V2: any } | { V3: any } | { V4: any } | string | Uint8Array,
+          message: XcmVersionedXcm | { V3: any } | { V4: any } | { V5: any } | string | Uint8Array,
           maxWeight:
             | SpWeightsWeightV2Weight
             | { refTime?: any; proofSize?: any }
@@ -2248,9 +2343,9 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           location:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
@@ -2278,9 +2373,9 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           location:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
@@ -2296,10 +2391,10 @@ declare module "@polkadot/api-base/types/submittable" {
        **/
       forceXcmVersion: AugmentedSubmittable<
         (
-          location: StagingXcmV4Location | { parents?: any; interior?: any } | string | Uint8Array,
+          location: StagingXcmV5Location | { parents?: any; interior?: any } | string | Uint8Array,
           version: u32 | AnyNumber | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [StagingXcmV4Location, u32]
+        [StagingXcmV5Location, u32]
       >;
       /**
        * Transfer some assets from the local chain to the destination chain through their local,
@@ -2337,23 +2432,23 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           dest:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           beneficiary:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           assets:
             | XcmVersionedAssets
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           feeAssetItem: u32 | AnyNumber | Uint8Array,
@@ -2390,23 +2485,23 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           dest:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           beneficiary:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           assets:
             | XcmVersionedAssets
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           feeAssetItem: u32 | AnyNumber | Uint8Array,
@@ -2455,23 +2550,23 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           dest:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           beneficiary:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           assets:
             | XcmVersionedAssets
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           feeAssetItem: u32 | AnyNumber | Uint8Array
@@ -2482,12 +2577,12 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           dest:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
-          message: XcmVersionedXcm | { V2: any } | { V3: any } | { V4: any } | string | Uint8Array
+          message: XcmVersionedXcm | { V3: any } | { V4: any } | { V5: any } | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
         [XcmVersionedLocation, XcmVersionedXcm]
       >;
@@ -2515,23 +2610,23 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           dest:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           beneficiary:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           assets:
             | XcmVersionedAssets
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           feeAssetItem: u32 | AnyNumber | Uint8Array
@@ -2577,23 +2672,23 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           dest:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           beneficiary:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           assets:
             | XcmVersionedAssets
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           feeAssetItem: u32 | AnyNumber | Uint8Array,
@@ -2660,16 +2755,16 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           dest:
             | XcmVersionedLocation
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           assets:
             | XcmVersionedAssets
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           assetsTransferType:
@@ -2680,7 +2775,13 @@ declare module "@polkadot/api-base/types/submittable" {
             | { RemoteReserve: any }
             | string
             | Uint8Array,
-          remoteFeesId: XcmVersionedAssetId | { V3: any } | { V4: any } | string | Uint8Array,
+          remoteFeesId:
+            | XcmVersionedAssetId
+            | { V3: any }
+            | { V4: any }
+            | { V5: any }
+            | string
+            | Uint8Array,
           feesTransferType:
             | StagingXcmExecutorAssetTransferTransferType
             | { Teleport: any }
@@ -2691,9 +2792,9 @@ declare module "@polkadot/api-base/types/submittable" {
             | Uint8Array,
           customXcmOnDest:
             | XcmVersionedXcm
-            | { V2: any }
             | { V3: any }
             | { V4: any }
+            | { V5: any }
             | string
             | Uint8Array,
           weightLimit:
@@ -2722,7 +2823,7 @@ declare module "@polkadot/api-base/types/submittable" {
       /**
        * Introduce a new challenge.
        *
-       * This function allows anyone to add a new challenge to the `ChallengesQueue`.
+       * This function allows authorized origins to add a new challenge to the `ChallengesQueue`.
        * The challenge will be dispatched in the coming blocks.
        * Users are charged a small fee for submitting a challenge, which
        * goes to the Treasury.
@@ -2743,6 +2844,13 @@ declare module "@polkadot/api-base/types/submittable" {
         (provider: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
         [H256]
       >;
+      priorityChallenge: AugmentedSubmittable<
+        (
+          key: H256 | string | Uint8Array,
+          shouldRemoveKey: bool | boolean | Uint8Array
+        ) => SubmittableExtrinsic<ApiType>,
+        [H256, bool]
+      >;
       /**
        * Set the [`ChallengesTickerPaused`] to `true` or `false`.
        *
@@ -2759,19 +2867,23 @@ declare module "@polkadot/api-base/types/submittable" {
        * is provided, the proof submitter is considered to be the Provider.
        * Relies on a Providers pallet to get the root for the Provider.
        * Validates that the proof corresponds to a challenge that was made in the past,
-       * by checking the `TickToChallengesSeed` StorageMap. The challenge tick that the
-       * Provider should have submitted a proof is calculated based on the last tick they
-       * submitted a proof for ([`LastTickProviderSubmittedAProofFor`]), and the proving period for
-       * that Provider, which is a function of their stake.
+       * by checking the [`TickToChallengesSeed`] StorageMap. The challenge tick that the
+       * Provider should be submitting a proof for is retrieved from [`ProviderToProofSubmissionRecord`],
+       * and it was calculated based on the last tick they submitted a proof for, and the challenge
+       * period for that Provider, at the time of the previous proof submission or when it was
+       * marked as slashable.
+       *
        * This extrinsic also checks that there hasn't been a checkpoint challenge round
        * in between the last time the Provider submitted a proof for and the tick
        * for which the proof is being submitted. If there has been, the Provider is
-       * subject to slashing.
+       * expected to include responses to the checkpoint challenges in the proof.
        *
        * If valid:
        * - Pushes forward the Provider in the [`TickToProvidersDeadlines`] StorageMap a number
        * of ticks corresponding to the stake of the Provider.
-       * - Registers this tick as the last tick in which the Provider submitted a proof.
+       * - Registers the last tick for which the Provider submitted a proof for in
+       * [`ProviderToProofSubmissionRecord`], as well as the next tick for which the Provider
+       * should submit a proof for.
        *
        * Execution of this extrinsic should be refunded if the proof is valid.
        **/
@@ -2793,32 +2905,42 @@ declare module "@polkadot/api-base/types/submittable" {
     };
     providers: {
       /**
-       * Dispatchable extrinsic only callable by an MSP that allows it to add a value proposition to its service
+       * Dispatchable extrinsic that allows BSPs and MSPs to add a new multiaddress to their account.
        *
        * The dispatch origin for this call must be Signed.
-       * The origin must be the account that wants to add a value proposition.
+       * The origin must be the account that wants to add a new multiaddress.
        *
        * Parameters:
-       * - `new_value_prop`: The value proposition that the MSP wants to add to its service.
+       * - `new_multiaddress`: The new multiaddress that the signer wants to add to its account.
        *
        * This extrinsic will perform the following checks and logic:
        * 1. Check that the extrinsic was signed and get the signer.
-       * 2. Check that the signer is registered as a MSP
-       * 3. Check that the MSP has not reached the maximum amount of value propositions
-       * 4. Check that the value proposition is valid (size and any other relevant checks)
-       * 5. Update the MSPs storage to add the value proposition (with its identifier)
+       * 2. Check that the signer is registered as a MSP or BSP.
+       * 3. Check that the Provider has not reached the maximum amount of multiaddresses.
+       * 4. Check that the multiaddress is valid (size and any other relevant checks). TODO: Implement this.
+       * 5. Update the Provider's storage to add the multiaddress.
+       *
+       * Emits `MultiAddressAdded` event when successful.
+       **/
+      addMultiaddress: AugmentedSubmittable<
+        (newMultiaddress: Bytes | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [Bytes]
+      >;
+      /**
+       * Dispatchable extrinsic only callable by an MSP that allows it to add a value proposition to its service
+       *
+       * The dispatch origin for this call must be Signed.
+       * The origin must be the account that wants to add a value proposition.
        *
        * Emits `ValuePropAdded` event when successful.
        **/
       addValueProp: AugmentedSubmittable<
         (
-          newValueProp:
-            | PalletStorageProvidersValueProposition
-            | { identifier?: any; dataLimit?: any; protocols?: any }
-            | string
-            | Uint8Array
+          pricePerGigaUnitOfDataPerBlock: u128 | AnyNumber | Uint8Array,
+          commitment: Bytes | string | Uint8Array,
+          bucketDataLimit: u64 | AnyNumber | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [PalletStorageProvidersValueProposition]
+        [u128, Bytes, u64]
       >;
       /**
        * Dispatchable extrinsic that allows users to sign off as a Backup Storage Provider.
@@ -2906,7 +3028,7 @@ declare module "@polkadot/api-base/types/submittable" {
        * Notes:
        * - This extrinsic could be called by the user itself or by a third party
        * - The deposit that the user has to pay to register as a SP is held when the user requests to register as a SP
-       * - If this extrinsic is successful, it will be free for the caller, to incentive state debloating
+       * - If this extrinsic is successful, it will be free for the caller, to incentive state de-bloating
        **/
       confirmSignUp: AugmentedSubmittable<
         (
@@ -2914,6 +3036,27 @@ declare module "@polkadot/api-base/types/submittable" {
         ) => SubmittableExtrinsic<ApiType>,
         [Option<AccountId32>]
       >;
+      /**
+       * Delete a provider from the system.
+       *
+       * This can only be done if the following conditions are met:
+       * - The provider is insolvent.
+       * - The provider has no active payment streams.
+       *
+       * This is a free operation and can be called by anyone with a signed transaction.
+       *
+       * You can utilize the runtime API `can_delete_provider` to check if a provider can be deleted
+       * to automate the process.
+       *
+       * Emits `MspDeleted` or `BspDeleted` event when successful.
+       *
+       * This operation is free if successful to encourage the community to delete insolvent providers,
+       * debloating the state.
+       **/
+      deleteProvider: AugmentedSubmittable<
+        (providerId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [H256]
+      >;
       /**
        * Dispatchable extrinsic that allows to forcefully and automatically sing up a Backup Storage Provider.
        *
@@ -2947,7 +3090,7 @@ declare module "@polkadot/api-base/types/submittable" {
         [AccountId32, H256, u64, Vec<Bytes>, AccountId32, Option<u32>]
       >;
       /**
-       * Dispatchable extrinsic that allows to forcefully and automatically sing up a Main Storage Provider.
+       * Dispatchable extrinsic that allows to forcefully and automatically sign up a Main Storage Provider.
        *
        * The dispatch origin for this call must be Root.
        * The `who` parameter is the account that wants to sign up as a Main Storage Provider.
@@ -2976,14 +3119,22 @@ declare module "@polkadot/api-base/types/submittable" {
           mspId: H256 | string | Uint8Array,
           capacity: u64 | AnyNumber | Uint8Array,
           multiaddresses: Vec<Bytes> | (Bytes | string | Uint8Array)[],
-          valueProp:
-            | PalletStorageProvidersValueProposition
-            | { identifier?: any; dataLimit?: any; protocols?: any }
-            | string
-            | Uint8Array,
+          valuePropPricePerGigaUnitOfDataPerBlock: u128 | AnyNumber | Uint8Array,
+          commitment: Bytes | string | Uint8Array,
+          valuePropMaxDataLimit: u64 | AnyNumber | Uint8Array,
           paymentAccount: AccountId32 | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [AccountId32, H256, u64, Vec<Bytes>, PalletStorageProvidersValueProposition, AccountId32]
+        [AccountId32, H256, u64, Vec<Bytes>, u128, Bytes, u64, AccountId32]
+      >;
+      /**
+       * Dispatchable extrinsic only callable by an MSP that allows it to make a value proposition unavailable.
+       *
+       * This operation cannot be reversed. You can only add new value propositions.
+       * This will not affect existing buckets which are using this value proposition.
+       **/
+      makeValuePropUnavailable: AugmentedSubmittable<
+        (valuePropId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [H256]
       >;
       /**
        * Dispatchable extrinsic that allows users to sign off as a Main Storage Provider.
@@ -3001,7 +3152,31 @@ declare module "@polkadot/api-base/types/submittable" {
        *
        * Emits `MspSignOffSuccess` event when successful.
        **/
-      mspSignOff: AugmentedSubmittable<() => SubmittableExtrinsic<ApiType>, []>;
+      mspSignOff: AugmentedSubmittable<
+        (mspId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [H256]
+      >;
+      /**
+       * Dispatchable extrinsic that allows BSPs and MSPs to remove an existing multiaddress from their account.
+       *
+       * The dispatch origin for this call must be Signed.
+       * The origin must be the account that wants to remove a multiaddress.
+       *
+       * Parameters:
+       * - `multiaddress`: The multiaddress that the signer wants to remove from its account.
+       *
+       * This extrinsic will perform the following checks and logic:
+       * 1. Check that the extrinsic was signed and get the signer.
+       * 2. Check that the signer is registered as a MSP or BSP.
+       * 3. Check that the multiaddress exists in the Provider's account.
+       * 4. Update the Provider's storage to remove the multiaddress.
+       *
+       * Emits `MultiAddressRemoved` event when successful.
+       **/
+      removeMultiaddress: AugmentedSubmittable<
+        (multiaddress: Bytes | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
+        [Bytes]
+      >;
       /**
        * Dispatchable extrinsic that allows users to sign up as a Backup Storage Provider.
        *
@@ -3067,25 +3242,42 @@ declare module "@polkadot/api-base/types/submittable" {
         (
           capacity: u64 | AnyNumber | Uint8Array,
           multiaddresses: Vec<Bytes> | (Bytes | string | Uint8Array)[],
-          valueProp:
-            | PalletStorageProvidersValueProposition
-            | { identifier?: any; dataLimit?: any; protocols?: any }
-            | string
-            | Uint8Array,
+          valuePropPricePerGigaUnitOfDataPerBlock: u128 | AnyNumber | Uint8Array,
+          commitment: Bytes | string | Uint8Array,
+          valuePropMaxDataLimit: u64 | AnyNumber | Uint8Array,
           paymentAccount: AccountId32 | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [u64, Vec<Bytes>, PalletStorageProvidersValueProposition, AccountId32]
+        [u64, Vec<Bytes>, u128, Bytes, u64, AccountId32]
       >;
       /**
        * Dispatchable extrinsic to slash a _slashable_ Storage Provider.
        *
        * A Storage Provider is _slashable_ iff it has failed to respond to challenges for providing proofs of storage.
        * In the context of the StorageHub protocol, the proofs-dealer pallet marks a Storage Provider as _slashable_ when it fails to respond to challenges.
+       *
+       * This is a free operation to incentivise the community to slash misbehaving providers.
        **/
       slash: AugmentedSubmittable<
         (providerId: H256 | string | Uint8Array) => SubmittableExtrinsic<ApiType>,
         [H256]
       >;
+      /**
+       * BSP operation to stop all of your automatic cycles.
+       *
+       * This includes:
+       *
+       * - Commit reveal randomness cycle
+       * - Proof challenge cycle
+       *
+       * If you are an BSP, the only requirement that must be met is that your root is the default one (an empty root).
+       **/
+      stopAllCycles: AugmentedSubmittable<() => SubmittableExtrinsic<ApiType>, []>;
+      /**
+       * Dispatchable extrinsic to top-up the deposit of a Storage Provider.
+       *
+       * The dispatch origin for this call must be signed.
+       **/
+      topUpDeposit: AugmentedSubmittable<() => SubmittableExtrinsic<ApiType>, []>;
       /**
        * Generic tx
        **/
@@ -3132,10 +3324,10 @@ declare module "@polkadot/api-base/types/submittable" {
        **/
       setKeys: AugmentedSubmittable<
         (
-          keys: StorageHubRuntimeSessionKeys | { aura?: any } | string | Uint8Array,
+          keys: ShParachainRuntimeSessionKeys | { aura?: any } | string | Uint8Array,
           proof: Bytes | string | Uint8Array
         ) => SubmittableExtrinsic<ApiType>,
-        [StorageHubRuntimeSessionKeys, Bytes]
+        [ShParachainRuntimeSessionKeys, Bytes]
       >;
       /**
        * Generic tx