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

package/CHANGELOG.md

@@ -1,140 +1,6 @@
-# [31.0.0](https://github.com/PolymeshAssociation/polymesh-sdk/compare/v30.2.0...v31.0.0) (2026-08-14)
-
-
-* fix!: 🐛 require expiresAt on off-chain settlement and STO receipts ([1473bc3](https://github.com/PolymeshAssociation/polymesh-sdk/commit/1473bc3749248826a69330d9fc1dbaf67202c736))
-
-
-### Bug Fixes
-
-* 🐛 authorise ballot voting as a holder action ([aa36fc0](https://github.com/PolymeshAssociation/polymesh-sdk/commit/aa36fc0a3177e2926397a01d2cc601b283a83518)), closes [#1643](https://github.com/PolymeshAssociation/polymesh-sdk/issues/1643)
-* 🐛 base transferFunds authorization on signing key, add NFT checks ([64adfd9](https://github.com/PolymeshAssociation/polymesh-sdk/commit/64adfd91710c0843e87bf902c3c73bdcda68d5d1))
-* 🐛 check agent permissions for the accept-side transaction ([394fb58](https://github.com/PolymeshAssociation/polymesh-sdk/commit/394fb588fb1d71ff1c4f5290572d470361ae9e08))
-* 🐛 compare NFT ownership by address for MultiSig Account holders in transferFunds ([816a5f7](https://github.com/PolymeshAssociation/polymesh-sdk/commit/816a5f799d9e6fb15e4e62b84410a5dfad019a9d))
-* 🐛 correct protocol fee mapping against v8 runtime ([69ec025](https://github.com/PolymeshAssociation/polymesh-sdk/commit/69ec025da27bc62d5ffb7476487b26296390ff49))
-* 🐛 correct transaction tags against chain v8 metadata ([e77224d](https://github.com/PolymeshAssociation/polymesh-sdk/commit/e77224dce8ab3bb3a4c2edd19d8ac2a43b10d204))
-* 🐛 declare the transaction revokeIdentityToCreatePortfolios submits ([debc1d0](https://github.com/PolymeshAssociation/polymesh-sdk/commit/debc1d065da6a8e6a36f102e0ac5b26c020ab9ed))
-* 🐛 declare the transactions procedures actually submit ([672fcfd](https://github.com/PolymeshAssociation/polymesh-sdk/commit/672fcfd3d1a7c3f4b4fb8756d65c789f6ad3a2f3))
-* 🐛 distinguish immediate execution from a pending instruction ([9c40cf9](https://github.com/PolymeshAssociation/polymesh-sdk/commit/9c40cf91ca1772812a03a0aa3fb530294b82298d))
-* 🐛 drop permission declarations the chain never checks ([ec0ddbb](https://github.com/PolymeshAssociation/polymesh-sdk/commit/ec0ddbbb395d0393119bf99b29079cafa8650fe2))
-* 🐛 drop remaining permission declarations the chain never checks ([fdb8f75](https://github.com/PolymeshAssociation/polymesh-sdk/commit/fdb8f75f968f607fd8c9b9654bd59c75564ada65))
-* 🐛 make generate:consts idempotent ([1c9b080](https://github.com/PolymeshAssociation/polymesh-sdk/commit/1c9b08096a2aba5c8ea98cbc561c4230245c7058))
-* 🐛 only require the DID Registrar role to issue a CDD claim ([78abd14](https://github.com/PolymeshAssociation/polymesh-sdk/commit/78abd14d912d85e61bdcaeda6fe5a0ed668d5f0c))
-* 🐛 protocol fees no longer silently reported as zero ([e30e51d](https://github.com/PolymeshAssociation/polymesh-sdk/commit/e30e51dcd3703258060ad2a22f4bd34ad13b397f))
-* 🐛 report transfer failures instead of throwing ([50fb337](https://github.com/PolymeshAssociation/polymesh-sdk/commit/50fb337d25beee873d779484b6fb25ec67aa37c4))
-* 🐛 return null from getNextCheckpoint after every Schedule is removed ([75d0b0e](https://github.com/PolymeshAssociation/polymesh-sdk/commit/75d0b0ed22f7819905b0804d25b65357d7d9488e))
-* 🐛 staking.getPayee returns null for an Account with no payee ([4a8effc](https://github.com/PolymeshAssociation/polymesh-sdk/commit/4a8effcabb8140fa01d812c11c5ab693778735be))
+# [31.1.0-beta.2](https://github.com/PolymeshAssociation/polymesh-sdk/compare/v31.1.0-beta.1...v31.1.0-beta.2) (2026-08-21)
 
 
 ### Features
 
-* 🎸 add Checkpoint.Schedules.getNextCheckpoint getter ([31db08c](https://github.com/PolymeshAssociation/polymesh-sdk/commit/31db08ccc433dde93355f5f90f0d2c7e36766259))
-* 🎸 add CorporateActionBase.getDocuments getter ([edef2cb](https://github.com/PolymeshAssociation/polymesh-sdk/commit/edef2cb4567aa85f0b100d80cf38b6464e8e07e8))
-* 🎸 align TransferError with the chain's transfer errors ([52f1364](https://github.com/PolymeshAssociation/polymesh-sdk/commit/52f13642eeec5397818afe09e1734be70ba2075a))
-* 🎸 allow transferFunds between asset holders on different DIDs ([458bfd5](https://github.com/PolymeshAssociation/polymesh-sdk/commit/458bfd5d28d156e1633ffd5970df41afd1d9374e))
-* 🎸 Drop v7 support ([4292be3](https://github.com/PolymeshAssociation/polymesh-sdk/commit/4292be303bb5bd161b83ce92ed9ea7b1993e82e7))
-* 🎸 make nft.createNftCollection grantable to External Agents ([32753ef](https://github.com/PolymeshAssociation/polymesh-sdk/commit/32753ef90ff9e1bc010e344e66155fd89a44ffe7))
-* 🎸 rebuild transaction groups from the chain's permission model ([b6cb8e5](https://github.com/PolymeshAssociation/polymesh-sdk/commit/b6cb8e5ee0b13903cf8f0e92050272800a260372))
-* 🎸 remove CDD transfer errors that cannot occur on v8 ([10114e3](https://github.com/PolymeshAssociation/polymesh-sdk/commit/10114e300392e9bb9f05406ce0f85bdcdda7774d))
-* 🎸 remove types and a procedure for extrinsics that no longer exist ([2fb7fec](https://github.com/PolymeshAssociation/polymesh-sdk/commit/2fb7fecbcc64eff17682a8e9c0c15732d433255c))
-
-
-### BREAKING CHANGES
-
-* `expiresAt` is now required on
-`Instruction.generateOffChainAffirmationReceipt` and
-`Offering.generateOffChainFundingReceipt`, and on
-`OffChainAffirmationReceipt` and `OffChainFundingReceipt`.
-* 🧨 `Assets.transferFunds` return type changed from
-`void` to `Instruction | undefined`. It resolves to the pending
-`Instruction` when a cross-DID transfer is left awaiting the
-receiver's affirmation, and `undefined` when the transfer settles
-immediately (same-DID, or the receiver auto-affirmed).
-* 🧨 The following exported types are removed, along with the
-`modifyCorporateActionsAgent` procedure:
-
-- `ScopeClaimProof` and `AddInvestorUniquenessClaimParams` — described
-  `identity.add_investor_uniqueness_claim`, which does not exist on chain v8
-- `ModifyPrimaryIssuanceAgentParams` — the Primary Issuance Agent concept was
-  superseded by External Agents
-- `ModifyCorporateActionsAgentParams` — its procedure's only caller,
-  `CorporateActions.setAgent`, was removed in v22.0.0 in favour of
-  `Permissions.inviteAgent`, but the procedure was left behind
-
-None had any reference in the SDK and no procedure accepted or returned them.
-There is no replacement because there is no longer an operation to describe.
-
-`testUtils` Asset entity mocks no longer default a `primaryIssuanceAgents`
-field, which `AssetDetails` has not had since v22.0.0.
-* 🧨 - Removed the `TransferStatus` enum and its sole
-producer `u8ToTransferStatus`. `TransferError` — the enum actually
-populated, by `Settlements.canTransfer` — keeps its role, and its members'
-doc comments no longer refer to `TransferStatus` equivalents.
-- Removed `TransferError.InvalidReceiverPortfolio`. Its sole producer was
-the `granularCanTransferResultToTransferBreakdown` cascade deleted with v7
-support, and it cannot be re-mapped: the `portfolio` pallet has a single
-`PortfolioDoesNotExist` variant, already mapped to `InvalidSenderPortfolio`.
-- Added `TransferError.InvalidReceiverIdentity` for a receiving Identity
-that is not active. Both transfer-validation paths report this condition
-(`nft.InvalidNFTTransferInvalidReceiverDID` and
-`asset.InvalidTransferInvalidReceiverDID`) and neither was mapped, so it
-previously surfaced as a raw chain error name.
-- Removed the `transfersCanTransfer` mock option in `testUtils`, typed
-against a return type `canTransfer` no longer has.
-- See [`changelogs/v30.2.0-next.md`](changelogs/v30.2.0-next.md) for full
-migration guidance.
-* 🧨 - Removed `TransferError.InvalidReceiverCdd`,
-`TransferError.InvalidSenderCdd` and `TransferError.ScopeClaimMissing`.
-The first two cannot be produced because transfers are no longer CDD
-gated; `ScopeClaimMissing` relates to Investor Uniqueness, removed from
-the chain some time ago.
-- See [`changelogs/v30.2.0-next.md`](changelogs/v30.2.0-next.md) for full
-migration guidance.
-* 🧨 - Removed `TxGroup.RelayerManagement` and
-`RELAYER_MANAGEMENT_TX_TAGS`. Every call in the `relayer` pallet is
-`ensure_signed` only, so the group never gated anything and no replacement
-grant is needed.
-- `TxGroup.MultiSigManagement` / `MULTISIG_MANAGEMENT_TX_TAGS` reduced to
-`multiSig.CreateMultisig`, the only permission-checked call in the pallet.
-The rest are executed under the MultiSig's own origin via a proposal, are
-`ensure_signed` only, or are primary-key only. What a MultiSig may do via
-proposal is constrained by the permissions held by the **MultiSig Account
-itself**, not by its signers'.
-- Added `TxGroup.InstructionMediation` / `INSTRUCTION_MEDIATION_TX_TAGS`
-(`AffirmInstructionAsMediator`, `RejectInstructionAsMediator`,
-`LockInstruction`, `UnlockInstruction`). These are **newly grantable, not
-relocated** — no group previously covered them, so existing
-`SettlementManagement` grantees do not already have them.
-- Added `TxGroup.DidRegistration` / `DID_REGISTRATION_TX_TAGS`
-(`identity.RegisterDid`); `TxGroup.CddRegistration` is deprecated but
-retained.
-- Removed tags for extrinsics no longer on chain:
-`settlement.AddInstructionWithMemo`, `settlement.AddAndAffirmInstructionWithMemo`,
-`portfolio.MovePortfolioFundsV2`.
-- Added tags for permission-checked v8 extrinsics no group previously
-covered, across `SettlementManagement`, `PortfolioManagement`,
-`StoManagement` and `CorporateActionsManagement`.
-- Consumers building permission UIs from `TX_GROUP_TO_TAGS_MAP`,
-`AGENT_TX_GROUP_VALUES` or the individual `*_TX_TAGS` constants should
-re-check their output.
-- See [`changelogs/v30.2.0-next.md`](changelogs/v30.2.0-next.md) for full
-migration guidance.
-* 🧨 - SDK now only supports **chain v8** — connecting to a v7 chain throws on
-initialization (`SUPPORTED_SPEC_VERSION_RANGE` narrowed to `'8.0'`).
-- Removed: `ChildIdentity` entity and all child-identity APIs (`Identities.createChild`/
-`createChildren`/`getChildIdentity`, `Identity.*` equivalents), `Claims.getCddClaims`,
-`Identity.hasValidCdd`, `RoleType.CddProvider`/`isCddProviderRole`/`CddProviderRole`,
-`AccountManagement.subsidizeAccount`, `consumeAddRelayerPayingKeyAuthorization`/
-`AuthorizationType.AddRelayerPayingKey`, `Instruction.withdraw`/`withdrawAsMediator`/
-`InstructionAffirmationOperation.Withdraw`/`WithdrawAsMediator`, `Nft.controllerTransfer`'s
-`destinationPortfolio` param, `AcceptPrimaryKeyRotationParams.cddAuth`,
-`SetStakingControllerParams`/`BondPolyxParams.controller`.
-- Renamed: `Identity.isCddProvider()` → `Identity.isDidRegistrar()`.
-- Deprecated: `Identities.registerIdentity` (`createCdd`/`expiry` are now no-ops) —
-use `registerDid`/`selfRegisterDid`.
-- Error message changes (update any string-matching code):
-`'Beneficiary/Subsidizer Account does not have a valid CDD Claim'` →
-`'...does not have an associated Identity'`;
-`'Issuing Identity does not have a valid CDD claim'` → `'Issuing Identity does not exist'`;
-`'Issuer must be a CDD provider'` → `'Issuer must be a DID Registrar'`;
-`'MultiSig signers must be accounts as of v7'` → `'MultiSig signers must be accounts'`.
-- See [`changelogs/v30.2.0-next.md`](changelogs/v30.2.0-next.md) for full migration guidance.
+* 🎸 support issuing NFTs to the signing Account, not just portfolios ([68a9ab4](https://github.com/PolymeshAssociation/polymesh-sdk/commit/68a9ab4471516623d2dc60f29ef5b7857f49a12a))

package/api/client/AccountManagement.d.ts

@@ -54,6 +54,35 @@ export declare class AccountManagement {
      * Unfreeze all of the secondary Accounts in the signing Identity. This will restore their permissions as they were before being frozen
      */
     unfreezeSecondaryAccounts: NoArgsProcedureMethod<void>;
+    /**
+     * Register the signing Account against its derived Ethereum address, so that the chain can
+     *   resolve that address back to the Account
+     *
+     * The derived address (see {@link api/entities/Account!Account.evmAddress | Account.evmAddress})
+     *   is `keccak256` of the Account, which the chain cannot invert on its own. Until it is mapped,
+     *   anything sent to the address is credited to the fallback Account reported by
+     *   {@link api/entities/Account!Account.getEvmAddressDetails | Account.getEvmAddressDetails}
+     *   instead, and recovering it needs the chain's `revive.dispatchAsFallbackAccount`. Map the
+     *   Account *before* advertising the address or receiving funds at it
+     *
+     * @note this takes a deposit from the signing Account, released by {@link unmapEvmAccount}
+     *
+     * @throws if the signing Account is Ethereum-derived — the chain resolves its address by
+     *   stripping the padding, so there is nothing to map
+     * @throws if the signing Account is already mapped
+     */
+    mapEvmAccount: NoArgsProcedureMethod<void>;
+    /**
+     * Unregister the signing Account from its derived Ethereum address, releasing the deposit taken
+     *   by {@link mapEvmAccount}
+     *
+     * @note after this, the chain can no longer resolve the derived address back to the Account, so
+     *   anything sent to it is credited to the fallback Account instead. Only do this for an Account
+     *   that will no longer be used
+     *
+     * @throws if the signing Account is not mapped
+     */
+    unmapEvmAccount: NoArgsProcedureMethod<void>;
     /**
      * Approves a subsidy request
      *
@@ -119,6 +148,25 @@ export declare class AccountManagement {
     getAccount(args: {
         address: string;
     }): Promise<Account | MultiSig>;
+    /**
+     * Return the Account the chain credits for an Ethereum (H160) address, mirroring the `revive`
+     *   pallet's address mapper
+     *
+     * - if the address has been mapped via {@link mapEvmAccount}, this is the Account that mapped it
+     * - otherwise it is the fallback Account `ss58(<address> ++ [0xEE; 12])`, which is also the
+     *   Account controlled by the Ethereum key itself when `address` is a native Ethereum address
+     *
+     * @param args.evmAddress - 20 byte hex encoded Ethereum address. Checksummed or not
+     *
+     * @note this always resolves to an Account, so the result alone does not say whether a mapping
+     *   exists. Use {@link api/entities/Account!Account.getEvmAddressDetails |
+     *   Account.getEvmAddressDetails} on the Account you expect for that
+     *
+     * @throws if `evmAddress` is not a 20 byte hex encoded address
+     */
+    getAccountByEvmAddress(args: {
+        evmAddress: string;
+    }): Promise<Account | MultiSig>;
     /**
      * Return the signing Account, or null if no signing Account has been set
      */

package/api/client/AccountManagement.d.ts.map

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

package/api/client/AccountManagement.js

@@ -14,6 +14,7 @@ const util_1 = require("@polkadot/util");
 const internal_1 = require("../../internal");
 const types_1 = require("../../types");
 const conversion_1 = require("../../utils/conversion");
+const eth_1 = require("../../utils/eth");
 const internal_2 = require("../../utils/internal");
 /**
  * Handles functionality related to Account Management
@@ -57,6 +58,14 @@ class AccountManagement {
             getProcedureAndArgs: () => [internal_1.toggleFreezeSecondaryAccounts, { freeze: false }],
             voidArgs: true,
         }, context);
+        this.mapEvmAccount = (0, internal_2.createProcedureMethod)({
+            getProcedureAndArgs: () => [internal_1.toggleEvmAccountMapping, { map: true }],
+            voidArgs: true,
+        }, context);
+        this.unmapEvmAccount = (0, internal_2.createProcedureMethod)({
+            getProcedureAndArgs: () => [internal_1.toggleEvmAccountMapping, { map: false }],
+            voidArgs: true,
+        }, context);
         this.acceptSubsidy = (0, internal_2.createProcedureMethod)({ getProcedureAndArgs: args => [internal_1.acceptSubsidy, args] }, context);
         this.revokeSubsidy = (0, internal_2.createProcedureMethod)({ getProcedureAndArgs: args => [internal_1.revokeSubsidy, args] }, context);
         this.approveSubsidy = (0, internal_2.createProcedureMethod)({ getProcedureAndArgs: args => [internal_1.subsidizeAccount, Object.assign({}, args)] }, context);
@@ -99,6 +108,35 @@ class AccountManagement {
     getAccount(args) {
         return (0, internal_2.getAccount)(args, this.context);
     }
+    /**
+     * Return the Account the chain credits for an Ethereum (H160) address, mirroring the `revive`
+     *   pallet's address mapper
+     *
+     * - if the address has been mapped via {@link mapEvmAccount}, this is the Account that mapped it
+     * - otherwise it is the fallback Account `ss58(<address> ++ [0xEE; 12])`, which is also the
+     *   Account controlled by the Ethereum key itself when `address` is a native Ethereum address
+     *
+     * @param args.evmAddress - 20 byte hex encoded Ethereum address. Checksummed or not
+     *
+     * @note this always resolves to an Account, so the result alone does not say whether a mapping
+     *   exists. Use {@link api/entities/Account!Account.getEvmAddressDetails |
+     *   Account.getEvmAddressDetails} on the Account you expect for that
+     *
+     * @throws if `evmAddress` is not a 20 byte hex encoded address
+     */
+    getAccountByEvmAddress(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { context } = this;
+            const { evmAddress } = args;
+            // validates `evmAddress`, so the storage query below is never handed a malformed key
+            const fallbackAddress = (0, eth_1.ss58FromEthAddress)(evmAddress, context.ss58Format);
+            const rawOriginalAccount = yield context.polymeshApi.query.revive.originalAccount(evmAddress);
+            const address = rawOriginalAccount.isSome
+                ? (0, conversion_1.accountIdToString)(rawOriginalAccount.unwrap())
+                : fallbackAddress;
+            return (0, internal_2.getAccount)({ address }, context);
+        });
+    }
     /**
      * Return the signing Account, or null if no signing Account has been set
      */

package/api/client/AccountManagement.js.map

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

package/api/client/Network.d.ts

@@ -1,7 +1,9 @@
+import { AnyJson } from '@polkadot/types/types';
+import { HexString } from '@polkadot/util/types';
 import BigNumber from 'bignumber.js';
 import { Account, Context } from '../../internal';
 import { EventIdEnum, ModuleIdEnum } from '../../middleware/types';
-import { EventIdentifier, ExtrinsicDataWithFees, MiddlewareMetadata, NetworkProperties, ProcedureMethod, ProtocolFees, SubCallback, SubmissionDetails, TransactionPayloadInput, TransferPolyxParams, TxTag, UnsubCallback } from '../../types';
+import { EventIdentifier, ExtrinsicDataWithFees, MiddlewareMetadata, NetworkProperties, ProcedureMethod, ProtocolFees, SubCallback, SubmissionDetails, SubmissionOpts, TransactionArgument, TransactionPayloadInput, TransferPolyxParams, TxTag, UnsubCallback } from '../../types';
 /**
  * Handles all Network related functionality, including querying for historical events from middleware
  */
@@ -80,9 +82,84 @@ export declare class Network {
     /**
      * Submits a transaction payload with its signature to the chain. `signature` should be hex encoded
      *
+     * @param opts - bounds on how long to wait while broadcasting and tracking the transaction.
+     *   Defaults to waiting indefinitely
+     *
      * @throws if the signature is not hex encoded
+     * @throws `TransactionTimeout` if a bound in `opts` is exceeded. The transaction is not cancelled
+     *   by this, and can be tracked afterwards with {@link watchTransaction}
+     */
+    submitTransaction(txPayload: TransactionPayloadInput, signature: string, opts?: SubmissionOpts): Promise<SubmissionDetails>;
+    /**
+     * Submits a raw, signed Ethereum transaction that carries a Polymesh runtime call through the
+     *   `revive` pallet's sentinel address. This is the SDK-broadcast submission step, reused
+     *   here to unlock Fireblocks / KMS / HSM / air-gapped custody flows for Ethereum-derived
+     *   Accounts: build the payload via
+     *   {@link base/PolymeshTransactionBase!PolymeshTransactionBase.toEthSignablePayload | transaction.toEthSignablePayload},
+     *   sign it externally, and submit the raw signed bytes here
+     *
+     * @param rawSignedTx - the raw signed Ethereum transaction, as returned by an `EthSigner`'s `signTransaction`
+     * @param opts - bounds on how long to wait while broadcasting and tracking the transaction.
+     *   Defaults to waiting indefinitely
+     *
+     * @throws `TransactionTimeout` if a bound in `opts` is exceeded. The transaction is not cancelled
+     *   by this, and can be tracked afterwards with {@link watchTransaction}
+     */
+    submitEthTransaction(rawSignedTx: HexString, opts?: SubmissionOpts): Promise<SubmissionDetails>;
+    /**
+     * Track a transaction that has already been broadcast, by its hash, and wait for it to be
+     *   included in a finalized block
+     *
+     * Complements {@link base/PolymeshTransactionBase!PolymeshTransactionBase.broadcast | transaction.broadcast}
+     *   and the timeouts on {@link submitTransaction} / {@link submitEthTransaction}: each of those
+     *   can leave a transaction in flight but untracked. Since this needs nothing but a hash and a
+     *   block height, tracking can be picked back up in a later session — after a page reload, for
+     *   instance, where the original handle no longer exists
+     *
+     * @param args.startingBlock - block height to start searching from. This must be at or before the
+     *   block the transaction was submitted in, or it will not be found. `broadcast` returns the
+     *   correct value to persist
+     * @param args.txHash - hash of the transaction to look for
+     * @param args.isEthTxHash - set to `true` when `txHash` is an Ethereum transaction hash, i.e. the
+     *   transaction was broadcast by an Ethereum wallet. Those are carried on chain as an unsigned
+     *   `revive.ethTransact` extrinsic, so they are matched by their payload rather than by the
+     *   extrinsic hash
+     * @param args.timeout - milliseconds to wait before giving up. Defaults to waiting indefinitely
+     *
+     * @throws `TransactionTimeout` if the transaction is not found in time. It may still be included
+     *   afterwards — this reports only that the search stopped
+     */
+    watchTransaction(args: {
+        startingBlock: BigNumber;
+        txHash: string;
+        isEthTxHash?: boolean;
+        timeout?: number;
+    }): Promise<SubmissionDetails>;
+    /**
+     * @hidden
+     *
+     * Broadcast an already-built extrinsic (either the offline-signed native extrinsic, or the
+     *   bare `revive.ethTransact` wrapper around a raw signed Ethereum transaction) and track it
+     *   through to finalization
+     *
+     * @note the bounds in `opts` only apply to the polling path. The subscription path is driven by
+     *   the node's own status stream, which reports progress unprompted and does not risk waiting on
+     *   a signer that never responds
+     */
+    private broadcastExtrinsic;
+    /**
+     * Decode the SCALE-encoded call carried by a `revive.ethTransact` transaction (or any other
+     *   Polymesh call), so a dapp can render it next to a wallet's confirmation prompt. Does not
+     *   fix in-wallet legibility (the wallet still shows raw bytes); it removes the worst of the
+     *   opacity for a dapp that cares
+     *
+     * @param hex - SCALE-encoded call, e.g. `transaction.toEthSignablePayload()`'s `transaction.data`
      */
-    submitTransaction(txPayload: TransactionPayloadInput, signature: string): Promise<SubmissionDetails>;
+    decodeCall(hex: HexString): {
+        tag: TxTag;
+        args: TransactionArgument[];
+        humanReadable: AnyJson;
+    };
     /**
      * Retrieve a list of events. Can be filtered using parameters
      *

package/api/client/Network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/api/client/Network.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,cAAc,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAgC,MAAM,YAAY,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAS,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAEL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,EACL,aAAa,EACd,MAAM,SAAS,CAAC;AAgBjB;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC;;OAEG;gBACS,OAAO,EAAE,OAAO;IAS5B;;OAEG;IACI,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC;IAI3C;;OAEG;IACI,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAIpC;;OAEG;IACI,aAAa,IAAI,SAAS;IAIjC;;OAEG;IACU,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAqB/D;;;;OAIG;IACI,eAAe,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,KAAK,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIxE;;OAEG;IACI,kBAAkB,IAAI,OAAO;IAQpC;;;;OAIG;IACI,kBAAkB,IAAI,OAAO,CAAC,SAAS,CAAC;IAE/C;;;;;;;;OAQG;IACI,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBnF;;OAEG;IACI,aAAa,EAAE,eAAe,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAEjE;;;;;;;;;;OAUG;IACU,qBAAqB,CAAC,IAAI,EAAE;QACvC,QAAQ,EAAE,YAAY,CAAC;QACvB,OAAO,EAAE,WAAW,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA2BnC;;;;OAIG;IACU,iBAAiB,CAC5B,SAAS,EAAE,uBAAuB,EAClC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAmI7B;;;;;;;;;;;;;OAaG;IACU,sBAAsB,CAAC,IAAI,EAAE;QACxC,QAAQ,EAAE,YAAY,CAAC;QACvB,OAAO,EAAE,WAAW,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,KAAK,CAAC,EAAE,SAAS,CAAC;KACnB,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC;IAiCrC;;;;;;OAMG;IACU,oBAAoB,CAAC,IAAI,EAAE;QACtC,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAuFzC;;;;;OAKG;IACI,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAIlE;;;;;;OAMG;IACU,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC;IAcnD;;OAEG;IACI,0BAA0B,IAAI,OAAO;IAW5C;;;;OAIG;IACI,oBAAoB,IAAI,OAAO;CAKvC"}
+{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/api/client/Network.ts"],"names":[],"mappings":"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"}

package/api/client/Network.js

@@ -15,6 +15,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Network = void 0;
 const util_1 = require("@polkadot/util");
 const bignumber_js_1 = __importDefault(require("bignumber.js"));
+const ethTransaction_1 = require("../../base/ethTransaction");
 const utils_1 = require("../../base/utils");
 const internal_1 = require("../../internal");
 const events_1 = require("../../middleware/queries/events");
@@ -125,10 +126,15 @@ class Network {
     /**
      * Submits a transaction payload with its signature to the chain. `signature` should be hex encoded
      *
+     * @param opts - bounds on how long to wait while broadcasting and tracking the transaction.
+     *   Defaults to waiting indefinitely
+     *
      * @throws if the signature is not hex encoded
+     * @throws `TransactionTimeout` if a bound in `opts` is exceeded. The transaction is not cancelled
+     *   by this, and can be tracked afterwards with {@link watchTransaction}
      */
-    submitTransaction(txPayload, signature) {
-        return __awaiter(this, void 0, void 0, function* () {
+    submitTransaction(txPayload_1, signature_1) {
+        return __awaiter(this, arguments, void 0, function* (txPayload, signature, opts = {}) {
             const { context } = this;
             let payload;
             let address;
@@ -164,9 +170,100 @@ class Network {
                 });
             extrinsic.addSignature(address, signature, payload);
             const transaction = context.polymeshApi.tx(extrinsic);
+            return yield this.broadcastExtrinsic(transaction, opts);
+        });
+    }
+    /**
+     * Submits a raw, signed Ethereum transaction that carries a Polymesh runtime call through the
+     *   `revive` pallet's sentinel address. This is the SDK-broadcast submission step, reused
+     *   here to unlock Fireblocks / KMS / HSM / air-gapped custody flows for Ethereum-derived
+     *   Accounts: build the payload via
+     *   {@link base/PolymeshTransactionBase!PolymeshTransactionBase.toEthSignablePayload | transaction.toEthSignablePayload},
+     *   sign it externally, and submit the raw signed bytes here
+     *
+     * @param rawSignedTx - the raw signed Ethereum transaction, as returned by an `EthSigner`'s `signTransaction`
+     * @param opts - bounds on how long to wait while broadcasting and tracking the transaction.
+     *   Defaults to waiting indefinitely
+     *
+     * @throws `TransactionTimeout` if a bound in `opts` is exceeded. The transaction is not cancelled
+     *   by this, and can be tracked afterwards with {@link watchTransaction}
+     */
+    submitEthTransaction(rawSignedTx_1) {
+        return __awaiter(this, arguments, void 0, function* (rawSignedTx, opts = {}) {
+            const { context } = this;
+            const transaction = context.polymeshApi.tx.revive.ethTransact(rawSignedTx);
+            return yield this.broadcastExtrinsic(transaction, opts);
+        });
+    }
+    /**
+     * Track a transaction that has already been broadcast, by its hash, and wait for it to be
+     *   included in a finalized block
+     *
+     * Complements {@link base/PolymeshTransactionBase!PolymeshTransactionBase.broadcast | transaction.broadcast}
+     *   and the timeouts on {@link submitTransaction} / {@link submitEthTransaction}: each of those
+     *   can leave a transaction in flight but untracked. Since this needs nothing but a hash and a
+     *   block height, tracking can be picked back up in a later session — after a page reload, for
+     *   instance, where the original handle no longer exists
+     *
+     * @param args.startingBlock - block height to start searching from. This must be at or before the
+     *   block the transaction was submitted in, or it will not be found. `broadcast` returns the
+     *   correct value to persist
+     * @param args.txHash - hash of the transaction to look for
+     * @param args.isEthTxHash - set to `true` when `txHash` is an Ethereum transaction hash, i.e. the
+     *   transaction was broadcast by an Ethereum wallet. Those are carried on chain as an unsigned
+     *   `revive.ethTransact` extrinsic, so they are matched by their payload rather than by the
+     *   extrinsic hash
+     * @param args.timeout - milliseconds to wait before giving up. Defaults to waiting indefinitely
+     *
+     * @throws `TransactionTimeout` if the transaction is not found in time. It may still be included
+     *   afterwards — this reports only that the search stopped
+     */
+    watchTransaction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { context } = this;
+            const { startingBlock, txHash, isEthTxHash = false, timeout } = args;
+            const matcher = isEthTxHash
+                ? (0, ethTransaction_1.ethTransactKeccakMatcher)(txHash)
+                : (0, utils_1.extrinsicHashMatcher)(context.createType('Hash', txHash));
+            const scanning = context.supportsSubscription()
+                ? (0, utils_1.subscribeForTransactionFinalization)(matcher, startingBlock, context)
+                : (0, utils_1.pollForTransactionFinalization)(matcher, startingBlock, context);
+            const result = yield (0, internal_2.withTimeout)(scanning, timeout, () => new internal_1.PolymeshError({
+                code: types_1.ErrorCode.TransactionTimeout,
+                message: 'The transaction was not found in a finalized block within the allotted time. It has not been cancelled and may still be included, so this can be retried',
+                data: { txHash, startingBlock, timeout },
+            }));
+            const failureError = (0, utils_1.getExtrinsicFailure)(result);
+            if (failureError) {
+                throw failureError;
+            }
+            return {
+                blockHash: (0, conversion_1.hashToString)(result.status.asFinalized),
+                transactionHash: txHash,
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                transactionIndex: new bignumber_js_1.default(result.txIndex),
+                result,
+            };
+        });
+    }
+    /**
+     * @hidden
+     *
+     * Broadcast an already-built extrinsic (either the offline-signed native extrinsic, or the
+     *   bare `revive.ethTransact` wrapper around a raw signed Ethereum transaction) and track it
+     *   through to finalization
+     *
+     * @note the bounds in `opts` only apply to the polling path. The subscription path is driven by
+     *   the node's own status stream, which reports progress unprompted and does not risk waiting on
+     *   a signer that never responds
+     */
+    broadcastExtrinsic(transaction, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { context } = this;
+            const { broadcastTimeout, watchTimeout } = opts;
             const submissionDetails = {
                 blockHash: '',
-                transactionHash: extrinsic.hash.toString(),
+                transactionHash: transaction.hash.toString(),
                 transactionIndex: new bignumber_js_1.default(-1),
             };
             if (context.supportsSubscription()) {
@@ -175,7 +272,7 @@ class Network {
                         const { status } = receipt;
                         let isLastCallback = false;
                         let unsubscribing = Promise.resolve();
-                        let extrinsicFailedEvent;
+                        let failureError;
                         // isCompleted implies status is one of: isFinalized, isInBlock or isError
                         if (receipt.isCompleted) {
                             if (receipt.isInBlock) {
@@ -184,10 +281,14 @@ class Network {
                                 // we know that the index has to be set by the time the transaction is included in a block
                                 // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                                 submissionDetails.transactionIndex = new bignumber_js_1.default(receipt.txIndex);
-                                // if the extrinsic failed due to an on-chain error, we should handle it in a special way
-                                [extrinsicFailedEvent] = (0, internal_2.filterEventRecords)(receipt, 'system', 'ExtrinsicFailed', true);
+                                /*
+                                 * if the extrinsic failed due to an on-chain error, we should handle it in a special
+                                 *   way. This also catches `revive.EthExtrinsicRevert`, emitted instead of
+                                 *   `system.ExtrinsicFailed` when the transaction was signed by an Ethereum key
+                                 */
+                                failureError = (0, utils_1.getExtrinsicFailure)(receipt);
                                 // extrinsic failed so we can unsubscribe
-                                isLastCallback = !!extrinsicFailedEvent;
+                                isLastCallback = !!failureError;
                             }
                             else {
                                 // isFinalized || isError so we know we can unsubscribe
@@ -203,10 +304,9 @@ class Network {
                              * Primarily for consistent error handling
                              */
                             let finishing = Promise.resolve();
-                            if (extrinsicFailedEvent) {
-                                const { data } = extrinsicFailedEvent;
+                            if (failureError) {
+                                const error = failureError;
                                 finishing = Promise.all([unsubscribing]).then(() => {
-                                    const error = (0, utils_1.handleExtrinsicFailure)(data[0]);
                                     reject(error);
                                 });
                             }
@@ -226,8 +326,24 @@ class Network {
             }
             else {
                 const startingBlock = yield context.getLatestBlock();
-                yield transaction.send();
-                const result = yield (0, utils_1.pollForTransactionFinalization)(transaction.hash, startingBlock, context);
+                yield (0, internal_2.withTimeout)(transaction.send(), broadcastTimeout, () => new internal_1.PolymeshError({
+                    code: types_1.ErrorCode.TransactionTimeout,
+                    message: 'The transaction was not broadcast within the allotted time. It was not cancelled — whether it ends up being submitted is unknown, so check before submitting again, or the same transaction may be submitted twice',
+                    data: { transactionHash: transaction.hash.toString(), broadcastTimeout },
+                }));
+                const result = yield (0, internal_2.withTimeout)((0, utils_1.pollForTransactionFinalization)((0, utils_1.extrinsicHashMatcher)(transaction.hash), startingBlock, context), watchTimeout, () => new internal_1.PolymeshError({
+                    code: types_1.ErrorCode.TransactionTimeout,
+                    message: 'The transaction was broadcast but was not found in a finalized block within the allotted time. It has not been cancelled and may still be included — it can be tracked by hash with `network.watchTransaction`',
+                    data: {
+                        transactionHash: transaction.hash.toString(),
+                        startingBlock,
+                        watchTimeout,
+                    },
+                }));
+                const failureError = (0, utils_1.getExtrinsicFailure)(result);
+                if (failureError) {
+                    throw failureError;
+                }
                 return {
                     blockHash: (0, conversion_1.hashToString)(result.status.asFinalized),
                     transactionHash: (0, conversion_1.hashToString)(transaction.hash),
@@ -237,6 +353,21 @@ class Network {
             }
         });
     }
+    /**
+     * Decode the SCALE-encoded call carried by a `revive.ethTransact` transaction (or any other
+     *   Polymesh call), so a dapp can render it next to a wallet's confirmation prompt. Does not
+     *   fix in-wallet legibility (the wallet still shows raw bytes); it removes the worst of the
+     *   opacity for a dapp that cares
+     *
+     * @param hex - SCALE-encoded call, e.g. `transaction.toEthSignablePayload()`'s `transaction.data`
+     */
+    decodeCall(hex) {
+        const { context } = this;
+        const tag = (0, conversion_1.transactionHexToTxTag)(hex, context);
+        const args = context.getTransactionArguments({ tag });
+        const humanReadable = context.createType('Call', hex).toHuman();
+        return { tag, args, humanReadable };
+    }
     /**
      * Retrieve a list of events. Can be filtered using parameters
      *