@polymeshassociation/polymesh-sdk 31.1.0-beta.2 → 31.1.0-beta.20

package/api/procedures/updateBondedPolyx.d.ts

@@ -17,15 +17,26 @@ export type Params = UpdatePolyxBondParams & ({
     type: 'unbond';
 } | {
     type: 'bondExtra';
+} | {
+    type: 'rebond';
 });
 /**
  * @hidden
  */
-export declare function prepareUnbondPolyx(this: Procedure<Params, void, Storage>, args: Params): Promise<TransactionSpec<void, ExtrinsicParams<'staking', 'unbond'>> | TransactionSpec<void, ExtrinsicParams<'staking', 'bondExtra'>>>;
+export declare function prepareUnbondPolyx(this: Procedure<Params, void, Storage>, args: Params): Promise<TransactionSpec<void, ExtrinsicParams<'staking', 'unbond'>> | TransactionSpec<void, ExtrinsicParams<'staking', 'bondExtra'>> | TransactionSpec<void, ExtrinsicParams<'staking', 'rebond'>>>;
 /**
  * @hidden
+ *
+ * The staking pallet does not consult a signer's `ExtrinsicPermissions` — no Substrate pallet in
+ *   the Polymesh runtime does — so no permission is required to run this, for a secondary key or
+ *   an external agent alike.
+ *
+ * `true` rather than empty arrays: an empty `SimplePermissions` still routes through
+ *   `Account.checkPermissions`, which reads the key's permissions from chain and **throws** for an
+ *   Account with no Identity. That turns a check that should be a no-op into a failure, and costs
+ *   a query either way.
  */
-export declare function getAuthorization(this: Procedure<Params, void, Storage>, args: Params): ProcedureAuthorization;
+export declare function getAuthorization(this: Procedure<Params, void, Storage>): ProcedureAuthorization;
 /**
  * @hidden
  */

