@argonprotocol/mainchain 1.4.12-dev.dd86fab9 → 1.4.12-dev.ece9349b

package/src/interfaces/augment-api-query.ts

@@ -64,9 +64,11 @@ import type {
   PalletBalancesBalanceLock,
   PalletBalancesReserveData,
   PalletBitcoinFissionsFission,
+  PalletBitcoinLocksLockReleaseCosignHeight,
   PalletBitcoinLocksLockReleaseRequest,
   PalletBitcoinLocksLockedBitcoin,
   PalletBitcoinLocksOrphanedUtxo,
+  PalletBitcoinLocksPendingPartialRelease,
   PalletBootstrapEndpointPubkey,
   PalletBootstrapRecoveryPubkey,
   PalletCrosschainTransferAccountTransferTotals,
@@ -93,7 +95,7 @@ import type {
   PalletMiningSlotMinerNonceScoring,
   PalletMintMintAction,
   PalletMintMintQueueCursor,
-  PalletMintPendingMintUtxo,
+  PalletMintPendingBitcoinMint,
   PalletMultisigMultisig,
   PalletOperationalAccountsOperationalAccount,
   PalletOperationalAccountsRewardsConfig,
@@ -249,9 +251,9 @@ declare module '@polkadot/api-base/types/storage' {
         [u32, AccountId32]
       >;
       /**
-       * Highest Bitcoin UTXO sync height processed for pending-funding expirations.
+       * Highest Bitcoin UTXO sync height processed for securitization hold expirations.
        **/
-      lastPendingFundingExpirationHeight: AugmentedQuery<
+      lastProcessedSecuritizationHoldBitcoinHeight: AugmentedQuery<
         ApiType,
         () => Observable<Option<u64>>,
         []
@@ -274,38 +276,53 @@ declare module '@polkadot/api-base/types/storage' {
         [u64]
       >;
       /**
-       * Stores the block number where a release was cosigned by the vault.
+       * Index of active UTXO IDs per owner account.
        **/
-      lockReleaseCosignHeightById: AugmentedQuery<
+      lockIdsByOwnerAccount: AugmentedQuery<
         ApiType,
-        (arg: u64 | AnyNumber | Uint8Array) => Observable<Option<u32>>,
-        [u64]
+        (
+          arg1: AccountId32 | string | Uint8Array,
+          arg2: u64 | AnyNumber | Uint8Array,
+        ) => Observable<Option<Null>>,
+        [AccountId32, u64]
+      >;
+      /**
+       * Index of active UTXO IDs per vault
+       **/
+      lockIdsByVaultId: AugmentedQuery<
+        ApiType,
+        (
+          arg1: u32 | AnyNumber | Uint8Array,
+          arg2: u64 | AnyNumber | Uint8Array,
+        ) => Observable<Option<Null>>,
+        [u32, u64]
       >;
       /**
-       * Stores bitcoin locks that have requested to be released
+       * Latest cosigned release for each Lock, retained for signature recovery.
        **/
-      lockReleaseRequestsByUtxoId: AugmentedQuery<
+      lockReleaseCosignHeightById: AugmentedQuery<
         ApiType,
         (
           arg: u64 | AnyNumber | Uint8Array,
-        ) => Observable<Option<PalletBitcoinLocksLockReleaseRequest>>,
+        ) => Observable<Option<PalletBitcoinLocksLockReleaseCosignHeight>>,
         [u64]
       >;
       /**
-       * Stores bitcoin utxos that have requested to be released
+       * Release requests awaiting a Vault cosignature.
        **/
-      locksByUtxoId: AugmentedQuery<
+      lockReleaseRequestsById: AugmentedQuery<
         ApiType,
-        (arg: u64 | AnyNumber | Uint8Array) => Observable<Option<PalletBitcoinLocksLockedBitcoin>>,
+        (
+          arg: u64 | AnyNumber | Uint8Array,
+        ) => Observable<Option<PalletBitcoinLocksLockReleaseRequest>>,
         [u64]
       >;
       /**
-       * Unfunded locks whose pending securitization reservation expires at the indexed height.
-       * Expiry releases the reservation but leaves the lock address watched for late orphan output.
+       * Stores bitcoin utxos that have requested to be released
        **/
-      locksPendingFundingByBitcoinHeight: AugmentedQuery<
+      locksById: AugmentedQuery<
         ApiType,
-        (arg: u64 | AnyNumber | Uint8Array) => Observable<BTreeSet<u64>>,
+        (arg: u64 | AnyNumber | Uint8Array) => Observable<Option<PalletBitcoinLocksLockedBitcoin>>,
         [u64]
       >;
       /**
@@ -316,22 +333,11 @@ declare module '@polkadot/api-base/types/storage' {
         () => Observable<Vec<ITuple<[u64, u128]>>>,
         []
       >;
-      /**
-       * Release amounts identified by the version 10 to 11 migration.
-       *
-       * Current release requests do not create currency holds. Each migrated entry is removed when
-       * its in-flight release request terminates.
-       **/
-      migratedReleaseHoldByUtxoId: AugmentedQuery<
-        ApiType,
-        (arg: u64 | AnyNumber | Uint8Array) => Observable<Option<u128>>,
-        [u64]
-      >;
       /**
        * The minimum number of satoshis accepted in one watched funding UTXO.
        **/
       minimumSatoshis: AugmentedQuery<ApiType, () => Observable<u64>, []>;
-      nextUtxoId: AugmentedQuery<ApiType, () => Observable<Option<u64>>, []>;
+      nextBitcoinLockId: AugmentedQuery<ApiType, () => Observable<Option<u64>>, []>;
       /**
        * Expiration of orphaned utxo refs by user account
        **/
@@ -358,33 +364,22 @@ declare module '@polkadot/api-base/types/storage' {
         [AccountId32, ArgonPrimitivesBitcoinUtxoRef]
       >;
       /**
-       * Index of active UTXO IDs per owner account.
-       **/
-      utxoIdsByOwnerAccount: AugmentedQuery<
-        ApiType,
-        (
-          arg1: AccountId32 | string | Uint8Array,
-          arg2: u64 | AnyNumber | Uint8Array,
-        ) => Observable<Option<Null>>,
-        [AccountId32, u64]
-      >;
-      /**
-       * Index of active UTXO IDs per vault
+       * Cosigned partial releases awaiting confirmation on Bitcoin.
        **/
-      utxoIdsByVaultId: AugmentedQuery<
+      pendingPartialReleaseByLockId: AugmentedQuery<
         ApiType,
         (
-          arg1: u32 | AnyNumber | Uint8Array,
-          arg2: u64 | AnyNumber | Uint8Array,
-        ) => Observable<Option<Null>>,
-        [u32, u64]
+          arg: u64 | AnyNumber | Uint8Array,
+        ) => Observable<Option<PalletBitcoinLocksPendingPartialRelease>>,
+        [u64]
       >;
       /**
-       * The utxo funding this lock. In the current runtime, this is just the first utxo received
+       * Lock IDs whose securitization hold expires at the indexed Bitcoin height.
+       * Expiry releases only the unactivated portion and leaves the lock address watched.
        **/
-      utxoIdToFundingUtxoRef: AugmentedQuery<
+      securitizationHoldExpirationsByBitcoinHeight: AugmentedQuery<
         ApiType,
-        (arg: u64 | AnyNumber | Uint8Array) => Observable<Option<ArgonPrimitivesBitcoinUtxoRef>>,
+        (arg: u64 | AnyNumber | Uint8Array) => Observable<BTreeSet<u64>>,
         [u64]
       >;
     };
@@ -409,6 +404,20 @@ declare module '@polkadot/api-base/types/storage' {
        * Check if the inherent was included
        **/
       inherentIncluded: AugmentedQuery<ApiType, () => Observable<bool>, []>;
+      /**
+       * The Lock ID identified by each watched script pubkey.
+       **/
+      lockIdByScriptPubkey: AugmentedQuery<
+        ApiType,
+        (
+          arg:
+            | ArgonPrimitivesBitcoinBitcoinCosignScriptPubkey
+            | { P2WSH: any }
+            | string
+            | Uint8Array,
+        ) => Observable<Option<u64>>,
+        [ArgonPrimitivesBitcoinBitcoinCosignScriptPubkey]
+      >;
       /**
        * Bitcoin Oracle Operator Account
        **/
@@ -433,31 +442,17 @@ declare module '@polkadot/api-base/types/storage' {
       /**
        * Watched Lock addresses and the scan height needed to observe them.
        **/
-      utxoAddressByUtxoId: AugmentedQuery<
+      utxoAddressByLockId: AugmentedQuery<
         ApiType,
         (
           arg: u64 | AnyNumber | Uint8Array,
         ) => Observable<Option<ArgonPrimitivesBitcoinUtxoAddress>>,
         [u64]
       >;
-      /**
-       * The Lock ID identified by each watched script pubkey.
-       **/
-      utxoIdByScriptPubkey: AugmentedQuery<
-        ApiType,
-        (
-          arg:
-            | ArgonPrimitivesBitcoinBitcoinCosignScriptPubkey
-            | { P2WSH: any }
-            | string
-            | Uint8Array,
-        ) => Observable<Option<u64>>,
-        [ArgonPrimitivesBitcoinBitcoinCosignScriptPubkey]
-      >;
       /**
        * Every output observed at a watched Lock address, retained until explicitly removed.
        **/
-      utxoRefsByUtxoId: AugmentedQuery<
+      utxoRefsByLockId: AugmentedQuery<
         ApiType,
         (arg: u64 | AnyNumber | Uint8Array) => Observable<BTreeSet<ArgonPrimitivesBitcoinUtxoRef>>,
         [u64]
@@ -1216,33 +1211,33 @@ declare module '@polkadot/api-base/types/storage' {
       /**
        * The next monotonic queue index to assign to a pending bitcoin mint.
        **/
-      nextPendingMintUtxoIndex: AugmentedQuery<ApiType, () => Observable<u64>, []>;
+      nextPendingBitcoinMintIndex: AugmentedQuery<ApiType, () => Observable<u64>, []>;
       /**
-       * Queue bookkeeping for pending bitcoin mints, including the bounded payout start and the
-       * current frame scan cursor.
+       * Bitcoin UTXOs that have been submitted for minting, keyed by a monotonic queue index so
+       * payouts can preserve FIFO order while each frame works through a fixed payout cohort.
        **/
-      pendingMintQueueState: AugmentedQuery<
+      pendingBitcoinMintsByIndex: AugmentedQuery<
         ApiType,
-        () => Observable<PalletMintMintQueueCursor>,
-        []
+        (arg: u64 | AnyNumber | Uint8Array) => Observable<Option<PalletMintPendingBitcoinMint>>,
+        [u64]
       >;
       /**
        * Reverse lookup from bitcoin UTXO id to all queued mint indices for direct removal and
        * client lookup.
        **/
-      pendingMintUtxoIdLookup: AugmentedQuery<
+      pendingMintIndicesByLockId: AugmentedQuery<
         ApiType,
         (arg: u64 | AnyNumber | Uint8Array) => Observable<Vec<u64>>,
         [u64]
       >;
       /**
-       * Bitcoin UTXOs that have been submitted for minting, keyed by a monotonic queue index so
-       * payouts can preserve FIFO order while each frame works through a fixed payout cohort.
+       * Queue bookkeeping for pending bitcoin mints, including the bounded payout start and the
+       * current frame scan cursor.
        **/
-      pendingMintUtxosByIndex: AugmentedQuery<
+      pendingMintQueueState: AugmentedQuery<
         ApiType,
-        (arg: u64 | AnyNumber | Uint8Array) => Observable<Option<PalletMintPendingMintUtxo>>,
-        [u64]
+        () => Observable<PalletMintMintQueueCursor>,
+        []
       >;
     };
     multisig: {

package/src/interfaces/augment-api-tx.ts

@@ -38,7 +38,7 @@ import type {
   ArgonPrimitivesBitcoinUtxoRef,
   ArgonPrimitivesDomainZoneRecord,
   ArgonPrimitivesEthereumEthereumReceiptLogProofBatch,
-  ArgonPrimitivesInherentsBitcoinUtxoSync,
+  ArgonPrimitivesInherentsBitcoinUtxoSyncV2,
   ArgonPrimitivesInherentsBlockSealInherent,
   ArgonPrimitivesNotaryNotaryMeta,
   ArgonPrimitivesNotebookSignedNotebookHeader,
@@ -295,7 +295,7 @@ declare module '@polkadot/api-base/types/submittable' {
         (
           fissionId: Compact<u64> | AnyNumber | Uint8Array,
           liquidId: Compact<u64> | AnyNumber | Uint8Array,
-          utxoId: Compact<u64> | AnyNumber | Uint8Array,
+          lockId: Compact<u64> | AnyNumber | Uint8Array,
           satoshis: Compact<u64> | AnyNumber | Uint8Array,
           microgonsAtTargetPerBtc: Compact<u128> | AnyNumber | Uint8Array,
         ) => SubmittableExtrinsic<ApiType>,
@@ -339,18 +339,19 @@ declare module '@polkadot/api-base/types/submittable' {
         [AccountId32, ArgonPrimitivesBitcoinUtxoRef, Bytes]
       >;
       /**
-       * Submitted by a Vault operator to cosign the release of a bitcoin UTXO. The Lock's
-       * securitization will be scheduled for release without a penalty.
+       * Submitted by a Vault operator to cosign every input in a Bitcoin Lock release. The
+       * signatures must follow ascending `UtxoRef` order: transaction ID, then output index.
+       * The Lock remains frozen until the exact cosigned transaction is observed on Bitcoin.
        *
        * This is submitted as a no-fee transaction off chain to allow keys to remain in cold
        * wallets.
        **/
       cosignRelease: AugmentedSubmittable<
         (
-          utxoId: u64 | AnyNumber | Uint8Array,
-          signature: Bytes | string | Uint8Array,
+          lockId: u64 | AnyNumber | Uint8Array,
+          signatures: Vec<Bytes> | (Bytes | string | Uint8Array)[],
         ) => SubmittableExtrinsic<ApiType>,
-        [u64, Bytes]
+        [u64, Vec<Bytes>]
       >;
       /**
        * Create a Bitcoin receive address backed by a Lock for the submitting account.
@@ -391,27 +392,28 @@ declare module '@polkadot/api-base/types/submittable' {
         [ArgonPrimitivesBitcoinUtxoRef, Bytes, u64]
       >;
       /**
-       * Submitted by a Bitcoin holder to trigger the release of their Utxo out of the cosign
-       * script. A transaction spending the UTXO should be pre-created so that the sighash
-       * can be submitted here. The vault operator will have 10 days to counter-sign the
-       * transaction. It will be published with the public key as a BitcoinUtxoCosigned Event.
+       * Submitted by a Bitcoin holder to spend every current UTXO in a Lock. The exact external
+       * amount and network fee determine whether the transaction fully releases the Lock or
+       * returns one consolidated change output to the same Lock script. The vault operator has
+       * 10 days to publish one signature per frozen input in a BitcoinUtxoCosigned event.
        *
        * Owner must submit a script pubkey and also a fee to pay to the bitcoin network.
        **/
       requestRelease: AugmentedSubmittable<
         (
-          utxoId: u64 | AnyNumber | Uint8Array,
+          lockId: u64 | AnyNumber | Uint8Array,
           toScriptPubkey: Bytes | string | Uint8Array,
+          destinationSatoshis: u64 | AnyNumber | Uint8Array,
           bitcoinNetworkFee: u64 | AnyNumber | Uint8Array,
         ) => SubmittableExtrinsic<ApiType>,
-        [u64, Bytes, u64]
+        [u64, Bytes, u64, u64]
       >;
       /**
        * Replace this Lock's BTC coverage and target value for its remaining term.
        **/
       resecuritize: AugmentedSubmittable<
         (
-          utxoId: u64 | AnyNumber | Uint8Array,
+          lockId: u64 | AnyNumber | Uint8Array,
           satoshis: Compact<u64> | AnyNumber | Uint8Array,
           options:
             | Option<PalletBitcoinLocksLockOptions>
@@ -425,7 +427,7 @@ declare module '@polkadot/api-base/types/submittable' {
       >;
       setFlexible: AugmentedSubmittable<
         (
-          utxoId: u64 | AnyNumber | Uint8Array,
+          lockId: u64 | AnyNumber | Uint8Array,
           isFlexible: bool | boolean | Uint8Array,
         ) => SubmittableExtrinsic<ApiType>,
         [u64, bool]
@@ -462,12 +464,12 @@ declare module '@polkadot/api-base/types/submittable' {
       sync: AugmentedSubmittable<
         (
           utxoSync:
-            | ArgonPrimitivesInherentsBitcoinUtxoSync
+            | ArgonPrimitivesInherentsBitcoinUtxoSyncV2
             | { spent?: any; funded?: any; syncToBlock?: any }
             | string
             | Uint8Array,
         ) => SubmittableExtrinsic<ApiType>,
-        [ArgonPrimitivesInherentsBitcoinUtxoSync]
+        [ArgonPrimitivesInherentsBitcoinUtxoSyncV2]
       >;
     };
     blockRewards: {