@argonprotocol/mainchain 1.4.10-dev.459cb75f → 1.4.10-dev.4dee3b2f

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@argonprotocol/mainchain",
-  "version": "1.4.10-dev.459cb75f",
+  "version": "1.4.10-dev.4dee3b2f",
   "description": "A client for accessing the Argon mainchain apis.",
   "repository": {
     "type": "git",
@@ -14,11 +14,14 @@
   "homepage": "https://github.com/argonprotocol/mainchain#readme",
   "scripts": {
     "build": "yarn generate:defs && yarn generate:meta && node clean-build.js && yarn tsc",
+    "generate:contract-declarations": "tsc -p tsconfig.contracts.json",
     "generate:defs": "polkadot-types-from-defs --endpoint metadata.json --input ./src/interfaces --package @argonprotocol/mainchain/interfaces",
     "generate:meta": "polkadot-types-from-chain --endpoint metadata.json --output ./src/interfaces --package @argonprotocol/mainchain/interfaces --strict",
     "test": "vitest --run --config vitest.config.ts",
-    "tsc": "yarn workspace @argonprotocol/ethereum-contracts build && tsup",
-    "watch": "tsup --watch",
+    "tsc": "yarn workspace @argonprotocol/ethereum-contracts build && yarn generate:contract-declarations && tsup && yarn validate:package",
+    "tsup": "yarn tsc",
+    "validate:package": "tsx src/scripts/validatePackage.ts",
+    "watch": "yarn generate:contract-declarations && tsup --watch",
     "typecheck": "tsc --noEmit -p tsconfig.test.json"
   },
   "files": [
@@ -65,7 +68,7 @@
   },
   "devDependencies": {
     "@argonprotocol/ethereum-contracts": "workspace:*",
-    "@argonprotocol/testing": "1.4.10-dev.459cb75f",
+    "@argonprotocol/testing": "1.4.10-dev.4dee3b2f",
     "@polkadot/typegen": "^16.5.6",
     "@substrate/ss58-registry": "^1.51.0",
     "@types/node": "^20",

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

@@ -103,7 +103,8 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       maximumSatoshiThresholdFromExpected: u64 & AugmentedConst<ApiType>;
       /**
-       * Maximum bitcoin blocks to watch a Utxo for confirmation before canceling
+       * Maximum bitcoin blocks to accept a UTXO for confirmation. Expired locks remain watched
+       * for this many additional blocks so late funding can be detected as orphaned.
        **/
       maxPendingConfirmationBlocks: u64 & AugmentedConst<ApiType>;
       /**
@@ -160,6 +161,12 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       targetBlockVotes: u128 & AugmentedConst<ApiType>;
     };
+    bootstrap: {
+      /**
+       * Maximum number of bytes in an encrypted recovery or endpoint payload.
+       **/
+      maxEncryptedPayloadLen: u32 & AugmentedConst<ApiType>;
+    };
     crosschainTransfer: {
       /**
        * Minimum remaining frame commitment required when reading vault committed collateral
@@ -370,13 +377,13 @@ declare module '@polkadot/api-base/types/consts' {
        **/
       bitcoinLockSizeForAccessCode: u128 & AugmentedConst<ApiType>;
       /**
-       * Maximum number of available access codes allowed at once.
+       * Maximum number of accrued access codes awarded at one frame boundary.
        **/
-      maxAvailableAccessCodes: u32 & AugmentedConst<ApiType>;
+      maxAccessCodeAwardsPerFrame: u32 & AugmentedConst<ApiType>;
       /**
-       * Maximum number of encrypted server bytes stored per network account.
+       * Maximum number of available access codes allowed at once.
        **/
-      maxEncryptedServerLen: u32 & AugmentedConst<ApiType>;
+      maxAvailableAccessCodes: u32 & AugmentedConst<ApiType>;
       /**
        * Minimum bitcoin amount required to register.
        **/
@@ -468,6 +475,10 @@ declare module '@polkadot/api-base/types/consts' {
        * The maximum number of ticks to preserve a price index
        **/
       maxDowntimeTicksBeforeReset: u64 & AugmentedConst<ApiType>;
+      /**
+       * Maximum number of per-frame Ethereum price buckets to retain.
+       **/
+      maxEthereumPriceHistoryFrames: u32 & AugmentedConst<ApiType>;
       /**
        * The oldest history to keep
        **/
@@ -640,11 +651,6 @@ declare module '@polkadot/api-base/types/consts' {
       batchedCallsLimit: u32 & AugmentedConst<ApiType>;
     };
     vaults: {
-      /**
-       * One no-fee stale `initialize_for` failure is allowed for each this-many units of lost
-       * `available_for_lock`.
-       **/
-      capacityDropAttemptUnit: u128 & AugmentedConst<ApiType>;
       /**
        * Max concurrent cosigns pending per vault
        **/
@@ -653,10 +659,6 @@ declare module '@polkadot/api-base/types/consts' {
        * The max pending vault term changes per block
        **/
       maxPendingTermModificationsPerTick: u32 & AugmentedConst<ApiType>;
-      /**
-       * Maximum number of recent `available_for_lock` drops retained per vault.
-       **/
-      maxRecentCapacityDropsPerVault: u32 & AugmentedConst<ApiType>;
       /**
        * The max number of vaults that can be created
        **/
@@ -669,10 +671,6 @@ declare module '@polkadot/api-base/types/consts' {
        * Minimum vault securitization required while the operational floor lock is active.
        **/
       operationalMinimumVaultSecuritization: u128 & AugmentedConst<ApiType>;
-      /**
-       * Number of Argon blocks to keep recent `available_for_lock` drops for stale init checks.
-       **/
-      recentCapacityDropBlockWindow: u32 & AugmentedConst<ApiType>;
       /**
        * The number of frames within which revenue must be collected
        **/

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

@@ -98,6 +98,30 @@ declare module '@polkadot/api-base/types/errors' {
        * An overflow occurred recording a lock expiration
        **/
       ExpirationAtBlockOverflow: AugmentedError<ApiType>;
+      /**
+       * The fee coupon nonce has already been consumed or superseded.
+       **/
+      FeeCouponAlreadyUsed: AugmentedError<ApiType>;
+      /**
+       * The fee coupon is past its expiration frame.
+       **/
+      FeeCouponExpired: AugmentedError<ApiType>;
+      /**
+       * Fee coupons can only be applied when initializing a lock.
+       **/
+      FeeCouponOnlyForInitialization: AugmentedError<ApiType>;
+      /**
+       * The fee coupon was issued for a different beneficiary.
+       **/
+      FeeCouponWrongAccount: AugmentedError<ApiType>;
+      /**
+       * The fee coupon was issued for a different chain.
+       **/
+      FeeCouponWrongChain: AugmentedError<ApiType>;
+      /**
+       * The fee coupon was issued for a different vault.
+       **/
+      FeeCouponWrongVault: AugmentedError<ApiType>;
       /**
        * Cannot request an orphaned release for the funding UTXO
        **/
@@ -124,6 +148,10 @@ declare module '@polkadot/api-base/types/errors' {
        * The bitcoin script to lock this bitcoin has errors
        **/
       InvalidBitcoinScript: AugmentedError<ApiType>;
+      /**
+       * The fee coupon was not signed by the vault delegate.
+       **/
+      InvalidFeeCouponSignature: AugmentedError<ApiType>;
       /**
        * Funding would result in an overflow of the balance type
        **/
@@ -352,6 +380,20 @@ declare module '@polkadot/api-base/types/errors' {
        **/
       MaxNotebooksAtTickExceeded: AugmentedError<ApiType>;
     };
+    bootstrap: {
+      /**
+       * The encrypted payload exceeds [`Config::MaxEncryptedPayloadLen`].
+       **/
+      EncryptedPayloadTooLong: AugmentedError<ApiType>;
+      /**
+       * The endpoint public key is already owned by a different account.
+       **/
+      EndpointOwnedByAnotherAccount: AugmentedError<ApiType>;
+      /**
+       * The recovery proof does not authorize this writer, public key, and payload.
+       **/
+      InvalidRecoveryProof: AugmentedError<ApiType>;
+    };
     crosschainTransfer: {
       /**
        * The force-set cut would discard a queue entry that already has local quorum.
@@ -990,10 +1032,6 @@ declare module '@polkadot/api-base/types/errors' {
        * An account cannot grant access to itself.
        **/
       CannotGrantAccessToSelf: AugmentedError<ApiType>;
-      /**
-       * The encrypted server payload exceeds the configured max length.
-       **/
-      EncryptedServerTooLong: AugmentedError<ApiType>;
       /**
        * The upstream access proof is invalid.
        **/
@@ -1002,6 +1040,11 @@ declare module '@polkadot/api-base/types/errors' {
        * One of the linked account ownership proofs is invalid.
        **/
       InvalidAccountProof: AugmentedError<ApiType>;
+      /**
+       * Profile names must start with an uppercase ASCII letter and otherwise be ASCII
+       * alphanumeric.
+       **/
+      InvalidName: AugmentedError<ApiType>;
       /**
        * The caller is not one of the accounts included in the registration.
        **/
@@ -1026,10 +1069,6 @@ declare module '@polkadot/api-base/types/errors' {
        * The requested account has not registered operational accounts.
        **/
       NotOperationalAccount: AugmentedError<ApiType>;
-      /**
-       * The caller is not the upstream account for the requested downstream account.
-       **/
-      NotUpstreamOfDownstream: AugmentedError<ApiType>;
       /**
        * A valid invite is required to register an operational account.
        **/
@@ -1110,6 +1149,10 @@ declare module '@polkadot/api-base/types/errors' {
       VestingBalance: AugmentedError<ApiType>;
     };
     priceIndex: {
+      /**
+       * Ethereum prices must be non-zero and correspond to the submitted price-index tick.
+       **/
+      InvalidEthereumPrices: AugmentedError<ApiType>;
       /**
        * Change in argon price is too large
        **/
@@ -1228,6 +1271,10 @@ declare module '@polkadot/api-base/types/errors' {
        * The bond lot is already scheduled for release.
        **/
       BondLotAlreadyReleasing: AugmentedError<ApiType>;
+      /**
+       * Only an active vault bond owned by its operator can be used as backfill.
+       **/
+      BondLotNotEligibleForBackfill: AugmentedError<ApiType>;
       /**
        * The bond lot could not be found.
        **/
@@ -1276,6 +1323,10 @@ declare module '@polkadot/api-base/types/errors' {
        * Too many bond lot releases are scheduled for the same frame.
        **/
       MaxPendingBondReleasesExceeded: AugmentedError<ApiType>;
+      /**
+       * The caller does not have permission to perform this action.
+       **/
+      NoPermissions: AugmentedError<ApiType>;
       /**
        * The caller does not own the bond lot.
        **/
@@ -1357,11 +1408,6 @@ declare module '@polkadot/api-base/types/errors' {
        * Funding would result in an overflow of the balance type
        **/
       InvalidVaultAmount: AugmentedError<ApiType>;
-      /**
-       * Vault names must start with an uppercase ASCII letter and otherwise be ASCII
-       * alphanumeric.
-       **/
-      InvalidVaultName: AugmentedError<ApiType>;
       /**
        * Unable to decode xpubkey
        **/

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

@@ -38,6 +38,8 @@ import type {
   FrameSupportTokensMiscBalanceStatus,
   FrameSystemDispatchEventInfo,
   PalletBalancesUnexpectedKind,
+  PalletBootstrapEndpointPubkey,
+  PalletBootstrapRecoveryPubkey,
   PalletCrosschainTransferAssetKind,
   PalletCrosschainTransferCouncilApprovalTargetId,
   PalletCrosschainTransferGatewayState,
@@ -315,6 +317,11 @@ declare module '@polkadot/api-base/types/events' {
         [utxoId: u64, vaultId: u32, compensationAmount: u128, compensatedAccountId: AccountId32],
         { utxoId: u64; vaultId: u32; compensationAmount: u128; compensatedAccountId: AccountId32 }
       >;
+      BitcoinLockBackfillChanged: AugmentedEvent<
+        ApiType,
+        [utxoId: u64, vaultId: u32, isBackfill: bool],
+        { utxoId: u64; vaultId: u32; isBackfill: bool }
+      >;
       BitcoinLockBurned: AugmentedEvent<
         ApiType,
         [utxoId: u64, vaultId: u32, wasUtxoSpent: bool],
@@ -530,6 +537,24 @@ declare module '@polkadot/api-base/types/events' {
         }
       >;
     };
+    bootstrap: {
+      /**
+       * An encrypted endpoint payload was stored or replaced by its owner.
+       **/
+      EndpointUpdated: AugmentedEvent<
+        ApiType,
+        [endpointOwner: AccountId32, endpointPubkey: PalletBootstrapEndpointPubkey],
+        { endpointOwner: AccountId32; endpointPubkey: PalletBootstrapEndpointPubkey }
+      >;
+      /**
+       * An encrypted recovery payload was stored or replaced.
+       **/
+      RecoveryPayloadUpdated: AugmentedEvent<
+        ApiType,
+        [writer: AccountId32, recoveryPubkey: PalletBootstrapRecoveryPubkey],
+        { writer: AccountId32; recoveryPubkey: PalletBootstrapRecoveryPubkey }
+      >;
+    };
     crosschainTransfer: {
       /**
        * An account registered its council signer for one destination chain.
@@ -1273,14 +1298,6 @@ declare module '@polkadot/api-base/types/events' {
         [account: AccountId32],
         { account: AccountId32 }
       >;
-      /**
-       * An upstream account updated the encrypted server payload for a downstream account.
-       **/
-      EncryptedServerUpdated: AugmentedEvent<
-        ApiType,
-        [upstreamAccount: AccountId32, downstreamAccount: AccountId32],
-        { upstreamAccount: AccountId32; downstreamAccount: AccountId32 }
-      >;
       /**
        * An operational account was registered with its linked accounts.
        **/
@@ -1830,6 +1847,16 @@ declare module '@polkadot/api-base/types/events' {
       >;
     };
     treasury: {
+      BackfillBondsReservedChanged: AugmentedEvent<
+        ApiType,
+        [vaultId: u32, backfillBondsReserved: u32],
+        { vaultId: u32; backfillBondsReserved: u32 }
+      >;
+      BondLotBackfillChanged: AugmentedEvent<
+        ApiType,
+        [vaultId: u32, bondLotId: u64, isBackfill: bool],
+        { vaultId: u32; bondLotId: u64; isBackfill: bool }
+      >;
       /**
        * A bond purchase entered its active program set.
        **/
@@ -2074,6 +2101,11 @@ declare module '@polkadot/api-base/types/events' {
       >;
     };
     vaults: {
+      BackfillSecuritizationReservedChanged: AugmentedEvent<
+        ApiType,
+        [vaultId: u32, backfillSecuritizationReserved: u128],
+        { vaultId: u32; backfillSecuritizationReserved: u128 }
+      >;
       CommittedArgonotsSet: AugmentedEvent<
         ApiType,
         [vaultId: u32, operatorAccountId: AccountId32, amount: u128],

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

@@ -66,6 +66,8 @@ import type {
   PalletBitcoinLocksLockReleaseRequest,
   PalletBitcoinLocksLockedBitcoin,
   PalletBitcoinLocksOrphanedUtxo,
+  PalletBootstrapEndpointPubkey,
+  PalletBootstrapRecoveryPubkey,
   PalletCrosschainTransferAccountTransferTotals,
   PalletCrosschainTransferChainConfig,
   PalletCrosschainTransferCouncilApprovalQueueEntry,
@@ -96,6 +98,8 @@ import type {
   PalletOperationalAccountsRewardsConfig,
   PalletPriceIndexArgonotAverageFrameAccumulator,
   PalletPriceIndexCpiMeasurementBucket,
+  PalletPriceIndexEthereumPriceFrameAccumulator,
+  PalletPriceIndexEthereumPriceIndex,
   PalletPriceIndexPriceIndex,
   PalletProxyAnnouncement,
   PalletProxyProxyDefinition,
@@ -104,7 +108,7 @@ import type {
   PalletTreasuryBondLotSummary,
   PalletTreasuryFrameArgonotBondParticipants,
   PalletTreasuryFrameVaultCapital,
-  PalletVaultsRecentCapacityDrop,
+  PalletTreasuryVaultBondState,
   PalletVaultsVaultFrameRevenue,
   SpConsensusGrandpaAppPublic,
   SpRuntimeDigest,
@@ -206,6 +210,14 @@ declare module '@polkadot/api-base/types/storage' {
       totalIssuance: AugmentedQuery<ApiType, () => Observable<u128>, []>;
     };
     bitcoinLocks: {
+      lastFeeCouponNonceByVaultAndAccount: AugmentedQuery<
+        ApiType,
+        (
+          arg1: u32 | AnyNumber | Uint8Array,
+          arg2: AccountId32 | string | Uint8Array,
+        ) => Observable<Option<u64>>,
+        [u32, AccountId32]
+      >;
       /**
        * Utxos that have been requested to be cosigned for releasing
        **/
@@ -338,7 +350,8 @@ declare module '@polkadot/api-base/types/storage' {
         []
       >;
       /**
-       * Pending funding entries that have expired and are awaiting bounded cleanup.
+       * Pending funding entries that have expired. These remain watched until their additional
+       * orphan-detection window ends, then await bounded cleanup.
        **/
       expiredPendingFunding: AugmentedQuery<
         ApiType,
@@ -512,6 +525,40 @@ declare module '@polkadot/api-base/types/storage' {
        **/
       voteMinimumHistory: AugmentedQuery<ApiType, () => Observable<Vec<u128>>, []>;
     };
+    bootstrap: {
+      /**
+       * Encrypted endpoint payload keyed by its public key.
+       *
+       * The pallet enforces ownership and length but does not parse or verify encryption.
+       **/
+      encryptedEndpointByPubkey: AugmentedQuery<
+        ApiType,
+        (arg: PalletBootstrapEndpointPubkey | string | Uint8Array) => Observable<Option<Bytes>>,
+        [PalletBootstrapEndpointPubkey]
+      >;
+      /**
+       * Encrypted recovery payload authorized by the corresponding recovery key.
+       *
+       * The pallet enforces authorization and length but does not parse or verify encryption.
+       **/
+      encryptedRecoveryPayloadByPubkey: AugmentedQuery<
+        ApiType,
+        (arg: PalletBootstrapRecoveryPubkey | string | Uint8Array) => Observable<Option<Bytes>>,
+        [PalletBootstrapRecoveryPubkey]
+      >;
+      /**
+       * Account authorized to update an encrypted endpoint payload.
+       *
+       * The first successful [`Pallet::set_endpoint`] call for a public key establishes its owner.
+       **/
+      endpointOwnerByPubkey: AugmentedQuery<
+        ApiType,
+        (
+          arg: PalletBootstrapEndpointPubkey | string | Uint8Array,
+        ) => Observable<Option<AccountId32>>,
+        [PalletBootstrapEndpointPubkey]
+      >;
+    };
     crosschainTransfer: {
       /**
        * The active Global Issuance Council hash in force for each destination chain.
@@ -1272,13 +1319,18 @@ declare module '@polkadot/api-base/types/storage' {
     };
     operationalAccounts: {
       /**
-       * Opaque encrypted upstream server payload keyed by the downstream account.
+       * Set of operational accounts that have met both follow-on access-code thresholds.
+       * The key count weights frame processing without scanning the set twice.
        **/
-      encryptedServerByDownstreamAccount: AugmentedQuery<
+      accessCodeReadyAccounts: AugmentedQuery<
         ApiType,
-        (arg: AccountId32 | string | Uint8Array) => Observable<Option<Bytes>>,
+        (arg: AccountId32 | string | Uint8Array) => Observable<Option<Null>>,
         [AccountId32]
       >;
+      /**
+       * Counter for the related counted storage map
+       **/
+      counterForAccessCodeReadyAccounts: AugmentedQuery<ApiType, () => Observable<u32>, []>;
       /**
        * Whether operational-account access is invite-only.
        *
@@ -1403,6 +1455,14 @@ declare module '@polkadot/api-base/types/storage' {
        * Stores the active price index
        **/
       current: AugmentedQuery<ApiType, () => Observable<Option<PalletPriceIndexPriceIndex>>, []>;
+      /**
+       * Stores the latest submitted Ethereum pricing.
+       **/
+      currentEthereumPrice: AugmentedQuery<
+        ApiType,
+        () => Observable<Option<PalletPriceIndexEthereumPriceIndex>>,
+        []
+      >;
       /**
        * Accumulates the current frame's Argonot price samples until the frame closes.
        **/
@@ -1435,6 +1495,14 @@ declare module '@polkadot/api-base/types/storage' {
         () => Observable<BTreeMap<u64, u128>>,
         []
       >;
+      /**
+       * Stores per-frame Ethereum price totals used for the trailing averages.
+       **/
+      historicEthereumPricesByFrame: AugmentedQuery<
+        ApiType,
+        () => Observable<BTreeMap<u64, PalletPriceIndexEthereumPriceFrameAccumulator>>,
+        []
+      >;
       /**
        * Stores the last valid price index
        **/
@@ -1659,7 +1727,8 @@ declare module '@polkadot/api-base/types/storage' {
     };
     treasury: {
       /**
-       * The active top Argonot bond lots kept in ascending bond order, then lower ids first.
+       * The active Argonot set keeps the smallest bond amount first, then lower ids first when
+       * amounts tie.
        **/
       argonotBondLots: AugmentedQuery<
         ApiType,
@@ -1686,13 +1755,15 @@ declare module '@polkadot/api-base/types/storage' {
         [AccountId32, u64]
       >;
       /**
-       * The accepted bond lots for a vault.
+       * The active bond state for a vault.
        *
-       * Lots are kept in descending bond order, then lower `bond_lot_id` first for ties.
+       * The bounded payout set keeps the largest bond amount first, then lower `bond_lot_id` first
+       * when amounts tie. Backfill lots remain in `BondLotById` and are represented here by their
+       * aggregate.
        **/
       bondLotsByVault: AugmentedQuery<
         ApiType,
-        (arg: u32 | AnyNumber | Uint8Array) => Observable<Vec<PalletTreasuryBondLotSummary>>,
+        (arg: u32 | AnyNumber | Uint8Array) => Observable<PalletTreasuryVaultBondState>,
         [u32]
       >;
       /**
@@ -1809,14 +1880,6 @@ declare module '@polkadot/api-base/types/storage' {
         (arg: u64 | AnyNumber | Uint8Array) => Observable<Vec<u32>>,
         [u64]
       >;
-      /**
-       * Recent reductions in `available_for_lock`, grouped by vault.
-       **/
-      recentCapacityDropsByVault: AugmentedQuery<
-        ApiType,
-        (arg: u32 | AnyNumber | Uint8Array) => Observable<Vec<PalletVaultsRecentCapacityDrop>>,
-        [u32]
-      >;
       /**
        * Tracks revenue from Bitcoin Locks and Treasury Pools for the trailing frames for each vault
        * (a frame is a "mining day" in Argon). Newest frames are first. Frames are removed after the