package/api/procedures/updateBondedPolyx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateBondedPolyx.d.ts","sourceRoot":"","sources":["../../../src/api/procedures/updateBondedPolyx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAa,aAAa,EAAU,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG5F;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,qBAAqB,GAAG,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAE1F;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EACtC,IAAI,EAAE,MAAM,GACX,OAAO,CACN,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,GAC3D,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CACjE,CAuEA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EACtC,IAAI,EAAE,MAAM,GACX,sBAAsB,CAWxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB7F;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CACC,CAAC"}
+{"version":3,"file":"updateBondedPolyx.d.ts","sourceRoot":"","sources":["../../../src/api/procedures/updateBondedPolyx.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAa,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG5F;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,qBAAqB,GACxC,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAqHpE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EACtC,IAAI,EAAE,MAAM,GACX,OAAO,CACN,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,GAC3D,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,GAC9D,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAC9D,CAmCA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,sBAAsB,CAI/F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB7F;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CACC,CAAC"}

package/api/procedures/updateBondedPolyx.js

@@ -8,62 +8,122 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateBondedPolyx = void 0;
 exports.prepareUnbondPolyx = prepareUnbondPolyx;
 exports.getAuthorization = getAuthorization;
 exports.prepareStorage = prepareStorage;
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
 const internal_1 = require("../../internal");
 const types_1 = require("../../types");
 const conversion_1 = require("../../utils/conversion");
+/**
+ * @hidden
+ *
+ * @throws if the acting account controls no bond
+ */
+function assertControllerEntry(controllerEntry, actingAccount) {
+    if (!controllerEntry) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.UnmetPrerequisite,
+            message: 'The caller must be a controller account',
+            data: { actingAccount: actingAccount.address },
+        });
+    }
+    return controllerEntry;
+}
+/**
+ * @hidden
+ *
+ * @throws if `amount` cannot be rebonded
+ */
+function assertRebondable(amount, controllerEntry, actingAccount) {
+    const { unlocking } = assertControllerEntry(controllerEntry, actingAccount);
+    /* the chain refuses a rebond with nothing unbonding, whatever the amount */
+    if (!unlocking.length) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.UnmetPrerequisite,
+            message: 'There is no unbonding POLYX to rebond',
+            data: { actingAccount: actingAccount.address },
+        });
+    }
+    const unlockingTotal = unlocking.reduce((total, { value }) => total.plus(value), new bignumber_js_1.default(0));
+    if (unlockingTotal.lt(amount)) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.InsufficientBalance,
+            message: 'Insufficient unbonding POLYX',
+            data: {
+                amount: amount.toString(),
+                unlocking: unlockingTotal.toString(),
+                actingAccount: actingAccount.address,
+            },
+        });
+    }
+}
+/**
+ * @hidden
+ *
+ * @throws if `amount` cannot be unbonded
+ */
+function assertUnbondable(amount, controllerEntry, actingAccount) {
+    const { active } = assertControllerEntry(controllerEntry, actingAccount);
+    if (active.lt(amount)) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.InsufficientBalance,
+            message: 'Insufficient bonded POLYX',
+            data: {
+                amount: amount.toString(),
+                active: active.toString(),
+                actingAccount: actingAccount.address,
+            },
+        });
+    }
+}
+/**
+ * @hidden
+ *
+ * @throws if `amount` cannot be added to an existing bond
+ */
+function assertBondExtraPossible(amount, actingBalance, isStash, actingAccount) {
+    if (!isStash) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.UnmetPrerequisite,
+            message: 'The caller must be a stash account',
+            data: { actingAccount: actingAccount.address },
+        });
+    }
+    if (actingBalance.free.lt(amount)) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.InsufficientBalance,
+            message: 'The stash account has insufficient free balance',
+            data: {
+                actingAccount: actingAccount.address,
+                free: actingBalance.free.toString(),
+            },
+        });
+    }
+}
 /**
  * @hidden
  */
 function prepareUnbondPolyx(args) {
-    const { context: { polymeshApi: { tx: { staking: { bondExtra, unbond }, }, }, }, context, storage: { actingAccount, actingBalance, controllerEntry, isStash }, } = this;
+    const { context: { polymeshApi: { tx: { staking: { bondExtra, rebond, unbond }, }, }, }, context, storage: { actingAccount, actingBalance, controllerEntry, isStash }, } = this;
     const { amount, type } = args;
     let transaction;
-    if (type === 'unbond') {
+    if (type === 'rebond') {
+        transaction = rebond;
+        assertRebondable(amount, controllerEntry, actingAccount);
+    }
+    else if (type === 'unbond') {
         transaction = unbond;
-        if (!controllerEntry) {
-            throw new internal_1.PolymeshError({
-                code: types_1.ErrorCode.UnmetPrerequisite,
-                message: 'The caller must be a controller account',
-                data: { actingAccount: actingAccount.address },
-            });
-        }
-        const { active } = controllerEntry;
-        if (active.lt(amount)) {
-            throw new internal_1.PolymeshError({
-                code: types_1.ErrorCode.InsufficientBalance,
-                message: 'Insufficient bonded POLYX',
-                data: {
-                    amount: amount.toString(),
-                    active: active.toString(),
-                    actingAccount: actingAccount.address,
-                },
-            });
-        }
+        assertUnbondable(amount, controllerEntry, actingAccount);
     }
     else {
         transaction = bondExtra;
-        if (!isStash) {
-            throw new internal_1.PolymeshError({
-                code: types_1.ErrorCode.UnmetPrerequisite,
-                message: 'The caller must be a stash account',
-                data: { actingAccount: actingAccount.address },
-            });
-        }
-        if (actingBalance.free.lt(amount)) {
-            throw new internal_1.PolymeshError({
-                code: types_1.ErrorCode.InsufficientBalance,
-                message: 'The stash account has insufficient free balance',
-                data: {
-                    actingAccount: actingAccount.address,
-                    free: actingBalance.free.toString(),
-                },
-            });
-        }
+        assertBondExtraPossible(amount, actingBalance, isStash, actingAccount);
     }
     const rawAmount = (0, conversion_1.bigNumberToBalance)(amount, context);
     return Promise.resolve({
@@ -74,16 +134,19 @@ function prepareUnbondPolyx(args) {
 }
 /**
  * @hidden
+ *
+ * The staking pallet does not consult a signer's `ExtrinsicPermissions` — no Substrate pallet in
+ *   the Polymesh runtime does — so no permission is required to run this, for a secondary key or
+ *   an external agent alike.
+ *
+ * `true` rather than empty arrays: an empty `SimplePermissions` still routes through
+ *   `Account.checkPermissions`, which reads the key's permissions from chain and **throws** for an
+ *   Account with no Identity. That turns a check that should be a no-op into a failure, and costs
+ *   a query either way.
  */
-function getAuthorization(args) {
-    const { type } = args;
-    const txTag = type === 'unbond' ? types_1.TxTags.staking.Unbond : types_1.TxTags.staking.BondExtra;
+function getAuthorization() {
     return {
-        permissions: {
-            assets: [],
-            transactions: [txTag],
-            portfolios: [],
-        },
+        permissions: true,
     };
 }
 /**

package/api/procedures/updateBondedPolyx.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateBondedPolyx.js","sourceRoot":"","sources":["../../../src/api/procedures/updateBondedPolyx.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"updateBondedPolyx.js","sourceRoot":"","sources":["../../../src/api/procedures/updateBondedPolyx.ts"],"names":[],"mappings":"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"}

package/api/procedures/utils.d.ts

@@ -1,7 +1,7 @@
 import { ISubmittableResult } from '@polkadot/types/types';
 import BigNumber from 'bignumber.js';
-import { Account, AuthorizationRequest, BaseAsset, Checkpoint, CheckpointSchedule, Context, CustomPermissionGroup, Identity, Instruction, KnownPermissionGroup } from '../../internal';
-import { AssetHolderId, AssetHolderLike, Authorization, Condition, GenericAuthorizationData, InputCondition, InputTaxWithholding, InstructionDetails, PermissionedAccount, PortfolioId, Signer, TransactionPermissions, TxTag } from '../../types';
+import { Account, AuthorizationRequest, BaseAsset, Checkpoint, CheckpointSchedule, Context, CustomPermissionGroup, DefaultPortfolio, Identity, Instruction, KnownPermissionGroup, NumberedPortfolio } from '../../internal';
+import { AssetHolderId, AssetHolderLike, Authorization, Condition, GenericAuthorizationData, InputCondition, InputTaxWithholding, InstructionDetails, PermissionedAccount, PortfolioId, PortfolioLike, Signer, TransactionPermissions, TxTag } from '../../types';
 /**
  * @hidden
  */
@@ -18,6 +18,19 @@ export declare function assertInstructionValidForLocking(details: InstructionDet
  * @hidden
  */
 export declare function assertInstructionValidForUnlocking(details: InstructionDetails): void;
+/**
+ * @hidden
+ *
+ * Throw if the connected chain has no extrinsic for `tag`. For a procedure whose extrinsic was
+ *   added in a later runtime than the oldest the SDK supports, so that an older chain refuses it
+ *   with a clear error rather than failing to find the extrinsic
+ *
+ * @param sinceVersion - the first Polymesh release with the extrinsic, reported in the error
+ *
+ * @note this reads the chain's metadata, not its spec version, so it is also right for a runtime
+ *   that is not on the public release line
+ */
+export declare function assertTxSupported(tag: TxTag, sinceVersion: string, context: Context): void;
 /**
  * @hidden
  */
@@ -127,8 +140,76 @@ export declare function addManualFees(currentFee: BigNumber | undefined, tags: T
  * @hidden
  */
 export declare function assertBallotRecordDateValid(checkpoint: CheckpointSchedule | Date, startDate: Date): Promise<void>;
+/**
+ * @hidden
+ *
+ * The storage a controller transfer keeps about where it delivers, shared by the fungible and NFT
+ *   procedures
+ */
+export interface ControllerTransferDestination {
+    did: string;
+    actingAddress: string;
+    destinationAssetHolder: Account | DefaultPortfolio | NumberedPortfolio;
+    /**
+     * whether the destination is somewhere `controllerTransfer` can deliver to, i.e. the acting
+     *   Account itself or a Portfolio of the signing Identity. Anywhere else takes
+     *   `controllerTransferTo`, available from Polymesh 8.1.1
+     */
+    isDestinationCallers: boolean;
+}
+/**
+ * @hidden
+ *
+ * Resolve where a controller transfer delivers, defaulting to the signing Identity's default
+ *   Portfolio, and decide which of the chain's two extrinsics can reach it
+ */
+export declare function getControllerTransferDestination(destination: AssetHolderLike | undefined, context: Context): Promise<ControllerTransferDestination>;
+/**
+ * @hidden
+ *
+ * Read where a controller transfer takes from, given as `origin` or as the deprecated
+ *   `originPortfolio`. The two mean the same thing, so passing both says nothing about which was
+ *   meant
+ */
+export declare function getControllerTransferOrigin(args: {
+    origin?: AssetHolderLike;
+    originPortfolio?: PortfolioLike;
+}): AssetHolderLike;
+/**
+ * @hidden
+ *
+ * Mirror the chain's receiver affirmation check on a controller transfer to a named destination
+ *   (`controller_transfer_to`). A forced transfer cannot affirm on the receiver's behalf, so a
+ *   destination that would have to affirm the incoming transfer is accepted only if the caller
+ *   controls it: the caller's own Account, or a Portfolio in the caller's custody
+ *
+ * A destination has to affirm when the Identity governing it (a Portfolio's custodian, else the
+ *   Account's or Portfolio's owner) has opted in to mandatory receiver affirmation, unless the
+ *   Asset is exempt from affirmation or has been pre-approved by that Identity or, for a Portfolio,
+ *   by the Portfolio itself
+ *
+ * @param caller.did - Identity the extrinsic is dispatched for
+ * @param caller.address - Account the extrinsic is dispatched from
+ */
+export declare function assertControllerTransferDestinationAccepted(destination: Account | NumberedPortfolio | DefaultPortfolio, asset: BaseAsset, caller: {
+    did: string;
+    address: string;
+}, context: Context): Promise<void>;
 /**
  * @hidden
  */
 export declare function getAssetHolderDid(assetHolderLike: AssetHolderLike, context: Context): Promise<string | undefined>;
+/**
+ * @hidden
+ *
+ * Throw if any holder is frozen outright for the Asset it would send. The chain refuses to move an
+ *   Asset out of a frozen holder by any route but a controller transfer
+ *
+ * @note the frozen part of a balance is already netted out of `free`, so this checks only a freeze
+ *   on the holder itself
+ */
+export declare function assertHoldersNotFrozen(holdings: {
+    holder: AssetHolderLike;
+    asset: string | BaseAsset;
+}[], context: Context): Promise<void>;
 //# sourceMappingURL=utils.d.ts.map

package/api/procedures/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/api/procedures/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,SAAS,MAAM,cAAc,CAAC;AAGrC,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,qBAAqB,EACrB,QAAQ,EACR,WAAW,EACX,oBAAoB,EAKrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EAEb,SAAS,EAIT,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAGlB,mBAAmB,EAEnB,WAAW,EACX,MAAM,EAEN,sBAAsB,EACtB,KAAK,EACN,MAAM,SAAS,CAAC;AASjB;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAiBD;;GAEG;AACH,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAWlF;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAcpF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,EAAE,EACnB,iBAAiB,EAAE,mBAAmB,EAAE,GACvC,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAoBvF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,mBAAmB,EAAE,EACtC,OAAO,EAAE,OAAO,GACf,IAAI,CAgCN;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI,GACjD,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,kBAAkB,GAAG,IAAI,EACrC,WAAW,EAAE,IAAI,EACjB,UAAU,EAAE,IAAI,GAAG,IAAI,GACtB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,GAAG,OAAO,CAE5F;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,CAAC,SAAS,GAAG,cAAc,CAAC,EAAE,EAC1C,wBAAwB,EAAE,SAAS,EACnC,OAAO,EAAE,OAAO,GACf,IAAI,CAyCN;AAED;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,WAAW,EAAE,oBAAoB,GAChC,IAAI,CAON;AAED;;;;GAIG;AACH,wBAAsB,wCAAwC,CAC5D,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAsB,sCAAsC,CAC1D,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;GAIG;AACH,wBAAsB,sCAAsC,CAC1D,IAAI,EAAE,wBAAwB,EAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CA2Bf;AA+CD;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,kCAAkC;gBACtB,GAAG,EAAE,KAAK;CAGvB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,sBAAsB,GAAG,IAAI,GACzC,OAAO,CAAC,CAAC,qBAAqB,GAAG,oBAAoB,CAAC,GAAG,SAAS,CAAC,CAWrE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,sBAAsB,GAAG,IAAI,GACzC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,GAEpC,MAAM,aAAa,EACnB,QAAQ,QAAQ,EAChB,QAAQ,QAAQ,GAAG,OAAO,EAC1B,QAAQ,IAAI,GAAG,IAAI,EACnB,SAAS,OAAO,MAEjB,SAAS,kBAAkB,KAAG,oBAM9B,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACnC,SAAS,OAAO,MAChB,SAAS,kBAAkB,KAAG,qBAS9B,CAAC;AAEJ;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,SAAS,GAAG,SAAS,EACjC,IAAI,EAAE,KAAK,EAAE,EACb,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAUhC;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,kBAAkB,GAAG,IAAI,EACrC,SAAS,EAAE,IAAI,GACd,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/api/procedures/utils.ts"],"names":[],"mappings":"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"}

package/api/procedures/utils.js

@@ -17,6 +17,7 @@ exports.assertInstructionValid = assertInstructionValid;
 exports.assertInstructionValidForManualExecution = assertInstructionValidForManualExecution;
 exports.assertInstructionValidForLocking = assertInstructionValidForLocking;
 exports.assertInstructionValidForUnlocking = assertInstructionValidForUnlocking;
+exports.assertTxSupported = assertTxSupported;
 exports.assertPortfolioExists = assertPortfolioExists;
 exports.assertAssetHolderExists = assertAssetHolderExists;
 exports.assertVenueExists = assertVenueExists;
@@ -36,7 +37,11 @@ exports.getGroupFromPermissions = getGroupFromPermissions;
 exports.assertGroupDoesNotExist = assertGroupDoesNotExist;
 exports.addManualFees = addManualFees;
 exports.assertBallotRecordDateValid = assertBallotRecordDateValid;
+exports.getControllerTransferDestination = getControllerTransferDestination;
+exports.getControllerTransferOrigin = getControllerTransferOrigin;
+exports.assertControllerTransferDestinationAccepted = assertControllerTransferDestinationAccepted;
 exports.getAssetHolderDid = getAssetHolderDid;
+exports.assertHoldersNotFrozen = assertHoldersNotFrozen;
 const bignumber_js_1 = __importDefault(require("bignumber.js"));
 const lodash_1 = require("lodash");
 const internal_1 = require("../../internal");
@@ -144,6 +149,30 @@ function assertInstructionValidForUnlocking(details) {
         });
     }
 }
+/**
+ * @hidden
+ *
+ * Throw if the connected chain has no extrinsic for `tag`. For a procedure whose extrinsic was
+ *   added in a later runtime than the oldest the SDK supports, so that an older chain refuses it
+ *   with a clear error rather than failing to find the extrinsic
+ *
+ * @param sinceVersion - the first Polymesh release with the extrinsic, reported in the error
+ *
+ * @note this reads the chain's metadata, not its spec version, so it is also right for a runtime
+ *   that is not on the public release line
+ */
+function assertTxSupported(tag, sinceVersion, context) {
+    var _a;
+    const [section, method] = tag.split('.');
+    const { tx } = context.polymeshApi;
+    if (!((_a = tx[section]) === null || _a === void 0 ? void 0 : _a[method])) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.NotSupported,
+            message: `The connected chain does not support "${tag}", which requires Polymesh ${sinceVersion} or later`,
+            data: { tag, specVersion: context.specVersion },
+        });
+    }
+}
 /**
  * @hidden
  */
@@ -644,6 +673,120 @@ function assertBallotRecordDateValid(checkpoint, startDate) {
         }
     });
 }
