@argonprotocol/mainchain 1.4.8 → 1.4.9-dev.5ffdfd6a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@argonprotocol/mainchain",
-  "version": "1.4.8",
+  "version": "1.4.9-dev.5ffdfd6a",
   "description": "A client for accessing the Argon mainchain apis.",
   "repository": {
     "type": "git",
@@ -65,7 +65,7 @@
   },
   "devDependencies": {
     "@argonprotocol/ethereum-contracts": "workspace:*",
-    "@argonprotocol/testing": "1.4.8",
+    "@argonprotocol/testing": "1.4.9-dev.5ffdfd6a",
     "@polkadot/typegen": "^16.5.6",
     "@substrate/ss58-registry": "^1.51.0",
     "@types/node": "^20",

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

@@ -209,11 +209,6 @@ declare module '@polkadot/api-base/types/consts' {
        * completes the remaining uncovered amount.
        **/
       minTransferCollateralIncrement: u128 & AugmentedConst<ApiType>;
-      /**
-       * Retention window, in ticks, for recent Argon transfer evidence used by operational
-       * accounts.
-       **/
-      recentTransferRetentionTicks: u64 & AugmentedConst<ApiType>;
       /**
        * Minting authority tip rate applied to transfer-out requests in basis points.
        **/
@@ -301,14 +296,25 @@ declare module '@polkadot/api-base/types/consts' {
       targetPricePerSeat: u128 & AugmentedConst<ApiType>;
     };
     mint: {
+      /**
+       * The maximum share of a queued bitcoin mint that may be paid in a single frame.
+       **/
+      bitcoinMintPayoutPercentPerFrame: Percent & AugmentedConst<ApiType>;
       /**
        * The maximum number of mint histories to keep
        **/
       maxMintHistoryToMaintain: u32 & AugmentedConst<ApiType>;
       /**
-       * The maximum number of UTXOs that can be waiting for minting
+       * The maximum number of queued bitcoin mints that may receive payouts in a frame.
+       **/
+      maxPendingMintPayoutWindowSize: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of queued mint entries a single bitcoin UTXO may accumulate.
+       **/
+      maxPendingMintsPerUtxo: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum number of miners that can be paid in a frame.
        **/
-      maxPendingMintUtxos: u32 & AugmentedConst<ApiType>;
       maxPossibleMiners: u32 & AugmentedConst<ApiType>;
     };
     multisig: {
@@ -359,45 +365,58 @@ declare module '@polkadot/api-base/types/consts' {
     };
     operationalAccounts: {
       /**
-       * Additional argon amount (base units) required per referral after operational.
+       * Additional argon amount (base units) required per follow-on upgrade code after
+       * operational certification.
        **/
-      bitcoinLockSizeForReferral: u128 & AugmentedConst<ApiType>;
+      bitcoinLockSizeForUpgradeCode: u128 & AugmentedConst<ApiType>;
       /**
-       * Maximum number of available referrals allowed at once.
+       * Maximum number of available upgrade codes allowed at once.
        **/
-      maxAvailableReferrals: u32 & AugmentedConst<ApiType>;
+      maxAvailableUpgradeCodes: u32 & AugmentedConst<ApiType>;
       /**
-       * Maximum number of encrypted server bytes stored per sponsee.
+       * Maximum number of encrypted server bytes stored per network account.
        **/
       maxEncryptedServerLen: u32 & AugmentedConst<ApiType>;
-      /**
-       * Maximum number of expired referral codes cleared per block.
-       **/
-      maxExpiredReferralCodeCleanupsPerBlock: u32 & AugmentedConst<ApiType>;
       /**
        * Mining seats required to become operational.
        **/
       miningSeatsForOperational: u32 & AugmentedConst<ApiType>;
       /**
-       * Mining seats required per referral after operational.
+       * Mining seats required per follow-on upgrade code after operational certification.
+       **/
+      miningSeatsPerUpgradeCode: u32 & AugmentedConst<ApiType>;
+      /**
+       * Default reward paid when an account becomes operational.
+       **/
+      operationalActivationReward: u128 & AugmentedConst<ApiType>;
+      /**
+       * Minimum total Uniswap transfer amount required for operational certification.
        **/
-      miningSeatsPerReferral: u32 & AugmentedConst<ApiType>;
+      operationalMinimumUniswapTransfer: u128 & AugmentedConst<ApiType>;
       /**
        * Minimum vault securitization required to become operational.
        **/
       operationalMinimumVaultSecuritization: u128 & AugmentedConst<ApiType>;
       /**
-       * Default bonus reward paid every referral threshold.
+       * Default bonus reward paid every operational referral threshold.
        **/
       operationalReferralBonusReward: u128 & AugmentedConst<ApiType>;
       /**
-       * Default reward paid when an account becomes operational.
+       * Number of operational referrals required per bonus reward.
+       **/
+      operationalReferralsPerBonusReward: u32 & AugmentedConst<ApiType>;
+      /**
+       * Minimum bitcoin amount required for treasury certification.
+       **/
+      treasuryMinimumBitcoin: u128 & AugmentedConst<ApiType>;
+      /**
+       * Minimum bond amount required for treasury certification.
        **/
-      operationalReferralReward: u128 & AugmentedConst<ApiType>;
+      treasuryMinimumBonds: u128 & AugmentedConst<ApiType>;
       /**
-       * Number of operational sponsees required per referral bonus reward.
+       * Minimum Uniswap transfer amount required for treasury certification.
        **/
-      referralBonusEveryXOperationalSponsees: u32 & AugmentedConst<ApiType>;
+      treasuryMinimumUniswapTransfer: u128 & AugmentedConst<ApiType>;
     };
     ownership: {
       /**
@@ -560,6 +579,14 @@ declare module '@polkadot/api-base/types/consts' {
       operationalFeeMultiplier: u8 & AugmentedConst<ApiType>;
     };
     treasury: {
+      /**
+       * The maximum number of active Argonot bond lots.
+       **/
+      maxActiveArgonotBondLots: u32 & AugmentedConst<ApiType>;
+      /**
+       * The maximum percent of ownership-token circulation that can be bonded.
+       **/
+      maxArgonotBondedPercentOfCirculation: Percent & AugmentedConst<ApiType>;
       /**
        * The maximum number of bond lots whose release delay may mature in a single frame.
        **/
@@ -580,6 +607,10 @@ declare module '@polkadot/api-base/types/consts' {
        * Treasury pallet id retained in metadata for account derivation.
        **/
       palletId: FrameSupportPalletId & AugmentedConst<ApiType>;
+      /**
+       * Percent of the full bid pool paid to Argonot bonds before vault distribution.
+       **/
+      percentForArgonotBondPool: Percent & AugmentedConst<ApiType>;
       /**
        * Percent of the bid pool reserved for treasury reserves.
        **/

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

@@ -790,6 +790,10 @@ declare module '@polkadot/api-base/types/errors' {
        * Bids must be in allowed increments
        **/
       InvalidBidAmount: AugmentedError<ApiType>;
+      /**
+       * Mining slot bidding currently requires a prior operational-account upgrade.
+       **/
+      OperationalAccountRegistrationRequired: AugmentedError<ApiType>;
       /**
        * Bidding for the next cohort has closed
        **/
@@ -970,6 +974,10 @@ declare module '@polkadot/api-base/types/errors' {
        * One of the provided accounts is already linked to an operational account.
        **/
       AccountAlreadyLinked: AugmentedError<ApiType>;
+      /**
+       * The requested account is already upgraded to operational.
+       **/
+      AccountAlreadyUpgraded: AugmentedError<ApiType>;
       /**
        * The account is already operational.
        **/
@@ -978,6 +986,10 @@ declare module '@polkadot/api-base/types/errors' {
        * The caller already registered an operational account.
        **/
       AlreadyRegistered: AugmentedError<ApiType>;
+      /**
+       * An account cannot upgrade itself.
+       **/
+      CannotUpgradeSelf: AugmentedError<ApiType>;
       /**
        * The encrypted server payload exceeds the configured max length.
        **/
@@ -986,14 +998,14 @@ declare module '@polkadot/api-base/types/errors' {
        * One of the linked account ownership proofs is invalid.
        **/
       InvalidAccountProof: AugmentedError<ApiType>;
-      /**
-       * The referral proof or sponsor proof is invalid.
-       **/
-      InvalidReferralProof: AugmentedError<ApiType>;
       /**
        * The caller is not one of the accounts included in the registration.
        **/
       InvalidRegistrationSubmitter: AugmentedError<ApiType>;
+      /**
+       * The requested referrer does not have an available upgrade to spend.
+       **/
+      NoAvailableUpgrades: AugmentedError<ApiType>;
       /**
        * The operational account has no pending rewards to claim.
        **/
@@ -1007,17 +1019,29 @@ declare module '@polkadot/api-base/types/errors' {
        **/
       NotEligibleForActivation: AugmentedError<ApiType>;
       /**
-       * The caller has not registered an operational account.
+       * The requested account has not registered operational accounts.
        **/
       NotOperationalAccount: AugmentedError<ApiType>;
       /**
-       * The caller is not the sponsor of the requested sponsee.
+       * The caller is not the referrer of the requested downstream account.
+       **/
+      NotReferrerOfAccount: AugmentedError<ApiType>;
+      /**
+       * The requested account has not reached treasury certification.
        **/
-      NotSponsorOfSponsee: AugmentedError<ApiType>;
+      NotTreasuryCertified: AugmentedError<ApiType>;
       /**
-       * The referral proof has expired.
+       * The requested referrer does not have a registered operational account.
        **/
-      ReferralProofExpired: AugmentedError<ApiType>;
+      ReferrerNotOperationalAccount: AugmentedError<ApiType>;
+      /**
+       * The requested referrer does not match the referrer recorded during registration.
+       **/
+      RegisteredReferrerMismatch: AugmentedError<ApiType>;
+      /**
+       * A valid invite is required to register an operational account.
+       **/
+      RegistrationInviteRequired: AugmentedError<ApiType>;
       /**
        * Reward claims must be at least one Argon.
        **/
@@ -1030,6 +1054,10 @@ declare module '@polkadot/api-base/types/errors' {
        * Reward claims must be whole Argon increments.
        **/
       RewardClaimNotWholeArgon: AugmentedError<ApiType>;
+      /**
+       * The requested account no longer satisfies treasury certification requirements.
+       **/
+      TreasuryCertificationNoLongerMet: AugmentedError<ApiType>;
       /**
        * The treasury does not currently have enough available reserves for the claim.
        **/
@@ -1192,6 +1220,14 @@ declare module '@polkadot/api-base/types/errors' {
        * treasury backing.
        **/
       ActiveBondAmountBelowEncumberedBacking: AugmentedError<ApiType>;
+      /**
+       * The Argonot bond purchase would exceed the active circulation cap.
+       **/
+      ArgonotBondPurchaseAboveCap: AugmentedError<ApiType>;
+      /**
+       * The Argonot bond purchase did not beat the current active-set cutoff.
+       **/
+      ArgonotBondPurchaseBelowCutoff: AugmentedError<ApiType>;
       /**
        * The bond lot is already scheduled for release.
        **/
@@ -1343,6 +1379,10 @@ declare module '@polkadot/api-base/types/errors' {
        * No Vault public keys are available
        **/
       NoVaultBitcoinPubkeysAvailable: AugmentedError<ApiType>;
+      /**
+       * Vault creation currently requires a prior operational-account upgrade.
+       **/
+      OperationalAccountRegistrationRequired: AugmentedError<ApiType>;
       /**
        * A vault must clear out all overdue external collect blockers before it can collect.
        **/

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

@@ -49,6 +49,7 @@ import type {
   PalletMintMintType,
   PalletMultisigTimepoint,
   PalletProxyDepositKind,
+  PalletTreasuryBondProgramId,
   PalletTreasuryBondReleaseReason,
   SpConsensusGrandpaAppPublic,
   SpRuntimeDispatchError,
@@ -1240,6 +1241,22 @@ declare module '@polkadot/api-base/types/events' {
       >;
     };
     operationalAccounts: {
+      /**
+       * Account has become treasury certified.
+       **/
+      AccountBecameTreasuryCertified: AugmentedEvent<
+        ApiType,
+        [account: AccountId32],
+        { account: AccountId32 }
+      >;
+      /**
+       * A referrer granted an operational upgrade to an existing account.
+       **/
+      AccountUpgradeGranted: AugmentedEvent<
+        ApiType,
+        [account: AccountId32, referrer: AccountId32],
+        { account: AccountId32; referrer: AccountId32 }
+      >;
       /**
        * Account has become operational.
        **/
@@ -1249,12 +1266,12 @@ declare module '@polkadot/api-base/types/events' {
         { account: AccountId32 }
       >;
       /**
-       * A sponsor updated the encrypted server payload for a sponsee.
+       * A referrer updated the encrypted server payload for a downstream account.
        **/
       EncryptedServerUpdated: AugmentedEvent<
         ApiType,
-        [sponsor: AccountId32, sponsee: AccountId32],
-        { sponsor: AccountId32; sponsee: AccountId32 }
+        [referrer: AccountId32, downstreamAccount: AccountId32],
+        { referrer: AccountId32; downstreamAccount: AccountId32 }
       >;
       /**
        * An operational account was registered with its linked accounts.
@@ -1264,16 +1281,14 @@ declare module '@polkadot/api-base/types/events' {
         [
           operationalAccount: AccountId32,
           vaultAccount: AccountId32,
-          miningFundingAccount: AccountId32,
-          miningBotAccount: AccountId32,
-          sponsor: Option<AccountId32>,
+          miningAccount: AccountId32,
+          referrer: Option<AccountId32>,
         ],
         {
           operationalAccount: AccountId32;
           vaultAccount: AccountId32;
-          miningFundingAccount: AccountId32;
-          miningBotAccount: AccountId32;
-          sponsor: Option<AccountId32>;
+          miningAccount: AccountId32;
+          referrer: Option<AccountId32>;
         }
       >;
       /**
@@ -1284,20 +1299,24 @@ declare module '@polkadot/api-base/types/events' {
         [
           account: AccountId32,
           updateOperationalProgress: bool,
-          hasUniswapTransfer: bool,
+          isTreasuryCertified: bool,
+          uniswapArgonTransfersInAmount: u128,
+          accountBitcoinAmount: u128,
+          accountVaultBondAmount: u128,
           vaultCreated: bool,
-          hasTreasuryPoolParticipation: bool,
-          observedBitcoinTotal: u128,
-          observedMiningSeatTotal: u32,
+          operatorVaultBitcoinAmount: u128,
+          miningSeatCount: u32,
         ],
         {
           account: AccountId32;
           updateOperationalProgress: bool;
-          hasUniswapTransfer: bool;
+          isTreasuryCertified: bool;
+          uniswapArgonTransfersInAmount: u128;
+          accountBitcoinAmount: u128;
+          accountVaultBondAmount: u128;
           vaultCreated: bool;
-          hasTreasuryPoolParticipation: bool;
-          observedBitcoinTotal: u128;
-          observedMiningSeatTotal: u32;
+          operatorVaultBitcoinAmount: u128;
+          miningSeatCount: u32;
         }
       >;
       /**
@@ -1339,8 +1358,8 @@ declare module '@polkadot/api-base/types/events' {
        **/
       RewardsConfigUpdated: AugmentedEvent<
         ApiType,
-        [operationalReferralReward: u128, referralBonusReward: u128],
-        { operationalReferralReward: u128; referralBonusReward: u128 }
+        [operationalActivationReward: u128, operationalReferralBonusReward: u128],
+        { operationalActivationReward: u128; operationalReferralBonusReward: u128 }
       >;
     };
     ownership: {
@@ -1804,20 +1823,42 @@ declare module '@polkadot/api-base/types/events' {
     };
     treasury: {
       /**
-       * A bond purchase entered a vault's accepted list.
+       * A bond purchase entered its active program set.
        **/
       BondLotPurchased: AugmentedEvent<
         ApiType,
-        [vaultId: u32, bondLotId: u64, accountId: AccountId32, bonds: u32],
-        { vaultId: u32; bondLotId: u64; accountId: AccountId32; bonds: u32 }
+        [
+          programId: PalletTreasuryBondProgramId,
+          bondLotId: u64,
+          accountId: AccountId32,
+          bonds: u32,
+        ],
+        {
+          programId: PalletTreasuryBondProgramId;
+          bondLotId: u64;
+          accountId: AccountId32;
+          bonds: u32;
+        }
       >;
       /**
        * A bond lot was released.
        **/
       BondLotReleased: AugmentedEvent<
         ApiType,
-        [frameId: u64, vaultId: u32, bondLotId: u64, accountId: AccountId32, bonds: u32],
-        { frameId: u64; vaultId: u32; bondLotId: u64; accountId: AccountId32; bonds: u32 }
+        [
+          frameId: u64,
+          programId: PalletTreasuryBondProgramId,
+          bondLotId: u64,
+          accountId: AccountId32,
+          bonds: u32,
+        ],
+        {
+          frameId: u64;
+          programId: PalletTreasuryBondProgramId;
+          bondLotId: u64;
+          accountId: AccountId32;
+          bonds: u32;
+        }
       >;
       /**
        * A bond lot was removed from future frames and scheduled for release.
@@ -1825,7 +1866,7 @@ declare module '@polkadot/api-base/types/events' {
       BondLotReleaseScheduled: AugmentedEvent<
         ApiType,
         [
-          vaultId: u32,
+          programId: PalletTreasuryBondProgramId,
           bondLotId: u64,
           accountId: AccountId32,
           bonds: u32,
@@ -1833,7 +1874,7 @@ declare module '@polkadot/api-base/types/events' {
           reason: PalletTreasuryBondReleaseReason,
         ],
         {
-          vaultId: u32;
+          programId: PalletTreasuryBondProgramId;
           bondLotId: u64;
           accountId: AccountId32;
           bonds: u32;
@@ -1841,6 +1882,26 @@ declare module '@polkadot/api-base/types/events' {
           reason: PalletTreasuryBondReleaseReason;
         }
       >;
+      /**
+       * An error occurred while paying frame earnings for an Argonot bond lot.
+       **/
+      CouldNotDistributeEarningsToArgonotBondLot: AugmentedEvent<
+        ApiType,
+        [
+          frameId: u64,
+          bondLotId: u64,
+          accountId: AccountId32,
+          amount: u128,
+          dispatchError: SpRuntimeDispatchError,
+        ],
+        {
+          frameId: u64;
+          bondLotId: u64;
+          accountId: AccountId32;
+          amount: u128;
+          dispatchError: SpRuntimeDispatchError;
+        }
+      >;
       /**
        * An error occurred while paying frame earnings for a bond lot.
        **/
@@ -1870,7 +1931,7 @@ declare module '@polkadot/api-base/types/events' {
         ApiType,
         [
           frameId: u64,
-          vaultId: u32,
+          programId: PalletTreasuryBondProgramId,
           bondLotId: u64,
           amount: u128,
           accountId: AccountId32,
@@ -1878,7 +1939,7 @@ declare module '@polkadot/api-base/types/events' {
         ],
         {
           frameId: u64;
-          vaultId: u32;
+          programId: PalletTreasuryBondProgramId;
           bondLotId: u64;
           amount: u128;
           accountId: AccountId32;
@@ -1907,8 +1968,24 @@ declare module '@polkadot/api-base/types/events' {
        **/
       FrameEarningsDistributed: AugmentedEvent<
         ApiType,
-        [frameId: u64, bidPoolDistributed: u128, treasuryReserves: u128, participatingVaults: u32],
-        { frameId: u64; bidPoolDistributed: u128; treasuryReserves: u128; participatingVaults: u32 }
+        [
+          frameId: u64,
+          bidPoolDistributed: u128,
+          argonotBondPoolDistributed: u128,
+          vaultBidPoolDistributed: u128,
+          treasuryRefunds: u128,
+          treasuryReserves: u128,
+          participatingVaults: u32,
+        ],
+        {
+          frameId: u64;
+          bidPoolDistributed: u128;
+          argonotBondPoolDistributed: u128;
+          vaultBidPoolDistributed: u128;
+          treasuryRefunds: u128;
+          treasuryReserves: u128;
+          participatingVaults: u32;
+        }
       >;
       /**
        * The current frame's vault capital was locked in.