+/**
+ * @hidden
+ *
+ * Resolve where a controller transfer delivers, defaulting to the signing Identity's default
+ *   Portfolio, and decide which of the chain's two extrinsics can reach it
+ */
+function getControllerTransferDestination(destination, context) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const [{ did }, { address: actingAddress }] = yield Promise.all([
+            context.getSigningIdentity(),
+            context.getActingAccount(),
+        ]);
+        const destinationAssetHolder = destination
+            ? (0, conversion_1.assetHolderLikeToAssetHolder)(destination, context)
+            : new internal_1.DefaultPortfolio({ did }, context);
+        /*
+         * `controller_transfer` names only the kind of destination, and resolves an Account kind to the
+         *   caller's own Account. So an Account destination is the caller's only if it is the acting
+         *   Account, even when another Account of the same Identity is named
+         */
+        const isDestinationCallers = destinationAssetHolder instanceof internal_1.Account
+            ? destinationAssetHolder.address === actingAddress
+            : destinationAssetHolder.owner.did === did;
+        return {
+            did,
+            actingAddress,
+            destinationAssetHolder,
+            isDestinationCallers,
+        };
+    });
+}
+/**
+ * @hidden
+ *
+ * Read where a controller transfer takes from, given as `origin` or as the deprecated
+ *   `originPortfolio`. The two mean the same thing, so passing both says nothing about which was
+ *   meant
+ */
+function getControllerTransferOrigin(args) {
+    const { origin, originPortfolio } = args;
+    if (origin !== undefined && originPortfolio !== undefined) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.ValidationError,
+            message: 'Pass "origin" or the deprecated "originPortfolio", not both',
+        });
+    }
+    const holder = origin !== null && origin !== void 0 ? origin : originPortfolio;
+    if (holder === undefined) {
+        throw new internal_1.PolymeshError({
+            code: types_1.ErrorCode.ValidationError,
+            message: 'Pass "origin", the Portfolio or Account to transfer from',
+        });
+    }
+    return holder;
+}
+/**
+ * @hidden
+ *
+ * Mirror the chain's receiver affirmation check on a controller transfer to a named destination
+ *   (`controller_transfer_to`). A forced transfer cannot affirm on the receiver's behalf, so a
+ *   destination that would have to affirm the incoming transfer is accepted only if the caller
+ *   controls it: the caller's own Account, or a Portfolio in the caller's custody
+ *
+ * A destination has to affirm when the Identity governing it (a Portfolio's custodian, else the
+ *   Account's or Portfolio's owner) has opted in to mandatory receiver affirmation, unless the
+ *   Asset is exempt from affirmation or has been pre-approved by that Identity or, for a Portfolio,
+ *   by the Portfolio itself
+ *
+ * @param caller.did - Identity the extrinsic is dispatched for
+ * @param caller.address - Account the extrinsic is dispatched from
+ */
+function assertControllerTransferDestinationAccepted(destination, asset, caller, context) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let governingIdentity;
+        let isControlledByCaller;
+        let isPortfolioPreApproved = false;
+        if (destination instanceof internal_1.Account) {
+            governingIdentity = yield destination.getIdentity();
+            isControlledByCaller = destination.address === caller.address;
+        }
+        else {
+            [governingIdentity, isPortfolioPreApproved] = yield Promise.all([
+                destination.getCustodian(),
+                destination.isAssetPreApproved(asset),
+            ]);
+            isControlledByCaller = governingIdentity.did === caller.did;
+        }
+        if (isControlledByCaller) {
+            return;
+        }
+        if (!governingIdentity) {
+            throw new internal_1.PolymeshError({
+                code: types_1.ErrorCode.UnmetPrerequisite,
+                message: 'The destination Account has no Identity to receive the Asset',
+            });
+        }
+        const rawAssetId = (0, conversion_1.assetToMeshAssetId)(asset, context);
+        const [requiresAffirmation, rawIsExempt, isIdentityPreApproved] = yield Promise.all([
+            governingIdentity.isMandatoryReceiverAffirmationEnabled(),
+            context.polymeshApi.query.asset.assetsExemptFromAffirmation(rawAssetId),
+            governingIdentity.isAssetPreApproved(asset),
+        ]);
+        if (requiresAffirmation &&
+            !(0, conversion_1.boolToBoolean)(rawIsExempt) &&
+            !isIdentityPreApproved &&
+            !isPortfolioPreApproved) {
+            throw new internal_1.PolymeshError({
+                code: types_1.ErrorCode.UnmetPrerequisite,
+                message: 'The destination must affirm incoming transfers of this Asset, which a controller transfer cannot do. It must pre-approve the Asset first',
+                data: { receiverIdentity: governingIdentity.did },
+            });
+        }
+    });
+}
 /**
  * @hidden
  */
@@ -660,4 +803,32 @@ function getAssetHolderDid(assetHolderLike, context) {
         }
     });
 }
+/**
+ * @hidden
+ *
+ * Throw if any holder is frozen outright for the Asset it would send. The chain refuses to move an
+ *   Asset out of a frozen holder by any route but a controller transfer
+ *
+ * @note the frozen part of a balance is already netted out of `free`, so this checks only a freeze
+ *   on the holder itself
+ */
+function assertHoldersNotFrozen(holdings, context) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const statuses = yield Promise.all(holdings.map((_a) => __awaiter(this, [_a], void 0, function* ({ holder, asset }) {
+            const baseAsset = yield (0, internal_2.asBaseAsset)(asset, context);
+            const { isFrozen } = yield (0, internal_2.getHolderFreezeStatus)(holder, baseAsset, context);
+            return { holder, assetId: baseAsset.id, isFrozen };
+        })));
+        const frozenHolders = statuses
+            .filter(({ isFrozen }) => isFrozen)
+            .map(({ holder, assetId }) => ({ holder, assetId }));
+        if (frozenHolders.length) {
+            throw new internal_1.PolymeshError({
+                code: types_1.ErrorCode.UnmetPrerequisite,
+                message: 'A sender is frozen for the Asset it would send',
+                data: { frozenHolders },
+            });
+        }
+    });
+}
 //# sourceMappingURL=utils.js.map